@unbrained/pm-cli 2026.10.14 → 2026.10.15
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/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +54 -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 +16 -16
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +2 -2
- 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-operations.d.ts +75 -75
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -8
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- 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-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
- package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
- package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
- package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
- package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
- package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
- package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
- package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
- package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
- package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
- package/dist/cli-bundle/main.js +26 -26
- 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 +22 -22
- 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 +51 -51
- 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 +702 -702
- package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
- package/dist/core/extensions/flag-value-types.d.ts +16 -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-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-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 -4
- 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 +14 -14
- 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 +3 -3
- 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-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/tool-definitions.d.ts +27 -27
- 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/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/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
- 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/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-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 +8 -8
- 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-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.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 +69 -69
- 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 +73 -73
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +38 -38
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -18
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- 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/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/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/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/task-composition.d.ts +7 -7
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +120 -120
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +31 -31
- 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-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-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/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 +13 -13
- 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.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/COMMANDS.md +11 -2
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/RELEASING.md +2 -0
- package/docs/TESTING.md +21 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
- package/marketplace.json +1 -1
- package/package.json +3 -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-UNQZGMJL.js +0 -20
- package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
|
@@ -1,180 +1,180 @@
|
|
|
1
|
-
import { type AgentEpisodeIdentity,
|
|
1
|
+
import { type AgentEpisodeIdentity,type AgentSessionContext } from "./agent-session-context.js";
|
|
2
2
|
/** Stable provenance categories recorded beside newly appended history authors. */
|
|
3
3
|
export type AuthorSource = "asserted" | "configured" | "detected" | "unknown";
|
|
4
4
|
/** Stable source categories for model observations recorded in mutation history. */
|
|
5
5
|
export type AgentModelSource = "override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
|
|
6
6
|
/** Stable built-in provenance dimensions understood by the default runtime. */
|
|
7
|
-
export declare const AGENT_PROVENANCE_DIMENSIONS:
|
|
7
|
+
export declare const AGENT_PROVENANCE_DIMENSIONS:readonly ["model","effort","role","topic","version"];
|
|
8
8
|
/** Built-in, bounded local resolver names accepted by harness descriptors. */
|
|
9
9
|
export type AgentProvenanceResolver = "ai_agent_version" | "claude_session_file" | "codex_session_file";
|
|
10
10
|
/** One bounded provenance value and the signal class that supplied it. */
|
|
11
11
|
export interface AgentProvenanceObservation {
|
|
12
12
|
/** Bounded descriptive value retained in local history. */
|
|
13
|
-
value:
|
|
13
|
+
value:string;
|
|
14
14
|
/** Signal class that supplied the value. */
|
|
15
|
-
source:
|
|
15
|
+
source:AgentModelSource;
|
|
16
16
|
/** Confidence attached to a semantic inference. */
|
|
17
|
-
confidence?:
|
|
17
|
+
confidence?:"high" | "medium" | "low";
|
|
18
18
|
/** Versioned inference rule when the value was derived. */
|
|
19
|
-
rule_version?:
|
|
19
|
+
rule_version?:"v2";
|
|
20
20
|
/** Bounded item and lineage references supporting an inference. */
|
|
21
|
-
evidence?:
|
|
21
|
+
evidence?:readonly string[];
|
|
22
22
|
}
|
|
23
23
|
/**
|
|
24
24
|
* Extensible provenance dimensions. A null value explicitly means that the
|
|
25
25
|
* selected harness declared the dimension but exposed no value this run.
|
|
26
26
|
*/
|
|
27
|
-
export type AgentProvenance = Readonly<Record<string,
|
|
27
|
+
export type AgentProvenance = Readonly<Record<string,AgentProvenanceObservation | null>>;
|
|
28
28
|
/** Bounded reason explaining why one declared provenance dimension was absent. */
|
|
29
29
|
export type AgentProvenanceAbsenceReason = "harness_unavailable" | "resolver_input_missing" | "resolver_failed" | "resolver_not_configured" | "probes_disabled" | "invalid_value";
|
|
30
30
|
/** Machine-readable resolution outcome for one provenance dimension. */
|
|
31
31
|
export interface AgentProvenanceOutcome {
|
|
32
32
|
/** Whether the dimension resolved without retaining private source material. */
|
|
33
|
-
status:
|
|
33
|
+
status:"resolved" | "unavailable" | "not_configured" | "failed";
|
|
34
34
|
/** Stable bounded reason for absent or rejected values. */
|
|
35
|
-
reason?:
|
|
35
|
+
reason?:AgentProvenanceAbsenceReason;
|
|
36
36
|
/** Resolver name when a bounded local resolver was attempted. */
|
|
37
|
-
resolver?:
|
|
37
|
+
resolver?:AgentProvenanceResolver;
|
|
38
38
|
/** Stable inference contract version used by downstream analytics. */
|
|
39
|
-
rule_version:
|
|
39
|
+
rule_version:"v1";
|
|
40
40
|
}
|
|
41
41
|
/** Privacy-bounded MCP client metadata that can participate in agent detection. */
|
|
42
42
|
export interface AgentClientInfo {
|
|
43
43
|
/** Client or harness name reported during protocol initialization. */
|
|
44
|
-
name:
|
|
44
|
+
name:string;
|
|
45
45
|
/** Optional client version retained only as an input signal. */
|
|
46
|
-
version?:
|
|
46
|
+
version?:string;
|
|
47
47
|
/** Optional model identifier reported by a trusted embedding host. */
|
|
48
|
-
model?:
|
|
48
|
+
model?:string;
|
|
49
49
|
/** Optional invocation/session identifier reported by an embedding host. */
|
|
50
|
-
session?:
|
|
50
|
+
session?:string;
|
|
51
51
|
/** Optional descriptive provenance supplied by an embedding host. */
|
|
52
|
-
provenance?:
|
|
52
|
+
provenance?:Readonly<Record<string,string | undefined>>;
|
|
53
53
|
/** Optional episode declaration supplied by an embedding host. */
|
|
54
|
-
episode?:
|
|
54
|
+
episode?:AgentEpisodeIdentity;
|
|
55
55
|
}
|
|
56
56
|
/** Declarative, side-effect-free signal definition for one agent harness. */
|
|
57
57
|
export interface HarnessSignalDescriptor {
|
|
58
58
|
/** Stable lowercase namespace written to provenance fields. */
|
|
59
|
-
harness:
|
|
59
|
+
harness:string;
|
|
60
60
|
/** Environment keys whose non-blank presence identifies the harness. */
|
|
61
|
-
environment_keys?:
|
|
61
|
+
environment_keys?:readonly string[];
|
|
62
62
|
/** Environment keys checked in order for a model identifier. */
|
|
63
|
-
model_environment_keys?:
|
|
63
|
+
model_environment_keys?:readonly string[];
|
|
64
64
|
/** Environment keys checked in order for an invocation/session identifier. */
|
|
65
|
-
session_environment_keys?:
|
|
65
|
+
session_environment_keys?:readonly string[];
|
|
66
66
|
/** Extensible provenance dimension to ordered environment-key mappings. */
|
|
67
|
-
provenance_environment_keys?:
|
|
67
|
+
provenance_environment_keys?:Readonly<Record<string,readonly string[] | undefined>>;
|
|
68
68
|
/** Provenance dimensions mapped to audited built-in local resolvers. */
|
|
69
|
-
provenance_resolvers?:
|
|
69
|
+
provenance_resolvers?:Readonly<Record<string,AgentProvenanceResolver | undefined>>;
|
|
70
70
|
/** Dimensions the harness is known not to expose through environment keys. */
|
|
71
|
-
provenance_unavailable_dimensions?:
|
|
71
|
+
provenance_unavailable_dimensions?:readonly string[];
|
|
72
72
|
/** Literal, case-insensitive executable or argument markers. */
|
|
73
|
-
argv_markers?:
|
|
73
|
+
argv_markers?:readonly string[];
|
|
74
74
|
/** Literal, case-insensitive MCP client-name markers. */
|
|
75
|
-
client_names?:
|
|
75
|
+
client_names?:readonly string[];
|
|
76
76
|
}
|
|
77
77
|
/** Versioned package-replaceable provenance contract for one agent harness. */
|
|
78
78
|
export interface AgentProvenanceAdapter {
|
|
79
79
|
/** Public adapter contract revision. */
|
|
80
|
-
contract_version:
|
|
80
|
+
contract_version:1;
|
|
81
81
|
/** Adapter implementation revision supplied by pm or a package. */
|
|
82
|
-
adapter_version:
|
|
82
|
+
adapter_version:string;
|
|
83
83
|
/** Explicit replacement precedence; built-ins use zero. */
|
|
84
|
-
priority:
|
|
84
|
+
priority:number;
|
|
85
85
|
/** Stable lowercase harness namespace. */
|
|
86
|
-
harness:
|
|
86
|
+
harness:string;
|
|
87
87
|
/** Executable detection and provenance descriptor. */
|
|
88
|
-
descriptor:
|
|
88
|
+
descriptor:HarnessSignalDescriptor;
|
|
89
89
|
/** Provenance dimensions intentionally covered by the adapter. */
|
|
90
|
-
supported_dimensions:
|
|
90
|
+
supported_dimensions:readonly string[];
|
|
91
91
|
/** Privacy classes the adapter may inspect. */
|
|
92
|
-
native_sources:
|
|
92
|
+
native_sources:readonly ("environment" | "argv" | "mcp_client" | "session_file")[];
|
|
93
93
|
/** Hard bounds shared by runtime probes and package review. */
|
|
94
|
-
probe_policy:
|
|
95
|
-
max_bytes:
|
|
96
|
-
max_lines:
|
|
97
|
-
network_access:
|
|
98
|
-
subprocess_access:
|
|
94
|
+
probe_policy:{
|
|
95
|
+
max_bytes:number;
|
|
96
|
+
max_lines:number;
|
|
97
|
+
network_access:false;
|
|
98
|
+
subprocess_access:false;
|
|
99
99
|
};
|
|
100
100
|
/** Stable normalization vocabulary declarations. */
|
|
101
|
-
normalization:
|
|
102
|
-
model_family:
|
|
103
|
-
effort:
|
|
104
|
-
preserve_raw:
|
|
101
|
+
normalization:{
|
|
102
|
+
model_family:"v1";
|
|
103
|
+
effort:"v1";
|
|
104
|
+
preserve_raw:true;
|
|
105
105
|
};
|
|
106
106
|
/** Confidence of a value read directly from the declared sources. */
|
|
107
|
-
confidence:
|
|
107
|
+
confidence:"high" | "medium" | "low";
|
|
108
108
|
/** Bounded reasons for intentionally uncovered dimensions. */
|
|
109
|
-
waivers?:
|
|
109
|
+
waivers?:Readonly<Record<string,string>>;
|
|
110
110
|
}
|
|
111
111
|
/** One raw and normalized adapter value with its stable vocabulary revision. */
|
|
112
112
|
export interface NormalizedAgentProvenanceAdapterValue {
|
|
113
113
|
/** Bounded value retained exactly as observed. */
|
|
114
|
-
raw:
|
|
114
|
+
raw:string;
|
|
115
115
|
/** Stable cross-harness family or vocabulary value. */
|
|
116
|
-
normalized:
|
|
116
|
+
normalized:string;
|
|
117
117
|
/** Normalization vocabulary revision. */
|
|
118
|
-
vocabulary:
|
|
118
|
+
vocabulary:"v1";
|
|
119
119
|
}
|
|
120
120
|
/** Public, privacy-safe agent observation shared by CLI, SDK, and MCP hosts. */
|
|
121
121
|
export interface DetectedAgentIdentity {
|
|
122
122
|
/** Normalized harness namespace when automatic detection succeeded. */
|
|
123
|
-
harness?:
|
|
123
|
+
harness?:string;
|
|
124
124
|
/** Model identifier observed from a bounded runtime signal. */
|
|
125
|
-
model?:
|
|
125
|
+
model?:string;
|
|
126
126
|
/** Signal class that supplied `model`. */
|
|
127
|
-
model_source?:
|
|
127
|
+
model_source?:AgentModelSource;
|
|
128
128
|
/** Transient invocation/session identifier available only to the current host. */
|
|
129
|
-
session?:
|
|
129
|
+
session?:string;
|
|
130
130
|
/** Privacy-safe stable fingerprint for the current harness invocation. */
|
|
131
|
-
instance?:
|
|
131
|
+
instance?:string;
|
|
132
132
|
/** Extensible local-only descriptive provenance observations. */
|
|
133
|
-
provenance?:
|
|
133
|
+
provenance?:AgentProvenance;
|
|
134
134
|
/** Stable declared episode identity when the session supplied one. */
|
|
135
|
-
episode?:
|
|
135
|
+
episode?:AgentEpisodeIdentity;
|
|
136
136
|
}
|
|
137
137
|
/** Agent identity plus explicit outcomes for every built-in provenance dimension. */
|
|
138
138
|
export interface DiagnosedAgentIdentity extends DetectedAgentIdentity {
|
|
139
139
|
/** Resolution outcomes that distinguish absence from resolver failure. */
|
|
140
|
-
provenance_outcomes:
|
|
140
|
+
provenance_outcomes:Readonly<Record<string,AgentProvenanceOutcome>>;
|
|
141
141
|
}
|
|
142
142
|
/** Public, privacy-safe identity resolution result shared by CLI and SDK hosts. */
|
|
143
143
|
export interface ResolvedAuthorIdentity extends DetectedAgentIdentity {
|
|
144
144
|
/** Stable author value written to mutation history. */
|
|
145
|
-
author:
|
|
145
|
+
author:string;
|
|
146
146
|
/** How the effective author was selected. */
|
|
147
|
-
source:
|
|
147
|
+
source:AuthorSource;
|
|
148
148
|
}
|
|
149
149
|
/** Bounded runtime signals accepted by the pure harness detector. */
|
|
150
150
|
export interface HarnessDetectionSignals {
|
|
151
151
|
/** Environment names and values supplied by the embedding runtime. */
|
|
152
|
-
env?:
|
|
152
|
+
env?:Readonly<Record<string,string | undefined>>;
|
|
153
153
|
/** Executable and argument tokens for the current process. */
|
|
154
|
-
argv?:
|
|
154
|
+
argv?:readonly string[];
|
|
155
155
|
/** Optional parent-process labels supplied by a host that already knows them. */
|
|
156
|
-
process_labels?:
|
|
156
|
+
process_labels?:readonly string[];
|
|
157
157
|
/** Optional protocol client metadata supplied by an MCP or SDK host. */
|
|
158
|
-
client_info?:
|
|
158
|
+
client_info?:AgentClientInfo;
|
|
159
159
|
/** Invocation metadata supplied directly by an embedding host. */
|
|
160
|
-
provenance?:
|
|
160
|
+
provenance?:Readonly<Record<string,string | undefined>>;
|
|
161
161
|
/** Session-wide semantic context supplied by an embedding host. */
|
|
162
|
-
session_context?:
|
|
162
|
+
session_context?:AgentSessionContext;
|
|
163
163
|
/** Invocation-local descriptors appended after built-in and package signals. */
|
|
164
|
-
descriptors?:
|
|
164
|
+
descriptors?:readonly HarnessSignalDescriptor[];
|
|
165
165
|
/** Disable local provenance probes for this invocation. */
|
|
166
|
-
probes_enabled?:
|
|
166
|
+
probes_enabled?:boolean;
|
|
167
167
|
/** Working directory used to derive harness-owned session paths. */
|
|
168
|
-
cwd?:
|
|
168
|
+
cwd?:string;
|
|
169
169
|
/** Home directory override used by embedders and isolated tests. */
|
|
170
|
-
home_dir?:
|
|
170
|
+
home_dir?:string;
|
|
171
171
|
/** Explicit harness-owned session file supplied by an embedding host. */
|
|
172
|
-
session_file?:
|
|
172
|
+
session_file?:string;
|
|
173
173
|
}
|
|
174
174
|
/** Built-in agent descriptors evaluated before package and workspace additions. */
|
|
175
|
-
export declare const BUILTIN_HARNESS_SIGNAL_DESCRIPTORS:
|
|
175
|
+
export declare const BUILTIN_HARNESS_SIGNAL_DESCRIPTORS:readonly HarnessSignalDescriptor[];
|
|
176
176
|
/** Built-in versioned adapters for supported interactive agent harnesses. */
|
|
177
|
-
export declare const BUILTIN_AGENT_PROVENANCE_ADAPTERS:
|
|
177
|
+
export declare const BUILTIN_AGENT_PROVENANCE_ADAPTERS:readonly AgentProvenanceAdapter[];
|
|
178
178
|
/**
|
|
179
179
|
* Register package-provided harness signals until the returned disposer runs.
|
|
180
180
|
*
|
|
@@ -182,22 +182,22 @@ export declare const BUILTIN_AGENT_PROVENANCE_ADAPTERS: readonly AgentProvenance
|
|
|
182
182
|
* Re-registering an identical package descriptor is reference counted so
|
|
183
183
|
* repeated extension activation remains idempotent.
|
|
184
184
|
*/
|
|
185
|
-
export declare function registerHarnessSignalDescriptors(descriptors:
|
|
185
|
+
export declare function registerHarnessSignalDescriptors(descriptors:readonly HarnessSignalDescriptor[]):() => void;
|
|
186
186
|
/** Return the effective built-in or explicitly higher-priority package adapters. */
|
|
187
|
-
export declare function listAgentProvenanceAdapters():
|
|
187
|
+
export declare function listAgentProvenanceAdapters():readonly AgentProvenanceAdapter[];
|
|
188
188
|
/**
|
|
189
189
|
* Register package adapters until disposal. Replacing a built-in requires an
|
|
190
190
|
* explicitly greater priority; equal-priority ambiguity fails closed.
|
|
191
191
|
*/
|
|
192
|
-
export declare function registerAgentProvenanceAdapters(adapters:
|
|
192
|
+
export declare function registerAgentProvenanceAdapters(adapters:readonly AgentProvenanceAdapter[]):() => void;
|
|
193
193
|
/** Normalize model-family or effort vocabulary while retaining the raw value. */
|
|
194
|
-
export declare function normalizeAgentProvenanceAdapterValue(dimension:
|
|
194
|
+
export declare function normalizeAgentProvenanceAdapterValue(dimension:"model" | "effort",value:string):NormalizedAgentProvenanceAdapterValue;
|
|
195
195
|
/** Run one invocation with host-provided detection signals available downstream. */
|
|
196
|
-
export declare function runWithHarnessDetectionSignals<T>(signals:
|
|
196
|
+
export declare function runWithHarnessDetectionSignals<T>(signals:HarnessDetectionSignals,callback:() => T):T;
|
|
197
197
|
/** Run one invocation with workspace-provided descriptors available downstream. */
|
|
198
|
-
export declare function runWithWorkspaceHarnessSignalDescriptors<T>(descriptors:
|
|
199
|
-
probesEnabled?:
|
|
200
|
-
}):
|
|
198
|
+
export declare function runWithWorkspaceHarnessSignalDescriptors<T>(descriptors:readonly HarnessSignalDescriptor[],callback:() => T,options?:{
|
|
199
|
+
probesEnabled?:boolean;
|
|
200
|
+
}):T;
|
|
201
201
|
/**
|
|
202
202
|
* Detect structured agent provenance from bounded caller-supplied signals.
|
|
203
203
|
*
|
|
@@ -205,18 +205,18 @@ probesEnabled?: boolean;
|
|
|
205
205
|
* treated as literal strings; they never execute regexes, commands, filesystem
|
|
206
206
|
* traversal, or network requests.
|
|
207
207
|
*/
|
|
208
|
-
export declare function detectAgentIdentity(signals?:
|
|
208
|
+
export declare function detectAgentIdentity(signals?:HarnessDetectionSignals):DetectedAgentIdentity;
|
|
209
209
|
/**
|
|
210
210
|
* Diagnose provenance without exposing environment values, paths, or probe data.
|
|
211
211
|
*
|
|
212
212
|
* This additive SDK contract keeps legacy `detectAgentIdentity` projections
|
|
213
213
|
* stable while giving health checks and history writers explicit absence states.
|
|
214
214
|
*/
|
|
215
|
-
export declare function diagnoseAgentIdentity(signals?:
|
|
215
|
+
export declare function diagnoseAgentIdentity(signals?:HarnessDetectionSignals):DiagnosedAgentIdentity;
|
|
216
216
|
/** Reads the invocation-wide author override through the canonical environment seam. */
|
|
217
|
-
export declare function readAuthorEnvironment():
|
|
217
|
+
export declare function readAuthorEnvironment():string | undefined;
|
|
218
218
|
/** Updates or clears the invocation-wide author override through the canonical environment seam. */
|
|
219
|
-
export declare function writeAuthorEnvironment(author:
|
|
219
|
+
export declare function writeAuthorEnvironment(author:string | undefined):void;
|
|
220
220
|
/**
|
|
221
221
|
* Detect a known agent harness from bounded, caller-supplied runtime signals.
|
|
222
222
|
*
|
|
@@ -224,17 +224,17 @@ export declare function writeAuthorEnvironment(author: string | undefined): void
|
|
|
224
224
|
* network access, or telemetry emission. Hosts can therefore use it in
|
|
225
225
|
* latency-sensitive mutation paths and test every detection branch directly.
|
|
226
226
|
*/
|
|
227
|
-
export declare function detectHarnessIdentity(signals?:
|
|
227
|
+
export declare function detectHarnessIdentity(signals?:HarnessDetectionSignals):string | undefined;
|
|
228
228
|
/**
|
|
229
229
|
* Resolve one mutation identity using the stable precedence contract:
|
|
230
230
|
* explicit argument, `PM_AUTHOR`, configured default, detected harness, then
|
|
231
231
|
* anonymous fallback.
|
|
232
232
|
*/
|
|
233
|
-
export declare function resolveAuthorIdentity(candidate:
|
|
233
|
+
export declare function resolveAuthorIdentity(candidate:string | undefined,fallback:string | undefined,signals?:HarnessDetectionSignals):ResolvedAuthorIdentity;
|
|
234
234
|
/** Return the provenance associated with the current resolved author. */
|
|
235
|
-
export declare function resolveHistoryAuthorSource(author:
|
|
235
|
+
export declare function resolveHistoryAuthorSource(author:string):AuthorSource;
|
|
236
236
|
/** Return structured agent provenance associated with the current author. */
|
|
237
|
-
export declare function resolveHistoryAgentIdentity(author:
|
|
237
|
+
export declare function resolveHistoryAgentIdentity(author:string):DetectedAgentIdentity;
|
|
238
238
|
/**
|
|
239
239
|
* Resolve the ownership principal for an automatically detected agent.
|
|
240
240
|
*
|
|
@@ -243,6 +243,6 @@ export declare function resolveHistoryAgentIdentity(author: string): DetectedAge
|
|
|
243
243
|
* same harness from silently sharing one claim. Explicit and configured
|
|
244
244
|
* authors intentionally retain their asserted principal.
|
|
245
245
|
*/
|
|
246
|
-
export declare function resolveClaimPrincipal(author:
|
|
246
|
+
export declare function resolveClaimPrincipal(author:string):string;
|
|
247
247
|
/** Resolves the effective mutation author from explicit input, environment defaults, and fallback settings. */
|
|
248
|
-
export declare function resolveAuthor(candidate:
|
|
248
|
+
export declare function resolveAuthor(candidate:string | undefined,fallback:string):string;
|
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
* Quotes tokenized recovery commands for the current platform shell.
|
|
4
4
|
*/
|
|
5
5
|
/** Quote one Windows argument with the linear CommandLineToArgvW escaping algorithm. */
|
|
6
|
-
export declare const quoteWindowsCommandArg:
|
|
6
|
+
export declare const quoteWindowsCommandArg:(arg:string) => string;
|
|
7
7
|
/** Quote one command argument only when platform shell-significant characters require it. */
|
|
8
|
-
export declare const quoteCommandArg:
|
|
8
|
+
export declare const quoteCommandArg:(arg:string,platform?:NodeJS.Platform) => string;
|
|
9
9
|
/** Render a complete pm command from already-tokenized arguments. */
|
|
10
|
-
export declare const renderPmCommand:
|
|
10
|
+
export declare const renderPmCommand:(argv:string[],platform?:NodeJS.Platform) => string;
|
|
@@ -6,43 +6,43 @@
|
|
|
6
6
|
/** Carries process-wide CLI options shared by command handlers and runtime adapters. */
|
|
7
7
|
export interface GlobalOptions {
|
|
8
8
|
/** Value that configures or reports json for this contract. */
|
|
9
|
-
json?:
|
|
9
|
+
json?:boolean;
|
|
10
10
|
/** Value that configures or reports quiet for this contract. */
|
|
11
|
-
quiet?:
|
|
11
|
+
quiet?:boolean;
|
|
12
12
|
/** Value that configures or reports no changed fields for this contract. */
|
|
13
|
-
noChangedFields?:
|
|
13
|
+
noChangedFields?:boolean;
|
|
14
14
|
/** Preserve the legacy full mutation envelope and changed-fields array. */
|
|
15
|
-
fullChangedFields?:
|
|
15
|
+
fullChangedFields?:boolean;
|
|
16
16
|
/** Value that configures or reports id only for this contract. */
|
|
17
|
-
idOnly?:
|
|
17
|
+
idOnly?:boolean;
|
|
18
18
|
/** Omit null and empty containers from JSON output. */
|
|
19
|
-
lean?:
|
|
19
|
+
lean?:boolean;
|
|
20
20
|
/** Attach a bounded receipt attributing the emitted output token cost. */
|
|
21
|
-
tokenAccounting?:
|
|
21
|
+
tokenAccounting?:boolean;
|
|
22
22
|
/** Canonical comma-separated fields or sections retained in read output. */
|
|
23
|
-
outputInclude?:
|
|
23
|
+
outputInclude?:string;
|
|
24
24
|
/** Canonical maximum row count retained in read output. */
|
|
25
|
-
outputLimit?:
|
|
25
|
+
outputLimit?:string;
|
|
26
26
|
/** Canonical estimated-token ceiling for read output. */
|
|
27
|
-
outputBudget?:
|
|
27
|
+
outputBudget?:string;
|
|
28
28
|
/** Canonical renderer encoding for read output. */
|
|
29
|
-
outputFormat?:
|
|
29
|
+
outputFormat?:"toon" | "json";
|
|
30
30
|
/** Caller-carried cross-call budget and served-item state. */
|
|
31
|
-
outputSession?:
|
|
31
|
+
outputSession?:string;
|
|
32
32
|
/** Opaque budget-compaction continuation cursor. */
|
|
33
|
-
outputCursor?:
|
|
33
|
+
outputCursor?:string;
|
|
34
34
|
/** Include the machine-readable row selector and TOON encoding contract. */
|
|
35
|
-
outputRowContract?:
|
|
35
|
+
outputRowContract?:boolean;
|
|
36
36
|
/** Filesystem path used for path resolution. */
|
|
37
|
-
path?:
|
|
37
|
+
path?:string;
|
|
38
38
|
/** Value that configures or reports no extensions for this contract. */
|
|
39
|
-
noExtensions?:
|
|
39
|
+
noExtensions?:boolean;
|
|
40
40
|
/** Value that configures or reports no pager for this contract. */
|
|
41
|
-
noPager?:
|
|
41
|
+
noPager?:boolean;
|
|
42
42
|
/** Value that configures or reports profile for this contract. */
|
|
43
|
-
profile?:
|
|
43
|
+
profile?:boolean;
|
|
44
44
|
/** Invocation-wide mutation author override. */
|
|
45
|
-
author?:
|
|
45
|
+
author?:string;
|
|
46
46
|
/** Fallback output format used when callers do not provide an override. */
|
|
47
|
-
defaultOutputFormat?:
|
|
47
|
+
defaultOutputFormat?:"toon" | "json";
|
|
48
48
|
}
|
|
@@ -6,13 +6,13 @@
|
|
|
6
6
|
/** Describes a detected unresolved merge-conflict marker and its source location. */
|
|
7
7
|
export interface ConflictMarkerMatch {
|
|
8
8
|
/** Value that configures or reports line for this contract. */
|
|
9
|
-
line:
|
|
9
|
+
line:number;
|
|
10
10
|
/** Value that configures or reports marker for this contract. */
|
|
11
|
-
marker:
|
|
11
|
+
marker:"<<<<<<<" | "=======" | ">>>>>>>";
|
|
12
12
|
/** Value that configures or reports text for this contract. */
|
|
13
|
-
text:
|
|
13
|
+
text:string;
|
|
14
14
|
}
|
|
15
15
|
/** Implements find merge conflict markers for the public runtime surface of this module. */
|
|
16
|
-
export declare function findMergeConflictMarkers(content:
|
|
16
|
+
export declare function findMergeConflictMarkers(content:string):ConflictMarkerMatch[];
|
|
17
17
|
/** Implements find first merge conflict marker for the public runtime surface of this module. */
|
|
18
|
-
export declare function findFirstMergeConflictMarker(content:
|
|
18
|
+
export declare function findFirstMergeConflictMarker(content:string):ConflictMarkerMatch | undefined;
|
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Provides shared primitives and utilities for Constants.
|
|
5
5
|
*/
|
|
6
|
-
import type { BuiltinItemType,
|
|
7
|
-
export { ITEM_METADATA_KEY_ORDER,
|
|
6
|
+
import type { BuiltinItemType,GovernancePreset,GovernanceSettings,PmSettings,RuntimeStatusDefinition,RuntimeWorkflowDefinition } from "../../types/index.js";
|
|
7
|
+
export { ITEM_METADATA_KEY_ORDER,ITEM_PROJECT_CONTEXT_KEYS,} from "./item-metadata-contract.js";
|
|
8
8
|
/**
|
|
9
9
|
* Canonical default lifecycle status model and workflow role mapping.
|
|
10
10
|
*
|
|
@@ -12,9 +12,9 @@ export { ITEM_METADATA_KEY_ORDER, ITEM_PROJECT_CONTEXT_KEYS, } from "./item-meta
|
|
|
12
12
|
* `src/core/schema/runtime-schema.ts` re-exports them as
|
|
13
13
|
* `DEFAULT_RUNTIME_STATUS_DEFINITIONS` / `DEFAULT_RUNTIME_WORKFLOW`.
|
|
14
14
|
*/
|
|
15
|
-
export declare const DEFAULT_STATUS_DEFINITIONS:
|
|
15
|
+
export declare const DEFAULT_STATUS_DEFINITIONS:ReadonlyArray<RuntimeStatusDefinition>;
|
|
16
16
|
/** Fallback workflow definition used when callers do not provide an override. */
|
|
17
|
-
export declare const DEFAULT_WORKFLOW_DEFINITION:
|
|
17
|
+
export declare const DEFAULT_WORKFLOW_DEFINITION:RuntimeWorkflowDefinition;
|
|
18
18
|
/** Public contract for pm dirname, shared by SDK and presentation-layer consumers. */
|
|
19
19
|
export declare const PM_DIRNAME = ".agents/pm";
|
|
20
20
|
/** Public contract for settings filename, shared by SDK and presentation-layer consumers. */
|
|
@@ -22,45 +22,45 @@ export declare const SETTINGS_FILENAME = "settings.json";
|
|
|
22
22
|
/** @deprecated Terminal transitions no longer synthesize reasons; retained for SDK source compatibility. */
|
|
23
23
|
export declare const CREATE_DIRECT_CLOSE_REASON_DEFAULT = "Closed at creation via pm create";
|
|
24
24
|
/** Public contract for pm core required subdirs, shared by SDK and presentation-layer consumers. */
|
|
25
|
-
export declare const PM_CORE_REQUIRED_SUBDIRS:
|
|
25
|
+
export declare const PM_CORE_REQUIRED_SUBDIRS:readonly ["","epics","features","tasks","chores","issues","schema","history","search","extensions","locks"];
|
|
26
26
|
/** Public contract for pm optional type subdirs, shared by SDK and presentation-layer consumers. */
|
|
27
|
-
export declare const PM_OPTIONAL_TYPE_SUBDIRS:
|
|
27
|
+
export declare const PM_OPTIONAL_TYPE_SUBDIRS:readonly ["decisions","events","reminders","milestones","meetings","plans"];
|
|
28
28
|
/** Public contract for pm required subdirs, shared by SDK and presentation-layer consumers. */
|
|
29
|
-
export declare const PM_REQUIRED_SUBDIRS:
|
|
29
|
+
export declare const PM_REQUIRED_SUBDIRS:readonly ["","epics","features","tasks","chores","issues","schema","history","search","extensions","locks","decisions","events","reminders","milestones","meetings","plans"];
|
|
30
30
|
/** Public contract for type to folder, shared by SDK and presentation-layer consumers. */
|
|
31
|
-
export declare const TYPE_TO_FOLDER:
|
|
32
|
-
type BuiltinGovernancePreset = Exclude<GovernancePreset,
|
|
31
|
+
export declare const TYPE_TO_FOLDER:Record<BuiltinItemType,string>;
|
|
32
|
+
type BuiltinGovernancePreset = Exclude<GovernancePreset,"custom">;
|
|
33
33
|
/** Public contract for governance preset defaults, shared by SDK and presentation-layer consumers. */
|
|
34
|
-
export declare const GOVERNANCE_PRESET_DEFAULTS:
|
|
34
|
+
export declare const GOVERNANCE_PRESET_DEFAULTS:Record<BuiltinGovernancePreset,Omit<GovernanceSettings,"preset">>;
|
|
35
35
|
/** Fallback validate stale blocker reason patterns used when callers do not provide an override. */
|
|
36
|
-
export declare const DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS:
|
|
36
|
+
export declare const DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS:readonly ["no active blocker","ready for planned execution sequencing","work completed","work is closed"];
|
|
37
37
|
/** Fallback validate closure like metadata field patterns used when callers do not provide an override. */
|
|
38
|
-
export declare const DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS:
|
|
39
|
-
readonly blocked_reason:
|
|
40
|
-
readonly resolution:
|
|
41
|
-
readonly actual_result:
|
|
38
|
+
export declare const DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS:{
|
|
39
|
+
readonly blocked_reason:readonly ["no active blocker because work is closed","work is closed"];
|
|
40
|
+
readonly resolution:readonly ["closed with implementation evidence","closed with verification evidence","work completed and recorded","work is closed"];
|
|
41
|
+
readonly actual_result:readonly ["closed and recorded","work completed","work completed and recorded"];
|
|
42
42
|
};
|
|
43
43
|
/** Public contract for settings defaults, shared by SDK and presentation-layer consumers. */
|
|
44
|
-
export declare const SETTINGS_DEFAULTS:
|
|
44
|
+
export declare const SETTINGS_DEFAULTS:PmSettings;
|
|
45
45
|
/** Public contract for empty canonical document, shared by SDK and presentation-layer consumers. */
|
|
46
|
-
export declare const EMPTY_CANONICAL_DOCUMENT:
|
|
47
|
-
metadata:
|
|
48
|
-
body:
|
|
46
|
+
export declare const EMPTY_CANONICAL_DOCUMENT:{
|
|
47
|
+
metadata:{};
|
|
48
|
+
body:string;
|
|
49
49
|
};
|
|
50
50
|
/** Public contract for exit code, shared by SDK and presentation-layer consumers. */
|
|
51
|
-
export declare const EXIT_CODE:
|
|
52
|
-
readonly SUCCESS:
|
|
53
|
-
readonly GENERIC_FAILURE:
|
|
54
|
-
readonly USAGE:
|
|
55
|
-
readonly NOT_FOUND:
|
|
56
|
-
readonly CONFLICT:
|
|
57
|
-
readonly DEPENDENCY_FAILED:
|
|
58
|
-
readonly NO_EFFECT:
|
|
59
|
-
readonly PARTIAL_EFFECT:
|
|
51
|
+
export declare const EXIT_CODE:{
|
|
52
|
+
readonly SUCCESS:0;
|
|
53
|
+
readonly GENERIC_FAILURE:1;
|
|
54
|
+
readonly USAGE:2;
|
|
55
|
+
readonly NOT_FOUND:3;
|
|
56
|
+
readonly CONFLICT:4;
|
|
57
|
+
readonly DEPENDENCY_FAILED:5;
|
|
58
|
+
readonly NO_EFFECT:6;
|
|
59
|
+
readonly PARTIAL_EFFECT:7;
|
|
60
60
|
};
|
|
61
61
|
/** Restricts telemetry error category values accepted by command, SDK, and storage contracts. */
|
|
62
62
|
export type TelemetryErrorCategory = "usage" | "validation" | "conflict" | "runtime" | "unknown";
|
|
63
63
|
/** Public contract for telemetry error category by code, shared by SDK and presentation-layer consumers. */
|
|
64
|
-
export declare const TELEMETRY_ERROR_CATEGORY_BY_CODE:
|
|
64
|
+
export declare const TELEMETRY_ERROR_CATEGORY_BY_CODE:Readonly<Record<string,TelemetryErrorCategory>>;
|
|
65
65
|
/** Implements resolve telemetry error category for the public runtime surface of this module. */
|
|
66
|
-
export declare function resolveTelemetryErrorCategory(errorCode:
|
|
66
|
+
export declare function resolveTelemetryErrorCategory(errorCode:string | undefined):TelemetryErrorCategory;
|