Canonical Documentation Map

This is the canonical index for all V1 live documentation. It is the single source of truth for which docs are active, which are evidence, and which are internal-only.

1. V1 Live Status

Doc	Path	Canonical
V1 Live Truth Matrix	docs/launch/v1-live-truth-matrix.md	✅
V1 Live Evidence Index	docs/launch/v1-live-evidence-index.md	✅
Post-Cloud Publication Plan	docs/launch/post-cloud-publication-plan.md	✅
Truth Matrix JSON	static/ai/v1/v1-live-truth-matrix.json	✅
Provider Validation Plan JSON	static/ai/v1/provider-live-validation-plan.json	✅
Launch Status (start-here)	docs/start-here/launch-status.md	✅
Current Status	docs/start-here/current-status.md	✅

2. Provider Lifecycle

Doc	Path	Canonical
ProviderFlow README (index)	docs/providerflow/README.md	✅
ProviderFlow Overview	docs/providerflow/overview.md	✅
Package Contract	docs/providerflow/package-contract.md	✅
YAML/DAG Contract	docs/providerflow/yaml-dag-contract.md	✅
Package Validation	docs/providerflow/package-validation.md	✅
Security Model	docs/providerflow/security-model.md	✅
Fixtures, Goldens, Traces	docs/providerflow/fixtures-goldens-traces.md	✅
Provider Package Lifecycle	docs/providerflow/provider-package-lifecycle.md	✅
V1 Provider Package Readiness Matrix	docs/providerflow/provider-package-v1-readiness-matrix.md	✅
Known Nonclaims	docs/providerflow/nonclaims.md	✅
Template Packs	docs/providerflow/template-packs.md	✅
Post-Cloud Validation Overview	docs/providerflow/post-cloud-provider-validation-overview.md	✅
Provider Test Account Checklist	docs/providerflow/provider-test-account-checklist.md	✅

Provider Packages

Package	Path	Maturity
Stripe v2	docs/providerflow/packages/stripe-v2.md	GA
GitHub v2	docs/providerflow/packages/github-v2.md	GA
Shopify v2	docs/providerflow/packages/shopify-v2.md	Preview
Twilio v2	docs/providerflow/packages/twilio-v2.md	Preview
Doppler (internal)	docs/providerflow/packages/doppler-internal.md	Internal
GitLab (internal)	docs/providerflow/packages/gitlab-internal.md	Internal
Terraform Cloud (internal)	docs/providerflow/packages/terraform-cloud-internal.md	Internal

Post-Cloud Validation Runbooks

Runbook	Path
Stripe Post-Cloud	docs/providerflow/stripe-post-cloud-validation-runbook.md
GitHub Post-Cloud	docs/providerflow/github-post-cloud-validation-runbook.md
Shopify Post-Cloud	docs/providerflow/shopify-post-cloud-validation-runbook.md
Twilio Post-Cloud	docs/providerflow/twilio-post-cloud-validation-runbook.md

Evidence Templates

Template	Path
Stripe Evidence Template	docs/providerflow/evidence-templates/stripe-live-validation-evidence-template.md
GitHub Evidence Template	docs/providerflow/evidence-templates/github-live-validation-evidence-template.md
Shopify Evidence Template	docs/providerflow/evidence-templates/shopify-live-validation-evidence-template.md
Twilio Evidence Template	docs/providerflow/evidence-templates/twilio-live-validation-evidence-template.md
Evidence Schema	docs/providerflow/evidence-templates/provider-live-validation-evidence.schema.json

3. Provider Integration Guides

Guide	Path	Canonical
Sources	docs/guides/sources.md	✅
Endpoints	docs/guides/endpoints.md	✅
Destinations	docs/guides/destinations.md	✅
Stripe Guide	docs/guides/stripe.md	✅
GitHub Guide	docs/guides/github.md	✅
Shopify Guide	docs/guides/shopify.md	✅
Twilio Guide	docs/guides/twilio.md	✅
Custom Webhooks	docs/guides/custom-webhooks.md	✅
Adapters	docs/guides/adapters.md	✅
Monitoring	docs/guides/monitoring.md	✅
Cluster Enrollment	docs/guides/cluster-enrollment.md	✅

4. Security / Public Trust

Doc	Path	Canonical
Security Posture (AI)	docs/ai/security-posture.md	✅
V1 Security Validation Summary	docs/ai/v1-security-validation-summary.md	✅
Security Capability Validation	docs/security/security-capability-validation.md	✅
Security Validation Suite	docs/security/security-validation-suite.md	✅
Security Validation V1 Cutline	docs/security/security-validation-v1-cutline.md	✅
Trust Lab	docs/security/trust-lab.md	✅
Trust Scenario Registry	docs/security/trust-scenario-registry.md	✅
V1 Security Readiness Checklist	docs/security/v1-security-readiness-checklist.md	✅
Security Tiering	docs/security/security-tiering.md	✅
Tenant Isolation	docs/security/tenant-isolation.md	✅
IP Allowlisting	docs/security/ip-allowlisting.md	✅
Header Validation	docs/security/header-validation.md	✅
Cryptographic Enrollment	docs/security/cryptographic-enrollment.md	✅
Secure Webhook Delivery	docs/security/secure-webhook-delivery.md	✅
Webhook Access Control	docs/security/webhook-access-control.md	✅
ZenLock Credential Lifecycle	docs/security/zenlock-credential-lifecycle.md	✅
Agent SaaS mTLS	docs/security/agent-saas-mtls.md	✅
Non-Claims (AI)	docs/ai/non-claims.md	✅
Public Surface Traceability	docs/ai/public-surface-traceability.md	✅
Public Terminology Taxonomy	docs/ai/public-terminology-taxonomy.md	✅
AI Overview	docs/ai/overview.md	✅
Public Docs Claim Audit	docs/evidence/public-docs-claim-audit.md	Evidence
Evidence Non-Claims	docs/evidence/non-claims.md	✅

5. Fabric

Doc	Path	Status
Three-Plane Model	docs/architecture/three-plane-model.md	local_ready
Platform Layers	docs/architecture/platform-layers.md	local_ready
Delivery Modes	docs/architecture/delivery-modes.md	Active

Fabric Planes and Adapters are tracked in the truth matrix under their respective statuses (local_ready, contract_verified). No dedicated Fabric docs page exists beyond the architecture docs.

6. Billing

Doc	Path	Status
Billing Terms	docs/legal/billing-terms.md	Archived (draft template)
Plans and Limits	docs/start-here/plans-and-limits.md	Active
Launch Status	docs/start-here/launch-status.md	Active

Stripe billing is cloud_gated in the truth matrix. Post-cloud validation of billing requires the control plane deploy first (see post-cloud validation sequence).

7. Cloud / Live Operations

Doc	Path	Status
Backups	docs/operations/backups.md	cloud_gated
Troubleshooting	docs/operations/troubleshooting.md	Active
Upgrades	docs/operations/upgrades.md	Active
Gateway API Migration	docs/networking/gateway-api-migration.md	Active
Prod Revalidation Runbook	docs/runbooks/prod-revalidation.md	Active
Rollback and Abort	docs/runbooks/rollback-and-abort.md	Active
Prod Republish	docs/runbooks/prod-republish.md	Active

8. Guardrails

Policy	Location
Public Surface Update Policy	docs/20-OPERATIONS/PUBLIC_SURFACE_UPDATE_POLICY.md
Canonical Docs Map (this file)	docs/README_CANONICAL_DOCS_MAP.md
Docs Consolidation Log	docs/DOCS_CONSOLIDATION_LOG.md
Evidence Navigation Index	docs/evidence/evidence-index.md
Hooks-only validation	zen-platform repo
No .github / workflows	Policy
Fixed report paths	/tmp/docsai-report.{md,json}
No bypass / no force-push	Policy

9. Archive / Evidence-Only Docs

These are historical or evidence artifacts, or archived docs. They are not active navigation docs and should not be treated as canonical references:

• docs/80-EVIDENCE/* — All audit evidence (see Evidence Index for classification)
• docs/evidence/public-docs-claim-audit.{json,md} — Historical claim audit
• docs/ai/evidence-v1-supersession.md — Supersession log
• docs/99-ARCHIVE/ — Archived docs (see docs/99-ARCHIVE/ARCHIVE_MANIFEST for details)
• docs/legal/*.md — Archived as draft templates (all 12 legal docs)
• docs/mcp/authentication.md — Archived, superseded by authentication-and-mtls.md
• docs/delivery/replay.md — Superseded by replay-and-recovery.md
• docs/delivery/deduplication-vs-idempotency.md — Superseded by individual files
• docs/delivery/replay-vs-retry.md — Superseded by individual files
• docs/delivery/routing-and-fan-out.md — Superseded by individual files
• docs/reference/api.md — Superseded by docs/api/*
• docs/reference/mcp.md — Superseded by docs/mcp/*

Provider Status (Canonical)

Provider	Maturity	Live E2E	Launch Gate
Stripe	verified	cloud_gated	NO_GO
GitHub	verified	cloud_gated	NO_GO
Shopify	verified	cloud_gated	NO_GO
Twilio	verified	cloud_gated	NO_GO

Public launch remains NO_GO until all launch gates pass.