attention-manifest-protocol 0.4.2 → 0.4.3
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/CHANGELOG.md +341 -293
- package/CHANGELOG.zh-CN.md +41 -8
- package/README.md +250 -171
- package/README.zh-CN.md +251 -171
- package/lib/assignment/assign.d.ts +102 -0
- package/lib/assignment/assign.js +556 -0
- package/lib/assignment/binding.d.ts +103 -0
- package/lib/assignment/binding.js +575 -0
- package/lib/assignment/errors.d.ts +14 -0
- package/lib/assignment/errors.js +16 -0
- package/lib/assignment/guards.d.ts +18 -0
- package/lib/assignment/guards.js +28 -0
- package/lib/assignment/index.d.ts +10 -0
- package/lib/assignment/index.js +10 -0
- package/lib/assignment/types.d.ts +169 -0
- package/lib/assignment/types.js +1 -0
- package/lib/attention/budget.d.ts +1 -1
- package/lib/attention/budget.js +31 -9
- package/lib/bayes/engine.js +2 -1
- package/lib/bayes/reliability.js +25 -10
- package/lib/boundary/frame.d.ts +10 -4
- package/lib/boundary/frame.js +346 -109
- package/lib/boundary/kinds.d.ts +11 -0
- package/lib/boundary/kinds.js +33 -0
- package/lib/boundary/refTable.d.ts +19 -9
- package/lib/boundary/refTable.js +128 -30
- package/lib/boundary/toolCall.d.ts +22 -10
- package/lib/boundary/toolCall.js +798 -97
- package/lib/concept/conceptBudget.js +10 -1
- package/lib/concurrency/idempotency.d.ts +4 -3
- package/lib/concurrency/idempotency.js +57 -13
- package/lib/concurrency/retry.js +18 -3
- package/lib/context/agentContext.d.ts +13 -0
- package/lib/context/agentContext.js +14 -1
- package/lib/context/ast.d.ts +4 -1
- package/lib/context/ast.js +13 -3
- package/lib/context/contentStore.js +22 -9
- package/lib/context/contextBuilder.d.ts +457 -0
- package/lib/context/contextBuilder.js +1395 -0
- package/lib/context/contextPackage.d.ts +214 -0
- package/lib/context/contextPackage.js +191 -0
- package/lib/context/index.d.ts +14 -3
- package/lib/context/index.js +9 -1
- package/lib/context/relevance.d.ts +171 -0
- package/lib/context/relevance.js +250 -0
- package/lib/context/workspaceDiff.d.ts +105 -0
- package/lib/context/workspaceDiff.js +238 -0
- package/lib/context/workspaceService.d.ts +236 -1
- package/lib/context/workspaceService.js +1501 -73
- package/lib/cooperation/collaboration.d.ts +9 -0
- package/lib/cooperation/session.d.ts +4 -4
- package/lib/cooperation/session.js +3 -3
- package/lib/database/adapter/filesystemStore.d.ts +145 -0
- package/lib/database/adapter/filesystemStore.js +321 -0
- package/lib/database/adapter/index.d.ts +2 -0
- package/lib/database/adapter/index.js +2 -0
- package/lib/database/adapter/workspaceSessionStore.d.ts +118 -0
- package/lib/database/adapter/workspaceSessionStore.js +120 -0
- package/lib/database/entity/fileGraph.d.ts +53 -0
- package/lib/database/entity/fileGraph.js +15 -0
- package/lib/database/entity/fileTree.d.ts +76 -0
- package/lib/database/entity/fileTree.js +39 -0
- package/lib/database/entity/hook.d.ts +29 -0
- package/lib/database/entity/hook.js +18 -0
- package/lib/database/entity/index.d.ts +4 -0
- package/lib/database/entity/index.js +4 -0
- package/lib/database/entity/workspaceSession.d.ts +53 -0
- package/lib/database/entity/workspaceSession.js +28 -0
- package/lib/database/repository/fileAnnotationRepository.d.ts +75 -0
- package/lib/database/repository/fileAnnotationRepository.js +109 -0
- package/lib/database/repository/fileGraphRepository.d.ts +188 -0
- package/lib/database/repository/fileGraphRepository.js +648 -0
- package/lib/database/repository/fileNodeRepository.d.ts +116 -0
- package/lib/database/repository/fileNodeRepository.js +263 -0
- package/lib/database/repository/fileOutlineRepository.d.ts +40 -0
- package/lib/database/repository/fileOutlineRepository.js +104 -0
- package/lib/database/repository/fileWriteRepository.d.ts +41 -0
- package/lib/database/repository/fileWriteRepository.js +93 -0
- package/lib/database/repository/hookRepository.d.ts +67 -0
- package/lib/database/repository/hookRepository.js +150 -0
- package/lib/database/repository/index.d.ts +7 -0
- package/lib/database/repository/index.js +7 -0
- package/lib/database/repository/workspaceSessionRepository.d.ts +134 -0
- package/lib/database/repository/workspaceSessionRepository.js +327 -0
- package/lib/database/service/database.d.ts +14 -0
- package/lib/database/service/database.js +21 -0
- package/lib/database/sql/schema.js +187 -0
- package/lib/database/store/database.js +6 -1
- package/lib/delegate/team.d.ts +5 -0
- package/lib/delegate/team.js +83 -20
- package/lib/discover/classify.d.ts +20 -0
- package/lib/discover/classify.js +85 -0
- package/lib/discover/host.d.ts +20 -0
- package/lib/discover/host.js +89 -0
- package/lib/discover/index.d.ts +11 -0
- package/lib/discover/index.js +11 -0
- package/lib/discover/kinds.d.ts +14 -0
- package/lib/discover/kinds.js +23 -0
- package/lib/discover/tree.d.ts +7 -0
- package/lib/discover/tree.js +432 -0
- package/lib/discover/types.d.ts +115 -0
- package/lib/discover/types.js +1 -0
- package/lib/error/boundaryRejection.d.ts +1 -1
- package/lib/evaluation/agreement.js +2 -2
- package/lib/execution/handles.js +6 -0
- package/lib/execution/pin.js +2 -2
- package/lib/file/cfb.d.ts +56 -0
- package/lib/file/cfb.js +396 -0
- package/lib/file/dependency.d.ts +151 -0
- package/lib/file/dependency.js +568 -0
- package/lib/file/directory.d.ts +34 -0
- package/lib/file/directory.js +141 -0
- package/lib/file/errors.d.ts +20 -0
- package/lib/file/errors.js +18 -0
- package/lib/file/exportGraph.d.ts +31 -0
- package/lib/file/exportGraph.js +554 -0
- package/lib/file/file.d.ts +40 -0
- package/lib/file/file.js +339 -0
- package/lib/file/importGraph.d.ts +121 -0
- package/lib/file/importGraph.js +1022 -0
- package/lib/file/index.d.ts +45 -0
- package/lib/file/index.js +30 -0
- package/lib/file/metadata.d.ts +66 -0
- package/lib/file/metadata.js +470 -0
- package/lib/file/path.d.ts +60 -0
- package/lib/file/path.js +259 -0
- package/lib/file/read.d.ts +168 -0
- package/lib/file/read.js +541 -0
- package/lib/file/runtime.d.ts +95 -0
- package/lib/file/runtime.js +150 -0
- package/lib/file/service.d.ts +227 -0
- package/lib/file/service.js +663 -0
- package/lib/file/syntaxTree.d.ts +7 -0
- package/lib/file/syntaxTree.js +38 -0
- package/lib/file/time.d.ts +38 -0
- package/lib/file/time.js +44 -0
- package/lib/file/tree.d.ts +53 -0
- package/lib/file/tree.js +417 -0
- package/lib/file/types.d.ts +371 -0
- package/lib/file/types.js +1 -0
- package/lib/file/write.d.ts +159 -0
- package/lib/file/write.js +1028 -0
- package/lib/file/zip.d.ts +35 -0
- package/lib/file/zip.js +349 -0
- package/lib/fingerprint/algorithm.d.ts +97 -0
- package/lib/fingerprint/algorithm.js +271 -0
- package/lib/fingerprint/bytes.d.ts +18 -0
- package/lib/fingerprint/bytes.js +31 -0
- package/lib/fingerprint/error.d.ts +73 -0
- package/lib/fingerprint/error.js +86 -0
- package/lib/fingerprint/file.d.ts +71 -0
- package/lib/fingerprint/file.js +254 -0
- package/lib/fingerprint/index.d.ts +37 -0
- package/lib/fingerprint/index.js +12 -0
- package/lib/fingerprint/json.d.ts +41 -0
- package/lib/fingerprint/json.js +94 -0
- package/lib/fingerprint/number.d.ts +32 -0
- package/lib/fingerprint/number.js +95 -0
- package/lib/fingerprint/policy.d.ts +54 -0
- package/lib/fingerprint/policy.js +50 -0
- package/lib/fingerprint/preimage.d.ts +84 -0
- package/lib/fingerprint/preimage.js +133 -0
- package/lib/fingerprint/raw.d.ts +26 -0
- package/lib/fingerprint/raw.js +45 -0
- package/lib/fingerprint/ref.d.ts +39 -0
- package/lib/fingerprint/ref.js +178 -0
- package/lib/fingerprint/text.d.ts +42 -0
- package/lib/fingerprint/text.js +155 -0
- package/lib/fingerprint/tree.d.ts +56 -0
- package/lib/fingerprint/tree.js +288 -0
- package/lib/fingerprint/verify.d.ts +20 -0
- package/lib/fingerprint/verify.js +99 -0
- package/lib/global/filesystem.d.ts +43 -0
- package/lib/global/filesystem.js +75 -0
- package/lib/global/index.d.ts +8 -0
- package/lib/global/index.js +8 -0
- package/lib/global/service.d.ts +51 -0
- package/lib/global/service.js +98 -0
- package/lib/governance/transport.js +18 -6
- package/lib/hook/ast.d.ts +29 -0
- package/lib/hook/ast.js +22 -0
- package/lib/hook/code.d.ts +55 -0
- package/lib/hook/code.js +47 -0
- package/lib/hook/dependency.d.ts +45 -0
- package/lib/hook/dependency.js +28 -0
- package/lib/hook/diff.d.ts +114 -0
- package/lib/hook/diff.js +327 -0
- package/lib/hook/exportation.d.ts +31 -0
- package/lib/hook/exportation.js +24 -0
- package/lib/hook/file.d.ts +44 -0
- package/lib/hook/file.js +154 -0
- package/lib/hook/importation.d.ts +33 -0
- package/lib/hook/importation.js +22 -0
- package/lib/hook/index.d.ts +30 -0
- package/lib/hook/index.js +23 -0
- package/lib/hook/outline.d.ts +35 -0
- package/lib/hook/outline.js +27 -0
- package/lib/hook/project.d.ts +65 -0
- package/lib/hook/project.js +217 -0
- package/lib/hook/types.d.ts +114 -0
- package/lib/hook/types.js +407 -0
- package/lib/index.d.ts +9 -0
- package/lib/index.js +9 -0
- package/lib/lock/lease.js +28 -3
- package/lib/manifest/cardSign.d.ts +1 -1
- package/lib/manifest/cardSign.js +37 -7
- package/lib/manifest/federation.js +13 -6
- package/lib/manifest/trust.d.ts +2 -0
- package/lib/manifest/trust.js +27 -6
- package/lib/module/index.d.ts +4 -0
- package/lib/module/index.js +4 -0
- package/lib/module/mcp/client.js +21 -2
- package/lib/module/mcp/filesystemServer.d.ts +24 -0
- package/lib/module/mcp/filesystemServer.js +102 -0
- package/lib/module/mcp/http.js +32 -19
- package/lib/module/mcp/workspaceServer.js +20 -3
- package/lib/module/tool/filesystemExecutor.d.ts +18 -0
- package/lib/module/tool/filesystemExecutor.js +49 -0
- package/lib/module/tool/globalExecutor.d.ts +17 -0
- package/lib/module/tool/globalExecutor.js +39 -0
- package/lib/module/tool/globalFilesystemExecutor.d.ts +18 -0
- package/lib/module/tool/globalFilesystemExecutor.js +49 -0
- package/lib/module/tool/workspaceExecutor.d.ts +9 -0
- package/lib/module/tool/workspaceExecutor.js +16 -3
- package/lib/naming/aliases.d.ts +48 -0
- package/lib/naming/aliases.js +79 -0
- package/lib/naming/catalog.d.ts +117 -0
- package/lib/naming/catalog.js +108 -0
- package/lib/naming/grammar.d.ts +67 -0
- package/lib/naming/grammar.js +212 -0
- package/lib/naming/ids.d.ts +157 -0
- package/lib/naming/ids.js +119 -0
- package/lib/naming/index.d.ts +13 -0
- package/lib/naming/index.js +13 -0
- package/lib/outline/index.d.ts +9 -0
- package/lib/outline/index.js +8 -0
- package/lib/outline/office.d.ts +160 -0
- package/lib/outline/office.js +2375 -0
- package/lib/outline/officeBridge.d.ts +32 -0
- package/lib/outline/officeBridge.js +27 -0
- package/lib/outline/outline.d.ts +159 -0
- package/lib/outline/outline.js +837 -0
- package/lib/outline/outlineIndex.d.ts +97 -0
- package/lib/outline/outlineIndex.js +325 -0
- package/lib/outline/outlineKeywords.d.ts +59 -0
- package/lib/outline/outlineKeywords.js +143 -0
- package/lib/outline/outlineStrategies.d.ts +414 -0
- package/lib/outline/outlineStrategies.js +8324 -0
- package/lib/outline/reactOutline.d.ts +37 -0
- package/lib/outline/reactOutline.js +1070 -0
- package/lib/outline/shellOutline.d.ts +65 -0
- package/lib/outline/shellOutline.js +873 -0
- package/lib/outline/sqlOutline.d.ts +170 -0
- package/lib/outline/sqlOutline.js +1536 -0
- package/lib/outline/strategy.d.ts +46 -0
- package/lib/outline/strategy.js +1 -0
- package/lib/outline/types.d.ts +95 -0
- package/lib/outline/types.js +1 -0
- package/lib/outline/visualBasicOutline.d.ts +27 -0
- package/lib/outline/visualBasicOutline.js +750 -0
- package/lib/protocol/filesystem.d.ts +55 -0
- package/lib/protocol/filesystem.js +105 -0
- package/lib/protocol/global.d.ts +42 -0
- package/lib/protocol/global.js +63 -0
- package/lib/protocol/globalFilesystem.d.ts +40 -0
- package/lib/protocol/globalFilesystem.js +59 -0
- package/lib/protocol/index.d.ts +4 -0
- package/lib/protocol/index.js +4 -0
- package/lib/protocol/protocol.d.ts +4 -0
- package/lib/protocol/wire.js +5 -2
- package/lib/protocol/workspace.d.ts +305 -0
- package/lib/protocol/workspace.js +258 -0
- package/lib/receipt/receipt.d.ts +8 -0
- package/lib/registry/content.js +9 -3
- package/lib/runtime/kernelRuntime.js +9 -1
- package/lib/scenario/scenario.js +5 -4
- package/lib/semantic/canonical.d.ts +61 -0
- package/lib/semantic/canonical.js +135 -8
- package/lib/semantic/jsonValue.d.ts +31 -0
- package/lib/semantic/jsonValue.js +122 -0
- package/lib/semantic/sha256.js +3 -0
- package/lib/semantic/time.d.ts +14 -0
- package/lib/semantic/time.js +56 -0
- package/lib/session/context.d.ts +76 -0
- package/lib/session/context.js +419 -0
- package/lib/session/errors.d.ts +24 -0
- package/lib/session/errors.js +22 -0
- package/lib/session/identity.d.ts +24 -0
- package/lib/session/identity.js +56 -0
- package/lib/session/index.d.ts +14 -0
- package/lib/session/index.js +12 -0
- package/lib/session/registry.d.ts +130 -0
- package/lib/session/registry.js +908 -0
- package/lib/session/types.d.ts +227 -0
- package/lib/session/types.js +14 -0
- package/lib/structure/index.d.ts +1 -0
- package/lib/structure/index.js +1 -0
- package/lib/structure/trie.d.ts +88 -0
- package/lib/structure/trie.js +183 -0
- package/lib/syntax/byteIndex.d.ts +44 -0
- package/lib/syntax/byteIndex.js +148 -0
- package/lib/syntax/charset.d.ts +88 -0
- package/lib/syntax/charset.js +276 -0
- package/lib/syntax/index.d.ts +6 -0
- package/lib/syntax/index.js +5 -0
- package/lib/syntax/syntaxRegistry.d.ts +150 -0
- package/lib/syntax/syntaxRegistry.js +314 -0
- package/lib/syntax/syntaxTree.d.ts +106 -0
- package/lib/syntax/syntaxTree.js +668 -0
- package/lib/syntax/types.d.ts +15 -0
- package/lib/syntax/types.js +1 -0
- package/lib/types/common.d.ts +1 -1
- package/package.json +72 -193
- package/.editorconfig +0 -12
- package/.prettierignore +0 -17
- package/MCP-Token/347/250/216/344/270/216/344/270/213/344/270/200/344/273/243/345/267/245/345/205/267/345/215/217/350/256/256.html +0 -1763
- package/docs/annotation-campaign-A.csv +0 -54
- package/docs/annotation-campaign-B.csv +0 -54
- package/docs/annotation-campaign.csv +0 -54
- package/docs/eval/annotations-A.jsonl +0 -16
- package/docs/eval/annotations.json +0 -122
- package/docs/eval/recorded-labels.json +0 -12
- package/docs/eval/replay-cases.json +0 -14
- package/docs/eval/replay-labels-b.json +0 -14
- package/docs/examples/attention-request.json +0 -16
- package/docs/examples/checkpoint.json +0 -15
- package/docs/examples/claim.json +0 -66
- package/docs/examples/collaboration.json +0 -66
- package/docs/examples/concept-checkpoint.json +0 -15
- package/docs/examples/concept-prune-plan.json +0 -45
- package/docs/examples/federation.json +0 -126
- package/docs/examples/frame-chain.json +0 -77
- package/docs/examples/ledger-snapshot.json +0 -108
- package/docs/examples/manifest.json +0 -77
- package/docs/examples/message.json +0 -19
- package/docs/examples/other-model.json +0 -45
- package/docs/examples/plan.json +0 -50
- package/docs/examples/prune-plan.json +0 -48
- package/docs/examples/receipt.json +0 -22
- package/docs/examples/runtime-run.json +0 -573
- package/docs/examples/team.json +0 -66
- package/docs/examples/verb-note.json +0 -11
- package/docs/probes/bayes-scores.json +0 -1452
- package/docs/probes/calibration-imported.json +0 -141
- package/docs/probes/context-ast-deepseek.json +0 -1577
- package/docs/probes/deepseek-probe.json +0 -917
- package/docs/probes/eval-recorded-replay.json +0 -597
- package/docs/probes/eval-replay.json +0 -124
- package/docs/probes/eval-summary.json +0 -42
- package/docs/probes/runtime-eval.json +0 -4230
- package/docs/schemas/collaboration.schema.json +0 -73
- package/docs/schemas/common.schema.json +0 -125
- package/docs/schemas/compaction.schema.json +0 -121
- package/docs/schemas/concept-compaction.schema.json +0 -73
- package/docs/schemas/concept.schema.json +0 -97
- package/docs/schemas/epistemic.schema.json +0 -178
- package/docs/schemas/federation.schema.json +0 -66
- package/docs/schemas/frame.schema.json +0 -86
- package/docs/schemas/ledger-snapshot.schema.json +0 -30
- package/docs/schemas/manifest.schema.json +0 -169
- package/docs/schemas/message.schema.json +0 -41
- package/docs/schemas/plan.schema.json +0 -189
- package/docs/schemas/receipt.schema.json +0 -45
- package/docs/schemas/social.schema.json +0 -153
- package/docs/schemas/team.schema.json +0 -56
- package/docs/schemas/verb.schema.json +0 -120
- package/eslint.config.mts +0 -96
- package/index.html +0 -13
- package/lib/context/workspaceProtocol.d.ts +0 -30
- package/lib/context/workspaceProtocol.js +0 -49
- package/prettier.config.mts +0 -37
- package/public/favicon.svg +0 -1
- package/public/icons.svg +0 -24
- package/src/attention/attention.ts +0 -347
- package/src/attention/budget.ts +0 -72
- package/src/attention/cognition.ts +0 -519
- package/src/attention/index.ts +0 -8
- package/src/attention/interrupts.ts +0 -228
- package/src/attention/resource.ts +0 -316
- package/src/attention/social.ts +0 -217
- package/src/attention/socialTypes.ts +0 -115
- package/src/authz/authz.ts +0 -305
- package/src/authz/index.ts +0 -1
- package/src/bayes/calibration.ts +0 -204
- package/src/bayes/calibrationRegistry.ts +0 -111
- package/src/bayes/calibrationSelection.ts +0 -154
- package/src/bayes/engine.ts +0 -532
- package/src/bayes/index.ts +0 -6
- package/src/bayes/reliability.ts +0 -62
- package/src/bayes/scopedPriors.ts +0 -88
- package/src/boundary/frame.ts +0 -322
- package/src/boundary/ids.ts +0 -14
- package/src/boundary/index.ts +0 -12
- package/src/boundary/refTable.ts +0 -125
- package/src/boundary/toolCall.ts +0 -212
- package/src/concept/concept.ts +0 -75
- package/src/concept/conceptBudget.ts +0 -346
- package/src/concept/conceptBudgetTypes.ts +0 -79
- package/src/concept/index.ts +0 -3
- package/src/concurrency/idempotency.ts +0 -41
- package/src/concurrency/index.ts +0 -5
- package/src/concurrency/mutex.ts +0 -26
- package/src/concurrency/namedLocks.ts +0 -35
- package/src/concurrency/retry.ts +0 -50
- package/src/concurrency/worker.ts +0 -128
- package/src/context/agentContext.ts +0 -308
- package/src/context/ast.ts +0 -499
- package/src/context/contentStore.ts +0 -75
- package/src/context/context.ts +0 -65
- package/src/context/contextIndex.ts +0 -85
- package/src/context/document.ts +0 -137
- package/src/context/fileStorePath.ts +0 -14
- package/src/context/index.ts +0 -43
- package/src/context/lifecycle.ts +0 -221
- package/src/context/projections.ts +0 -151
- package/src/context/workspace.ts +0 -422
- package/src/context/workspaceProtocol.ts +0 -112
- package/src/context/workspaceService.ts +0 -423
- package/src/cooperation/board.ts +0 -104
- package/src/cooperation/collaboration.ts +0 -60
- package/src/cooperation/index.ts +0 -6
- package/src/cooperation/merge.ts +0 -190
- package/src/cooperation/metrics.ts +0 -57
- package/src/cooperation/session.ts +0 -131
- package/src/cooperation/unified.ts +0 -56
- package/src/counter.ts +0 -9
- package/src/database/adapter/adapters.ts +0 -35
- package/src/database/adapter/index.ts +0 -4
- package/src/database/adapter/runtimeSink.ts +0 -74
- package/src/database/adapter/sessionStore.ts +0 -32
- package/src/database/adapter/turnStore.ts +0 -23
- package/src/database/entity/agent.ts +0 -199
- package/src/database/entity/entity.ts +0 -1046
- package/src/database/entity/handle.ts +0 -79
- package/src/database/entity/index.ts +0 -32
- package/src/database/entity/message.ts +0 -74
- package/src/database/entity/meta.ts +0 -11
- package/src/database/entity/object.ts +0 -42
- package/src/database/entity/outbox.ts +0 -15
- package/src/database/entity/process.ts +0 -65
- package/src/database/entity/registry.ts +0 -155
- package/src/database/entity/runtimeApproval.ts +0 -30
- package/src/database/entity/runtimeSession.ts +0 -13
- package/src/database/entity/runtimeTurn.ts +0 -15
- package/src/database/entity/thread.ts +0 -85
- package/src/database/entity/window.ts +0 -85
- package/src/database/entity/worker.ts +0 -90
- package/src/database/index.ts +0 -6
- package/src/database/repository/addressSpaceRepository.ts +0 -72
- package/src/database/repository/agentRepository.ts +0 -460
- package/src/database/repository/base.ts +0 -41
- package/src/database/repository/executionRepository.ts +0 -477
- package/src/database/repository/handleRepository.ts +0 -64
- package/src/database/repository/index.ts +0 -20
- package/src/database/repository/messageRepository.ts +0 -52
- package/src/database/repository/objectRepository.ts +0 -69
- package/src/database/repository/outboxRepository.ts +0 -63
- package/src/database/repository/processRepository.ts +0 -58
- package/src/database/repository/registryRepository.ts +0 -119
- package/src/database/repository/repository.ts +0 -491
- package/src/database/repository/runtimeApprovalRepository.ts +0 -44
- package/src/database/repository/runtimeSessionRepository.ts +0 -27
- package/src/database/repository/runtimeTurnRepository.ts +0 -39
- package/src/database/repository/socialRepository.ts +0 -185
- package/src/database/repository/threadRepository.ts +0 -57
- package/src/database/repository/windowRepository.ts +0 -88
- package/src/database/repository/workerRepository.ts +0 -69
- package/src/database/service/database.ts +0 -90
- package/src/database/service/handleService.ts +0 -48
- package/src/database/service/index.ts +0 -16
- package/src/database/service/messageService.ts +0 -61
- package/src/database/service/objectService.ts +0 -59
- package/src/database/service/processService.ts +0 -61
- package/src/database/service/registryServices.ts +0 -88
- package/src/database/service/service.ts +0 -183
- package/src/database/service/stepService.ts +0 -53
- package/src/database/service/threadService.ts +0 -65
- package/src/database/service/windowService.ts +0 -30
- package/src/database/service/workerService.ts +0 -57
- package/src/database/sql/index.ts +0 -3
- package/src/database/sql/schema.ts +0 -418
- package/src/database/sql/sql.ts +0 -543
- package/src/database/store/database.ts +0 -210
- package/src/database/store/index.ts +0 -3
- package/src/database/store/store.ts +0 -266
- package/src/delegate/index.ts +0 -2
- package/src/delegate/team.ts +0 -268
- package/src/delegate/teamTypes.ts +0 -47
- package/src/diagnosis/checklist.ts +0 -74
- package/src/diagnosis/context.ts +0 -93
- package/src/diagnosis/frame.ts +0 -256
- package/src/diagnosis/index.ts +0 -5
- package/src/diagnosis/router.ts +0 -72
- package/src/diagnosis/types.ts +0 -89
- package/src/error/agentError.ts +0 -16
- package/src/error/ampError.ts +0 -20
- package/src/error/authzError.ts +0 -14
- package/src/error/boundaryRejection.ts +0 -20
- package/src/error/index.ts +0 -7
- package/src/error/kernelError.ts +0 -27
- package/src/error/mailboxError.ts +0 -9
- package/src/error/windowError.ts +0 -12
- package/src/evaluation/agreement.ts +0 -96
- package/src/evaluation/index.ts +0 -2
- package/src/evaluation/labels.ts +0 -241
- package/src/evidence/evidenceGraph.ts +0 -205
- package/src/evidence/index.ts +0 -4
- package/src/evidence/revalidation.ts +0 -191
- package/src/execution/exec.ts +0 -408
- package/src/execution/handles.ts +0 -65
- package/src/execution/index.ts +0 -3
- package/src/execution/pin.ts +0 -154
- package/src/frame/frame.ts +0 -70
- package/src/frame/index.ts +0 -1
- package/src/goal/goal.ts +0 -43
- package/src/goal/index.ts +0 -2
- package/src/goal/plan.ts +0 -196
- package/src/governance/attentionManifest.ts +0 -802
- package/src/governance/audit.ts +0 -362
- package/src/governance/budget.ts +0 -628
- package/src/governance/context.ts +0 -356
- package/src/governance/control.ts +0 -159
- package/src/governance/cooperation.ts +0 -479
- package/src/governance/credential.ts +0 -359
- package/src/governance/httpServer.ts +0 -99
- package/src/governance/index.ts +0 -32
- package/src/governance/legal.ts +0 -574
- package/src/governance/matrix.ts +0 -460
- package/src/governance/perspectives.ts +0 -406
- package/src/governance/signing.ts +0 -407
- package/src/governance/store.ts +0 -125
- package/src/governance/switching.ts +0 -459
- package/src/governance/toolPolicy.ts +0 -80
- package/src/governance/transport.ts +0 -204
- package/src/governance/types.ts +0 -380
- package/src/governance/workflow.ts +0 -743
- package/src/index.ts +0 -11
- package/src/interaction/index.ts +0 -1
- package/src/interaction/interaction.ts +0 -391
- package/src/ipc/index.ts +0 -4
- package/src/ipc/mailbox.ts +0 -132
- package/src/ipc/memorySocialStore.ts +0 -93
- package/src/ipc/social.ts +0 -93
- package/src/kernel/index.ts +0 -14
- package/src/kernel/scheduler.ts +0 -498
- package/src/ledger/checkpoint.ts +0 -304
- package/src/ledger/index.ts +0 -4
- package/src/ledger/ledger.ts +0 -31
- package/src/ledger/persistence.ts +0 -159
- package/src/ledger/share.ts +0 -80
- package/src/lock/index.ts +0 -2
- package/src/lock/lease.ts +0 -74
- package/src/main.ts +0 -199
- package/src/manifest/agentCard.ts +0 -72
- package/src/manifest/cardSign.ts +0 -87
- package/src/manifest/federation.ts +0 -237
- package/src/manifest/federationTypes.ts +0 -55
- package/src/manifest/index.ts +0 -8
- package/src/manifest/keys.ts +0 -643
- package/src/manifest/manifest.ts +0 -114
- package/src/manifest/sign.ts +0 -134
- package/src/manifest/trust.ts +0 -146
- package/src/mission/index.ts +0 -2
- package/src/mission/missionQueue.ts +0 -75
- package/src/module/index.ts +0 -9
- package/src/module/llm/deepseek.ts +0 -214
- package/src/module/llm/llm.ts +0 -84
- package/src/module/mcp/client.ts +0 -110
- package/src/module/mcp/http.ts +0 -102
- package/src/module/mcp/protocol.ts +0 -77
- package/src/module/mcp/server.ts +0 -148
- package/src/module/mcp/transport.ts +0 -30
- package/src/module/mcp/workspaceServer.ts +0 -111
- package/src/module/sandbox/sandbox.ts +0 -29
- package/src/module/tool/mcpExecutor.ts +0 -54
- package/src/module/tool/policy.ts +0 -52
- package/src/module/tool/redact.ts +0 -29
- package/src/module/tool/tool.ts +0 -53
- package/src/module/tool/workspaceExecutor.ts +0 -35
- package/src/policy/guard.ts +0 -240
- package/src/policy/index.ts +0 -2
- package/src/policy/policy.ts +0 -561
- package/src/process/agent.ts +0 -341
- package/src/process/agentService.ts +0 -236
- package/src/process/agentStore.ts +0 -378
- package/src/process/executionStore.ts +0 -151
- package/src/process/index.ts +0 -5
- package/src/process/process.ts +0 -240
- package/src/process/transitions.ts +0 -19
- package/src/progress/index.ts +0 -2
- package/src/progress/progress.ts +0 -85
- package/src/protocol/a2a.ts +0 -120
- package/src/protocol/channel.ts +0 -44
- package/src/protocol/envelope.ts +0 -655
- package/src/protocol/httpChannel.ts +0 -87
- package/src/protocol/index.ts +0 -6
- package/src/protocol/protocol.ts +0 -138
- package/src/protocol/wire.ts +0 -60
- package/src/receipt/index.ts +0 -1
- package/src/receipt/receipt.ts +0 -47
- package/src/registry/content.ts +0 -69
- package/src/registry/index.ts +0 -23
- package/src/registry/registry.ts +0 -599
- package/src/runtime/action.ts +0 -87
- package/src/runtime/behavior.ts +0 -330
- package/src/runtime/behaviorTuning.ts +0 -163
- package/src/runtime/cognitiveRuntime.ts +0 -703
- package/src/runtime/escalation.ts +0 -35
- package/src/runtime/governedTask.ts +0 -233
- package/src/runtime/index.ts +0 -15
- package/src/runtime/kernelRuntime.ts +0 -144
- package/src/runtime/operation.ts +0 -35
- package/src/runtime/replay.ts +0 -71
- package/src/runtime/routing.ts +0 -58
- package/src/runtime/safety.ts +0 -48
- package/src/runtime/session.ts +0 -341
- package/src/runtime/sessionStore.ts +0 -43
- package/src/runtime/telemetry.ts +0 -55
- package/src/runtime/turnStore.ts +0 -30
- package/src/scenario/index.ts +0 -1
- package/src/scenario/scenario.ts +0 -299
- package/src/semantic/canonical.ts +0 -24
- package/src/semantic/index.ts +0 -2
- package/src/semantic/sha256.ts +0 -82
- package/src/storage/appendLog.ts +0 -372
- package/src/storage/fileAppendSink.ts +0 -40
- package/src/storage/index.ts +0 -2
- package/src/store/bindCache.ts +0 -22
- package/src/store/cache.ts +0 -191
- package/src/store/context.ts +0 -31
- package/src/store/handleStore.ts +0 -31
- package/src/store/index.ts +0 -9
- package/src/store/messageStore.ts +0 -31
- package/src/store/objectStore.ts +0 -31
- package/src/store/processStore.ts +0 -31
- package/src/store/threadStore.ts +0 -31
- package/src/store/windowStore.ts +0 -31
- package/src/structure/abstractSyntaxTree.ts +0 -493
- package/src/structure/avlTree.ts +0 -408
- package/src/structure/binarySearchTree.ts +0 -352
- package/src/structure/binaryTree.ts +0 -525
- package/src/structure/bloomFilter.ts +0 -231
- package/src/structure/compare.ts +0 -110
- package/src/structure/cuckooFilter.ts +0 -337
- package/src/structure/deque.ts +0 -223
- package/src/structure/filterKey.ts +0 -36
- package/src/structure/hash.ts +0 -279
- package/src/structure/heap.ts +0 -268
- package/src/structure/index.ts +0 -20
- package/src/structure/iterator.ts +0 -22
- package/src/structure/lru.ts +0 -619
- package/src/structure/ordered.ts +0 -399
- package/src/structure/priority.ts +0 -915
- package/src/structure/queue.ts +0 -168
- package/src/structure/redBlackTree.ts +0 -680
- package/src/structure/segmentTree.ts +0 -248
- package/src/structure/stack.ts +0 -118
- package/src/structure/unordered.ts +0 -407
- package/src/style.css +0 -278
- package/src/thread/index.ts +0 -2
- package/src/thread/thread.ts +0 -176
- package/src/thread/transitions.ts +0 -17
- package/src/types/common.ts +0 -119
- package/src/types/index.ts +0 -23
- package/src/warrant/epistemic.ts +0 -154
- package/src/warrant/index.ts +0 -3
- package/src/warrant/inquiry.ts +0 -166
- package/src/warrant/warrant.ts +0 -179
- package/src/window/compaction.ts +0 -403
- package/src/window/compactionTypes.ts +0 -119
- package/src/window/index.ts +0 -7
- package/src/window/page.ts +0 -18
- package/src/window/window.ts +0 -244
- package/tools/_helpers.ts +0 -34
- package/tools/a2a-check.ts +0 -110
- package/tools/a2a-flow-check.ts +0 -78
- package/tools/agent-card-check.ts +0 -76
- package/tools/agent-check.ts +0 -236
- package/tools/agent-store-check.ts +0 -153
- package/tools/agreement-check.ts +0 -27
- package/tools/annotation-server-check.ts +0 -48
- package/tools/annotation-server.ts +0 -230
- package/tools/annotation-status.ts +0 -65
- package/tools/approval-access-check.ts +0 -66
- package/tools/arch-check.ts +0 -72
- package/tools/attention-core-check.ts +0 -48
- package/tools/attention-resource-check.ts +0 -169
- package/tools/audit-check.ts +0 -207
- package/tools/authority-check.ts +0 -124
- package/tools/authz-check.ts +0 -138
- package/tools/bayes-check.ts +0 -162
- package/tools/bayes-probe.ts +0 -154
- package/tools/behavior-tuning-check.ts +0 -53
- package/tools/board-check.ts +0 -87
- package/tools/boundary-check.ts +0 -199
- package/tools/bundle-trust-check.ts +0 -96
- package/tools/calibrate-imported.ts +0 -108
- package/tools/calibration-check.ts +0 -44
- package/tools/calibration-registry-check.ts +0 -40
- package/tools/calibration-sim.ts +0 -40
- package/tools/card-sign-check.ts +0 -71
- package/tools/card-trust-check.ts +0 -78
- package/tools/channel-check.ts +0 -86
- package/tools/checkpoint-check.ts +0 -620
- package/tools/cleanup-style-configs.ts +0 -29
- package/tools/cognition-check.ts +0 -648
- package/tools/cognitive-runtime-check.ts +0 -609
- package/tools/collaboration-demo.ts +0 -78
- package/tools/compaction-check.ts +0 -266
- package/tools/concept-check.ts +0 -260
- package/tools/concurrency-check.ts +0 -242
- package/tools/conformance-runtime.ts +0 -389
- package/tools/conformance.ts +0 -651
- package/tools/context-ast-check.ts +0 -90
- package/tools/context-ast-deepseek.ts +0 -242
- package/tools/context-graph-bench.ts +0 -50
- package/tools/context-graph-check.ts +0 -229
- package/tools/context-index-check.ts +0 -48
- package/tools/context-lifecycle-check.ts +0 -69
- package/tools/context-projection-check.ts +0 -73
- package/tools/context-scope-check.ts +0 -134
- package/tools/context-storage-check.ts +0 -113
- package/tools/cooperation-check.ts +0 -517
- package/tools/cooperation-http-check.ts +0 -125
- package/tools/deepseek-llm-check.ts +0 -147
- package/tools/deepseek-probe.ts +0 -494
- package/tools/diagnosis-check.ts +0 -109
- package/tools/diagnosis-router-check.ts +0 -50
- package/tools/document-context-check.ts +0 -237
- package/tools/envelope-check.ts +0 -659
- package/tools/eslint-rules/index.ts +0 -26
- package/tools/eslint-rules/rules/jsdoc-comment-format.ts +0 -105
- package/tools/eslint-rules/rules/no-function-keyword.ts +0 -60
- package/tools/eslint-rules/rules/no-multiline-parameters.ts +0 -71
- package/tools/eslint-rules/rules/no-multiline-type-parameters.ts +0 -57
- package/tools/eslint-rules/rules/no-undefined-comparison.ts +0 -115
- package/tools/eslint-rules/rules/prefer-template-for-string-conversion.ts +0 -97
- package/tools/eslint-rules/rules/require-typeof-parentheses.ts +0 -49
- package/tools/eslint-rules/rules/require-variable-type.ts +0 -36
- package/tools/eslint-rules/rules/variable-naming.ts +0 -175
- package/tools/eval-recorded-replay.ts +0 -215
- package/tools/eval-replay.ts +0 -139
- package/tools/eval-summary.ts +0 -136
- package/tools/evidence-revalidation-check.ts +0 -235
- package/tools/exec-check.ts +0 -217
- package/tools/federation-check.ts +0 -166
- package/tools/federation-demo.ts +0 -45
- package/tools/filter-check.ts +0 -243
- package/tools/governance-check.ts +0 -680
- package/tools/governance-store-check.ts +0 -131
- package/tools/governed-task-check.ts +0 -227
- package/tools/guard-check.ts +0 -122
- package/tools/http-channel-check.ts +0 -125
- package/tools/import-campaign.ts +0 -28
- package/tools/inquiry-check.ts +0 -126
- package/tools/interaction-check.ts +0 -171
- package/tools/interrupts-check.ts +0 -173
- package/tools/ipc-check.ts +0 -170
- package/tools/kernel-async-check.ts +0 -136
- package/tools/kernel-check.ts +0 -369
- package/tools/kernel-runtime-check.ts +0 -276
- package/tools/keys-check.ts +0 -559
- package/tools/label-audit.ts +0 -70
- package/tools/labels-workflow-check.ts +0 -49
- package/tools/linear-structure-check.ts +0 -524
- package/tools/live-exec.ts +0 -62
- package/tools/live-governance-eval.ts +0 -813
- package/tools/live-legacy.ts +0 -50
- package/tools/lru-check.ts +0 -182
- package/tools/make-annotation-campaign.ts +0 -57
- package/tools/mcp-executor-check.ts +0 -33
- package/tools/merge-annotations.ts +0 -32
- package/tools/merge-check.ts +0 -98
- package/tools/metrics-check.ts +0 -84
- package/tools/net-probe.ts +0 -107
- package/tools/oauth-probe.ts +0 -117
- package/tools/outbox-check.ts +0 -50
- package/tools/persistence-check.ts +0 -144
- package/tools/pin-check.ts +0 -116
- package/tools/platform-check.ts +0 -281
- package/tools/policy-check.ts +0 -514
- package/tools/prettier-plugin/index.mts +0 -84
- package/tools/priority-check.ts +0 -627
- package/tools/probe-context7.ts +0 -63
- package/tools/registry-check.ts +0 -252
- package/tools/reliability-check.ts +0 -25
- package/tools/retry-check.ts +0 -85
- package/tools/rewrite-declaration-extensions.ts +0 -98
- package/tools/runtime-check.ts +0 -165
- package/tools/runtime-deepseek-check.ts +0 -85
- package/tools/runtime-eval.ts +0 -358
- package/tools/scenario-check.ts +0 -161
- package/tools/scenario-incident.ts +0 -162
- package/tools/scoped-priors-check.ts +0 -35
- package/tools/scoped-priors-pooling.ts +0 -34
- package/tools/segment-ast-check.ts +0 -649
- package/tools/session-check.ts +0 -196
- package/tools/session-store-check.ts +0 -73
- package/tools/share-check.ts +0 -88
- package/tools/sign-check.ts +0 -95
- package/tools/signing-check.ts +0 -275
- package/tools/snapshot-demo.ts +0 -65
- package/tools/social-check.ts +0 -146
- package/tools/structure-compare-check.ts +0 -95
- package/tools/support/documentScanner.ts +0 -577
- package/tools/support/texScanner.ts +0 -631
- package/tools/support/workspaceScanner.ts +0 -476
- package/tools/team-check.ts +0 -163
- package/tools/team-demo.ts +0 -36
- package/tools/telemetry-check.ts +0 -44
- package/tools/tex-context-check.ts +0 -263
- package/tools/tool-gate-check.ts +0 -98
- package/tools/tree-structure-check.ts +0 -786
- package/tools/trust-flow-check.ts +0 -158
- package/tools/turn-store-check.ts +0 -57
- package/tools/unified-check.ts +0 -83
- package/tools/validate.ts +0 -309
- package/tools/wire-check.ts +0 -96
- package/tools/workspace-agent-check.ts +0 -486
- package/tools/workspace-agent-demo.ts +0 -62
- package/tools/workspace-agent-server.ts +0 -101
- package/tools/workspace-context-check.ts +0 -331
- package/tools/workspace-context.ts +0 -131
- package/tsconfig.build.json +0 -14
- package/tsconfig.json +0 -24
- package/tsconfig.tools.json +0 -31
- package/viz/context-ast.json +0 -1577
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SQLite repository for the persisted file/directory tree.
|
|
3
|
+
*
|
|
4
|
+
* One row per node. `node_id` is `rootId + "\0" + path`, which makes a point
|
|
5
|
+
* lookup a primary-key read while `(root_id, path)` stays unique for joins.
|
|
6
|
+
* `lines`/`bytes` are TEXT in the table because the domain uses `bigint`; the
|
|
7
|
+
* repository converts explicitly instead of relying on driver coercion.
|
|
8
|
+
*
|
|
9
|
+
* `stats.truncated` has no column, so it is recorded in the shared `meta` table
|
|
10
|
+
* under `file_nodes.truncated.<rootId>` inside the same transaction as the tree
|
|
11
|
+
* rows. A reload therefore cannot present a truncated walk as complete.
|
|
12
|
+
*/
|
|
13
|
+
import type { DatabaseSync } from "node:sqlite";
|
|
14
|
+
import type { TreeSnapshot } from "../../file/types.js";
|
|
15
|
+
import type { FileNodeRow } from "../entity/fileTree.js";
|
|
16
|
+
import { BaseRepository } from "./base.js";
|
|
17
|
+
/**
|
|
18
|
+
* Repository for `file_nodes`.
|
|
19
|
+
*/
|
|
20
|
+
export declare class FileNodeRepository extends BaseRepository<FileNodeRow, string> {
|
|
21
|
+
/**
|
|
22
|
+
* Create the repository.
|
|
23
|
+
*
|
|
24
|
+
* @param db - Open SQLite connection.
|
|
25
|
+
*/
|
|
26
|
+
constructor(db: DatabaseSync);
|
|
27
|
+
/**
|
|
28
|
+
* Replace the whole persisted tree of one root in one transaction.
|
|
29
|
+
*
|
|
30
|
+
* Old rows are deleted first, so a node that disappeared from the snapshot
|
|
31
|
+
* cannot linger. Every node of `snapshot.root` is inserted recursively with
|
|
32
|
+
* the snapshot revision and the supplied update timestamp, and the
|
|
33
|
+
* truncation flag is recorded in the same transaction.
|
|
34
|
+
*
|
|
35
|
+
* @param rootId - Session root id.
|
|
36
|
+
* @param snapshot - Tree snapshot built by the filesystem domain.
|
|
37
|
+
* @param updatedAt - ISO timestamp for the write.
|
|
38
|
+
* @throws RangeError when a node reports negative lines or bytes.
|
|
39
|
+
* @throws Error when a root id or path contains NUL.
|
|
40
|
+
*/
|
|
41
|
+
replaceTree(rootId: string, snapshot: TreeSnapshot, updatedAt: string): void;
|
|
42
|
+
/**
|
|
43
|
+
* Read one node.
|
|
44
|
+
*
|
|
45
|
+
* @param rootId - Session root id.
|
|
46
|
+
* @param path - Root-relative POSIX path.
|
|
47
|
+
* @returns The row, or `undefined` when absent.
|
|
48
|
+
*/
|
|
49
|
+
findNode(rootId: string, path: string): FileNodeRow | undefined;
|
|
50
|
+
/**
|
|
51
|
+
* List the direct children of one directory.
|
|
52
|
+
*
|
|
53
|
+
* @param rootId - Session root id.
|
|
54
|
+
* @param parentPath - Parent path; `.` for the root.
|
|
55
|
+
* @returns Child rows, directories before files and each group by name.
|
|
56
|
+
*/
|
|
57
|
+
children(rootId: string, parentPath: string): FileNodeRow[];
|
|
58
|
+
/**
|
|
59
|
+
* List every row of one root.
|
|
60
|
+
*
|
|
61
|
+
* Used to rebuild a snapshot without one query per directory.
|
|
62
|
+
*
|
|
63
|
+
* @param rootId - Session root id.
|
|
64
|
+
* @returns Rows ordered by path.
|
|
65
|
+
*/
|
|
66
|
+
listNodes(rootId: string): FileNodeRow[];
|
|
67
|
+
/**
|
|
68
|
+
* Read the truncation flag persisted with the tree.
|
|
69
|
+
*
|
|
70
|
+
* @param rootId - Session root id.
|
|
71
|
+
* @returns `true` when the persisted snapshot was truncated.
|
|
72
|
+
*/
|
|
73
|
+
loadTruncated(rootId: string): boolean;
|
|
74
|
+
/**
|
|
75
|
+
* Delete every node of one root and its truncation flag.
|
|
76
|
+
*
|
|
77
|
+
* @param rootId - Session root id.
|
|
78
|
+
*/
|
|
79
|
+
deleteTree(rootId: string): void;
|
|
80
|
+
/**
|
|
81
|
+
* Count the persisted nodes of one root.
|
|
82
|
+
*
|
|
83
|
+
* @param rootId - Session root id.
|
|
84
|
+
* @returns Number of rows.
|
|
85
|
+
*/
|
|
86
|
+
count(rootId: string): number;
|
|
87
|
+
/**
|
|
88
|
+
* Insert one node and then its descendants.
|
|
89
|
+
*
|
|
90
|
+
* @param rootId - Session root id.
|
|
91
|
+
* @param node - Node to persist.
|
|
92
|
+
* @param revision - Snapshot revision shared by every row.
|
|
93
|
+
* @param updatedAt - ISO timestamp for the write.
|
|
94
|
+
*/
|
|
95
|
+
private insertNode;
|
|
96
|
+
/**
|
|
97
|
+
* Read one meta value.
|
|
98
|
+
*
|
|
99
|
+
* @param key - Meta key.
|
|
100
|
+
* @returns Value, or `undefined` when absent.
|
|
101
|
+
*/
|
|
102
|
+
private readMeta;
|
|
103
|
+
/**
|
|
104
|
+
* Insert or replace one meta value.
|
|
105
|
+
*
|
|
106
|
+
* @param key - Meta key.
|
|
107
|
+
* @param value - Meta value.
|
|
108
|
+
*/
|
|
109
|
+
private writeMeta;
|
|
110
|
+
/**
|
|
111
|
+
* Delete one meta value.
|
|
112
|
+
*
|
|
113
|
+
* @param key - Meta key.
|
|
114
|
+
*/
|
|
115
|
+
private deleteMeta;
|
|
116
|
+
}
|
|
@@ -0,0 +1,263 @@
|
|
|
1
|
+
import { FileNodeTable } from "../entity/fileTree.js";
|
|
2
|
+
import { assertSqlIdentifier } from "../sql/sql.js";
|
|
3
|
+
import { transaction } from "../store/database.js";
|
|
4
|
+
import { BaseRepository } from "./base.js";
|
|
5
|
+
/**
|
|
6
|
+
* Meta table metadata.
|
|
7
|
+
*
|
|
8
|
+
* `meta` has no entity module; this local {@link TableMeta} keeps its
|
|
9
|
+
* identifiers validated like every other table.
|
|
10
|
+
*/
|
|
11
|
+
const MetaTable = {
|
|
12
|
+
table: "meta",
|
|
13
|
+
primaryKey: "key",
|
|
14
|
+
columns: ["key", "value"],
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* Prefix for the truncation flag of one root.
|
|
18
|
+
*/
|
|
19
|
+
const TruncatedPrefix = "file_nodes.truncated.";
|
|
20
|
+
/**
|
|
21
|
+
* Quote a column that is declared by the table metadata.
|
|
22
|
+
*
|
|
23
|
+
* @param meta - Table metadata.
|
|
24
|
+
* @param column - Column name.
|
|
25
|
+
* @returns Double-quoted column name.
|
|
26
|
+
*/
|
|
27
|
+
const quoted = (meta, column) => {
|
|
28
|
+
if (!meta.columns.includes(column)) {
|
|
29
|
+
throw new Error(`unknown column for ${meta.table}: ${column}`);
|
|
30
|
+
}
|
|
31
|
+
return `"${assertSqlIdentifier(column)}"`;
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* Quote a table name that is declared by table metadata.
|
|
35
|
+
*
|
|
36
|
+
* @param meta - Table metadata.
|
|
37
|
+
* @returns Double-quoted table name.
|
|
38
|
+
*/
|
|
39
|
+
const tableOf = (meta) => `"${assertSqlIdentifier(meta.table)}"`;
|
|
40
|
+
/**
|
|
41
|
+
* Build a bound `column = ?` conjunction from declared columns.
|
|
42
|
+
*
|
|
43
|
+
* @param meta - Table metadata.
|
|
44
|
+
* @param columns - Column names in bind order.
|
|
45
|
+
* @returns SQL fragment with one placeholder per column.
|
|
46
|
+
*/
|
|
47
|
+
const conditions = (meta, columns) => columns.map((column) => `${quoted(meta, column)} = ?`).join(" AND ");
|
|
48
|
+
/**
|
|
49
|
+
* Deterministic node primary key.
|
|
50
|
+
*
|
|
51
|
+
* NUL is the separator, so a component containing NUL would alias another
|
|
52
|
+
* `(rootId, path)` pair on the primary key while differing on the unique pair.
|
|
53
|
+
*
|
|
54
|
+
* @param rootId - Session root id.
|
|
55
|
+
* @param path - Root-relative POSIX path.
|
|
56
|
+
* @returns `rootId\0path`.
|
|
57
|
+
* @throws Error when a component contains NUL.
|
|
58
|
+
*/
|
|
59
|
+
const nodeId = (rootId, path) => {
|
|
60
|
+
if (rootId.includes("\u0000") || path.includes("\u0000")) {
|
|
61
|
+
throw new Error("file node components must not contain U+0000");
|
|
62
|
+
}
|
|
63
|
+
return `${rootId}\u0000${path}`;
|
|
64
|
+
};
|
|
65
|
+
/**
|
|
66
|
+
* Reject a negative line/byte counter.
|
|
67
|
+
*
|
|
68
|
+
* @param value - Counter supplied by the tree snapshot.
|
|
69
|
+
* @param field - Field name used in the error message.
|
|
70
|
+
* @throws RangeError when the counter is negative.
|
|
71
|
+
*/
|
|
72
|
+
const assertCounter = (value, field) => {
|
|
73
|
+
if (value < 0n) {
|
|
74
|
+
throw new RangeError(`${field} must not be negative`);
|
|
75
|
+
}
|
|
76
|
+
};
|
|
77
|
+
/**
|
|
78
|
+
* Root-relative parent path of a node.
|
|
79
|
+
*
|
|
80
|
+
* The snapshot root is `.` and has no parent; a direct child of the root has
|
|
81
|
+
* `.` as its parent so a direct-children query stays a single index seek.
|
|
82
|
+
*
|
|
83
|
+
* @param path - Root-relative POSIX path.
|
|
84
|
+
* @returns Parent path.
|
|
85
|
+
*/
|
|
86
|
+
const parentOf = (path) => {
|
|
87
|
+
const slash = path.lastIndexOf("/");
|
|
88
|
+
return slash < 0 ? "." : path.slice(0, slash);
|
|
89
|
+
};
|
|
90
|
+
/**
|
|
91
|
+
* Repository for `file_nodes`.
|
|
92
|
+
*/
|
|
93
|
+
export class FileNodeRepository extends BaseRepository {
|
|
94
|
+
/**
|
|
95
|
+
* Create the repository.
|
|
96
|
+
*
|
|
97
|
+
* @param db - Open SQLite connection.
|
|
98
|
+
*/
|
|
99
|
+
constructor(db) {
|
|
100
|
+
super(db, FileNodeTable);
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Replace the whole persisted tree of one root in one transaction.
|
|
104
|
+
*
|
|
105
|
+
* Old rows are deleted first, so a node that disappeared from the snapshot
|
|
106
|
+
* cannot linger. Every node of `snapshot.root` is inserted recursively with
|
|
107
|
+
* the snapshot revision and the supplied update timestamp, and the
|
|
108
|
+
* truncation flag is recorded in the same transaction.
|
|
109
|
+
*
|
|
110
|
+
* @param rootId - Session root id.
|
|
111
|
+
* @param snapshot - Tree snapshot built by the filesystem domain.
|
|
112
|
+
* @param updatedAt - ISO timestamp for the write.
|
|
113
|
+
* @throws RangeError when a node reports negative lines or bytes.
|
|
114
|
+
* @throws Error when a root id or path contains NUL.
|
|
115
|
+
*/
|
|
116
|
+
replaceTree(rootId, snapshot, updatedAt) {
|
|
117
|
+
transaction(this.db, () => {
|
|
118
|
+
this.deleteTree(rootId);
|
|
119
|
+
this.insertNode(rootId, snapshot.root, snapshot.revision, updatedAt);
|
|
120
|
+
this.writeMeta(`${TruncatedPrefix}${rootId}`, snapshot.stats.truncated ? "1" : "0");
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Read one node.
|
|
125
|
+
*
|
|
126
|
+
* @param rootId - Session root id.
|
|
127
|
+
* @param path - Root-relative POSIX path.
|
|
128
|
+
* @returns The row, or `undefined` when absent.
|
|
129
|
+
*/
|
|
130
|
+
findNode(rootId, path) {
|
|
131
|
+
const rows = this.queries.select({
|
|
132
|
+
where: conditions(FileNodeTable, ["root_id", "path"]),
|
|
133
|
+
params: [rootId, path],
|
|
134
|
+
limit: 1,
|
|
135
|
+
});
|
|
136
|
+
return rows.length === 0 ? undefined : rows[0];
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* List the direct children of one directory.
|
|
140
|
+
*
|
|
141
|
+
* @param rootId - Session root id.
|
|
142
|
+
* @param parentPath - Parent path; `.` for the root.
|
|
143
|
+
* @returns Child rows, directories before files and each group by name.
|
|
144
|
+
*/
|
|
145
|
+
children(rootId, parentPath) {
|
|
146
|
+
return this.queries.select({
|
|
147
|
+
where: conditions(FileNodeTable, ["root_id", "parent_path"]),
|
|
148
|
+
params: [rootId, parentPath],
|
|
149
|
+
orderBy: `ORDER BY ${quoted(FileNodeTable, "type")} ASC, ${quoted(FileNodeTable, "name")} ASC`,
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* List every row of one root.
|
|
154
|
+
*
|
|
155
|
+
* Used to rebuild a snapshot without one query per directory.
|
|
156
|
+
*
|
|
157
|
+
* @param rootId - Session root id.
|
|
158
|
+
* @returns Rows ordered by path.
|
|
159
|
+
*/
|
|
160
|
+
listNodes(rootId) {
|
|
161
|
+
return this.queries.select({
|
|
162
|
+
where: conditions(FileNodeTable, ["root_id"]),
|
|
163
|
+
params: [rootId],
|
|
164
|
+
orderBy: `ORDER BY ${quoted(FileNodeTable, "path")} ASC`,
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* Read the truncation flag persisted with the tree.
|
|
169
|
+
*
|
|
170
|
+
* @param rootId - Session root id.
|
|
171
|
+
* @returns `true` when the persisted snapshot was truncated.
|
|
172
|
+
*/
|
|
173
|
+
loadTruncated(rootId) {
|
|
174
|
+
return this.readMeta(`${TruncatedPrefix}${rootId}`) === "1";
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* Delete every node of one root and its truncation flag.
|
|
178
|
+
*
|
|
179
|
+
* @param rootId - Session root id.
|
|
180
|
+
*/
|
|
181
|
+
deleteTree(rootId) {
|
|
182
|
+
this.deleteWhere(conditions(FileNodeTable, ["root_id"]), rootId);
|
|
183
|
+
this.deleteMeta(`${TruncatedPrefix}${rootId}`);
|
|
184
|
+
}
|
|
185
|
+
/**
|
|
186
|
+
* Count the persisted nodes of one root.
|
|
187
|
+
*
|
|
188
|
+
* @param rootId - Session root id.
|
|
189
|
+
* @returns Number of rows.
|
|
190
|
+
*/
|
|
191
|
+
count(rootId) {
|
|
192
|
+
return this.queries.count(conditions(FileNodeTable, ["root_id"]), rootId);
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* Insert one node and then its descendants.
|
|
196
|
+
*
|
|
197
|
+
* @param rootId - Session root id.
|
|
198
|
+
* @param node - Node to persist.
|
|
199
|
+
* @param revision - Snapshot revision shared by every row.
|
|
200
|
+
* @param updatedAt - ISO timestamp for the write.
|
|
201
|
+
*/
|
|
202
|
+
insertNode(rootId, node, revision, updatedAt) {
|
|
203
|
+
assertCounter(node.lines, "node lines");
|
|
204
|
+
assertCounter(node.bytes, "node bytes");
|
|
205
|
+
this.insert({
|
|
206
|
+
node_id: nodeId(rootId, node.path),
|
|
207
|
+
root_id: rootId,
|
|
208
|
+
path: node.path,
|
|
209
|
+
parent_path: node.path === "." ? null : parentOf(node.path),
|
|
210
|
+
type: node.type,
|
|
211
|
+
name: node.name,
|
|
212
|
+
extension: node.extension,
|
|
213
|
+
fingerprint: node.fingerprint,
|
|
214
|
+
charset: node.charset,
|
|
215
|
+
lines: `${node.lines}`,
|
|
216
|
+
bytes: `${node.bytes}`,
|
|
217
|
+
created_at: node.create,
|
|
218
|
+
modified_at: node.modify,
|
|
219
|
+
description: node.description,
|
|
220
|
+
summary: node.summary,
|
|
221
|
+
purpose: node.purpose,
|
|
222
|
+
revision,
|
|
223
|
+
updated_at: updatedAt,
|
|
224
|
+
});
|
|
225
|
+
if (node.type === "Directory") {
|
|
226
|
+
for (let index = 0; index < node.children.length; index += 1) {
|
|
227
|
+
this.insertNode(rootId, node.children[index], revision, updatedAt);
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
/**
|
|
232
|
+
* Read one meta value.
|
|
233
|
+
*
|
|
234
|
+
* @param key - Meta key.
|
|
235
|
+
* @returns Value, or `undefined` when absent.
|
|
236
|
+
*/
|
|
237
|
+
readMeta(key) {
|
|
238
|
+
const sql = `SELECT ${quoted(MetaTable, "value")} AS value FROM ${tableOf(MetaTable)} WHERE ${quoted(MetaTable, "key")} = ? LIMIT 1`;
|
|
239
|
+
const row = this.db.prepare(sql).get(key);
|
|
240
|
+
return row === (void 0) ? undefined : row.value;
|
|
241
|
+
}
|
|
242
|
+
/**
|
|
243
|
+
* Insert or replace one meta value.
|
|
244
|
+
*
|
|
245
|
+
* @param key - Meta key.
|
|
246
|
+
* @param value - Meta value.
|
|
247
|
+
*/
|
|
248
|
+
writeMeta(key, value) {
|
|
249
|
+
const keyColumn = quoted(MetaTable, "key");
|
|
250
|
+
const valueColumn = quoted(MetaTable, "value");
|
|
251
|
+
const sql = `INSERT INTO ${tableOf(MetaTable)} (${keyColumn}, ${valueColumn}) VALUES (?, ?) ON CONFLICT(${keyColumn}) DO UPDATE SET ${valueColumn} = excluded.${valueColumn}`;
|
|
252
|
+
this.db.prepare(sql).run(key, value);
|
|
253
|
+
}
|
|
254
|
+
/**
|
|
255
|
+
* Delete one meta value.
|
|
256
|
+
*
|
|
257
|
+
* @param key - Meta key.
|
|
258
|
+
*/
|
|
259
|
+
deleteMeta(key) {
|
|
260
|
+
const sql = `DELETE FROM ${tableOf(MetaTable)} WHERE ${quoted(MetaTable, "key")} = ?`;
|
|
261
|
+
this.db.prepare(sql).run(key);
|
|
262
|
+
}
|
|
263
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SQLite repository for the outline cache.
|
|
3
|
+
*
|
|
4
|
+
* A result is keyed by `rootId + "\0" + path + "\0" + fingerprint`, so an
|
|
5
|
+
* unchanged file reuses its parsed outline and a changed file can never read a
|
|
6
|
+
* stale tree. The node list is stored as JSON; language, charset and the
|
|
7
|
+
* truncation flag stay as columns so a reader can filter without parsing.
|
|
8
|
+
*/
|
|
9
|
+
import type { DatabaseSync } from "node:sqlite";
|
|
10
|
+
import type { OutlineResult } from "../../outline/types.js";
|
|
11
|
+
import type { FileOutlineRow } from "../entity/fileTree.js";
|
|
12
|
+
import { BaseRepository } from "./base.js";
|
|
13
|
+
/**
|
|
14
|
+
* Repository for `file_outlines`.
|
|
15
|
+
*/
|
|
16
|
+
export declare class FileOutlineRepository extends BaseRepository<FileOutlineRow, string> {
|
|
17
|
+
/**
|
|
18
|
+
* Create the repository.
|
|
19
|
+
*
|
|
20
|
+
* @param db - Open SQLite connection.
|
|
21
|
+
*/
|
|
22
|
+
constructor(db: DatabaseSync);
|
|
23
|
+
/**
|
|
24
|
+
* Insert or replace the outline of one fingerprint.
|
|
25
|
+
*
|
|
26
|
+
* @param rootId - Session root id.
|
|
27
|
+
* @param outline - Parsed outline.
|
|
28
|
+
* @param at - ISO timestamp for the write.
|
|
29
|
+
*/
|
|
30
|
+
save(rootId: string, outline: OutlineResult, at: string): void;
|
|
31
|
+
/**
|
|
32
|
+
* Load the outline of one exact fingerprint.
|
|
33
|
+
*
|
|
34
|
+
* @param rootId - Session root id.
|
|
35
|
+
* @param path - Root-relative POSIX path.
|
|
36
|
+
* @param fingerprint - File content fingerprint.
|
|
37
|
+
* @returns The cached outline, or `undefined` when absent or stale.
|
|
38
|
+
*/
|
|
39
|
+
load(rootId: string, path: string, fingerprint: string): OutlineResult | undefined;
|
|
40
|
+
}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { outlineFromWire, wireOutline } from "../../outline/outlineIndex.js";
|
|
2
|
+
import { FileOutlineTable } from "../entity/fileTree.js";
|
|
3
|
+
import { assertSqlIdentifier } from "../sql/sql.js";
|
|
4
|
+
import { BaseRepository } from "./base.js";
|
|
5
|
+
/**
|
|
6
|
+
* Quote a column that is declared by the table metadata.
|
|
7
|
+
*
|
|
8
|
+
* @param meta - Table metadata.
|
|
9
|
+
* @param column - Column name.
|
|
10
|
+
* @returns Double-quoted column name.
|
|
11
|
+
*/
|
|
12
|
+
const quoted = (meta, column) => {
|
|
13
|
+
if (!meta.columns.includes(column)) {
|
|
14
|
+
throw new Error(`unknown column for ${meta.table}: ${column}`);
|
|
15
|
+
}
|
|
16
|
+
return `"${assertSqlIdentifier(column)}"`;
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Build a bound `column = ?` conjunction from declared columns.
|
|
20
|
+
*
|
|
21
|
+
* @param meta - Table metadata.
|
|
22
|
+
* @param columns - Column names in bind order.
|
|
23
|
+
* @returns SQL fragment with one placeholder per column.
|
|
24
|
+
*/
|
|
25
|
+
const conditions = (meta, columns) => columns.map((column) => `${quoted(meta, column)} = ?`).join(" AND ");
|
|
26
|
+
/**
|
|
27
|
+
* Deterministic outline primary key.
|
|
28
|
+
*
|
|
29
|
+
* NUL is the separator, so a component containing NUL would alias another
|
|
30
|
+
* `(rootId, path, fingerprint)` triple on the primary key.
|
|
31
|
+
*
|
|
32
|
+
* @param rootId - Session root id.
|
|
33
|
+
* @param path - Root-relative POSIX path.
|
|
34
|
+
* @param fingerprint - File content fingerprint.
|
|
35
|
+
* @returns `rootId\0path\0fingerprint`.
|
|
36
|
+
* @throws Error when a component contains NUL.
|
|
37
|
+
*/
|
|
38
|
+
const outlineId = (rootId, path, fingerprint) => {
|
|
39
|
+
if (rootId.includes("\u0000") || path.includes("\u0000") || fingerprint.includes("\u0000")) {
|
|
40
|
+
throw new Error("outline components must not contain U+0000");
|
|
41
|
+
}
|
|
42
|
+
return `${rootId}\u0000${path}\u0000${fingerprint}`;
|
|
43
|
+
};
|
|
44
|
+
/**
|
|
45
|
+
* Repository for `file_outlines`.
|
|
46
|
+
*/
|
|
47
|
+
export class FileOutlineRepository extends BaseRepository {
|
|
48
|
+
/**
|
|
49
|
+
* Create the repository.
|
|
50
|
+
*
|
|
51
|
+
* @param db - Open SQLite connection.
|
|
52
|
+
*/
|
|
53
|
+
constructor(db) {
|
|
54
|
+
super(db, FileOutlineTable);
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Insert or replace the outline of one fingerprint.
|
|
58
|
+
*
|
|
59
|
+
* @param rootId - Session root id.
|
|
60
|
+
* @param outline - Parsed outline.
|
|
61
|
+
* @param at - ISO timestamp for the write.
|
|
62
|
+
*/
|
|
63
|
+
save(rootId, outline, at) {
|
|
64
|
+
this.upsert({
|
|
65
|
+
outline_id: outlineId(rootId, outline.path, outline.fingerprint),
|
|
66
|
+
root_id: rootId,
|
|
67
|
+
path: outline.path,
|
|
68
|
+
fingerprint: outline.fingerprint,
|
|
69
|
+
language: outline.language,
|
|
70
|
+
charset: outline.charset,
|
|
71
|
+
data_json: JSON.stringify(wireOutline(outline)),
|
|
72
|
+
truncated: outline.truncated ? 1 : 0,
|
|
73
|
+
created_at: at,
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Load the outline of one exact fingerprint.
|
|
78
|
+
*
|
|
79
|
+
* @param rootId - Session root id.
|
|
80
|
+
* @param path - Root-relative POSIX path.
|
|
81
|
+
* @param fingerprint - File content fingerprint.
|
|
82
|
+
* @returns The cached outline, or `undefined` when absent or stale.
|
|
83
|
+
*/
|
|
84
|
+
load(rootId, path, fingerprint) {
|
|
85
|
+
const rows = this.queries.select({
|
|
86
|
+
where: conditions(FileOutlineTable, ["root_id", "path", "fingerprint"]),
|
|
87
|
+
params: [rootId, path, fingerprint],
|
|
88
|
+
limit: 1,
|
|
89
|
+
});
|
|
90
|
+
if (rows.length === 0) {
|
|
91
|
+
return undefined;
|
|
92
|
+
}
|
|
93
|
+
const row = rows[0];
|
|
94
|
+
const wire = JSON.parse(row.data_json);
|
|
95
|
+
return outlineFromWire({
|
|
96
|
+
...wire,
|
|
97
|
+
path: row.path,
|
|
98
|
+
fingerprint: row.fingerprint,
|
|
99
|
+
language: row.language,
|
|
100
|
+
charset: row.charset,
|
|
101
|
+
truncated: row.truncated === 1,
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SQLite repository for the append-only write journal.
|
|
3
|
+
*
|
|
4
|
+
* A row is metadata only: path, mode, before/after fingerprints, byte count and
|
|
5
|
+
* timestamp. Content is never copied here, so a crash cannot leave a stale body
|
|
6
|
+
* that contradicts the workspace file. `write_id` is autoincremented and gives a
|
|
7
|
+
* total order per store; a session's history is read newest first.
|
|
8
|
+
*/
|
|
9
|
+
import type { DatabaseSync } from "node:sqlite";
|
|
10
|
+
import type { WriteJournalEntry } from "../../file/types.js";
|
|
11
|
+
import type { FileWriteRow } from "../entity/fileTree.js";
|
|
12
|
+
import { BaseRepository } from "./base.js";
|
|
13
|
+
/**
|
|
14
|
+
* Repository for `file_writes`.
|
|
15
|
+
*/
|
|
16
|
+
export declare class FileWriteRepository extends BaseRepository<FileWriteRow, number> {
|
|
17
|
+
/**
|
|
18
|
+
* Create the repository.
|
|
19
|
+
*
|
|
20
|
+
* @param db - Open SQLite connection.
|
|
21
|
+
*/
|
|
22
|
+
constructor(db: DatabaseSync);
|
|
23
|
+
/**
|
|
24
|
+
* Append one successful write, letting SQLite assign `write_id`.
|
|
25
|
+
*
|
|
26
|
+
* @param entry - Journal record.
|
|
27
|
+
* @param rootId - Session root id; the entry's own copy is not trusted for
|
|
28
|
+
* the row, so a caller cannot journal into another root.
|
|
29
|
+
* @throws Error when the mode is outside the closed write-mode set.
|
|
30
|
+
* @throws RangeError when the byte count is negative.
|
|
31
|
+
*/
|
|
32
|
+
append(entry: WriteJournalEntry, rootId: string): void;
|
|
33
|
+
/**
|
|
34
|
+
* Read a session's journal, newest first.
|
|
35
|
+
*
|
|
36
|
+
* @param sessionId - Session handle.
|
|
37
|
+
* @param limit - Maximum rows; zero is allowed and returns nothing.
|
|
38
|
+
* @returns Journal rows.
|
|
39
|
+
*/
|
|
40
|
+
list(sessionId: string, limit: number): FileWriteRow[];
|
|
41
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import { FileWriteTable } from "../entity/fileTree.js";
|
|
2
|
+
import { assertSqlIdentifier } from "../sql/sql.js";
|
|
3
|
+
import { BaseRepository } from "./base.js";
|
|
4
|
+
/**
|
|
5
|
+
* Quote a column that is declared by the table metadata.
|
|
6
|
+
*
|
|
7
|
+
* @param meta - Table metadata.
|
|
8
|
+
* @param column - Column name.
|
|
9
|
+
* @returns Double-quoted column name.
|
|
10
|
+
*/
|
|
11
|
+
const quoted = (meta, column) => {
|
|
12
|
+
if (!meta.columns.includes(column)) {
|
|
13
|
+
throw new Error(`unknown column for ${meta.table}: ${column}`);
|
|
14
|
+
}
|
|
15
|
+
return `"${assertSqlIdentifier(column)}"`;
|
|
16
|
+
};
|
|
17
|
+
/**
|
|
18
|
+
* Build a bound `column = ?` conjunction from declared columns.
|
|
19
|
+
*
|
|
20
|
+
* @param meta - Table metadata.
|
|
21
|
+
* @param columns - Column names in bind order.
|
|
22
|
+
* @returns SQL fragment with one placeholder per column.
|
|
23
|
+
*/
|
|
24
|
+
const conditions = (meta, columns) => columns.map((column) => `${quoted(meta, column)} = ?`).join(" AND ");
|
|
25
|
+
/**
|
|
26
|
+
* Validate one journal mode against the closed write-mode set.
|
|
27
|
+
*
|
|
28
|
+
* @param value - Mode supplied by the caller.
|
|
29
|
+
* @returns The validated mode.
|
|
30
|
+
* @throws Error when the mode is outside the closed set.
|
|
31
|
+
*/
|
|
32
|
+
const parseMode = (value) => {
|
|
33
|
+
if (value === "create" || value === "overwrite" || value === "upsert" || value === "append") {
|
|
34
|
+
return value;
|
|
35
|
+
}
|
|
36
|
+
throw new Error(`invalid write mode: ${value}`);
|
|
37
|
+
};
|
|
38
|
+
/**
|
|
39
|
+
* Repository for `file_writes`.
|
|
40
|
+
*/
|
|
41
|
+
export class FileWriteRepository extends BaseRepository {
|
|
42
|
+
/**
|
|
43
|
+
* Create the repository.
|
|
44
|
+
*
|
|
45
|
+
* @param db - Open SQLite connection.
|
|
46
|
+
*/
|
|
47
|
+
constructor(db) {
|
|
48
|
+
super(db, FileWriteTable);
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Append one successful write, letting SQLite assign `write_id`.
|
|
52
|
+
*
|
|
53
|
+
* @param entry - Journal record.
|
|
54
|
+
* @param rootId - Session root id; the entry's own copy is not trusted for
|
|
55
|
+
* the row, so a caller cannot journal into another root.
|
|
56
|
+
* @throws Error when the mode is outside the closed write-mode set.
|
|
57
|
+
* @throws RangeError when the byte count is negative.
|
|
58
|
+
*/
|
|
59
|
+
append(entry, rootId) {
|
|
60
|
+
const mode = parseMode(entry.mode);
|
|
61
|
+
if (entry.bytes < 0n) {
|
|
62
|
+
throw new RangeError("write bytes must not be negative");
|
|
63
|
+
}
|
|
64
|
+
this.insert({
|
|
65
|
+
session_id: entry.sessionId,
|
|
66
|
+
root_id: rootId,
|
|
67
|
+
path: entry.path,
|
|
68
|
+
mode,
|
|
69
|
+
previous_fingerprint: entry.previousFingerprint,
|
|
70
|
+
next_fingerprint: entry.nextFingerprint,
|
|
71
|
+
bytes: `${entry.bytes}`,
|
|
72
|
+
at: entry.at,
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Read a session's journal, newest first.
|
|
77
|
+
*
|
|
78
|
+
* @param sessionId - Session handle.
|
|
79
|
+
* @param limit - Maximum rows; zero is allowed and returns nothing.
|
|
80
|
+
* @returns Journal rows.
|
|
81
|
+
*/
|
|
82
|
+
list(sessionId, limit) {
|
|
83
|
+
if (!Number.isInteger(limit) || limit < 0) {
|
|
84
|
+
throw new RangeError("limit must be a non-negative integer");
|
|
85
|
+
}
|
|
86
|
+
return this.queries.select({
|
|
87
|
+
where: conditions(FileWriteTable, ["session_id"]),
|
|
88
|
+
params: [sessionId],
|
|
89
|
+
orderBy: `ORDER BY ${quoted(FileWriteTable, "write_id")} DESC`,
|
|
90
|
+
limit,
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
}
|