@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,139 +1,139 @@
|
|
|
1
|
-
import { type ResolvedItemTypeDefinition,
|
|
1
|
+
import { type ResolvedItemTypeDefinition,type RuntimeFieldRegistry,type GlobalOptions } from "../runtime-primitives.js";
|
|
2
2
|
import { type SimilarityAdvisory } from "../similarity.js";
|
|
3
3
|
import { type LifecycleTransitionSuggestion } from "./lifecycle-transitions.js";
|
|
4
|
-
import type { MutationMetadataCommandOptions,
|
|
5
|
-
import type { Comment,
|
|
4
|
+
import type { MutationMetadataCommandOptions,SharedLinkedResourceClearOptions,SharedLinkedResourceOptions } from "./mutation-command-options.js";
|
|
5
|
+
import type { Comment,Dependency,ItemMetadata,LinkedDoc,LinkedFile,LinkedTest,LogNote } from "../../types/index.js";
|
|
6
6
|
/** Documents the create command options payload exchanged by command, SDK, and package integrations. */
|
|
7
|
-
export interface CreateCommandOptions extends MutationMetadataCommandOptions,
|
|
7
|
+
export interface CreateCommandOptions extends MutationMetadataCommandOptions,SharedLinkedResourceOptions,SharedLinkedResourceClearOptions {
|
|
8
8
|
/** Value that configures or reports title for this contract. */
|
|
9
|
-
title?:
|
|
9
|
+
title?:string;
|
|
10
10
|
/** Explicit item id, normalized with the workspace prefix instead of randomly generated. */
|
|
11
|
-
id?:
|
|
11
|
+
id?:string;
|
|
12
12
|
/** Value that configures or reports description for this contract. */
|
|
13
|
-
description?:
|
|
13
|
+
description?:string;
|
|
14
14
|
/** Schema type that determines the shape and validation rules for this value. */
|
|
15
|
-
type?:
|
|
15
|
+
type?:string;
|
|
16
16
|
/** Lifecycle state reported for status. */
|
|
17
|
-
status?:
|
|
17
|
+
status?:string;
|
|
18
18
|
/** Author-controlled reason when creating directly in a terminal status. */
|
|
19
|
-
closeReason?:
|
|
19
|
+
closeReason?:string;
|
|
20
20
|
/** Actual completion time when importing an already-completed item. */
|
|
21
|
-
completedAt?:
|
|
21
|
+
completedAt?:string;
|
|
22
22
|
/** Value that configures or reports priority for this contract. */
|
|
23
|
-
priority?:
|
|
23
|
+
priority?:string | number;
|
|
24
24
|
/** Value that configures or reports tags for this contract. */
|
|
25
|
-
tags?:
|
|
25
|
+
tags?:string;
|
|
26
26
|
/** Value that configures or reports add tags for this contract. */
|
|
27
|
-
addTags?:
|
|
27
|
+
addTags?:string[];
|
|
28
28
|
/** Value that configures or reports body for this contract. */
|
|
29
|
-
body?:
|
|
29
|
+
body?:string;
|
|
30
30
|
/** Value that configures or reports allow missing parent for this contract. */
|
|
31
|
-
allowMissingParent?:
|
|
31
|
+
allowMissingParent?:boolean;
|
|
32
32
|
/** Explicitly permit unresolved local dependency targets with warning receipts. */
|
|
33
|
-
allowUnresolvedDeps?:
|
|
33
|
+
allowUnresolvedDeps?:boolean;
|
|
34
34
|
/** Value that configures or reports template for this contract. */
|
|
35
|
-
template?:
|
|
35
|
+
template?:string;
|
|
36
36
|
/** Creates mode using the validated operation inputs. */
|
|
37
|
-
createMode?:
|
|
37
|
+
createMode?:string;
|
|
38
38
|
/** Value that configures or reports schedule preset for this contract. */
|
|
39
|
-
schedulePreset?:
|
|
39
|
+
schedulePreset?:string;
|
|
40
40
|
/** Explicitly permit a likely duplicate when strict governance is enabled. */
|
|
41
|
-
allowDuplicate?:
|
|
42
|
-
[key:
|
|
41
|
+
allowDuplicate?:boolean;
|
|
42
|
+
[key:string]:unknown;
|
|
43
43
|
}
|
|
44
44
|
/** Presentation-neutral input accepted by the SDK-owned create operation. */
|
|
45
45
|
export type CreateOperationOptions = CreateCommandOptions;
|
|
46
46
|
/** Documents the create result payload exchanged by command, SDK, and package integrations. */
|
|
47
47
|
export interface CreateResult {
|
|
48
48
|
/** Value that configures or reports item for this contract. */
|
|
49
|
-
item:
|
|
49
|
+
item:ItemMetadata;
|
|
50
50
|
/** Value that configures or reports changed fields for this contract. */
|
|
51
|
-
changed_fields:
|
|
51
|
+
changed_fields:string[];
|
|
52
52
|
/** Value that configures or reports warnings for this contract. */
|
|
53
|
-
warnings:
|
|
53
|
+
warnings:string[];
|
|
54
54
|
/** Value that configures or reports parent source for this contract. */
|
|
55
|
-
parent_source?:
|
|
55
|
+
parent_source?:"focus";
|
|
56
56
|
/** Value that configures or reports next transition for this contract. */
|
|
57
|
-
next_transition?:
|
|
57
|
+
next_transition?:LifecycleTransitionSuggestion;
|
|
58
58
|
/** Likely existing items found before the mutation committed. */
|
|
59
|
-
similarity_advisory?:
|
|
59
|
+
similarity_advisory?:SimilarityAdvisory;
|
|
60
60
|
}
|
|
61
|
-
declare function buildInvalidLogSeedKeysMessage(optionName:
|
|
62
|
-
declare function parseCreateUnsetTargets(raw:
|
|
63
|
-
metadataKeys:
|
|
64
|
-
optionKeys:
|
|
61
|
+
declare function buildInvalidLogSeedKeysMessage(optionName:"--comment" | "--note" | "--learning",unsupportedKeys:string[]):string;
|
|
62
|
+
declare function parseCreateUnsetTargets(raw:string[] | undefined,runtimeFieldRegistry?:RuntimeFieldRegistry):{
|
|
63
|
+
metadataKeys:Set<string>;
|
|
64
|
+
optionKeys:Set<string>;
|
|
65
65
|
};
|
|
66
|
-
declare function parseDependencies(raw:
|
|
67
|
-
values:
|
|
68
|
-
explicitEmpty:
|
|
66
|
+
declare function parseDependencies(raw:string[] | undefined,nowValue:string,prefix:string,fallbackAuthor:string):{
|
|
67
|
+
values:Dependency[] | undefined;
|
|
68
|
+
explicitEmpty:boolean;
|
|
69
69
|
};
|
|
70
|
-
declare function normalizeDependencyKindInput(raw:
|
|
71
|
-
declare function looksLikeStructuredEntry(raw:
|
|
70
|
+
declare function normalizeDependencyKindInput(raw:string | undefined):string | undefined;
|
|
71
|
+
declare function looksLikeStructuredEntry(raw:string,keys:readonly string[]):boolean;
|
|
72
72
|
/** Implements parse log seed for the public runtime surface of this module. */
|
|
73
|
-
export declare function parseLogSeed(optionName:
|
|
74
|
-
values:
|
|
75
|
-
explicitEmpty:
|
|
73
|
+
export declare function parseLogSeed(optionName:"--comment" | "--note" | "--learning",raw:string[] | undefined,nowValue:string,fallbackAuthor:string):{
|
|
74
|
+
values:LogNote[] | Comment[] | undefined;
|
|
75
|
+
explicitEmpty:boolean;
|
|
76
76
|
};
|
|
77
77
|
/** Implements parse files for the public runtime surface of this module. */
|
|
78
|
-
export declare function parseFiles(raw:
|
|
79
|
-
values:
|
|
80
|
-
explicitEmpty:
|
|
78
|
+
export declare function parseFiles(raw:string[] | undefined):{
|
|
79
|
+
values:LinkedFile[] | undefined;
|
|
80
|
+
explicitEmpty:boolean;
|
|
81
81
|
};
|
|
82
82
|
/** Implements parse tests for the public runtime surface of this module. */
|
|
83
|
-
export declare function parseTests(raw:
|
|
84
|
-
values:
|
|
85
|
-
explicitEmpty:
|
|
83
|
+
export declare function parseTests(raw:string[] | undefined):{
|
|
84
|
+
values:LinkedTest[] | undefined;
|
|
85
|
+
explicitEmpty:boolean;
|
|
86
86
|
};
|
|
87
87
|
/** Implements parse docs for the public runtime surface of this module. */
|
|
88
|
-
export declare function parseDocs(raw:
|
|
89
|
-
values:
|
|
90
|
-
explicitEmpty:
|
|
88
|
+
export declare function parseDocs(raw:string[] | undefined):{
|
|
89
|
+
values:LinkedDoc[] | undefined;
|
|
90
|
+
explicitEmpty:boolean;
|
|
91
91
|
};
|
|
92
|
-
declare function buildHistoryMessage(baseMessage:
|
|
93
|
-
declare function normalizeCreatePolicyOptionKey(raw:
|
|
92
|
+
declare function buildHistoryMessage(baseMessage:string | undefined,explicitUnsets:string[]):string | undefined;
|
|
93
|
+
declare function normalizeCreatePolicyOptionKey(raw:string,typeName:string,sourceLabel:string):string;
|
|
94
94
|
interface CreateOptionValueLookup {
|
|
95
|
-
scalarValues:
|
|
96
|
-
repeatableValues:
|
|
97
|
-
addTags:
|
|
95
|
+
scalarValues:Record<string,unknown>;
|
|
96
|
+
repeatableValues:Record<string,unknown>;
|
|
97
|
+
addTags:string[] | undefined;
|
|
98
98
|
}
|
|
99
|
-
declare function hasCreateOptionValue(lookup:
|
|
100
|
-
declare function collectMissingRequiredTypeOptionKeys(errors:
|
|
101
|
-
declare function filterNonMissingTypeOptionErrors(errors:
|
|
102
|
-
declare function typeOptionExampleValue(typeDefinition:
|
|
99
|
+
declare function hasCreateOptionValue(lookup:CreateOptionValueLookup,optionKey:string):boolean;
|
|
100
|
+
declare function collectMissingRequiredTypeOptionKeys(errors:string[],typeName:string):string[];
|
|
101
|
+
declare function filterNonMissingTypeOptionErrors(errors:string[],typeName:string):string[];
|
|
102
|
+
declare function typeOptionExampleValue(typeDefinition:ResolvedItemTypeDefinition,key:string):string;
|
|
103
103
|
/** Render canonical scalar flags, retaining placeholders only where the caller must supply project-specific intent. */
|
|
104
|
-
declare function createExampleTokensForFlag(flag:
|
|
104
|
+
declare function createExampleTokensForFlag(flag:string,typeName:string,openStatus:string):string[];
|
|
105
105
|
/** Build a runnable option shape for one configured type, expressing empty required collections with explicit clear flags. */
|
|
106
|
-
declare function buildTypeSpecificCreateExample(typeDefinition:
|
|
106
|
+
declare function buildTypeSpecificCreateExample(typeDefinition:ResolvedItemTypeDefinition,missingCreateFlags:string[],missingTypeOptionKeys:string[],openStatus:string):string;
|
|
107
107
|
/** Require a trimmed option value while preserving title-specific recovery guidance. */
|
|
108
|
-
export declare function requireStringOption(value:
|
|
109
|
-
declare function mergeCreateOptionsWithTemplate(templateOptions:
|
|
110
|
-
declare function normalizeExtensionCommandPath(command:
|
|
111
|
-
declare function hasTemplatesShowHandler():
|
|
112
|
-
declare function readTemplateOptionsFromRuntimeResult(result:
|
|
113
|
-
declare function loadCreateTemplateOptionsFromRuntime(templateName:
|
|
108
|
+
export declare function requireStringOption(value:string | undefined,flag:string):string;
|
|
109
|
+
declare function mergeCreateOptionsWithTemplate(templateOptions:Record<string,unknown>,explicitOptions:CreateCommandOptions):CreateCommandOptions;
|
|
110
|
+
declare function normalizeExtensionCommandPath(command:string):string;
|
|
111
|
+
declare function hasTemplatesShowHandler():boolean;
|
|
112
|
+
declare function readTemplateOptionsFromRuntimeResult(result:unknown,templateName:string):Record<string,string | string[] | number | boolean>;
|
|
113
|
+
declare function loadCreateTemplateOptionsFromRuntime(templateName:string,global:GlobalOptions,pmRoot:string):Promise<Record<string,string | string[] | number | boolean>>;
|
|
114
114
|
/** Implements run create for the public runtime surface of this module. */
|
|
115
|
-
export declare function runCreate(options:
|
|
115
|
+
export declare function runCreate(options:CreateCommandOptions,global:GlobalOptions):Promise<CreateResult>;
|
|
116
116
|
/** Public contract for test only create command, shared by SDK and presentation-layer consumers. */
|
|
117
|
-
export declare const _testOnlyCreateCommand:
|
|
118
|
-
buildHistoryMessage:
|
|
119
|
-
buildInvalidLogSeedKeysMessage:
|
|
120
|
-
buildTypeSpecificCreateExample:
|
|
121
|
-
collectMissingRequiredTypeOptionKeys:
|
|
122
|
-
createExampleTokensForFlag:
|
|
123
|
-
filterNonMissingTypeOptionErrors:
|
|
124
|
-
hasTemplatesShowHandler:
|
|
125
|
-
hasCreateOptionValue:
|
|
126
|
-
loadCreateTemplateOptionsFromRuntime:
|
|
127
|
-
looksLikeStructuredEntry:
|
|
128
|
-
mergeCreateOptionsWithTemplate:
|
|
129
|
-
normalizeCreatePolicyOptionKey:
|
|
130
|
-
normalizeDependencyKindInput:
|
|
131
|
-
parseDependencies:
|
|
132
|
-
normalizeExtensionCommandPath:
|
|
133
|
-
parseCreateUnsetTargets:
|
|
134
|
-
requireStringOption:
|
|
135
|
-
readTemplateOptionsFromRuntimeResult:
|
|
136
|
-
resolveRuntimeCreateUnsetDefinition:
|
|
137
|
-
typeOptionExampleValue:
|
|
117
|
+
export declare const _testOnlyCreateCommand:{
|
|
118
|
+
buildHistoryMessage:typeof buildHistoryMessage;
|
|
119
|
+
buildInvalidLogSeedKeysMessage:typeof buildInvalidLogSeedKeysMessage;
|
|
120
|
+
buildTypeSpecificCreateExample:typeof buildTypeSpecificCreateExample;
|
|
121
|
+
collectMissingRequiredTypeOptionKeys:typeof collectMissingRequiredTypeOptionKeys;
|
|
122
|
+
createExampleTokensForFlag:typeof createExampleTokensForFlag;
|
|
123
|
+
filterNonMissingTypeOptionErrors:typeof filterNonMissingTypeOptionErrors;
|
|
124
|
+
hasTemplatesShowHandler:typeof hasTemplatesShowHandler;
|
|
125
|
+
hasCreateOptionValue:typeof hasCreateOptionValue;
|
|
126
|
+
loadCreateTemplateOptionsFromRuntime:typeof loadCreateTemplateOptionsFromRuntime;
|
|
127
|
+
looksLikeStructuredEntry:typeof looksLikeStructuredEntry;
|
|
128
|
+
mergeCreateOptionsWithTemplate:typeof mergeCreateOptionsWithTemplate;
|
|
129
|
+
normalizeCreatePolicyOptionKey:typeof normalizeCreatePolicyOptionKey;
|
|
130
|
+
normalizeDependencyKindInput:typeof normalizeDependencyKindInput;
|
|
131
|
+
parseDependencies:typeof parseDependencies;
|
|
132
|
+
normalizeExtensionCommandPath:typeof normalizeExtensionCommandPath;
|
|
133
|
+
parseCreateUnsetTargets:typeof parseCreateUnsetTargets;
|
|
134
|
+
requireStringOption:typeof requireStringOption;
|
|
135
|
+
readTemplateOptionsFromRuntimeResult:typeof readTemplateOptionsFromRuntimeResult;
|
|
136
|
+
resolveRuntimeCreateUnsetDefinition:(token:string,registry:RuntimeFieldRegistry | undefined) => import("./shared-unset-fields.js").RuntimeUnsetFieldDefinition | undefined;
|
|
137
|
+
typeOptionExampleValue:typeof typeOptionExampleValue;
|
|
138
138
|
};
|
|
139
139
|
export {};
|
|
@@ -2,36 +2,36 @@ import { type GlobalOptions } from "../runtime-primitives.js";
|
|
|
2
2
|
/** Documents the delete command options payload exchanged by command, SDK, and package integrations. */
|
|
3
3
|
export interface DeleteCommandOptions {
|
|
4
4
|
/** Value that configures or reports author for this contract. */
|
|
5
|
-
author?:
|
|
5
|
+
author?:string;
|
|
6
6
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
7
|
-
message?:
|
|
7
|
+
message?:string;
|
|
8
8
|
/** Value that configures or reports force for this contract. */
|
|
9
|
-
force?:
|
|
9
|
+
force?:boolean;
|
|
10
10
|
/** Value that configures or reports dry run for this contract. */
|
|
11
|
-
dryRun?:
|
|
11
|
+
dryRun?:boolean;
|
|
12
12
|
}
|
|
13
13
|
/** Documents the delete result payload exchanged by command, SDK, and package integrations. */
|
|
14
14
|
export interface DeleteResult {
|
|
15
15
|
/** Value that configures or reports item for this contract. */
|
|
16
|
-
item:
|
|
16
|
+
item:Record<string,unknown>;
|
|
17
17
|
/** Value that configures or reports changed fields for this contract. */
|
|
18
|
-
changed_fields:
|
|
18
|
+
changed_fields:string[];
|
|
19
19
|
/** Value that configures or reports dry run for this contract. */
|
|
20
|
-
dry_run:
|
|
20
|
+
dry_run:boolean;
|
|
21
21
|
/** Whether the item was deleted by this invocation. */
|
|
22
|
-
deleted:
|
|
22
|
+
deleted:boolean;
|
|
23
23
|
/** Stable mutation outcome used instead of echoing the item's stale lifecycle status. */
|
|
24
|
-
outcome:
|
|
24
|
+
outcome:"deleted" | "would_delete";
|
|
25
25
|
/** Lifecycle status the item had immediately before deletion. */
|
|
26
|
-
previous_status:
|
|
26
|
+
previous_status:string;
|
|
27
27
|
/** Filesystem path used for target resolution. */
|
|
28
|
-
target_path?:
|
|
28
|
+
target_path?:string;
|
|
29
29
|
/** Retained append-only audit stream for the deleted item. */
|
|
30
|
-
history_retained:
|
|
30
|
+
history_retained:string;
|
|
31
31
|
/** Explicit retention contract; tombstone GC is never implicit. */
|
|
32
|
-
tombstone_retention:
|
|
32
|
+
tombstone_retention:"retain_append_only";
|
|
33
33
|
/** Value that configures or reports warnings for this contract. */
|
|
34
|
-
warnings:
|
|
34
|
+
warnings:string[];
|
|
35
35
|
}
|
|
36
36
|
/** Implements run delete for the public runtime surface of this module. */
|
|
37
|
-
export declare function runDelete(id:
|
|
37
|
+
export declare function runDelete(id:string,options:DeleteCommandOptions,global:GlobalOptions):Promise<DeleteResult>;
|
|
@@ -3,4 +3,4 @@ export declare const EVENT_END_AFTER_START_MESSAGE = "--event end must be strict
|
|
|
3
3
|
/** Public contract for event end duration mutually exclusive message, shared by SDK and presentation-layer consumers. */
|
|
4
4
|
export declare const EVENT_END_DURATION_MUTUALLY_EXCLUSIVE_MESSAGE = "--event end and duration are mutually exclusive; provide only one (use duration=<relative> like duration=2h, duration=30min, or duration=PT30M, or set an explicit end).";
|
|
5
5
|
/** Resolve an explicit end or unambiguous duration; reject backwards spans and collapse zero-length events. */
|
|
6
|
-
export declare function resolveEventEndAt(startAt:
|
|
6
|
+
export declare function resolveEventEndAt(startAt:string,endRaw:string | undefined,durationRaw:string | undefined,referenceDate:Date):string | undefined;
|
|
@@ -2,18 +2,18 @@ import { type GlobalOptions } from "../runtime-primitives.js";
|
|
|
2
2
|
/** Documents the focus options payload exchanged by command, SDK, and package integrations. */
|
|
3
3
|
export interface FocusOptions {
|
|
4
4
|
/** Value that configures or reports clear for this contract. */
|
|
5
|
-
clear?:
|
|
5
|
+
clear?:boolean;
|
|
6
6
|
}
|
|
7
7
|
/** Documents the focus result payload exchanged by command, SDK, and package integrations. */
|
|
8
8
|
export interface FocusResult {
|
|
9
9
|
/** Value that configures or reports action for this contract. */
|
|
10
|
-
action:
|
|
10
|
+
action:"set" | "clear" | "show";
|
|
11
11
|
/** Value that configures or reports focused item for this contract. */
|
|
12
|
-
focused_item:
|
|
12
|
+
focused_item:string | null;
|
|
13
13
|
/** Value that configures or reports title for this contract. */
|
|
14
|
-
title:
|
|
14
|
+
title:string | null;
|
|
15
15
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
16
|
-
message:
|
|
16
|
+
message:string;
|
|
17
17
|
}
|
|
18
18
|
/** Implements run focus for the public runtime surface of this module. */
|
|
19
|
-
export declare function runFocus(id:
|
|
19
|
+
export declare function runFocus(id:string | undefined,options:FocusOptions,global:GlobalOptions):Promise<FocusResult>;
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
/** Inputs for the internal workspace-wide hierarchy mutation lock. */
|
|
2
2
|
export interface HierarchyMutationLockOptions {
|
|
3
3
|
/** Tracker root whose hierarchy is being changed. */
|
|
4
|
-
pmRoot:
|
|
4
|
+
pmRoot:string;
|
|
5
5
|
/** Principal recorded as the lock owner. */
|
|
6
|
-
author:
|
|
6
|
+
author:string;
|
|
7
7
|
/** Tracker-configured stale-lock lifetime. */
|
|
8
|
-
ttlSeconds:
|
|
8
|
+
ttlSeconds:number;
|
|
9
9
|
/** Tracker-configured bounded lock wait. */
|
|
10
|
-
waitMs:
|
|
10
|
+
waitMs:number;
|
|
11
11
|
/** Whether this mutation can add hierarchy evidence or a one-edge relationship. */
|
|
12
|
-
required:
|
|
12
|
+
required:boolean;
|
|
13
13
|
}
|
|
14
14
|
/** Acquire the shared hierarchy writer lock, or return a no-op release. */
|
|
15
|
-
export declare function acquireHierarchyMutationLock(options:
|
|
15
|
+
export declare function acquireHierarchyMutationLock(options:HierarchyMutationLockOptions):Promise<() => Promise<void>>;
|
|
@@ -1,71 +1,71 @@
|
|
|
1
1
|
/** Describes a repeatable option whose legacy none/null token maps to a clear flag. */
|
|
2
2
|
export interface LegacyNoneCollectionNormalizer<TOptions extends object> {
|
|
3
3
|
/** Value that configures or reports option key for this contract. */
|
|
4
|
-
optionKey:
|
|
4
|
+
optionKey:keyof TOptions;
|
|
5
5
|
/** Value that configures or reports clear flag key for this contract. */
|
|
6
|
-
clearFlagKey:
|
|
6
|
+
clearFlagKey:keyof TOptions;
|
|
7
7
|
/** Value that configures or reports value flag for this contract. */
|
|
8
|
-
valueFlag:
|
|
8
|
+
valueFlag:string;
|
|
9
9
|
/** Value that configures or reports clear flag for this contract. */
|
|
10
|
-
clearFlag:
|
|
10
|
+
clearFlag:string;
|
|
11
11
|
/** Value that configures or reports disable flag key for this contract. */
|
|
12
|
-
disableFlagKey?:
|
|
12
|
+
disableFlagKey?:keyof TOptions;
|
|
13
13
|
}
|
|
14
14
|
/** Collection and clear options shared by create and update legacy-token normalization. */
|
|
15
15
|
export interface LegacyNoneCollectionOptions {
|
|
16
16
|
/** Dependency entries accepted by create and update. */
|
|
17
|
-
dep?:
|
|
17
|
+
dep?:string[];
|
|
18
18
|
/** Whether dependency entries should be cleared. */
|
|
19
|
-
clearDeps?:
|
|
19
|
+
clearDeps?:boolean;
|
|
20
20
|
/** Comment entries accepted by create and update. */
|
|
21
|
-
comment?:
|
|
21
|
+
comment?:string[];
|
|
22
22
|
/** Whether comment entries should be cleared. */
|
|
23
|
-
clearComments?:
|
|
23
|
+
clearComments?:boolean;
|
|
24
24
|
/** Note entries accepted by create and update. */
|
|
25
|
-
note?:
|
|
25
|
+
note?:string[];
|
|
26
26
|
/** Whether note entries should be cleared. */
|
|
27
|
-
clearNotes?:
|
|
27
|
+
clearNotes?:boolean;
|
|
28
28
|
/** Learning entries accepted by create and update. */
|
|
29
|
-
learning?:
|
|
29
|
+
learning?:string[];
|
|
30
30
|
/** Whether learning entries should be cleared. */
|
|
31
|
-
clearLearnings?:
|
|
31
|
+
clearLearnings?:boolean;
|
|
32
32
|
/** Linked-file entries accepted by create and update. */
|
|
33
|
-
file?:
|
|
33
|
+
file?:string[];
|
|
34
34
|
/** Whether linked-file entries should be cleared. */
|
|
35
|
-
clearFiles?:
|
|
35
|
+
clearFiles?:boolean;
|
|
36
36
|
/** Linked-test entries accepted by create and update. */
|
|
37
|
-
test?:
|
|
37
|
+
test?:string[];
|
|
38
38
|
/** Whether linked-test entries should be cleared. */
|
|
39
|
-
clearTests?:
|
|
39
|
+
clearTests?:boolean;
|
|
40
40
|
/** Linked-document entries accepted by create and update. */
|
|
41
|
-
doc?:
|
|
41
|
+
doc?:string[];
|
|
42
42
|
/** Whether linked-document entries should be cleared. */
|
|
43
|
-
clearDocs?:
|
|
43
|
+
clearDocs?:boolean;
|
|
44
44
|
/** Reminder entries accepted by create and update. */
|
|
45
|
-
reminder?:
|
|
45
|
+
reminder?:string[];
|
|
46
46
|
/** Whether reminder entries should be cleared. */
|
|
47
|
-
clearReminders?:
|
|
47
|
+
clearReminders?:boolean;
|
|
48
48
|
/** Event entries accepted by create and update. */
|
|
49
|
-
event?:
|
|
49
|
+
event?:string[];
|
|
50
50
|
/** Whether event entries should be cleared. */
|
|
51
|
-
clearEvents?:
|
|
51
|
+
clearEvents?:boolean;
|
|
52
52
|
/** Custom type-option entries accepted by create and update. */
|
|
53
|
-
typeOption?:
|
|
53
|
+
typeOption?:string[];
|
|
54
54
|
/** Whether custom type-option entries should be cleared. */
|
|
55
|
-
clearTypeOptions?:
|
|
55
|
+
clearTypeOptions?:boolean;
|
|
56
56
|
}
|
|
57
57
|
/** Build the shared create/update collection normalizer table with optional replacement-mode guards. */
|
|
58
|
-
export declare function createLegacyNoneCollectionNormalizers<TOptions extends LegacyNoneCollectionOptions>(options?:
|
|
59
|
-
depDisableFlagKey?:
|
|
60
|
-
fileDisableFlagKey?:
|
|
61
|
-
testDisableFlagKey?:
|
|
62
|
-
docDisableFlagKey?:
|
|
63
|
-
}):
|
|
58
|
+
export declare function createLegacyNoneCollectionNormalizers<TOptions extends LegacyNoneCollectionOptions>(options?:{
|
|
59
|
+
depDisableFlagKey?:keyof TOptions;
|
|
60
|
+
fileDisableFlagKey?:keyof TOptions;
|
|
61
|
+
testDisableFlagKey?:keyof TOptions;
|
|
62
|
+
docDisableFlagKey?:keyof TOptions;
|
|
63
|
+
}):ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>>;
|
|
64
64
|
/** Implements check whether legacy none token for the public runtime surface of this module. */
|
|
65
|
-
export declare function isLegacyNoneToken(value:
|
|
65
|
+
export declare function isLegacyNoneToken(value:string | undefined):boolean;
|
|
66
66
|
/** Implements assert no legacy none token for the public runtime surface of this module. */
|
|
67
|
-
export declare function assertNoLegacyNoneToken(value:
|
|
67
|
+
export declare function assertNoLegacyNoneToken(value:string | undefined,flag:string,replacementHint?:string):void;
|
|
68
68
|
/** Implements assert no legacy none tokens for the public runtime surface of this module. */
|
|
69
|
-
export declare function assertNoLegacyNoneTokens(values:
|
|
69
|
+
export declare function assertNoLegacyNoneTokens(values:string[] | undefined,flag:string,replacementHint?:string):void;
|
|
70
70
|
/** Convert collection-level legacy none/null tokens into their explicit clear flags. */
|
|
71
|
-
export declare function applyLegacyNoneCollectionNormalizers<TOptions extends Record<string,
|
|
71
|
+
export declare function applyLegacyNoneCollectionNormalizers<TOptions extends Record<string,unknown>>(normalized:TOptions,definitions:ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>>):TOptions;
|
|
@@ -7,9 +7,9 @@ import { type RuntimeStatusRegistry } from "../runtime-primitives.js";
|
|
|
7
7
|
/** GH-216: a contextual next-step hint that nudges agents toward the underutilized `in_progress` lifecycle state instead of jumping straight from `open` to `closed`. The suggestion is intentionally non-binding (no governance enforcement) and only surfaces when a richer transition genuinely exists. */
|
|
8
8
|
export interface LifecycleTransitionSuggestion {
|
|
9
9
|
/** Ready-to-run command that advances the item to the suggested status. */
|
|
10
|
-
command:
|
|
10
|
+
command:string;
|
|
11
11
|
/** The status the suggested command moves the item to. */
|
|
12
|
-
to_status:
|
|
12
|
+
to_status:string;
|
|
13
13
|
}
|
|
14
14
|
/**
|
|
15
15
|
* Suggest the next lifecycle transition for a freshly created (or open) item.
|
|
@@ -20,4 +20,4 @@ to_status: string;
|
|
|
20
20
|
* scheduling types and workflows that collapse `in_progress` into `open` — so
|
|
21
21
|
* the suggestion never fabricates a transition the workflow cannot perform.
|
|
22
22
|
*/
|
|
23
|
-
export declare function suggestNextLifecycleTransition(id:
|
|
23
|
+
export declare function suggestNextLifecycleTransition(id:string,type:string,status:string,statusRegistry:RuntimeStatusRegistry):LifecycleTransitionSuggestion | undefined;
|
|
@@ -2,23 +2,23 @@ import type { GlobalOptions } from "../../core/shared/command-types.js";
|
|
|
2
2
|
/** Minimal generic dispatch context consumed by lifecycle mutation adapters. */
|
|
3
3
|
export interface LifecycleMutationActionContext {
|
|
4
4
|
/** Flat MCP/action arguments. */
|
|
5
|
-
args:
|
|
5
|
+
args:Record<string,unknown>;
|
|
6
6
|
/** Normalized command option bag. */
|
|
7
|
-
options:
|
|
7
|
+
options:Record<string,unknown>;
|
|
8
8
|
/** Item id resolved from flat arguments, when present. */
|
|
9
|
-
id:
|
|
9
|
+
id:string | undefined;
|
|
10
10
|
/** Normalized transport-level force override. */
|
|
11
|
-
force?:
|
|
11
|
+
force?:boolean;
|
|
12
12
|
/** Presentation-neutral global command options. */
|
|
13
|
-
global:
|
|
13
|
+
global:GlobalOptions;
|
|
14
14
|
}
|
|
15
15
|
/** Dispatch explicit and ranked claims through the same compact receipt contract. */
|
|
16
|
-
export declare function runMcpClaimAction(context:
|
|
16
|
+
export declare function runMcpClaimAction(context:LifecycleMutationActionContext):Promise<unknown>;
|
|
17
17
|
/** Dispatch close through the shared MCP mutation compaction contract. */
|
|
18
|
-
export declare function runMcpCloseAction(context:
|
|
18
|
+
export declare function runMcpCloseAction(context:LifecycleMutationActionContext):Promise<unknown>;
|
|
19
19
|
/** Apply one shared transport projection to canonical and legacy lifecycle compositions. */
|
|
20
|
-
export declare function runMcpTaskCompositionAction(context:
|
|
20
|
+
export declare function runMcpTaskCompositionAction(context:LifecycleMutationActionContext,action:"start_task" | "pause_task" | "close_task"):Promise<unknown>;
|
|
21
21
|
/** Release ownership with the same compact/full controls used by claiming and pausing. */
|
|
22
|
-
export declare function runMcpReleaseAction(context:
|
|
22
|
+
export declare function runMcpReleaseAction(context:LifecycleMutationActionContext):Promise<unknown>;
|
|
23
23
|
/** Dispatch recurrence through the shared MCP mutation compaction contract. */
|
|
24
|
-
export declare function runMcpReopenAction(context:
|
|
24
|
+
export declare function runMcpReopenAction(context:LifecycleMutationActionContext):Promise<unknown>;
|
|
@@ -1,2 +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]="
|
|
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]="04780b9d-76a4-544a-9341-7aa56c1e451b")}catch{}})();import{projectMutationResult}from"../../core/output/mutation-projection.js";import{PmCliError}from"../../core/shared/errors.js";import{runClose}from"./close.js";import{runReopen}from"./reopen.js";import{runClaim,runClaimNext,runRelease}from"./claim.js";import{runStartTask,runPauseTask,runCloseTask}from"./task-composition.js";import{readRuntimeString,withMutationCompaction,mutationOptionsWithOverrides}from"../runtime-input.js";async function runMcpClaimAction(context){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(context.args,context.options),force=context.force===!0||runnerOptions.force===!0,selectionOptions={...context.args,...runnerOptions};if(selectionOptions.start===!0)return runMcpTaskCompositionAction(context,"start_task");const result=context.args.next===!0||runnerOptions.next===!0?await runClaimNext(force,context.global,selectionOptions,selectionOptions):await runClaim(requireLifecycleItemId(context,runnerOptions),force,context.global,selectionOptions);return projectMutationResult(result,{changedFields,compactEnvelope:changedFields==="compact"&&!idOnly,idOnly})}function requireLifecycleItemId(context,options){const id=context.id??readRuntimeString(options,"id");if(!id)throw new PmCliError("Missing required argument: id",64);return id}function readLifecycleReason(context,options){return readRuntimeString(context.args,"reason")??readRuntimeString(context.args,"text")??readRuntimeString(options,"reason")??readRuntimeString(options,"text")}async function runMcpCloseAction(context){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(context.args,context.options);return runnerOptions.releaseAssignment===!0?runMcpTaskCompositionAction(context,"close_task"):projectMutationResult(await runClose(requireLifecycleItemId(context,runnerOptions),readLifecycleReason(context,runnerOptions),{...runnerOptions,force:context.force===!0||runnerOptions.force===!0},context.global),{changedFields,compactEnvelope:changedFields==="compact"&&!idOnly,idOnly})}async function runMcpTaskCompositionAction(context,action){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(context.args,context.options),id=requireLifecycleItemId(context,runnerOptions),options=mutationOptionsWithOverrides(runnerOptions,{force:context.force===!0||runnerOptions.force===!0}),result=action==="start_task"?await runStartTask(id,options,context.global):action==="pause_task"?await runPauseTask(id,options,context.global):await runCloseTask(id,readLifecycleReason(context,runnerOptions),options,context.global);return projectMutationResult(result,{changedFields,idOnly,compactEnvelope:changedFields==="compact"&&!idOnly})}async function runMcpReleaseAction(context){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(context.args,context.options),options=mutationOptionsWithOverrides(runnerOptions,{message:readRuntimeString(Object.hasOwn(runnerOptions,"message")?runnerOptions:context.args,"message")});if(options.pause===!0)return runMcpTaskCompositionAction({...context,options},"pause_task");const result=await runRelease(requireLifecycleItemId(context,options),context.force===!0||options.force===!0,context.global,options);return projectMutationResult(result,{changedFields,idOnly,compactEnvelope:changedFields==="compact"&&!idOnly})}async function runMcpReopenAction(context){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(context.args,context.options);return projectMutationResult(await runReopen(requireLifecycleItemId(context,runnerOptions),readLifecycleReason(context,runnerOptions)??"",{...runnerOptions,force:context.force===!0||runnerOptions.force===!0},context.global),{changedFields,compactEnvelope:changedFields==="compact"&&!idOnly,idOnly})}export{runMcpClaimAction,runMcpCloseAction,runMcpReleaseAction,runMcpReopenAction,runMcpTaskCompositionAction};
|
|
2
2
|
//# sourceMappingURL=mcp-actions.js.map
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/** Implements normalize risk input for the public runtime surface of this module. */
|
|
2
|
-
export declare function normalizeRiskInput(value:
|
|
2
|
+
export declare function normalizeRiskInput(value:string):string;
|
|
3
3
|
/** Implements normalize severity input for the public runtime surface of this module. */
|
|
4
|
-
export declare function normalizeSeverityInput(value:
|
|
4
|
+
export declare function normalizeSeverityInput(value:string):string;
|
|
5
5
|
/** Implements parse confidence input for the public runtime surface of this module. */
|
|
6
|
-
export declare function parseConfidenceInput(value:
|
|
6
|
+
export declare function parseConfidenceInput(value:string):number | "low" | "medium" | "high";
|
|
7
7
|
/** Implements parse regression input for the public runtime surface of this module. */
|
|
8
|
-
export declare function parseRegressionInput(value:
|
|
8
|
+
export declare function parseRegressionInput(value:string):boolean;
|