docs(commercial): separate USD 20B quality from contract readiness

[seonghobae]

Fixes #161 only when this candidate reaches protected main.

Product-contract repair

Wardnet had one misleading historical filename, docs/commercial/20b-krw-sale-readiness.md, even though the runtime contract and document body define a 2B KRW customer-contract readiness predicate. That naming defect made it too easy to conflate a customer field with the standing USD 20 billion software-sale quality ambition.

This slice keeps the two authorities separate without changing runtime pricing or readiness behavior:

• docs/commercial/2b-krw-customer-contract-readiness.md is the canonical customer-contract/readiness document and retains the existing 2_000_000_000 KRW predicate;
• docs/commercial/usd-20b-product-quality-bar.md defines the USD 20 billion ambition as a buyer-visible product/security/operability/release/integration quality bar, never as tenant pricing, billing, ARR, accounting, or annual_contract_value_krw;
• the old 20b-krw path becomes a compatibility shim because protected-main evidence manifests currently publish that path; this avoids an unversioned API/document-manifest break;
• README and CLAUDE guidance point to the canonical 2B customer-contract document plus the separate USD 20B quality document;
• the repository integration test rejects remapping TARGET_SALE_VALUE_KRW to 20B KRW and keeps customer/readiness, product-quality, and compatibility authorities explicit.

TDD / single-writer history

RED 6adb83af0be136ae96c95132fa625bf752f24642 added the executable authority-boundary contract before the canonical documents existed. GREEN lineage 007146411f4585ae8ee2410e4a54d44ff65e3cbd → 299ccbd124d8a74243c6a6a50d6e1ff97ca28806 → 2de85e45bf99225561728b45914182e9d2fed901, followed by formatting/reference repairs, supplies the separated authorities and compatibility shim.

A later gap-ledger attempt was removed after fresh inventory proved PR #130 already owns docs/product-technical-gap-baseline.md. Current effective delta does not touch that single-writer path. The runtime constant remains TARGET_SALE_VALUE_KRW = 2_000_000_000; this PR does not assert that 2B KRW is a product valuation and does not create billing/accounting authority.

Fresh protected-main integration — 2026-09-05 KST

Protected/default main is exact 5829a0f08d78de464dd24393ce5d0f25fba9d126 after merged #159. The prior candidate bd41d8430b269cbd9b440d225e1d53b28a4fe817 was 11 protected commits behind. Fresh compare proved the intervening protected delta changed only .github/workflows/{ci,fuzz,scorecard-analysis}.yml, AGENTS.md, and the two workflow runner/queue contract tests; none overlaps this six-file commercial-authority slice.

The branch was therefore repaired non-destructively with merge commit c5ee24d5ddcf2031decb21869410aef51cdda6fa, preserving the full prior branch and exact protected main as parents. No force push or destructive rebase was used. Fresh compare against protected main reports behind_by=0; the effective delta is exactly:

• CLAUDE.md
• README.md
• docs/commercial/20b-krw-sale-readiness.md
• docs/commercial/2b-krw-customer-contract-readiness.md
• docs/commercial/usd-20b-product-quality-bar.md
• tests/commercial_authority_architecture.rs

All predecessor workflow/review evidence is historical after this ancestry movement. Exact-head runs have materialized for c5ee24d5... but are currently non-passing/queued: CI 33907112694, Security Scan 33907112695, SAST Semgrep 33907112712, CodeQL PR 33907112611. Queued state is not merge evidence and is covered by the central runner/control-plane owner path.

Keep Draft until unchanged c5ee24d5ddcf2031decb21869410aef51cdda6fa has terminal exact-head repository/security/coverage/central review/thread/governance evidence and the solo-maintainer rule is satisfiable without self/model approval. Do not use routine bypass, gate weakening, no-op dispatch commits, mutable foreign authority, or predecessor evidence reuse.

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}