Skip to content

Bring the decomposition guide in line with #416 and #434 - #437

Merged
lamemustafa merged 3 commits into
masterfrom
docs/416-decomposition-history
Sep 16, 2026
Merged

lamemustafa merged 3 commits into
masterfrom
docs/416-decomposition-history

Conversation

@lamemustafa

Copy link
Copy Markdown
Owner

Documentation only. Brings docs/module-decomposition.md in line with #416's decisions and #434's merge.

The reseal report (#436) is deliberately not described here, since it hasn't merged; that PR will add the pointer.

One thing this surfaced: agent_desktop_journal_review.rs was missed by the #416 measurement itself. It is declared pub(crate) mod, which the regex behind that measurement didn't match — the same reason agent_import_ledger.rs was missed until #434's review. Corrected on #416.

🤖 Generated with Claude Code

The guide's worked example was the gap #434 closed: it listed seven
unpinned collaborators of agent_import.rs, five of which are now pinned.
It said "218 of 218", which #434 made 232, and that there is no capacity
"by design" -- not what the history shows. RESERVED_SURFACE_FILES was
introduced in #223 with the cap at exactly count + 15; exact-count raises
are a convention since #260. In the slack period #246 added eight pins
without touching the cap, which is what the convention now prevents.

Its first rule, "Splitting a pinned file means pinning every file it
splits into", contradicts the #416 decision to report rather than
require: pin the parts that decide what Bridge posts or lets leave the
machine, each with a named reason.

It now names the two production collaborators still unpinned and why.
One, agent_desktop_journal_review.rs, was missed by the #416 measurement
itself -- declared `pub(crate) mod`, which the regex behind that
measurement did not match -- and is recorded here as orchestration that
delegates review, post and reconcile to the pinned agent_desktop_journal.rs.

Documentation only.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

lamemustafa and others added 2 commits September 16, 2026 14:38
… cannot widen

Fact-check found two sentences broader than the history. Exact-count
raises date from #260, but a named reason beside the constant only from
#278 (210 to 211); #260, #271 and #276 changed the number alone, and
most of the 232 pins have no individual reason. And agent_import_schema.rs
does run as build_import_xml's argument check, so it is described as what
it is -- one that cannot widen admission, since agent_import.rs re-checks
the bounds -- rather than as not deciding admission at all.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
#438 raises the cap to 238; the number belongs to the constant, not the
prose.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@lamemustafa
lamemustafa merged commit 4f94407 into master Sep 16, 2026
11 checks passed
@lamemustafa
lamemustafa deleted the docs/416-decomposition-history branch September 16, 2026 09:13
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