Merge pull request #234 from engineeredsoftware/v47/gate-2-feature-excess-alignment-audit

V47 Gate 2: Feature Excess And Alignment Audit

Author: geraldarthurdavis

.bitcode/v46-local-interface-comprehension-rehearsal.json

@@ -799,18 +799,18 @@
     "delta": "BITCODE_SPEC_V46_DELTA.md:a16a16db40d4eeae612a0657",
     "notes": "BITCODE_SPEC_V46_NOTES.md:cca70aca3566132e7026351c",
     "parity": "BITCODE_SPEC_V46_PARITY_MATRIX.md:91b47eeaa106639d2d21856b",
-    "roadmap": "SPECIFICATIONS_ROADMAP.md:9a349af9258300768b8fc758",
+    "roadmap": "SPECIFICATIONS_ROADMAP.md:d77398b3e03ad727d9275b66",
     "readme": "README.md:d28ec731634e03953d8adfe6",
     "protocolReadme": "packages/protocol/README.md:f5b175049f4f4e8df179e184",
-    "packageJson": "package.json:9985108aaea23b4bb4f5e7a9",
-    "packageIndex": "packages/protocol/src/index.js:1f16ea428bd71351a1292cb6",
-    "packageTypes": "packages/protocol/src/index.d.ts:278dfc652c621533b5e86f4d",
-    "packageSource": "packages/protocol/src/canonical/v46-local-interface-comprehension-rehearsal.js:ea56065835a819cd454c5558",
+    "packageJson": "package.json:47e46090fa44c01d26069bfb",
+    "packageIndex": "packages/protocol/src/index.js:41a9fb2ceea33ad0a2eb5585",
+    "packageTypes": "packages/protocol/src/index.d.ts:0668307b7b1f6262432f32e0",
+    "packageSource": "packages/protocol/src/canonical/v46-local-interface-comprehension-rehearsal.js:79ee15948652b8909022052e",
     "packageTest": "packages/protocol/test/v46-local-interface-comprehension-rehearsal.test.js:5b6ad282088791ea76ec2bbf",
     "generator": "scripts/generate-v46-local-interface-comprehension-rehearsal.mjs:d6a9dadb6f8ee51de50a529f",
     "checker": "scripts/check-v46-gate7-local-interface-comprehension-rehearsal.mjs:beb49c72404e73e730640a72",
-    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:7cb34abd82e64e1fb32946b0",
-    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:7e675adc942626fc2048a266",
+    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:0cc93a50c149a253eb60287a",
+    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:31089b944c381ce30c0633db",
     "v46ProtocolArtifact": ".bitcode/v46-protocol-comprehension-object-model.json:b09508f0d7841284effb0e01",
     "v46PublicArtifact": ".bitcode/v46-public-operator-claim-boundaries.json:352e9021ffbe43d650923b98",
     "v46ProductArtifact": ".bitcode/v46-product-route-comprehension-readback.json:c5d1d887915cb920288b18a8",

.bitcode/v47-feature-excess-alignment-audit.json

@@ -0,0 +1,356 @@
+{
+  "artifactId": "v47-feature-excess-alignment-audit",
+  "schemaId": "bitcode.v47.featureExcessAlignmentAudit.v1",
+  "version": "V47",
+  "currentTarget": "V46",
+  "sourceSafetyVerdict": "source-safe-launch-scope-metadata",
+  "generatedAt": "deterministic",
+  "artifactRoot": "v47-feature-excess-alignment-audit:07dd51ab80528e971790e5c1",
+  "passed": true,
+  "launchRouteIds": [
+    "/deposit",
+    "/read",
+    "/packs"
+  ],
+  "supportingSurfaceIds": [
+    "/",
+    "/docs",
+    "/auxillaries",
+    "/btd/[assetPackId]",
+    "/executions/[runId]",
+    "/api/activity",
+    "/api/deposits",
+    "/api/read-review",
+    "/api/make-bitcode-branch",
+    "/api/executions"
+  ],
+  "deferredSurfaceIds": [
+    "/terminal direct product entry",
+    "/conversations direct commercial launch",
+    "/exchange direct product entry",
+    "/orbitals direct route family",
+    "/edgetimes",
+    "/demo-video",
+    "ChatGPT App commercialization",
+    "MCP/API commercialization",
+    "Bitcode Chat commercialization",
+    "value-bearing mainnet BTC settlement",
+    "advanced market mechanics"
+  ],
+  "featurePolicyIds": [
+    "public-nav-current-routes-only",
+    "landing-cta-current-routes-only",
+    "btd-detail-current-routes-only",
+    "exchange-compatibility-redirect-only",
+    "terminal-direct-entry-flaggable",
+    "conversations-direct-entry-flaggable",
+    "testnet-btc-only",
+    "source-safe-preview-only"
+  ],
+  "forbiddenLaunchEntryTargets": [
+    "/terminal?intent=acquire-btd",
+    "/terminal?intent=submit-read-for-btd",
+    "/exchange?intent=buy-existing-btd",
+    "router.push('/terminal')",
+    "window.location.assign('/terminal"
+  ],
+  "forbiddenPayloadIds": [
+    "protected_source_payload",
+    "raw_source_text",
+    "unpaid_assetpack_source",
+    "raw_protected_prompt",
+    "interpolated_prompt",
+    "raw_provider_response",
+    "wallet_private_material",
+    "settlement_private_payload",
+    "mainnet_value_bearing_payment_secret"
+  ],
+  "auditRows": [
+    {
+      "rowId": "launch-routes-are-current-product-entrypoints",
+      "classification": "launch",
+      "owner": "website-product-routes",
+      "routeIds": [
+        "/deposit",
+        "/read",
+        "/packs"
+      ],
+      "policy": "The V47 website MVP opens through Deposit, Read, and Packs; public navigation and landing acquisition actions must point at those route roots.",
+      "requiredPolicyIds": [
+        "public-nav-current-routes-only",
+        "landing-cta-current-routes-only"
+      ],
+      "rowRoot": "v47-feature-excess-row:ea73c2d5b16a4df3e4c7a7dc",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false,
+      "launchBlockingWhenViolated": true
+    },
+    {
+      "rowId": "compatibility-routes-cannot-own-product-state",
+      "classification": "compatibility",
+      "owner": "compatibility-routes",
+      "routeIds": [
+        "/exchange",
+        "/btd/[assetPackId]"
+      ],
+      "policy": "Compatibility routes may preserve old links only when they redirect or point into Packs/Read and do not claim independent Exchange or Terminal product authority.",
+      "requiredPolicyIds": [
+        "exchange-compatibility-redirect-only",
+        "btd-detail-current-routes-only"
+      ],
+      "rowRoot": "v47-feature-excess-row:e191b697d12abdddde5f2d14",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false,
+      "launchBlockingWhenViolated": true
+    },
+    {
+      "rowId": "retained-workspaces-are-flagged-or-direct-only",
+      "classification": "deferred",
+      "owner": "retained-workspaces",
+      "routeIds": [
+        "/terminal",
+        "/conversations"
+      ],
+      "policy": "Terminal and Conversations remain retained operator/composition workspaces; they must not be primary launch CTAs and direct entry must be flaggable for launch mode.",
+      "requiredPolicyIds": [
+        "terminal-direct-entry-flaggable",
+        "conversations-direct-entry-flaggable"
+      ],
+      "rowRoot": "v47-feature-excess-row:7f5941cec87ea2b766915ab6",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false,
+      "launchBlockingWhenViolated": true
+    },
+    {
+      "rowId": "commercial-surfaces-deferred",
+      "classification": "deferred",
+      "owner": "non-website-commercial-surfaces",
+      "routeIds": [
+        "MCP/API",
+        "ChatGPT App",
+        "Bitcode Chat"
+      ],
+      "policy": "API/MCP, ChatGPT App, and Bitcode Chat are protocol/interface surfaces only in V47 and must not be presented as commercially launched website flows.",
+      "requiredPolicyIds": [
+        "testnet-btc-only",
+        "source-safe-preview-only"
+      ],
+      "rowRoot": "v47-feature-excess-row:ad4ea3f63b6f0cf6dd67212d",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false,
+      "launchBlockingWhenViolated": true
+    },
+    {
+      "rowId": "source-and-value-boundaries-remain-launch-blockers",
+      "classification": "blocked",
+      "owner": "source-safety-and-mainnet",
+      "routeIds": [
+        "mainnet settlement",
+        "source-bearing preview"
+      ],
+      "policy": "V47 testnet launch cannot expose unpaid AssetPack source, raw prompts, raw provider responses, secrets, wallet private material, or value-bearing mainnet settlement.",
+      "requiredPolicyIds": [
+        "testnet-btc-only",
+        "source-safe-preview-only"
+      ],
+      "rowRoot": "v47-feature-excess-row:7ab47362d3f4342bfaae9cf7",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false,
+      "launchBlockingWhenViolated": true
+    }
+  ],
+  "sourceRoots": {
+    "activePointer": "BITCODE_SPEC.txt:820a850b09546da1a1a1c447",
+    "spec": "BITCODE_SPEC_V47.md:9ccb78b6f22f1360552940a4",
+    "delta": "BITCODE_SPEC_V47_DELTA.md:949e8f86783da80db60e5d58",
+    "notes": "BITCODE_SPEC_V47_NOTES.md:c2951a1b11a87828391f1961",
+    "parity": "BITCODE_SPEC_V47_PARITY_MATRIX.md:6c48efc4b067a78e947c85d8",
+    "roadmap": "SPECIFICATIONS_ROADMAP.md:d77398b3e03ad727d9275b66",
+    "publicCopy": "uapi/components/base/bitcode/layout/bitcode-public-copy.ts:9b39322f872b899e1c752701",
+    "nav": "uapi/components/base/bitcode/layout/nav.tsx:2b2eaaf65982969883af8d1e",
+    "features": "uapi/config/features.ts:6ff2da113ab17dfc468d7461",
+    "workspaceSurface": "uapi/components/base/bitcode/layout/workspace-surface.ts:12418d5db9c3ddad6d10c841",
+    "home": "uapi/app/page.tsx:b1b707e58f8917b8a97717b4",
+    "heroClient": "uapi/app/hero-client.tsx:2a524ab6b50787be4414f8ba",
+    "marketingPricing": "uapi/app/(root)/components/MarketingPricingSection.tsx:6eda1c0801da2e0e2b6dc47c",
+    "packsPage": "uapi/app/packs/page.tsx:1b3d7a1cc00500a13042e8dd",
+    "readPage": "uapi/app/read/page.tsx:37a723ed87feac05c0504249",
+    "depositPage": "uapi/app/deposit/page.tsx:6bab6a9debab3f4350d0ddca",
+    "terminalPage": "uapi/app/terminal/page.tsx:6b75306c69248605ab1bb69b",
+    "conversationsPage": "uapi/app/conversations/page.tsx:bb3f749e94dbe158142bbe0d",
+    "exchangePage": "uapi/app/exchange/page.tsx:be7a744d1f9c9252d1b6eba9",
+    "exchangeReadme": "uapi/app/exchange/README.md:3a0b7052de6be76fcda2b094",
+    "btdDetailPage": "uapi/app/btd/[assetPackId]/page.tsx:b94efe66179c2a2a27bde659",
+    "packageJson": "package.json:47e46090fa44c01d26069bfb",
+    "protocolIndex": "packages/protocol/src/index.js:41a9fb2ceea33ad0a2eb5585",
+    "protocolTypes": "packages/protocol/src/index.d.ts:0668307b7b1f6262432f32e0",
+    "protocolSource": "packages/protocol/src/canonical/v47-feature-excess-alignment-audit.js:c96a52d2511eff4d321a61e3",
+    "protocolTest": "packages/protocol/test/v47-feature-excess-alignment-audit.test.js:d4eb230b98bcbc3ee18af459",
+    "generator": "scripts/generate-v47-feature-excess-alignment-audit.mjs:1132b37cd29dddc216db998d",
+    "checker": "scripts/check-v47-gate2-feature-excess-alignment-audit.mjs:007c139e5c0a60e0d621e7f4",
+    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:0cc93a50c149a253eb60287a",
+    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:31089b944c381ce30c0633db"
+  },
+  "predicateResults": [
+    {
+      "id": "active-canon-pointer-remains-v46",
+      "sourcePath": "BITCODE_SPEC.txt",
+      "passed": true
+    },
+    {
+      "id": "spec-records-gate2-feature-excess",
+      "sourcePath": "BITCODE_SPEC_V47.md",
+      "passed": true
+    },
+    {
+      "id": "delta-records-gate2-artifact",
+      "sourcePath": "BITCODE_SPEC_V47_DELTA.md",
+      "passed": true
+    },
+    {
+      "id": "notes-record-gate2-policy",
+      "sourcePath": "BITCODE_SPEC_V47_NOTES.md",
+      "passed": true
+    },
+    {
+      "id": "parity-records-gate2-closure",
+      "sourcePath": "BITCODE_SPEC_V47_PARITY_MATRIX.md",
+      "passed": true
+    },
+    {
+      "id": "roadmap-records-gate2-closure",
+      "sourcePath": "SPECIFICATIONS_ROADMAP.md",
+      "passed": true
+    },
+    {
+      "id": "public-nav-current-routes-only",
+      "sourcePath": "uapi/components/base/bitcode/layout/bitcode-public-copy.ts",
+      "passed": true
+    },
+    {
+      "id": "landing-cta-current-routes-only",
+      "sourcePath": "uapi/app/hero-client.tsx",
+      "passed": true
+    },
+    {
+      "id": "marketing-acquisition-current-routes-only",
+      "sourcePath": "uapi/app/(root)/components/MarketingPricingSection.tsx",
+      "passed": true
+    },
+    {
+      "id": "btd-detail-current-routes-only",
+      "sourcePath": "uapi/app/btd/[assetPackId]/page.tsx",
+      "passed": true
+    },
+    {
+      "id": "exchange-compatibility-redirect-only",
+      "sourcePath": "uapi/app/exchange/page.tsx",
+      "passed": true
+    },
+    {
+      "id": "terminal-direct-entry-flaggable",
+      "sourcePath": "uapi/components/base/bitcode/layout/nav.tsx",
+      "passed": true
+    },
+    {
+      "id": "terminal-metadata-retained-operator-workspace",
+      "sourcePath": "uapi/app/terminal/page.tsx",
+      "passed": true
+    },
+    {
+      "id": "conversations-direct-entry-flaggable",
+      "sourcePath": "uapi/app/conversations/page.tsx",
+      "passed": true
+    },
+    {
+      "id": "feature-config-owns-deferred-flags",
+      "sourcePath": "uapi/config/features.ts",
+      "passed": true
+    },
+    {
+      "id": "public-shell-launch-routes-classified",
+      "sourcePath": "uapi/components/base/bitcode/layout/workspace-surface.ts",
+      "passed": true
+    },
+    {
+      "id": "public-launch-sources-avoid-deferred-entry-targets",
+      "sourcePath": "uapi/components/base/bitcode/layout/bitcode-public-copy.ts",
+      "passed": true
+    },
+    {
+      "id": "protocol-test-covers-artifact",
+      "sourcePath": "packages/protocol/test/v47-feature-excess-alignment-audit.test.js",
+      "passed": true
+    },
+    {
+      "id": "protocol-package-exports-gate2",
+      "sourcePath": "packages/protocol/src/index.js",
+      "passed": true
+    },
+    {
+      "id": "protocol-types-export-gate2",
+      "sourcePath": "packages/protocol/src/index.d.ts",
+      "passed": true
+    },
+    {
+      "id": "package-json-exposes-gate2",
+      "sourcePath": "package.json",
+      "passed": true
+    },
+    {
+      "id": "gate-workflow-runs-gate2",
+      "sourcePath": ".github/workflows/bitcode-gate-quality.yml",
+      "passed": true
+    },
+    {
+      "id": "canon-workflow-runs-gate2",
+      "sourcePath": ".github/workflows/bitcode-canon-quality.yml",
+      "passed": true
+    },
+    {
+      "id": "generator-exists",
+      "sourcePath": "scripts/generate-v47-feature-excess-alignment-audit.mjs",
+      "passed": true
+    },
+    {
+      "id": "checker-exists",
+      "sourcePath": "scripts/check-v47-gate2-feature-excess-alignment-audit.mjs",
+      "passed": true
+    }
+  ],
+  "coverage": {
+    "websiteLaunchRoutesOnly": true,
+    "publicNavCurrentRoutesOnly": true,
+    "launchCtasCurrentRoutesOnly": true,
+    "btdDetailCurrentRoutesOnly": true,
+    "exchangeCompatibilityRedirectOnly": true,
+    "terminalDirectEntryFlaggable": true,
+    "conversationsDirectEntryFlaggable": true,
+    "nonWebsiteCommercialSurfacesDeferred": true,
+    "testnetBtcOnly": true,
+    "sourceSafePreviewOnly": true,
+    "launchRouteCount": 3,
+    "supportingSurfaceCount": 10,
+    "deferredSurfaceCount": 11,
+    "launchAuditRowCount": 1,
+    "deferredAuditRowCount": 2,
+    "sourceSafeMetadataOnly": true,
+    "protectedSourceVisible": false,
+    "rawSourceTextVisible": false,
+    "unpaidAssetPackSourceVisible": false,
+    "rawPromptVisible": false,
+    "interpolatedPromptVisible": false,
+    "rawProviderResponseVisible": false,
+    "walletPrivateMaterialVisible": false,
+    "settlementPrivatePayloadVisible": false,
+    "valueBearingMainnetEnabled": false,
+    "requiredPredicateCount": 25,
+    "passedPredicateCount": 25,
+    "failedPredicateIds": []
+  }
+}

.github/workflows/bitcode-canon-quality.yml

@@ -454,6 +454,9 @@ jobs:
               if [ -f scripts/check-v47-gate1-scope-measurement-launch-freeze.mjs ]; then
                 node scripts/check-v47-gate1-scope-measurement-launch-freeze.mjs --skip-branch-check
               fi
+              if [ -f scripts/check-v47-gate2-feature-excess-alignment-audit.mjs ]; then
+                node scripts/check-v47-gate2-feature-excess-alignment-audit.mjs --skip-branch-check --skip-uapi-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2