V44 Gate 5: Add Depositor earning supply intelligence

Add source-safe DepositorEarningSupplyIntelligence for /deposit likely demand, unfit Need opportunities, source criticality, ROI posture, estimate-only BTC compensation ranges, source-to-shares proof boundaries, earning statements, and supply recommendations.

Bind the V44 Depositor earnings supply opportunities artifact, generator, checker, protocol exports, tests, workflow hooks, and draft specification documentation updates.

Validated with V44 gate checks, focused package and UAPI tests, package/UAPI/protocol typechecks, protocol tests, workflow YAML parsing, diff whitespace, ASCII hygiene, and changed-file secret scanning.

Author: geraldarthurdavis

.bitcode/v44-depositor-earnings-supply-opportunities.json

@@ -0,0 +1,362 @@
+{
+  "artifactId": "v44-depositor-earnings-supply-opportunities",
+  "schemaId": "bitcode.v44.depositorEarningsSupplyOpportunities.v1",
+  "version": "V44",
+  "currentTarget": "V43",
+  "sourceSafetyVerdict": "source-safe-depositor-earnings-supply-opportunity-metadata",
+  "generatedAt": "deterministic",
+  "artifactRoot": "v44-depositor-earnings-supply-opportunities:7d08756f3b7ca3d960bcdce1",
+  "passed": true,
+  "objectIds": [
+    "DepositorEarningSupplyIntelligence",
+    "DepositorEarningStatement",
+    "DepositSupplyOpportunity",
+    "UnfitNeedOpportunity",
+    "SourceCriticalityPosture",
+    "ExpectedCompensationRange",
+    "SourceSafeSupplyRecommendation"
+  ],
+  "earningStateIds": [
+    "compensation-range-estimated",
+    "repair-required-before-earning",
+    "blocked-critical-source"
+  ],
+  "recommendationIds": [
+    "approve-for-depository-review",
+    "repair-policy-before-admission",
+    "resynthesize-for-demand",
+    "withhold-critical-source"
+  ],
+  "demandOpportunityStateIds": [
+    "strong-demand-opportunity",
+    "moderate-demand-opportunity",
+    "weak-demand-opportunity"
+  ],
+  "forbiddenPayloadIds": [
+    "protected-source-payloads",
+    "raw-source-text",
+    "unpaid-assetpack-source",
+    "raw-prompts",
+    "interpolated-prompts",
+    "raw-provider-responses",
+    "credentials",
+    "wallet-private-material",
+    "private-settlement-payloads",
+    "value-bearing-mainnet-admission"
+  ],
+  "rows": [
+    {
+      "rowId": "likely-demand-intelligence",
+      "owner": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "contract": "DepositorEarningSupplyIntelligence aggregates likely Reading demand from source-safe option policy evaluations.",
+      "requiredFields": [
+        "likelyDemand",
+        "averageConfidence",
+        "strongDemandOptionCount",
+        "demandRoot"
+      ],
+      "rowRoot": "v44-depositor-earning-supply-row:3f21ab5d35fe3fe66b040e54",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false
+    },
+    {
+      "rowId": "unfit-need-opportunities",
+      "owner": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "contract": "Unfit Need opportunities are represented as source-safe weighted demand signals that guide supply creation without exposing Read or source payloads.",
+      "requiredFields": [
+        "unfitNeedOpportunities",
+        "opportunityCount",
+        "opportunityRoot"
+      ],
+      "rowRoot": "v44-depositor-earning-supply-row:1657685e3e08e02653f801db",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false
+    },
+    {
+      "rowId": "earning-statements",
+      "owner": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "contract": "Depositor earning statements label all values as estimates and expose BTC compensation ranges, ROI, criticality, blockers, warnings, and statement roots.",
+      "requiredFields": [
+        "DepositorEarningStatement",
+        "valueLabel",
+        "expectedCompensationRangeSats",
+        "blocked-critical-source"
+      ],
+      "rowRoot": "v44-depositor-earning-supply-row:0835a42862b22864611d6f1a",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false
+    },
+    {
+      "rowId": "source-safe-supply-recommendations",
+      "owner": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "contract": "Supply recommendations choose approve, repair, resynthesize, or withhold actions from source-safe demand, criticality, ROI, and compensation posture.",
+      "requiredFields": [
+        "approve-for-depository-review",
+        "repair-policy-before-admission",
+        "resynthesize-for-demand",
+        "withhold-critical-source"
+      ],
+      "rowRoot": "v44-depositor-earning-supply-row:95fc05f465a5dbc377888ddf",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false
+    },
+    {
+      "rowId": "deposit-route-earning-readback",
+      "owner": "uapi/app/deposit/DepositPageClient.tsx",
+      "contract": "/deposit renders earning estimates, unfit Need opportunities, source-safe recommendations, and opportunity roots beside the five-step Depositing path.",
+      "requiredFields": [
+        "Supply opportunity",
+        "Earning estimate",
+        "Unfit Need opportunities",
+        "DepositorEarningSupplyIntelligence"
+      ],
+      "rowRoot": "v44-depositor-earning-supply-row:f701e70f93e3ece09d9e402c",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false
+    },
+    {
+      "rowId": "source-to-shares-compensation-basis",
+      "owner": "packages/btd/src/source-to-shares.ts",
+      "contract": "Depositor earning ranges remain estimate-only until future Need-Fit settlement produces source-to-shares allocation receipts.",
+      "requiredFields": [
+        "source-to-shares-largest-remainder",
+        "settlementAllocations",
+        "settlementConservation"
+      ],
+      "rowRoot": "v44-depositor-earning-supply-row:874063553da1f69224274403",
+      "sourceSafeMetadataOnly": true,
+      "protectedSourceVisible": false,
+      "unpaidAssetPackSourceVisible": false
+    }
+  ],
+  "sourceRoots": {
+    "activePointer": "BITCODE_SPEC.txt:4ea77b214c66f69c697bff3d",
+    "spec": "BITCODE_SPEC_V44.md:f42417c87b28658f95bfc5e2",
+    "delta": "BITCODE_SPEC_V44_DELTA.md:67047539c440859038b21e0e",
+    "notes": "BITCODE_SPEC_V44_NOTES.md:65d2a226a68ddc14e10d4f1d",
+    "parity": "BITCODE_SPEC_V44_PARITY_MATRIX.md:720f3406bcadd2098ba3a509",
+    "roadmap": "SPECIFICATIONS_ROADMAP.md:2ef8f1bf59c26479728c3153",
+    "readme": "README.md:a6409b31ee2230d6889bf26f",
+    "protocolReadme": "packages/protocol/README.md:e33e94fa5584a2a44cd49c1f",
+    "packageJson": "package.json:8d6cf25f9345ca24f1a6aa3b",
+    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:11c68267a63ed03d95524e98",
+    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:dfd0de96bd301ec722e4ea67",
+    "economicModel": "packages/protocol/src/canonical/v44-economic-domain-model.js:21b8f5c80ad8322dff2909ed",
+    "portfolioMarketIntelligence": "packages/protocol/src/canonical/v44-packs-portfolio-market-intelligence.js:f5d37e086c9bbbdb6202da53",
+    "optionPolicy": "packages/pipelines/asset-pack/src/deposit-asset-pack-option-policy.ts:12816b23b2d8e304ab4a1638",
+    "earningSupplyIntelligence": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts:e0ec2d83cfaf3bfaaa126387",
+    "earningSupplyIntelligenceTest": "packages/pipelines/asset-pack/src/__tests__/depositor-earning-supply-intelligence.test.ts:3b7a869e6262f6f5ebcc71fe",
+    "depositModel": "uapi/app/deposit/deposit-route-model.ts:b4a51a495a193eff88f1f103",
+    "depositClient": "uapi/app/deposit/DepositPageClient.tsx:3aee0372e480aa8212be7fe0",
+    "depositRouteTest": "uapi/tests/depositRouteModel.test.ts:f60d0f4541bb0dae5d455f13",
+    "depositPageTest": "uapi/tests/depositPageClient.test.tsx:44960f6c465c87194a689958",
+    "assetPackPackageIndex": "packages/pipelines/asset-pack/src/index.ts:4d900afeb3eb6ab1202403ee",
+    "assetPackPackageManifest": "packages/pipelines/asset-pack/package.json:7f4a82493f32385420e2082c",
+    "sourceToShares": "packages/btd/src/source-to-shares.ts:6e2e84251b29ba2477766708",
+    "packageIndex": "packages/protocol/src/index.js:806cfbf3ee86977fead7b928",
+    "packageTypes": "packages/protocol/src/index.d.ts:907bd1de313f4d5503462765",
+    "packageSource": "packages/protocol/src/canonical/v44-depositor-earnings-supply-opportunities.js:cf9cf5f99f00dbf3201c8c8e",
+    "packageTest": "packages/protocol/test/v44-depositor-earnings-supply-opportunities.test.js:1b025c1904f94a1069b64ddf",
+    "generator": "scripts/generate-v44-depositor-earnings-supply-opportunities.mjs:0844124207cbfe8264f12a2f",
+    "checker": "scripts/check-v44-gate5-depositor-earnings-supply-opportunities.mjs:85467da9804f946a18c764ce"
+  },
+  "predicateResults": [
+    {
+      "id": "active-canon-pointer-remains-v43",
+      "sourcePath": "BITCODE_SPEC.txt",
+      "passed": true
+    },
+    {
+      "id": "spec-defines-gate5",
+      "sourcePath": "BITCODE_SPEC_V44.md",
+      "passed": true
+    },
+    {
+      "id": "spec-names-gate5-artifact",
+      "sourcePath": "BITCODE_SPEC_V44.md",
+      "passed": true
+    },
+    {
+      "id": "delta-records-gate5",
+      "sourcePath": "BITCODE_SPEC_V44_DELTA.md",
+      "passed": true
+    },
+    {
+      "id": "notes-records-gate5",
+      "sourcePath": "BITCODE_SPEC_V44_NOTES.md",
+      "passed": true
+    },
+    {
+      "id": "parity-records-gate5",
+      "sourcePath": "BITCODE_SPEC_V44_PARITY_MATRIX.md",
+      "passed": true
+    },
+    {
+      "id": "roadmap-records-gate5",
+      "sourcePath": "SPECIFICATIONS_ROADMAP.md",
+      "passed": true
+    },
+    {
+      "id": "readme-records-gate5",
+      "sourcePath": "README.md",
+      "passed": true
+    },
+    {
+      "id": "protocol-readme-records-gate5",
+      "sourcePath": "packages/protocol/README.md",
+      "passed": true
+    },
+    {
+      "id": "economic-model-prerequisite-present",
+      "sourcePath": "packages/protocol/src/canonical/v44-economic-domain-model.js",
+      "passed": true
+    },
+    {
+      "id": "portfolio-market-prerequisite-present",
+      "sourcePath": "packages/protocol/src/canonical/v44-packs-portfolio-market-intelligence.js",
+      "passed": true
+    },
+    {
+      "id": "option-policy-prerequisite-present",
+      "sourcePath": "packages/pipelines/asset-pack/src/deposit-asset-pack-option-policy.ts",
+      "passed": true
+    },
+    {
+      "id": "earning-intelligence-defines-builder",
+      "sourcePath": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "passed": true
+    },
+    {
+      "id": "earning-intelligence-defines-demand",
+      "sourcePath": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "passed": true
+    },
+    {
+      "id": "earning-intelligence-defines-statements",
+      "sourcePath": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "passed": true
+    },
+    {
+      "id": "earning-intelligence-defines-recommendations",
+      "sourcePath": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "passed": true
+    },
+    {
+      "id": "earning-intelligence-forbids-source-leakage",
+      "sourcePath": "packages/pipelines/asset-pack/src/depositor-earning-supply-intelligence.ts",
+      "passed": true
+    },
+    {
+      "id": "asset-pack-package-exports-intelligence",
+      "sourcePath": "packages/pipelines/asset-pack/src/index.ts",
+      "passed": true
+    },
+    {
+      "id": "asset-pack-manifest-exports-intelligence",
+      "sourcePath": "packages/pipelines/asset-pack/package.json",
+      "passed": true
+    },
+    {
+      "id": "deposit-model-uses-intelligence",
+      "sourcePath": "uapi/app/deposit/deposit-route-model.ts",
+      "passed": true
+    },
+    {
+      "id": "deposit-client-renders-earnings",
+      "sourcePath": "uapi/app/deposit/DepositPageClient.tsx",
+      "passed": true
+    },
+    {
+      "id": "earning-test-covers-intelligence",
+      "sourcePath": "packages/pipelines/asset-pack/src/__tests__/depositor-earning-supply-intelligence.test.ts",
+      "passed": true
+    },
+    {
+      "id": "route-test-covers-intelligence",
+      "sourcePath": "uapi/tests/depositRouteModel.test.ts",
+      "passed": true
+    },
+    {
+      "id": "page-test-covers-intelligence",
+      "sourcePath": "uapi/tests/depositPageClient.test.tsx",
+      "passed": true
+    },
+    {
+      "id": "source-to-shares-prerequisite-present",
+      "sourcePath": "packages/btd/src/source-to-shares.ts",
+      "passed": true
+    },
+    {
+      "id": "package-test-covers-gate5",
+      "sourcePath": "packages/protocol/test/v44-depositor-earnings-supply-opportunities.test.js",
+      "passed": true
+    },
+    {
+      "id": "package-exports-gate5",
+      "sourcePath": "packages/protocol/src/index.js",
+      "passed": true
+    },
+    {
+      "id": "package-types-export-gate5",
+      "sourcePath": "packages/protocol/src/index.d.ts",
+      "passed": true
+    },
+    {
+      "id": "package-json-exposes-gate5",
+      "sourcePath": "package.json",
+      "passed": true
+    },
+    {
+      "id": "gate-workflow-runs-gate5",
+      "sourcePath": ".github/workflows/bitcode-gate-quality.yml",
+      "passed": true
+    },
+    {
+      "id": "canon-workflow-runs-gate5",
+      "sourcePath": ".github/workflows/bitcode-canon-quality.yml",
+      "passed": true
+    },
+    {
+      "id": "generator-exists",
+      "sourcePath": "scripts/generate-v44-depositor-earnings-supply-opportunities.mjs",
+      "passed": true
+    },
+    {
+      "id": "checker-exists",
+      "sourcePath": "scripts/check-v44-gate5-depositor-earnings-supply-opportunities.mjs",
+      "passed": true
+    }
+  ],
+  "coverage": {
+    "depositorEarningSupplyIntelligenceImplemented": true,
+    "likelyDemandImplemented": true,
+    "unfitNeedOpportunitiesImplemented": true,
+    "roiPostureImplemented": true,
+    "sourceCriticalityPostureImplemented": true,
+    "expectedCompensationRangesImplemented": true,
+    "earningStatementsImplemented": true,
+    "sourceSafeSupplyRecommendationsImplemented": true,
+    "depositRouteUiImplemented": true,
+    "sourceToSharesEstimateBoundaryImplemented": true,
+    "sourceSafeMetadataOnly": true,
+    "protectedSourceVisible": false,
+    "rawSourceTextVisible": false,
+    "sourceSnippetVisible": false,
+    "rawPromptVisible": false,
+    "interpolatedPromptVisible": false,
+    "rawProviderResponseVisible": false,
+    "unpaidAssetPackSourceVisible": false,
+    "credentialsSerialized": false,
+    "walletPrivateMaterialVisible": false,
+    "settlementPrivatePayloadVisible": false,
+    "valueBearingMainnetAdmitted": false,
+    "requiredPredicateCount": 33,
+    "passedPredicateCount": 33,
+    "failedPredicateIds": []
+  }
+}