Skip to content

fix(spec): correct stale tags restatements in book.json and liveness README - #9357

Merged
os-steve merged 1 commit into
mainfrom
claude/issue-9316-liveness-stale-tags-restatements
Aug 17, 2026
Merged

fix(spec): correct stale tags restatements in book.json and liveness README#9357
os-steve merged 1 commit into
mainfrom
claude/issue-9316-liveness-stale-tags-restatements

Conversation

@os-steve

Copy link
Copy Markdown
Collaborator

Fixes#9316

Same class as #9310 (merged as #9317): DocSchema declared tags in 17.0.0 (#4509, ADR-0049) — verified today on origin/main at packages/spec/src/system/doc.zod.ts:126, tags: z.array(z.string()).optional(). That made the book include: { tag } variant live (matchesInclude reads doc.tags, packages/spec/src/system/book.zod.ts:213), but two more places in the liveness tree still restated the pre-fix claim that the tag rule can never match:

  • packages/spec/liveness/book.json — the groups.include prop's note (also bumped verifiedAt to today, since the claim was re-checked)
  • packages/spec/liveness/README.md — the book row

Both corrected to current-state truth, matching the #9317 wording posture (cites #4509/ADR-0049, cross-references the doc side's fuller history) and preserving load-bearing cross-references — the README row keeps its #4667 inline-translations-tombstone paragraph intact.

No verdict change (include stays status: "live"), no behaviour change — ledger prose only.

Tests

Local gates (worktree objectstack-issue-9316, head e26f5b14a):

  • pnpm --filter @objectstack/spec run check:liveness — pass (✓ every governed-type property … is classified … the README state table carries a row for each of the 30 governed type(s))
  • pnpm --filter @objectstack/spec run check:empty-state — pass
  • pnpm --filter @objectstack/spec run check:strictness-ledger — pass
  • pnpm --filter @objectstack/spec run check:variant-docs — pass
  • pnpm check:merge-driver — pass (self-test)
  • pnpm check:type-source-resolution — pass
  • node scripts/check-dev-prereqs.mjs --self-test — pass (the full scan half needs a built workspace and is not run by CI on PRs — only its self-test is, per lint.yml)
  • node scripts/docs-audit/check-affected-docs.mjs — pass
  • node scripts/check-nul-bytes.mjs --self-test && node scripts/check-nul-bytes.mjs — pass

No changeset — ledger prose only, no user-visible change; docs/qa/platform-checklist/FOLLOW-UPS.md:83 (E1) is an existing append-only decision-register row about the already-merged #9310/#9317 fix (out of this card's file surface, not edited).

Generated by Claude Code


Generated by Claude Code

… book.json and liveness README
Same class as #9310/#9317: DocSchema declared `tags` in 17.0.0 (#4509,
ADR-0049), making the book `include: { tag }` include variant live, but
two more places in the liveness tree still restated the pre-fix claim
that the tag rule can never match:
- packages/spec/liveness/book.json — the `groups.include` prop's note
- packages/spec/liveness/README.md — the `book` row
Both corrected to current-state truth, matching the #9317 wording
posture and preserving load-bearing cross-references (the #4667
tombstone paragraph on the README row). No verdict change, no
behaviour change — ledger prose only.
Fixes#9316
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fs18A2DdXLVN2h8PaaFBcP
@github-actionsgithub-actionsBot added size/xs documentation Improvements or additions to documentation labels Aug 17, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

Nothing in this diff resolved to a documentable surface (no symbol, route or SDK anchor derived from 1 changed package(s)), so this run has no opinion about the docs.

What this run could not see
  • 2 changed file(s) yielded no anchor (packages/spec/liveness/README.md, packages/spec/liveness/book.json) — pages documenting those are invisible to this run

Coarse fallback — 113 page(s) merely mention a changed package (the pre-#9192 predicate, kept for the deliberately-wide backstop): node scripts/docs-audit/affected-docs.mjs --json origin/mainpackageMentionDocs.

@os-steveos-steve added the skip-changeset PR has no user-facing published change; bypasses the changeset gate label Aug 17, 2026 — with Claude
@os-steve
os-steve marked this pull request as ready for review August 17, 2026 16:43
@os-steve
os-steve added this pull request to the merge queueAug 17, 2026
Merged via the queue into main with commit 9c249a6Aug 17, 2026
30 of 31 checks passed
@os-steve
os-steve deleted the claude/issue-9316-liveness-stale-tags-restatements branch August 17, 2026 17:02
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/xsskip-changesetPR has no user-facing published change; bypasses the changeset gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

finding: same stale tags claim restated in book.json and liveness/README.md

2 participants

@os-steve@claude