The standalone prototype should be the root-level project shape for fengqun while preserving the existing planning documents already at the root. This keeps README, examples, tests, and the Python package directly discoverable without deleting the prior docs.
Constraint: User clarified that swarm-minimal is the repository root, but other existing root files must remain.
Rejected: Deleting existing root docs | They are part of the fengqun repository context and were explicitly protected.
Confidence: high
Scope-risk: narrow
Directive: Keep secrets in ignored .env only; do not commit live credentials.
Tested: python3 -B -m unittest discover -s tests; git diff --check; secret-pattern scan showed only placeholders/test values/task-id false positives.
Not-tested: Remote web UI rendering after push.
The Heicode-local swarm prototype is moved into this dedicated repository as an isolated artifact so the main Heicode workspace can be cleaned afterward. Secrets remain excluded through the local .gitignore contract, and only placeholders/test fixtures are included.
Constraint: User requested upload to http://gitee.ath.cx:3000/taijibaga/fengqun before deleting the Heicode-local copy.
Rejected: Flattening into repository root | Existing fengqun docs would be overwritten and history would be noisier.
Confidence: high
Scope-risk: narrow
Directive: Keep real credentials out of this repository; use ignored .env only for local live runs.
Tested: /Volumes/macOS/GO/heicode/swarm-minimal/.venv/bin/python -B -m unittest discover -s tests; git diff --check; secret-pattern scan found only placeholders/test values.
Not-tested: Fresh virtualenv install from the uploaded repository after clone.
gongzhiyong