@unbrained/pm-cli 2026.9.7 → 2026.9.9
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/.agents/skills/pm-developer/SKILL.md +12 -4
- package/.agents/skills/pm-developer/references/MULTI_AGENT_MERGE.md +19 -10
- package/.agents/skills/pm-extensions/SKILL.md +6 -0
- package/.agents/skills/pm-sdk/SKILL.md +11 -2
- package/.agents/skills/pm-user/SKILL.md +7 -2
- package/.agents/skills/pm-user/references/ECOSYSTEM_PLANNING.md +95 -0
- package/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +231 -182
- package/dist/cli/after-command-context-usage.js +1 -48
- package/dist/cli/argv-utils.js +1 -40
- package/dist/cli/bootstrap-args.js +1 -9
- package/dist/cli/bundle-integrity.js +2 -110
- package/dist/cli/commander-usage.js +11 -771
- package/dist/cli/commands/activity.js +1 -9
- package/dist/cli/commands/aggregate.js +1 -5
- package/dist/cli/commands/append.js +1 -5
- package/dist/cli/commands/claim.js +1 -5
- package/dist/cli/commands/close-many.js +1 -5
- package/dist/cli/commands/close.js +1 -9
- package/dist/cli/commands/comments.js +1 -5
- package/dist/cli/commands/config.js +1 -9
- package/dist/cli/commands/context.js +1 -9
- package/dist/cli/commands/contracts.js +1 -5
- package/dist/cli/commands/copy.js +1 -9
- package/dist/cli/commands/create.js +1 -9
- package/dist/cli/commands/delete.js +1 -9
- package/dist/cli/commands/deps.js +1 -9
- package/dist/cli/commands/docs.js +1 -9
- package/dist/cli/commands/duplicates.js +1 -9
- package/dist/cli/commands/eval.js +1 -9
- package/dist/cli/commands/extension/describe.js +1 -5
- package/dist/cli/commands/extension/scaffold.js +1 -5
- package/dist/cli/commands/extension/shared.js +1 -5
- package/dist/cli/commands/extension.js +1 -9
- package/dist/cli/commands/files.js +1 -9
- package/dist/cli/commands/focus.js +1 -9
- package/dist/cli/commands/gc.js +1 -9
- package/dist/cli/commands/get.js +1 -9
- package/dist/cli/commands/graph.js +1 -10
- package/dist/cli/commands/health.js +1 -9
- package/dist/cli/commands/history-compact.js +1 -10
- package/dist/cli/commands/history-redact.js +1 -11
- package/dist/cli/commands/history-repair.js +1 -10
- package/dist/cli/commands/history.js +1 -5
- package/dist/cli/commands/index.js +1 -58
- package/dist/cli/commands/init-agent-guidance.js +1 -9
- package/dist/cli/commands/init.js +1 -9
- package/dist/cli/commands/learnings.js +1 -5
- package/dist/cli/commands/lifecycle-transitions.js +1 -5
- package/dist/cli/commands/list.js +1 -9
- package/dist/cli/commands/merge.js +1 -11
- package/dist/cli/commands/next.js +1 -9
- package/dist/cli/commands/notes.js +1 -5
- package/dist/cli/commands/plan.js +1 -9
- package/dist/cli/commands/profile.js +1 -9
- package/dist/cli/commands/restore.js +1 -9
- package/dist/cli/commands/scheduling-shortcuts.js +1 -9
- package/dist/cli/commands/schema.js +1 -10
- package/dist/cli/commands/search.js +1 -9
- package/dist/cli/commands/stats.js +1 -9
- package/dist/cli/commands/telemetry.js +1 -9
- package/dist/cli/commands/test-all.js +1 -9
- package/dist/cli/commands/test-runs.js +1 -9
- package/dist/cli/commands/test.js +1 -9
- package/dist/cli/commands/update-many.js +1 -5
- package/dist/cli/commands/update.js +1 -9
- package/dist/cli/commands/upgrade.js +1 -5
- package/dist/cli/commands/validate.js +1 -15
- package/dist/cli/context-intent-invocation.js +1 -20
- package/dist/cli/description-stdin.js +1 -17
- package/dist/cli/error-guidance.js +1 -1353
- package/dist/cli/extension-command-help.js +5 -636
- package/dist/cli/extension-command-options.js +1 -427
- package/dist/cli/extension-recovery.js +1 -126
- package/dist/cli/help-content.js +2 -1001
- package/dist/cli/help-json-payload.js +4 -570
- package/dist/cli/main.d.ts +4 -0
- package/dist/cli/main.js +5 -2573
- package/dist/cli/migration-gates.js +1 -289
- package/dist/cli/public.js +1 -20
- package/dist/cli/register-annotations.js +1 -270
- package/dist/cli/register-assurance.js +1 -62
- package/dist/cli/register-files-lookup.js +1 -56
- package/dist/cli/register-history-activity.d.ts +8 -0
- package/dist/cli/register-history-activity.js +2 -0
- package/dist/cli/register-history-author.js +1 -38
- package/dist/cli/register-history-maintenance.d.ts +9 -0
- package/dist/cli/register-history-maintenance.js +2 -0
- package/dist/cli/register-list-query.js +10 -943
- package/dist/cli/register-mutation-options.js +1 -9
- package/dist/cli/register-mutation.d.ts +0 -5
- package/dist/cli/register-mutation.js +19 -1893
- package/dist/cli/register-operations.js +1 -920
- package/dist/cli/register-setup.js +1 -716
- package/dist/cli/register-structured-mutation.js +1 -196
- package/dist/cli/registration-helpers.js +1 -5
- package/dist/cli/runtime-compatibility-boundary.js +4 -42
- package/dist/cli/schema-registration-helpers.js +1 -73
- package/dist/cli/search-refresh.js +1 -13
- package/dist/cli/stats-analytics-json.js +1 -68
- package/dist/cli/telemetry-flush.js +1 -10
- package/dist/cli-bundle/bundle-manifest.json +164 -156
- package/dist/cli-bundle/chunks/{chunk-NPN5I67J.js → chunk-3IPRM75M.js} +3 -3
- package/dist/cli-bundle/chunks/chunk-4VL5P22L.js +2 -0
- package/dist/cli-bundle/chunks/chunk-AAFBV3U3.js +29 -0
- package/dist/cli-bundle/chunks/chunk-D3YVILJJ.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-WYRZZ5ZE.js → chunk-DEZPZOQ7.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-ECBLPN7B.js +3 -0
- package/dist/cli-bundle/chunks/chunk-J6ERHBV2.js +235 -0
- package/dist/cli-bundle/chunks/chunk-JUNJ5EKI.js +2 -0
- package/dist/cli-bundle/chunks/chunk-L5RCDKQ2.js +2 -0
- package/dist/cli-bundle/chunks/chunk-NSAPNEYH.js +2 -0
- package/dist/cli-bundle/chunks/chunk-OHNLSGGV.js +79 -0
- package/dist/cli-bundle/chunks/chunk-WQKMSFBV.js +5 -0
- package/dist/cli-bundle/chunks/{chunk-BAX2BYUW.js → chunk-XZ6T7YPP.js} +256 -150
- package/dist/cli-bundle/chunks/{chunk-JT6XF6GE.js → chunk-Z3XVXUVF.js} +4 -4
- package/dist/cli-bundle/chunks/register-list-query-UIHRCS6D.js +11 -0
- package/dist/cli-bundle/chunks/register-mutation-WHWMGRVX.js +20 -0
- package/dist/cli-bundle/chunks/register-operations-64YZYTC5.js +2 -0
- package/dist/cli-bundle/chunks/register-setup-PERI45EM.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-2W4XIYOB.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-2WSBXIGF.js +12 -0
- package/dist/cli-bundle/focused-chunks/chunk-5FHTCOHS.js +3 -0
- package/dist/cli-bundle/focused-chunks/chunk-7N6DOREF.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-3BZEOXLT.js → chunk-7PC4R5QB.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-BUCJUZVG.js +6 -0
- package/dist/cli-bundle/focused-chunks/chunk-FE3BABLJ.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-IWITF53W.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-OQUGRHKV.js +10 -0
- package/dist/cli-bundle/focused-chunks/{chunk-M6PBRFSH.js → chunk-PNKIANFZ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-LIJIA4TY.js → chunk-QQQ4SAUO.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-TTYXF5YD.js +177 -0
- package/dist/cli-bundle/focused-chunks/chunk-XNR3DM6J.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-XSS3APUF.js +9 -0
- package/dist/cli-bundle/focused-chunks/chunk-YCDQ2N23.js +8 -0
- package/dist/cli-bundle/focused-chunks/chunk-YJUXGS57.js +20 -0
- package/dist/cli-bundle/focused-chunks/chunk-ZTCE4UO6.js +58 -0
- package/dist/cli-bundle/main.js +20 -20
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +37 -37
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +42 -42
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +11 -11
- package/dist/cli.js +1 -104
- package/dist/core/checkpoint/checkpoint-gc.js +1 -169
- package/dist/core/checkpoint/mutation-checkpoint.js +2 -133
- package/dist/core/config/nested-settings.js +1 -534
- package/dist/core/config/positional-value.js +1 -109
- package/dist/core/diagnostics/remediation.js +1 -506
- package/dist/core/extensions/activation-summary-markdown.js +2 -145
- package/dist/core/extensions/activation-summary.js +1 -92
- package/dist/core/extensions/activation-transaction.js +1 -46
- package/dist/core/extensions/capability-usage.js +1 -173
- package/dist/core/extensions/command-hook-context.js +1 -13
- package/dist/core/extensions/command-metadata-contract.js +1 -22
- package/dist/core/extensions/command-visibility-tier.js +1 -29
- package/dist/core/extensions/contribution-inventory.js +1 -173
- package/dist/core/extensions/exporter-output-contract.js +1 -66
- package/dist/core/extensions/extension-candidate.js +1 -18
- package/dist/core/extensions/extension-capability-aliases.js +1 -158
- package/dist/core/extensions/extension-hook-runtime.js +1 -699
- package/dist/core/extensions/extension-policy.js +1 -599
- package/dist/core/extensions/extension-registries.js +1 -62
- package/dist/core/extensions/extension-runtime-helpers.js +1 -33
- package/dist/core/extensions/extension-types.js +1 -102
- package/dist/core/extensions/flag-definition-validation.js +1 -52
- package/dist/core/extensions/flag-value-types.js +1 -64
- package/dist/core/extensions/index.js +1 -526
- package/dist/core/extensions/item-field-types.js +1 -39
- package/dist/core/extensions/item-fields.js +1 -261
- package/dist/core/extensions/loader.js +1 -2223
- package/dist/core/extensions/manifest-schema.js +1 -69
- package/dist/core/extensions/module-graph-snapshot.js +1 -33
- package/dist/core/extensions/preflight-ownership.js +1 -41
- package/dist/core/extensions/registration-validation.js +1 -82
- package/dist/core/extensions/registration-values.js +1 -209
- package/dist/core/extensions/reserved-host-flags.js +1 -36
- package/dist/core/extensions/runtime-registrations.js +1 -67
- package/dist/core/extensions/service-ownership.js +1 -19
- package/dist/core/extensions/version-compat.js +1 -216
- package/dist/core/fs/fs-utils.js +2 -158
- package/dist/core/fs/host-environment-errors.js +1 -141
- package/dist/core/fs/index.js +1 -9
- package/dist/core/fs/path-utils.js +1 -17
- package/dist/core/governance/content-fields.js +1 -160
- package/dist/core/governance/issue-codes.js +1 -151
- package/dist/core/governance/metadata-coverage.js +1 -358
- package/dist/core/history/drift-cache.js +3 -72
- package/dist/core/history/drift-scan.js +1 -342
- package/dist/core/history/event-classification.js +1 -109
- package/dist/core/history/event-index.js +8 -784
- package/dist/core/history/history-compact-bulk.js +1 -104
- package/dist/core/history/history-diff.js +1 -158
- package/dist/core/history/history-rewrite.d.ts +6 -1
- package/dist/core/history/history-rewrite.js +1 -107
- package/dist/core/history/history-storage-stats.js +1 -102
- package/dist/core/history/history-stream-policy.js +1 -62
- package/dist/core/history/history.js +2 -617
- package/dist/core/history/identity.js +1 -30
- package/dist/core/history/index.js +1 -9
- package/dist/core/history/projection.js +1 -196
- package/dist/core/history/read.d.ts +9 -0
- package/dist/core/history/read.js +1 -57
- package/dist/core/history/replay.js +2 -439
- package/dist/core/history/version-address.js +1 -32
- package/dist/core/history/workspace-history.js +2 -433
- package/dist/core/io/body-file.js +1 -62
- package/dist/core/io/bulk-ids-input.js +1 -112
- package/dist/core/item/actionability.js +1 -327
- package/dist/core/item/dependency-reference.js +1 -20
- package/dist/core/item/id.js +1 -112
- package/dist/core/item/index.js +1 -12
- package/dist/core/item/item-format-version.js +1 -78
- package/dist/core/item/item-format.js +5 -1473
- package/dist/core/item/item-record.js +1 -23
- package/dist/core/item/item-type-definition.js +1 -133
- package/dist/core/item/parent-reference-policy.js +1 -57
- package/dist/core/item/parse.js +2 -603
- package/dist/core/item/plan-lifecycle.js +1 -19
- package/dist/core/item/priority.js +1 -61
- package/dist/core/item/sprint-release-format.js +1 -38
- package/dist/core/item/status-filter.js +1 -115
- package/dist/core/item/status.js +1 -43
- package/dist/core/item/toon-decode.js +1 -29
- package/dist/core/item/type-registry.js +1 -715
- package/dist/core/item/type-synonyms.js +1 -38
- package/dist/core/lock/index.js +1 -9
- package/dist/core/lock/lock-gc.js +1 -240
- package/dist/core/lock/lock.js +3 -590
- package/dist/core/output/mutation-projection.js +1 -217
- package/dist/core/output/output-control.js +1 -25
- package/dist/core/output/output.js +11 -494
- package/dist/core/output/query-summary.js +1 -58
- package/dist/core/output/tabular.js +1 -77
- package/dist/core/packages/manifest.js +1 -244
- package/dist/core/packages/root.js +1 -84
- package/dist/core/policy/workflow-policy-schema.d.ts +312 -0
- package/dist/core/policy/workflow-policy-schema.js +2 -0
- package/dist/core/policy/workflow-policy-store.d.ts +24 -0
- package/dist/core/policy/workflow-policy-store.js +2 -0
- package/dist/core/policy/workflow-policy.d.ts +139 -0
- package/dist/core/policy/workflow-policy.js +2 -0
- package/dist/core/profile/profile-describe.js +1 -83
- package/dist/core/profile/profile-lint.js +1 -415
- package/dist/core/profile/profile-plan.js +0 -0
- package/dist/core/profile/profile-presets.js +1 -370
- package/dist/core/reproducibility/context.js +1 -82
- package/dist/core/schema/fields-file.js +2 -288
- package/dist/core/schema/item-types-file.js +2 -296
- package/dist/core/schema/runtime-field-filters.js +1 -49
- package/dist/core/schema/runtime-field-values.js +1 -313
- package/dist/core/schema/runtime-schema.js +2 -826
- package/dist/core/schema/status-defs-file.js +2 -227
- package/dist/core/schema/status-token.js +1 -31
- package/dist/core/schema/type-inference.js +1 -95
- package/dist/core/schema/type-presets.js +1 -87
- package/dist/core/schema/type-workflows.js +1 -104
- package/dist/core/search/background-refresh.js +2 -286
- package/dist/core/search/bm25.js +1 -146
- package/dist/core/search/cache.js +2 -534
- package/dist/core/search/corpus.js +1 -311
- package/dist/core/search/embedding-batches.js +1 -163
- package/dist/core/search/eval.js +1 -225
- package/dist/core/search/http-client.js +1 -75
- package/dist/core/search/providers.js +1 -242
- package/dist/core/search/relevance.js +1 -244
- package/dist/core/search/semantic-defaults.js +1 -199
- package/dist/core/search/staleness.js +1 -30
- package/dist/core/search/vector-stores.js +2 -664
- package/dist/core/search/vectorization-metadata.js +1 -81
- package/dist/core/sentry/helpers.js +1 -272
- package/dist/core/sentry/instrument.js +1 -387
- package/dist/core/session/session-state.js +1 -260
- package/dist/core/shared/agent-session-context.js +1 -133
- package/dist/core/shared/author.js +1 -1172
- package/dist/core/shared/command-types.js +1 -4
- package/dist/core/shared/conflict-markers.js +1 -31
- package/dist/core/shared/constants.js +1 -405
- package/dist/core/shared/errors.js +1 -20
- package/dist/core/shared/html-entity-decode.js +1 -131
- package/dist/core/shared/index.js +1 -12
- package/dist/core/shared/item-metadata-contract.js +1 -89
- package/dist/core/shared/lazy-module.js +1 -16
- package/dist/core/shared/levenshtein.js +1 -61
- package/dist/core/shared/memo.js +1 -19
- package/dist/core/shared/numeric-parsers.js +1 -20
- package/dist/core/shared/option-alias-visibility.js +1 -67
- package/dist/core/shared/primitives.js +1 -127
- package/dist/core/shared/serial-queue.js +1 -79
- package/dist/core/shared/serialization.js +1 -210
- package/dist/core/shared/split-comma-list.js +1 -30
- package/dist/core/shared/text-normalization.js +1 -38
- package/dist/core/shared/time.js +1 -306
- package/dist/core/store/index.js +1 -12
- package/dist/core/store/item-format-migration.js +1 -125
- package/dist/core/store/item-metadata-cache.js +1 -1116
- package/dist/core/store/item-metadata-query-index.js +9 -394
- package/dist/core/store/item-metadata-read-work.js +1 -43
- package/dist/core/store/item-store.js +1 -693
- package/dist/core/store/paths.d.ts +1 -1
- package/dist/core/store/paths.js +1 -214
- package/dist/core/store/settings-read-cache.js +1 -85
- package/dist/core/store/settings-validator.d.ts +1 -0
- package/dist/core/store/settings-validator.js +1 -421
- package/dist/core/store/settings.js +3 -1309
- package/dist/core/store/tracker-preflight.js +1 -141
- package/dist/core/telemetry/consent.js +5 -108
- package/dist/core/telemetry/observability.js +1 -246
- package/dist/core/telemetry/runtime.js +4 -1988
- package/dist/core/test/background-runs.js +4 -945
- package/dist/core/test/item-test-run-tracking.js +1 -63
- package/dist/core/test/run-selectors.js +1 -120
- package/dist/core/validate/estimate-defaults.js +1 -89
- package/dist/core/validate/fix-planning.js +1 -189
- package/dist/core/validate/linked-artifact-reference.js +1 -36
- package/dist/core/validate/missing-by-type.js +1 -34
- package/dist/core/validate/missing-link-owners.js +1 -95
- package/dist/core/validate/stale-file-classification.js +1 -82
- package/dist/mcp/http-server.js +5 -448
- package/dist/mcp/legacy-adapter.js +1 -77
- package/dist/mcp/runtime-capabilities.js +1 -200
- package/dist/mcp/server.js +4 -1233
- package/dist/mcp/tool-definitions.js +1 -804
- package/dist/sdk/actionability.js +1 -13
- package/dist/sdk/agent/closed-domain-contracts.js +1 -161
- package/dist/sdk/agent/command-recovery.js +1 -59
- package/dist/sdk/agent/command-suggestions.js +1 -66
- package/dist/sdk/agent/create-option-policy.js +1 -31
- package/dist/sdk/agent/identity-config.js +1 -106
- package/dist/sdk/agent/item-addressing.js +1 -207
- package/dist/sdk/agent/refusal-closure-census.js +1 -151
- package/dist/sdk/agent/refusal-closure.js +1 -133
- package/dist/sdk/agent/refusal-corpus-contracts.js +1 -193
- package/dist/sdk/agent/refusal-reachability.js +1 -593
- package/dist/sdk/agent/subcommand-recovery.js +1 -83
- package/dist/sdk/agent/task-transcript-contracts.js +1 -197
- package/dist/sdk/agent/tracker-preflight-contracts.js +1 -126
- package/dist/sdk/agent-capability-contracts.js +1 -428
- package/dist/sdk/agent-session-context.js +1 -9
- package/dist/sdk/annotations.js +1 -448
- package/dist/sdk/author-attribution.js +1 -468
- package/dist/sdk/authoring.js +1 -20
- package/dist/sdk/cli-bootstrap.js +1 -838
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts/agent-output-contracts.js +4 -476
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.js +1 -79
- package/dist/sdk/cli-contracts/command-aliases.d.ts +4 -0
- package/dist/sdk/cli-contracts/command-aliases.js +1 -107
- package/dist/sdk/cli-contracts/command-exit-contracts.js +1 -151
- package/dist/sdk/cli-contracts/commander-mutation-options.js +1 -1081
- package/dist/sdk/cli-contracts/commander-types.js +1 -159
- package/dist/sdk/cli-contracts/completeness.js +1 -393
- package/dist/sdk/cli-contracts/enum-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts/enum-contracts.js +1 -222
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1947
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -347
- package/dist/sdk/cli-contracts/grammar-contracts.js +1 -986
- package/dist/sdk/cli-contracts/registration-helpers.js +7 -990
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +5 -0
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -2090
- package/dist/sdk/cli-contracts/schemas/assurance-definition.js +1 -324
- package/dist/sdk/cli-contracts/string-lists.js +1 -16
- package/dist/sdk/cli-contracts/tool-option-contracts.js +1 -461
- package/dist/sdk/cli-contracts/tool-parameter-tables.js +1 -2167
- package/dist/sdk/cli-contracts/tool-schema.d.ts +3 -1
- package/dist/sdk/cli-contracts/tool-schema.js +1 -1664
- package/dist/sdk/cli-contracts/typed-action-inputs.js +1 -4
- package/dist/sdk/cli-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts.js +1 -17
- package/dist/sdk/cli-program.js +1 -49
- package/dist/sdk/command-line.d.ts +2 -5
- package/dist/sdk/command-line.js +1 -78
- package/dist/sdk/comments.js +1 -133
- package/dist/sdk/compile-cache.js +1 -73
- package/dist/sdk/completion.js +174 -839
- package/dist/sdk/compose.js +1 -1090
- package/dist/sdk/config.js +1 -1204
- package/dist/sdk/context/recency.js +1 -33
- package/dist/sdk/context/semantic-session-attribution.js +1 -82
- package/dist/sdk/context/usage-egress.js +1 -29
- package/dist/sdk/context/usage-ledger.js +3 -185
- package/dist/sdk/context-intent-contracts.js +1 -709
- package/dist/sdk/context-intent-runtime.js +1 -115
- package/dist/sdk/context-packing.js +1 -218
- package/dist/sdk/context-relevance.js +1 -503
- package/dist/sdk/context-signal-store.js +2 -426
- package/dist/sdk/context-usage.js +1 -367
- package/dist/sdk/contracts.js +1 -23
- package/dist/sdk/core-governance.js +1 -14
- package/dist/sdk/core.js +1 -14
- package/dist/sdk/corpus-shape.js +1 -401
- package/dist/sdk/define.js +1 -220
- package/dist/sdk/dependencies.js +1 -718
- package/dist/sdk/dependency-flag-validation.js +1 -156
- package/dist/sdk/dependency-provenance.js +1 -135
- package/dist/sdk/docs.js +1 -14
- package/dist/sdk/duplicates.js +1 -40
- package/dist/sdk/environment/agent-environment.js +1 -466
- package/dist/sdk/environment/host-environment-errors.js +1 -8
- package/dist/sdk/environment/project-runtime-compatibility.js +1 -481
- package/dist/sdk/environment/source-context.js +1 -28
- package/dist/sdk/environment/tracker-preflight.js +1 -9
- package/dist/sdk/error-code-catalog.js +1 -153
- package/dist/sdk/error-runtime.js +1 -58
- package/dist/sdk/errors.js +1 -58
- package/dist/sdk/eval.js +1 -190
- package/dist/sdk/extension/author-manifest.js +1 -92
- package/dist/sdk/extension/bundled-catalog.js +1 -332
- package/dist/sdk/extension/concurrency.js +1 -25
- package/dist/sdk/extension/copy-scope.d.ts +2 -0
- package/dist/sdk/extension/copy-scope.js +2 -0
- package/dist/sdk/extension/custom-field-collisions.js +1 -30
- package/dist/sdk/extension/describe.js +3 -189
- package/dist/sdk/extension/doctor.js +1 -606
- package/dist/sdk/extension/install-plan.d.ts +69 -0
- package/dist/sdk/extension/install-plan.js +2 -0
- package/dist/sdk/extension/install-receipts.d.ts +7 -0
- package/dist/sdk/extension/install-receipts.js +2 -0
- package/dist/sdk/extension/install-runtime.js +3 -313
- package/dist/sdk/extension/install-snapshot.js +1 -66
- package/dist/sdk/extension/install-sources.js +5 -1057
- package/dist/sdk/extension/managed-state.js +2 -252
- package/dist/sdk/extension/migrations.js +2 -174
- package/dist/sdk/extension/output-ownership.js +1 -25
- package/dist/sdk/extension/runtime-summary.js +1 -18
- package/dist/sdk/extension/scaffold.js +4 -2308
- package/dist/sdk/extension/shared.js +1 -147
- package/dist/sdk/extension/source-resolution.js +1 -65
- package/dist/sdk/extension/update-check.js +1 -67
- package/dist/sdk/extension-command-context.js +1 -44
- package/dist/sdk/extension-contracts.js +1 -73
- package/dist/sdk/extension.d.ts +7 -2
- package/dist/sdk/extension.js +1 -2196
- package/dist/sdk/files.js +1 -535
- package/dist/sdk/flag-invocation-contracts.d.ts +0 -5
- package/dist/sdk/flag-invocation-contracts.js +1 -344
- package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -2224
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -2236
- package/dist/sdk/generated-error-code-catalog.js +1 -16
- package/dist/sdk/governance/assurance-action-contracts.js +1 -4
- package/dist/sdk/governance/assurance-action.js +1 -411
- package/dist/sdk/governance/assurance-limits.js +1 -10
- package/dist/sdk/governance/assurance-mutation-error.js +1 -81
- package/dist/sdk/governance/assurance-presets.js +1 -135
- package/dist/sdk/governance/assurance-runtime.js +1 -238
- package/dist/sdk/governance/assurance.js +4 -1182
- package/dist/sdk/governance/boundary-fixtures.js +1 -200
- package/dist/sdk/governance/coverage-assurance.js +1 -60
- package/dist/sdk/governance/defect-recurrence-coverage.js +1 -188
- package/dist/sdk/governance/defect-recurrence-graph.js +1 -120
- package/dist/sdk/governance/defect-recurrence-signals.js +1 -24
- package/dist/sdk/governance/defect-recurrence.js +1 -623
- package/dist/sdk/governance/extension-host-version.js +1 -115
- package/dist/sdk/governance/gc.js +1 -368
- package/dist/sdk/governance/health.js +1 -2367
- package/dist/sdk/governance/hierarchy-validation.js +1 -108
- package/dist/sdk/governance/linked-file-report.js +1 -71
- package/dist/sdk/governance/merge-receipt-history.js +1 -206
- package/dist/sdk/governance/provenance-health.js +1 -282
- package/dist/sdk/governance/reindex.js +4 -761
- package/dist/sdk/governance/stale-work.js +1 -82
- package/dist/sdk/governance/status-role-diagnostics.js +1 -35
- package/dist/sdk/governance/storage-integrity.js +1 -280
- package/dist/sdk/governance/tracked-runtime-cache.js +1 -106
- package/dist/sdk/governance/upgrade.js +2 -327
- package/dist/sdk/governance/validate-history-drift.js +1 -81
- package/dist/sdk/governance/validate-item-reader.js +1 -17
- package/dist/sdk/governance/validate-normalization.js +1 -36
- package/dist/sdk/governance/validate.d.ts +3 -1
- package/dist/sdk/governance/validate.js +1 -2261
- package/dist/sdk/governance/workflow-completeness.d.ts +32 -0
- package/dist/sdk/governance/workflow-completeness.js +2 -0
- package/dist/sdk/governance/workflow-policy.d.ts +47 -0
- package/dist/sdk/governance/workflow-policy.js +4 -0
- package/dist/sdk/governance/workspace-position.js +1 -163
- package/dist/sdk/governance.d.ts +2 -0
- package/dist/sdk/governance.js +1 -31
- package/dist/sdk/graph/adapter.js +1 -181
- package/dist/sdk/graph/analytics.js +1 -474
- package/dist/sdk/graph/assembly.js +1 -377
- package/dist/sdk/graph/cache.js +1 -160
- package/dist/sdk/graph/centrality.js +1 -258
- package/dist/sdk/graph/conformance.js +1 -130
- package/dist/sdk/graph/deadline-scheduling.d.ts +90 -0
- package/dist/sdk/graph/deadline-scheduling.js +2 -0
- package/dist/sdk/graph/durable-cache.d.ts +1 -1
- package/dist/sdk/graph/durable-cache.js +1 -361
- package/dist/sdk/graph/governance-contracts.js +1 -34
- package/dist/sdk/graph/governance.d.ts +13 -1
- package/dist/sdk/graph/governance.js +1 -735
- package/dist/sdk/graph/hierarchy-integrity.js +1 -310
- package/dist/sdk/graph/index.d.ts +3 -2
- package/dist/sdk/graph/index.js +1 -26
- package/dist/sdk/graph/lifecycle-coverage.d.ts +32 -0
- package/dist/sdk/graph/lifecycle-coverage.js +2 -0
- package/dist/sdk/graph/mutation-advisory.js +1 -176
- package/dist/sdk/graph/remediation.js +1 -197
- package/dist/sdk/graph/run.d.ts +15 -1
- package/dist/sdk/graph/run.js +1 -768
- package/dist/sdk/graph/scheduling.js +1 -124
- package/dist/sdk/graph/traversal.js +1 -284
- package/dist/sdk/graph/workspace-relationship-kind-registry.js +1 -27
- package/dist/sdk/graph.js +1 -15
- package/dist/sdk/guide-topics.js +1 -707
- package/dist/sdk/guide.js +1 -279
- package/dist/sdk/history/maintenance.d.ts +71 -0
- package/dist/sdk/history/maintenance.js +2 -0
- package/dist/sdk/history/salvage.js +2 -247
- package/dist/sdk/history/subject.d.ts +19 -0
- package/dist/sdk/history/subject.js +2 -0
- package/dist/sdk/history-analytics.js +1 -282
- package/dist/sdk/history-compact.js +1 -527
- package/dist/sdk/history-mcp.js +1 -68
- package/dist/sdk/history-provenance.js +1 -182
- package/dist/sdk/history-read.js +1 -96
- package/dist/sdk/history-redact.d.ts +1 -14
- package/dist/sdk/history-redact.js +1 -643
- package/dist/sdk/history-repair.d.ts +5 -0
- package/dist/sdk/history-repair.js +1 -657
- package/dist/sdk/improvement-ledger-validation.js +1 -62
- package/dist/sdk/improvement-ledger.js +2 -257
- package/dist/sdk/index.d.ts +4 -1
- package/dist/sdk/index.js +1 -183
- package/dist/sdk/init-agent-guidance.js +2 -496
- package/dist/sdk/init.js +2 -820
- package/dist/sdk/invocation-author.js +1 -39
- package/dist/sdk/item-children.js +1 -90
- package/dist/sdk/item-metadata-index.js +1 -15
- package/dist/sdk/item-schedule.js +1 -27
- package/dist/sdk/item-transaction.js +1 -396
- package/dist/sdk/learnings.js +1 -29
- package/dist/sdk/lifecycle/append.js +2 -53
- package/dist/sdk/lifecycle/claim.d.ts +2 -0
- package/dist/sdk/lifecycle/claim.js +1 -242
- package/dist/sdk/lifecycle/close-many.js +1 -438
- package/dist/sdk/lifecycle/close.js +1 -468
- package/dist/sdk/lifecycle/copy.js +1 -212
- package/dist/sdk/lifecycle/create.js +1 -1949
- package/dist/sdk/lifecycle/delete.js +1 -45
- package/dist/sdk/lifecycle/event-validation-messages.js +1 -91
- package/dist/sdk/lifecycle/focus.js +1 -91
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.js +1 -24
- package/dist/sdk/lifecycle/legacy-none-tokens.js +1 -149
- package/dist/sdk/lifecycle/lifecycle-transitions.js +1 -40
- package/dist/sdk/lifecycle/mcp-actions.d.ts +2 -0
- package/dist/sdk/lifecycle/mcp-actions.js +1 -51
- package/dist/sdk/lifecycle/metadata-normalizers.js +1 -46
- package/dist/sdk/lifecycle/mutation-command-options.js +1 -9
- package/dist/sdk/lifecycle/plan.js +1 -1606
- package/dist/sdk/lifecycle/recurrence-parsers.d.ts +1 -1
- package/dist/sdk/lifecycle/recurrence-parsers.js +1 -147
- package/dist/sdk/lifecycle/reopen.js +1 -68
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.js +1 -143
- package/dist/sdk/lifecycle/restore.d.ts +1 -0
- package/dist/sdk/lifecycle/restore.js +1 -330
- package/dist/sdk/lifecycle/shared-unset-fields.js +1 -295
- package/dist/sdk/lifecycle/update-many.js +1 -861
- package/dist/sdk/lifecycle/update.js +1 -2136
- package/dist/sdk/lifecycle-completion.js +1 -92
- package/dist/sdk/lifecycle-policy.js +1 -120
- package/dist/sdk/linked-artifacts.js +1 -530
- package/dist/sdk/mcp/apps.js +4 -133
- package/dist/sdk/mcp/authorization.js +1 -404
- package/dist/sdk/mcp/discovery.js +1 -494
- package/dist/sdk/mcp/interactions.js +1 -336
- package/dist/sdk/mcp/protocol.d.ts +7 -0
- package/dist/sdk/mcp/protocol.js +1 -184
- package/dist/sdk/mcp/skills.js +1 -389
- package/dist/sdk/mcp/subscriptions.js +1 -211
- package/dist/sdk/mcp/tasks.js +2 -430
- package/dist/sdk/mcp/transport.js +1 -260
- package/dist/sdk/merge/abandoned-receipts.js +1 -46
- package/dist/sdk/merge/driver.js +1 -212
- package/dist/sdk/merge/index.js +1 -16
- package/dist/sdk/merge/install.js +3 -561
- package/dist/sdk/merge/receipt-file-boundary.js +1 -46
- package/dist/sdk/merge/receipt-operation.js +1 -96
- package/dist/sdk/merge/receipt-schema.js +1 -397
- package/dist/sdk/merge/receipts.js +4 -525
- package/dist/sdk/merge/reconcile.js +1 -352
- package/dist/sdk/merge/three-way.js +3 -775
- package/dist/sdk/merge.js +1 -10
- package/dist/sdk/mutation-events.js +1 -292
- package/dist/sdk/mutation-guard.js +1 -216
- package/dist/sdk/notes.js +1 -139
- package/dist/sdk/output-contracts.js +1 -172
- package/dist/sdk/output-projection.js +1 -430
- package/dist/sdk/output-token-accounting.js +1 -140
- package/dist/sdk/output.js +1 -64
- package/dist/sdk/ownership-source.js +1 -21
- package/dist/sdk/package-import-adapters.js +1 -442
- package/dist/sdk/package-migrations.js +1 -20
- package/dist/sdk/package-runtime-options.js +1 -80
- package/dist/sdk/pagination.js +1 -162
- package/dist/sdk/profile.js +1 -454
- package/dist/sdk/provenance.js +1 -258
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.js +1 -401
- package/dist/sdk/query/aggregate.d.ts +16 -0
- package/dist/sdk/query/aggregate.js +1 -390
- package/dist/sdk/query/calendar.js +1 -964
- package/dist/sdk/query/complete-list.js +1 -215
- package/dist/sdk/query/context.js +1 -1702
- package/dist/sdk/query/duplicate-candidates.js +1 -70
- package/dist/sdk/query/get.js +1 -450
- package/dist/sdk/query/history.js +1 -186
- package/dist/sdk/query/item-filter-options.js +1 -9
- package/dist/sdk/query/light-metadata.js +1 -18
- package/dist/sdk/query/list-filter-shared.js +1 -81
- package/dist/sdk/query/list.js +1 -1304
- package/dist/sdk/query/multi-value-filters.js +1 -78
- package/dist/sdk/query/next.js +1 -513
- package/dist/sdk/query/parsers.js +1 -44
- package/dist/sdk/query/projection-contracts.js +1 -184
- package/dist/sdk/query/search-contracts.d.ts +27 -0
- package/dist/sdk/query/search-contracts.js +1 -230
- package/dist/sdk/query/search-pagination.js +1 -35
- package/dist/sdk/query/search-rendering.js +1 -105
- package/dist/sdk/query/search.d.ts +6 -4
- package/dist/sdk/query/search.js +2 -1987
- package/dist/sdk/query.js +1 -35
- package/dist/sdk/read-output/continuation.js +1 -194
- package/dist/sdk/read-output-budget.js +1 -135
- package/dist/sdk/read-output-contracts.d.ts +1 -1
- package/dist/sdk/read-output-contracts.js +1 -1225
- package/dist/sdk/read-output-rows.js +1 -186
- package/dist/sdk/read-output-session.js +1 -208
- package/dist/sdk/relationship-analytics.js +1 -410
- package/dist/sdk/relationship-context.js +1 -284
- package/dist/sdk/relationship-history.js +4 -519
- package/dist/sdk/relationship-kinds/contract.js +1 -22
- package/dist/sdk/relationship-migration.js +1 -77
- package/dist/sdk/relationships.js +1 -579
- package/dist/sdk/reproducibility/process.js +1 -87
- package/dist/sdk/runtime-action-aliases.js +1 -59
- package/dist/sdk/runtime-extended-actions.js +1 -177
- package/dist/sdk/runtime-input.js +1 -614
- package/dist/sdk/runtime-primitives.js +1 -84
- package/dist/sdk/runtime-public-contracts.d.ts +2 -1
- package/dist/sdk/runtime-public-contracts.js +1 -4
- package/dist/sdk/runtime-stats-options.js +1 -38
- package/dist/sdk/runtime.d.ts +4 -0
- package/dist/sdk/runtime.js +1 -1928
- package/dist/sdk/scheduling-shortcuts.js +1 -63
- package/dist/sdk/schema-migration.js +3 -856
- package/dist/sdk/schema.d.ts +2 -1
- package/dist/sdk/schema.js +1 -1376
- package/dist/sdk/search-refresh-worker.js +1 -18
- package/dist/sdk/similarity-scoring.js +1 -53
- package/dist/sdk/similarity.js +1 -326
- package/dist/sdk/start-task-status.js +1 -14
- package/dist/sdk/stats.js +1 -270
- package/dist/sdk/structured-mutations.js +1 -580
- package/dist/sdk/telemetry-flush.js +1 -13
- package/dist/sdk/telemetry.js +1 -405
- package/dist/sdk/templates.js +2 -292
- package/dist/sdk/test/batch.js +2 -509
- package/dist/sdk/test/entry.js +1 -70
- package/dist/sdk/test/execution.js +6 -2211
- package/dist/sdk/test/linked-command-detection.js +1 -546
- package/dist/sdk/test/measurements.js +1 -91
- package/dist/sdk/test/parsers.js +1 -545
- package/dist/sdk/test/runs.js +1 -193
- package/dist/sdk/test/trust.js +2 -206
- package/dist/sdk/testing.js +4 -1391
- package/dist/sdk/traceability/runtime-files-lookup.js +1 -32
- package/dist/sdk/traceability/source-traceability.js +1 -292
- package/dist/sdk/tracker-root-discovery.js +1 -9
- package/dist/sdk/workspace-contracts-cache.js +1 -28
- package/dist/sdk/workspace-contracts.js +1 -33
- package/dist/sdk/workspace-memory.js +2 -318
- package/dist/sdk/workspace-recipe.js +1 -71
- package/dist/sdk/workspace-snapshot.js +4 -613
- package/dist/sdk/workspace-transaction-gc.js +1 -149
- package/dist/sdk/workspace-transaction.js +2 -363
- package/dist/sdk/workspace.js +3 -127
- package/dist/types/index.js +1 -9
- package/dist/types.d.ts +4 -0
- package/dist/types.js +1 -245
- package/docs/AGENT_GUIDE.md +1 -1
- package/docs/COMMANDS.md +10 -0
- package/docs/CONFIGURATION.md +12 -1
- package/docs/CONTEXT_ALGORITHM_PORTFOLIO.md +167 -0
- package/docs/DIAGNOSTIC_OUTPUT_CONTRACTS.md +9 -3
- package/docs/EXTENSIONS.md +1 -0
- package/docs/HISTORY_MAINTENANCE.md +125 -0
- package/docs/MCP_2026_07_28_CONFORMANCE.md +20 -10
- package/docs/PACKAGE_EVIDENCE.md +92 -0
- package/docs/PLANNING_MEASUREMENTS.md +183 -0
- package/docs/README.md +4 -0
- package/docs/READ_OUTPUT_CONTRACTS.md +5 -0
- package/docs/SCRIPTING.md +21 -0
- package/docs/TESTING.md +33 -0
- package/docs/WORKFLOW_POLICIES.md +129 -0
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +7 -7
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +11 -5
- package/marketplace.json +2 -2
- package/package.json +5 -5
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/scripts/finalize-build.mjs +45 -3
- package/dist/cli-bundle/chunks/chunk-AZDFJGH6.js +0 -9
- package/dist/cli-bundle/chunks/chunk-CKOL5U7J.js +0 -77
- package/dist/cli-bundle/chunks/chunk-JX4DH4WC.js +0 -3
- package/dist/cli-bundle/chunks/chunk-OF76PSDQ.js +0 -5
- package/dist/cli-bundle/chunks/chunk-QUWFABDM.js +0 -232
- package/dist/cli-bundle/chunks/chunk-QWRRFYK3.js +0 -2
- package/dist/cli-bundle/chunks/chunk-RWWBOWJ5.js +0 -2
- package/dist/cli-bundle/chunks/chunk-WGAOYSYH.js +0 -40
- package/dist/cli-bundle/chunks/chunk-WI2AYPA7.js +0 -2
- package/dist/cli-bundle/chunks/register-list-query-5JL52D33.js +0 -11
- package/dist/cli-bundle/chunks/register-mutation-ZPG7KMVP.js +0 -20
- package/dist/cli-bundle/chunks/register-operations-I5W3KMGB.js +0 -2
- package/dist/cli-bundle/chunks/register-setup-H4SVAVX7.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-AL5ON6K6.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-CHC2IDXA.js +0 -6
- package/dist/cli-bundle/focused-chunks/chunk-CK6QFAPZ.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-EZR3GHFE.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-H2WJWK7L.js +0 -56
- package/dist/cli-bundle/focused-chunks/chunk-NTPY5GSO.js +0 -3
- package/dist/cli-bundle/focused-chunks/chunk-P5O7MP5Y.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDMW2E36.js +0 -177
- package/dist/cli-bundle/focused-chunks/chunk-PEFABF7E.js +0 -26
- package/dist/cli-bundle/focused-chunks/chunk-QTVCLMSZ.js +0 -6
- package/dist/cli-bundle/focused-chunks/chunk-QTZRBUYA.js +0 -8
- package/dist/cli-bundle/focused-chunks/chunk-SGQST3PQ.js +0 -12
- package/dist/cli-bundle/focused-chunks/chunk-UKHASMMP.js +0 -10
- package/dist/cli-bundle/focused-chunks/chunk-ZPEKQHOC.js +0 -2
|
@@ -1,694 +1,2 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module core/store/item-store
|
|
3
|
-
*
|
|
4
|
-
* Reads and writes tracker storage with format-aware helpers for Item Store.
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7cbc256e-cdd8-51de-9c22-08cf2f3cd010")}catch(e){}}();
|
|
8
|
-
import fs from "node:fs/promises";
|
|
9
|
-
import { recordItemMetadataEnumeration } from "./item-metadata-read-work.js";
|
|
10
|
-
import path from "node:path";
|
|
11
|
-
import { getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveOnReadHooks, runActiveBeforeMutationHooks, runActiveOnWriteHooks, runActiveServiceOverride, } from "../extensions/index.js";
|
|
12
|
-
import { collectRegisteredItemFieldNames } from "../extensions/item-fields.js";
|
|
13
|
-
import { EMPTY_CANONICAL_DOCUMENT, EXIT_CODE, TYPE_TO_FOLDER, } from "../shared/constants.js";
|
|
14
|
-
import { PmCliError } from "../shared/errors.js";
|
|
15
|
-
import { levenshteinDistanceWithinLimit } from "../shared/levenshtein.js";
|
|
16
|
-
import { appendHistoryEntry, createHistoryEntry } from "../history/history.js";
|
|
17
|
-
import { enforceHistoryStreamPolicyForItem } from "../history/history-stream-policy.js";
|
|
18
|
-
import { canonicalDocument, parseItemDocument, serializeItemDocument, } from "../item/item-format.js";
|
|
19
|
-
import { resolveItemTypeRegistry } from "../item/type-registry.js";
|
|
20
|
-
import { acquireLock } from "../lock/lock.js";
|
|
21
|
-
import { writeFileAtomic } from "../fs/fs-utils.js";
|
|
22
|
-
import { isUtf8 } from "node:buffer";
|
|
23
|
-
import { normalizeItemId, normalizeRawItemId } from "../item/id.js";
|
|
24
|
-
import { acquireItemMetadataDerivedIndexLock, listAllDocumentCandidatesCached, listAllDocumentsCached, listAllDocumentsCachedLight, refreshItemMetadataDerivedIndex, } from "./item-metadata-cache.js";
|
|
25
|
-
import { getHistoryPath, getItemPath, ITEM_FILE_EXTENSIONS } from "./paths.js";
|
|
26
|
-
import { resolveGovernanceKnobs } from "./settings.js";
|
|
27
|
-
import { assertReadableTrackerRoot } from "./tracker-preflight.js";
|
|
28
|
-
import { resolveClaimPrincipal } from "../shared/author.js";
|
|
29
|
-
import { nowIso } from "../shared/time.js";
|
|
30
|
-
async function fileExists(targetPath) {
|
|
31
|
-
try {
|
|
32
|
-
await fs.access(targetPath);
|
|
33
|
-
return true;
|
|
34
|
-
}
|
|
35
|
-
catch {
|
|
36
|
-
return false;
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
function isErrno(error, code) {
|
|
40
|
-
return (typeof error === "object" &&
|
|
41
|
-
error !== null &&
|
|
42
|
-
"code" in error &&
|
|
43
|
-
error.code === code);
|
|
44
|
-
}
|
|
45
|
-
function appendWarning(warnings, warning) {
|
|
46
|
-
if (!warnings) {
|
|
47
|
-
return;
|
|
48
|
-
}
|
|
49
|
-
if (!warnings.includes(warning)) {
|
|
50
|
-
warnings.push(warning);
|
|
51
|
-
}
|
|
52
|
-
}
|
|
53
|
-
function resolveActiveExtensionFieldNames(explicit) {
|
|
54
|
-
return (explicit ??
|
|
55
|
-
collectRegisteredItemFieldNames(getActiveExtensionRegistrations()));
|
|
56
|
-
}
|
|
57
|
-
function resolveItemFormatSearchOrder(preferredFormat) {
|
|
58
|
-
if (preferredFormat === "toon") {
|
|
59
|
-
return ["toon", "json_markdown"];
|
|
60
|
-
}
|
|
61
|
-
if (preferredFormat === "json_markdown") {
|
|
62
|
-
return ["json_markdown", "toon"];
|
|
63
|
-
}
|
|
64
|
-
return ["toon", "json_markdown"];
|
|
65
|
-
}
|
|
66
|
-
/** Implements locate item for the public runtime surface of this module. */
|
|
67
|
-
export async function locateItem(pmRoot, rawId, idPrefix = "pm-", preferredFormat, typeToFolder = TYPE_TO_FOLDER) {
|
|
68
|
-
const trimmedRawId = rawId.trim();
|
|
69
|
-
const exactRawId = trimmedRawId.startsWith("#")
|
|
70
|
-
? trimmedRawId.slice(1)
|
|
71
|
-
: trimmedRawId;
|
|
72
|
-
if (exactRawId.length === 0) {
|
|
73
|
-
return null;
|
|
74
|
-
}
|
|
75
|
-
const normalizedId = normalizeItemId(rawId, idPrefix);
|
|
76
|
-
const rawNormalizedId = normalizeRawItemId(rawId);
|
|
77
|
-
const candidateIds = [
|
|
78
|
-
...new Set([exactRawId, normalizedId, rawNormalizedId]),
|
|
79
|
-
].filter((candidateId) => candidateId.length > 0);
|
|
80
|
-
const entries = Object.entries(typeToFolder);
|
|
81
|
-
const searchOrder = resolveItemFormatSearchOrder(preferredFormat);
|
|
82
|
-
for (const candidateId of candidateIds) {
|
|
83
|
-
for (const [type] of entries) {
|
|
84
|
-
for (const itemFormat of searchOrder) {
|
|
85
|
-
const itemPath = getItemPath(pmRoot, type, candidateId, itemFormat, typeToFolder);
|
|
86
|
-
if (await fileExists(itemPath)) {
|
|
87
|
-
return {
|
|
88
|
-
id: candidateId,
|
|
89
|
-
type,
|
|
90
|
-
itemPath,
|
|
91
|
-
item_format: itemFormat,
|
|
92
|
-
};
|
|
93
|
-
}
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
}
|
|
97
|
-
return null;
|
|
98
|
-
}
|
|
99
|
-
/** Implements read located item for the public runtime surface of this module. */
|
|
100
|
-
export async function readLocatedItem(item, options = {}) {
|
|
101
|
-
const snapshot = await readLocatedItemSnapshot(item, options);
|
|
102
|
-
if (snapshot.error !== null)
|
|
103
|
-
throw snapshot.error;
|
|
104
|
-
return { raw: snapshot.raw, document: snapshot.document };
|
|
105
|
-
}
|
|
106
|
-
/**
|
|
107
|
-
* Read once and retain a recoverable parse failure beside its exact text snapshot.
|
|
108
|
-
* Filesystem and merge-conflict errors still throw; callers must explicitly
|
|
109
|
-
* reconstruct an invalid document before performing any mutation.
|
|
110
|
-
*/
|
|
111
|
-
export async function readLocatedItemSnapshot(item, options = {}) {
|
|
112
|
-
const bytes = await fs.readFile(item.itemPath);
|
|
113
|
-
if (!isUtf8(bytes)) {
|
|
114
|
-
throw new PmCliError("Item contains invalid UTF-8; preserve a binary backup before recovering it.", EXIT_CODE.CONFLICT, { code: "item_document_encoding_invalid", item_id: item.id, item_path: item.itemPath, byte_length: bytes.length, empty: false });
|
|
115
|
-
}
|
|
116
|
-
const raw = bytes.toString("utf8");
|
|
117
|
-
await runActiveOnReadHooks({
|
|
118
|
-
path: item.itemPath,
|
|
119
|
-
scope: "project",
|
|
120
|
-
});
|
|
121
|
-
let document;
|
|
122
|
-
try {
|
|
123
|
-
document = parseItemDocument(raw, {
|
|
124
|
-
format: item.item_format,
|
|
125
|
-
schema: options.schema,
|
|
126
|
-
extensionFieldNames: resolveActiveExtensionFieldNames(options.extensionFieldNames),
|
|
127
|
-
onWarning: (warning) => appendWarning(options.warnings, warning),
|
|
128
|
-
});
|
|
129
|
-
}
|
|
130
|
-
catch (error) {
|
|
131
|
-
if (error instanceof PmCliError && error.code === "item_document_invalid") {
|
|
132
|
-
return {
|
|
133
|
-
raw,
|
|
134
|
-
document: null,
|
|
135
|
-
error: new PmCliError(`Cannot read ${item.id} at ${item.itemPath}${bytes.length === 0 ? " (zero-length file)" : ""}: ${error.message}`, error.exitCode, {
|
|
136
|
-
...error.context,
|
|
137
|
-
item_id: item.id,
|
|
138
|
-
item_path: item.itemPath,
|
|
139
|
-
byte_length: bytes.length,
|
|
140
|
-
empty: bytes.length === 0,
|
|
141
|
-
nextSteps: [
|
|
142
|
-
`Run pm history ${item.id} --full, then pm restore ${item.id} <version> to recover a recorded state.`,
|
|
143
|
-
],
|
|
144
|
-
}),
|
|
145
|
-
};
|
|
146
|
-
}
|
|
147
|
-
throw error;
|
|
148
|
-
}
|
|
149
|
-
return { raw, document, error: null };
|
|
150
|
-
}
|
|
151
|
-
/** Implements list all item metadata for the public runtime surface of this module. */
|
|
152
|
-
export async function listAllItemMetadata(pmRoot, preferredFormat, typeToFolder = TYPE_TO_FOLDER, warnings, schema) {
|
|
153
|
-
await assertReadableTrackerRoot(pmRoot);
|
|
154
|
-
const documents = await listAllDocumentsCached(pmRoot, preferredFormat, typeToFolder, warnings, schema);
|
|
155
|
-
recordItemMetadataEnumeration(documents.length);
|
|
156
|
-
return documents.map((document) => document.metadata);
|
|
157
|
-
}
|
|
158
|
-
/**
|
|
159
|
-
* Light variant of {@link listAllItemMetadata}: returns item-metadata WITHOUT the heavy
|
|
160
|
-
* collection fields (comments/notes/learnings/files/tests/test_runs/docs). Skips the
|
|
161
|
-
* large collections cache so the hot list path stays cheap. Only use for callers that
|
|
162
|
-
* read just the light scalar/small fields — see {@link listAllDocumentsCachedLight}.
|
|
163
|
-
*/
|
|
164
|
-
export async function listAllItemMetadataLight(pmRoot, preferredFormat, typeToFolder = TYPE_TO_FOLDER, warnings, schema) {
|
|
165
|
-
await assertReadableTrackerRoot(pmRoot);
|
|
166
|
-
const documents = await listAllDocumentsCachedLight(pmRoot, preferredFormat, typeToFolder, warnings, schema);
|
|
167
|
-
recordItemMetadataEnumeration(documents.length);
|
|
168
|
-
return documents.map((document) => document.metadata);
|
|
169
|
-
}
|
|
170
|
-
/** List item metadata with bodies, optionally bypassing the derived-index fast path when an integrity workflow must re-read authoritative files. */
|
|
171
|
-
export async function listAllItemMetadataWithBody(pmRoot, preferredFormat, typeToFolder = TYPE_TO_FOLDER, warnings, schema, options = {}) {
|
|
172
|
-
await assertReadableTrackerRoot(pmRoot);
|
|
173
|
-
const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema, {
|
|
174
|
-
includeBody: true,
|
|
175
|
-
forceSourceScan: options.forceSourceScan,
|
|
176
|
-
});
|
|
177
|
-
recordItemMetadataEnumeration(candidates.length);
|
|
178
|
-
return candidates.map((candidate) => ({
|
|
179
|
-
...candidate.metadata,
|
|
180
|
-
// includeBody:true guarantees candidate bodies are materialized.
|
|
181
|
-
body: candidate.body,
|
|
182
|
-
}));
|
|
183
|
-
}
|
|
184
|
-
/** Build the minimal host-bound read-only SDK exposed to transactional extension guards. */
|
|
185
|
-
export function createMutationGuardSdk(params) {
|
|
186
|
-
return {
|
|
187
|
-
async get(id) {
|
|
188
|
-
const located = await locateItem(params.pmRoot, id, params.settings.id_prefix, params.settings.item_format, params.typeToFolder);
|
|
189
|
-
if (!located)
|
|
190
|
-
return null;
|
|
191
|
-
const { document } = await readLocatedItem(located, {
|
|
192
|
-
schema: params.settings.schema,
|
|
193
|
-
});
|
|
194
|
-
return { item: document.metadata, body: document.body };
|
|
195
|
-
},
|
|
196
|
-
list: () => listAllItemMetadata(params.pmRoot, params.settings.item_format, params.typeToFolder, undefined, params.settings.schema),
|
|
197
|
-
};
|
|
198
|
-
}
|
|
199
|
-
async function listKnownItemIds(pmRoot, typeToFolder) {
|
|
200
|
-
const folders = new Set(Object.values(typeToFolder));
|
|
201
|
-
const allIds = [];
|
|
202
|
-
await Promise.all([...folders].map(async (folder) => {
|
|
203
|
-
try {
|
|
204
|
-
const entries = await fs.readdir(path.join(pmRoot, folder));
|
|
205
|
-
for (const entry of entries) {
|
|
206
|
-
for (const ext of ITEM_FILE_EXTENSIONS) {
|
|
207
|
-
if (entry.toLowerCase().endsWith(ext)) {
|
|
208
|
-
allIds.push(entry.slice(0, -ext.length));
|
|
209
|
-
break;
|
|
210
|
-
}
|
|
211
|
-
}
|
|
212
|
-
}
|
|
213
|
-
}
|
|
214
|
-
catch {
|
|
215
|
-
// ignore missing folders
|
|
216
|
-
}
|
|
217
|
-
}));
|
|
218
|
-
return allIds;
|
|
219
|
-
}
|
|
220
|
-
async function buildDidYouMeanSuggestions(pmRoot, badId, idPrefix, typeToFolder) {
|
|
221
|
-
const normalized = normalizeItemId(badId, idPrefix);
|
|
222
|
-
const ids = await listKnownItemIds(pmRoot, typeToFolder);
|
|
223
|
-
if (ids.length === 0)
|
|
224
|
-
return [];
|
|
225
|
-
const limit = Math.max(3, Math.floor(normalized.length / 2));
|
|
226
|
-
const scored = ids
|
|
227
|
-
.map((id) => ({
|
|
228
|
-
id,
|
|
229
|
-
distance: levenshteinDistanceWithinLimit(id, normalized, limit),
|
|
230
|
-
}))
|
|
231
|
-
.filter((entry) => entry.distance !== null)
|
|
232
|
-
.sort((left, right) => left.distance - right.distance)
|
|
233
|
-
.slice(0, 3)
|
|
234
|
-
.map((entry) => entry.id);
|
|
235
|
-
return scored;
|
|
236
|
-
}
|
|
237
|
-
/** Implements build item not found error for the public runtime surface of this module. */
|
|
238
|
-
export async function buildItemNotFoundError(pmRoot, badId, idPrefix, typeToFolder) {
|
|
239
|
-
const suggestions = await buildDidYouMeanSuggestions(pmRoot, badId, idPrefix, typeToFolder);
|
|
240
|
-
const nextSteps = [
|
|
241
|
-
"Confirm the active --path/PM_PATH scope, then retry with a valid id.",
|
|
242
|
-
];
|
|
243
|
-
if (suggestions.length > 0) {
|
|
244
|
-
nextSteps.unshift(`Did you mean one of: ${suggestions.join(", ")}?`);
|
|
245
|
-
}
|
|
246
|
-
return new PmCliError(`Item ${badId} not found`, EXIT_CODE.NOT_FOUND, {
|
|
247
|
-
nextSteps,
|
|
248
|
-
});
|
|
249
|
-
}
|
|
250
|
-
function bypassesAssigneeConflict(op, bypassAssigneeConflict) {
|
|
251
|
-
return (op === "claim" ||
|
|
252
|
-
(bypassAssigneeConflict === true &&
|
|
253
|
-
(op === "comment_add" ||
|
|
254
|
-
op === "comment_edit" ||
|
|
255
|
-
op === "comment_delete" ||
|
|
256
|
-
op === "note_add" ||
|
|
257
|
-
op === "learning_add" ||
|
|
258
|
-
op === "release" ||
|
|
259
|
-
op === "update" ||
|
|
260
|
-
op === "update_ownership_bypass" ||
|
|
261
|
-
// Historical compatibility for streams written before the optional
|
|
262
|
-
// governance package moved its ownership workflow out of core.
|
|
263
|
-
op === "update_audit")));
|
|
264
|
-
}
|
|
265
|
-
async function prepareLockedItem(params) {
|
|
266
|
-
const typeToFolder = params.typeToFolder ??
|
|
267
|
-
resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations())
|
|
268
|
-
.type_to_folder;
|
|
269
|
-
const located = await locateItem(params.pmRoot, params.id, params.settings.id_prefix, params.settings.item_format, typeToFolder);
|
|
270
|
-
if (!located) {
|
|
271
|
-
throw await buildItemNotFoundError(params.pmRoot, params.id, params.settings.id_prefix, typeToFolder);
|
|
272
|
-
}
|
|
273
|
-
const releaseLock = await acquireLock(params.pmRoot, located.id, params.settings.locks.ttl_seconds, params.author, Boolean(params.force), params.settings.governance.force_required_for_stale_lock, params.settings.locks.wait_ms);
|
|
274
|
-
try {
|
|
275
|
-
const warnings = [];
|
|
276
|
-
const { raw: originalRaw, document } = await readLocatedItem(located, {
|
|
277
|
-
schema: params.settings.schema,
|
|
278
|
-
extensionFieldNames: params.extensionFieldNames,
|
|
279
|
-
warnings,
|
|
280
|
-
});
|
|
281
|
-
const assigned = document.metadata.assignee?.trim();
|
|
282
|
-
const assignedPrincipal = document.metadata.claim_principal?.trim() || assigned;
|
|
283
|
-
const callerPrincipal = resolveClaimPrincipal(params.author);
|
|
284
|
-
const governance = resolveGovernanceKnobs(params.settings);
|
|
285
|
-
const hasOwnershipConflict = assigned &&
|
|
286
|
-
assignedPrincipal !== callerPrincipal &&
|
|
287
|
-
!params.force &&
|
|
288
|
-
!bypassesAssigneeConflict(params.op, params.bypassAssigneeConflict);
|
|
289
|
-
if (hasOwnershipConflict) {
|
|
290
|
-
if (governance.ownership_enforcement === "strict") {
|
|
291
|
-
throw new PmCliError(`Item ${located.id} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
|
|
292
|
-
}
|
|
293
|
-
if (governance.ownership_enforcement === "warn") {
|
|
294
|
-
warnings.push(`ownership_warning:assignee_conflict:${located.id}:${assigned}`);
|
|
295
|
-
}
|
|
296
|
-
}
|
|
297
|
-
return {
|
|
298
|
-
typeToFolder,
|
|
299
|
-
located,
|
|
300
|
-
originalRaw,
|
|
301
|
-
document,
|
|
302
|
-
warnings,
|
|
303
|
-
releaseLock,
|
|
304
|
-
};
|
|
305
|
-
}
|
|
306
|
-
catch (error) {
|
|
307
|
-
await releaseLock();
|
|
308
|
-
throw error;
|
|
309
|
-
}
|
|
310
|
-
}
|
|
311
|
-
function resolveItemStoreWriteOverride(serviceWriteOverride, targetItemPath, serializedAfter) {
|
|
312
|
-
if (!serviceWriteOverride.handled ||
|
|
313
|
-
typeof serviceWriteOverride.result !== "object" ||
|
|
314
|
-
serviceWriteOverride.result === null) {
|
|
315
|
-
return {
|
|
316
|
-
effectiveTargetItemPath: targetItemPath,
|
|
317
|
-
effectiveSerializedAfter: serializedAfter,
|
|
318
|
-
skipItemWrite: false,
|
|
319
|
-
};
|
|
320
|
-
}
|
|
321
|
-
const overrideRecord = serviceWriteOverride.result;
|
|
322
|
-
return {
|
|
323
|
-
effectiveTargetItemPath: typeof overrideRecord.target_item_path === "string" &&
|
|
324
|
-
overrideRecord.target_item_path.trim().length > 0
|
|
325
|
-
? overrideRecord.target_item_path
|
|
326
|
-
: targetItemPath,
|
|
327
|
-
effectiveSerializedAfter: typeof overrideRecord.contents === "string"
|
|
328
|
-
? overrideRecord.contents
|
|
329
|
-
: serializedAfter,
|
|
330
|
-
skipItemWrite: overrideRecord.skip_write === true,
|
|
331
|
-
};
|
|
332
|
-
}
|
|
333
|
-
async function rollbackMutatedItemWrite(params) {
|
|
334
|
-
if (params.skipItemWrite) {
|
|
335
|
-
return;
|
|
336
|
-
}
|
|
337
|
-
if (params.effectiveTargetItemPath !== params.originalItemPath) {
|
|
338
|
-
await writeFileAtomic(params.originalItemPath, params.originalRaw);
|
|
339
|
-
await fs.rm(params.effectiveTargetItemPath, { force: true });
|
|
340
|
-
return;
|
|
341
|
-
}
|
|
342
|
-
await writeFileAtomic(params.originalItemPath, params.originalRaw);
|
|
343
|
-
}
|
|
344
|
-
async function mutateItemWithDeferredHistoryContext(params) {
|
|
345
|
-
const prepared = await prepareLockedItem({
|
|
346
|
-
pmRoot: params.pmRoot,
|
|
347
|
-
settings: params.settings,
|
|
348
|
-
id: params.id,
|
|
349
|
-
op: params.op,
|
|
350
|
-
author: params.author,
|
|
351
|
-
force: params.force,
|
|
352
|
-
bypassAssigneeConflict: params.bypassAssigneeConflict,
|
|
353
|
-
extensionFieldNames: params.extensionFieldNames,
|
|
354
|
-
typeToFolder: params.typeToFolder,
|
|
355
|
-
});
|
|
356
|
-
const { typeToFolder, located, originalRaw, document, warnings: parseWarnings, releaseLock, } = prepared;
|
|
357
|
-
try {
|
|
358
|
-
const beforeDocument = canonicalDocument(document, {
|
|
359
|
-
schema: params.settings.schema,
|
|
360
|
-
extensionFieldNames: params.extensionFieldNames,
|
|
361
|
-
});
|
|
362
|
-
const mutableDocument = canonicalDocument(structuredClone(document), {
|
|
363
|
-
schema: params.settings.schema,
|
|
364
|
-
extensionFieldNames: params.extensionFieldNames,
|
|
365
|
-
});
|
|
366
|
-
const mutation = await params.mutate(mutableDocument);
|
|
367
|
-
if (params.skipNoop === true && mutation.changedFields.length === 0) {
|
|
368
|
-
return {
|
|
369
|
-
item: beforeDocument.metadata,
|
|
370
|
-
body: beforeDocument.body,
|
|
371
|
-
changedFields: [],
|
|
372
|
-
warnings: [...parseWarnings, ...(mutation.warnings ?? [])],
|
|
373
|
-
};
|
|
374
|
-
}
|
|
375
|
-
const historyContext = params.resolveHistoryContext?.();
|
|
376
|
-
mutableDocument.metadata.updated_at = nowIso();
|
|
377
|
-
const afterDocument = canonicalDocument(mutableDocument, {
|
|
378
|
-
schema: params.settings.schema,
|
|
379
|
-
extensionFieldNames: params.extensionFieldNames,
|
|
380
|
-
});
|
|
381
|
-
await runActiveBeforeMutationHooks({
|
|
382
|
-
pm_root: params.pmRoot,
|
|
383
|
-
operation: params.op,
|
|
384
|
-
before: beforeDocument,
|
|
385
|
-
after: afterDocument,
|
|
386
|
-
changed_fields: mutation.changedFields,
|
|
387
|
-
sdk: createMutationGuardSdk({
|
|
388
|
-
pmRoot: params.pmRoot,
|
|
389
|
-
settings: params.settings,
|
|
390
|
-
typeToFolder,
|
|
391
|
-
}),
|
|
392
|
-
});
|
|
393
|
-
const historyPolicy = await enforceHistoryStreamPolicyForItem({
|
|
394
|
-
pmRoot: params.pmRoot,
|
|
395
|
-
settings: params.settings,
|
|
396
|
-
itemId: located.id,
|
|
397
|
-
commandLabel: params.op,
|
|
398
|
-
});
|
|
399
|
-
const targetItemFormat = "toon";
|
|
400
|
-
const serializedAfter = serializeItemDocument(afterDocument, {
|
|
401
|
-
format: targetItemFormat,
|
|
402
|
-
schema: params.settings.schema,
|
|
403
|
-
extensionFieldNames: params.extensionFieldNames,
|
|
404
|
-
});
|
|
405
|
-
const targetItemPath = getItemPath(params.pmRoot, afterDocument.metadata.type, located.id, targetItemFormat, typeToFolder);
|
|
406
|
-
const historyPath = getHistoryPath(params.pmRoot, located.id);
|
|
407
|
-
const serviceWriteOverride = await runActiveServiceOverride("item_store_write", {
|
|
408
|
-
op: params.op,
|
|
409
|
-
pm_root: params.pmRoot,
|
|
410
|
-
item_id: located.id,
|
|
411
|
-
source_item_path: located.itemPath,
|
|
412
|
-
target_item_path: targetItemPath,
|
|
413
|
-
history_path: historyPath,
|
|
414
|
-
item_format: targetItemFormat,
|
|
415
|
-
before: beforeDocument,
|
|
416
|
-
after: afterDocument,
|
|
417
|
-
contents: serializedAfter,
|
|
418
|
-
});
|
|
419
|
-
const { effectiveTargetItemPath, effectiveSerializedAfter, skipItemWrite } = resolveItemStoreWriteOverride(serviceWriteOverride, targetItemPath, serializedAfter);
|
|
420
|
-
const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(params.pmRoot, params.author);
|
|
421
|
-
let derivedIndexWarnings = [];
|
|
422
|
-
try {
|
|
423
|
-
if (!skipItemWrite) {
|
|
424
|
-
await writeFileAtomic(effectiveTargetItemPath, effectiveSerializedAfter);
|
|
425
|
-
}
|
|
426
|
-
if (!skipItemWrite && effectiveTargetItemPath !== located.itemPath) {
|
|
427
|
-
await fs.rm(located.itemPath);
|
|
428
|
-
}
|
|
429
|
-
const entry = createHistoryEntry({
|
|
430
|
-
nowIso: afterDocument.metadata.updated_at,
|
|
431
|
-
author: params.author,
|
|
432
|
-
op: params.op,
|
|
433
|
-
before: beforeDocument,
|
|
434
|
-
after: afterDocument,
|
|
435
|
-
message: params.message,
|
|
436
|
-
context: historyContext,
|
|
437
|
-
});
|
|
438
|
-
try {
|
|
439
|
-
await appendHistoryEntry(historyPath, entry);
|
|
440
|
-
}
|
|
441
|
-
catch (error) {
|
|
442
|
-
await rollbackMutatedItemWrite({
|
|
443
|
-
skipItemWrite,
|
|
444
|
-
effectiveTargetItemPath,
|
|
445
|
-
originalItemPath: located.itemPath,
|
|
446
|
-
originalRaw,
|
|
447
|
-
});
|
|
448
|
-
throw error;
|
|
449
|
-
}
|
|
450
|
-
if (!skipItemWrite) {
|
|
451
|
-
derivedIndexWarnings = await refreshItemMetadataDerivedIndex({
|
|
452
|
-
pmRoot: params.pmRoot,
|
|
453
|
-
preferredFormat: params.settings.item_format,
|
|
454
|
-
typeToFolder,
|
|
455
|
-
schema: params.settings.schema,
|
|
456
|
-
itemPath: effectiveTargetItemPath,
|
|
457
|
-
previousItemPath: located.itemPath,
|
|
458
|
-
document: afterDocument,
|
|
459
|
-
});
|
|
460
|
-
}
|
|
461
|
-
}
|
|
462
|
-
finally {
|
|
463
|
-
await releaseDerivedIndexLock();
|
|
464
|
-
}
|
|
465
|
-
const hookWarnings = [
|
|
466
|
-
...(await runActiveOnWriteHooks({
|
|
467
|
-
path: effectiveTargetItemPath,
|
|
468
|
-
scope: "project",
|
|
469
|
-
op: params.op,
|
|
470
|
-
item_id: afterDocument.metadata.id,
|
|
471
|
-
item_type: afterDocument.metadata.type,
|
|
472
|
-
before: beforeDocument,
|
|
473
|
-
after: afterDocument,
|
|
474
|
-
changed_fields: mutation.changedFields,
|
|
475
|
-
})),
|
|
476
|
-
...(await runActiveOnWriteHooks({
|
|
477
|
-
path: historyPath,
|
|
478
|
-
scope: "project",
|
|
479
|
-
op: `${params.op}:history`,
|
|
480
|
-
item_id: afterDocument.metadata.id,
|
|
481
|
-
item_type: afterDocument.metadata.type,
|
|
482
|
-
before: beforeDocument,
|
|
483
|
-
after: afterDocument,
|
|
484
|
-
changed_fields: mutation.changedFields,
|
|
485
|
-
})),
|
|
486
|
-
];
|
|
487
|
-
recordAfterCommandAffectedItem({
|
|
488
|
-
id: afterDocument.metadata.id,
|
|
489
|
-
op: params.op,
|
|
490
|
-
item_type: afterDocument.metadata.type,
|
|
491
|
-
previous_status: beforeDocument.metadata.status,
|
|
492
|
-
status: afterDocument.metadata.status,
|
|
493
|
-
previous: projectAfterCommandItemSnapshot(beforeDocument.metadata, mutation.changedFields),
|
|
494
|
-
current: projectAfterCommandItemSnapshot(afterDocument.metadata, mutation.changedFields),
|
|
495
|
-
changed_fields: mutation.changedFields,
|
|
496
|
-
});
|
|
497
|
-
return {
|
|
498
|
-
item: afterDocument.metadata,
|
|
499
|
-
body: afterDocument.body,
|
|
500
|
-
changedFields: mutation.changedFields,
|
|
501
|
-
warnings: [
|
|
502
|
-
...parseWarnings,
|
|
503
|
-
...(mutation.warnings ?? []),
|
|
504
|
-
...historyPolicy.warnings,
|
|
505
|
-
...serviceWriteOverride.warnings,
|
|
506
|
-
...derivedIndexWarnings,
|
|
507
|
-
...hookWarnings,
|
|
508
|
-
],
|
|
509
|
-
};
|
|
510
|
-
}
|
|
511
|
-
finally {
|
|
512
|
-
await releaseLock();
|
|
513
|
-
}
|
|
514
|
-
}
|
|
515
|
-
/** Mutate one item while attaching structured context to its immutable history event. */
|
|
516
|
-
export async function mutateItemWithHistoryContext(params) {
|
|
517
|
-
const { historyContext, ...mutationParams } = params;
|
|
518
|
-
return mutateItemWithDeferredHistoryContext({
|
|
519
|
-
...mutationParams,
|
|
520
|
-
resolveHistoryContext: () => historyContext,
|
|
521
|
-
});
|
|
522
|
-
}
|
|
523
|
-
/** Mutate one item while resolving structured history context after its locked mutation. */
|
|
524
|
-
export async function mutateItemWithHistoryContextResolver(params) {
|
|
525
|
-
return mutateItemWithDeferredHistoryContext(params);
|
|
526
|
-
}
|
|
527
|
-
/** Mutate one item through the compatibility overload while preserving transactional storage and immutable history semantics. */
|
|
528
|
-
export async function mutateItem(params) {
|
|
529
|
-
return mutateItemWithDeferredHistoryContext(params);
|
|
530
|
-
}
|
|
531
|
-
/** Public contract for item store test only, shared by SDK and presentation-layer consumers. */
|
|
532
|
-
export const itemStoreTestOnly = {
|
|
533
|
-
appendWarning,
|
|
534
|
-
bypassesAssigneeConflict,
|
|
535
|
-
buildDidYouMeanSuggestions,
|
|
536
|
-
isErrno,
|
|
537
|
-
};
|
|
538
|
-
/** Implements delete item for the public runtime surface of this module. */
|
|
539
|
-
export async function deleteItem(params) {
|
|
540
|
-
const prepared = await prepareLockedItem({
|
|
541
|
-
pmRoot: params.pmRoot,
|
|
542
|
-
settings: params.settings,
|
|
543
|
-
id: params.id,
|
|
544
|
-
op: "delete",
|
|
545
|
-
author: params.author,
|
|
546
|
-
force: params.force,
|
|
547
|
-
});
|
|
548
|
-
const { located, originalRaw, document, warnings: parseWarnings, releaseLock, } = prepared;
|
|
549
|
-
try {
|
|
550
|
-
const extensionFieldNames = resolveActiveExtensionFieldNames(undefined);
|
|
551
|
-
const beforeDocument = canonicalDocument(document, {
|
|
552
|
-
schema: params.settings.schema,
|
|
553
|
-
extensionFieldNames,
|
|
554
|
-
});
|
|
555
|
-
await runActiveBeforeMutationHooks({
|
|
556
|
-
pm_root: params.pmRoot,
|
|
557
|
-
operation: "delete",
|
|
558
|
-
before: beforeDocument,
|
|
559
|
-
after: null,
|
|
560
|
-
changed_fields: ["deleted"],
|
|
561
|
-
sdk: createMutationGuardSdk({
|
|
562
|
-
pmRoot: params.pmRoot,
|
|
563
|
-
settings: params.settings,
|
|
564
|
-
typeToFolder: prepared.typeToFolder,
|
|
565
|
-
}),
|
|
566
|
-
});
|
|
567
|
-
const historyPolicy = await enforceHistoryStreamPolicyForItem({
|
|
568
|
-
pmRoot: params.pmRoot,
|
|
569
|
-
settings: params.settings,
|
|
570
|
-
itemId: located.id,
|
|
571
|
-
commandLabel: "delete",
|
|
572
|
-
});
|
|
573
|
-
const deletionTimestamp = nowIso();
|
|
574
|
-
const tombstoneDocument = EMPTY_CANONICAL_DOCUMENT;
|
|
575
|
-
const historyEntry = createHistoryEntry({
|
|
576
|
-
nowIso: deletionTimestamp,
|
|
577
|
-
author: params.author,
|
|
578
|
-
op: "delete",
|
|
579
|
-
before: beforeDocument,
|
|
580
|
-
after: tombstoneDocument,
|
|
581
|
-
message: params.message,
|
|
582
|
-
});
|
|
583
|
-
const historyPath = getHistoryPath(params.pmRoot, located.id);
|
|
584
|
-
const serviceDeleteOverride = await runActiveServiceOverride("item_store_delete", {
|
|
585
|
-
op: "delete",
|
|
586
|
-
pm_root: params.pmRoot,
|
|
587
|
-
item_id: located.id,
|
|
588
|
-
item_path: located.itemPath,
|
|
589
|
-
history_path: historyPath,
|
|
590
|
-
before: beforeDocument,
|
|
591
|
-
});
|
|
592
|
-
let effectiveItemPath = located.itemPath;
|
|
593
|
-
let skipDelete = false;
|
|
594
|
-
if (serviceDeleteOverride.handled &&
|
|
595
|
-
typeof serviceDeleteOverride.result === "object" &&
|
|
596
|
-
serviceDeleteOverride.result !== null) {
|
|
597
|
-
const overrideRecord = serviceDeleteOverride.result;
|
|
598
|
-
if (typeof overrideRecord.item_path === "string" &&
|
|
599
|
-
overrideRecord.item_path.trim().length > 0) {
|
|
600
|
-
effectiveItemPath = overrideRecord.item_path;
|
|
601
|
-
}
|
|
602
|
-
if (overrideRecord.skip_delete === true) {
|
|
603
|
-
skipDelete = true;
|
|
604
|
-
}
|
|
605
|
-
}
|
|
606
|
-
if (params.dryRun === true) {
|
|
607
|
-
return {
|
|
608
|
-
item: beforeDocument.metadata,
|
|
609
|
-
changedFields: ["deleted"],
|
|
610
|
-
targetPath: effectiveItemPath,
|
|
611
|
-
warnings: [
|
|
612
|
-
...parseWarnings,
|
|
613
|
-
...historyPolicy.warnings,
|
|
614
|
-
...serviceDeleteOverride.warnings,
|
|
615
|
-
],
|
|
616
|
-
};
|
|
617
|
-
}
|
|
618
|
-
const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(params.pmRoot, params.author);
|
|
619
|
-
let derivedIndexWarnings = [];
|
|
620
|
-
try {
|
|
621
|
-
if (!skipDelete) {
|
|
622
|
-
await fs.rm(effectiveItemPath);
|
|
623
|
-
}
|
|
624
|
-
try {
|
|
625
|
-
await appendHistoryEntry(historyPath, historyEntry);
|
|
626
|
-
}
|
|
627
|
-
catch (error) {
|
|
628
|
-
if (!skipDelete) {
|
|
629
|
-
await writeFileAtomic(effectiveItemPath, originalRaw);
|
|
630
|
-
}
|
|
631
|
-
throw error;
|
|
632
|
-
}
|
|
633
|
-
if (!skipDelete) {
|
|
634
|
-
derivedIndexWarnings = await refreshItemMetadataDerivedIndex({
|
|
635
|
-
pmRoot: params.pmRoot,
|
|
636
|
-
preferredFormat: params.settings.item_format,
|
|
637
|
-
typeToFolder: prepared.typeToFolder,
|
|
638
|
-
schema: params.settings.schema,
|
|
639
|
-
itemPath: effectiveItemPath,
|
|
640
|
-
document: null,
|
|
641
|
-
});
|
|
642
|
-
}
|
|
643
|
-
}
|
|
644
|
-
finally {
|
|
645
|
-
await releaseDerivedIndexLock();
|
|
646
|
-
}
|
|
647
|
-
const hookWarnings = [
|
|
648
|
-
...(await runActiveOnWriteHooks({
|
|
649
|
-
path: effectiveItemPath,
|
|
650
|
-
scope: "project",
|
|
651
|
-
op: "delete",
|
|
652
|
-
item_id: beforeDocument.metadata.id,
|
|
653
|
-
item_type: beforeDocument.metadata.type,
|
|
654
|
-
before: beforeDocument,
|
|
655
|
-
after: tombstoneDocument,
|
|
656
|
-
changed_fields: ["deleted"],
|
|
657
|
-
})),
|
|
658
|
-
...(await runActiveOnWriteHooks({
|
|
659
|
-
path: historyPath,
|
|
660
|
-
scope: "project",
|
|
661
|
-
op: "delete:history",
|
|
662
|
-
item_id: beforeDocument.metadata.id,
|
|
663
|
-
item_type: beforeDocument.metadata.type,
|
|
664
|
-
before: beforeDocument,
|
|
665
|
-
after: tombstoneDocument,
|
|
666
|
-
changed_fields: ["deleted"],
|
|
667
|
-
})),
|
|
668
|
-
];
|
|
669
|
-
recordAfterCommandAffectedItem({
|
|
670
|
-
id: beforeDocument.metadata.id,
|
|
671
|
-
op: "delete",
|
|
672
|
-
item_type: beforeDocument.metadata.type,
|
|
673
|
-
previous_status: beforeDocument.metadata.status,
|
|
674
|
-
previous: projectAfterCommandItemSnapshot(beforeDocument.metadata, Object.keys(beforeDocument.metadata)),
|
|
675
|
-
changed_fields: ["deleted"],
|
|
676
|
-
});
|
|
677
|
-
return {
|
|
678
|
-
item: beforeDocument.metadata,
|
|
679
|
-
changedFields: ["deleted"],
|
|
680
|
-
warnings: [
|
|
681
|
-
...parseWarnings,
|
|
682
|
-
...historyPolicy.warnings,
|
|
683
|
-
...serviceDeleteOverride.warnings,
|
|
684
|
-
...derivedIndexWarnings,
|
|
685
|
-
...hookWarnings,
|
|
686
|
-
],
|
|
687
|
-
};
|
|
688
|
-
}
|
|
689
|
-
finally {
|
|
690
|
-
await releaseLock();
|
|
691
|
-
}
|
|
692
|
-
}
|
|
1
|
+
!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="abd6941f-b4cc-50e4-a64e-d0720d73cdba")}catch(e2){}})();import fs from"node:fs/promises";import{enforceWorkflowMutation}from"../policy/workflow-policy-store.js";import{recordItemMetadataEnumeration}from"./item-metadata-read-work.js";import path from"node:path";import{getActiveExtensionRegistrations,projectAfterCommandItemSnapshot,recordAfterCommandAffectedItem,runActiveOnReadHooks,runActiveBeforeMutationHooks,runActiveOnWriteHooks,runActiveServiceOverride}from"../extensions/index.js";import{collectRegisteredItemFieldNames}from"../extensions/item-fields.js";import{EMPTY_CANONICAL_DOCUMENT,EXIT_CODE,TYPE_TO_FOLDER}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";import{levenshteinDistanceWithinLimit}from"../shared/levenshtein.js";import{appendHistoryEntry,createHistoryEntry}from"../history/history.js";import{enforceHistoryStreamPolicyForItem}from"../history/history-stream-policy.js";import{canonicalDocument,parseItemDocument,serializeItemDocument}from"../item/item-format.js";import{resolveItemTypeRegistry}from"../item/type-registry.js";import{acquireLock}from"../lock/lock.js";import{writeFileAtomic}from"../fs/fs-utils.js";import{isUtf8}from"node:buffer";import{normalizeItemId,normalizeRawItemId}from"../item/id.js";import{acquireItemMetadataDerivedIndexLock,listAllDocumentCandidatesCached,listAllDocumentsCached,listAllDocumentsCachedLight,refreshItemMetadataDerivedIndex}from"./item-metadata-cache.js";import{getHistoryPath,getItemPath,ITEM_FILE_EXTENSIONS}from"./paths.js";import{resolveGovernanceKnobs}from"./settings.js";import{assertReadableTrackerRoot}from"./tracker-preflight.js";import{resolveClaimPrincipal}from"../shared/author.js";import{nowIso}from"../shared/time.js";async function fileExists(targetPath){try{await fs.access(targetPath);return true}catch{return false}}function isErrno(error,code){return typeof error==="object"&&error!==null&&"code"in error&&error.code===code}function appendWarning(warnings,warning){if(!warnings){return}if(!warnings.includes(warning)){warnings.push(warning)}}function resolveActiveExtensionFieldNames(explicit){return explicit??collectRegisteredItemFieldNames(getActiveExtensionRegistrations())}function resolveItemFormatSearchOrder(preferredFormat){if(preferredFormat==="toon"){return["toon","json_markdown"]}if(preferredFormat==="json_markdown"){return["json_markdown","toon"]}return["toon","json_markdown"]}async function locateItem(pmRoot,rawId,idPrefix="pm-",preferredFormat,typeToFolder=TYPE_TO_FOLDER){const trimmedRawId=rawId.trim();const exactRawId=trimmedRawId.startsWith("#")?trimmedRawId.slice(1):trimmedRawId;if(exactRawId.length===0){return null}const normalizedId=normalizeItemId(rawId,idPrefix);const rawNormalizedId=normalizeRawItemId(rawId);const candidateIds=[...new Set([exactRawId,normalizedId,rawNormalizedId])].filter(candidateId=>candidateId.length>0);const entries=Object.entries(typeToFolder);const searchOrder=resolveItemFormatSearchOrder(preferredFormat);for(const candidateId of candidateIds){for(const[type]of entries){for(const itemFormat of searchOrder){const itemPath=getItemPath(pmRoot,type,candidateId,itemFormat,typeToFolder);if(await fileExists(itemPath)){return{id:candidateId,type,itemPath,item_format:itemFormat}}}}}return null}async function readLocatedItem(item,options={}){const snapshot=await readLocatedItemSnapshot(item,options);if(snapshot.error!==null)throw snapshot.error;return{raw:snapshot.raw,document:snapshot.document}}async function readLocatedItemSnapshot(item,options={}){const bytes=await fs.readFile(item.itemPath);if(!isUtf8(bytes)){throw new PmCliError("Item contains invalid UTF-8; preserve a binary backup before recovering it.",EXIT_CODE.CONFLICT,{code:"item_document_encoding_invalid",item_id:item.id,item_path:item.itemPath,byte_length:bytes.length,empty:false})}const raw=bytes.toString("utf8");await runActiveOnReadHooks({path:item.itemPath,scope:"project"});let document;try{document=parseItemDocument(raw,{format:item.item_format,schema:options.schema,extensionFieldNames:resolveActiveExtensionFieldNames(options.extensionFieldNames),onWarning:warning=>appendWarning(options.warnings,warning)})}catch(error){if(error instanceof PmCliError&&error.code==="item_document_invalid"){return{raw,document:null,error:new PmCliError(`Cannot read ${item.id} at ${item.itemPath}${bytes.length===0?" (zero-length file)":""}: ${error.message}`,error.exitCode,{...error.context,item_id:item.id,item_path:item.itemPath,byte_length:bytes.length,empty:bytes.length===0,nextSteps:[`Run pm history ${item.id} --full, then pm restore ${item.id} <version> to recover a recorded state.`]})}}throw error}return{raw,document,error:null}}async function listAllItemMetadata(pmRoot,preferredFormat,typeToFolder=TYPE_TO_FOLDER,warnings,schema){await assertReadableTrackerRoot(pmRoot);const documents=await listAllDocumentsCached(pmRoot,preferredFormat,typeToFolder,warnings,schema);recordItemMetadataEnumeration(documents.length);return documents.map(document=>document.metadata)}async function listAllItemMetadataLight(pmRoot,preferredFormat,typeToFolder=TYPE_TO_FOLDER,warnings,schema){await assertReadableTrackerRoot(pmRoot);const documents=await listAllDocumentsCachedLight(pmRoot,preferredFormat,typeToFolder,warnings,schema);recordItemMetadataEnumeration(documents.length);return documents.map(document=>document.metadata)}async function listAllItemMetadataWithBody(pmRoot,preferredFormat,typeToFolder=TYPE_TO_FOLDER,warnings,schema,options={}){await assertReadableTrackerRoot(pmRoot);const candidates=await listAllDocumentCandidatesCached(pmRoot,preferredFormat,typeToFolder,warnings,schema,{includeBody:true,forceSourceScan:options.forceSourceScan});recordItemMetadataEnumeration(candidates.length);return candidates.map(candidate=>({...candidate.metadata,body:candidate.body}))}function createMutationGuardSdk(params){return{async get(id){const located=await locateItem(params.pmRoot,id,params.settings.id_prefix,params.settings.item_format,params.typeToFolder);if(!located)return null;const{document}=await readLocatedItem(located,{schema:params.settings.schema});return{item:document.metadata,body:document.body}},list:()=>listAllItemMetadata(params.pmRoot,params.settings.item_format,params.typeToFolder,void 0,params.settings.schema)}}async function listKnownItemIds(pmRoot,typeToFolder){const folders=new Set(Object.values(typeToFolder));const allIds=[];await Promise.all([...folders].map(async folder=>{try{const entries=await fs.readdir(path.join(pmRoot,folder));for(const entry of entries){for(const ext of ITEM_FILE_EXTENSIONS){if(entry.toLowerCase().endsWith(ext)){allIds.push(entry.slice(0,-ext.length));break}}}}catch{}}));return allIds}async function buildDidYouMeanSuggestions(pmRoot,badId,idPrefix,typeToFolder){const normalized=normalizeItemId(badId,idPrefix);const ids=await listKnownItemIds(pmRoot,typeToFolder);if(ids.length===0)return[];const limit=Math.max(3,Math.floor(normalized.length/2));const scored=ids.map(id=>({id,distance:levenshteinDistanceWithinLimit(id,normalized,limit)})).filter(entry=>entry.distance!==null).sort((left,right)=>left.distance-right.distance).slice(0,3).map(entry=>entry.id);return scored}async function buildItemNotFoundError(pmRoot,badId,idPrefix,typeToFolder){const suggestions=await buildDidYouMeanSuggestions(pmRoot,badId,idPrefix,typeToFolder);const nextSteps=["Confirm the active --path/PM_PATH scope, then retry with a valid id."];if(suggestions.length>0){nextSteps.unshift(`Did you mean one of: ${suggestions.join(", ")}?`)}return new PmCliError(`Item ${badId} not found`,EXIT_CODE.NOT_FOUND,{nextSteps})}function bypassesAssigneeConflict(op,bypassAssigneeConflict){return op==="claim"||bypassAssigneeConflict===true&&(op==="comment_add"||op==="comment_edit"||op==="comment_delete"||op==="note_add"||op==="learning_add"||op==="release"||op==="update"||op==="update_ownership_bypass"||op==="update_audit")}async function prepareLockedItem(params){const typeToFolder=params.typeToFolder??resolveItemTypeRegistry(params.settings,getActiveExtensionRegistrations()).type_to_folder;const located=await locateItem(params.pmRoot,params.id,params.settings.id_prefix,params.settings.item_format,typeToFolder);if(!located){throw await buildItemNotFoundError(params.pmRoot,params.id,params.settings.id_prefix,typeToFolder)}const releaseLock=await acquireLock(params.pmRoot,located.id,params.settings.locks.ttl_seconds,params.author,Boolean(params.force),params.settings.governance.force_required_for_stale_lock,params.settings.locks.wait_ms);try{const warnings=[];const{raw:originalRaw,document}=await readLocatedItem(located,{schema:params.settings.schema,extensionFieldNames:params.extensionFieldNames,warnings});const assigned=document.metadata.assignee?.trim();const assignedPrincipal=document.metadata.claim_principal?.trim()||assigned;const callerPrincipal=resolveClaimPrincipal(params.author);const governance=resolveGovernanceKnobs(params.settings);const hasOwnershipConflict=assigned&&assignedPrincipal!==callerPrincipal&&!params.force&&!bypassesAssigneeConflict(params.op,params.bypassAssigneeConflict);if(hasOwnershipConflict){if(governance.ownership_enforcement==="strict"){throw new PmCliError(`Item ${located.id} is assigned to ${assigned}. Use --force to override.`,EXIT_CODE.CONFLICT)}if(governance.ownership_enforcement==="warn"){warnings.push(`ownership_warning:assignee_conflict:${located.id}:${assigned}`)}}return{typeToFolder,located,originalRaw,document,warnings,releaseLock}}catch(error){await releaseLock();throw error}}function resolveItemStoreWriteOverride(serviceWriteOverride,targetItemPath,serializedAfter){if(!serviceWriteOverride.handled||typeof serviceWriteOverride.result!=="object"||serviceWriteOverride.result===null){return{effectiveTargetItemPath:targetItemPath,effectiveSerializedAfter:serializedAfter,skipItemWrite:false}}const overrideRecord=serviceWriteOverride.result;return{effectiveTargetItemPath:typeof overrideRecord.target_item_path==="string"&&overrideRecord.target_item_path.trim().length>0?overrideRecord.target_item_path:targetItemPath,effectiveSerializedAfter:typeof overrideRecord.contents==="string"?overrideRecord.contents:serializedAfter,skipItemWrite:overrideRecord.skip_write===true}}async function rollbackMutatedItemWrite(params){if(params.skipItemWrite){return}if(params.effectiveTargetItemPath!==params.originalItemPath){await writeFileAtomic(params.originalItemPath,params.originalRaw);await fs.rm(params.effectiveTargetItemPath,{force:true});return}await writeFileAtomic(params.originalItemPath,params.originalRaw)}async function mutateItemWithDeferredHistoryContext(params){const prepared=await prepareLockedItem({pmRoot:params.pmRoot,settings:params.settings,id:params.id,op:params.op,author:params.author,force:params.force,bypassAssigneeConflict:params.bypassAssigneeConflict,extensionFieldNames:params.extensionFieldNames,typeToFolder:params.typeToFolder});const{typeToFolder,located,originalRaw,document,warnings:parseWarnings,releaseLock}=prepared;try{const beforeDocument=canonicalDocument(document,{schema:params.settings.schema,extensionFieldNames:params.extensionFieldNames});const mutableDocument=canonicalDocument(structuredClone(document),{schema:params.settings.schema,extensionFieldNames:params.extensionFieldNames});const mutation=await params.mutate(mutableDocument);if(params.skipNoop===true&&mutation.changedFields.length===0){return{item:beforeDocument.metadata,body:beforeDocument.body,changedFields:[],warnings:[...parseWarnings,...mutation.warnings??[]]}}const historyContext=params.resolveHistoryContext?.();mutableDocument.metadata.updated_at=nowIso();const afterDocument=canonicalDocument(mutableDocument,{schema:params.settings.schema,extensionFieldNames:params.extensionFieldNames});const workflowPolicy=await enforceWorkflowMutation({pmRoot:params.pmRoot,settings:params.settings,operation:params.op,author:params.author,before:beforeDocument,after:afterDocument});await runActiveBeforeMutationHooks({pm_root:params.pmRoot,operation:params.op,before:beforeDocument,after:afterDocument,changed_fields:mutation.changedFields,sdk:createMutationGuardSdk({pmRoot:params.pmRoot,settings:params.settings,typeToFolder})});const historyPolicy=await enforceHistoryStreamPolicyForItem({pmRoot:params.pmRoot,settings:params.settings,itemId:located.id,commandLabel:params.op});const targetItemFormat="toon";const serializedAfter=serializeItemDocument(afterDocument,{format:targetItemFormat,schema:params.settings.schema,extensionFieldNames:params.extensionFieldNames});const targetItemPath=getItemPath(params.pmRoot,afterDocument.metadata.type,located.id,targetItemFormat,typeToFolder);const historyPath=getHistoryPath(params.pmRoot,located.id);const serviceWriteOverride=await runActiveServiceOverride("item_store_write",{op:params.op,pm_root:params.pmRoot,item_id:located.id,source_item_path:located.itemPath,target_item_path:targetItemPath,history_path:historyPath,item_format:targetItemFormat,before:beforeDocument,after:afterDocument,contents:serializedAfter});const{effectiveTargetItemPath,effectiveSerializedAfter,skipItemWrite}=resolveItemStoreWriteOverride(serviceWriteOverride,targetItemPath,serializedAfter);const releaseDerivedIndexLock=await acquireItemMetadataDerivedIndexLock(params.pmRoot,params.author);let derivedIndexWarnings=[];try{if(!skipItemWrite){await writeFileAtomic(effectiveTargetItemPath,effectiveSerializedAfter)}if(!skipItemWrite&&effectiveTargetItemPath!==located.itemPath){await fs.rm(located.itemPath)}const entry=createHistoryEntry({nowIso:afterDocument.metadata.updated_at,author:params.author,op:params.op,before:beforeDocument,after:afterDocument,message:params.message,context:workflowPolicy.decisions.length===0?historyContext:{...historyContext,workflow_policies:workflowPolicy.decisions}});try{await appendHistoryEntry(historyPath,entry)}catch(error){await rollbackMutatedItemWrite({skipItemWrite,effectiveTargetItemPath,originalItemPath:located.itemPath,originalRaw});throw error}if(!skipItemWrite){derivedIndexWarnings=await refreshItemMetadataDerivedIndex({pmRoot:params.pmRoot,preferredFormat:params.settings.item_format,typeToFolder,schema:params.settings.schema,itemPath:effectiveTargetItemPath,previousItemPath:located.itemPath,document:afterDocument})}}finally{await releaseDerivedIndexLock()}const hookWarnings=[...await runActiveOnWriteHooks({path:effectiveTargetItemPath,scope:"project",op:params.op,item_id:afterDocument.metadata.id,item_type:afterDocument.metadata.type,before:beforeDocument,after:afterDocument,changed_fields:mutation.changedFields}),...await runActiveOnWriteHooks({path:historyPath,scope:"project",op:`${params.op}:history`,item_id:afterDocument.metadata.id,item_type:afterDocument.metadata.type,before:beforeDocument,after:afterDocument,changed_fields:mutation.changedFields})];recordAfterCommandAffectedItem({id:afterDocument.metadata.id,op:params.op,item_type:afterDocument.metadata.type,previous_status:beforeDocument.metadata.status,status:afterDocument.metadata.status,previous:projectAfterCommandItemSnapshot(beforeDocument.metadata,mutation.changedFields),current:projectAfterCommandItemSnapshot(afterDocument.metadata,mutation.changedFields),changed_fields:mutation.changedFields});return{item:afterDocument.metadata,body:afterDocument.body,changedFields:mutation.changedFields,warnings:[...parseWarnings,...mutation.warnings??[],...workflowPolicy.warnings,...historyPolicy.warnings,...serviceWriteOverride.warnings,...derivedIndexWarnings,...hookWarnings]}}finally{await releaseLock()}}async function mutateItemWithHistoryContext(params){const{historyContext,...mutationParams}=params;return mutateItemWithDeferredHistoryContext({...mutationParams,resolveHistoryContext:()=>historyContext})}async function mutateItemWithHistoryContextResolver(params){return mutateItemWithDeferredHistoryContext(params)}async function mutateItem(params){return mutateItemWithDeferredHistoryContext(params)}const itemStoreTestOnly={appendWarning,bypassesAssigneeConflict,buildDidYouMeanSuggestions,isErrno};async function deleteItem(params){const prepared=await prepareLockedItem({pmRoot:params.pmRoot,settings:params.settings,id:params.id,op:"delete",author:params.author,force:params.force});const{located,originalRaw,document,warnings:parseWarnings,releaseLock}=prepared;try{const extensionFieldNames=resolveActiveExtensionFieldNames(void 0);const beforeDocument=canonicalDocument(document,{schema:params.settings.schema,extensionFieldNames});const workflowPolicy=await enforceWorkflowMutation({pmRoot:params.pmRoot,settings:params.settings,operation:"delete",author:params.author,before:beforeDocument,after:null,dryRun:params.dryRun});await runActiveBeforeMutationHooks({pm_root:params.pmRoot,operation:"delete",before:beforeDocument,after:null,changed_fields:["deleted"],sdk:createMutationGuardSdk({pmRoot:params.pmRoot,settings:params.settings,typeToFolder:prepared.typeToFolder})});const historyPolicy=await enforceHistoryStreamPolicyForItem({pmRoot:params.pmRoot,settings:params.settings,itemId:located.id,commandLabel:"delete"});const deletionTimestamp=nowIso();const tombstoneDocument=EMPTY_CANONICAL_DOCUMENT;const historyEntry=createHistoryEntry({nowIso:deletionTimestamp,author:params.author,op:"delete",before:beforeDocument,after:tombstoneDocument,message:params.message,context:workflowPolicy.decisions.length===0?void 0:{workflow_policies:workflowPolicy.decisions}});const historyPath=getHistoryPath(params.pmRoot,located.id);const serviceDeleteOverride=await runActiveServiceOverride("item_store_delete",{op:"delete",pm_root:params.pmRoot,item_id:located.id,item_path:located.itemPath,history_path:historyPath,before:beforeDocument});let effectiveItemPath=located.itemPath;let skipDelete=false;if(serviceDeleteOverride.handled&&typeof serviceDeleteOverride.result==="object"&&serviceDeleteOverride.result!==null){const overrideRecord=serviceDeleteOverride.result;if(typeof overrideRecord.item_path==="string"&&overrideRecord.item_path.trim().length>0){effectiveItemPath=overrideRecord.item_path}if(overrideRecord.skip_delete===true){skipDelete=true}}if(params.dryRun===true){return{item:beforeDocument.metadata,changedFields:["deleted"],targetPath:effectiveItemPath,warnings:[...parseWarnings,...workflowPolicy.warnings,...historyPolicy.warnings,...serviceDeleteOverride.warnings]}}const releaseDerivedIndexLock=await acquireItemMetadataDerivedIndexLock(params.pmRoot,params.author);let derivedIndexWarnings=[];try{if(!skipDelete){await fs.rm(effectiveItemPath)}try{await appendHistoryEntry(historyPath,historyEntry)}catch(error){if(!skipDelete){await writeFileAtomic(effectiveItemPath,originalRaw)}throw error}if(!skipDelete){derivedIndexWarnings=await refreshItemMetadataDerivedIndex({pmRoot:params.pmRoot,preferredFormat:params.settings.item_format,typeToFolder:prepared.typeToFolder,schema:params.settings.schema,itemPath:effectiveItemPath,document:null})}}finally{await releaseDerivedIndexLock()}const hookWarnings=[...await runActiveOnWriteHooks({path:effectiveItemPath,scope:"project",op:"delete",item_id:beforeDocument.metadata.id,item_type:beforeDocument.metadata.type,before:beforeDocument,after:tombstoneDocument,changed_fields:["deleted"]}),...await runActiveOnWriteHooks({path:historyPath,scope:"project",op:"delete:history",item_id:beforeDocument.metadata.id,item_type:beforeDocument.metadata.type,before:beforeDocument,after:tombstoneDocument,changed_fields:["deleted"]})];recordAfterCommandAffectedItem({id:beforeDocument.metadata.id,op:"delete",item_type:beforeDocument.metadata.type,previous_status:beforeDocument.metadata.status,previous:projectAfterCommandItemSnapshot(beforeDocument.metadata,Object.keys(beforeDocument.metadata)),changed_fields:["deleted"]});return{item:beforeDocument.metadata,changedFields:["deleted"],warnings:[...parseWarnings,...workflowPolicy.warnings,...historyPolicy.warnings,...serviceDeleteOverride.warnings,...derivedIndexWarnings,...hookWarnings]}}finally{await releaseLock()}}export{buildItemNotFoundError,createMutationGuardSdk,deleteItem,itemStoreTestOnly,listAllItemMetadata,listAllItemMetadataLight,listAllItemMetadataWithBody,locateItem,mutateItem,mutateItemWithHistoryContext,mutateItemWithHistoryContextResolver,readLocatedItem,readLocatedItemSnapshot};
|
|
693
2
|
//# sourceMappingURL=item-store.js.map
|
|
694
|
-
//# debugId=7cbc256e-cdd8-51de-9c22-08cf2f3cd010
|