Commit Graph
18 Commits
Author SHA1 Message Date
gongzhiyongandOmX a4d771ede5 Define numeric swarm acceptance gates
Add a concrete 0-100 swarmness/compliance score, local large-scale stress, and 3000 TPM budget acceptance so the repo can say when it is a swarm by measured criteria instead of prose alone.

Constraint: user required Chinese docs, explicit scenarios, parameters, formulas, pass/fail lines, and git upload.

Rejected: prose-only PASS reports | they did not answer whether the system is a swarm with a concrete score.

Confidence: high

Scope-risk: moderate

Directive: keep production runtime claims separate from local minimal swarm acceptance scores.

Tested: py_compile swarm_minimal examples tests; unittest discover -s tests 45 tests; run_swarm_compliance_score.py; run_tpm_budget_acceptance.py; run_academic_standard_evaluation.py; git diff --check; docs/script secret-pattern scan.

Not-tested: live S07 and production Kubernetes/NewAPI provider-rate-limit stress were not rerun in this upload step.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-17 18:19:24 +08:00
gongzhiyongandOmX c22dc7f573 Codify swarm characteristic acceptance
Make the user's six swarm characteristics first-class acceptance gates by adding S10/A07 tests, a standard document, and synchronized reports.

Constraint: The user asked to set acceptance indicators and test standard details around decentralization, self-organization, emergence, robustness, scalability, and implicit collaboration.

Rejected: Treating the six traits as prose-only documentation | they now run as deterministic tests and scenario matrix gates.

Confidence: high

Scope-risk: moderate

Directive: Future swarm-readiness claims must report F01-F06 explicitly and distinguish local Agent-layer proof from production no-coordinator runtime.

Tested: py_compile; unittest discover ran 41 tests; run_swarm_characteristics_acceptance PASS; run_academic_standard_evaluation A01-A07 PASS; run_standard_scenario_acceptance S01-S10 PASS with S07 run_id 9c7ccc6087c1435694a52efb12c32301; docs/README secret-pattern scan clean; git diff --cached --check clean.

Not-tested: Production no-coordinator distributed runtime and Kubernetes-scale worker telemetry remain outside this minimal local acceptance gate.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-17 17:22:23 +08:00
gongzhiyongandOmX 996d7c7c18 Document scoring and acceptance formulas
Make the scoring implementation auditable by writing the formulas for quality scoring, task scores, pheromones, candidate fusion, consensus, and S07/S09 pass gates.

Constraint: The user asked to turn the scoring explanation into a document under the Chinese docs line.

Rejected: Leaving formulas only in chat | future reviewers need a repo artifact linked from the docs index.

Confidence: high

Scope-risk: narrow

Directive: Keep future score changes synchronized with SCORING_AND_ACCEPTANCE_FORMULAS.zh-CN.md and the acceptance scripts.

Tested: rg formula/index scan; docs secret-pattern scan; git diff --check; .venv/bin/python -B -m unittest tests.test_model_io_report_audit.

Not-tested: Did not rerun live S07 because this is a documentation-only formula extraction.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 17:38:09 +08:00
gongzhiyongandOmX 7518895241 Align documentation with closed-loop evidence
Make the documentation set read consistently after S09 was implemented and verified, while preserving the boundary between local minimal acceptance and production platform delivery.

Constraint: The user asked for a comprehensive Chinese documentation update after code-level acceptance and testing.

Rejected: Leaving older platform planning docs without current-status overlays | that makes completed S09 work look unfinished and blurs the production boundary.

Confidence: high

Scope-risk: narrow

Directive: Future docs must keep S01-S09 minimal evidence separate from Manager/Agnet/Kubernetes production integration claims.

Tested: unittest discover -s tests; tests.test_model_io_report_audit; run_next_boundary_acceptance.py; run_academic_standard_evaluation.py; secret-pattern rg scan; stale-doc rg scan; git diff --check.

Not-tested: Did not rerun the external S07 live matrix in this docs-only pass; latest S07 live evidence remains run d700c90182274332b68e283fb3e9fb18 from the preceding acceptance pass.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 17:15:48 +08:00
gongzhiyongandOmX 2fd6e4ab9a Close next-boundary swarm gaps
Turn the remaining minimal-boundary items into executable behavior: locked autonomous claim scaling for 3/5/7 agents, multi-candidate fusion, and challenge-revise-revote consensus.

Constraint: The user asked to implement code directly, complete testing and acceptance, and explain the test standards rather than only updating the comparison document.

Rejected: Leaving SW-AQS-16, candidate fusion, and questioning consensus as documentation-only future work | each now has deterministic code paths and S09 acceptance evidence.

Confidence: high

Scope-risk: moderate

Directive: Future claims about full production readiness must still distinguish this local deterministic S09 acceptance from real runtime/Kubernetes scaling and Manager/Agnet platform integration.

Tested: .venv/bin/python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; .venv/bin/python -B -m unittest tests.test_standard_scenarios; .venv/bin/python -B -m unittest discover -s tests; .venv/bin/python -u -B examples/run_next_boundary_acceptance.py; .venv/bin/python -u -B examples/run_academic_standard_evaluation.py; .venv/bin/python -u -B examples/run_standard_scenario_acceptance.py; .venv/bin/python -B examples/export_model_agnet_io_report.py; .venv/bin/python -B -m unittest tests.test_model_io_report_audit; docs secret pattern scan; git diff --check.

Not-tested: Real Kubernetes/worker runtime 3/5/7 scaling, Redis Stream consumer-driven replanning, and Manager/Agnet approval integration remain outside this local minimal acceptance.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 17:09:03 +08:00
gongzhiyongandOmX cd2431ece2 Add minimal quality-gated convergence
Promote the S07 external FastAPI chain from score-only acceptance to a minimal quality-gated flow with refusal detection, retry/fallback recovery, handoff quality checks, and a multi-round consensus gate before final convergence.

Constraint: The user asked to fix the documented shortcomings around score-only convergence, weak refusal scoring, and unqualified handoff evidence while continuing the minimal version.

Rejected: Replacing the whole coordinator with a production consensus runtime | the minimal fix keeps the existing task pool/convergence shape and adds scenario-level quality gates plus consensus evidence.

Confidence: high

Scope-risk: moderate

Directive: Future S07 runs must keep all_outputs_pass_quality_gate and multi_round_quality_consensus_accepts_chain as required checks before claiming PASS.

Tested: .venv/bin/python -B -m unittest tests.test_standard_scenarios; .venv/bin/python -u -B examples/run_continuous_reasoning_acceptance.py; .venv/bin/python -B examples/export_model_agnet_io_report.py; .venv/bin/python -B -m unittest discover -s tests; .venv/bin/python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; .venv/bin/python -u -B examples/run_academic_standard_evaluation.py; .venv/bin/python -B -m unittest tests.test_model_io_report_audit; git diff --check; docs secret pattern scan.

Not-tested: The combined run_standard_scenario_acceptance wrapper was not rerun after report export to avoid creating a newer live run that would make the exported latest-run report stale.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 16:35:00 +08:00
gongzhiyongandOmX 693171f6be Add Agnet input output logic narrative
Add a no-code Chinese explanation of the current Agnet framework logic and implementation process using only Agnet inputs, outputs, handoffs, and convergence behavior.

Constraint: The user asked for a framework logic explanation without code, based on Agnet input and output.

Rejected: Expanding the generated model I/O report again | a standalone narrative keeps the explanation readable and avoids another raw evidence dump.

Confidence: high

Scope-risk: narrow

Directive: Keep this document prose-only; do not add source snippets, command blocks, or inline code markers.

Tested: no backtick/code-marker scan on docs/AGNET_FRAMEWORK_INPUT_OUTPUT_LOGIC.zh-CN.md; .venv/bin/python -B -m unittest discover -s tests; .venv/bin/python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; git diff --check; docs secret pattern scan.

Not-tested: Live S07 was not rerun because this change adds explanatory documentation only.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 16:13:47 +08:00
gongzhiyongandOmX 647dbce515 Clarify model IO report scenario
Rewrite the generated model/Agnet I/O report around the external FastAPI scenario, the actual test work, Agnet implementation mechanics, and convergence flow so the report is auditable by humans instead of being a raw output dump.

Constraint: The user said the scenario description did not explain what the project is, what work was done, how Agnets work, or how convergence happened.

Rejected: Keeping full raw model outputs in the report | large English refusal blocks obscured the Chinese audit narrative and made the report hard to judge.

Confidence: high

Scope-risk: narrow

Directive: Keep MODEL_AGNET_IO_REPORT.zh-CN.md generated from examples/export_model_agnet_io_report.py and preserve the scenario/mechanics/convergence sections in future exports.

Tested: .venv/bin/python -B -m unittest tests.test_model_io_report_audit; .venv/bin/python -B -m unittest discover -s tests; .venv/bin/python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; .venv/bin/python -u -B examples/run_academic_standard_evaluation.py; git diff --check; docs secret pattern scan.

Not-tested: Live S07 rerun was not repeated because this change rewrites report generation and reuses the latest persisted run evidence.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 15:54:07 +08:00
gongzhiyongandOmX f4292e5999 Remove duplicate test docs
Delete redundant and pure-English test documentation so the docs set has one clear Chinese source of truth for standards, scenarios, model I/O, and industry mapping.

Constraint: The user asked to delete unnecessary duplicate docs and pure-English docs.

Rejected: Keeping parallel English and article-derived matrices | they duplicate the current Chinese standard reports and confuse the active S07 FastAPI evidence.

Confidence: high

Scope-risk: narrow

Directive: Keep future Agent test documentation in docs/ and prefer Chinese source-of-truth reports over parallel duplicate matrices.

Tested: .venv/bin/python -B -m unittest discover -s tests; .venv/bin/python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; git diff --check; duplicate-doc reference scan; docs secret pattern scan.

Not-tested: Live S07 matrix was not rerun because this change only deletes duplicate docs and updates indexes.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 15:49:24 +08:00
gongzhiyongandOmX dc2b166e60 Use external codebase for live agent scenario
Replace the self-referential S07 code task with a pinned fastapi/fastapi GitHub scenario so the live Agent standard tests evaluate an external complex codebase instead of the local harness project.

Constraint: The user explicitly rejected using this project as the code target for the live scenario.

Rejected: Keeping swarm-minimal as the S07 code target | it would keep validating the harness against itself.

Confidence: high

Scope-risk: moderate

Directive: Keep S07 target files external to this repository unless the user explicitly asks for a local-harness scenario.

Tested: .venv/bin/python -u -B examples/run_standard_scenario_acceptance.py; .venv/bin/python -B -m unittest discover -s tests; .venv/bin/python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; .venv/bin/python -u -B examples/run_academic_standard_evaluation.py; git diff --check; docs secret-pattern scan.

Not-tested: Applying the proposed FastAPI patch inside the external fastapi/fastapi repository was not run; S07 is a live Agent reasoning and evidence-chain test.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 15:44:36 +08:00
gongzhiyongandOmX d632fd9f64 Add report audit scenario
Extend the Agent standard matrix with a report-audit scenario so model input, output, handoff, and secret-safety evidence are tested instead of remaining narrative-only.

Constraint: The user requested another test pass and expanded Agent/swarm testing scenarios under docs/.

Rejected: Treating the model I/O report as untested documentation | it would leave the handoff and input/output evidence unguarded.

Confidence: high

Scope-risk: moderate

Directive: Keep model I/O reports under docs/ and redact secret-shaped values during export.

Tested: .venv/bin/python -u -B examples/run_standard_scenario_acceptance.py; .venv/bin/python -B -m unittest discover -s tests; .venv/bin/python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; .venv/bin/python -u -B examples/run_academic_standard_evaluation.py; git diff --check; docs secret-pattern scan.

Not-tested: Large-scale concurrent 3/5/7 worker load and external browser rendering were not run.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 15:17:47 +08:00
gongzhiyongandOmX e4997efeb1 Refresh live agent IO evidence
Refresh the model/Agnet I/O report from a new S01-S07 standard matrix run and add the scenario coverage summary directly to the report.

Constraint: The linked Gitee docs page should show current evidence and the user asked to supplement the tested scenarios.

Rejected: Leaving the previous live run as latest | it would make the linked report stale after rerunning S07.

Confidence: high

Scope-risk: narrow

Directive: Keep regenerated model I/O reports under docs/ and strip trailing whitespace from model-produced multiline output.

Tested: python -u -B examples/run_standard_scenario_acceptance.py; git diff --check; python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; python -B -m unittest discover -s tests; python -u -B examples/run_academic_standard_evaluation.py

Not-tested: Browser rendering of the internal Gitee page was not verified because the URL is internal; git push updates the same origin/main path.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 14:48:03 +08:00
gongzhiyongandOmX fc877dad24 Move remaining docs into docs index
Keep the repository root focused on README while moving the remaining planning and swarm test documents under docs/ and indexing them there.

Constraint: The user explicitly requested that documents should live under docs/.

Rejected: Leaving older root-level Markdown files in place | it keeps the homepage cluttered and splits the documentation surface.

Confidence: high

Scope-risk: narrow

Directive: Keep future ordinary documentation under docs/ unless it is a root entrypoint such as README.md.

Tested: git diff --cached --check; find . -maxdepth 1 -type f -name '*.md' shows only README.md.

Not-tested: No runtime tests rerun because this is a documentation path-only move.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 14:39:32 +08:00
gongzhiyongandOmX 10a980b0bf Establish agent swarm quality evidence
Define Agent and swarm-specific acceptance evidence, move the reports under docs, and make the homepage point to the current standard, live run, model I/O, and handoff evidence.

Constraint: Agent quality standards are configured from industry AI and agent risk references because there is no single accepted swarm-Agent certification standard.

Rejected: Treating py_compile or unittest as the primary quality standard | they are evidence collection tools, not the Agent quality standard itself.

Confidence: high

Scope-risk: moderate

Directive: Keep future standard reports under docs/ and keep secrets in ignored local .env files only.

Tested: git diff --cached --check; python -B -m py_compile swarm_minimal/*.py examples/*.py tests/*.py; python -B -m unittest discover -s tests; python -u -B examples/run_academic_standard_evaluation.py

Not-tested: Did not rerun the full live Azure/NewAPI S07 scenario after moving docs; previous live run 3e8e58ae4e084bc8b90cf5c46f8992f3 passed before the docs relocation.

Co-authored-by: OmX <omx@oh-my-codex.dev>
2026-05-16 14:36:47 +08:00
gongzhiyong 111be3e435 Promote the minimal swarm prototype to the repository root
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.
2026-05-16 13:32:11 +08:00
gongzhiyong f6182166b0 Preserve the standalone swarm prototype in the fengqun repository
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.
2026-05-16 13:29:03 +08:00
xiaohei d4940d3e96 上传文件至「docs」 2026-05-14 17:50:32 +00:00
xiaohei d0877c6cba 上传文件至「/」
Signed-off-by: xiaohei <xiaohei@xinghanlab.com>
2026-05-14 17:45:34 +00:00