chainlesschain 0.162.189 → 0.162.197
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.
- package/README.md +84 -11
- package/bin/chainlesschain.js +7 -52
- package/completions/_cc +209 -0
- package/completions/cc.bash +18 -0
- package/completions/cc.fish +13 -0
- package/completions/cc.ps1 +226 -0
- package/package.json +10 -2
- package/src/assets/web-panel/assets/{AIOps-DbZft8w0.js → AIOps-D3Gu1a5d.js} +1 -1
- package/src/assets/web-panel/assets/{ActionButton-DoOZpwfN.js → ActionButton-DrwAoKaz.js} +1 -1
- package/src/assets/web-panel/assets/{Analytics-B0J0KLTW.js → Analytics-C7Q-gd_3.js} +3 -3
- package/src/assets/web-panel/assets/{AppLayout-D9eIR0qq.js → AppLayout-DgBtae-n.js} +4 -4
- package/src/assets/web-panel/assets/{Artifacts-BnZXEVeo.js → Artifacts-pQ6LcA-W.js} +1 -1
- package/src/assets/web-panel/assets/{Audit-X1ce4Bjn.js → Audit-DK61tocB.js} +1 -1
- package/src/assets/web-panel/assets/{BackgroundAgents-BvWR-y5v.js → BackgroundAgents-BOKgDFRh.js} +1 -1
- package/src/assets/web-panel/assets/{Backup-BublSGEd.js → Backup-Bo9G4vTP.js} +1 -1
- package/src/assets/web-panel/assets/{BaseInput-CR_77Hso.js → BaseInput-Do_dE9_v.js} +1 -1
- package/src/assets/web-panel/assets/{Chat-DixW52tq.js → Chat-COVvZzOL.js} +6 -6
- package/src/assets/web-panel/assets/ChatBubbleRenderer-BUUyJ5QO.js +1 -0
- package/src/assets/web-panel/assets/{Checkbox-CCv1C87K.js → Checkbox-Z9MJMolt.js} +1 -1
- package/src/assets/web-panel/assets/{Codegen-B03Cc3dd.js → Codegen-BVzWKVbf.js} +1 -1
- package/src/assets/web-panel/assets/{Col-CA06-6pU.js → Col-C8MnYcbT.js} +1 -1
- package/src/assets/web-panel/assets/{Community-Bj881J52.js → Community-DQxqw15l.js} +1 -1
- package/src/assets/web-panel/assets/{Compact-UZLTPoaL.js → Compact-BAUmrh3y.js} +1 -1
- package/src/assets/web-panel/assets/{Compliance-kGwzRb_0.js → Compliance-jPAkQ3zK.js} +1 -1
- package/src/assets/web-panel/assets/{Cowork-KundoYM8.js → Cowork-BBQyxbh8.js} +2 -2
- package/src/assets/web-panel/assets/{Cron-BYZyoqDe.js → Cron-W5koq8Z5.js} +2 -2
- package/src/assets/web-panel/assets/{Crosschain-BhrrppBX.js → Crosschain-BQhnu5hS.js} +1 -1
- package/src/assets/web-panel/assets/{DID-CdC6EguZ.js → DID-DD7PlI18.js} +2 -2
- package/src/assets/web-panel/assets/{Dashboard-CcQx3J4y.js → Dashboard-w_ILuwKI.js} +2 -2
- package/src/assets/web-panel/assets/{Dropdown-BpijtEzQ.js → Dropdown-qiDUAyAo.js} +1 -1
- package/src/assets/web-panel/assets/{EmailListRenderer-DfZjeZTe.js → EmailListRenderer-PDeBcI5H.js} +1 -1
- package/src/assets/web-panel/assets/{FamilyGuardDashboard-BFYSf69C.js → FamilyGuardDashboard-SuArscRM.js} +1 -1
- package/src/assets/web-panel/assets/{Federation-Okdi3pJm.js → Federation-BCovZaUn.js} +1 -1
- package/src/assets/web-panel/assets/{FormItemContext-mH-HebKW.js → FormItemContext-DjlFdVFk.js} +1 -1
- package/src/assets/web-panel/assets/{GenericCardRenderer-xivV69x7.js → GenericCardRenderer-DoEZ7fcS.js} +1 -1
- package/src/assets/web-panel/assets/{Git-1rh_YBwg.js → Git-CV0-6GPI.js} +2 -2
- package/src/assets/web-panel/assets/{Governance-eAXkNxdY.js → Governance-B_SFN50w.js} +1 -1
- package/src/assets/web-panel/assets/{Inference-CS6dMVTN.js → Inference-heI0Eo6k.js} +1 -1
- package/src/assets/web-panel/assets/{KnowledgeGraph-Bq_TnkvD.js → KnowledgeGraph-Cz5INS5p.js} +1 -1
- package/src/assets/web-panel/assets/{Logs-KchHtiHt.js → Logs-BSFxiHkg.js} +2 -2
- package/src/assets/web-panel/assets/MarkdownRenderer-1mNozZ8v.js +1 -0
- package/src/assets/web-panel/assets/{Marketplace-CsmGcX5X.js → Marketplace-0TWTpE7k.js} +1 -1
- package/src/assets/web-panel/assets/{McpTools-BaPFnnyz.js → McpTools-CV4-wBLm.js} +4 -4
- package/src/assets/web-panel/assets/{Memory-2m-sUUf7.js → Memory-x5bH5rw5.js} +2 -2
- package/src/assets/web-panel/assets/{MobileBridge-D5nVZBRu.js → MobileBridge-DaBmUu9G.js} +1 -1
- package/src/assets/web-panel/assets/{MobileProjects-Bo8MLZvT.js → MobileProjects-DqnoFPgR.js} +1 -1
- package/src/assets/web-panel/assets/{Mtc-3GDvamGa.js → Mtc-B_zKEBif.js} +4 -4
- package/src/assets/web-panel/assets/{MtcAudit-D2zGuZCH.js → MtcAudit-BCfKD2yg.js} +4 -4
- package/src/assets/web-panel/assets/{Multisig-BBVQ4t6t.js → Multisig-DgYfj6c_.js} +3 -3
- package/src/assets/web-panel/assets/{NLProgramming-BIOCyOGp.js → NLProgramming-Dz09lFUm.js} +1 -1
- package/src/assets/web-panel/assets/{Notes-DVwBGpzc.js → Notes-Cuj6ugBE.js} +3 -3
- package/src/assets/web-panel/assets/{NotificationSettings-BDnHfIfX.js → NotificationSettings-DK2WXjhg.js} +1 -1
- package/src/assets/web-panel/assets/{OrderTableRenderer-C7Ek20ag.js → OrderTableRenderer-D1IAOQoo.js} +1 -1
- package/src/assets/web-panel/assets/{Organization-D3SRKaa7.js → Organization-9fqnPvTw.js} +4 -4
- package/src/assets/web-panel/assets/{Overflow-C2B8ahyn.js → Overflow-n5xHkhow.js} +1 -1
- package/src/assets/web-panel/assets/{P2P-2iwQzG65.js → P2P-B5AUWwH-.js} +2 -2
- package/src/assets/web-panel/assets/{PdhVaultBrowser-CoPiWqMN.js → PdhVaultBrowser-CoUDV6dy.js} +4 -4
- package/src/assets/web-panel/assets/{Permissions-yV5XNXo5.js → Permissions-DPRmQf_H.js} +4 -4
- package/src/assets/web-panel/assets/{PersonalDataHub-uCDJhMUF.js → PersonalDataHub-B37bsbEN.js} +4 -4
- package/src/assets/web-panel/assets/{Pipeline-hN7ucMOA.js → Pipeline-CCAuPqu9.js} +1 -1
- package/src/assets/web-panel/assets/{Privacy-CgU0ptN4.js → Privacy-B81msZdv.js} +1 -1
- package/src/assets/web-panel/assets/{ProjectInit-CfYPiT6j.js → ProjectInit-B-Py2NbF.js} +2 -2
- package/src/assets/web-panel/assets/{ProjectSettings-B0A2C4nw.js → ProjectSettings-CYsneiRB.js} +2 -2
- package/src/assets/web-panel/assets/{Projects-BE5C0ajn.js → Projects-Y975Mh6R.js} +1 -1
- package/src/assets/web-panel/assets/{Providers-CstQPf8W.js → Providers-uO-10aP1.js} +1 -1
- package/src/assets/web-panel/assets/{QrScannerModal-Co3z_ynk.js → QrScannerModal-Bj_6gJ0l.js} +1 -1
- package/src/assets/web-panel/assets/{QuickAsk-DMTS6pQ6.js → QuickAsk-BgpBCMPE.js} +1 -1
- package/src/assets/web-panel/assets/{Recommend-ETw4odUa.js → Recommend-DhUW3YUA.js} +1 -1
- package/src/assets/web-panel/assets/RemoteSession-DdeyfbkA.js +5 -0
- package/src/assets/web-panel/assets/{Reputation-BTVqQgKq.js → Reputation-fxW421xd.js} +1 -1
- package/src/assets/web-panel/assets/{Row-CBKKwwtO.js → Row-De73w1og.js} +1 -1
- package/src/assets/web-panel/assets/{RssFeed-BHUQ438I.js → RssFeed-3US_Q_lj.js} +2 -2
- package/src/assets/web-panel/assets/{Search-B4NqeUsF.js → Search-DbZ_DU74.js} +1 -1
- package/src/assets/web-panel/assets/{Security-BRjoYG5_.js → Security-DoIU1vMF.js} +4 -4
- package/src/assets/web-panel/assets/{Services-CxQzu3p3.js → Services-DB_RGqpc.js} +2 -2
- package/src/assets/web-panel/assets/{Skeleton-BKzwwmWO.js → Skeleton-DnzLaayC.js} +1 -1
- package/src/assets/web-panel/assets/{Skills-DrsFcgth.js → Skills-VzVXHENF.js} +1 -1
- package/src/assets/web-panel/assets/{Sla-D21tmXCH.js → Sla-DMfvjCAI.js} +1 -1
- package/src/assets/web-panel/assets/{SpeechSettings-CjyjLfp8.js → SpeechSettings-DQQOYWbF.js} +1 -1
- package/src/assets/web-panel/assets/{SyncSettings-Cu45-tnx.js → SyncSettings-Bmx3FG1P.js} +2 -2
- package/src/assets/web-panel/assets/{Tasks-oMcILYOj.js → Tasks-DOQyfb-2.js} +1 -1
- package/src/assets/web-panel/assets/{Templates-Bh-Zcr5R.js → Templates-D6hTRT7c.js} +1 -1
- package/src/assets/web-panel/assets/{Tenant-68ns63aI.js → Tenant-CTPQZAzs.js} +1 -1
- package/src/assets/web-panel/assets/{Terminal-BLJkFykE.js → Terminal-B7vII3oH.js} +2 -2
- package/src/assets/web-panel/assets/{TimelineRenderer-xcrJLq-O.js → TimelineRenderer-BkiFJeXV.js} +1 -1
- package/src/assets/web-panel/assets/{Tokens-C6PpFJtf.js → Tokens-BPPdQMNo.js} +1 -1
- package/src/assets/web-panel/assets/{Trigger-BaKA7tdM.js → Trigger-BxG8JAEI.js} +1 -1
- package/src/assets/web-panel/assets/{Trust-BzhA57Jc.js → Trust-DHD7nMpM.js} +1 -1
- package/src/assets/web-panel/assets/{UkeySign-4_U3JkIR.js → UkeySign-B4BJpU47.js} +1 -1
- package/src/assets/web-panel/assets/{VideoEditing-162AANxX.js → VideoEditing-CRiGpFx2.js} +1 -1
- package/src/assets/web-panel/assets/{Wallet-B1viuql_.js → Wallet-BSDSNiem.js} +4 -4
- package/src/assets/web-panel/assets/{WebAuthn-ZVWazhCy.js → WebAuthn-DLTUh5Zv.js} +5 -5
- package/src/assets/web-panel/assets/WorkflowEditor-tW2MwjhD.js +1 -0
- package/src/assets/web-panel/assets/{chat-DmrHNuwq.js → chat-SgsLQ3FC.js} +1 -1
- package/src/assets/web-panel/assets/{colors-DAJ_M-PK.js → colors-BHjjLIKO.js} +1 -1
- package/src/assets/web-panel/assets/{compact-item-uIzmYwLs.js → compact-item-VceErdKq.js} +1 -1
- package/src/assets/web-panel/assets/{createContext-D_ZmuLwb.js → createContext-BZ332MYl.js} +1 -1
- package/src/assets/web-panel/assets/devWarning-DosMaL-k.js +1 -0
- package/src/assets/web-panel/assets/{hasIn-CDt_shTL.js → hasIn-CBTjJOjn.js} +1 -1
- package/src/assets/web-panel/assets/index-0O5ePnUq.js +1 -0
- package/src/assets/web-panel/assets/{index-rXdwUeE3.js → index-1n7xjKDU.js} +1 -1
- package/src/assets/web-panel/assets/{index-BAvSmJXW.js → index-29wVzi-k.js} +1 -1
- package/src/assets/web-panel/assets/{index-C16fYKFD.js → index-B2u26AS3.js} +1 -1
- package/src/assets/web-panel/assets/{index-C5WcdJH2.js → index-B40dQn0G.js} +3 -3
- package/src/assets/web-panel/assets/{index-CaelyMgF.js → index-B5KAGxNo.js} +1 -1
- package/src/assets/web-panel/assets/{index-OzTxFIJP.js → index-BC1xuQgX.js} +1 -1
- package/src/assets/web-panel/assets/{index-CzXqvMuP.js → index-BETEjuNr.js} +1 -1
- package/src/assets/web-panel/assets/{index-clSX4PEc.js → index-BOtvPdHt.js} +1 -1
- package/src/assets/web-panel/assets/{index-saf3VNeP.js → index-BPXFLYdW.js} +1 -1
- package/src/assets/web-panel/assets/{index-DdUMcwRB.js → index-BQSmZGgs.js} +1 -1
- package/src/assets/web-panel/assets/{index-DfSSy9uy.js → index-BRWhLbWF.js} +1 -1
- package/src/assets/web-panel/assets/{index-GcKOHD_c.js → index-BTlc-Bve.js} +1 -1
- package/src/assets/web-panel/assets/{index-BHvlm0In.js → index-BY1wexYG.js} +1 -1
- package/src/assets/web-panel/assets/{index-Cvak6Oe2.js → index-BcUenmCX.js} +1 -1
- package/src/assets/web-panel/assets/{index-CKyd472S.js → index-BeiqkxJG.js} +1 -1
- package/src/assets/web-panel/assets/{index-DvFhhe6r.js → index-BhXZEUAc.js} +1 -1
- package/src/assets/web-panel/assets/{index-DBFmcaCQ.js → index-By5jBtkV.js} +1 -1
- package/src/assets/web-panel/assets/{index-DqDSF2RW.js → index-CLc19alH.js} +1 -1
- package/src/assets/web-panel/assets/{index-DeGBoLQA.js → index-CMVvxIS8.js} +1 -1
- package/src/assets/web-panel/assets/{index-FyplHuNt.js → index-C_B9rFQE.js} +1 -1
- package/src/assets/web-panel/assets/{index-CeUpKjvi.js → index-CaIS_TNX.js} +1 -1
- package/src/assets/web-panel/assets/{index-BRa4kJ_S.js → index-CawpdGTW.js} +1 -1
- package/src/assets/web-panel/assets/index-ChAzPigF.js +1 -0
- package/src/assets/web-panel/assets/{index-QsgfSZrV.js → index-CpumS98o.js} +1 -1
- package/src/assets/web-panel/assets/{index-BDF6EQBs.js → index-Cr4rjlW5.js} +1 -1
- package/src/assets/web-panel/assets/{index-rS3gl_68.js → index-CrUgDQkf.js} +1 -1
- package/src/assets/web-panel/assets/{index-D4n1lGTB.js → index-CtjLcCNU.js} +1 -1
- package/src/assets/web-panel/assets/{index-ifxmu8SY.js → index-DUkVN794.js} +1 -1
- package/src/assets/web-panel/assets/{index-BTCXf1t-.js → index-D_SePDWj.js} +1 -1
- package/src/assets/web-panel/assets/{index-Bbxjfstq.js → index-DaCCy6lq.js} +1 -1
- package/src/assets/web-panel/assets/{index-D9OE8B3d.js → index-DdefYBSw.js} +1 -1
- package/src/assets/web-panel/assets/{index-CG0lY4h3.js → index-DePOeMDM.js} +1 -1
- package/src/assets/web-panel/assets/{index-Bx4d6c1k.js → index-DgPvuIn2.js} +1 -1
- package/src/assets/web-panel/assets/{index-Z8P4BexE.js → index-FJ3zC9LK.js} +1 -1
- package/src/assets/web-panel/assets/{index-ByzGvpR9.js → index-_PHrIO4O.js} +1 -1
- package/src/assets/web-panel/assets/{index-DwfvPe-j.js → index-fU7wNHDB.js} +1 -1
- package/src/assets/web-panel/assets/{index-CcZ9xJI9.js → index-iYQNU9za.js} +1 -1
- package/src/assets/web-panel/assets/{index-CbD_WW_6.js → index-vIXOpcjD.js} +1 -1
- package/src/assets/web-panel/assets/{initDefaultProps-pmfaD-aK.js → initDefaultProps-D1oZNz0D.js} +1 -1
- package/src/assets/web-panel/assets/{motion-CaQ2CpYF.js → motion-C8k6doMO.js} +1 -1
- package/src/assets/web-panel/assets/{move-CkKTqNbI.js → move-DJ4qSbYt.js} +1 -1
- package/src/assets/web-panel/assets/{mtc-parser-Dd4xsgRI.js → mtc-parser-CdpJD85j.js} +1 -1
- package/src/assets/web-panel/assets/{omit-BFuA5YEs.js → omit-B0V4slKA.js} +1 -1
- package/src/assets/web-panel/assets/{pickAttrs-DDfxOAJc.js → pickAttrs-Di5NiW1F.js} +1 -1
- package/src/assets/web-panel/assets/{placementArrow-Be595JCp.js → placementArrow-B5OMHgEM.js} +1 -1
- package/src/assets/web-panel/assets/{responsiveObserve-7byljUM3.js → responsiveObserve-C6U9IWql.js} +1 -1
- package/src/assets/web-panel/assets/{slide-CTWfOTaY.js → slide-BMyTH3rN.js} +1 -1
- package/src/assets/web-panel/assets/{statusUtils-CNZOuIxM.js → statusUtils-C7d6BG7Z.js} +1 -1
- package/src/assets/web-panel/assets/{styleChecker-DwOcBV78.js → styleChecker-CR50QnQy.js} +1 -1
- package/src/assets/web-panel/assets/{useFlexGapSupport-B6MNwAO9.js → useFlexGapSupport-DBEeoMb8.js} +1 -1
- package/src/assets/web-panel/assets/{useFs-CzyQjH9r.js → useFs-3r099cjv.js} +1 -1
- package/src/assets/web-panel/assets/{usePersonalDataHub-Dxh3KiVA.js → usePersonalDataHub-C5IYNdTK.js} +1 -1
- package/src/assets/web-panel/assets/{vnode-DVfZiS5N.js → vnode-DmEOLRHf.js} +1 -1
- package/src/assets/web-panel/assets/{zoom-BYme7fbY.js → zoom-DnpUiVCB.js} +1 -1
- package/src/assets/web-panel/index.html +1 -1
- package/src/cli-help.js +181 -0
- package/src/command-help-index.json +181 -0
- package/src/command-manifest.json +1271 -175
- package/src/command-surface-policy.js +312 -0
- package/src/commands/agent.js +76 -33
- package/src/commands/artifacts.js +400 -2
- package/src/commands/background-session.js +41 -3
- package/src/commands/checkpoint-restore-recovery.js +1476 -0
- package/src/commands/checkpoint.js +947 -22
- package/src/commands/compact.js +101 -25
- package/src/commands/config.js +506 -20
- package/src/commands/doctor.js +4 -1
- package/src/commands/hub.js +1 -1
- package/src/commands/mcp.js +688 -24
- package/src/commands/pack.js +16 -2
- package/src/commands/plugin.js +20 -12
- package/src/commands/session-mcp-recovery.js +218 -0
- package/src/commands/session.js +470 -110
- package/src/commands/setup.js +36 -10
- package/src/commands/skill.js +181 -110
- package/src/commands/status.js +21 -5
- package/src/commands/update.js +68 -6
- package/src/constants.js +11 -0
- package/src/data/changelog.json +14 -1
- package/src/gateways/ws/action-protocol.js +10 -0
- package/src/gateways/ws/session-protocol.js +555 -27
- package/src/gateways/ws/ws-agent-handler.js +541 -14
- package/src/gateways/ws/ws-session-gateway.js +129 -22
- package/src/gateways/ws/ws-session-state.js +431 -0
- package/src/harness/background-task-manager.js +233 -36
- package/src/harness/jsonl-session-store.js +2551 -167
- package/src/harness/mcp-client.js +802 -61
- package/src/harness/prompt-compressor.js +227 -27
- package/src/harness/session-index.js +89 -38
- package/src/harness/session-list-index.js +254 -0
- package/src/harness/structured-handoff.js +410 -0
- package/src/lazy-dispatch.js +747 -84
- package/src/lib/__tests__/logger.test.js +50 -2
- package/src/lib/advisor-runtime.js +1047 -0
- package/src/lib/agent-core.js +1 -0
- package/src/lib/agent-sandbox.js +120 -26
- package/src/lib/agent-session-export.js +20 -0
- package/src/lib/agent-team/team-runner.js +230 -8
- package/src/lib/artifact-store.js +131 -8
- package/src/lib/background-agent-supervisor.js +185 -13
- package/src/lib/background-interaction-journal.js +37 -9
- package/src/lib/background-launch-profile.js +1058 -0
- package/src/lib/checkpoint-restore-already-completed-controller.js +902 -0
- package/src/lib/checkpoint-restore-orchestrator.js +987 -0
- package/src/lib/checkpoint-restore-partial-rollback-controller.js +1953 -0
- package/src/lib/checkpoint-restore-recovery-controller.js +689 -0
- package/src/lib/checkpoint-restore-recovery.js +884 -0
- package/src/lib/checkpoint-restore-retention.js +126 -0
- package/src/lib/checkpoint-restore-saga.js +5079 -0
- package/src/lib/checkpoint-restore-session-recovery.js +1178 -0
- package/src/lib/checkpoint-restore-workspace-target-verifier.js +270 -0
- package/src/lib/checkpoint-store.js +1688 -97
- package/src/lib/checkpoint-timeline-authority.js +522 -0
- package/src/lib/checkpoint-timeline.js +642 -0
- package/src/lib/config-keys.js +18 -119
- package/src/lib/config-manager.js +446 -27
- package/src/lib/config-redaction.js +57 -0
- package/src/lib/config-schema.js +853 -0
- package/src/lib/cowork-mcp-tools.js +5 -0
- package/src/lib/cowork-task-runner.js +458 -63
- package/src/lib/delivery-coordinator.js +1234 -0
- package/src/lib/delivery-evidence.js +450 -0
- package/src/lib/doctor-checkup.js +199 -14
- package/src/lib/executable-path.js +34 -0
- package/src/lib/fatal-handler.js +16 -0
- package/src/lib/file-checkpoint.js +4909 -186
- package/src/lib/file-lines.js +125 -0
- package/src/lib/headless-config-command.js +16 -5
- package/src/lib/hook-runner.cjs +139 -38
- package/src/lib/hooks-v2-workspace-context.js +10 -0
- package/src/lib/impacted-gate-selector.js +424 -0
- package/src/lib/interaction-adapter.js +62 -0
- package/src/lib/jsonl-session-store.js +1 -35
- package/src/lib/logger.js +66 -14
- package/src/lib/mcp-call-ledger-store.js +1069 -0
- package/src/lib/mcp-call-ledger.js +747 -0
- package/src/lib/mcp-client.js +5 -0
- package/src/lib/mcp-conflict-scheduler.js +468 -0
- package/src/lib/mcp-effect-contract.js +102 -0
- package/src/lib/mcp-headers-helper-trust.js +145 -0
- package/src/lib/mcp-headers-helper.js +616 -0
- package/src/lib/mcp-host-recovery-runtime.js +131 -0
- package/src/lib/mcp-ledger-recovery-admission.js +1065 -0
- package/src/lib/mcp-recovery-adjudication.js +443 -0
- package/src/lib/output-context.js +86 -0
- package/src/lib/packer/file-identity.js +170 -0
- package/src/lib/packer/index.js +3 -0
- package/src/lib/packer/native-update-state.js +277 -0
- package/src/lib/packer/pack-update-applier.js +1983 -136
- package/src/lib/packer/pack-update-checker.js +34 -0
- package/src/lib/packer/pack-update-downloader.js +875 -86
- package/src/lib/packer/pack-update-signature.js +86 -0
- package/src/lib/packer/pkg-config-generator.js +6 -0
- package/src/lib/paths.js +65 -10
- package/src/lib/plan-mode.js +831 -14
- package/src/lib/plan-persistence.js +540 -0
- package/src/lib/plugin-runtime/hooks.js +227 -69
- package/src/lib/plugin-runtime/plugin-options.js +189 -44
- package/src/lib/pr-automation-policy.js +146 -8
- package/src/lib/process-execution-broker/credential-agent.js +7 -0
- package/src/lib/process-execution-broker/index.js +53 -8
- package/src/lib/process-execution-broker/workspace-transaction.js +976 -73
- package/src/lib/project-instructions.js +165 -29
- package/src/lib/project-mcp-trust.js +67 -0
- package/src/lib/public-ide-capability-manifest.js +278 -0
- package/src/lib/public-ide-capability-validation.js +351 -0
- package/src/lib/secret-store.js +267 -43
- package/src/lib/secure-fs.js +1089 -0
- package/src/lib/security-audit.js +58 -0
- package/src/lib/service-manager.js +34 -13
- package/src/lib/session-budget-runtime.js +1452 -0
- package/src/lib/session-host-snapshot.js +388 -0
- package/src/lib/session-message-provenance.js +429 -0
- package/src/lib/session-projection.js +804 -0
- package/src/lib/session-resource-budget.js +1495 -0
- package/src/lib/settings-hooks.cjs +138 -22
- package/src/lib/settings-loader.cjs +25 -2
- package/src/lib/side-effect-ledger-store.js +45 -23
- package/src/lib/skill-execution-identity.js +217 -0
- package/src/lib/skill-loader.js +299 -18
- package/src/lib/sub-agent-context.js +236 -28
- package/src/lib/sub-agent-registry.js +5 -0
- package/src/lib/subagent-contract.js +94 -0
- package/src/lib/todo-manager.js +185 -18
- package/src/lib/todo-persistence.js +417 -0
- package/src/lib/turn-binding-store.js +41 -23
- package/src/lib/with-file-lock.js +25 -1
- package/src/lib/ws-chat-handler.js +21 -0
- package/src/program-base.js +18 -0
- package/src/repl/advisor-command.js +103 -0
- package/src/repl/agent-repl.js +2332 -154
- package/src/repl/btw-command.js +93 -10
- package/src/repl/clipboard-image.js +119 -0
- package/src/repl/config-summary.js +64 -108
- package/src/repl/prompt-editor.js +233 -0
- package/src/repl/prompt-interactions.js +404 -0
- package/src/repl/prompt-stash.js +354 -0
- package/src/repl/prompt-suggestions.js +312 -0
- package/src/repl/repl-keybindings.js +227 -0
- package/src/repl/session-recap.js +217 -0
- package/src/repl/slash-command-registry.js +25 -4
- package/src/repl/terminal-layout.js +88 -0
- package/src/runtime/agent-core.js +1264 -325
- package/src/runtime/coding-agent-contract-shared.cjs +13 -1
- package/src/runtime/coding-agent-managed-tool-policy.cjs +7 -2
- package/src/runtime/diagnostics.js +32 -13
- package/src/runtime/headless-runner.js +298 -118
- package/src/runtime/headless-stream.js +353 -95
- package/src/runtime/mcp-config.js +148 -14
- package/src/runtime/status-diagnostics-lite.js +137 -0
- package/src/assets/web-panel/assets/ChatBubbleRenderer-DDHDpBBA.js +0 -1
- package/src/assets/web-panel/assets/MarkdownRenderer-TabqHW9B.js +0 -1
- package/src/assets/web-panel/assets/RemoteSession-B0rkE09d.js +0 -5
- package/src/assets/web-panel/assets/WorkflowEditor-tzdyUk-1.js +0 -1
- package/src/assets/web-panel/assets/devWarning-DIrncrV1.js +0 -1
- package/src/assets/web-panel/assets/index-D-Swwqld.js +0 -1
- package/src/assets/web-panel/assets/index-FMZAMKy8.js +0 -1
package/src/lib/todo-manager.js
CHANGED
|
@@ -1,7 +1,28 @@
|
|
|
1
|
+
import {
|
|
2
|
+
TODO_PERSISTENCE_ERROR_CODES,
|
|
3
|
+
TODO_SNAPSHOT_SCHEMA,
|
|
4
|
+
TODO_SNAPSHOT_VERSION,
|
|
5
|
+
TodoPersistenceError,
|
|
6
|
+
TodoSnapshotPersistence,
|
|
7
|
+
resolveTodoStateDir,
|
|
8
|
+
} from "./todo-persistence.js";
|
|
9
|
+
|
|
10
|
+
export {
|
|
11
|
+
TODO_PERSISTENCE_ERROR_CODES,
|
|
12
|
+
TODO_SNAPSHOT_SCHEMA,
|
|
13
|
+
TODO_SNAPSHOT_VERSION,
|
|
14
|
+
TodoPersistenceError,
|
|
15
|
+
TodoSnapshotPersistence,
|
|
16
|
+
resolveTodoStateDir,
|
|
17
|
+
todoSnapshotPath,
|
|
18
|
+
} from "./todo-persistence.js";
|
|
19
|
+
|
|
1
20
|
/**
|
|
2
21
|
* Session TODO Manager
|
|
3
22
|
*
|
|
4
|
-
*
|
|
23
|
+
* Session-scoped TODO list. Named sessions use a versioned, revision-CAS
|
|
24
|
+
* snapshot by default; the unnamed/default store and `{ memoryOnly: true }`
|
|
25
|
+
* retain the original in-memory behavior.
|
|
5
26
|
* Inspired by open-agents todo_write tool.
|
|
6
27
|
*
|
|
7
28
|
* Contract:
|
|
@@ -19,10 +40,83 @@ const VALID_STATUSES = Object.freeze([
|
|
|
19
40
|
|
|
20
41
|
const _stores = new Map();
|
|
21
42
|
|
|
22
|
-
|
|
23
|
-
|
|
43
|
+
function cloneTodos(todos) {
|
|
44
|
+
return todos.map((todo) => ({
|
|
45
|
+
id: todo.id,
|
|
46
|
+
content: todo.content,
|
|
47
|
+
status: todo.status,
|
|
48
|
+
}));
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function resolveStoreTarget(sessionId, options = {}) {
|
|
52
|
+
if (
|
|
53
|
+
!sessionId ||
|
|
54
|
+
options.memoryOnly === true ||
|
|
55
|
+
options.persistence === false
|
|
56
|
+
) {
|
|
57
|
+
return {
|
|
58
|
+
key: `memory:${sessionId || "__default__"}`,
|
|
59
|
+
persistence: null,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
const supplied = options.persistence;
|
|
63
|
+
const persistence =
|
|
64
|
+
supplied && typeof supplied === "object"
|
|
65
|
+
? supplied
|
|
66
|
+
: new TodoSnapshotPersistence({
|
|
67
|
+
...(options.persistenceOptions || {}),
|
|
68
|
+
...(options.stateDir ? { stateDir: options.stateDir } : {}),
|
|
69
|
+
validateTodos,
|
|
70
|
+
});
|
|
71
|
+
const identity =
|
|
72
|
+
persistence.identity ||
|
|
73
|
+
persistence.stateDir ||
|
|
74
|
+
resolveTodoStateDir({ stateDir: options.stateDir });
|
|
75
|
+
return {
|
|
76
|
+
key: `persistent:${identity}:${sessionId}`,
|
|
77
|
+
persistence,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
function persistenceFailure(error) {
|
|
82
|
+
const known =
|
|
83
|
+
error instanceof TodoPersistenceError ||
|
|
84
|
+
String(error?.code || "").startsWith("TODO_");
|
|
85
|
+
return {
|
|
86
|
+
success: false,
|
|
87
|
+
code: known ? error.code : TODO_PERSISTENCE_ERROR_CODES.WRITE_FAILED,
|
|
88
|
+
error: known ? error.message : "TODO persistence failed",
|
|
89
|
+
...(Number.isSafeInteger(error?.expectedRevision)
|
|
90
|
+
? { expectedRevision: error.expectedRevision }
|
|
91
|
+
: {}),
|
|
92
|
+
...(Number.isSafeInteger(error?.actualRevision)
|
|
93
|
+
? { actualRevision: error.actualRevision }
|
|
94
|
+
: {}),
|
|
95
|
+
...(typeof error?.recoveryStrategy === "string"
|
|
96
|
+
? { recoveryStrategy: error.recoveryStrategy }
|
|
97
|
+
: {}),
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
export function getTodoStore(sessionId, options = {}) {
|
|
102
|
+
const { key, persistence } = resolveStoreTarget(sessionId, options);
|
|
24
103
|
if (!_stores.has(key)) {
|
|
25
|
-
|
|
104
|
+
if (persistence) {
|
|
105
|
+
const snapshot = persistence.load(sessionId);
|
|
106
|
+
_stores.set(key, {
|
|
107
|
+
todos: cloneTodos(snapshot.todos),
|
|
108
|
+
revision: snapshot.revision,
|
|
109
|
+
persistence,
|
|
110
|
+
sessionId,
|
|
111
|
+
});
|
|
112
|
+
} else {
|
|
113
|
+
_stores.set(key, {
|
|
114
|
+
todos: [],
|
|
115
|
+
revision: 0,
|
|
116
|
+
persistence: null,
|
|
117
|
+
sessionId: sessionId || null,
|
|
118
|
+
});
|
|
119
|
+
}
|
|
26
120
|
}
|
|
27
121
|
return _stores.get(key);
|
|
28
122
|
}
|
|
@@ -64,33 +158,106 @@ export function validateTodos(todos) {
|
|
|
64
158
|
return { valid: true };
|
|
65
159
|
}
|
|
66
160
|
|
|
67
|
-
export function writeTodos(sessionId, todos) {
|
|
161
|
+
export function writeTodos(sessionId, todos, options = {}) {
|
|
68
162
|
const check = validateTodos(todos);
|
|
69
163
|
if (!check.valid) {
|
|
70
164
|
return { success: false, error: check.error };
|
|
71
165
|
}
|
|
72
|
-
const
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
166
|
+
const hasExpectedRevision = Object.prototype.hasOwnProperty.call(
|
|
167
|
+
options,
|
|
168
|
+
"expectedRevision",
|
|
169
|
+
);
|
|
170
|
+
if (
|
|
171
|
+
hasExpectedRevision &&
|
|
172
|
+
(!Number.isSafeInteger(options.expectedRevision) ||
|
|
173
|
+
options.expectedRevision < 0)
|
|
174
|
+
) {
|
|
175
|
+
return {
|
|
176
|
+
success: false,
|
|
177
|
+
code: TODO_PERSISTENCE_ERROR_CODES.REVISION_CONFLICT,
|
|
178
|
+
error: "expectedRevision must be a non-negative safe integer",
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
let store;
|
|
182
|
+
try {
|
|
183
|
+
store = getTodoStore(sessionId, options);
|
|
184
|
+
} catch (error) {
|
|
185
|
+
return persistenceFailure(error);
|
|
186
|
+
}
|
|
187
|
+
const nextTodos = cloneTodos(todos);
|
|
188
|
+
if (store.persistence) {
|
|
189
|
+
const expectedRevision = hasExpectedRevision
|
|
190
|
+
? options.expectedRevision
|
|
191
|
+
: store.revision;
|
|
192
|
+
let snapshot;
|
|
193
|
+
try {
|
|
194
|
+
snapshot = store.persistence.compareAndSwap(
|
|
195
|
+
sessionId,
|
|
196
|
+
expectedRevision,
|
|
197
|
+
nextTodos,
|
|
198
|
+
);
|
|
199
|
+
} catch (error) {
|
|
200
|
+
return persistenceFailure(error);
|
|
201
|
+
}
|
|
202
|
+
store.todos = cloneTodos(snapshot.todos);
|
|
203
|
+
store.revision = snapshot.revision;
|
|
204
|
+
} else {
|
|
205
|
+
if (hasExpectedRevision && options.expectedRevision !== store.revision) {
|
|
206
|
+
return {
|
|
207
|
+
success: false,
|
|
208
|
+
code: TODO_PERSISTENCE_ERROR_CODES.REVISION_CONFLICT,
|
|
209
|
+
error: "TODO snapshot revision conflict",
|
|
210
|
+
expectedRevision: options.expectedRevision,
|
|
211
|
+
actualRevision: store.revision,
|
|
212
|
+
};
|
|
213
|
+
}
|
|
214
|
+
store.todos = nextTodos;
|
|
215
|
+
store.revision += 1;
|
|
216
|
+
}
|
|
78
217
|
return {
|
|
79
218
|
success: true,
|
|
80
219
|
count: store.todos.length,
|
|
81
220
|
summary: summarizeTodos(store.todos),
|
|
221
|
+
revision: store.revision,
|
|
82
222
|
};
|
|
83
223
|
}
|
|
84
224
|
|
|
85
|
-
export function getTodos(sessionId) {
|
|
86
|
-
const store = getTodoStore(sessionId);
|
|
87
|
-
|
|
225
|
+
export function getTodos(sessionId, options = {}) {
|
|
226
|
+
const store = getTodoStore(sessionId, options);
|
|
227
|
+
if (store.persistence && options.refresh !== false) {
|
|
228
|
+
const snapshot = store.persistence.load(sessionId);
|
|
229
|
+
store.todos = cloneTodos(snapshot.todos);
|
|
230
|
+
store.revision = snapshot.revision;
|
|
231
|
+
}
|
|
232
|
+
return cloneTodos(store.todos);
|
|
88
233
|
}
|
|
89
234
|
|
|
90
|
-
export function
|
|
91
|
-
const
|
|
92
|
-
store
|
|
93
|
-
return {
|
|
235
|
+
export function getTodoSnapshot(sessionId, options = {}) {
|
|
236
|
+
const todos = getTodos(sessionId, options);
|
|
237
|
+
const store = getTodoStore(sessionId, { ...options, refresh: false });
|
|
238
|
+
return {
|
|
239
|
+
schema: TODO_SNAPSHOT_SCHEMA,
|
|
240
|
+
version: TODO_SNAPSHOT_VERSION,
|
|
241
|
+
sessionId: sessionId || null,
|
|
242
|
+
revision: store.revision,
|
|
243
|
+
todos,
|
|
244
|
+
};
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
export function clearTodos(sessionId, options = {}) {
|
|
248
|
+
const result = writeTodos(sessionId, [], options);
|
|
249
|
+
if (!result.success) return result;
|
|
250
|
+
return { success: true, revision: result.revision };
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
export function recoverTodoSnapshot(sessionId, strategy, options = {}) {
|
|
254
|
+
const { key, persistence } = resolveStoreTarget(sessionId, options);
|
|
255
|
+
if (!persistence) {
|
|
256
|
+
return { strategy, recovered: 0, memoryOnly: true };
|
|
257
|
+
}
|
|
258
|
+
const result = persistence.recover(sessionId, strategy);
|
|
259
|
+
_stores.delete(key);
|
|
260
|
+
return result;
|
|
94
261
|
}
|
|
95
262
|
|
|
96
263
|
export function summarizeTodos(todos) {
|
|
@@ -0,0 +1,417 @@
|
|
|
1
|
+
import fsDefault from "node:fs";
|
|
2
|
+
import pathDefault from "node:path";
|
|
3
|
+
import { randomUUID as randomUUIDDefault } from "node:crypto";
|
|
4
|
+
import { getStatePath as getStatePathDefault } from "./paths.js";
|
|
5
|
+
import { withFileLock as withFileLockDefault } from "./with-file-lock.js";
|
|
6
|
+
|
|
7
|
+
export const TODO_SNAPSHOT_SCHEMA = "chainlesschain.session-todos";
|
|
8
|
+
export const TODO_SNAPSHOT_VERSION = 1;
|
|
9
|
+
|
|
10
|
+
export const TODO_PERSISTENCE_ERROR_CODES = Object.freeze({
|
|
11
|
+
INVALID_SESSION: "TODO_SESSION_ID_INVALID",
|
|
12
|
+
CORRUPT: "TODO_SNAPSHOT_CORRUPT",
|
|
13
|
+
RECOVERY_REQUIRED: "TODO_SNAPSHOT_RECOVERY_REQUIRED",
|
|
14
|
+
REVISION_CONFLICT: "TODO_REVISION_CONFLICT",
|
|
15
|
+
WRITE_FAILED: "TODO_SNAPSHOT_WRITE_FAILED",
|
|
16
|
+
LOCK_FAILED: "TODO_SNAPSHOT_LOCK_FAILED",
|
|
17
|
+
RECOVERY_FAILED: "TODO_SNAPSHOT_RECOVERY_FAILED",
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
export class TodoPersistenceError extends Error {
|
|
21
|
+
constructor(code, message, options = {}) {
|
|
22
|
+
super(message, options.cause ? { cause: options.cause } : undefined);
|
|
23
|
+
this.name = "TodoPersistenceError";
|
|
24
|
+
this.code = code;
|
|
25
|
+
for (const [key, value] of Object.entries(options.details || {})) {
|
|
26
|
+
this[key] = value;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function persistenceError(code, message, cause, details) {
|
|
32
|
+
return new TodoPersistenceError(code, message, { cause, details });
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function isKnownPersistenceError(error) {
|
|
36
|
+
return error instanceof TodoPersistenceError;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export function isUnsafeTodoSessionId(sessionId) {
|
|
40
|
+
return (
|
|
41
|
+
typeof sessionId !== "string" ||
|
|
42
|
+
sessionId.length === 0 ||
|
|
43
|
+
sessionId.includes("/") ||
|
|
44
|
+
sessionId.includes("\\") ||
|
|
45
|
+
sessionId.includes("..") ||
|
|
46
|
+
sessionId.includes("\0")
|
|
47
|
+
);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function assertSafeSessionId(sessionId) {
|
|
51
|
+
if (isUnsafeTodoSessionId(sessionId)) {
|
|
52
|
+
throw persistenceError(
|
|
53
|
+
TODO_PERSISTENCE_ERROR_CODES.INVALID_SESSION,
|
|
54
|
+
"TODO persistence requires a safe non-empty session id",
|
|
55
|
+
null,
|
|
56
|
+
{
|
|
57
|
+
sessionId:
|
|
58
|
+
typeof sessionId === "string" ? sessionId.slice(0, 80) : null,
|
|
59
|
+
},
|
|
60
|
+
);
|
|
61
|
+
}
|
|
62
|
+
return sessionId;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** Resolve the state directory through an injectable seam for hosts and tests. */
|
|
66
|
+
export function resolveTodoStateDir(options = {}) {
|
|
67
|
+
const path = options.path || pathDefault;
|
|
68
|
+
if (typeof options.stateDir === "string" && options.stateDir.trim()) {
|
|
69
|
+
return path.resolve(options.stateDir);
|
|
70
|
+
}
|
|
71
|
+
const env = options.env || process.env;
|
|
72
|
+
const dataDir = env.CHAINLESSCHAIN_DATA_DIR;
|
|
73
|
+
if (typeof dataDir === "string" && dataDir.trim()) {
|
|
74
|
+
return path.join(path.resolve(dataDir), "todos");
|
|
75
|
+
}
|
|
76
|
+
const getStatePath = options.getStatePath || getStatePathDefault;
|
|
77
|
+
return path.join(path.resolve(getStatePath()), "todos");
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export function todoSnapshotPath(sessionId, options = {}) {
|
|
81
|
+
const path = options.path || pathDefault;
|
|
82
|
+
return path.join(
|
|
83
|
+
resolveTodoStateDir({ ...options, path }),
|
|
84
|
+
`${assertSafeSessionId(sessionId)}.json`,
|
|
85
|
+
);
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
function cloneTodos(todos) {
|
|
89
|
+
return todos.map((todo) => ({
|
|
90
|
+
id: todo.id,
|
|
91
|
+
content: todo.content,
|
|
92
|
+
status: todo.status,
|
|
93
|
+
}));
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function emptySnapshot(sessionId) {
|
|
97
|
+
return {
|
|
98
|
+
schema: TODO_SNAPSHOT_SCHEMA,
|
|
99
|
+
version: TODO_SNAPSHOT_VERSION,
|
|
100
|
+
sessionId,
|
|
101
|
+
revision: 0,
|
|
102
|
+
updatedAt: 0,
|
|
103
|
+
todos: [],
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Versioned, revision-CAS snapshot store for one session's canonical TODO list.
|
|
109
|
+
* It never logs snapshot contents. Corrupt canonical files and orphaned atomic
|
|
110
|
+
* write files remain visible and block writes until explicitly recovered.
|
|
111
|
+
*/
|
|
112
|
+
export class TodoSnapshotPersistence {
|
|
113
|
+
constructor(options = {}) {
|
|
114
|
+
this._fs = options.fs || fsDefault;
|
|
115
|
+
this._path = options.path || pathDefault;
|
|
116
|
+
this._env = options.env || process.env;
|
|
117
|
+
this._getStatePath = options.getStatePath || getStatePathDefault;
|
|
118
|
+
this._randomUUID = options.randomUUID || randomUUIDDefault;
|
|
119
|
+
this._now = options.now || (() => Date.now());
|
|
120
|
+
this._platform = options.platform || process.platform;
|
|
121
|
+
this._withFileLock = options.withFileLock || withFileLockDefault;
|
|
122
|
+
this._beforeRename = options.beforeRename || null;
|
|
123
|
+
this._validateTodos = options.validateTodos || null;
|
|
124
|
+
this.stateDir = resolveTodoStateDir({
|
|
125
|
+
stateDir: options.stateDir,
|
|
126
|
+
env: this._env,
|
|
127
|
+
path: this._path,
|
|
128
|
+
getStatePath: this._getStatePath,
|
|
129
|
+
});
|
|
130
|
+
this.identity = this.stateDir;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
snapshotPath(sessionId) {
|
|
134
|
+
return todoSnapshotPath(sessionId, {
|
|
135
|
+
stateDir: this.stateDir,
|
|
136
|
+
path: this._path,
|
|
137
|
+
});
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
_ensureDirectory() {
|
|
141
|
+
this._fs.mkdirSync(this.stateDir, {
|
|
142
|
+
recursive: true,
|
|
143
|
+
mode: 0o700,
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
_temporaryPaths(filePath) {
|
|
148
|
+
const prefix = `.${this._path.basename(filePath)}.`;
|
|
149
|
+
let names;
|
|
150
|
+
try {
|
|
151
|
+
names = this._fs.readdirSync(this.stateDir);
|
|
152
|
+
} catch (error) {
|
|
153
|
+
if (error?.code === "ENOENT") return [];
|
|
154
|
+
throw error;
|
|
155
|
+
}
|
|
156
|
+
return names
|
|
157
|
+
.filter((name) => name.startsWith(prefix) && name.endsWith(".tmp"))
|
|
158
|
+
.sort()
|
|
159
|
+
.map((name) => this._path.join(this.stateDir, name));
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
_validateSnapshot(sessionId, value) {
|
|
163
|
+
const todoValidation =
|
|
164
|
+
value && Array.isArray(value.todos) && this._validateTodos
|
|
165
|
+
? this._validateTodos(value.todos)
|
|
166
|
+
: { valid: Array.isArray(value?.todos) };
|
|
167
|
+
if (
|
|
168
|
+
!value ||
|
|
169
|
+
typeof value !== "object" ||
|
|
170
|
+
Array.isArray(value) ||
|
|
171
|
+
value.schema !== TODO_SNAPSHOT_SCHEMA ||
|
|
172
|
+
value.version !== TODO_SNAPSHOT_VERSION ||
|
|
173
|
+
value.sessionId !== sessionId ||
|
|
174
|
+
!Number.isSafeInteger(value.revision) ||
|
|
175
|
+
value.revision < 0 ||
|
|
176
|
+
!Number.isFinite(value.updatedAt) ||
|
|
177
|
+
!todoValidation.valid
|
|
178
|
+
) {
|
|
179
|
+
throw persistenceError(
|
|
180
|
+
TODO_PERSISTENCE_ERROR_CODES.CORRUPT,
|
|
181
|
+
"TODO snapshot failed schema validation",
|
|
182
|
+
);
|
|
183
|
+
}
|
|
184
|
+
return {
|
|
185
|
+
schema: TODO_SNAPSHOT_SCHEMA,
|
|
186
|
+
version: TODO_SNAPSHOT_VERSION,
|
|
187
|
+
sessionId,
|
|
188
|
+
revision: value.revision,
|
|
189
|
+
updatedAt: value.updatedAt,
|
|
190
|
+
todos: cloneTodos(value.todos),
|
|
191
|
+
};
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
_readUnlocked(sessionId, filePath) {
|
|
195
|
+
const temporaryPaths = this._temporaryPaths(filePath);
|
|
196
|
+
if (temporaryPaths.length > 0) {
|
|
197
|
+
throw persistenceError(
|
|
198
|
+
TODO_PERSISTENCE_ERROR_CODES.RECOVERY_REQUIRED,
|
|
199
|
+
"TODO snapshot has an incomplete atomic write; explicit recovery is required",
|
|
200
|
+
null,
|
|
201
|
+
{
|
|
202
|
+
filePath,
|
|
203
|
+
temporaryPaths,
|
|
204
|
+
recoveryStrategy: "discard-temporary",
|
|
205
|
+
},
|
|
206
|
+
);
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
let serialized;
|
|
210
|
+
try {
|
|
211
|
+
serialized = this._fs.readFileSync(filePath, "utf8");
|
|
212
|
+
} catch (error) {
|
|
213
|
+
if (error?.code === "ENOENT") return emptySnapshot(sessionId);
|
|
214
|
+
throw persistenceError(
|
|
215
|
+
TODO_PERSISTENCE_ERROR_CODES.CORRUPT,
|
|
216
|
+
"Could not read TODO snapshot",
|
|
217
|
+
error,
|
|
218
|
+
{ filePath, recoveryStrategy: "quarantine-corrupt" },
|
|
219
|
+
);
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
try {
|
|
223
|
+
return this._validateSnapshot(sessionId, JSON.parse(serialized));
|
|
224
|
+
} catch (error) {
|
|
225
|
+
if (isKnownPersistenceError(error)) {
|
|
226
|
+
error.filePath = filePath;
|
|
227
|
+
error.recoveryStrategy = "quarantine-corrupt";
|
|
228
|
+
throw error;
|
|
229
|
+
}
|
|
230
|
+
throw persistenceError(
|
|
231
|
+
TODO_PERSISTENCE_ERROR_CODES.CORRUPT,
|
|
232
|
+
"Could not parse TODO snapshot",
|
|
233
|
+
error,
|
|
234
|
+
{ filePath, recoveryStrategy: "quarantine-corrupt" },
|
|
235
|
+
);
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
_locked(sessionId, operation) {
|
|
240
|
+
this._ensureDirectory();
|
|
241
|
+
const filePath = this.snapshotPath(sessionId);
|
|
242
|
+
try {
|
|
243
|
+
return this._withFileLock(filePath, () => operation(filePath), {
|
|
244
|
+
_fs: this._fs,
|
|
245
|
+
failIfUnavailable: true,
|
|
246
|
+
timeoutMs: 5_000,
|
|
247
|
+
retryMs: 2,
|
|
248
|
+
maxRetryMs: 32,
|
|
249
|
+
retryJitterMs: 4,
|
|
250
|
+
});
|
|
251
|
+
} catch (error) {
|
|
252
|
+
if (isKnownPersistenceError(error)) throw error;
|
|
253
|
+
throw persistenceError(
|
|
254
|
+
TODO_PERSISTENCE_ERROR_CODES.LOCK_FAILED,
|
|
255
|
+
"Could not acquire or release the TODO snapshot lock",
|
|
256
|
+
error,
|
|
257
|
+
{ filePath },
|
|
258
|
+
);
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
load(sessionId) {
|
|
263
|
+
assertSafeSessionId(sessionId);
|
|
264
|
+
return this._locked(sessionId, (filePath) =>
|
|
265
|
+
this._readUnlocked(sessionId, filePath),
|
|
266
|
+
);
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
_writeAtomic(filePath, snapshot) {
|
|
270
|
+
const temporaryPath = this._path.join(
|
|
271
|
+
this.stateDir,
|
|
272
|
+
`.${this._path.basename(filePath)}.${process.pid}.${this._randomUUID()}.tmp`,
|
|
273
|
+
);
|
|
274
|
+
let descriptor = null;
|
|
275
|
+
let renamed = false;
|
|
276
|
+
try {
|
|
277
|
+
descriptor = this._fs.openSync(temporaryPath, "wx", 0o600);
|
|
278
|
+
this._fs.writeFileSync(
|
|
279
|
+
descriptor,
|
|
280
|
+
`${JSON.stringify(snapshot, null, 2)}\n`,
|
|
281
|
+
"utf8",
|
|
282
|
+
);
|
|
283
|
+
this._fs.fsyncSync(descriptor);
|
|
284
|
+
this._fs.closeSync(descriptor);
|
|
285
|
+
descriptor = null;
|
|
286
|
+
if (this._beforeRename) this._beforeRename(temporaryPath, filePath);
|
|
287
|
+
// Same-directory rename is the atomic commit point on POSIX and Windows.
|
|
288
|
+
this._fs.renameSync(temporaryPath, filePath);
|
|
289
|
+
renamed = true;
|
|
290
|
+
|
|
291
|
+
// Directory fsync is unsupported on Windows. Elsewhere it is best-effort
|
|
292
|
+
// after the commit point; a failure must not invite an unsafe retry.
|
|
293
|
+
if (this._platform !== "win32") {
|
|
294
|
+
let directoryDescriptor = null;
|
|
295
|
+
try {
|
|
296
|
+
directoryDescriptor = this._fs.openSync(this.stateDir, "r");
|
|
297
|
+
this._fs.fsyncSync(directoryDescriptor);
|
|
298
|
+
} catch {
|
|
299
|
+
// Snapshot content is already atomically committed.
|
|
300
|
+
} finally {
|
|
301
|
+
if (directoryDescriptor != null) {
|
|
302
|
+
try {
|
|
303
|
+
this._fs.closeSync(directoryDescriptor);
|
|
304
|
+
} catch {
|
|
305
|
+
// Best-effort descriptor cleanup after a committed rename.
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
} catch (error) {
|
|
311
|
+
if (descriptor != null) {
|
|
312
|
+
try {
|
|
313
|
+
this._fs.closeSync(descriptor);
|
|
314
|
+
} catch {
|
|
315
|
+
// Preserve the original persistence failure.
|
|
316
|
+
}
|
|
317
|
+
}
|
|
318
|
+
if (!renamed) {
|
|
319
|
+
try {
|
|
320
|
+
this._fs.unlinkSync(temporaryPath);
|
|
321
|
+
} catch {
|
|
322
|
+
// A cleanup failure leaves a visible recovery-required temp file.
|
|
323
|
+
}
|
|
324
|
+
}
|
|
325
|
+
throw persistenceError(
|
|
326
|
+
TODO_PERSISTENCE_ERROR_CODES.WRITE_FAILED,
|
|
327
|
+
"Could not atomically persist TODO snapshot",
|
|
328
|
+
error,
|
|
329
|
+
{ filePath, temporaryPath },
|
|
330
|
+
);
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
|
|
334
|
+
compareAndSwap(sessionId, expectedRevision, todos) {
|
|
335
|
+
assertSafeSessionId(sessionId);
|
|
336
|
+
if (!Number.isSafeInteger(expectedRevision) || expectedRevision < 0) {
|
|
337
|
+
throw persistenceError(
|
|
338
|
+
TODO_PERSISTENCE_ERROR_CODES.REVISION_CONFLICT,
|
|
339
|
+
"TODO write requires a non-negative expected revision",
|
|
340
|
+
null,
|
|
341
|
+
{ expectedRevision },
|
|
342
|
+
);
|
|
343
|
+
}
|
|
344
|
+
const validation = this._validateTodos
|
|
345
|
+
? this._validateTodos(todos)
|
|
346
|
+
: { valid: Array.isArray(todos) };
|
|
347
|
+
if (!validation.valid) {
|
|
348
|
+
throw persistenceError(
|
|
349
|
+
TODO_PERSISTENCE_ERROR_CODES.CORRUPT,
|
|
350
|
+
"Refused to persist an invalid TODO list",
|
|
351
|
+
);
|
|
352
|
+
}
|
|
353
|
+
const nextTodos = cloneTodos(todos);
|
|
354
|
+
return this._locked(sessionId, (filePath) => {
|
|
355
|
+
const current = this._readUnlocked(sessionId, filePath);
|
|
356
|
+
if (current.revision !== expectedRevision) {
|
|
357
|
+
throw persistenceError(
|
|
358
|
+
TODO_PERSISTENCE_ERROR_CODES.REVISION_CONFLICT,
|
|
359
|
+
"TODO snapshot revision conflict",
|
|
360
|
+
null,
|
|
361
|
+
{
|
|
362
|
+
filePath,
|
|
363
|
+
expectedRevision,
|
|
364
|
+
actualRevision: current.revision,
|
|
365
|
+
},
|
|
366
|
+
);
|
|
367
|
+
}
|
|
368
|
+
const next = {
|
|
369
|
+
schema: TODO_SNAPSHOT_SCHEMA,
|
|
370
|
+
version: TODO_SNAPSHOT_VERSION,
|
|
371
|
+
sessionId,
|
|
372
|
+
revision: current.revision + 1,
|
|
373
|
+
updatedAt: this._now(),
|
|
374
|
+
todos: nextTodos,
|
|
375
|
+
};
|
|
376
|
+
this._writeAtomic(filePath, next);
|
|
377
|
+
return this._validateSnapshot(sessionId, next);
|
|
378
|
+
});
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
recover(sessionId, strategy) {
|
|
382
|
+
assertSafeSessionId(sessionId);
|
|
383
|
+
return this._locked(sessionId, (filePath) => {
|
|
384
|
+
if (strategy === "discard-temporary") {
|
|
385
|
+
const temporaryPaths = this._temporaryPaths(filePath);
|
|
386
|
+
for (const temporaryPath of temporaryPaths) {
|
|
387
|
+
this._fs.unlinkSync(temporaryPath);
|
|
388
|
+
}
|
|
389
|
+
return { strategy, recovered: temporaryPaths.length, filePath };
|
|
390
|
+
}
|
|
391
|
+
if (strategy === "quarantine-corrupt") {
|
|
392
|
+
try {
|
|
393
|
+
this._readUnlocked(sessionId, filePath);
|
|
394
|
+
} catch (error) {
|
|
395
|
+
if (error?.code !== TODO_PERSISTENCE_ERROR_CODES.CORRUPT) throw error;
|
|
396
|
+
const quarantinePath = `${filePath}.corrupt.${this._now()}.${this._randomUUID()}`;
|
|
397
|
+
try {
|
|
398
|
+
this._fs.renameSync(filePath, quarantinePath);
|
|
399
|
+
} catch (cause) {
|
|
400
|
+
throw persistenceError(
|
|
401
|
+
TODO_PERSISTENCE_ERROR_CODES.RECOVERY_FAILED,
|
|
402
|
+
"Could not quarantine corrupt TODO snapshot",
|
|
403
|
+
cause,
|
|
404
|
+
{ filePath, quarantinePath },
|
|
405
|
+
);
|
|
406
|
+
}
|
|
407
|
+
return { strategy, recovered: 1, filePath, quarantinePath };
|
|
408
|
+
}
|
|
409
|
+
return { strategy, recovered: 0, filePath };
|
|
410
|
+
}
|
|
411
|
+
throw persistenceError(
|
|
412
|
+
TODO_PERSISTENCE_ERROR_CODES.RECOVERY_FAILED,
|
|
413
|
+
"Unknown TODO snapshot recovery strategy",
|
|
414
|
+
);
|
|
415
|
+
});
|
|
416
|
+
}
|
|
417
|
+
}
|