docs: advance the hook pin and merge 29 split pages back together #149

Merged
coilyco-ops merged 1 commit from aos/claude/docs-merge-to-cap into main 2026-08-27 04:18:00 +00:00
Owner

agent-proxy carried 69 docs against the large band's 40-doc cap. Not neglect: the pinned hook (aos-precommit-v0.18.0) enforced a flat 80-line / 4000-char cap with no count cap, so long pages had to be split. Each stub said so in its own body, "split across the pages below to stay inside the documentation caps". The count cap that punishes the result landed later.

The two rules were mutually unsatisfiable at the old pin. Merging produced pages over the 4000-char cap, splitting produced pages over the 40-doc cap. Advancing to aos-precommit-v0.49.0 raises per-file caps to 120 lines / 8000 chars and makes the merge legal. That advance surfaced exactly one finding across the whole suite: the doc count itself.

Sixteen families merged, 69 docs to 40. No prose deleted, corpus is 162,160 chars against a 320,000 ceiling. Six sub-700-char stubs that existed only to index their own fragments are gone. 32 doc cross-links, 5 self-links left by the merges, and 2 source files carrying docs/ pointers repointed. Full suite green.

Why this is a PR and not a push to main: the pin advance also brought pr-guard, which refuses default-branch pushes unconditionally and does not read the repo's ward lane. agent-proxy declares merge-remote-main. Flagged in coilysiren/inbox#439 - advancing any repo to v0.49.0 silently converts its lane to PR-only.

Refs: coilysiren/inbox#439

agent-proxy carried 69 docs against the large band's 40-doc cap. Not neglect: the pinned hook (`aos-precommit-v0.18.0`) enforced a flat 80-line / 4000-char cap with no count cap, so long pages had to be split. Each stub said so in its own body, "split across the pages below to stay inside the documentation caps". The count cap that punishes the result landed later. The two rules were mutually unsatisfiable at the old pin. Merging produced pages over the 4000-char cap, splitting produced pages over the 40-doc cap. Advancing to `aos-precommit-v0.49.0` raises per-file caps to 120 lines / 8000 chars and makes the merge legal. That advance surfaced exactly one finding across the whole suite: the doc count itself. Sixteen families merged, **69 docs to 40**. No prose deleted, corpus is 162,160 chars against a 320,000 ceiling. Six sub-700-char stubs that existed only to index their own fragments are gone. 32 doc cross-links, 5 self-links left by the merges, and 2 source files carrying `docs/` pointers repointed. Full suite green. **Why this is a PR and not a push to main:** the pin advance also brought `pr-guard`, which refuses default-branch pushes unconditionally and does not read the repo's ward lane. agent-proxy declares `merge-remote-main`. Flagged in coilysiren/inbox#439 - advancing any repo to v0.49.0 silently converts its lane to PR-only. Refs: coilysiren/inbox#439
docs: advance the hook pin and merge 29 split pages back together
All checks were successful
ci / smoke (pull_request) Successful in 6s
ci / quality (pull_request) Successful in 36s
7cc2722cda
agent-proxy carried 69 docs against the large band's 40-doc cap. That was not
neglect: the pinned hook (aos-precommit-v0.18.0) enforced a flat 80-line /
4000-char cap with no count cap, so every long page had to be split, and each
stub said so in its own body - "split across the pages below to stay inside the
documentation caps". The count cap that punishes the result landed later.

The two rules were mutually unsatisfiable at the old pin: merging produced pages
over the 4000-char cap, splitting produced pages over the 40-doc cap. Advancing
the pin to aos-precommit-v0.49.0 raises the per-file caps to 120 lines / 8000
chars and makes the merge legal. That advance surfaced exactly one finding
across the whole suite, the doc count itself.

Sixteen families merge back into their parents, 69 docs to 40. No prose is
deleted - the corpus is 162,160 chars against a 320,000 ceiling - and every
page lands inside both caps. Six sub-700-char stubs that existed only to index
their own fragments are gone. 32 doc cross-links, 5 self-links left behind by
the merges, and 2 source files carrying docs/ pointers are repointed.

Refs: coilysiren/inbox#439

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: Kai Siren <coilysiren@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
Agent-Role: devrel
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
coilyco-flight-deck/agent-proxy!149
No description provided.