Skip to content

feat(library): enforce manifest-backed chapter availability - #170

Open
anantham wants to merge 1 commit into
codex/chapter-publication-integrityfrom
codex/chapter-publication-client-gate
Open

feat(library): enforce manifest-backed chapter availability#170
anantham wants to merge 1 commit into
codex/chapter-publication-integrityfrom
codex/chapter-publication-client-gate

Conversation

@anantham

Copy link
Copy Markdown
Owner

Summary

Makes a validated exact chapter manifest authoritative for catalog projection, cache/package completeness, and generated publication output. This is stacked on #169 so the reader behavior stays reviewable separately from the contract/verifier.

Root Cause

The client treated broad metadata ranges as proof of published chapter identity. A package could therefore advertise and navigate to chapters absent from its session artifact.

Changes

  • Project virtual catalog rows only from validated exact manifest identities
  • Use the same exact manifest for cache/package completeness
  • Fail closed when a package declares a missing or invalid manifest
  • Preserve legacy range behavior only for packages not yet migrated
  • Normalize relative manifest URLs
  • Generate manifest output alongside session artifacts
  • Amend CORE-015 and library publishing/reader documentation

Testing

  • Exact head 63afee0: 6 focused files, 56 tests passed
  • TypeScript --noEmit passed
  • git diff --check passed
  • Broader pinned Node 24 pre-commit tree: 298 files passed, 9,395 tests passed, 347 skipped, 0 failed

Review Checklist

Context: Metadata ranges could project chapters that had no exact published identity.
Changes: Make validated manifests authoritative for catalog projection, package completeness, and generated publication output.
Impact: Declared invalid manifests fail closed; legacy packages retain prior behavior until migrated.
Tests: 6 focused files, 56 tests; TypeScript; diff check.
Docs: CORE-015 amendment, library guides, WORKLOG.
ADR: CORE-015
@vercel

vercel Bot commented Aug 31, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
lexicon-forge Ready Ready Preview Aug 31, 2026 8:15am

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