@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,262 +1,262 @@
|
|
|
1
1
|
import { type GlobalOptions } from "../runtime-primitives.js";
|
|
2
|
-
import type { DependencyKind,
|
|
3
|
-
import type { MutationMetadataCommandOptions,
|
|
2
|
+
import type { DependencyKind,ItemMetadata,PlanDecision,PlanDiscovery,PlanHarness,PlanMode,PlanStep,PlanStepStatus,PlanValidationCheck } from "../../types/index.js";
|
|
3
|
+
import type { MutationMetadataCommandOptions,SharedLinkedResourceOptions } from "./mutation-command-options.js";
|
|
4
4
|
import { type PlanMutationReceipt } from "./plan-mutation-receipt.js";
|
|
5
5
|
/** Public contract for plan subcommands, shared by SDK and presentation-layer consumers. */
|
|
6
|
-
export declare const PLAN_SUBCOMMANDS:
|
|
6
|
+
export declare const PLAN_SUBCOMMANDS:readonly ["create","show","add-step","update-step","complete-step","block-step","reorder-step","remove-step","link","unlink","decision","discovery","validation","resume","approve","materialize"];
|
|
7
7
|
/** Restricts plan subcommand values accepted by command, SDK, and storage contracts. */
|
|
8
8
|
export type PlanSubcommand = (typeof PLAN_SUBCOMMANDS)[number];
|
|
9
9
|
/** Supported values accepted by the plan show depth contract. */
|
|
10
|
-
export declare const PLAN_SHOW_DEPTH_VALUES:
|
|
10
|
+
export declare const PLAN_SHOW_DEPTH_VALUES:readonly ["brief","standard","deep"];
|
|
11
11
|
/** Restricts plan show depth values accepted by command, SDK, and storage contracts. */
|
|
12
12
|
export type PlanShowDepth = (typeof PLAN_SHOW_DEPTH_VALUES)[number];
|
|
13
13
|
/** Documents the plan command options payload exchanged by command, SDK, and package integrations. */
|
|
14
|
-
export interface PlanCommandOptions extends Omit<MutationMetadataCommandOptions,
|
|
14
|
+
export interface PlanCommandOptions extends Omit<MutationMetadataCommandOptions,"author" | "blockedBy" | "message" | "parent">,Omit<SharedLinkedResourceOptions,"dep" | "doc" | "field" | "file" | "test"> {
|
|
15
15
|
/** Value that configures or reports title for this contract. */
|
|
16
|
-
title?:
|
|
16
|
+
title?:string;
|
|
17
17
|
/** Value that configures or reports description for this contract. */
|
|
18
|
-
description?:
|
|
18
|
+
description?:string;
|
|
19
19
|
/** Value that configures or reports scope for this contract. */
|
|
20
|
-
scope?:
|
|
20
|
+
scope?:string;
|
|
21
21
|
/** Value that configures or reports parent for this contract. */
|
|
22
|
-
parent?:
|
|
22
|
+
parent?:string;
|
|
23
23
|
/** Value that configures or reports related for this contract. */
|
|
24
|
-
related?:
|
|
24
|
+
related?:string | string[];
|
|
25
25
|
/** Value that configures or reports blocks for this contract. */
|
|
26
|
-
blocks?:
|
|
26
|
+
blocks?:string | string[];
|
|
27
27
|
/** Value that configures or reports blocked by for this contract. */
|
|
28
|
-
blockedBy?:
|
|
28
|
+
blockedBy?:string | string[];
|
|
29
29
|
/** Value that configures or reports harness for this contract. */
|
|
30
|
-
harness?:
|
|
30
|
+
harness?:string;
|
|
31
31
|
/** Value that configures or reports mode for this contract. */
|
|
32
|
-
mode?:
|
|
32
|
+
mode?:string;
|
|
33
33
|
/** Value that configures or reports resume context for this contract. */
|
|
34
|
-
resumeContext?:
|
|
34
|
+
resumeContext?:string;
|
|
35
35
|
/** Value that configures or reports tags for this contract. */
|
|
36
|
-
tags?:
|
|
36
|
+
tags?:string;
|
|
37
37
|
/** Value that configures or reports priority for this contract. */
|
|
38
|
-
priority?:
|
|
38
|
+
priority?:string;
|
|
39
39
|
/** Lifecycle status used when creating the Plan item. */
|
|
40
|
-
status?:
|
|
40
|
+
status?:string;
|
|
41
41
|
/** Required-option policy used when creating the Plan item. */
|
|
42
|
-
createMode?:
|
|
42
|
+
createMode?:string;
|
|
43
43
|
/** Value that configures or reports body for this contract. */
|
|
44
|
-
body?:
|
|
44
|
+
body?:string;
|
|
45
45
|
/** Value that configures or reports claim for this contract. */
|
|
46
|
-
claim?:
|
|
46
|
+
claim?:boolean;
|
|
47
47
|
/** Value that configures or reports from search for this contract. */
|
|
48
|
-
fromSearch?:
|
|
48
|
+
fromSearch?:string;
|
|
49
49
|
/** Value that configures or reports step title for this contract. */
|
|
50
|
-
stepTitle?:
|
|
50
|
+
stepTitle?:string;
|
|
51
51
|
/** pm-6mit: repeatable --step values. On create each value seeds one ordered step (argv order; values are never comma-split so titles may contain commas). On other subcommands a single value aliases stepTitle. */
|
|
52
|
-
step?:
|
|
52
|
+
step?:string | string[];
|
|
53
53
|
/** Value that configures or reports step body for this contract. */
|
|
54
|
-
stepBody?:
|
|
54
|
+
stepBody?:string;
|
|
55
55
|
/** Value that configures or reports step owner for this contract. */
|
|
56
|
-
stepOwner?:
|
|
56
|
+
stepOwner?:string;
|
|
57
57
|
/** Lifecycle status of the referenced plan step. */
|
|
58
|
-
stepStatus?:
|
|
58
|
+
stepStatus?:string;
|
|
59
59
|
/** Value that configures or reports step evidence for this contract. */
|
|
60
|
-
stepEvidence?:
|
|
60
|
+
stepEvidence?:string;
|
|
61
61
|
/** Value that configures or reports step blocked reason for this contract. */
|
|
62
|
-
stepBlockedReason?:
|
|
62
|
+
stepBlockedReason?:string;
|
|
63
63
|
/** Value that configures or reports step replacement for this contract. */
|
|
64
|
-
stepReplacement?:
|
|
64
|
+
stepReplacement?:string;
|
|
65
65
|
/** Value that configures or reports depends on for this contract. */
|
|
66
|
-
dependsOn?:
|
|
66
|
+
dependsOn?:string | string[];
|
|
67
67
|
/** Value that configures or reports link for this contract. */
|
|
68
|
-
link?:
|
|
68
|
+
link?:string | string[];
|
|
69
69
|
/** Value that configures or reports link kind for this contract. */
|
|
70
|
-
linkKind?:
|
|
70
|
+
linkKind?:string;
|
|
71
71
|
/** Value that configures or reports link note for this contract. */
|
|
72
|
-
linkNote?:
|
|
72
|
+
linkNote?:string;
|
|
73
73
|
/** Value that configures or reports promote to item dep for this contract. */
|
|
74
|
-
promoteToItemDep?:
|
|
74
|
+
promoteToItemDep?:boolean;
|
|
75
75
|
/** Value that configures or reports allow multiple active for this contract. */
|
|
76
|
-
allowMultipleActive?:
|
|
76
|
+
allowMultipleActive?:boolean;
|
|
77
77
|
/** Value that configures or reports file for this contract. */
|
|
78
|
-
file?:
|
|
78
|
+
file?:string | string[];
|
|
79
79
|
/** Value that configures or reports test for this contract. */
|
|
80
|
-
test?:
|
|
80
|
+
test?:string | string[];
|
|
81
81
|
/** Value that configures or reports doc for this contract. */
|
|
82
|
-
doc?:
|
|
82
|
+
doc?:string | string[];
|
|
83
83
|
/** Value that configures or reports decision text for this contract. */
|
|
84
|
-
decisionText?:
|
|
84
|
+
decisionText?:string;
|
|
85
85
|
/** Value that configures or reports decision for this contract. */
|
|
86
|
-
decision?:
|
|
86
|
+
decision?:string;
|
|
87
87
|
/** Value that configures or reports decision rationale for this contract. */
|
|
88
|
-
decisionRationale?:
|
|
88
|
+
decisionRationale?:string;
|
|
89
89
|
/** Value that configures or reports decision evidence for this contract. */
|
|
90
|
-
decisionEvidence?:
|
|
90
|
+
decisionEvidence?:string;
|
|
91
91
|
/** Value that configures or reports discovery text for this contract. */
|
|
92
|
-
discoveryText?:
|
|
92
|
+
discoveryText?:string;
|
|
93
93
|
/** Value that configures or reports discovery for this contract. */
|
|
94
|
-
discovery?:
|
|
94
|
+
discovery?:string;
|
|
95
95
|
/** Value that configures or reports validation text for this contract. */
|
|
96
|
-
validationText?:
|
|
96
|
+
validationText?:string;
|
|
97
97
|
/** Value that configures or reports validation for this contract. */
|
|
98
|
-
validation?:
|
|
98
|
+
validation?:string;
|
|
99
99
|
/** Value that configures or reports validation command for this contract. */
|
|
100
|
-
validationCommand?:
|
|
100
|
+
validationCommand?:string;
|
|
101
101
|
/** Value that configures or reports validation expected for this contract. */
|
|
102
|
-
validationExpected?:
|
|
102
|
+
validationExpected?:string;
|
|
103
103
|
/** Value that configures or reports depth for this contract. */
|
|
104
|
-
depth?:
|
|
104
|
+
depth?:string;
|
|
105
105
|
/** Value that configures or reports fields for this contract. */
|
|
106
|
-
fields?:
|
|
106
|
+
fields?:string;
|
|
107
107
|
/** Value that configures or reports steps for this contract. */
|
|
108
|
-
steps?:
|
|
108
|
+
steps?:string;
|
|
109
109
|
/** Value that configures or reports template for this contract. */
|
|
110
|
-
template?:
|
|
110
|
+
template?:string;
|
|
111
111
|
/** Schema type that determines the shape and validation rules for this value. */
|
|
112
|
-
materializeType?:
|
|
112
|
+
materializeType?:string;
|
|
113
113
|
/** Value that configures or reports materialize parent for this contract. */
|
|
114
|
-
materializeParent?:
|
|
114
|
+
materializeParent?:string;
|
|
115
115
|
/** Value that configures or reports materialize tags for this contract. */
|
|
116
|
-
materializeTags?:
|
|
116
|
+
materializeTags?:string;
|
|
117
117
|
/** Custom field values forwarded to every materialized item as `name=value` pairs. */
|
|
118
|
-
field?:
|
|
118
|
+
field?:string | string[];
|
|
119
119
|
/** Value that configures or reports author for this contract. */
|
|
120
|
-
author?:
|
|
120
|
+
author?:string;
|
|
121
121
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
122
|
-
message?:
|
|
122
|
+
message?:string;
|
|
123
123
|
/** Value that configures or reports force for this contract. */
|
|
124
|
-
force?:
|
|
124
|
+
force?:boolean;
|
|
125
125
|
}
|
|
126
126
|
/** Presentation-neutral input accepted by SDK-owned planning operations. */
|
|
127
127
|
export type PlanOperationOptions = PlanCommandOptions;
|
|
128
128
|
/** Documents the plan command result payload exchanged by command, SDK, and package integrations. */
|
|
129
129
|
export interface PlanCommandResult {
|
|
130
130
|
/** Bounded acknowledgement for mutations; full typed Plan state remains available alongside it. */
|
|
131
|
-
mutation_receipt?:
|
|
131
|
+
mutation_receipt?:PlanMutationReceipt;
|
|
132
132
|
/** Value that configures or reports action for this contract. */
|
|
133
|
-
action:
|
|
133
|
+
action:PlanSubcommand;
|
|
134
134
|
/** Value that configures or reports plan for this contract. */
|
|
135
|
-
plan:
|
|
135
|
+
plan:PlanResultPlan;
|
|
136
136
|
/** Value that configures or reports step for this contract. */
|
|
137
|
-
step?:
|
|
137
|
+
step?:PlanStep;
|
|
138
138
|
/** Value that configures or reports current step for this contract. */
|
|
139
|
-
current_step?:
|
|
139
|
+
current_step?:PlanStep | undefined;
|
|
140
140
|
/** Value that configures or reports next actions for this contract. */
|
|
141
|
-
next_actions?:
|
|
141
|
+
next_actions?:string[];
|
|
142
142
|
/** Value that configures or reports materialized for this contract. */
|
|
143
|
-
materialized?:
|
|
144
|
-
id:
|
|
145
|
-
title:
|
|
146
|
-
type:
|
|
147
|
-
parent?:
|
|
148
|
-
tags:
|
|
149
|
-
from_step:
|
|
143
|
+
materialized?:{
|
|
144
|
+
id:string;
|
|
145
|
+
title:string;
|
|
146
|
+
type:string;
|
|
147
|
+
parent?:string;
|
|
148
|
+
tags:string[];
|
|
149
|
+
from_step:string;
|
|
150
150
|
}[];
|
|
151
151
|
/** Value that configures or reports materialize skipped for this contract. */
|
|
152
|
-
materialize_skipped?:
|
|
153
|
-
from_step:
|
|
154
|
-
reason:
|
|
155
|
-
existing_id?:
|
|
152
|
+
materialize_skipped?:{
|
|
153
|
+
from_step:string;
|
|
154
|
+
reason:"already_completed" | "already_materialized";
|
|
155
|
+
existing_id?:string;
|
|
156
156
|
}[];
|
|
157
157
|
/** Value that configures or reports warnings for this contract. */
|
|
158
|
-
warnings:
|
|
158
|
+
warnings:string[];
|
|
159
159
|
/** ISO 8601 timestamp recording when generated occurred. */
|
|
160
|
-
generated_at:
|
|
160
|
+
generated_at:string;
|
|
161
161
|
}
|
|
162
162
|
/** Documents the plan result plan payload exchanged by command, SDK, and package integrations. */
|
|
163
163
|
export interface PlanResultPlan {
|
|
164
164
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
165
|
-
id:
|
|
165
|
+
id:string;
|
|
166
166
|
/** Value that configures or reports title for this contract. */
|
|
167
|
-
title:
|
|
167
|
+
title:string;
|
|
168
168
|
/** Lifecycle state reported for status. */
|
|
169
|
-
status:
|
|
169
|
+
status:string;
|
|
170
170
|
/** Value that configures or reports mode for this contract. */
|
|
171
|
-
mode:
|
|
171
|
+
mode:PlanMode;
|
|
172
172
|
/** Value that configures or reports scope for this contract. */
|
|
173
|
-
scope?:
|
|
173
|
+
scope?:string;
|
|
174
174
|
/** Value that configures or reports harness for this contract. */
|
|
175
|
-
harness?:
|
|
175
|
+
harness?:PlanHarness;
|
|
176
176
|
/** Value that configures or reports parent for this contract. */
|
|
177
|
-
parent?:
|
|
177
|
+
parent?:string;
|
|
178
178
|
/** Value that configures or reports resume context for this contract. */
|
|
179
|
-
resume_context?:
|
|
179
|
+
resume_context?:string;
|
|
180
180
|
/** Value that configures or reports steps summary for this contract. */
|
|
181
|
-
steps_summary:
|
|
181
|
+
steps_summary:PlanStepSummary;
|
|
182
182
|
/** Value that configures or reports current step for this contract. */
|
|
183
|
-
current_step?:
|
|
184
|
-
id:
|
|
185
|
-
order:
|
|
186
|
-
title:
|
|
187
|
-
status:
|
|
183
|
+
current_step?:{
|
|
184
|
+
id:string;
|
|
185
|
+
order:number;
|
|
186
|
+
title:string;
|
|
187
|
+
status:PlanStepStatus;
|
|
188
188
|
} | undefined;
|
|
189
189
|
/** Value that configures or reports blocked steps for this contract. */
|
|
190
|
-
blocked_steps?:
|
|
191
|
-
id:
|
|
192
|
-
order:
|
|
193
|
-
title:
|
|
194
|
-
blocked_reason?:
|
|
190
|
+
blocked_steps?:{
|
|
191
|
+
id:string;
|
|
192
|
+
order:number;
|
|
193
|
+
title:string;
|
|
194
|
+
blocked_reason?:string;
|
|
195
195
|
}[];
|
|
196
196
|
/** Value that configures or reports steps for this contract. */
|
|
197
|
-
steps?:
|
|
197
|
+
steps?:PlanStep[];
|
|
198
198
|
/** Value that configures or reports decisions for this contract. */
|
|
199
|
-
decisions?:
|
|
199
|
+
decisions?:PlanDecision[];
|
|
200
200
|
/** Value that configures or reports discoveries for this contract. */
|
|
201
|
-
discoveries?:
|
|
201
|
+
discoveries?:PlanDiscovery[];
|
|
202
202
|
/** Value that configures or reports validation for this contract. */
|
|
203
|
-
validation?:
|
|
203
|
+
validation?:PlanValidationCheck[];
|
|
204
204
|
/** Value that configures or reports linked items for this contract. */
|
|
205
|
-
linked_items?:
|
|
206
|
-
id:
|
|
207
|
-
kind:
|
|
205
|
+
linked_items?:{
|
|
206
|
+
id:string;
|
|
207
|
+
kind:DependencyKind;
|
|
208
208
|
}[];
|
|
209
209
|
}
|
|
210
210
|
/** Documents the plan step summary payload exchanged by command, SDK, and package integrations. */
|
|
211
211
|
export interface PlanStepSummary {
|
|
212
212
|
/** Value that configures or reports total for this contract. */
|
|
213
|
-
total:
|
|
213
|
+
total:number;
|
|
214
214
|
/** Value that configures or reports pending for this contract. */
|
|
215
|
-
pending:
|
|
215
|
+
pending:number;
|
|
216
216
|
/** Value that configures or reports in progress for this contract. */
|
|
217
|
-
in_progress:
|
|
217
|
+
in_progress:number;
|
|
218
218
|
/** Value that configures or reports blocked for this contract. */
|
|
219
|
-
blocked:
|
|
219
|
+
blocked:number;
|
|
220
220
|
/** Value that configures or reports completed for this contract. */
|
|
221
|
-
completed:
|
|
221
|
+
completed:number;
|
|
222
222
|
/** Value that configures or reports skipped for this contract. */
|
|
223
|
-
skipped:
|
|
223
|
+
skipped:number;
|
|
224
224
|
/** Value that configures or reports superseded for this contract. */
|
|
225
|
-
superseded:
|
|
225
|
+
superseded:number;
|
|
226
226
|
/** Whole-percent step-completion progress (`round(completed / total * 100)`), surfaced so agents see plan progress without recomputing it (GH-158 #5). */
|
|
227
|
-
completion_pct:
|
|
227
|
+
completion_pct:number;
|
|
228
228
|
}
|
|
229
229
|
/** Public contract for plan template names, shared by SDK and presentation-layer consumers. */
|
|
230
|
-
export declare const PLAN_TEMPLATE_NAMES:
|
|
230
|
+
export declare const PLAN_TEMPLATE_NAMES:readonly ["bug-investigation","feature-implementation","refactoring-sprint"];
|
|
231
231
|
/** Restricts plan template names accepted by `pm plan create --template` (GH-158 #2). */
|
|
232
232
|
export type PlanTemplateName = (typeof PLAN_TEMPLATE_NAMES)[number];
|
|
233
233
|
interface PlanTemplateStepSeed {
|
|
234
|
-
title:
|
|
235
|
-
body:
|
|
234
|
+
title:string;
|
|
235
|
+
body:string;
|
|
236
236
|
}
|
|
237
237
|
/** Resolves the ordered step seeds for a built-in plan template, rejecting unknown names with the allowed set so agents can self-correct. */
|
|
238
|
-
export declare function resolvePlanTemplateSteps(raw:
|
|
238
|
+
export declare function resolvePlanTemplateSteps(raw:string):PlanTemplateStepSeed[];
|
|
239
239
|
/** Compare the union of persisted Plan metadata keys so additions, updates, and removals are all audited. */
|
|
240
|
-
declare function changedPlanMetadataFields(beforePlanFields:
|
|
240
|
+
declare function changedPlanMetadataFields(beforePlanFields:ReadonlyMap<string,string | undefined>,metadata:ItemMetadata):string[];
|
|
241
241
|
/** Documents the plan dispatch input payload exchanged by command, SDK, and package integrations. */
|
|
242
242
|
export interface PlanDispatchInput {
|
|
243
243
|
/** Value that configures or reports subcommand for this contract. */
|
|
244
|
-
subcommand:
|
|
244
|
+
subcommand:PlanSubcommand;
|
|
245
245
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
246
|
-
id?:
|
|
246
|
+
id?:string;
|
|
247
247
|
/** Value that configures or reports step ref for this contract. */
|
|
248
|
-
stepRef?:
|
|
248
|
+
stepRef?:string;
|
|
249
249
|
/** Value that configures or reports reorder to for this contract. */
|
|
250
|
-
reorderTo?:
|
|
250
|
+
reorderTo?:number;
|
|
251
251
|
/** Value that configures or reports options for this contract. */
|
|
252
|
-
options:
|
|
252
|
+
options:PlanCommandOptions;
|
|
253
253
|
/** Value that configures or reports global for this contract. */
|
|
254
|
-
global:
|
|
254
|
+
global:GlobalOptions;
|
|
255
255
|
}
|
|
256
256
|
/** Implements run plan for the public runtime surface of this module. */
|
|
257
|
-
export declare function runPlan(input:
|
|
257
|
+
export declare function runPlan(input:PlanDispatchInput):Promise<PlanCommandResult>;
|
|
258
258
|
/** Internal Plan mutation helpers exposed only for branch-complete regression coverage. */
|
|
259
|
-
export declare const _testOnlyPlanCommand:
|
|
260
|
-
changedPlanMetadataFields:
|
|
259
|
+
export declare const _testOnlyPlanCommand:{
|
|
260
|
+
changedPlanMetadataFields:typeof changedPlanMetadataFields;
|
|
261
261
|
};
|
|
262
262
|
export {};
|
|
@@ -14,11 +14,11 @@ import type { RecurrenceRule } from "../../types/index.js";
|
|
|
14
14
|
* via the `emptyNumericGuard` option so both call sites keep their exact
|
|
15
15
|
* behaviour, including error strings.
|
|
16
16
|
*/
|
|
17
|
-
export declare function parseEventBoolean(value:
|
|
17
|
+
export declare function parseEventBoolean(value:string,flag:string):boolean;
|
|
18
18
|
/** Implements parse delimited list for the public runtime surface of this module. */
|
|
19
|
-
export declare function parseDelimitedList(raw:
|
|
19
|
+
export declare function parseDelimitedList(raw:string | undefined):string[];
|
|
20
20
|
/** Implements ensure enum value for the public runtime surface of this module. */
|
|
21
|
-
export declare function ensureEnumValue<T extends string>(value:
|
|
21
|
+
export declare function ensureEnumValue<T extends string>(value:string,allowed:readonly T[],label:string,field?:string):T;
|
|
22
22
|
/** `"defined"` parses `recur_interval=`/`recur_count=` (empty values), matching the historical `create` behaviour. `"truthy"` skips empty values, matching the historical `update` behaviour. */
|
|
23
23
|
export type RecurrenceEmptyNumericGuard = "defined" | "truthy";
|
|
24
24
|
/**
|
|
@@ -29,6 +29,6 @@ export type RecurrenceEmptyNumericGuard = "defined" | "truthy";
|
|
|
29
29
|
* a new recur key can never be silently rejected (GH-258). Keep in sync with
|
|
30
30
|
* the `kv.recur_*` reads below.
|
|
31
31
|
*/
|
|
32
|
-
export declare const RECURRENCE_CSV_KEYS:
|
|
32
|
+
export declare const RECURRENCE_CSV_KEYS:readonly ["recur_freq","recur_interval","recur_count","recur_until","recur_by_weekday","recur_by_month_day","recur_exdates"];
|
|
33
33
|
/** Implements parse recurrence rule for the public runtime surface of this module. */
|
|
34
|
-
export declare function parseRecurrenceRule(kv:
|
|
34
|
+
export declare function parseRecurrenceRule(kv:Record<string,string>,startAt:string,nowValue:Date,emptyNumericGuard:RecurrenceEmptyNumericGuard):RecurrenceRule | undefined;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/** @module sdk/lifecycle/release-handoff Validates project-defined handoff queues before ownership changes. */
|
|
2
|
+
import { type RuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
|
|
3
|
+
import type { ItemMetadata,PmSettings } from "../../types/index.js";
|
|
4
|
+
import type { ReleaseMutationOptions,ReleaseResult } from "./claim.js";
|
|
5
|
+
/** Resolve a declared non-terminal queue and evidence without inventing project statuses. */
|
|
6
|
+
export declare function resolveReleaseHandoff(options:ReleaseMutationOptions,registry:RuntimeStatusRegistry):string | undefined;
|
|
7
|
+
/** Enforce the locked source state and configured transition before changing the queue. */
|
|
8
|
+
export declare function applyReleaseHandoff(metadata:ItemMetadata,target:string,settings:PmSettings,registry:RuntimeStatusRegistry,message:string):{
|
|
9
|
+
receipt:NonNullable<ReleaseResult["handoff"]>;
|
|
10
|
+
warnings:string[];
|
|
11
|
+
changedFields:string[];
|
|
12
|
+
};
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e32c9f13-2e6a-5ac6-a1ce-9c839121441a")}catch{}})();import{normalizeStatusInputWithRegistry,statusIsTerminal}from"../../core/schema/runtime-schema.js";import{resolveTypeWorkflows}from"../../core/schema/type-workflows.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{enforceTypeWorkflowTransition}from"./workflow-transition.js";function resolveReleaseHandoff(options,registry){if(options.handoff===void 0)return;if(options.pause===!0)throw new PmCliError("--handoff cannot be combined with --pause. Choose a handoff queue or pause the item.",EXIT_CODE.USAGE);const status=typeof options.handoff=="string"?normalizeStatusInputWithRegistry(options.handoff,registry):void 0;if(status===void 0||statusIsTerminal(status,registry)||status===registry.in_progress_status)throw new PmCliError("--handoff must name a configured non-terminal status distinct from the in-progress status. Inspect pm schema statuses or add a project queue with pm schema add-status <queue> --role active.",EXIT_CODE.USAGE);if(typeof options.message!="string"||options.message.trim().length===0)throw new PmCliError("--handoff requires --message with implementation evidence and the next verification step.",EXIT_CODE.USAGE);return status}function applyReleaseHandoff(metadata,target,settings,registry,message){if(statusIsTerminal(metadata.status,registry)||!metadata.assignee?.trim())throw new PmCliError("Handoff requires a claimed, non-terminal item. Claim the active work before handing it off; use pm item reopen for completed work.",EXIT_CODE.CONFLICT);const enforcement=settings.governance.workflow_enforcement??"off",warning=enforceTypeWorkflowTransition({enforcement,typeWorkflows:enforcement==="off"?[]:resolveTypeWorkflows(settings.schema),statusRegistry:registry,typeName:metadata.type,fromStatus:metadata.status,toStatus:target}),receipt={from_status:metadata.status,to_status:target,message},changedFields=metadata.status===target?[]:["status"];return metadata.status=target,{receipt,warnings:warning?[warning]:[],changedFields}}export{applyReleaseHandoff,resolveReleaseHandoff};
|
|
2
|
+
//# sourceMappingURL=release-handoff.js.map
|
|
@@ -11,39 +11,39 @@ export type { PreviousTerminalEvidence } from "./update.js";
|
|
|
11
11
|
/** Options accepted by the SDK and `pm item reopen` recurrence primitive. */
|
|
12
12
|
export interface ReopenCommandOptions {
|
|
13
13
|
/** Active target status; only the workspace open or in-progress status is allowed. */
|
|
14
|
-
status?:
|
|
14
|
+
status?:string;
|
|
15
15
|
/** Current active planning expectation, replacing the archived terminal expectation. */
|
|
16
|
-
expectedResult?:
|
|
16
|
+
expectedResult?:string;
|
|
17
17
|
/** Explicit mutation author override. */
|
|
18
|
-
author?:
|
|
18
|
+
author?:string;
|
|
19
19
|
/** Optional human-readable history message in addition to structured recurrence context. */
|
|
20
|
-
message?:
|
|
20
|
+
message?:string;
|
|
21
21
|
/** Override an ownership or stale-lock conflict. */
|
|
22
|
-
force?:
|
|
22
|
+
force?:boolean;
|
|
23
23
|
}
|
|
24
24
|
/** Structured recurrence receipt returned by every presentation surface. */
|
|
25
25
|
export interface RecurrenceReceipt {
|
|
26
26
|
/** Required reason that the terminal work became active again. */
|
|
27
|
-
reason:
|
|
27
|
+
reason:string;
|
|
28
28
|
/** Terminal status observed while holding the item lock. */
|
|
29
|
-
from_status:
|
|
29
|
+
from_status:string;
|
|
30
30
|
/** Active status written through the update pipeline. */
|
|
31
|
-
to_status:
|
|
31
|
+
to_status:string;
|
|
32
32
|
/** Prior terminal evidence retained in immutable history. */
|
|
33
|
-
previous_terminal:
|
|
33
|
+
previous_terminal:PreviousTerminalEvidence;
|
|
34
34
|
}
|
|
35
35
|
/** Result returned after a terminal item is reopened. */
|
|
36
36
|
export interface ReopenResult {
|
|
37
37
|
/** Reopened item metadata. */
|
|
38
|
-
item:
|
|
38
|
+
item:Record<string,unknown>;
|
|
39
39
|
/** Fields changed by the canonical update pipeline. */
|
|
40
|
-
changed_fields:
|
|
40
|
+
changed_fields:string[];
|
|
41
41
|
/** Non-fatal mutation and extension warnings. */
|
|
42
|
-
warnings:
|
|
42
|
+
warnings:string[];
|
|
43
43
|
/** Immutable recurrence transition receipt. */
|
|
44
|
-
recurrence:
|
|
44
|
+
recurrence:RecurrenceReceipt;
|
|
45
45
|
/** Executable planning recovery when the caller has not supplied a current expectation. */
|
|
46
|
-
recovery?:
|
|
46
|
+
recovery?:PmCliErrorRecoveryPayload;
|
|
47
47
|
}
|
|
48
48
|
/** Reopen terminal work through the canonical update mutation and history path. */
|
|
49
|
-
export declare function runReopen(id:
|
|
49
|
+
export declare function runReopen(id:string,reason:string,options:ReopenCommandOptions,global:GlobalOptions):Promise<ReopenResult>;
|
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
import type { CalendarEvent,
|
|
1
|
+
import type { CalendarEvent,Reminder } from "../../types/index.js";
|
|
2
2
|
import { type RecurrenceEmptyNumericGuard } from "./recurrence-parsers.js";
|
|
3
3
|
type EmptyValueGuard = "defined" | "truthy";
|
|
4
4
|
type ReminderValueMode = "raw" | "trimmed";
|
|
5
5
|
interface ParseReminderEntriesOptions {
|
|
6
|
-
valueMode:
|
|
6
|
+
valueMode:ReminderValueMode;
|
|
7
7
|
}
|
|
8
8
|
interface ParseEventEntriesOptions {
|
|
9
|
-
allDayEmptyGuard:
|
|
10
|
-
recurrenceEmptyNumericGuard:
|
|
9
|
+
allDayEmptyGuard:EmptyValueGuard;
|
|
10
|
+
recurrenceEmptyNumericGuard:RecurrenceEmptyNumericGuard;
|
|
11
11
|
}
|
|
12
12
|
/** Implements parse reminder entries for the public runtime surface of this module. */
|
|
13
|
-
export declare function parseReminderEntries(raw:
|
|
13
|
+
export declare function parseReminderEntries(raw:string[],nowValue:Date,options:ParseReminderEntriesOptions):Reminder[];
|
|
14
14
|
/** Implements parse event entries for the public runtime surface of this module. */
|
|
15
|
-
export declare function parseEventEntries(raw:
|
|
15
|
+
export declare function parseEventEntries(raw:string[],nowValue:Date,options:ParseEventEntriesOptions):CalendarEvent[];
|
|
16
16
|
/** Implements parse type option entries for the public runtime surface of this module. */
|
|
17
|
-
export declare function parseTypeOptionEntries(raw:
|
|
17
|
+
export declare function parseTypeOptionEntries(raw:string[]):Record<string,string>;
|
|
18
18
|
export {};
|
|
@@ -1,56 +1,56 @@
|
|
|
1
|
-
import { type GlobalOptions,
|
|
2
|
-
import { applyHistoryPatch,
|
|
3
|
-
import type { HistoryEntry,
|
|
1
|
+
import { type GlobalOptions,locateItem,readSettings } from "../runtime-primitives.js";
|
|
2
|
+
import { applyHistoryPatch,ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget,extractPatchFailureContext,replayHistoryToTarget as replayToTarget } from "../history-read.js";
|
|
3
|
+
import type { HistoryEntry,ItemDocument,ItemMetadata } from "../../types/index.js";
|
|
4
4
|
interface ResolvedRestoreSubject {
|
|
5
|
-
id:
|
|
6
|
-
historyPath:
|
|
7
|
-
located:
|
|
8
|
-
historyPolicyWarnings:
|
|
5
|
+
id:string;
|
|
6
|
+
historyPath:string;
|
|
7
|
+
located:Awaited<ReturnType<typeof locateItem>>;
|
|
8
|
+
historyPolicyWarnings:string[];
|
|
9
9
|
}
|
|
10
10
|
/** Documents the restore command options payload exchanged by command, SDK, and package integrations. */
|
|
11
11
|
export interface RestoreCommandOptions {
|
|
12
12
|
/** Value that configures or reports author for this contract. */
|
|
13
|
-
author?:
|
|
13
|
+
author?:string;
|
|
14
14
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
15
|
-
message?:
|
|
15
|
+
message?:string;
|
|
16
16
|
/** Value that configures or reports force for this contract. */
|
|
17
|
-
force?:
|
|
17
|
+
force?:boolean;
|
|
18
18
|
}
|
|
19
19
|
/** Documents the restore result payload exchanged by command, SDK, and package integrations. */
|
|
20
20
|
export interface RestoreResult {
|
|
21
21
|
/** Value that configures or reports item for this contract. */
|
|
22
|
-
item:
|
|
22
|
+
item:ItemMetadata;
|
|
23
23
|
/** Value that configures or reports restored from for this contract. */
|
|
24
|
-
restored_from:
|
|
25
|
-
kind:
|
|
26
|
-
target:
|
|
27
|
-
history_index:
|
|
28
|
-
version:
|
|
29
|
-
entry_ts:
|
|
30
|
-
entry_op:
|
|
24
|
+
restored_from:{
|
|
25
|
+
kind:"version" | "timestamp";
|
|
26
|
+
target:string;
|
|
27
|
+
history_index:number;
|
|
28
|
+
version:number | null;
|
|
29
|
+
entry_ts:string;
|
|
30
|
+
entry_op:string;
|
|
31
31
|
};
|
|
32
32
|
/** Value that configures or reports changed fields for this contract. */
|
|
33
|
-
changed_fields:
|
|
33
|
+
changed_fields:string[];
|
|
34
34
|
/** Value that configures or reports warnings for this contract. */
|
|
35
|
-
warnings:
|
|
35
|
+
warnings:string[];
|
|
36
36
|
}
|
|
37
37
|
/** Resolve restore targets with the command's established wording and at-or-before timestamp semantics. */
|
|
38
|
-
declare function ensureReplayTarget(target:
|
|
39
|
-
declare function replayCurrentDocument(history:
|
|
38
|
+
declare function ensureReplayTarget(target:string,history:readonly HistoryEntry[]):import("../../core/history/projection.js").ResolvedHistoryTarget;
|
|
39
|
+
declare function replayCurrentDocument(history:HistoryEntry[]):ItemDocument;
|
|
40
40
|
/** Resolve live or deleted history and enforce the current item's stream policy before restoring a historical version. */
|
|
41
|
-
declare function resolveRestoreSubject(pmRoot:
|
|
42
|
-
declare function changedFields(beforeDocument:
|
|
41
|
+
declare function resolveRestoreSubject(pmRoot:string,id:string,settings:Awaited<ReturnType<typeof readSettings>>,typeToFolder:Record<string,string>):Promise<ResolvedRestoreSubject>;
|
|
42
|
+
declare function changedFields(beforeDocument:ItemDocument,afterDocument:ItemDocument):string[];
|
|
43
43
|
/** Implements run restore for the public runtime surface of this module. */
|
|
44
|
-
export declare function runRestore(id:
|
|
44
|
+
export declare function runRestore(id:string,target:string,options:RestoreCommandOptions,global:GlobalOptions):Promise<RestoreResult>;
|
|
45
45
|
/** Public contract for test only restore command, shared by SDK and presentation-layer consumers. */
|
|
46
|
-
export declare const _testOnlyRestoreCommand:
|
|
47
|
-
applyHistoryPatch:
|
|
48
|
-
changedFields:
|
|
49
|
-
ensureMaterializedRestoreTarget:
|
|
50
|
-
ensureReplayTarget:
|
|
51
|
-
extractPatchFailureContext:
|
|
52
|
-
replayCurrentDocument:
|
|
53
|
-
replayToTarget:
|
|
54
|
-
resolveRestoreSubject:
|
|
46
|
+
export declare const _testOnlyRestoreCommand:{
|
|
47
|
+
applyHistoryPatch:typeof applyHistoryPatch;
|
|
48
|
+
changedFields:typeof changedFields;
|
|
49
|
+
ensureMaterializedRestoreTarget:typeof ensureMaterializedRestoreTarget;
|
|
50
|
+
ensureReplayTarget:typeof ensureReplayTarget;
|
|
51
|
+
extractPatchFailureContext:typeof extractPatchFailureContext;
|
|
52
|
+
replayCurrentDocument:typeof replayCurrentDocument;
|
|
53
|
+
replayToTarget:typeof replayToTarget;
|
|
54
|
+
resolveRestoreSubject:typeof resolveRestoreSubject;
|
|
55
55
|
};
|
|
56
56
|
export {};
|