Skip to content

Enrich JiuwenSwarm init from existing knowledge and maintainer docs - #285

Merged
tzhouam merged 2 commits into
mainfrom
feat/jiuwenswarm-maintainer-init
Oct 1, 2026
Merged

tzhouam merged 2 commits into
mainfrom
feat/jiuwenswarm-maintainer-init

Conversation

@tzhouam

@tzhouam tzhouam commented Oct 1, 2026 •

Copy link
Copy Markdown
Collaborator

Existing repositories need to enrich explanatory knowledge without recreating local skeleton/modules records. Init now supports an explicit merged-knowledge baseline, reads relevant project and partial maintainer docs alongside pinned source, and extracts architecture, API, configuration, design tradeoffs, feature relationships, and validation entry points.

The JiuwenSwarm rerun at f0a69728c96b5961d993449f1a901cbd2f4dac5b visited 21 production owners using existing knowledge and 53 distinct docs, including 24 maintainer documents. It adds 29 host source-checked sections in five owner pages: Web, AgentServer runtime, code harness, common contracts, and the bundled daily-report skill. Examples include packaged static assets, WebSocket lifecycle, sticky observability, configuration-cache isolation, ACP defaults, and lazy email/model setup.

  • --from-existing validates merged indexes/routes without synthesizing prerequisite records; existing stage gates remain enforced.
  • --subscription-generator explicitly selects an authenticated Zcode coding plan, binds billing selection to the dispatched provider, preserves unknown USD usage, and retains judge budget checks. Default API spend protections remain enforced.
  • Readable source-line arrays prevent native attachment readers from truncating giant JSON lines. Explicit feature ownership fills unambiguous legacy route gaps across all first-party code; conflicting file assignments remain unrouted.
  • A malformed component reply leaves that component unfinished and allows the other owners to continue. Only advisory-pass sections enter generated pages; other drafts stay in ignored local traces for review. Host corrections are reported separately from model passes.

Coverage remains 79/79 inventoried features and 2,043/2,199 production files (92.9%), exceeding the 85% requirement. File coverage includes 1,893 verified static interface contracts and does not imply exhaustive behavioral review or upstream test execution. The additional explanations deepen the existing coverage. Both the reproducible coverage audit and a sanitized init summary are under eval/knowledge-coverage/.

Generation used Zcode GLM-5.3, with Codex advisory checks and host source review. No Claude Code calls were made. The final run accounts for $49.50 in fixed judge units ($55.50 across attempts, within the configured $60 ceiling); subscription fees and native transport USD are unreported. Revalidation reused all 120 original replies with exact role and system/prompt SHA-256 matching, requiring no additional model calls.

Validation:

  • Knowledge-tree and wiki validators pass; SPEC freshness, documentation links/citations, and pinned coverage audit pass.
  • Targeted init, provider-isolation, billing, ownership-conflict, and spend-cap tests pass.
  • Full suite: 2,336 passed, 17 skipped at d839083201b87351d6a55c03581b7ae8888e9d19; both CI suites pass for the same head.

@tzhouam tzhouam changed the title Enrich existing JiuwenSwarm knowledge with project and maintainer docs Enrich JiuwenSwarm init from existing knowledge and maintainer docs Oct 1, 2026
@tzhouam
tzhouam marked this pull request as ready for review October 1, 2026 20:08
@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-01T20:12:39.933333Z d839083 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 6779a53 into main Oct 1, 2026
2 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d839083201

ℹ️ 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".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +223 to +224
except ModelUnavailable as exc:
self.record.unfinished.append(f"knowledge owner {name}: unusable draft: {exc}")

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Block when the generator is globally unavailable

When ModelUnavailable reflects a backend-wide failure such as a missing CLI, expired login, rejected subscription billing, or provider outage, every owner call reaches this handler and the stage continues as though each component merely returned a bad draft. After all calls fail, _conclude() can mark the run empty (or publish unrelated deterministic changes), and _chain() accepts an empty knowledge stage as completed, so the CLI reports success while producing no requested knowledge. Preserve per-component recovery for malformed replies, but propagate or otherwise block after a generator-wide/all-owner outage.

Useful? React with 👍 / 👎.

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