Skip to content

docs: fix stale test count and broken file paths in README - #33

Open
dsmcewan wants to merge 1 commit into
mainfrom
docs/readme-accuracy-pass
Open

docs: fix stale test count and broken file paths in README#33
dsmcewan wants to merge 1 commit into
mainfrom
docs/readme-accuracy-pass

Conversation

@dsmcewan

Copy link
Copy Markdown
Owner

Summary

Accuracy-only pass over README.md (no other docs needed changes). Verified against the current codebase by cloning fresh, installing the package, running the test suite, and executing every CLI/Docker/server command the README documents.

Fixed

  • Stale test count. README said pytest tests/ -q # 191 deterministic tests (in both the Run section and the Layout tree). Running the suite now shows 272 passed. Updated both occurrences.
  • Broken file paths — "The six layers" section. All six layer files were referenced as layers/pattern_detector.py, layers/gap_detector.py, layers/third_party.py, layers/domain_convergence.py, layers/phrase_fragmentation.py, layers/cross_channel.py. There is no top-level layers/ directory — these only exist under convergence/layers/. Fixed all six references.
  • Broken file paths — Narration/adapters section. Same issue for adapters/anthropic_llm.py, adapters/openai_llm.py, adapters/grok_llm.py, adapters/antigravity_cli_llm.py — corrected to convergence/adapters/....
  • Missing Gemini adapter documentation. The Layout section already lists "Gemini" as one of five supported LLM backends, and --model gemini is a real, working CLI choice (confirmed in demo.py), but the detailed adapters list never mentioned convergence/adapters/gemini_llm.py (API-key backend) or convergence/adapters/gemini_cli_llm.py (keyless CLI fallback). Added a bullet describing both, matching the existing format.

Verified accurate, left unchanged

  • Badges (CI, license, Python 3.10–3.12 matrix, ≥80% coverage — actual measured coverage is 85%).
  • Install/run instructions, all convergence / convergence-web / convergence-build commands, --corpus, --eval, --about, --trick, --chat flags — all executed successfully.
  • Docker env vars (CONVERGENCE_HOST, CONVERGENCE_API_KEY, /api/chat gating with X-API-Key) match Dockerfile and web/server.py.
  • FRAGMENTS.md/INTENT.md/HIERARCHY.md doc-guard tests (tests/test_fragments_doc.py, etc.) still pass unchanged.
  • docs/ARCHITECTURE.md is an intentional redirect stub to the root ARCHITECTURE.md; not referenced by README, left as-is.

Test plan

  • pytest tests/ -q — 272 passed
  • pytest tests/test_fragments_doc.py tests/test_intent_doc.py tests/test_hierarchy_doc.py -q — 9 passed (unaffected by this change)
  • Ran convergence --corpus {contractor,grammar,dynamics}, --eval, --about, convergence-build, convergence-web (curl'd the served index and /api/chat) to confirm README commands work as described

- pytest tests/ -q now reports 191 deterministic tests in two places; the
  suite currently has 272 passing tests.
- The "six layers" section referenced layers/*.py and the adapters
  bullets referenced adapters/*.py, but both subdirectories only exist
  nested under convergence/ (convergence/layers/, convergence/adapters/),
  so those paths didn't resolve from the repo root.
- The adapters list omitted convergence/adapters/gemini_llm.py and
  gemini_cli_llm.py, even though `--model gemini` is a real, working CLI
  choice and the Layout section already lists Gemini as one of the five
  supported backends.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant