@unbrained/pm-cli 2026.10.14 → 2026.10.17
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/references/COMMAND_PLAYBOOK.md +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/AGENTS.md +1 -0
- package/CHANGELOG.md +74 -2
- package/dist/cli/after-command-context-usage.d.ts +7 -7
- package/dist/cli/argv-utils.d.ts +4 -4
- package/dist/cli/bundle-integrity.d.ts +16 -16
- package/dist/cli/command-namespaces.d.ts +1 -1
- package/dist/cli/commander-usage.d.ts +34 -34
- package/dist/cli/commands/governance/validate.d.ts +1 -1
- package/dist/cli/commands/history/history-compact.d.ts +1 -1
- package/dist/cli/commands/history/history-redact.d.ts +1 -1
- package/dist/cli/commands/history/history-repair.d.ts +1 -1
- package/dist/cli/commands/history/restore.d.ts +1 -1
- package/dist/cli/commands/lifecycle/close.d.ts +1 -1
- package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
- package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
- package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
- package/dist/cli/commands/query/get.d.ts +1 -1
- package/dist/cli/commands/workspace/merge.d.ts +1 -1
- package/dist/cli/commands/workspace/schema.d.ts +1 -1
- package/dist/cli/context-intent-invocation.d.ts +1 -1
- package/dist/cli/description-stdin.d.ts +1 -1
- package/dist/cli/error-guidance.d.ts +119 -119
- package/dist/cli/extension-command-help.d.ts +64 -64
- package/dist/cli/extension-command-help.js +2 -2
- package/dist/cli/extension-command-options.d.ts +18 -16
- package/dist/cli/extension-command-options.js +1 -1
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +3 -3
- package/dist/cli/help-json-payload.d.ts +45 -45
- package/dist/cli/invocation-profile.d.ts +5 -5
- package/dist/cli/main.d.ts +217 -217
- package/dist/cli/migration-gates.d.ts +24 -24
- package/dist/cli/option-values.d.ts +1 -1
- package/dist/cli/public.d.ts +1 -1
- package/dist/cli/register-annotations.d.ts +2 -2
- package/dist/cli/register-assurance.d.ts +1 -1
- package/dist/cli/register-files-lookup.d.ts +1 -1
- package/dist/cli/register-history-activity.d.ts +1 -1
- package/dist/cli/register-history-author.d.ts +1 -1
- package/dist/cli/register-history-maintenance.d.ts +1 -1
- package/dist/cli/register-list-query.d.ts +7 -7
- package/dist/cli/register-list-query.js +3 -3
- package/dist/cli/register-mutation-options.d.ts +1 -1
- package/dist/cli/register-mutation.d.ts +4 -4
- package/dist/cli/register-mutation.js +2 -2
- package/dist/cli/register-operations.d.ts +75 -75
- package/dist/cli/register-operations.js +1 -1
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -13
- package/dist/cli/register-structured-mutation.js +1 -1
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- package/dist/cli/runtime/invocation-options.js +1 -1
- package/dist/cli/runtime/projection-retry.d.ts +1 -1
- package/dist/cli/runtime/selection.d.ts +16 -16
- package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
- package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
- package/dist/cli/schema/registration.d.ts +1 -1
- package/dist/cli/schema-registration-helpers.d.ts +2 -2
- package/dist/cli/stats-analytics-json.d.ts +1 -1
- package/dist/cli-bundle/bundle-manifest.json +1 -1
- package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-3QKI3XNX.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-4PNPDT2N.js +236 -0
- package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-6ZDKKOKM.js} +28 -28
- package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-B5QVGCZX.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-EA2CG7UM.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-HY7FQ7QX.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-J4LPQCET.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-JS3B2M4D.js +6 -0
- package/dist/cli-bundle/chunks/chunk-O4YBC3OM.js +30 -0
- package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-OZCSXX4D.js} +63 -64
- package/dist/cli-bundle/chunks/chunk-VMCSTFSO.js +2 -0
- package/dist/cli-bundle/chunks/chunk-W3KZ22DW.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-X2ONXFBP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-X53HM753.js +20 -0
- package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-RU3QZSAQ.js} +7 -7
- package/dist/cli-bundle/chunks/register-mutation-EQYMT32A.js +20 -0
- package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-VXBGE4XI.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-UUDEGFRO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-2IOHHNRT.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-5JEFDEL3.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-AH6NX6GM.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-E33QA7PK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-FTUZ3JF2.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-JXR6UKFM.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-LDKX4KYJ.js +2 -0
- package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-MBQF6HT6.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-NZO7GOXD.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-PYC7BF6Z.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-QOSVJDOO.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-RBLSY6ML.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-RHTH5ILM.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-SIGIGZCG.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-TRFVAWF2.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-UNTQE37U.js} +2 -2
- package/dist/cli-bundle/main.js +22 -22
- 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 +23 -23
- 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 +54 -54
- 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 +7 -7
- package/dist/cli.d.ts +9 -9
- package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
- package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
- package/dist/core/config/nested-settings.d.ts +20 -20
- package/dist/core/config/positional-value.d.ts +9 -9
- package/dist/core/diagnostics/remediation.d.ts +7 -7
- package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
- package/dist/core/extensions/activation-summary.d.ts +30 -30
- package/dist/core/extensions/activation-transaction.d.ts +9 -9
- package/dist/core/extensions/capability-usage.d.ts +25 -25
- package/dist/core/extensions/command-hook-context.d.ts +15 -15
- package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
- package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
- package/dist/core/extensions/contribution-inventory.d.ts +24 -24
- package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
- package/dist/core/extensions/extension-candidate.d.ts +14 -14
- package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
- package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
- package/dist/core/extensions/extension-policy.d.ts +62 -62
- package/dist/core/extensions/extension-registries.d.ts +8 -8
- package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
- package/dist/core/extensions/extension-types.d.ts +717 -702
- package/dist/core/extensions/extension-types.js +1 -1
- package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
- package/dist/core/extensions/flag-value-types.d.ts +32 -4
- package/dist/core/extensions/flag-value-types.js +1 -1
- package/dist/core/extensions/index.d.ts +34 -34
- package/dist/core/extensions/item-field-types.d.ts +3 -3
- package/dist/core/extensions/item-fields.d.ts +6 -6
- package/dist/core/extensions/loader.d.ts +66 -66
- package/dist/core/extensions/manifest-parser.d.ts +1 -1
- package/dist/core/extensions/manifest-schema.d.ts +13 -13
- package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
- package/dist/core/extensions/preflight-ownership.d.ts +3 -3
- package/dist/core/extensions/read-output-contract.d.ts +2 -2
- package/dist/core/extensions/registration-contracts.d.ts +12 -12
- package/dist/core/extensions/registration-contracts.js +1 -1
- package/dist/core/extensions/registration-validation.d.ts +6 -6
- package/dist/core/extensions/registration-values.d.ts +19 -19
- package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
- package/dist/core/extensions/runtime-registrations.d.ts +6 -6
- package/dist/core/extensions/service-ownership.d.ts +1 -1
- package/dist/core/extensions/version-compat.d.ts +9 -9
- package/dist/core/fs/atomic-create.d.ts +1 -1
- package/dist/core/fs/fs-utils.d.ts +12 -12
- package/dist/core/fs/host-environment-errors.d.ts +10 -10
- package/dist/core/fs/path-utils.d.ts +1 -1
- package/dist/core/governance/content-fields.d.ts +25 -25
- package/dist/core/governance/issue-codes.d.ts +16 -16
- package/dist/core/governance/metadata-coverage.d.ts +64 -64
- package/dist/core/history/digest.d.ts +5 -5
- package/dist/core/history/drift-cache.d.ts +2 -2
- package/dist/core/history/drift-scan.d.ts +18 -18
- package/dist/core/history/event-classification.d.ts +4 -4
- package/dist/core/history/event-index.d.ts +33 -33
- package/dist/core/history/history-compact-bulk.d.ts +12 -12
- package/dist/core/history/history-diff.d.ts +15 -15
- package/dist/core/history/history-rewrite.d.ts +43 -43
- package/dist/core/history/history-storage-stats.d.ts +20 -20
- package/dist/core/history/history-stream-policy.d.ts +12 -12
- package/dist/core/history/history.d.ts +45 -45
- package/dist/core/history/identity.d.ts +4 -4
- package/dist/core/history/operation-contract.d.ts +17 -17
- package/dist/core/history/projection.d.ts +16 -16
- package/dist/core/history/read.d.ts +4 -4
- package/dist/core/history/replay.d.ts +47 -47
- package/dist/core/history/tombstone.d.ts +1 -1
- package/dist/core/history/version-address.d.ts +2 -2
- package/dist/core/history/workspace-history.d.ts +72 -72
- package/dist/core/io/body-file.d.ts +2 -2
- package/dist/core/io/bulk-ids-input.d.ts +7 -7
- package/dist/core/item/actionability.d.ts +30 -30
- package/dist/core/item/dependency-reference.d.ts +2 -2
- package/dist/core/item/id.d.ts +9 -9
- package/dist/core/item/item-format-version.d.ts +17 -15
- package/dist/core/item/item-format-version.js +1 -1
- package/dist/core/item/item-format.d.ts +54 -54
- package/dist/core/item/item-format.js +3 -3
- package/dist/core/item/item-record.d.ts +1 -1
- package/dist/core/item/item-type-definition.d.ts +11 -11
- package/dist/core/item/parent-reference-policy.d.ts +6 -6
- package/dist/core/item/parse.d.ts +37 -37
- package/dist/core/item/plan-lifecycle.d.ts +4 -4
- package/dist/core/item/priority.d.ts +3 -3
- package/dist/core/item/sprint-release-format.d.ts +4 -4
- package/dist/core/item/status-filter.d.ts +5 -5
- package/dist/core/item/status.d.ts +3 -3
- package/dist/core/item/toon-decode.d.ts +10 -10
- package/dist/core/item/type-registry.d.ts +35 -35
- package/dist/core/item/type-synonyms.d.ts +2 -2
- package/dist/core/lock/lock-gc.d.ts +28 -28
- package/dist/core/lock/lock.d.ts +53 -53
- package/dist/core/output/mutation-projection.d.ts +4 -25
- package/dist/core/output/mutation-projection.js +1 -1
- package/dist/core/output/output-control.d.ts +4 -4
- package/dist/core/output/output.d.ts +30 -30
- package/dist/core/output/query-summary.d.ts +5 -5
- package/dist/core/output/tabular.d.ts +3 -3
- package/dist/core/packages/manifest.d.ts +30 -30
- package/dist/core/packages/root.d.ts +4 -4
- package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
- package/dist/core/policy/workflow-policy-store.d.ts +15 -15
- package/dist/core/policy/workflow-policy.d.ts +56 -56
- package/dist/core/profile/profile-describe.d.ts +22 -22
- package/dist/core/profile/profile-lint.d.ts +13 -13
- package/dist/core/profile/profile-plan.d.ts +45 -45
- package/dist/core/profile/profile-presets.d.ts +36 -36
- package/dist/core/reproducibility/context.d.ts +9 -9
- package/dist/core/schema/fields-file.d.ts +35 -35
- package/dist/core/schema/item-types-file.d.ts +29 -29
- package/dist/core/schema/runtime-field-filters.d.ts +3 -3
- package/dist/core/schema/runtime-field-values.d.ts +7 -7
- package/dist/core/schema/runtime-schema.d.ts +59 -59
- package/dist/core/schema/status-defs-file.d.ts +29 -29
- package/dist/core/schema/status-token.d.ts +1 -1
- package/dist/core/schema/type-inference.d.ts +10 -10
- package/dist/core/schema/type-presets.d.ts +5 -5
- package/dist/core/schema/type-workflows.d.ts +15 -15
- package/dist/core/schema/type-workflows.js +1 -1
- package/dist/core/search/background-refresh.d.ts +12 -12
- package/dist/core/search/bm25.d.ts +16 -16
- package/dist/core/search/cache.d.ts +34 -34
- package/dist/core/search/corpus.d.ts +17 -17
- package/dist/core/search/embedding-batches.d.ts +25 -25
- package/dist/core/search/eval-thresholds.d.ts +4 -4
- package/dist/core/search/eval.d.ts +40 -40
- package/dist/core/search/http-client.d.ts +24 -24
- package/dist/core/search/providers.d.ts +30 -30
- package/dist/core/search/relevance.d.ts +17 -17
- package/dist/core/search/semantic-defaults.d.ts +5 -5
- package/dist/core/search/staleness.d.ts +3 -3
- package/dist/core/search/vector-stores.d.ts +51 -51
- package/dist/core/search/vectorization-metadata.d.ts +9 -9
- package/dist/core/sentry/helpers.d.ts +27 -27
- package/dist/core/sentry/instrument.d.ts +51 -51
- package/dist/core/sentry/instrument.js +1 -1
- package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
- package/dist/core/sentry/sensitive-assignments.js +2 -0
- package/dist/core/session/session-state.d.ts +37 -37
- package/dist/core/shared/agent-session-context.d.ts +14 -14
- package/dist/core/shared/author.d.ts +89 -89
- package/dist/core/shared/command-line.d.ts +3 -3
- package/dist/core/shared/command-types.d.ts +20 -20
- package/dist/core/shared/conflict-markers.d.ts +5 -5
- package/dist/core/shared/constants.d.ts +30 -30
- package/dist/core/shared/errors.d.ts +100 -100
- package/dist/core/shared/html-entity-decode.d.ts +2 -2
- package/dist/core/shared/item-metadata-contract.d.ts +2 -2
- package/dist/core/shared/lazy-module.d.ts +1 -1
- package/dist/core/shared/levenshtein.d.ts +1 -1
- package/dist/core/shared/memo.d.ts +1 -1
- package/dist/core/shared/numeric-parsers.d.ts +1 -1
- package/dist/core/shared/option-alias-visibility.d.ts +3 -3
- package/dist/core/shared/primitives.d.ts +13 -13
- package/dist/core/shared/secret-rules.d.ts +92 -92
- package/dist/core/shared/serial-queue.d.ts +6 -6
- package/dist/core/shared/serialization.d.ts +4 -4
- package/dist/core/shared/split-comma-list.d.ts +4 -4
- package/dist/core/shared/text-normalization.d.ts +5 -3
- package/dist/core/shared/text-normalization.js +1 -1
- package/dist/core/shared/time.d.ts +27 -27
- package/dist/core/store/item-format-migration.d.ts +7 -7
- package/dist/core/store/item-metadata-cache.d.ts +30 -30
- package/dist/core/store/item-metadata-query-index.d.ts +66 -66
- package/dist/core/store/item-metadata-read-work.d.ts +6 -6
- package/dist/core/store/item-mutation-precondition.d.ts +11 -0
- package/dist/core/store/item-mutation-precondition.js +2 -0
- package/dist/core/store/item-store.d.ts +123 -123
- package/dist/core/store/item-store.js +1 -1
- package/dist/core/store/paths.d.ts +27 -27
- package/dist/core/store/settings-concurrency.d.ts +1 -1
- package/dist/core/store/settings-read-cache.d.ts +11 -11
- package/dist/core/store/settings-validator.d.ts +117 -117
- package/dist/core/store/settings.d.ts +84 -84
- package/dist/core/store/sqlite-runtime.d.ts +2 -2
- package/dist/core/store/tracker-preflight.d.ts +3 -3
- package/dist/core/telemetry/consent.d.ts +1 -1
- package/dist/core/telemetry/observability.d.ts +16 -16
- package/dist/core/telemetry/policy.d.ts +7 -7
- package/dist/core/telemetry/read-sampling.d.ts +1 -1
- package/dist/core/telemetry/runtime.d.ts +275 -275
- package/dist/core/test/background-runs.d.ts +123 -123
- package/dist/core/test/item-test-run-tracking.d.ts +10 -10
- package/dist/core/test/run-selectors.d.ts +12 -12
- package/dist/core/validate/estimate-defaults.d.ts +3 -3
- package/dist/core/validate/fix-planning.d.ts +36 -36
- package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
- package/dist/core/validate/missing-by-type.d.ts +3 -3
- package/dist/core/validate/missing-link-owners.d.ts +17 -17
- package/dist/core/validate/stale-file-classification.d.ts +6 -6
- package/dist/mcp/http-server.d.ts +26 -26
- package/dist/mcp/legacy-adapter.d.ts +18 -18
- package/dist/mcp/runtime-capabilities.d.ts +18 -18
- package/dist/mcp/server.d.ts +73 -73
- package/dist/mcp/server.js +1 -1
- package/dist/mcp/tool-definitions.d.ts +27 -27
- package/dist/mcp/tool-definitions.js +1 -1
- package/dist/sdk/actionability.d.ts +1 -1
- package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
- package/dist/sdk/agent/command-recovery.d.ts +5 -5
- package/dist/sdk/agent/command-suggestions.d.ts +4 -4
- package/dist/sdk/agent/create-option-policy.d.ts +2 -2
- package/dist/sdk/agent/identity-config.d.ts +18 -18
- package/dist/sdk/agent/item-addressing.d.ts +6 -6
- package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
- package/dist/sdk/agent/refusal-closure.d.ts +22 -22
- package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
- package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
- package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
- package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
- package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
- package/dist/sdk/agent-capability-contracts.d.ts +41 -41
- package/dist/sdk/agent-session-context.d.ts +1 -1
- package/dist/sdk/annotations.d.ts +74 -74
- package/dist/sdk/author-attribution.d.ts +47 -47
- package/dist/sdk/authoring.d.ts +9 -9
- package/dist/sdk/cli-bootstrap.d.ts +65 -65
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
- package/dist/sdk/cli-contracts/agent-output-contracts.js +1 -1
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
- package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
- package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
- package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
- package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
- package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
- package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
- package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -1
- package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +57 -57
- package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
- package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
- package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
- package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
- package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
- package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
- package/dist/sdk/cli-contracts/tool-schema.js +1 -1
- package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
- package/dist/sdk/cli-contracts.d.ts +15 -15
- package/dist/sdk/cli-program.d.ts +1 -1
- package/dist/sdk/cli-program.js +1 -1
- package/dist/sdk/command-line.d.ts +3 -3
- package/dist/sdk/comments.d.ts +24 -24
- package/dist/sdk/compile-cache.d.ts +4 -4
- package/dist/sdk/completion/bash.d.ts +1 -1
- package/dist/sdk/completion/fish.d.ts +1 -1
- package/dist/sdk/completion/shared.d.ts +74 -74
- package/dist/sdk/completion/zsh.d.ts +1 -1
- package/dist/sdk/completion.d.ts +3 -3
- package/dist/sdk/compose.d.ts +94 -94
- package/dist/sdk/config.d.ts +105 -105
- package/dist/sdk/context/recency.d.ts +1 -1
- package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
- package/dist/sdk/context/usage-egress.d.ts +1 -1
- package/dist/sdk/context/usage-ledger.d.ts +18 -18
- package/dist/sdk/context-intent-contracts.d.ts +37 -37
- package/dist/sdk/context-intent-contracts.js +1 -1
- package/dist/sdk/context-intent-runtime.d.ts +10 -10
- package/dist/sdk/context-packing.d.ts +44 -44
- package/dist/sdk/context-relevance.d.ts +110 -110
- package/dist/sdk/context-signal-store.d.ts +52 -52
- package/dist/sdk/context-usage.d.ts +78 -78
- package/dist/sdk/contracts.d.ts +2 -1
- package/dist/sdk/contracts.js +1 -1
- package/dist/sdk/core-governance.d.ts +5 -5
- package/dist/sdk/core.d.ts +9 -8
- package/dist/sdk/core.js +1 -1
- package/dist/sdk/corpus-shape.d.ts +60 -60
- package/dist/sdk/define.d.ts +36 -36
- package/dist/sdk/dependencies.d.ts +70 -70
- package/dist/sdk/dependency-flag-validation.d.ts +17 -17
- package/dist/sdk/dependency-provenance.d.ts +22 -22
- package/dist/sdk/docs.d.ts +17 -17
- package/dist/sdk/duplicates.d.ts +14 -14
- package/dist/sdk/environment/agent-environment.d.ts +118 -118
- package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
- package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
- package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
- package/dist/sdk/environment/source-context.d.ts +4 -4
- package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
- package/dist/sdk/error-code-catalog.d.ts +33 -33
- package/dist/sdk/error-runtime.d.ts +5 -5
- package/dist/sdk/errors.d.ts +17 -17
- package/dist/sdk/eval.d.ts +27 -27
- package/dist/sdk/extension/author-manifest.d.ts +9 -9
- package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
- package/dist/sdk/extension/concurrency.d.ts +1 -1
- package/dist/sdk/extension/copy-scope.d.ts +1 -1
- package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
- package/dist/sdk/extension/describe.d.ts +21 -21
- package/dist/sdk/extension/doctor.d.ts +46 -46
- package/dist/sdk/extension/install-plan.d.ts +32 -32
- package/dist/sdk/extension/install-receipts.d.ts +4 -4
- package/dist/sdk/extension/install-runtime.d.ts +12 -12
- package/dist/sdk/extension/install-snapshot.d.ts +10 -10
- package/dist/sdk/extension/install-sources.d.ts +106 -106
- package/dist/sdk/extension/managed-state.d.ts +42 -42
- package/dist/sdk/extension/managed-update-status.d.ts +1 -1
- package/dist/sdk/extension/migrations.d.ts +48 -48
- package/dist/sdk/extension/output-ownership.d.ts +19 -19
- package/dist/sdk/extension/runtime-summary.d.ts +7 -7
- package/dist/sdk/extension/scaffold.d.ts +15 -15
- package/dist/sdk/extension/shared.d.ts +16 -16
- package/dist/sdk/extension/source-resolution.d.ts +16 -16
- package/dist/sdk/extension/static-inventory.d.ts +23 -23
- package/dist/sdk/extension/update-check.d.ts +9 -9
- package/dist/sdk/extension-command-context.d.ts +1 -1
- package/dist/sdk/extension-contracts.d.ts +10 -10
- package/dist/sdk/extension.d.ts +221 -221
- package/dist/sdk/files.d.ts +101 -101
- package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
- package/dist/sdk/flag-invocation-contracts.js +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
- package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
- package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
- package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
- package/dist/sdk/governance/assurance-action.d.ts +46 -46
- package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
- package/dist/sdk/governance/assurance-presets.d.ts +25 -25
- package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
- package/dist/sdk/governance/assurance.d.ts +204 -204
- package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
- package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
- package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
- package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
- package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
- package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
- package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
- package/dist/sdk/governance/extension-host-version.d.ts +9 -9
- package/dist/sdk/governance/gc.d.ts +26 -26
- package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
- package/dist/sdk/governance/health.d.ts +172 -172
- package/dist/sdk/governance/health.js +1 -1
- package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
- package/dist/sdk/governance/linked-file-report.d.ts +15 -15
- package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
- package/dist/sdk/governance/provenance-health.d.ts +35 -35
- package/dist/sdk/governance/reindex.d.ts +102 -102
- package/dist/sdk/governance/reliability.d.ts +29 -29
- package/dist/sdk/governance/stale-work.d.ts +13 -13
- package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
- package/dist/sdk/governance/storage-integrity.d.ts +28 -28
- package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
- package/dist/sdk/governance/upgrade.d.ts +77 -77
- package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
- package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
- package/dist/sdk/governance/validate-normalization.d.ts +4 -4
- package/dist/sdk/governance/validate.d.ts +176 -176
- package/dist/sdk/governance/validate.js +1 -1
- package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
- package/dist/sdk/governance/workflow-policy.d.ts +18 -18
- package/dist/sdk/governance/workspace-position.d.ts +40 -40
- package/dist/sdk/governance.d.ts +2 -2
- package/dist/sdk/graph/adapter.d.ts +45 -45
- package/dist/sdk/graph/analytics.d.ts +36 -36
- package/dist/sdk/graph/assembly.d.ts +51 -51
- package/dist/sdk/graph/cache.d.ts +19 -19
- package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
- package/dist/sdk/graph/centrality.d.ts +20 -20
- package/dist/sdk/graph/conformance.d.ts +21 -21
- package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
- package/dist/sdk/graph/durable-cache.d.ts +22 -22
- package/dist/sdk/graph/governance-contracts.d.ts +1 -1
- package/dist/sdk/graph/governance.d.ts +92 -92
- package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
- package/dist/sdk/graph/index.d.ts +15 -15
- package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
- package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
- package/dist/sdk/graph/query-contracts.d.ts +6 -6
- package/dist/sdk/graph/remediation.d.ts +15 -15
- package/dist/sdk/graph/run.d.ts +203 -203
- package/dist/sdk/graph/scheduling.d.ts +21 -21
- package/dist/sdk/graph/traversal.d.ts +18 -18
- package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
- package/dist/sdk/guide-topics.d.ts +19 -19
- package/dist/sdk/guide-topics.js +1 -1
- package/dist/sdk/guide.d.ts +43 -43
- package/dist/sdk/history/attestation-command.d.ts +8 -8
- package/dist/sdk/history/attestation-contract.d.ts +43 -43
- package/dist/sdk/history/attestation-scan.d.ts +4 -4
- package/dist/sdk/history/attestation.d.ts +4 -4
- package/dist/sdk/history/maintenance.d.ts +25 -25
- package/dist/sdk/history/salvage.d.ts +19 -19
- package/dist/sdk/history/subject.d.ts +8 -8
- package/dist/sdk/history-analytics.d.ts +64 -64
- package/dist/sdk/history-compact.d.ts +67 -67
- package/dist/sdk/history-mcp.d.ts +7 -7
- package/dist/sdk/history-provenance.d.ts +40 -40
- package/dist/sdk/history-read.d.ts +24 -24
- package/dist/sdk/history-redact.d.ts +68 -68
- package/dist/sdk/history-repair.d.ts +92 -92
- package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
- package/dist/sdk/improvement-ledger.d.ts +62 -62
- package/dist/sdk/index.d.ts +70 -69
- package/dist/sdk/index.js +1 -1
- package/dist/sdk/init-agent-guidance.d.ts +68 -68
- package/dist/sdk/init.d.ts +117 -117
- package/dist/sdk/invocation-author.d.ts +1 -1
- package/dist/sdk/item-children.d.ts +15 -15
- package/dist/sdk/item-metadata-index.d.ts +2 -2
- package/dist/sdk/item-schedule.d.ts +9 -9
- package/dist/sdk/item-transaction.d.ts +139 -76
- package/dist/sdk/item-transaction.js +1 -1
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +53 -39
- package/dist/sdk/lifecycle/claim.js +1 -1
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -24
- package/dist/sdk/lifecycle/close.js +1 -1
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- package/dist/sdk/lifecycle/core-item-fields.d.ts +6 -0
- package/dist/sdk/lifecycle/core-item-fields.js +2 -0
- package/dist/sdk/lifecycle/create.d.ts +88 -88
- package/dist/sdk/lifecycle/delete.d.ts +15 -15
- package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
- package/dist/sdk/lifecycle/focus.d.ts +6 -6
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
- package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
- package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
- package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
- package/dist/sdk/lifecycle/mcp-actions.js +1 -1
- package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
- package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
- package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
- package/dist/sdk/lifecycle/mutation-option-validation.d.ts +2 -0
- package/dist/sdk/lifecycle/mutation-option-validation.js +2 -0
- package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
- package/dist/sdk/lifecycle/plan.d.ts +127 -127
- package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
- package/dist/sdk/lifecycle/release-handoff.d.ts +12 -0
- package/dist/sdk/lifecycle/release-handoff.js +2 -0
- package/dist/sdk/lifecycle/reopen.d.ts +15 -15
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
- package/dist/sdk/lifecycle/restore.d.ts +34 -34
- package/dist/sdk/lifecycle/restore.js +1 -1
- package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
- package/dist/sdk/lifecycle/structured-mutation-plan.d.ts +33 -0
- package/dist/sdk/lifecycle/structured-mutation-plan.js +2 -0
- package/dist/sdk/lifecycle/task-composition.d.ts +9 -9
- package/dist/sdk/lifecycle/task-composition.js +1 -1
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +113 -121
- package/dist/sdk/lifecycle/update.js +1 -1
- package/dist/sdk/lifecycle/workflow-transition.d.ts +13 -0
- package/dist/sdk/lifecycle/workflow-transition.js +2 -0
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +42 -32
- package/dist/sdk/lifecycle-policy.js +1 -1
- package/dist/sdk/linked-artifacts.d.ts +58 -58
- package/dist/sdk/mcp/apps.d.ts +28 -28
- package/dist/sdk/mcp/authorization.d.ts +66 -66
- package/dist/sdk/mcp/discovery.d.ts +67 -67
- package/dist/sdk/mcp/interactions.d.ts +49 -49
- package/dist/sdk/mcp/protocol.d.ts +63 -63
- package/dist/sdk/mcp/skills.d.ts +62 -62
- package/dist/sdk/mcp/subscriptions.d.ts +26 -26
- package/dist/sdk/mcp/tasks.d.ts +51 -51
- package/dist/sdk/mcp/transport.d.ts +17 -17
- package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
- package/dist/sdk/merge/driver.d.ts +38 -38
- package/dist/sdk/merge/index.d.ts +5 -5
- package/dist/sdk/merge/install.d.ts +48 -48
- package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
- package/dist/sdk/merge/receipt-operation.d.ts +6 -6
- package/dist/sdk/merge/receipt-schema.d.ts +11 -11
- package/dist/sdk/merge/receipts.d.ts +111 -111
- package/dist/sdk/merge/reconcile.d.ts +20 -20
- package/dist/sdk/merge/three-way.d.ts +50 -50
- package/dist/sdk/merge/three-way.js +2 -2
- package/dist/sdk/merge/worktree-config.d.ts +3 -3
- package/dist/sdk/mutation-events.d.ts +62 -62
- package/dist/sdk/mutation-guard.d.ts +134 -134
- package/dist/sdk/notes.d.ts +28 -28
- package/dist/sdk/output/table-rows.d.ts +6 -6
- package/dist/sdk/output-contracts.d.ts +26 -26
- package/dist/sdk/output-projection.d.ts +108 -108
- package/dist/sdk/output-token-accounting.d.ts +18 -18
- package/dist/sdk/output.d.ts +18 -18
- package/dist/sdk/ownership-source.d.ts +1 -1
- package/dist/sdk/package-import-adapters.d.ts +51 -51
- package/dist/sdk/package-migrations.d.ts +3 -3
- package/dist/sdk/package-runtime-options.d.ts +3 -3
- package/dist/sdk/pagination.d.ts +28 -28
- package/dist/sdk/pagination.js +1 -1
- package/dist/sdk/profile.d.ts +72 -72
- package/dist/sdk/provenance.d.ts +37 -37
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.d.ts +84 -84
- package/dist/sdk/query/aggregate.d.ts +109 -109
- package/dist/sdk/query/calendar.d.ts +95 -95
- package/dist/sdk/query/complete-list.d.ts +35 -35
- package/dist/sdk/query/context.d.ts +300 -300
- package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
- package/dist/sdk/query/get.d.ts +54 -54
- package/dist/sdk/query/history.d.ts +38 -38
- package/dist/sdk/query/item-filter-options.d.ts +41 -41
- package/dist/sdk/query/light-metadata.d.ts +1 -1
- package/dist/sdk/query/list-filter-shared.d.ts +4 -4
- package/dist/sdk/query/list.d.ts +167 -167
- package/dist/sdk/query/list.js +1 -1
- package/dist/sdk/query/multi-value-filters.d.ts +6 -6
- package/dist/sdk/query/next-ready-budget.d.ts +8 -8
- package/dist/sdk/query/next.d.ts +94 -94
- package/dist/sdk/query/parsers.d.ts +3 -3
- package/dist/sdk/query/projection-contracts.d.ts +18 -18
- package/dist/sdk/query/search/corpus.d.ts +15 -15
- package/dist/sdk/query/search/filters.d.ts +15 -15
- package/dist/sdk/query/search/input.d.ts +8 -8
- package/dist/sdk/query/search/lexical.d.ts +10 -10
- package/dist/sdk/query/search/response.d.ts +22 -22
- package/dist/sdk/query/search/semantic.d.ts +133 -133
- package/dist/sdk/query/search/types.d.ts +65 -65
- package/dist/sdk/query/search-contracts.d.ts +53 -53
- package/dist/sdk/query/search-pagination.d.ts +21 -21
- package/dist/sdk/query/search-rendering.d.ts +30 -30
- package/dist/sdk/query/search.d.ts +60 -60
- package/dist/sdk/query/workspace-contracts.d.ts +2 -2
- package/dist/sdk/query.d.ts +6 -6
- package/dist/sdk/read-output/continuation.d.ts +11 -11
- package/dist/sdk/read-output/extension.d.ts +3 -3
- package/dist/sdk/read-output/options.d.ts +7 -7
- package/dist/sdk/read-output/provenance.d.ts +6 -6
- package/dist/sdk/read-output-budget.d.ts +11 -11
- package/dist/sdk/read-output-budget.js +1 -1
- package/dist/sdk/read-output-contracts.d.ts +112 -112
- package/dist/sdk/read-output-contracts.js +1 -1
- package/dist/sdk/read-output-rows.d.ts +15 -15
- package/dist/sdk/read-output-session.d.ts +29 -29
- package/dist/sdk/relationship-analytics.d.ts +46 -46
- package/dist/sdk/relationship-context.d.ts +48 -48
- package/dist/sdk/relationship-history.d.ts +59 -59
- package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
- package/dist/sdk/relationship-migration.d.ts +14 -14
- package/dist/sdk/relationships.d.ts +46 -46
- package/dist/sdk/reproducibility/process.d.ts +9 -9
- package/dist/sdk/runtime/actions.d.ts +1 -1
- package/dist/sdk/runtime/context.d.ts +15 -15
- package/dist/sdk/runtime/schema-preview.d.ts +1 -1
- package/dist/sdk/runtime/schema.d.ts +1 -1
- package/dist/sdk/runtime-action-aliases.d.ts +3 -3
- package/dist/sdk/runtime-extended-actions.d.ts +9 -9
- package/dist/sdk/runtime-input.d.ts +29 -29
- package/dist/sdk/runtime-input.js +1 -1
- package/dist/sdk/runtime-primitives.d.ts +53 -53
- package/dist/sdk/runtime-primitives.js +1 -1
- package/dist/sdk/runtime-public-contracts.d.ts +46 -46
- package/dist/sdk/runtime-stats-options.d.ts +1 -1
- package/dist/sdk/runtime.d.ts +374 -374
- package/dist/sdk/runtime.js +1 -1
- package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
- package/dist/sdk/schema-migration.d.ts +79 -79
- package/dist/sdk/schema.d.ts +224 -224
- package/dist/sdk/search-refresh-worker.d.ts +1 -1
- package/dist/sdk/similarity-scoring.d.ts +10 -10
- package/dist/sdk/similarity.d.ts +73 -73
- package/dist/sdk/start-task-status.d.ts +1 -1
- package/dist/sdk/stats.d.ts +72 -72
- package/dist/sdk/structured-mutations.d.ts +64 -13
- package/dist/sdk/structured-mutations.js +1 -1
- package/dist/sdk/telemetry-flush.d.ts +1 -1
- package/dist/sdk/telemetry.d.ts +32 -32
- package/dist/sdk/templates.d.ts +35 -35
- package/dist/sdk/test/batch.d.ts +50 -50
- package/dist/sdk/test/command-args.d.ts +2 -2
- package/dist/sdk/test/entry.d.ts +4 -4
- package/dist/sdk/test/execution-receipts.d.ts +5 -5
- package/dist/sdk/test/execution.d.ts +247 -247
- package/dist/sdk/test/json-path.d.ts +4 -4
- package/dist/sdk/test/linked-command-detection.d.ts +36 -36
- package/dist/sdk/test/measurements.d.ts +10 -10
- package/dist/sdk/test/parsers.d.ts +18 -18
- package/dist/sdk/test/prerequisites.d.ts +3 -3
- package/dist/sdk/test/runs.d.ts +43 -43
- package/dist/sdk/test/trust.d.ts +15 -15
- package/dist/sdk/test/update.d.ts +23 -23
- package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
- package/dist/sdk/testing.d.ts +248 -248
- package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
- package/dist/sdk/traceability/source-traceability.d.ts +50 -50
- package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
- package/dist/sdk/workspace-contracts.d.ts +20 -20
- package/dist/sdk/workspace-memory.d.ts +42 -42
- package/dist/sdk/workspace-recipe.d.ts +9 -9
- package/dist/sdk/workspace-snapshot.d.ts +60 -60
- package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
- package/dist/sdk/workspace-transaction.d.ts +26 -26
- package/dist/sdk/workspace-transaction.js +2 -2
- package/dist/sdk/workspace.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/AGENT_GUIDE.md +33 -4
- package/docs/CLOSE_EVIDENCE_RECOVERY.md +16 -7
- package/docs/COMMANDS.md +96 -12
- package/docs/ECOSYSTEM_PLANNING_REVIEW.md +5 -1
- package/docs/EXTENSIONS.md +1 -1
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/RELEASING.md +2 -0
- package/docs/SDK.md +114 -2
- package/docs/TESTING.md +36 -1
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +1 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +17 -3
- package/marketplace.json +1 -1
- package/package.json +4 -1
- 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-claude/package.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/pm-codex/package.json +1 -1
- package/plugins/pm-codex/plugin.json +1 -1
- package/runtime-dependencies.json +1 -1
- package/scripts/finalize-build.mjs +9 -3
- package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
- package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
- package/dist/cli-bundle/chunks/chunk-LOSRTNNP.js +0 -2
- package/dist/cli-bundle/chunks/chunk-PP3BVMFL.js +0 -30
- package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
- package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
- package/dist/cli-bundle/chunks/register-mutation-TNRHNK4N.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-23ACMPGB.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-LKWDWER4.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
- package/docs/ecosystem-review-2026-09-28.json +0 -1
|
@@ -1,132 +1,132 @@
|
|
|
1
|
-
import { type HistoryCompactBulkSkipReason,
|
|
1
|
+
import { type HistoryCompactBulkSkipReason,type HistoryCompactScope } from "../core/history/history-compact-bulk.js";
|
|
2
2
|
import { type BulkIdsValue } from "../core/io/bulk-ids-input.js";
|
|
3
3
|
import type { GlobalOptions } from "../core/shared/command-types.js";
|
|
4
4
|
/** Documents the history compact command options payload exchanged by command, SDK, and package integrations. */
|
|
5
5
|
export interface HistoryCompactCommandOptions {
|
|
6
6
|
/** Value that configures or reports before for this contract. */
|
|
7
|
-
before?:
|
|
7
|
+
before?:string;
|
|
8
8
|
/** Value that configures or reports dry run for this contract. */
|
|
9
|
-
dryRun?:
|
|
9
|
+
dryRun?:boolean;
|
|
10
10
|
/** Value that configures or reports author for this contract. */
|
|
11
|
-
author?:
|
|
11
|
+
author?:string;
|
|
12
12
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
13
|
-
message?:
|
|
13
|
+
message?:string;
|
|
14
14
|
/** Value that configures or reports force for this contract. */
|
|
15
|
-
force?:
|
|
15
|
+
force?:boolean;
|
|
16
16
|
}
|
|
17
17
|
type HistoryCompactBoundaryKind = "default" | "version" | "timestamp";
|
|
18
18
|
/** Documents the history compact result payload exchanged by command, SDK, and package integrations. */
|
|
19
19
|
export interface HistoryCompactResult {
|
|
20
20
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
21
|
-
id:
|
|
21
|
+
id:string;
|
|
22
22
|
/** Value that configures or reports dry run for this contract. */
|
|
23
|
-
dry_run:
|
|
23
|
+
dry_run:boolean;
|
|
24
24
|
/** Value that configures or reports changed for this contract. */
|
|
25
|
-
changed:
|
|
25
|
+
changed:boolean;
|
|
26
26
|
/** Value that configures or reports compact boundary for this contract. */
|
|
27
|
-
compact_boundary:
|
|
28
|
-
kind:
|
|
29
|
-
before:
|
|
30
|
-
entries_compacted:
|
|
31
|
-
entries_retained:
|
|
32
|
-
first_retained_entry:
|
|
27
|
+
compact_boundary:{
|
|
28
|
+
kind:HistoryCompactBoundaryKind;
|
|
29
|
+
before:string | null;
|
|
30
|
+
entries_compacted:number;
|
|
31
|
+
entries_retained:number;
|
|
32
|
+
first_retained_entry:number | null;
|
|
33
33
|
};
|
|
34
34
|
/** Value that configures or reports history for this contract. */
|
|
35
|
-
history:
|
|
36
|
-
path:
|
|
37
|
-
entries_scanned:
|
|
38
|
-
entries_after:
|
|
39
|
-
baseline_entry_added:
|
|
40
|
-
audit_entry_added:
|
|
41
|
-
verify_ok:
|
|
42
|
-
verify_errors:
|
|
35
|
+
history:{
|
|
36
|
+
path:string;
|
|
37
|
+
entries_scanned:number;
|
|
38
|
+
entries_after:number;
|
|
39
|
+
baseline_entry_added:boolean;
|
|
40
|
+
audit_entry_added:boolean;
|
|
41
|
+
verify_ok:boolean;
|
|
42
|
+
verify_errors:string[];
|
|
43
43
|
};
|
|
44
44
|
/** Value that configures or reports item for this contract. */
|
|
45
|
-
item:
|
|
46
|
-
exists:
|
|
47
|
-
path:
|
|
48
|
-
matched_chain_before:
|
|
45
|
+
item:{
|
|
46
|
+
exists:boolean;
|
|
47
|
+
path:string | null;
|
|
48
|
+
matched_chain_before:boolean | null;
|
|
49
49
|
};
|
|
50
50
|
/** Value that configures or reports warnings for this contract. */
|
|
51
|
-
warnings:
|
|
51
|
+
warnings:string[];
|
|
52
52
|
/** ISO 8601 timestamp recording when generated occurred. */
|
|
53
|
-
generated_at:
|
|
53
|
+
generated_at:string;
|
|
54
54
|
}
|
|
55
55
|
/** Implements run history compact for the public runtime surface of this module. */
|
|
56
|
-
export declare function runHistoryCompact(id:
|
|
56
|
+
export declare function runHistoryCompact(id:string,options:HistoryCompactCommandOptions,global:GlobalOptions):Promise<HistoryCompactResult>;
|
|
57
57
|
/** Default entry floor below which a stream is treated as already compact. */
|
|
58
58
|
export declare const HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES = 3;
|
|
59
59
|
/** Documents the bulk history compact command options payload exchanged by command, SDK, and package integrations. */
|
|
60
60
|
export interface HistoryCompactBulkCommandOptions {
|
|
61
61
|
/** Value that configures or reports ids for this contract. */
|
|
62
|
-
ids?:
|
|
62
|
+
ids?:BulkIdsValue;
|
|
63
63
|
/** Value that configures or reports scope for this contract. */
|
|
64
|
-
scope?:
|
|
64
|
+
scope?:HistoryCompactScope;
|
|
65
65
|
/** Value that configures or reports all over for this contract. */
|
|
66
|
-
allOver?:
|
|
66
|
+
allOver?:number;
|
|
67
67
|
/** Value that configures or reports min entries for this contract. */
|
|
68
|
-
minEntries?:
|
|
68
|
+
minEntries?:number;
|
|
69
69
|
/** Value that configures or reports dry run for this contract. */
|
|
70
|
-
dryRun?:
|
|
70
|
+
dryRun?:boolean;
|
|
71
71
|
/** Value that configures or reports author for this contract. */
|
|
72
|
-
author?:
|
|
72
|
+
author?:string;
|
|
73
73
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
74
|
-
message?:
|
|
74
|
+
message?:string;
|
|
75
75
|
/** Value that configures or reports force for this contract. */
|
|
76
|
-
force?:
|
|
76
|
+
force?:boolean;
|
|
77
77
|
}
|
|
78
78
|
/** Per-item outcome row in a bulk compaction pass. */
|
|
79
79
|
export interface HistoryCompactBulkItemResult {
|
|
80
80
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
81
|
-
id:
|
|
81
|
+
id:string;
|
|
82
82
|
/** Value that configures or reports outcome for this contract. */
|
|
83
|
-
outcome:
|
|
83
|
+
outcome:"compacted" | "skipped" | "errored";
|
|
84
84
|
/** Value that configures or reports entries before for this contract. */
|
|
85
|
-
entries_before:
|
|
85
|
+
entries_before:number;
|
|
86
86
|
/** Value that configures or reports entries after for this contract. */
|
|
87
|
-
entries_after:
|
|
87
|
+
entries_after:number | null;
|
|
88
88
|
/** Value that configures or reports skip reason for this contract. */
|
|
89
|
-
skip_reason:
|
|
89
|
+
skip_reason:HistoryCompactBulkSkipReason | null;
|
|
90
90
|
/** Value that configures or reports changed for this contract. */
|
|
91
|
-
changed:
|
|
91
|
+
changed:boolean;
|
|
92
92
|
/** Value that configures or reports error for this contract. */
|
|
93
|
-
error:
|
|
93
|
+
error:string | null;
|
|
94
94
|
}
|
|
95
95
|
/** Documents the bulk history compact result payload exchanged by command, SDK, and package integrations. */
|
|
96
96
|
export interface HistoryCompactBulkResult {
|
|
97
97
|
/** Value that configures or reports bulk for this contract. */
|
|
98
|
-
bulk:
|
|
98
|
+
bulk:true;
|
|
99
99
|
/** Value that configures or reports dry run for this contract. */
|
|
100
|
-
dry_run:
|
|
100
|
+
dry_run:boolean;
|
|
101
101
|
/** Value that configures or reports mode for this contract. */
|
|
102
|
-
mode:
|
|
102
|
+
mode:"ids" | "scan";
|
|
103
103
|
/** Value that configures or reports scope for this contract. */
|
|
104
|
-
scope:
|
|
104
|
+
scope:HistoryCompactScope | null;
|
|
105
105
|
/** Value that configures or reports criteria for this contract. */
|
|
106
|
-
criteria:
|
|
107
|
-
min_entries:
|
|
108
|
-
all_over:
|
|
109
|
-
policy_threshold_applied:
|
|
106
|
+
criteria:{
|
|
107
|
+
min_entries:number;
|
|
108
|
+
all_over:number | null;
|
|
109
|
+
policy_threshold_applied:boolean;
|
|
110
110
|
};
|
|
111
111
|
/** Value that configures or reports totals for this contract. */
|
|
112
|
-
totals:
|
|
113
|
-
streams_considered:
|
|
114
|
-
selected:
|
|
115
|
-
items_compacted:
|
|
116
|
-
items_skipped:
|
|
117
|
-
items_errored:
|
|
112
|
+
totals:{
|
|
113
|
+
streams_considered:number;
|
|
114
|
+
selected:number;
|
|
115
|
+
items_compacted:number;
|
|
116
|
+
items_skipped:number;
|
|
117
|
+
items_errored:number;
|
|
118
118
|
};
|
|
119
119
|
/** Value that configures or reports results for this contract. */
|
|
120
|
-
results:
|
|
120
|
+
results:HistoryCompactBulkItemResult[];
|
|
121
121
|
/** ISO 8601 timestamp recording when generated occurred. */
|
|
122
|
-
generated_at:
|
|
122
|
+
generated_at:string;
|
|
123
123
|
}
|
|
124
124
|
/** Enforce the `pm history-compact` target contract shared by the CLI and MCP surfaces: exactly one selection mode — a single item `<id>`, an explicit `--ids` list, or a scan selector (`--all-over` / `--closed` / `--all-streams`). */
|
|
125
|
-
export declare function assertHistoryCompactTarget(id:
|
|
126
|
-
ids?:
|
|
127
|
-
allOver?:
|
|
128
|
-
scope?:
|
|
129
|
-
}):
|
|
125
|
+
export declare function assertHistoryCompactTarget(id:string | undefined,bulk:{
|
|
126
|
+
ids?:string[];
|
|
127
|
+
allOver?:number;
|
|
128
|
+
scope?:HistoryCompactScope;
|
|
129
|
+
}):void;
|
|
130
130
|
/**
|
|
131
131
|
* Bulk history compaction: compact every history stream matching the requested
|
|
132
132
|
* selection (explicit `--ids`, a `--scope` lifecycle filter, and/or an
|
|
@@ -139,5 +139,5 @@ scope?: HistoryCompactScope;
|
|
|
139
139
|
* given, the policy's `max_entries` is used as the scan threshold so the
|
|
140
140
|
* configured policy drives the sweep.
|
|
141
141
|
*/
|
|
142
|
-
export declare function runHistoryCompactBulk(options:
|
|
142
|
+
export declare function runHistoryCompactBulk(options:HistoryCompactBulkCommandOptions,global:GlobalOptions):Promise<HistoryCompactBulkResult>;
|
|
143
143
|
export {};
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
import type { GlobalOptions } from "../core/shared/command-types.js";
|
|
2
|
-
import { type HistoryCompactBulkResult,
|
|
2
|
+
import { type HistoryCompactBulkResult,type HistoryCompactResult } from "./history-compact.js";
|
|
3
3
|
/** Minimal action context required by MCP history maintenance adapters. */
|
|
4
4
|
export interface HistoryMcpActionContext {
|
|
5
5
|
/** Optional positional item id used by single-stream mode. */
|
|
6
|
-
id?:
|
|
6
|
+
id?:string;
|
|
7
7
|
/** Alias-rich MCP options normalized by the selected history adapter. */
|
|
8
|
-
options:
|
|
8
|
+
options:Record<string,unknown>;
|
|
9
9
|
/** Force flag forwarded to integrity-sensitive maintenance engines. */
|
|
10
|
-
force?:
|
|
10
|
+
force?:boolean;
|
|
11
11
|
/** Global tracker and output controls shared with native command handlers. */
|
|
12
|
-
global:
|
|
12
|
+
global:GlobalOptions;
|
|
13
13
|
}
|
|
14
14
|
/** Dispatch single-stream or all-stream history repair from an MCP payload. */
|
|
15
|
-
export declare function runMcpHistoryRepairAction(context:
|
|
15
|
+
export declare function runMcpHistoryRepairAction(context:HistoryMcpActionContext):Promise<unknown>;
|
|
16
16
|
/** Dispatch single or bounded bulk history compaction from an MCP payload. */
|
|
17
|
-
export declare function runMcpHistoryCompactAction(context:
|
|
17
|
+
export declare function runMcpHistoryCompactAction(context:HistoryMcpActionContext):Promise<HistoryCompactResult | HistoryCompactBulkResult>;
|
|
@@ -9,86 +9,86 @@ import type { HistoryEntry } from "../types.js";
|
|
|
9
9
|
/** Versioned, workspace-owned interpretation of legacy author spellings. */
|
|
10
10
|
export interface AuthorIdentityVocabulary {
|
|
11
11
|
/** Reproducible revision included in projections and summaries. */
|
|
12
|
-
version:
|
|
12
|
+
version:number;
|
|
13
13
|
/** Exact author literals mapped to canonical harness namespaces. */
|
|
14
|
-
aliases:
|
|
14
|
+
aliases:Readonly<Record<string,string>>;
|
|
15
15
|
}
|
|
16
16
|
/** Read predicates shared by history, activity, events, and SDK consumers. */
|
|
17
17
|
export interface HistoryProvenanceFilters {
|
|
18
18
|
/** Canonical recorded or vocabulary-resolved harness namespace. */
|
|
19
|
-
harness?:
|
|
19
|
+
harness?:string | readonly string[];
|
|
20
20
|
/** Privacy-safe invocation fingerprint. */
|
|
21
|
-
agentInstance?:
|
|
21
|
+
agentInstance?:string | readonly string[];
|
|
22
22
|
/** Dimension predicates expressed as exact `dimension=value` pairs. */
|
|
23
|
-
provenance?:
|
|
23
|
+
provenance?:string | readonly string[];
|
|
24
24
|
}
|
|
25
25
|
/** Patch-free identity and provenance projection for one immutable event. */
|
|
26
26
|
export interface HistoryProvenanceRow {
|
|
27
27
|
/** Optional history stream subject supplied by a collection reader. */
|
|
28
|
-
item_id?:
|
|
28
|
+
item_id?:string;
|
|
29
29
|
/** Optional one-based stream version supplied by a collection reader. */
|
|
30
|
-
version?:
|
|
30
|
+
version?:number;
|
|
31
31
|
/** Immutable event timestamp. */
|
|
32
|
-
ts:
|
|
32
|
+
ts:string;
|
|
33
33
|
/** Immutable mutation operation. */
|
|
34
|
-
op:
|
|
34
|
+
op:string;
|
|
35
35
|
/** Original, byte-preserved author literal. */
|
|
36
|
-
author:
|
|
36
|
+
author:string;
|
|
37
37
|
/** Recorded author selection source when available. */
|
|
38
|
-
author_source?:
|
|
38
|
+
author_source?:HistoryEntry["author_source"];
|
|
39
39
|
/** Recorded harness or read-time alias interpretation. */
|
|
40
|
-
agent_harness?:
|
|
40
|
+
agent_harness?:string;
|
|
41
41
|
/** Whether the harness was recorded, interpreted, or remains unresolved. */
|
|
42
|
-
harness_source:
|
|
42
|
+
harness_source:"recorded" | "vocabulary" | "unresolved";
|
|
43
43
|
/** Vocabulary revision used for this interpretation. */
|
|
44
|
-
vocabulary_version:
|
|
44
|
+
vocabulary_version:number;
|
|
45
45
|
/** Privacy-safe invocation fingerprint. */
|
|
46
|
-
agent_instance?:
|
|
46
|
+
agent_instance?:string;
|
|
47
47
|
/** Every recorded extensible provenance observation, without patch payloads. */
|
|
48
|
-
agent_provenance:
|
|
48
|
+
agent_provenance:NonNullable<HistoryEntry["agent_provenance"]>;
|
|
49
49
|
/** Optional event message. */
|
|
50
|
-
message?:
|
|
50
|
+
message?:string;
|
|
51
51
|
}
|
|
52
52
|
/** Constant-size provenance coverage report over an inspected history set. */
|
|
53
53
|
export interface HistoryProvenanceSummary {
|
|
54
54
|
/** Number of immutable entries inspected. */
|
|
55
|
-
entries:
|
|
55
|
+
entries:number;
|
|
56
56
|
/** Vocabulary revision used for legacy interpretation. */
|
|
57
|
-
vocabulary_version:
|
|
57
|
+
vocabulary_version:number;
|
|
58
58
|
/** Recorded or interpreted harness coverage. */
|
|
59
|
-
harness:
|
|
59
|
+
harness:{
|
|
60
60
|
/** Entries resolving to a canonical harness. */
|
|
61
|
-
resolved:
|
|
61
|
+
resolved:number;
|
|
62
62
|
/** Entries without a recorded or interpreted harness. */
|
|
63
|
-
unresolved:
|
|
63
|
+
unresolved:number;
|
|
64
64
|
/** Most frequent unresolved author literals, bounded to twenty rows. */
|
|
65
|
-
unresolved_authors:
|
|
66
|
-
author:
|
|
67
|
-
entries:
|
|
65
|
+
unresolved_authors:Array<{
|
|
66
|
+
author:string;
|
|
67
|
+
entries:number;
|
|
68
68
|
}>;
|
|
69
69
|
};
|
|
70
70
|
/** Availability counts for every observed or declared dimension. */
|
|
71
|
-
dimensions:
|
|
72
|
-
dimension:
|
|
73
|
-
observed:
|
|
74
|
-
unavailable:
|
|
75
|
-
legacy_missing:
|
|
71
|
+
dimensions:Array<{
|
|
72
|
+
dimension:string;
|
|
73
|
+
observed:number;
|
|
74
|
+
unavailable:number;
|
|
75
|
+
legacy_missing:number;
|
|
76
76
|
}>;
|
|
77
77
|
}
|
|
78
78
|
/** Default interpretation used when a legacy workspace has no vocabulary. */
|
|
79
|
-
export declare const DEFAULT_AUTHOR_IDENTITY_VOCABULARY:
|
|
79
|
+
export declare const DEFAULT_AUTHOR_IDENTITY_VOCABULARY:AuthorIdentityVocabulary;
|
|
80
80
|
/** Resolve the extensible dimension vocabulary declared by built-ins and workspace descriptors. */
|
|
81
|
-
export declare function resolveHistoryProvenanceDimensions(descriptors?:
|
|
81
|
+
export declare function resolveHistoryProvenanceDimensions(descriptors?:readonly HarnessSignalDescriptor[]):string[];
|
|
82
82
|
/** Parse and validate exact provenance dimension predicates. */
|
|
83
|
-
export declare function parseHistoryProvenanceFilters(filters:
|
|
83
|
+
export declare function parseHistoryProvenanceFilters(filters:HistoryProvenanceFilters,dimensions?:readonly string[]):Map<string,Set<string>>;
|
|
84
84
|
/** Project one immutable entry without its JSON Patch or document hashes. */
|
|
85
|
-
export declare function projectHistoryProvenance(entry:
|
|
86
|
-
itemId?:
|
|
87
|
-
version?:
|
|
88
|
-
}):
|
|
85
|
+
export declare function projectHistoryProvenance(entry:HistoryEntry,vocabulary?:AuthorIdentityVocabulary,coordinates?:{
|
|
86
|
+
itemId?:string;
|
|
87
|
+
version?:number;
|
|
88
|
+
}):HistoryProvenanceRow;
|
|
89
89
|
/** Test one immutable entry against shared provenance predicates. */
|
|
90
|
-
export declare function historyEntryMatchesProvenance(entry:
|
|
90
|
+
export declare function historyEntryMatchesProvenance(entry:HistoryEntry,filters:HistoryProvenanceFilters,vocabulary?:AuthorIdentityVocabulary,dimensions?:readonly string[]):boolean;
|
|
91
91
|
/** Compile shared provenance predicates once for efficient history scans. */
|
|
92
|
-
export declare function compileHistoryProvenanceMatcher(filters:
|
|
92
|
+
export declare function compileHistoryProvenanceMatcher(filters:HistoryProvenanceFilters,vocabulary?:AuthorIdentityVocabulary,dimensions?:readonly string[]):(entry:HistoryEntry) => boolean;
|
|
93
93
|
/** Summarize identity and dimension completeness without returning event rows. */
|
|
94
|
-
export declare function summarizeHistoryProvenance(entries:
|
|
94
|
+
export declare function summarizeHistoryProvenance(entries:readonly HistoryEntry[],vocabulary?:AuthorIdentityVocabulary,dimensions?:readonly string[]):HistoryProvenanceSummary;
|
|
@@ -1,51 +1,51 @@
|
|
|
1
|
-
import { applyHistoryPatch,
|
|
1
|
+
import { applyHistoryPatch,ensureMaterializedHistoryTarget,extractPatchFailureContext,replayHistoryToTarget,resolveHistoryTarget,type ResolvedHistoryTarget } from "../core/history/projection.js";
|
|
2
2
|
import { readHistoryEntries } from "../core/history/read.js";
|
|
3
|
-
import type { HistoryEntry,
|
|
4
|
-
export { findHistoryIdentityDiscontinuities,
|
|
3
|
+
import type { HistoryEntry,ItemDocument } from "../types/index.js";
|
|
4
|
+
export { findHistoryIdentityDiscontinuities,type HistoryIdentityDiscontinuity,} from "../core/history/identity.js";
|
|
5
5
|
/** Workspace resolution controls accepted by {@link getItemAt}. */
|
|
6
6
|
export interface GetItemAtOptions {
|
|
7
7
|
/** Explicit tracker root, equivalent to the CLI global `--pm-path`. */
|
|
8
|
-
pmRoot?:
|
|
8
|
+
pmRoot?:string;
|
|
9
9
|
/** Working directory used when discovering the nearest tracker. */
|
|
10
|
-
cwd?:
|
|
10
|
+
cwd?:string;
|
|
11
11
|
}
|
|
12
12
|
/** Verified historical item projection returned by {@link getItemAt}. */
|
|
13
13
|
export interface GetItemAtResult {
|
|
14
14
|
/** Reconstructed canonical item document at the selected version. */
|
|
15
|
-
document:
|
|
15
|
+
document:ItemDocument;
|
|
16
16
|
/** Always true, preventing consumers from confusing this with current state. */
|
|
17
|
-
reconstructed:
|
|
17
|
+
reconstructed:true;
|
|
18
18
|
/** Durable one-based version; null when a legacy checkpoint lost its mapping. */
|
|
19
|
-
as_of_version:
|
|
19
|
+
as_of_version:number | null;
|
|
20
20
|
/** Timestamp of the final included history entry. */
|
|
21
|
-
as_of_timestamp:
|
|
21
|
+
as_of_timestamp:string;
|
|
22
22
|
/** Normalized target resolution metadata shared with restore. */
|
|
23
|
-
target:
|
|
23
|
+
target:ResolvedHistoryTarget;
|
|
24
24
|
/** Total number of entries currently available in the stream. */
|
|
25
|
-
history_length:
|
|
25
|
+
history_length:number;
|
|
26
26
|
}
|
|
27
27
|
/** Verification projection shared by CLI history reads and SDK consumers. */
|
|
28
28
|
export interface HistoryVerificationResult {
|
|
29
29
|
/** Whether the hash chain and optional current document both verify. */
|
|
30
|
-
ok:
|
|
30
|
+
ok:boolean;
|
|
31
31
|
/** Number of entries verified. */
|
|
32
|
-
entries:
|
|
32
|
+
entries:number;
|
|
33
33
|
/** Stable verification errors in encounter order. */
|
|
34
|
-
errors:
|
|
34
|
+
errors:string[];
|
|
35
35
|
/** Hash produced by the newest entry, when one exists. */
|
|
36
|
-
latest_after_hash?:
|
|
36
|
+
latest_after_hash?:string;
|
|
37
37
|
/** Canonical hash of the supplied current document. */
|
|
38
|
-
current_item_hash?:
|
|
38
|
+
current_item_hash?:string;
|
|
39
39
|
/** Whether the supplied document matches the newest history hash. */
|
|
40
|
-
current_matches_latest?:
|
|
40
|
+
current_matches_latest?:boolean;
|
|
41
41
|
/** Whether every governed workspace singleton matches the latest replayed state. */
|
|
42
|
-
workspace_state_matches_latest?:
|
|
42
|
+
workspace_state_matches_latest?:boolean;
|
|
43
43
|
/** Governed singleton paths whose JSON differs from the replayed value. */
|
|
44
|
-
workspace_state_mismatches?:
|
|
44
|
+
workspace_state_mismatches?:string[];
|
|
45
45
|
/** Governed singleton paths absent from disk. */
|
|
46
|
-
workspace_state_missing?:
|
|
46
|
+
workspace_state_missing?:string[];
|
|
47
47
|
/** Governed singleton paths unreadable as safe workspace-local JSON. */
|
|
48
|
-
workspace_state_unreadable?:
|
|
48
|
+
workspace_state_unreadable?:string[];
|
|
49
49
|
}
|
|
50
50
|
/**
|
|
51
51
|
* Verify a history chain and optionally compare it with a current document.
|
|
@@ -54,10 +54,10 @@ workspace_state_unreadable?: string[];
|
|
|
54
54
|
* aggregate multiple configuration files and therefore have no single item
|
|
55
55
|
* document to compare.
|
|
56
56
|
*/
|
|
57
|
-
export declare function verifyHistoryEntries(history:
|
|
57
|
+
export declare function verifyHistoryEntries(history:HistoryEntry[],currentDocument?:ItemDocument):HistoryVerificationResult;
|
|
58
58
|
/**
|
|
59
59
|
* Reconstruct one item at a one-based version or ISO timestamp without locks,
|
|
60
60
|
* item writes, history writes, or derived-index mutations.
|
|
61
61
|
*/
|
|
62
|
-
export declare function getItemAt(id:
|
|
63
|
-
export { applyHistoryPatch,
|
|
62
|
+
export declare function getItemAt(id:string,target:string,options?:GetItemAtOptions):Promise<GetItemAtResult>;
|
|
63
|
+
export { applyHistoryPatch,ensureMaterializedHistoryTarget,extractPatchFailureContext,readHistoryEntries,replayHistoryToTarget,resolveHistoryTarget,};
|
|
@@ -1,110 +1,110 @@
|
|
|
1
|
-
export { resolveHistorySubject,
|
|
1
|
+
export { resolveHistorySubject,type HistorySubject,} from "./history/subject.js";
|
|
2
2
|
import { type ReplayDocument } from "../core/history/replay.js";
|
|
3
3
|
import type { GlobalOptions } from "../core/shared/command-types.js";
|
|
4
4
|
/** Documents the history redact command options payload exchanged by command, SDK, and package integrations. */
|
|
5
5
|
export interface HistoryRedactCommandOptions {
|
|
6
6
|
/** Value that configures or reports literal for this contract. */
|
|
7
|
-
literal?:
|
|
7
|
+
literal?:string[] | string;
|
|
8
8
|
/** Value that configures or reports regex for this contract. */
|
|
9
|
-
regex?:
|
|
9
|
+
regex?:string[] | string;
|
|
10
10
|
/** Value that configures or reports replacement for this contract. */
|
|
11
|
-
replacement?:
|
|
11
|
+
replacement?:string;
|
|
12
12
|
/** Value that configures or reports dry run for this contract. */
|
|
13
|
-
dryRun?:
|
|
13
|
+
dryRun?:boolean;
|
|
14
14
|
/** Value that configures or reports author for this contract. */
|
|
15
|
-
author?:
|
|
15
|
+
author?:string;
|
|
16
16
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
17
|
-
message?:
|
|
17
|
+
message?:string;
|
|
18
18
|
/** Value that configures or reports force for this contract. */
|
|
19
|
-
force?:
|
|
19
|
+
force?:boolean;
|
|
20
20
|
}
|
|
21
21
|
interface RegexRule {
|
|
22
|
-
kind:
|
|
23
|
-
source:
|
|
24
|
-
flags:
|
|
22
|
+
kind:"regex";
|
|
23
|
+
source:string;
|
|
24
|
+
flags:string;
|
|
25
25
|
}
|
|
26
26
|
interface LiteralRule {
|
|
27
|
-
kind:
|
|
28
|
-
value:
|
|
27
|
+
kind:"literal";
|
|
28
|
+
value:string;
|
|
29
29
|
}
|
|
30
30
|
type RedactionRule = RegexRule | LiteralRule;
|
|
31
31
|
/** Documents the history redact result payload exchanged by command, SDK, and package integrations. */
|
|
32
32
|
export interface HistoryRedactResult {
|
|
33
33
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
34
|
-
id:
|
|
34
|
+
id:string;
|
|
35
35
|
/** Value that configures or reports dry run for this contract. */
|
|
36
|
-
dry_run:
|
|
36
|
+
dry_run:boolean;
|
|
37
37
|
/** Value that configures or reports changed for this contract. */
|
|
38
|
-
changed:
|
|
38
|
+
changed:boolean;
|
|
39
39
|
/** Value that configures or reports patterns for this contract. */
|
|
40
|
-
patterns:
|
|
40
|
+
patterns:{
|
|
41
41
|
/** Number of unique literal matchers accepted without disclosing their values. */
|
|
42
|
-
literal_count:
|
|
42
|
+
literal_count:number;
|
|
43
43
|
/** Number of unique regular-expression matchers accepted without disclosing their source. */
|
|
44
|
-
regex_count:
|
|
44
|
+
regex_count:number;
|
|
45
45
|
/** Total number of accepted matchers across both matcher kinds. */
|
|
46
|
-
total_count:
|
|
46
|
+
total_count:number;
|
|
47
47
|
/** Whether the canonical default replacement was selected implicitly. */
|
|
48
|
-
replacement_is_default:
|
|
48
|
+
replacement_is_default:boolean;
|
|
49
49
|
};
|
|
50
50
|
/** Value that configures or reports history for this contract. */
|
|
51
|
-
history:
|
|
52
|
-
path:
|
|
53
|
-
entries_scanned:
|
|
54
|
-
entries_changed:
|
|
55
|
-
replacements:
|
|
56
|
-
hash_mismatches_before:
|
|
57
|
-
hash_mismatches_after:
|
|
58
|
-
preexisting_hash_mismatches:
|
|
59
|
-
audit_entry_added:
|
|
60
|
-
verify_ok:
|
|
61
|
-
verify_errors:
|
|
51
|
+
history:{
|
|
52
|
+
path:string;
|
|
53
|
+
entries_scanned:number;
|
|
54
|
+
entries_changed:number;
|
|
55
|
+
replacements:number;
|
|
56
|
+
hash_mismatches_before:number;
|
|
57
|
+
hash_mismatches_after:number;
|
|
58
|
+
preexisting_hash_mismatches:number;
|
|
59
|
+
audit_entry_added:boolean;
|
|
60
|
+
verify_ok:boolean;
|
|
61
|
+
verify_errors:string[];
|
|
62
62
|
};
|
|
63
63
|
/** Value that configures or reports item for this contract. */
|
|
64
|
-
item:
|
|
65
|
-
existed_before:
|
|
66
|
-
exists_after:
|
|
67
|
-
path_before:
|
|
68
|
-
path_after:
|
|
69
|
-
changed:
|
|
64
|
+
item:{
|
|
65
|
+
existed_before:boolean;
|
|
66
|
+
exists_after:boolean;
|
|
67
|
+
path_before:string | null;
|
|
68
|
+
path_after:string | null;
|
|
69
|
+
changed:boolean;
|
|
70
70
|
};
|
|
71
71
|
/** Value that configures or reports warnings for this contract. */
|
|
72
|
-
warnings:
|
|
72
|
+
warnings:string[];
|
|
73
73
|
/** ISO 8601 timestamp recording when generated occurred. */
|
|
74
|
-
generated_at:
|
|
74
|
+
generated_at:string;
|
|
75
75
|
}
|
|
76
|
-
declare function normalizeStringArrayInput(value:
|
|
77
|
-
declare function normalizeRegexFlags(flags:
|
|
78
|
-
declare function parseRegexRule(spec:
|
|
79
|
-
declare function buildRedactionRules(literalInput:
|
|
80
|
-
declare function applyLiteralRule(value:
|
|
81
|
-
value:
|
|
82
|
-
replacements:
|
|
76
|
+
declare function normalizeStringArrayInput(value:string[] | string | undefined):string[];
|
|
77
|
+
declare function normalizeRegexFlags(flags:string):string;
|
|
78
|
+
declare function parseRegexRule(spec:string):RegexRule;
|
|
79
|
+
declare function buildRedactionRules(literalInput:string[] | string | undefined,regexInput:string[] | string | undefined):RedactionRule[];
|
|
80
|
+
declare function applyLiteralRule(value:string,literal:string,replacement:string):{
|
|
81
|
+
value:string;
|
|
82
|
+
replacements:number;
|
|
83
83
|
};
|
|
84
|
-
declare function applyRegexRule(value:
|
|
85
|
-
value:
|
|
86
|
-
replacements:
|
|
84
|
+
declare function applyRegexRule(value:string,rule:RegexRule,replacement:string):{
|
|
85
|
+
value:string;
|
|
86
|
+
replacements:number;
|
|
87
87
|
};
|
|
88
|
-
declare function redactStringValue(value:
|
|
89
|
-
value:
|
|
90
|
-
replacements:
|
|
88
|
+
declare function redactStringValue(value:string,rules:RedactionRule[],replacement:string):{
|
|
89
|
+
value:string;
|
|
90
|
+
replacements:number;
|
|
91
91
|
};
|
|
92
|
-
declare function redactUnknownValue(value:
|
|
93
|
-
value:
|
|
94
|
-
replacements:
|
|
92
|
+
declare function redactUnknownValue(value:unknown,rules:RedactionRule[],replacement:string):{
|
|
93
|
+
value:unknown;
|
|
94
|
+
replacements:number;
|
|
95
95
|
};
|
|
96
|
-
declare function hasItemMetadata(replay:
|
|
96
|
+
declare function hasItemMetadata(replay:ReplayDocument):boolean;
|
|
97
97
|
/** Implements run history redact for the public runtime surface of this module. */
|
|
98
|
-
export declare function runHistoryRedact(id:
|
|
98
|
+
export declare function runHistoryRedact(id:string,options:HistoryRedactCommandOptions,global:GlobalOptions):Promise<HistoryRedactResult>;
|
|
99
99
|
/** Public contract for test only, shared by SDK and presentation-layer consumers. */
|
|
100
|
-
export declare const _testOnly:
|
|
101
|
-
applyLiteralRule:
|
|
102
|
-
applyRegexRule:
|
|
103
|
-
buildRedactionRules:
|
|
104
|
-
hasItemMetadata:
|
|
105
|
-
normalizeRegexFlags:
|
|
106
|
-
normalizeStringArrayInput:
|
|
107
|
-
parseRegexRule:
|
|
108
|
-
redactStringValue:
|
|
109
|
-
redactUnknownValue:
|
|
100
|
+
export declare const _testOnly:{
|
|
101
|
+
applyLiteralRule:typeof applyLiteralRule;
|
|
102
|
+
applyRegexRule:typeof applyRegexRule;
|
|
103
|
+
buildRedactionRules:typeof buildRedactionRules;
|
|
104
|
+
hasItemMetadata:typeof hasItemMetadata;
|
|
105
|
+
normalizeRegexFlags:typeof normalizeRegexFlags;
|
|
106
|
+
normalizeStringArrayInput:typeof normalizeStringArrayInput;
|
|
107
|
+
parseRegexRule:typeof parseRegexRule;
|
|
108
|
+
redactStringValue:typeof redactStringValue;
|
|
109
|
+
redactUnknownValue:typeof redactUnknownValue;
|
|
110
110
|
};
|