settld 0.1.2 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (483) hide show
  1. package/README.md +93 -3
  2. package/SETTLD_VERSION +1 -1
  3. package/bin/settld-mcp +2 -0
  4. package/bin/settld.js +71 -0
  5. package/conformance/kernel-v0/README.md +7 -0
  6. package/conformance/kernel-v0/run.mjs +292 -4
  7. package/docs/ACCESS.md +57 -0
  8. package/docs/ADOPTION_CHECKLIST.md +44 -0
  9. package/docs/ALERTS.md +198 -0
  10. package/docs/ARCHITECTURE.md +69 -0
  11. package/docs/ARCHITECTURE_FOUNDER_GUIDE.md +284 -0
  12. package/docs/ARTIFACTS.md +60 -0
  13. package/docs/CERTIFICATION_CHECKLIST.md +33 -0
  14. package/docs/CIRCLE_SANDBOX_E2E.md +152 -0
  15. package/docs/CONFIG.md +297 -0
  16. package/docs/CONTRACTS_APIS.md +23 -0
  17. package/docs/DEPRECATION.md +31 -0
  18. package/docs/DOMAIN_MODEL.md +92 -0
  19. package/docs/EVENT_ENVELOPE.md +53 -0
  20. package/docs/FINANCE_PACK_FORMAT.md +53 -0
  21. package/docs/INCIDENT_TAXONOMY.md +30 -0
  22. package/docs/JOB_STATE_MACHINE.md +66 -0
  23. package/docs/KERNEL_COMPATIBLE.md +60 -0
  24. package/docs/KERNEL_V0.md +40 -0
  25. package/docs/KEY_ROTATION.md +80 -0
  26. package/docs/LEDGER.md +82 -0
  27. package/docs/LIVENESS.md +76 -0
  28. package/docs/MVP_BUILD_ORDER.md +36 -0
  29. package/docs/ONCALL_PLAYBOOK.md +39 -0
  30. package/docs/OPERATIONS_SIGNING.md +20 -0
  31. package/docs/OVERVIEW.md +190 -0
  32. package/docs/PERF_BASELINE.md +85 -0
  33. package/docs/PRD.md +77 -0
  34. package/docs/QUICKSTART_KERNEL_V0.md +96 -0
  35. package/docs/QUICKSTART_MCP.md +377 -0
  36. package/docs/QUICKSTART_MCP_HOSTS.md +210 -0
  37. package/docs/QUICKSTART_POLICY_PACKS.md +65 -0
  38. package/docs/QUICKSTART_PRODUCE.md +61 -0
  39. package/docs/QUICKSTART_PROFILES.md +198 -0
  40. package/docs/QUICKSTART_RELEASE_VERIFY.md +39 -0
  41. package/docs/QUICKSTART_SDK.md +125 -0
  42. package/docs/QUICKSTART_SDK_PYTHON.md +111 -0
  43. package/docs/QUICKSTART_VERIFY.md +54 -0
  44. package/docs/QUICKSTART_X402_GATEWAY.md +317 -0
  45. package/docs/README.md +33 -0
  46. package/docs/RELEASE_CHECKLIST.md +182 -0
  47. package/docs/RELEASING.md +82 -0
  48. package/docs/REPO_SETTINGS.md +37 -0
  49. package/docs/RUNBOOK.md +86 -0
  50. package/docs/SKILLS.md +42 -0
  51. package/docs/SKILL_BUNDLE_FORMAT.md +48 -0
  52. package/docs/SLO.md +131 -0
  53. package/docs/SUMMARY.md +17 -0
  54. package/docs/SUPPORT.md +31 -0
  55. package/docs/THREAT_MODEL.md +36 -0
  56. package/docs/TRUST.md +59 -0
  57. package/docs/WORKFLOW.md +35 -0
  58. package/docs/X402_BATCH_SETTLEMENT.md +126 -0
  59. package/docs/blog/2026-02-14-your-ai-agent-just-spent-500-where-is-the-receipt.md +73 -0
  60. package/docs/examples/x402-provider-payout-registry.example.json +14 -0
  61. package/docs/gitbook/README.md +64 -0
  62. package/docs/gitbook/SETUP.md +25 -0
  63. package/docs/gitbook/SUMMARY.md +15 -0
  64. package/docs/gitbook/api-reference.md +73 -0
  65. package/docs/gitbook/closepacks.md +55 -0
  66. package/docs/gitbook/conformance.md +59 -0
  67. package/docs/gitbook/core-primitives.md +85 -0
  68. package/docs/gitbook/dispute-lifecycle.md +33 -0
  69. package/docs/gitbook/faq.md +21 -0
  70. package/docs/gitbook/guides.md +49 -0
  71. package/docs/gitbook/operations-runbook.md +36 -0
  72. package/docs/gitbook/quickstart.md +103 -0
  73. package/docs/gitbook/replay-and-audit.md +30 -0
  74. package/docs/gitbook/sdk-reference.md +35 -0
  75. package/docs/gitbook/security-model.md +58 -0
  76. package/docs/integrations/README.md +15 -0
  77. package/docs/integrations/github-actions-verify.yml +31 -0
  78. package/docs/integrations/github-actions.md +34 -0
  79. package/docs/integrations/openclaw/CLAWHUB_PUBLISH_CHECKLIST.md +65 -0
  80. package/docs/integrations/openclaw/PUBLIC_QUICKSTART.md +95 -0
  81. package/docs/integrations/openclaw/settld-mcp-skill/SKILL.md +69 -0
  82. package/docs/integrations/openclaw/settld-mcp-skill/mcp-server.example.json +12 -0
  83. package/docs/kernel-compatible/capabilities.json +36 -0
  84. package/docs/marketing/agent-commerce-substrate.md +78 -0
  85. package/docs/marketing/hn-repost-2026-02-17.md +102 -0
  86. package/docs/marketing/show-hn-post.md +45 -0
  87. package/docs/ops/ARTIFACT_VERIFICATION_STATUS.md +43 -0
  88. package/docs/ops/BILLING_WEBHOOK_REPLAY.md +105 -0
  89. package/docs/ops/CI_FLAKE_BUDGET.md +31 -0
  90. package/docs/ops/DISPUTE_FINANCE_RECONCILIATION_PACKET.md +56 -0
  91. package/docs/ops/GO_LIVE_GATE_S13.md +27 -0
  92. package/docs/ops/HOSTED_BASELINE_R2.md +129 -0
  93. package/docs/ops/KERNEL_V0_SHIP_GATE.md +69 -0
  94. package/docs/ops/LIGHTHOUSE_PRODUCTION_CLOSE.md +51 -0
  95. package/docs/ops/MCP_COMPATIBILITY_MATRIX.md +30 -0
  96. package/docs/ops/MINIMUM_PRODUCTION_TOPOLOGY.md +89 -0
  97. package/docs/ops/P0_BACKEND_PROGRESS.md +150 -0
  98. package/docs/ops/PAYMENTS_ALPHA_R5.md +105 -0
  99. package/docs/ops/PILOT_ONBOARDING_RUNBOOK.md +112 -0
  100. package/docs/ops/PRODUCTION_DEPLOYMENT_CHECKLIST.md +140 -0
  101. package/docs/ops/R1_SLOS.md +66 -0
  102. package/docs/ops/RELEASE_SIGNING_INCIDENT.md +58 -0
  103. package/docs/ops/SELF_SERVE_LAUNCH_AUTOMATION.md +89 -0
  104. package/docs/ops/THROUGHPUT_DRILL_10X.md +48 -0
  105. package/docs/ops/TRUST_CONFIG_WIZARD.md +60 -0
  106. package/docs/ops/X402_PILOT_WEEKLY_METRICS.md +76 -0
  107. package/docs/ops/tool-call-disputes-holdback.md +52 -0
  108. package/docs/pilot-kit/PILOT_PACKAGE_SCORECARD_X402.md +46 -0
  109. package/docs/pilot-kit/README.md +29 -0
  110. package/docs/pilot-kit/architecture-one-pager.md +48 -0
  111. package/docs/pilot-kit/buyer-email.txt +19 -0
  112. package/docs/pilot-kit/buyer-one-pager.md +31 -0
  113. package/docs/pilot-kit/gtm-pilot-playbook.md +182 -0
  114. package/docs/pilot-kit/offline-verify.md +33 -0
  115. package/docs/pilot-kit/procurement-one-pager.md +50 -0
  116. package/docs/pilot-kit/rfp-clause.md +46 -0
  117. package/docs/pilot-kit/roi-calculator-template.csv +2 -0
  118. package/docs/pilot-kit/security-qa.md +153 -0
  119. package/docs/pilot-kit/security-summary.md +35 -0
  120. package/docs/plans/2026-02-13-mcp-spike-design.md +113 -0
  121. package/docs/plans/2026-02-20-trust-os-v1-jira-backlog.md +348 -0
  122. package/docs/plans/2026-02-21-agent-economic-actor-operating-model.md +169 -0
  123. package/docs/plans/2026-02-21-trust-os-v1-strategy.md +241 -0
  124. package/docs/research/2026-02-21-agent-spend-host-landscape.md +57 -0
  125. package/docs/spec/AcceptanceCriteria.v1.md +17 -0
  126. package/docs/spec/AcceptanceEvaluation.v1.md +10 -0
  127. package/docs/spec/AgentEvent.v1.md +47 -0
  128. package/docs/spec/AgentIdentity.v1.md +62 -0
  129. package/docs/spec/AgentPassport.v1.md +95 -0
  130. package/docs/spec/AgentReputation.v1.md +59 -0
  131. package/docs/spec/AgentReputation.v2.md +52 -0
  132. package/docs/spec/AgentRun.v1.md +47 -0
  133. package/docs/spec/AgentRunSettlement.v1.md +52 -0
  134. package/docs/spec/AgentWallet.v1.md +43 -0
  135. package/docs/spec/AgreementDelegation.v1.md +109 -0
  136. package/docs/spec/ArbitrationCase.v1.md +67 -0
  137. package/docs/spec/ArbitrationOutcomeMapping.v1.md +62 -0
  138. package/docs/spec/ArbitrationVerdict.v1.md +60 -0
  139. package/docs/spec/BundleHeadAttestation.v1.md +32 -0
  140. package/docs/spec/CANONICAL_JSON.md +31 -0
  141. package/docs/spec/CRYPTOGRAPHY.md +61 -0
  142. package/docs/spec/ClosePack.v1.md +49 -0
  143. package/docs/spec/ClosePackManifest.v1.md +24 -0
  144. package/docs/spec/DelegationGrant.v1.md +90 -0
  145. package/docs/spec/DisputeCaseLifecycle.v1.md +51 -0
  146. package/docs/spec/DisputeOpenEnvelope.v1.md +43 -0
  147. package/docs/spec/ERRORS.md +76 -0
  148. package/docs/spec/ESCROW_NETTING_INVARIANTS.md +71 -0
  149. package/docs/spec/EvidenceIndex.v1.md +20 -0
  150. package/docs/spec/ExecutionIntent.v1.md +90 -0
  151. package/docs/spec/FinancePackBundleManifest.v1.md +24 -0
  152. package/docs/spec/FundingHold.v1.md +60 -0
  153. package/docs/spec/GovernancePolicy.v1.md +34 -0
  154. package/docs/spec/GovernancePolicy.v2.md +30 -0
  155. package/docs/spec/INVARIANTS.md +389 -0
  156. package/docs/spec/InteractionDirectionMatrix.v1.md +30 -0
  157. package/docs/spec/InvoiceBundleManifest.v1.md +24 -0
  158. package/docs/spec/InvoiceClaim.v1.md +11 -0
  159. package/docs/spec/MONEY_RAIL_STATE_MACHINE.md +58 -0
  160. package/docs/spec/MarketplaceAcceptance.v2.md +46 -0
  161. package/docs/spec/MarketplaceOffer.v2.md +54 -0
  162. package/docs/spec/MeteringReport.v1.md +18 -0
  163. package/docs/spec/OperatorAction.v1.md +90 -0
  164. package/docs/spec/PRODUCER_ERRORS.md +42 -0
  165. package/docs/spec/PolicyDecision.v1.md +83 -0
  166. package/docs/spec/PricingMatrix.v1.md +20 -0
  167. package/docs/spec/PricingMatrixSignatures.v1.md +30 -0
  168. package/docs/spec/PricingMatrixSignatures.v2.md +29 -0
  169. package/docs/spec/ProduceCliOutput.v1.md +46 -0
  170. package/docs/spec/ProofBundleManifest.v1.md +24 -0
  171. package/docs/spec/README.md +109 -0
  172. package/docs/spec/REFERENCE_IMPLEMENTATIONS.md +29 -0
  173. package/docs/spec/REFERENCE_VERIFIER_BEHAVIOR.md +68 -0
  174. package/docs/spec/REMOTE_SIGNER.md +66 -0
  175. package/docs/spec/ReleaseIndex.v1.md +32 -0
  176. package/docs/spec/ReleaseIndexSignatures.v1.md +17 -0
  177. package/docs/spec/ReleaseTrust.v1.md +13 -0
  178. package/docs/spec/ReleaseTrust.v2.md +26 -0
  179. package/docs/spec/RemoteSignerRequest.v1.md +21 -0
  180. package/docs/spec/RemoteSignerResponse.v1.md +16 -0
  181. package/docs/spec/ReputationEvent.v1.md +63 -0
  182. package/docs/spec/RevocationList.v1.md +28 -0
  183. package/docs/spec/SIGNER_PROVIDER_PLUGIN.md +32 -0
  184. package/docs/spec/STRICTNESS.md +68 -0
  185. package/docs/spec/SUPPLY_CHAIN.md +33 -0
  186. package/docs/spec/SettlementAdjustment.v1.md +45 -0
  187. package/docs/spec/SettlementDecisionRecord.v1.md +48 -0
  188. package/docs/spec/SettlementDecisionRecord.v2.md +53 -0
  189. package/docs/spec/SettlementDecisionReport.v1.md +44 -0
  190. package/docs/spec/SettlementKernel.v1.md +59 -0
  191. package/docs/spec/SettlementReceipt.v1.md +63 -0
  192. package/docs/spec/SlaDefinition.v1.md +24 -0
  193. package/docs/spec/SlaEvaluation.v1.md +12 -0
  194. package/docs/spec/THREAT_MODEL.md +113 -0
  195. package/docs/spec/TOOL_PROVENANCE.md +30 -0
  196. package/docs/spec/TRUST_ANCHORS.md +84 -0
  197. package/docs/spec/TenantSettings.v1.md +90 -0
  198. package/docs/spec/TenantSettings.v2.md +99 -0
  199. package/docs/spec/TimestampProof.v1.md +25 -0
  200. package/docs/spec/ToolCallAgreement.v1.md +34 -0
  201. package/docs/spec/ToolCallEvidence.v1.md +47 -0
  202. package/docs/spec/ToolManifest.v1.md +47 -0
  203. package/docs/spec/VERIFIER_ENVIRONMENT.md +38 -0
  204. package/docs/spec/VERSIONING.md +107 -0
  205. package/docs/spec/VerificationReport.v1.md +50 -0
  206. package/docs/spec/VerifyAboutOutput.v1.md +10 -0
  207. package/docs/spec/VerifyCliOutput.v1.md +28 -0
  208. package/docs/spec/WARNINGS.md +83 -0
  209. package/docs/spec/error-codes.v1.txt +285 -0
  210. package/docs/spec/examples/agreement_delegation_v1.example.json +21 -0
  211. package/docs/spec/examples/arbitration_case_v1.example.json +26 -0
  212. package/docs/spec/examples/arbitration_verdict_v1.example.json +32 -0
  213. package/docs/spec/examples/dispute_open_envelope_v1.example.json +18 -0
  214. package/docs/spec/examples/produce_cli_output_v1.example.json +32 -0
  215. package/docs/spec/examples/release_index_signature_v1.example.json +9 -0
  216. package/docs/spec/examples/release_index_signatures_v1.example.json +14 -0
  217. package/docs/spec/examples/release_index_v1.example.json +15 -0
  218. package/docs/spec/examples/release_trust_v1.example.json +7 -0
  219. package/docs/spec/examples/release_trust_v2.example.json +22 -0
  220. package/docs/spec/examples/remote_signer_request_v1.example.json +18 -0
  221. package/docs/spec/examples/remote_signer_response_v1.example.json +8 -0
  222. package/docs/spec/examples/reputation_event_v1.example.json +29 -0
  223. package/docs/spec/examples/verification_report_v1.example.json +24 -0
  224. package/docs/spec/examples/verify_about_output_v1.example.json +29 -0
  225. package/docs/spec/examples/verify_cli_output_v1.example.json +13 -0
  226. package/docs/spec/legacy/MarketplaceAcceptance.v1.md +48 -0
  227. package/docs/spec/legacy/MarketplaceOffer.v1.md +56 -0
  228. package/docs/spec/legacy/schemas/MarketplaceAcceptance.v1.schema.json +53 -0
  229. package/docs/spec/legacy/schemas/MarketplaceOffer.v1.schema.json +61 -0
  230. package/docs/spec/producer-error-codes.v1.txt +14 -0
  231. package/docs/spec/schemas/AcceptanceCriteria.v1.schema.json +24 -0
  232. package/docs/spec/schemas/AcceptanceEvaluation.v1.schema.json +26 -0
  233. package/docs/spec/schemas/AgentEvent.v1.schema.json +49 -0
  234. package/docs/spec/schemas/AgentIdentity.v1.schema.json +129 -0
  235. package/docs/spec/schemas/AgentPassport.v1.schema.json +112 -0
  236. package/docs/spec/schemas/AgentReputation.v1.schema.json +151 -0
  237. package/docs/spec/schemas/AgentReputation.v2.schema.json +120 -0
  238. package/docs/spec/schemas/AgentRun.v1.schema.json +71 -0
  239. package/docs/spec/schemas/AgentRunSettlement.v1.schema.json +75 -0
  240. package/docs/spec/schemas/AgentWallet.v1.schema.json +54 -0
  241. package/docs/spec/schemas/AgreementDelegation.v1.schema.json +50 -0
  242. package/docs/spec/schemas/ArbitrationCase.v1.schema.json +133 -0
  243. package/docs/spec/schemas/ArbitrationVerdict.v1.schema.json +149 -0
  244. package/docs/spec/schemas/BundleHeadAttestation.v1.schema.json +21 -0
  245. package/docs/spec/schemas/ClosePackManifest.v1.schema.json +38 -0
  246. package/docs/spec/schemas/DelegationGrant.v1.schema.json +102 -0
  247. package/docs/spec/schemas/DisputeOpenEnvelope.v1.schema.json +78 -0
  248. package/docs/spec/schemas/EvidenceIndex.v1.schema.json +41 -0
  249. package/docs/spec/schemas/ExecutionIntent.v1.schema.json +85 -0
  250. package/docs/spec/schemas/FinancePackBundleManifest.v1.schema.json +38 -0
  251. package/docs/spec/schemas/FundingHold.v1.schema.json +46 -0
  252. package/docs/spec/schemas/GovernancePolicy.v1.schema.json +45 -0
  253. package/docs/spec/schemas/GovernancePolicy.v2.schema.json +70 -0
  254. package/docs/spec/schemas/InteractionDirectionMatrix.v1.schema.json +43 -0
  255. package/docs/spec/schemas/InvoiceBundleManifest.v1.schema.json +38 -0
  256. package/docs/spec/schemas/InvoiceClaim.v1.schema.json +39 -0
  257. package/docs/spec/schemas/MarketplaceAcceptance.v2.schema.json +53 -0
  258. package/docs/spec/schemas/MarketplaceOffer.v2.schema.json +61 -0
  259. package/docs/spec/schemas/MeteringReport.v1.schema.json +45 -0
  260. package/docs/spec/schemas/OperatorAction.v1.schema.json +113 -0
  261. package/docs/spec/schemas/PolicyDecision.v1.schema.json +74 -0
  262. package/docs/spec/schemas/PricingMatrix.v1.schema.json +24 -0
  263. package/docs/spec/schemas/PricingMatrixSignatures.v1.schema.json +24 -0
  264. package/docs/spec/schemas/PricingMatrixSignatures.v2.schema.json +24 -0
  265. package/docs/spec/schemas/ProduceCliOutput.v1.schema.json +107 -0
  266. package/docs/spec/schemas/ProofBundleManifest.v1.schema.json +37 -0
  267. package/docs/spec/schemas/PublicKeys.v1.schema.json +33 -0
  268. package/docs/spec/schemas/ReleaseIndex.v1.schema.json +45 -0
  269. package/docs/spec/schemas/ReleaseIndexSignature.v1.schema.json +16 -0
  270. package/docs/spec/schemas/ReleaseIndexSignatures.v1.schema.json +16 -0
  271. package/docs/spec/schemas/ReleaseTrust.v1.schema.json +15 -0
  272. package/docs/spec/schemas/ReleaseTrust.v2.schema.json +37 -0
  273. package/docs/spec/schemas/RemoteSignerPublicKeyResponse.v1.schema.json +14 -0
  274. package/docs/spec/schemas/RemoteSignerRequest.v1.schema.json +24 -0
  275. package/docs/spec/schemas/RemoteSignerResponse.v1.schema.json +10 -0
  276. package/docs/spec/schemas/RemoteSignerSignRequest.v1.schema.json +27 -0
  277. package/docs/spec/schemas/RemoteSignerSignResponse.v1.schema.json +16 -0
  278. package/docs/spec/schemas/ReputationEvent.v1.schema.json +164 -0
  279. package/docs/spec/schemas/RevocationList.v1.schema.json +51 -0
  280. package/docs/spec/schemas/SettlementAdjustment.v1.schema.json +44 -0
  281. package/docs/spec/schemas/SettlementDecisionRecord.v1.schema.json +66 -0
  282. package/docs/spec/schemas/SettlementDecisionRecord.v2.schema.json +149 -0
  283. package/docs/spec/schemas/SettlementDecisionReport.v1.schema.json +61 -0
  284. package/docs/spec/schemas/SettlementReceipt.v1.schema.json +135 -0
  285. package/docs/spec/schemas/SlaDefinition.v1.schema.json +33 -0
  286. package/docs/spec/schemas/SlaEvaluation.v1.schema.json +26 -0
  287. package/docs/spec/schemas/TenantSettings.v1.schema.json +90 -0
  288. package/docs/spec/schemas/TenantSettings.v2.schema.json +161 -0
  289. package/docs/spec/schemas/TimestampProof.v1.schema.json +17 -0
  290. package/docs/spec/schemas/ToolCallAgreement.v1.schema.json +34 -0
  291. package/docs/spec/schemas/ToolCallEvidence.v1.schema.json +45 -0
  292. package/docs/spec/schemas/ToolManifest.v1.schema.json +54 -0
  293. package/docs/spec/schemas/VerificationReport.v1.schema.json +83 -0
  294. package/docs/spec/schemas/VerifyAboutOutput.v1.schema.json +54 -0
  295. package/docs/spec/schemas/VerifyCliOutput.v1.schema.json +75 -0
  296. package/docs/spec/schemas/VerifyReleaseOutput.v1.schema.json +47 -0
  297. package/docs/spec/x402-error-codes.v1.txt +35 -0
  298. package/docs/templates/buyer-email.txt +18 -0
  299. package/docs/templates/buyer-one-pager.md +24 -0
  300. package/package.json +53 -6
  301. package/scripts/acceptance/full-stack.mjs +734 -0
  302. package/scripts/acceptance/full-stack.sh +99 -0
  303. package/scripts/audit/build-audit-packet.mjs +242 -0
  304. package/scripts/backup-pg.sh +45 -0
  305. package/scripts/backup-restore/README.md +18 -0
  306. package/scripts/backup-restore/capture-state.mjs +130 -0
  307. package/scripts/backup-restore/client.mjs +97 -0
  308. package/scripts/backup-restore/seed-workload.mjs +235 -0
  309. package/scripts/backup-restore/verify-state.mjs +139 -0
  310. package/scripts/backup-restore-test.sh +217 -0
  311. package/scripts/chaos.js +221 -0
  312. package/scripts/ci/build-launch-cutover-packet.mjs +304 -0
  313. package/scripts/ci/build-self-serve-benchmark-report.mjs +122 -0
  314. package/scripts/ci/changelog-guard.mjs +145 -0
  315. package/scripts/ci/check-kernel-v0-launch-gate.mjs +233 -0
  316. package/scripts/ci/check-secret-hygiene.mjs +78 -0
  317. package/scripts/ci/check-version-consistency.mjs +42 -0
  318. package/scripts/ci/cli-pack-smoke.mjs +160 -0
  319. package/scripts/ci/flake-budget-guard.mjs +68 -0
  320. package/scripts/ci/generate-error-codes.mjs +54 -0
  321. package/scripts/ci/lib/lighthouse-tracker.mjs +90 -0
  322. package/scripts/ci/lib/self-serve-launch-gate.mjs +89 -0
  323. package/scripts/ci/npm-pack-smoke.mjs +454 -0
  324. package/scripts/ci/run-10x-throughput-drill.mjs +318 -0
  325. package/scripts/ci/run-10x-throughput-incident-rehearsal.mjs +368 -0
  326. package/scripts/ci/run-arbitration-workspace-browser-e2e.sh +22 -0
  327. package/scripts/ci/run-circle-sandbox-smoke.mjs +237 -0
  328. package/scripts/ci/run-go-live-gate.mjs +150 -0
  329. package/scripts/ci/run-kernel-v0-ship-gate.mjs +97 -0
  330. package/scripts/ci/run-mcp-host-cert-matrix.mjs +201 -0
  331. package/scripts/ci/run-mcp-host-smoke.mjs +473 -0
  332. package/scripts/ci/run-offline-verification-parity-gate.mjs +762 -0
  333. package/scripts/ci/run-onboarding-host-success-gate.mjs +516 -0
  334. package/scripts/ci/run-onboarding-policy-slo-gate.mjs +537 -0
  335. package/scripts/ci/run-production-cutover-gate.mjs +540 -0
  336. package/scripts/ci/run-public-openclaw-npx-smoke.mjs +148 -0
  337. package/scripts/ci/run-release-promotion-guard.mjs +756 -0
  338. package/scripts/ci/run-self-serve-launch-gate.mjs +56 -0
  339. package/scripts/ci/runtime-import-smoke.mjs +58 -0
  340. package/scripts/ci/update-lighthouse-tracker.mjs +112 -0
  341. package/scripts/closepack/lib.mjs +286 -0
  342. package/scripts/collect-debug.sh +263 -0
  343. package/scripts/demo/compositional-settlement-3hop.mjs +237 -0
  344. package/scripts/demo/delivery-robot/export-ui-fixture.mjs +188 -0
  345. package/scripts/demo/delivery-robot/generate.mjs +377 -0
  346. package/scripts/demo/kernel-agent-goes-shopping.mjs +202 -0
  347. package/scripts/demo/magic-link-first-green.mjs +118 -0
  348. package/scripts/demo/magic-link-kind-smoke.mjs +577 -0
  349. package/scripts/demo/mcp-paid-exa.mjs +1110 -0
  350. package/scripts/dev/billing-doctor.sh +145 -0
  351. package/scripts/dev/billing-smoke-prod.sh +219 -0
  352. package/scripts/dev/billing-webhook-replay.sh +161 -0
  353. package/scripts/dev/env.dev.example +29 -0
  354. package/scripts/dev/env.sh +37 -0
  355. package/scripts/dev/new-sdk-key.sh +81 -0
  356. package/scripts/dev/sdk-first-run.sh +21 -0
  357. package/scripts/dev/smoke-x402-gateway.sh +115 -0
  358. package/scripts/dev/start-api.sh +24 -0
  359. package/scripts/doctor/mcp-host.mjs +120 -0
  360. package/scripts/examples/produce-and-verify-jobproof.mjs +191 -0
  361. package/scripts/examples/sdk-first-paid-rfq.py +105 -0
  362. package/scripts/examples/sdk-first-verified-run.mjs +85 -0
  363. package/scripts/examples/sdk-first-verified-run.py +99 -0
  364. package/scripts/examples/sdk-tenant-analytics.mjs +103 -0
  365. package/scripts/examples/sdk-tenant-analytics.py +118 -0
  366. package/scripts/finance-pack/bundle.mjs +284 -0
  367. package/scripts/fixtures/generate-bundle-fixtures.mjs +877 -0
  368. package/scripts/governance/export.mjs +169 -0
  369. package/scripts/load/delivery-stress.k6.js +183 -0
  370. package/scripts/load/ingest-burst.k6.js +236 -0
  371. package/scripts/load/run-delivery-load.js +66 -0
  372. package/scripts/load/webhook-receiver.js +131 -0
  373. package/scripts/magic-link/migrate-run-records-to-db.mjs +35 -0
  374. package/scripts/mcp/probe.mjs +238 -0
  375. package/scripts/mcp/settld-mcp-http-gateway.mjs +178 -0
  376. package/scripts/mcp/settld-mcp-server.mjs +1511 -0
  377. package/scripts/openapi/write.mjs +13 -0
  378. package/scripts/ops/bootstrap-tenant-conformance.mjs +185 -0
  379. package/scripts/ops/build-x402-pilot-reliability-report.mjs +489 -0
  380. package/scripts/ops/check-x402-receipt-sample.mjs +181 -0
  381. package/scripts/ops/design-partner-run-packet.mjs +466 -0
  382. package/scripts/ops/dispute-finance-reconciliation-packet.mjs +313 -0
  383. package/scripts/ops/hosted-baseline-evidence.mjs +890 -0
  384. package/scripts/ops/money-rails-chargeback-evidence.mjs +509 -0
  385. package/scripts/ops/money-rails-reconcile-evidence.mjs +180 -0
  386. package/scripts/ops/p0-seed-money-rail-operation.mjs +432 -0
  387. package/scripts/ops/run-x402-hitl-smoke.mjs +607 -0
  388. package/scripts/pilot/finance-pack.mjs +495 -0
  389. package/scripts/pilot/fixtures/robot-keypair.json +4 -0
  390. package/scripts/pilot/fixtures/server-signer.json +4 -0
  391. package/scripts/policy/cli.mjs +600 -0
  392. package/scripts/profile/cli.mjs +1324 -0
  393. package/scripts/proof-bundle/job.mjs +109 -0
  394. package/scripts/proof-bundle/lib.mjs +92 -0
  395. package/scripts/proof-bundle/month.mjs +103 -0
  396. package/scripts/provider/conformance-run.mjs +159 -0
  397. package/scripts/provider/keys-generate.mjs +135 -0
  398. package/scripts/provider/publish.mjs +420 -0
  399. package/scripts/quickstart/x402.mjs +334 -0
  400. package/scripts/register-entity-secret.mjs +102 -0
  401. package/scripts/release/build-artifacts.mjs +181 -0
  402. package/scripts/release/generate-release-index.mjs +112 -0
  403. package/scripts/release/release-index-lib.mjs +232 -0
  404. package/scripts/release/sign-release-index.mjs +85 -0
  405. package/scripts/release/validate-release-assets.mjs +170 -0
  406. package/scripts/release/verify-release.mjs +261 -0
  407. package/scripts/restore-pg.sh +34 -0
  408. package/scripts/scaffold/create-settld-paid-tool.mjs +19 -0
  409. package/scripts/sdk/smoke-python.py +30 -0
  410. package/scripts/sdk/smoke.mjs +16 -0
  411. package/scripts/settlement/x402-batch-worker.mjs +1091 -0
  412. package/scripts/setup/circle-bootstrap.mjs +310 -0
  413. package/scripts/setup/host-config.mjs +617 -0
  414. package/scripts/setup/onboard.mjs +1337 -0
  415. package/scripts/setup/openclaw-onboard.mjs +423 -0
  416. package/scripts/setup/wizard.mjs +986 -0
  417. package/scripts/slo/check.mjs +239 -0
  418. package/scripts/smoke/k8s-smoke.mjs +214 -0
  419. package/scripts/spec/generate-protocol-vectors.mjs +1019 -0
  420. package/scripts/test/check-no-generated-artifacts.sh +12 -0
  421. package/scripts/test/run.sh +59 -0
  422. package/scripts/trust/validate-trust-file.mjs +57 -0
  423. package/scripts/trust-config/rotate-settld-pay.mjs +277 -0
  424. package/scripts/trust-config/wizard.mjs +161 -0
  425. package/scripts/vendor-contract-test-lib.mjs +182 -0
  426. package/scripts/vendor-contract-test.mjs +55 -0
  427. package/scripts/vercel/build-mkdocs.sh +9 -0
  428. package/scripts/vercel/ignore-mkdocs.sh +25 -0
  429. package/scripts/vercel/install-mkdocs.sh +6 -0
  430. package/scripts/verify-pg.js +217 -0
  431. package/scripts/x402/receipt-verify.mjs +289 -0
  432. package/services/finance-sink/src/dedupe-store.js +29 -6
  433. package/services/receiver/src/dedupe-store.js +29 -5
  434. package/services/x402-gateway/Dockerfile +13 -0
  435. package/services/x402-gateway/README.md +58 -0
  436. package/services/x402-gateway/examples/upstream-mock.js +337 -0
  437. package/services/x402-gateway/src/server.js +1058 -0
  438. package/src/api/app.js +34658 -16940
  439. package/src/api/maintenance.js +70 -0
  440. package/src/api/middleware/trust-kernel.js +114 -0
  441. package/src/api/openapi.js +1778 -70
  442. package/src/api/persistence.js +456 -0
  443. package/src/api/server.js +81 -5
  444. package/src/api/store.js +1581 -62
  445. package/src/api/workers/deliveries.js +99 -4
  446. package/src/api/workers/insolvency-sweep.js +159 -0
  447. package/src/core/agent-card.js +69 -0
  448. package/src/core/agent-wallets.js +231 -0
  449. package/src/core/agreement-delegation.js +549 -0
  450. package/src/core/billing-plans.js +40 -6
  451. package/src/core/circle-reserve-adapter.js +845 -0
  452. package/src/core/event-policy.js +21 -2
  453. package/src/core/maintenance-locks.js +1 -0
  454. package/src/core/operator-action.js +303 -0
  455. package/src/core/paid-tool-manifest.js +318 -0
  456. package/src/core/policy-decision.js +322 -0
  457. package/src/core/policy-packs.js +207 -0
  458. package/src/core/profile-fingerprint.js +27 -0
  459. package/src/core/profile-simulation-reasons.js +84 -0
  460. package/src/core/profile-templates.js +242 -0
  461. package/src/core/provider-publish-conformance.js +525 -0
  462. package/src/core/provider-publish-proof.js +396 -0
  463. package/src/core/provider-quote-signature.js +170 -0
  464. package/src/core/settld-keys.js +112 -0
  465. package/src/core/settld-pay-token.js +344 -0
  466. package/src/core/settlement-kernel.js +239 -2
  467. package/src/core/settlement-verifier.js +335 -0
  468. package/src/core/tool-call-agreement.js +112 -0
  469. package/src/core/tool-call-evidence.js +144 -0
  470. package/src/core/tool-provider-signature.js +98 -0
  471. package/src/core/wallet-assignment-resolver.js +129 -0
  472. package/src/core/wallet-provider-bootstrap.js +365 -0
  473. package/src/core/x402-escalation-override.js +258 -0
  474. package/src/core/x402-gate.js +118 -0
  475. package/src/core/x402-provider-refund-decision.js +220 -0
  476. package/src/core/x402-receipt-verifier.js +708 -0
  477. package/src/core/x402-reversal-command.js +251 -0
  478. package/src/core/x402-wallet-issuer-decision.js +252 -0
  479. package/src/core/zk-verifier.js +300 -0
  480. package/src/db/migrations/029_reputation_event_index.sql +54 -0
  481. package/src/db/migrations/030_artifacts_source_event_unique_job_only.sql +15 -0
  482. package/src/db/pg.js +18 -7
  483. package/src/db/store-pg.js +1508 -111
@@ -0,0 +1,495 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+
4
+ import { createApi } from "../../src/api/app.js";
5
+ import { createStore } from "../../src/api/store.js";
6
+ import { keyIdFromPublicKeyPem } from "../../src/core/crypto.js";
7
+ import { sha256Hex } from "../../src/core/crypto.js";
8
+ import { createChainedEvent, finalizeChainedEvent } from "../../src/core/event-chain.js";
9
+ import { resetDeterministicIds } from "../../src/core/ids.js";
10
+ import { buildJobProofBundleV1, buildMonthProofBundleV1 } from "../../src/core/proof-bundle.js";
11
+ import { GOVERNANCE_STREAM_ID } from "../../src/core/governance.js";
12
+ import { contractDocumentV1FromLegacyContract, hashContractDocumentV1 } from "../../src/core/contract-document.js";
13
+ import { MONTH_CLOSE_BASIS, makeMonthCloseStreamId } from "../../src/core/month-close.js";
14
+ import { DEFAULT_TENANT_ID } from "../../src/core/tenancy.js";
15
+
16
+ import { request } from "../../test/api-test-harness.js";
17
+ import { writeFilesToDir, writeZipFromDir, ensureDir } from "../proof-bundle/lib.mjs";
18
+
19
+ function isoFromMs(ms) {
20
+ return new Date(ms).toISOString();
21
+ }
22
+
23
+ async function writeJson(filepath, value) {
24
+ const dir = path.dirname(filepath);
25
+ await fs.mkdir(dir, { recursive: true });
26
+ await fs.writeFile(filepath, JSON.stringify(value, null, 2) + "\n", "utf8");
27
+ }
28
+
29
+ function safeJson(res) {
30
+ if (res?.json) return res.json;
31
+ if (!res?.body) return null;
32
+ if (typeof res.body !== "string") return res.body;
33
+
34
+ const trimmed = res.body.trim();
35
+ if (!trimmed) return null;
36
+ if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
37
+ try {
38
+ return JSON.parse(trimmed);
39
+ } catch {
40
+ return res.body;
41
+ }
42
+ }
43
+ return res.body;
44
+ }
45
+
46
+ async function main() {
47
+ resetDeterministicIds();
48
+
49
+ const runId = "finance_pack_v1";
50
+ const root = path.resolve("demo/finance-pack/output", runId);
51
+ const latest = path.resolve("demo/finance-pack/output/latest");
52
+
53
+ let nowMs = Date.parse("2026-01-20T09:50:00.000Z");
54
+ const nowIso = () => isoFromMs(nowMs);
55
+
56
+ const serverSignerKeypair = JSON.parse(
57
+ await fs.readFile(new URL("./fixtures/server-signer.json", import.meta.url), "utf8")
58
+ );
59
+ const store = createStore({ serverSignerKeypair });
60
+ const api = createApi({ store, now: nowIso, ingestToken: "ingest_tok" });
61
+ const protocolHeaders = { "x-settld-protocol": "1.0" };
62
+
63
+ const steps = [];
64
+ const recordStep = (name, res, extra = null) => {
65
+ const json = safeJson(res);
66
+ steps.push({
67
+ name,
68
+ statusCode: res?.statusCode ?? null,
69
+ code: res?.headers?.get?.("x-proxy-error-code") ?? null,
70
+ body: json ?? res?.body ?? null,
71
+ ...(extra ? { extra } : null)
72
+ });
73
+ };
74
+
75
+ // 0) Register a robot key (for client-finalized telemetry).
76
+ const robotKeypairFixture = JSON.parse(
77
+ await fs.readFile(new URL("./fixtures/robot-keypair.json", import.meta.url), "utf8")
78
+ );
79
+ const { publicKeyPem: robotPublicKeyPem, privateKeyPem: robotPrivateKeyPem } = robotKeypairFixture;
80
+ const robotId = "rob_demo_delivery";
81
+ const robotKeyId = keyIdFromPublicKeyPem(robotPublicKeyPem);
82
+
83
+ const robotReg = await request(api, {
84
+ method: "POST",
85
+ path: "/robots/register",
86
+ headers: { ...protocolHeaders, "x-idempotency-key": "demo_robot_reg" },
87
+ body: { robotId, publicKeyPem: robotPublicKeyPem }
88
+ });
89
+ recordStep("robot.register", robotReg);
90
+ if (robotReg.statusCode !== 201) throw new Error("robot.register failed");
91
+
92
+ const robotAvail = await request(api, {
93
+ method: "POST",
94
+ path: `/robots/${robotId}/availability`,
95
+ headers: { ...protocolHeaders, "x-idempotency-key": "demo_robot_avail", "x-proxy-expected-prev-chain-hash": robotReg.json.robot.lastChainHash },
96
+ body: { availability: [{ startAt: "2026-01-01T00:00:00.000Z", endAt: "2026-03-01T00:00:00.000Z" }] }
97
+ });
98
+ recordStep("robot.availability", robotAvail);
99
+ if (robotAvail.statusCode !== 201) throw new Error("robot.availability failed");
100
+
101
+ // 1) Create a contract with credits enabled (so the demo shows SLA -> CreditMemo).
102
+ const contractId = "c_demo_delivery";
103
+ const contractCreate = await request(api, {
104
+ method: "POST",
105
+ path: "/ops/contracts",
106
+ headers: protocolHeaders,
107
+ body: {
108
+ contractId,
109
+ name: "Demo Contract (delivery)",
110
+ isDefault: false,
111
+ policies: {
112
+ creditPolicy: {
113
+ enabled: true,
114
+ defaultAmountCents: 1250,
115
+ maxAmountCents: 1250,
116
+ currency: "USD"
117
+ },
118
+ evidencePolicy: { retentionDays: 30 }
119
+ }
120
+ }
121
+ });
122
+ recordStep("ops.contracts.create", contractCreate);
123
+ if (contractCreate.statusCode !== 201) throw new Error("ops.contracts.create failed");
124
+
125
+ // 2) Create + quote + book a job.
126
+ const created = await request(api, {
127
+ method: "POST",
128
+ path: "/jobs",
129
+ headers: { ...protocolHeaders, "x-idempotency-key": "demo_job_create" },
130
+ body: { templateId: "reset_standard", customerId: "cust_demo", siteId: "site_demo", contractId, constraints: {} }
131
+ });
132
+ recordStep("jobs.create", created);
133
+ if (created.statusCode !== 201) throw new Error("jobs.create failed");
134
+ const jobId = created.json.job.id;
135
+ let lastChainHash = created.json.job.lastChainHash;
136
+
137
+ const bookingStartAt = "2026-01-20T10:00:00.000Z";
138
+ const bookingEndAt = "2026-01-20T10:15:00.000Z";
139
+ const accessValidTo = "2026-01-20T10:45:00.000Z";
140
+
141
+ const quote = await request(api, {
142
+ method: "POST",
143
+ path: `/jobs/${jobId}/quote`,
144
+ headers: { ...protocolHeaders, "x-idempotency-key": "demo_job_quote", "x-proxy-expected-prev-chain-hash": lastChainHash },
145
+ body: {
146
+ startAt: bookingStartAt,
147
+ endAt: bookingEndAt,
148
+ environmentTier: "ENV_HOSPITALITY",
149
+ requiresOperatorCoverage: false,
150
+ customerId: "cust_demo",
151
+ siteId: "site_demo",
152
+ contractId
153
+ }
154
+ });
155
+ recordStep("jobs.quote", quote);
156
+ if (quote.statusCode !== 201) throw new Error("jobs.quote failed");
157
+ lastChainHash = quote.json.job.lastChainHash;
158
+
159
+ const book = await request(api, {
160
+ method: "POST",
161
+ path: `/jobs/${jobId}/book`,
162
+ headers: { ...protocolHeaders, "x-idempotency-key": "demo_job_book", "x-proxy-expected-prev-chain-hash": lastChainHash },
163
+ body: {
164
+ paymentHoldId: `hold_${jobId}`,
165
+ startAt: bookingStartAt,
166
+ endAt: bookingEndAt,
167
+ environmentTier: "ENV_HOSPITALITY",
168
+ requiresOperatorCoverage: false,
169
+ customerId: "cust_demo",
170
+ siteId: "site_demo",
171
+ contractId
172
+ }
173
+ });
174
+ recordStep("jobs.book", book);
175
+ if (book.statusCode !== 201) throw new Error("jobs.book failed");
176
+ lastChainHash = book.json.job.lastChainHash;
177
+
178
+ const bookedPolicyHash = book.json.event?.payload?.policyHash ?? null;
179
+ const customerContractHash = book.json.event?.payload?.customerContractHash ?? null;
180
+
181
+ // 3) Match/reserve + access.
182
+ const postServerEvent = async (type, payload, idempotencyKey) => {
183
+ const res = await request(api, {
184
+ method: "POST",
185
+ path: `/jobs/${jobId}/events`,
186
+ headers: {
187
+ ...protocolHeaders,
188
+ ...(idempotencyKey ? { "x-idempotency-key": idempotencyKey } : {}),
189
+ "x-proxy-expected-prev-chain-hash": lastChainHash
190
+ },
191
+ body: { type, actor: { type: "system", id: "proxy" }, payload }
192
+ });
193
+ recordStep(`jobs.events.${type}`, res);
194
+ if (res.statusCode !== 201) throw new Error(`jobs.events.${type} failed (status ${res.statusCode}): ${res.body ?? ""}`);
195
+ lastChainHash = res.json.job.lastChainHash;
196
+ return res;
197
+ };
198
+
199
+ const postRobotEvent = async (type, payload) => {
200
+ const at = nowIso();
201
+ const draft = createChainedEvent({ streamId: jobId, type, actor: { type: "robot", id: robotId }, payload, at });
202
+ const finalized = finalizeChainedEvent({
203
+ event: draft,
204
+ prevChainHash: lastChainHash,
205
+ signer: { keyId: robotKeyId, privateKeyPem: robotPrivateKeyPem }
206
+ });
207
+ const res = await request(api, { method: "POST", path: `/jobs/${jobId}/events`, headers: protocolHeaders, body: finalized });
208
+ recordStep(`jobs.events.${type}.robot`, res);
209
+ if (res.statusCode !== 201) throw new Error(`jobs.events.${type} (robot) failed (status ${res.statusCode}): ${res.body ?? ""}`);
210
+ lastChainHash = res.json.job.lastChainHash;
211
+ return res;
212
+ };
213
+
214
+ await postServerEvent("MATCHED", { robotId, operatorPartyId: "pty_operator_demo" }, "demo_match");
215
+ await postServerEvent("RESERVED", { robotId, startAt: bookingStartAt, endAt: bookingEndAt, reservationId: `rsv_${jobId}` }, "demo_reserve");
216
+
217
+ const accessPlanId = `ap_${jobId}`;
218
+ await postServerEvent(
219
+ "ACCESS_PLAN_ISSUED",
220
+ {
221
+ jobId,
222
+ accessPlanId,
223
+ method: "DOCKED_IN_BUILDING",
224
+ credentialRef: `vault://access/${accessPlanId}/v1`,
225
+ scope: { areas: ["LOADING_DOCK"], noGo: [] },
226
+ validFrom: bookingStartAt,
227
+ validTo: accessValidTo,
228
+ revocable: true,
229
+ requestedBy: "system"
230
+ },
231
+ "demo_access_plan"
232
+ );
233
+
234
+ // 4) Robot telemetry (late start -> SLA breach -> credit).
235
+ nowMs = Date.parse("2026-01-20T09:58:00.000Z");
236
+ await postRobotEvent("EN_ROUTE", { etaSeconds: 60 });
237
+ nowMs = Date.parse("2026-01-20T10:01:00.000Z");
238
+ await postRobotEvent("ACCESS_GRANTED", { jobId, accessPlanId, method: "DOCKED_IN_BUILDING" });
239
+ nowMs = Date.parse("2026-01-20T10:18:00.000Z"); // after SLA window end
240
+ await postRobotEvent("EXECUTION_STARTED", { plan: ["deliver"], destination: "room_412" });
241
+ nowMs = Date.parse("2026-01-20T10:18:32.000Z");
242
+ await postRobotEvent("EXECUTION_COMPLETED", { report: { durationSeconds: 32 }, deliveredTo: "room_412" });
243
+
244
+ nowMs += 60_000;
245
+ await postServerEvent("SETTLED", { settlement: "demo" }, "demo_settle");
246
+
247
+ const accounting = await api.tickJobAccounting({ maxMessages: 200 });
248
+ steps.push({ name: "tick.jobAccounting", result: accounting });
249
+
250
+ const artifactsTick = await api.tickArtifacts({ maxMessages: 400 });
251
+ steps.push({ name: "tick.artifacts", result: artifactsTick });
252
+
253
+ // 5) Configure a minimal finance account map (so journal CSV renders).
254
+ const financeMap = {
255
+ schemaVersion: "FinanceAccountMap.v1",
256
+ accounts: {
257
+ acct_customer_escrow: "2100",
258
+ acct_platform_revenue: "4000",
259
+ acct_owner_payable: "2000",
260
+ acct_operator_payable: "2010",
261
+ acct_sla_credits_expense: "4900",
262
+ acct_customer_credits_payable: "2110",
263
+ acct_cash: "1000",
264
+ acct_insurance_reserve: "2150",
265
+ acct_coverage_reserve: "2160",
266
+ acct_coverage_unearned: "2170",
267
+ acct_coverage_revenue: "4010",
268
+ acct_coverage_payout_expense: "5100",
269
+ acct_insurer_receivable: "1200",
270
+ acct_operator_chargeback_receivable: "1210",
271
+ acct_claims_expense: "5200",
272
+ acct_claims_payable: "2200",
273
+ acct_operator_labor_expense: "5300",
274
+ acct_operator_cost_accrued: "2210",
275
+ acct_developer_royalty_payable: "2020"
276
+ }
277
+ };
278
+
279
+ const financeMapRes = await request(api, {
280
+ method: "PUT",
281
+ path: "/ops/finance/account-map",
282
+ headers: protocolHeaders,
283
+ body: { mapping: financeMap }
284
+ });
285
+ recordStep("ops.finance.account-map.put", financeMapRes);
286
+ if (financeMapRes.statusCode !== 200) throw new Error("failed to set finance account map");
287
+
288
+ // 6) Month close + GLBatch + CSV.
289
+ const month = "2026-01";
290
+ const monthCloseReq = await request(api, {
291
+ method: "POST",
292
+ path: "/ops/month-close",
293
+ headers: { ...protocolHeaders, "x-idempotency-key": "demo_month_close" },
294
+ body: { month, basis: MONTH_CLOSE_BASIS.SETTLED_AT }
295
+ });
296
+ recordStep("ops.month-close.request", monthCloseReq);
297
+ if (monthCloseReq.statusCode !== 202) throw new Error("month close request failed");
298
+
299
+ const monthCloseTick = await api.tickMonthClose({ maxMessages: 50 });
300
+ steps.push({ name: "tick.monthClose", result: monthCloseTick });
301
+
302
+ const glBatchRes = await request(api, { method: "GET", path: `/ops/finance/gl-batch?period=${encodeURIComponent(month)}`, headers: protocolHeaders });
303
+ recordStep("ops.finance.gl-batch.get", glBatchRes);
304
+ if (glBatchRes.statusCode !== 200) throw new Error("GL batch not found after month close");
305
+
306
+ const glCsvRes = await request(api, { method: "GET", path: `/ops/finance/gl-batch.csv?period=${encodeURIComponent(month)}`, headers: protocolHeaders });
307
+ recordStep("ops.finance.gl-batch.csv.get", glCsvRes);
308
+ if (glCsvRes.statusCode !== 200) throw new Error("GL CSV not available");
309
+ const glCsv = glCsvRes.body;
310
+
311
+ // Collect artifacts.
312
+ const artifacts = await api.store.listArtifacts({ tenantId: "tenant_default", jobId });
313
+ const allArtifacts = await api.store.listArtifacts({ tenantId: "tenant_default" });
314
+
315
+ const latestByType = new Map();
316
+ for (const a of artifacts) {
317
+ const t = a?.artifactType ?? a?.schemaVersion ?? null;
318
+ if (!t) continue;
319
+ const prev = latestByType.get(t) ?? null;
320
+ const at = Date.parse(a?.generatedAt ?? a?.createdAt ?? 0);
321
+ const bt = Date.parse(prev?.generatedAt ?? prev?.createdAt ?? 0);
322
+ if (!prev || (Number.isFinite(at) && Number.isFinite(bt) && at > bt)) latestByType.set(t, a);
323
+ }
324
+
325
+ const artifactsByType = Object.fromEntries(Array.from(latestByType.entries()).sort((a, b) => String(a[0]).localeCompare(String(b[0]))));
326
+
327
+ const glBatchArtifact = glBatchRes.json?.artifact ?? null;
328
+
329
+ // Proof bundles (job + month).
330
+ const jobEvents = api.store.jobEvents.get(`tenant_default\n${jobId}`) ?? [];
331
+ const monthId = makeMonthCloseStreamId({ month, basis: MONTH_CLOSE_BASIS.SETTLED_AT });
332
+ const monthEvents = api.store.monthEvents.get(`tenant_default\n${monthId}`) ?? [];
333
+
334
+ const contractDocsByHash = new Map();
335
+ const contract = api.store.contracts.get(`tenant_default\n${contractId}`) ?? null;
336
+ if (contract && typeof contract === "object" && customerContractHash) {
337
+ const contractDoc = contractDocumentV1FromLegacyContract({ ...contract, contractVersion: contract.contractVersion ?? 1 });
338
+ const hash = hashContractDocumentV1(contractDoc);
339
+ if (hash === customerContractHash) contractDocsByHash.set(hash, contractDoc);
340
+ }
341
+
342
+ const publicKeyByKeyId = api.store.publicKeyByKeyId instanceof Map ? api.store.publicKeyByKeyId : new Map();
343
+ const manifestSigner = api.store?.serverSigner ? { keyId: api.store.serverSigner.keyId, privateKeyPem: api.store.serverSigner.privateKeyPem } : null;
344
+ let signerKeys = [];
345
+ if (typeof api.store.listSignerKeys === "function") {
346
+ const tenantKeys = await api.store.listSignerKeys({ tenantId: "tenant_default" });
347
+ const defaultKeys = await api.store.listSignerKeys({ tenantId: "tenant_default" });
348
+ const all = [...(tenantKeys ?? []), ...(defaultKeys ?? [])];
349
+ const byKeyId = new Map();
350
+ for (const r of all) {
351
+ const keyId = r?.keyId ? String(r.keyId) : null;
352
+ if (!keyId) continue;
353
+ byKeyId.set(keyId, r);
354
+ }
355
+ signerKeys = Array.from(byKeyId.values());
356
+ }
357
+ const generatedAt = nowIso();
358
+ const tenantGovernanceEvents = api.store.monthEvents.get(`tenant_default\n${GOVERNANCE_STREAM_ID}`) ?? [];
359
+ const tenantGovernanceSnapshot = {
360
+ streamId: GOVERNANCE_STREAM_ID,
361
+ lastChainHash: tenantGovernanceEvents.length ? tenantGovernanceEvents[tenantGovernanceEvents.length - 1]?.chainHash ?? null : null,
362
+ lastEventId: tenantGovernanceEvents.length ? tenantGovernanceEvents[tenantGovernanceEvents.length - 1]?.id ?? null : null
363
+ };
364
+ const governanceEvents = api.store.monthEvents.get(`${DEFAULT_TENANT_ID}\n${GOVERNANCE_STREAM_ID}`) ?? [];
365
+ const governanceSnapshot = {
366
+ streamId: GOVERNANCE_STREAM_ID,
367
+ lastChainHash: governanceEvents.length ? governanceEvents[governanceEvents.length - 1]?.chainHash ?? null : null,
368
+ lastEventId: governanceEvents.length ? governanceEvents[governanceEvents.length - 1]?.id ?? null : null
369
+ };
370
+
371
+ const jobBundle = buildJobProofBundleV1({
372
+ tenantId: "tenant_default",
373
+ jobId,
374
+ jobEvents,
375
+ jobSnapshot: api.store.jobs.get(`tenant_default\n${jobId}`) ?? created.json.job,
376
+ governanceEvents,
377
+ governanceSnapshot,
378
+ tenantGovernanceEvents,
379
+ tenantGovernanceSnapshot,
380
+ artifacts,
381
+ contractDocsByHash,
382
+ publicKeyByKeyId,
383
+ signerKeys,
384
+ manifestSigner,
385
+ generatedAt
386
+ });
387
+
388
+ const monthArtifacts = allArtifacts.filter((a) => {
389
+ if (!a || typeof a !== "object") return false;
390
+ if (a.month && String(a.month) === month) return true;
391
+ if (a.period && String(a.period) === month) return true;
392
+ return false;
393
+ });
394
+
395
+ const journalCsvArtifact =
396
+ monthArtifacts
397
+ .filter((a) => a?.artifactType === "JournalCsv.v1" && String(a?.period ?? "") === String(month))
398
+ .sort((a, b) => String(a?.artifactId ?? "").localeCompare(String(b?.artifactId ?? "")))
399
+ .slice(-1)[0] ?? null;
400
+
401
+ const monthBundle = buildMonthProofBundleV1({
402
+ tenantId: "tenant_default",
403
+ period: month,
404
+ basis: MONTH_CLOSE_BASIS.SETTLED_AT,
405
+ monthEvents,
406
+ governanceEvents,
407
+ governanceSnapshot,
408
+ tenantGovernanceEvents,
409
+ tenantGovernanceSnapshot,
410
+ artifacts: monthArtifacts,
411
+ contractDocsByHash,
412
+ publicKeyByKeyId,
413
+ signerKeys,
414
+ manifestSigner,
415
+ generatedAt
416
+ });
417
+
418
+ // Write outputs.
419
+ await fs.rm(latest, { recursive: true, force: true });
420
+ await fs.mkdir(latest, { recursive: true });
421
+
422
+ await writeJson(path.join(root, "run.json"), {
423
+ runId,
424
+ tenantId: "tenant_default",
425
+ jobId,
426
+ month,
427
+ bookedPolicyHash,
428
+ customerContractHash,
429
+ outputs: Object.keys(artifactsByType).sort(),
430
+ glBatchArtifactHash: glBatchArtifact?.artifactHash ?? null
431
+ });
432
+ await writeJson(path.join(latest, "run.json"), {
433
+ runId,
434
+ tenantId: "tenant_default",
435
+ jobId,
436
+ month,
437
+ bookedPolicyHash,
438
+ customerContractHash,
439
+ outputs: Object.keys(artifactsByType).sort(),
440
+ glBatchArtifactHash: glBatchArtifact?.artifactHash ?? null
441
+ });
442
+
443
+ for (const [artifactType, artifact] of Object.entries(artifactsByType)) {
444
+ await writeJson(path.join(root, `${artifactType}.json`), artifact);
445
+ await writeJson(path.join(latest, `${artifactType}.json`), artifact);
446
+ }
447
+
448
+ await writeJson(path.join(root, "GLBatch.v1.json"), glBatchArtifact);
449
+ await writeJson(path.join(latest, "GLBatch.v1.json"), glBatchArtifact);
450
+ await fs.writeFile(path.join(root, "GLBatch.v1.csv"), glCsv, "utf8");
451
+ await fs.writeFile(path.join(latest, "GLBatch.v1.csv"), glCsv, "utf8");
452
+
453
+ if (journalCsvArtifact) {
454
+ await writeJson(path.join(root, "JournalCsv.v1.json"), journalCsvArtifact);
455
+ await writeJson(path.join(latest, "JournalCsv.v1.json"), journalCsvArtifact);
456
+ if (typeof journalCsvArtifact.csv === "string") {
457
+ await fs.writeFile(path.join(root, "JournalCsv.v1.csv"), journalCsvArtifact.csv, "utf8");
458
+ await fs.writeFile(path.join(latest, "JournalCsv.v1.csv"), journalCsvArtifact.csv, "utf8");
459
+ }
460
+ }
461
+
462
+ await writeJson(path.join(root, "steps.json"), { steps });
463
+ await writeJson(path.join(latest, "steps.json"), { steps });
464
+
465
+ // Proof bundle directories + zip.
466
+ const jobBundleDir = path.join(root, "proof", "job");
467
+ const monthBundleDir = path.join(root, "proof", "month");
468
+ ensureDir(jobBundleDir);
469
+ ensureDir(monthBundleDir);
470
+ writeFilesToDir({ files: jobBundle.files, outDir: jobBundleDir });
471
+ writeFilesToDir({ files: monthBundle.files, outDir: monthBundleDir });
472
+ await writeZipFromDir({ dir: jobBundleDir, outPath: path.join(root, "JobProofBundle.v1.zip") });
473
+ await writeZipFromDir({ dir: monthBundleDir, outPath: path.join(root, "MonthProofBundle.v1.zip") });
474
+
475
+ // Also mirror proof bundles to latest.
476
+ const jobBundleDirLatest = path.join(latest, "proof", "job");
477
+ const monthBundleDirLatest = path.join(latest, "proof", "month");
478
+ ensureDir(jobBundleDirLatest);
479
+ ensureDir(monthBundleDirLatest);
480
+ writeFilesToDir({ files: jobBundle.files, outDir: jobBundleDirLatest });
481
+ writeFilesToDir({ files: monthBundle.files, outDir: monthBundleDirLatest });
482
+ await writeZipFromDir({ dir: jobBundleDirLatest, outPath: path.join(latest, "JobProofBundle.v1.zip") });
483
+ await writeZipFromDir({ dir: monthBundleDirLatest, outPath: path.join(latest, "MonthProofBundle.v1.zip") });
484
+
485
+ // Console summary.
486
+ process.stdout.write(`ok\njobId=${jobId}\nmonth=${month}\noutput=${latest}\n`);
487
+ process.stdout.write(`glBatchHash=${glBatchArtifact?.artifactHash ?? "missing"}\n`);
488
+ process.stdout.write(`glCsvSha256=${sha256Hex(new TextEncoder().encode(glCsv))}\n`);
489
+ }
490
+
491
+ main().catch((err) => {
492
+ // eslint-disable-next-line no-console
493
+ console.error(err);
494
+ process.exit(1);
495
+ });
@@ -0,0 +1,4 @@
1
+ {
2
+ "publicKeyPem": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAv0Gnw00fPMxSp81nfB2ZqhO20nRQ8pkTYyzkXvCzaIE=\n-----END PUBLIC KEY-----\n",
3
+ "privateKeyPem": "-----BEGIN PRIVATE KEY-----\nMC4CAQAwBQYDK2VwBCIEID/OvQImA+y6mlJ5IT0Y1t7RC1KagtWbpQj6PWhbYici\n-----END PRIVATE KEY-----\n"
4
+ }
@@ -0,0 +1,4 @@
1
+ {
2
+ "publicKeyPem": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAWsInmaySb9NFWDppZyHn8diAv+Q1IuKL34AiHFiAElQ=\n-----END PUBLIC KEY-----\n",
3
+ "privateKeyPem": "-----BEGIN PRIVATE KEY-----\nMC4CAQAwBQYDK2VwBCIEIEXYtiwWPHCi/wnsCxF/qBQk8ReEX6Ni7zAG4joJ6+SM\n-----END PRIVATE KEY-----\n"
4
+ }