Skip to content

docs: refresh stale architecture, roadmap, and module briefs#35

Merged
crewhaus merged 1 commit into
mainfrom
docs/fix-outdated-docs-and-demos
Jun 21, 2026
Merged

docs: refresh stale architecture, roadmap, and module briefs#35
crewhaus merged 1 commit into
mainfrom
docs/fix-outdated-docs-and-demos

Conversation

@crewhaus

Copy link
Copy Markdown
Owner

Refreshes docs/ artifacts that diverged from the shipped codebase, per the OUTDATED-DOCS-AND-DEMOS.md backlog. Verified against crewhaus/factory source.

Changes

  • COMPILER-ARCHITECTURE.md
    • The Bundle type is defined in @crewhaus/ir and merely re-exported by the compiler (was attributed to packages/compiler).
    • Replaced line-number citations for lower/emit/IrNode (drifted by hundreds of lines) with symbol-name navigation; also fixed two drifted ir-passes citations (redundantMcpServerCollapse, DEFAULT_PIPELINE).
    • Corrected the add-a-target step order: the spec schema branch must precede the lower() case.
  • build-roadmap.md — header marked as a frozen snapshot with a pointer to MODULE-CATALOG-STATUS.md; stale "12 target shapes" corrected to 14.
  • module-briefs/ — added a prominent caveat that the Status column is a historical planning snapshot (defer to MODULE-CATALOG-STATUS.md); annotated the non-shipping channel briefs (registry/signal/bluebubbles/email/sms/web/transport/binding/router/features) — only five channel adapters ship (slack/telegram/discord/whatsapp/imessage).

🤖 Generated with Claude Code

Fixes catalogued in OUTDATED-DOCS-AND-DEMOS.md:
- COMPILER-ARCHITECTURE.md: the Bundle type is defined in @crewhaus/ir and
  re-exported by the compiler (not defined in packages/compiler); replaced
  drifted line-number citations with symbol-name navigation; corrected the
  add-a-target step order so the spec branch precedes the lower() case
- build-roadmap.md: marked the header as a frozen snapshot and corrected the
  stale shape count (12 -> 14); points to MODULE-CATALOG-STATUS.md for current counts
- module-briefs: added a caveat that the Status column is a historical planning
  snapshot (defer to MODULE-CATALOG-STATUS.md); annotated the non-shipping
  channel briefs (only slack/telegram/discord/whatsapp/imessage ship)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@crewhaus crewhaus merged commit b572ff7 into main Jun 21, 2026
2 checks passed
@crewhaus crewhaus deleted the docs/fix-outdated-docs-and-demos branch June 21, 2026 00:19
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.

2 participants