Work-package charter#
- Task ID:
COV-004 - Owner: Oshun portfolio content-coverage contract maintainer; implementation owner: Codex
- Accountable product: Shared V1–V9 autonomous-content platform
- Priority: P0
- Target milestone: 2026-07-15 SOTA gap-closure program
- Risk tier: High release-integrity, localization, accessibility, inventory, and human-authored lineage risk
- Dependencies: COV-001 canonical content slots; COV-002 source-preserving seed; COV-003 portfolio dependency contract; source-owned V1–V9 locale and manual-content records; AUD-003 reproducible verification; AUD-006 generated capability truth
- Affected schemas and inventory: New strict
ContentInventoryRegistryV1Schema, reviewed modality accessibility floor, deterministic generator/report, 77 inventory rows, unknown-preserving aggregates, exports, focused CI, and adversarial tests. No inventory row is promoted to a complete COV-001 slot. - Rollout strategy: Publish through
@oshun/contracts/content-coverageand the root contracts namespace, keep the generated registry/report source-digest-bound in CI, then require COV-005 and product importers to canonicalize the rows and reconcile release evidence. - Rollback strategy: Revert the inventory contract, generator, committed outputs, tests, exports, CI step, audit qualification, and ledger closure together. Never preserve an aggregate that silently treats unknown as zero.
- Evidence-pack location: This file
Inventory result and locale truth#
The deterministic registry contains 77 rows:
- 54 COV-002 targets: 28 V1 generation surfaces, four V1 live autonomy categories, 16 V8/V9 required artifacts, and six V8/V9 placement targets.
- Nine direct product locale observations: V1 shared customer messages (8), V2 translation files (2), V3 HUD bundles (18), V4 recorded VO packs (12), V5 stadium caption language count (16, identities undeclared), V6 cognition dialogue profiles (3), V7 creator-marketplace launch locales (8), V8 case source locale (1), and V9 lesson planner targets (undeclared).
- 14 intentionally manual records: three expired V2 MOTDs, one V2 patch-note release, one V4 schedule-rotation patch note, six V5 approved replacement artifacts, and three V5 public-news articles.
Locale observations have exactly three states. enumerated requires canonical,
unique BCP 47 identities whose length equals the count. count-only preserves a
positive declared count but cannot invent identities. undeclared has a null
count rather than zero. A one-identity enumeration is always an explicit
single-locale gap.
The V1 shared customer-message catalog has eight locales, but none of the 28
generation surfaces or four live autonomy-category definitions links itself to
that catalog or declares a locale. All 32 remain explicit undeclared gaps. The
V5 caption declaration remains count-only, V8 remains an explicit en-US
single-locale gap, and V9 remains undeclared.
Modality and accessibility policy#
Every row has a reviewed content-kind/modality classification. The contract computes the exact union of these COV-004 minimums:
| Modality | Required minimums |
|---|---|
| text | reading level, assistive metadata |
| image | alt text, assistive metadata |
| audio | transcript, assistive metadata |
| video | captions, transcript, audio description, assistive metadata |
| 3D | audio description, keyboard access, controller access, assistive metadata |
| animation | audio description, assistive metadata |
| interactive | keyboard access, controller access, assistive metadata |
| gameplay | audio description, keyboard access, controller access, assistive metadata |
| metadata | assistive metadata |
| code | keyboard access, reading level, assistive metadata |
| document | reading level, assistive metadata |
The schema rejects a row whose accessibility list differs from the reviewed modality floor. This records requirements per row/content kind; it is not evidence that any current artifact conforms.
Manual lifecycle, lineage, and quantities#
Manual rows use the same strict inventory fields, source locators, stable
lineage references, locale observation, accessibility requirements, lifecycle
state, quantities, and gap ownership as agent/hybrid targets. The three MOTDs
are explicitly stale because their source end times precede the inventory
date. Static patch notes, replacement records, and news are review records;
they are not promoted to production placement.
Required/current/missing/stale/blocked quantities remain nullable. The 16
required artifacts and six placement targets each contribute one known required
unit, while their current/missing/stale/blocked values remain unknown. Manual
source records contribute known current units; stale MOTDs contribute known
stale units. Every aggregate reports { knownSum, unknownRows } by product,
product surface, modality, locale, source policy, and accessibility requirement.
Thus a group with no known missing quantity reports zero known plus its unknown
row count, never a false zero-missing conclusion.
Every one of the 77 rows currently has at least one explicit gap, and all 77
assign team:oshun-content-coverage-migration with escalation
oncall:oshun-platform. That is migration accountability, not invented product
ownership.
Determinism and artifact identity#
| Artifact | SHA-256 |
|---|---|
libs/contracts/src/content-coverage/inventory-registry.ts |
ca31e1bc6e47c6e4de0fde25ebcd3296590a04aabef6d2158e4da78a9fc2d018 |
scripts/content-coverage/generate-content-inventory.ts |
f82709367bdc669898615aed8d87644e8ab84f6ed76364d41f11275c4a3bd252 |
scripts/content-coverage/generate-content-inventory.test.ts |
a56b738395ae166d724c629024e03f606fa98421c2efea13f9903022a1a608bd |
content-coverage/content-inventory.v1.json |
c914b426b9bceba986392c1f52d00dbe0a1b741a4595036e62715d6ba75e59ca |
content-coverage/content-inventory-report.md |
2fed182eabe427b0788c52c08b199e58d992407f11d9bf3e3eaf2d5a78f04a8f |
.github/workflows/content-slot-contract.yml |
2804d75d2517c024be01a0ba5bd290ec17101da92f73850648b381fe360e3a34 |
package.json |
e5916556278e56f52cae0f3df4117ca3c754e4a1ff5740ff0186c59df8bfface |
Row IDs hash stable identities. Source files carry SHA-256 digests, each row references declared source locators, directory enumeration is sorted, reviewed classifications are frozen maps, and aggregate dimensions/values are sorted. The generator has no wall-clock or random input; the inventory date is fixed.
Automated and adversarial verification#
pnpm verify:content-coverage:inventorypasses targeted ESLint, the script TypeScript project, 10/10 Node test cases, byte-for-byte generated output drift checking, and the contracts source typecheck.- Tests freeze all 54 COV-002 targets and nine direct locale surfaces; prove V1 catalog locales are not inherited by its autonomy/generation rows; freeze all exact/count-only/undeclared observations; verify all 11 modality policies; inventory all 14 manual records; prove every required aggregate dimension and unknown counter; and require ownership on every gap.
- Adversarial cases reject locale-count inflation, accessibility weakening,
unowned gaps, stale aggregates, stale summaries, unknown weakening fields, and
source-digest drift. A second source build and
--checkprove committed output determinism. pnpm verify:contracts:content-slotremains green at 17/17 tests,pnpm verify:contracts:content-dependency-graphremains green at 28/28, andpnpm verify:content-coverage:seed-registryremains green at 10/10 with 68 registered / 7,185 unregistered seed rows.NX_DAEMON=false pnpm exec nx run @oshun/contracts:build --parallel=1passes. A runtimetsxprobe verifies schema version and accessibility helper exports through the root flat export, rootContentCoverageContractsnamespace, and@oshun/contracts/content-coveragesubpath.- The contracts checks/builds ran sequentially. Resource gates observed about 11–12 GiB available RAM, 30 GiB free swap, and 38 GiB free disk. Build memory was polled at least every 30 seconds and remained about 11 GiB available.
- Source pre-commit ESLint, Prettier, asset locking, and V5 documentation
validation passed. The hook's inferred broad typecheck was bypassed with
SKIP_TYPECHECK=1under the host resource policy; focused script/contracts typechecks and resource-gated package builds passed before and after remote integration.
Negative proof and claim boundary#
- This task proves a strict contract, source-backed repository inventory, reviewed modality/accessibility requirements, and deterministic reporting. It does not prove translation quality/completeness, live locale negotiation, artifact accessibility conformance, current production placement, or any deployed row count.
- The inventory still reports zero complete COV-001 slots. Most quantities are deliberately unknown. No COV-002 row is canonicalized and no COV-003 graph is populated. COV-005 still owns release blocking, unknown-shipped detection in release paths, alerts, and runtime reconciliation.
- Static source is not a live artifact or placement receipt. A test fixture is not a translated, accessible, approved, or customer-observed release. No provider result, human approval, or production probe is manufactured.
- No user-facing web/admin/mobile UI, persistence migration, media pipeline, or Unreal asset changed. Playwright/mobile/browser accessibility, database, provider, media, and Unreal execution are therefore inapplicable to COV-004.
Publication identity#
- Implementation source commit:
968c65790ff87e457c8cb7ccc8aff38a6ad38cae - Remote-integrated tested source:
f0665ab54fdf1f62bea260ba51f023bc45c2f52e - Publication metadata commit:
e64c8584ff73f564c3a942b4f52865efe5578040