Skip to content

Add documented feature knowledge and coverage gates for JiuwenSwarm - #284

Merged
tzhouam merged 3 commits into
mainfrom
feat/kb-owner-knowledge
Oct 1, 2026
Merged

tzhouam merged 3 commits into
mainfrom
feat/kb-owner-knowledge

Conversation

@tzhouam

@tzhouam tzhouam commented Oct 1, 2026 •

Copy link
Copy Markdown
Collaborator

JiuwenSwarm's initialization stopped at PR-weighted rule coverage, leaving architecture, APIs, settings and less frequently changed features underrepresented. Add an explanatory knowledge stage and independent feature/file coverage gates, then enrich the pinned JiuwenSwarm knowledge slice.

Changes

  • Generate six cited knowledge dimensions from pinned code and existing repository documentation: architecture, APIs, configuration, tradeoffs, feature relationships and validation. Rank the complete configured document list before prompt caps, retain README context, and distinguish documented design from implemented behavior.
  • Define feature entry points and all first-party production roots in a coverage policy. Required policies block later stages until every inventoried feature and at least 85% of production files are covered; results are bound to the current policy hash.
  • Preserve existing knowledge, label design inferences and uncertain sections, and verify static file records against both source hashes and extracted contents. Rules, indexes, bare links and stale records do not count.
  • Add 79 feature guides, nine design-tradeoff guides and 1,893 verified file interface/dependency records, organized by code owner. The saved audit at upstream f0a69728c96b5961d993449f1a901cbd2f4dac5b covers 79/79 inventoried feature areas and 2,043/2,199 production files (92.9%).

Feature coverage measures the declared inventory. File coverage includes structural interface/dependency knowledge; neither metric proves exhaustive behavior analysis or runtime correctness. For example, the SkillDev guide explicitly records its unfinished stage-agent construction.

Validation

  • Pinned coverage audit passes with no missing catalog sources or stale records.
  • Knowledge tree and wiki validators pass: zero errors; 39 tree size/organization warnings.
  • Documentation links, citations and strict SPEC freshness checks pass.
  • Full offline suite passes in an isolated environment with the declared dependencies: 2,323 passed, 17 skipped. Documentation-selection and local-versus-remote link-check regressions are included.
  • Both GitHub push and pull-request workflows pass, including unit tests, CLI/doctor smoke checks, packaged runtime data, documentation checks and knowledge validators.

Pipeline implementation, JiuwenSwarm knowledge and the link-check regression are separate commits. No upstream model, OAuth or runtime integration calls were executed.

@tzhouam
tzhouam marked this pull request as ready for review October 1, 2026 16:24
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-01T16:25:16.384832Z a1d1a80 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@tzhouam
tzhouam merged commit 65641cc into main Oct 1, 2026
2 checks passed
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