docs: one-local-environment setup for the integrated functional test - #351
Merged
Merged
Conversation
The harness doc listed the four-repo prerequisite but not how to prepare it. Add a "Prepare all peers in one local environment" section: check the repos out side by side and editable-install AZ-06 Deception + Knowledge (with the shared Fabric v0.6.0 contracts) into a single venv, so Edge drives every peer on one interpreter. Documents the local-first install order (Fabric first, then --no-deps editable installs to avoid re-fetching the pinned git Fabric) and the network-allowed [api]-extra alternative, plus a shared-interpreter verify snippet. One-command mode works directly from that venv. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0198tdsTP5iQjwUD7GB9cmwj
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Follow-up to #350. The integrated functional-test doc listed the four-repo prerequisite but not how to prepare it. This adds a "Prepare all peers in one local environment" section so a reader can go from bare checkouts to a green run.
It documents preparing AZ-06 Deception and Knowledge in the same local environment as Edge:
@v0.6.0dependency in Deception/Knowledge is satisfied by the local checkout), then editable-install Deception and Knowledge with--no-deps(avoids re-fetching/shadowing Fabric) and add their runtime deps explicitly;pip install -e './Azazel-Knowledge[api]', letting pip fetch the tag-pinned Fabric);Edge itself is not pip-installed — the harness puts its
py/tree onsys.path— so running the harness from that venv is what lands all four packages on one interpreter, after which one-command mode works directly.The recipe matches the environment the harness was validated in (Python 3.11;
azazel-fabric0.6.0 +azazel-deception+azazel-knowledgeeditable; fastapi/uvicorn/pydantic + PyYAML/idna/PyNaCl).Type of change
Checklist
PYTHONPATH=. pytest -qpassesinstaller/,systemd/,security/without explicit justification belowNotes for reviewers
Docs-only change to
docs/architecture/edge-integration-functional-test.md. No code or restricted-area changes.Related issues
Refs #325
🤖 Generated with Claude Code
Generated by Claude Code