@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,138 +1,138 @@
|
|
|
1
|
-
import { type EmbeddingBatchReceipt,
|
|
2
|
-
import type { ItemDocument,
|
|
1
|
+
import { type EmbeddingBatchReceipt,resolveEmbeddingProviders,resolveVectorStores,type VectorizationEmbeddingIdentity,type GlobalOptions,type CachedDocumentCandidate } from "../runtime-primitives.js";
|
|
2
|
+
import type { ItemDocument,PmSettings } from "../../types/index.js";
|
|
3
3
|
type ReindexMode = "keyword" | "semantic" | "hybrid";
|
|
4
4
|
/** Documents the reindex options payload exchanged by command, SDK, and package integrations. */
|
|
5
5
|
export interface ReindexOptions {
|
|
6
6
|
/** Value that configures or reports mode for this contract. */
|
|
7
|
-
mode?:
|
|
7
|
+
mode?:string;
|
|
8
8
|
/** Value that configures or reports progress for this contract. */
|
|
9
|
-
progress?:
|
|
9
|
+
progress?:boolean;
|
|
10
10
|
/** Value that configures or reports full for this contract. */
|
|
11
|
-
full?:
|
|
11
|
+
full?:boolean;
|
|
12
12
|
}
|
|
13
13
|
/** Documents the reindex result payload exchanged by command, SDK, and package integrations. */
|
|
14
14
|
export interface ReindexResult {
|
|
15
15
|
/** Whether the operation completed without a blocking failure. */
|
|
16
|
-
ok:
|
|
16
|
+
ok:boolean;
|
|
17
17
|
/** Value that configures or reports mode for this contract. */
|
|
18
|
-
mode:
|
|
18
|
+
mode:ReindexMode;
|
|
19
19
|
/** Value that configures or reports total items for this contract. */
|
|
20
|
-
total_items:
|
|
20
|
+
total_items:number;
|
|
21
21
|
/** Value that configures or reports semantic for this contract. */
|
|
22
|
-
semantic:
|
|
23
|
-
enabled:
|
|
24
|
-
stale_items:
|
|
25
|
-
unchanged_items:
|
|
26
|
-
embedded_items:
|
|
27
|
-
vector_upserted:
|
|
28
|
-
batches_completed:
|
|
22
|
+
semantic:{
|
|
23
|
+
enabled:boolean;
|
|
24
|
+
stale_items:number;
|
|
25
|
+
unchanged_items:number;
|
|
26
|
+
embedded_items:number;
|
|
27
|
+
vector_upserted:number;
|
|
28
|
+
batches_completed:number;
|
|
29
29
|
/** Actual built-in provider requests, splits, throughput, and byte ceiling. */
|
|
30
|
-
batching?:
|
|
30
|
+
batching?:EmbeddingBatchReceipt;
|
|
31
31
|
};
|
|
32
32
|
/** Value that configures or reports artifacts for this contract. */
|
|
33
|
-
artifacts:
|
|
34
|
-
manifest:
|
|
35
|
-
embeddings:
|
|
33
|
+
artifacts:{
|
|
34
|
+
manifest:string;
|
|
35
|
+
embeddings:string;
|
|
36
36
|
};
|
|
37
37
|
/** Value that configures or reports warnings for this contract. */
|
|
38
|
-
warnings:
|
|
38
|
+
warnings:string[];
|
|
39
39
|
/** ISO 8601 timestamp recording when generated occurred. */
|
|
40
|
-
generated_at:
|
|
40
|
+
generated_at:string;
|
|
41
41
|
}
|
|
42
|
-
declare function shouldEmitReindexProgress(options:
|
|
43
|
-
declare function emitReindexProgress(enabled:
|
|
44
|
-
declare function parseMode(raw:
|
|
45
|
-
declare function hydrateDocuments(pmRoot:
|
|
46
|
-
declare function buildKeywordRecord(document:
|
|
47
|
-
type ExtensionEmbedBatch = (context:
|
|
48
|
-
inputs:
|
|
49
|
-
settings:
|
|
50
|
-
model:
|
|
42
|
+
declare function shouldEmitReindexProgress(options:ReindexOptions):boolean;
|
|
43
|
+
declare function emitReindexProgress(enabled:boolean,message:string):void;
|
|
44
|
+
declare function parseMode(raw:string | undefined):ReindexMode;
|
|
45
|
+
declare function hydrateDocuments(pmRoot:string,candidates:CachedDocumentCandidate[],schema:PmSettings["schema"],warnings:string[],itemIds?:Set<string>):Promise<ItemDocument[]>;
|
|
46
|
+
declare function buildKeywordRecord(document:ItemDocument,mode:ReindexMode,corpusFields?:string[]):Record<string,unknown>;
|
|
47
|
+
type ExtensionEmbedBatch = (context:{
|
|
48
|
+
inputs:string[];
|
|
49
|
+
settings:PmSettings;
|
|
50
|
+
model:string;
|
|
51
51
|
}) => Promise<number[][]> | number[][];
|
|
52
|
-
type ExtensionEmbedOne = (context:
|
|
53
|
-
input:
|
|
54
|
-
settings:
|
|
55
|
-
model:
|
|
52
|
+
type ExtensionEmbedOne = (context:{
|
|
53
|
+
input:string;
|
|
54
|
+
settings:PmSettings;
|
|
55
|
+
model:string;
|
|
56
56
|
}) => Promise<number[]> | number[];
|
|
57
|
-
type ExtensionVectorUpsert = (context:
|
|
58
|
-
points:
|
|
59
|
-
id:
|
|
60
|
-
vector:
|
|
61
|
-
payload:
|
|
57
|
+
type ExtensionVectorUpsert = (context:{
|
|
58
|
+
points:Array<{
|
|
59
|
+
id:string;
|
|
60
|
+
vector:number[];
|
|
61
|
+
payload:Record<string,unknown>;
|
|
62
62
|
}>;
|
|
63
|
-
settings:
|
|
63
|
+
settings:PmSettings;
|
|
64
64
|
}) => Promise<void> | void;
|
|
65
|
-
type ExtensionVectorDelete = (context:
|
|
66
|
-
ids:
|
|
67
|
-
settings:
|
|
65
|
+
type ExtensionVectorDelete = (context:{
|
|
66
|
+
ids:string[];
|
|
67
|
+
settings:PmSettings;
|
|
68
68
|
}) => Promise<void> | void;
|
|
69
69
|
interface ExtensionVectorAdapter {
|
|
70
|
-
adapterName:
|
|
71
|
-
upsert?:
|
|
72
|
-
delete?:
|
|
70
|
+
adapterName:string;
|
|
71
|
+
upsert?:ExtensionVectorUpsert;
|
|
72
|
+
delete?:ExtensionVectorDelete;
|
|
73
73
|
}
|
|
74
74
|
interface ReindexEmbeddingExecutionResult {
|
|
75
|
-
vectors:
|
|
76
|
-
embeddingIdentity:
|
|
75
|
+
vectors:number[][];
|
|
76
|
+
embeddingIdentity:VectorizationEmbeddingIdentity;
|
|
77
77
|
}
|
|
78
78
|
/** Public contract for test only, shared by SDK and presentation-layer consumers. */
|
|
79
|
-
export declare const _testOnly:
|
|
80
|
-
shouldEmitReindexProgress:
|
|
81
|
-
emitReindexProgress:
|
|
82
|
-
parseMode:
|
|
83
|
-
hydrateDocuments:
|
|
84
|
-
buildKeywordRecord:
|
|
85
|
-
resolveExtensionSearchEmbedding:
|
|
86
|
-
resolveExtensionVectorAdapter:
|
|
87
|
-
assertVector:
|
|
88
|
-
executeExtensionEmbedding:
|
|
89
|
-
resolveExtensionEmbeddingModel:
|
|
90
|
-
resolveReindexEmbeddingIdentity:
|
|
91
|
-
executeReindexEmbedding:
|
|
92
|
-
collectLedgerOrphanIds:
|
|
93
|
-
resetVectorStoreForReindex:
|
|
94
|
-
pruneReindexOrphanVectors:
|
|
95
|
-
upsertReindexVectors:
|
|
79
|
+
export declare const _testOnly:{
|
|
80
|
+
shouldEmitReindexProgress:typeof shouldEmitReindexProgress;
|
|
81
|
+
emitReindexProgress:typeof emitReindexProgress;
|
|
82
|
+
parseMode:typeof parseMode;
|
|
83
|
+
hydrateDocuments:typeof hydrateDocuments;
|
|
84
|
+
buildKeywordRecord:typeof buildKeywordRecord;
|
|
85
|
+
resolveExtensionSearchEmbedding:typeof resolveExtensionSearchEmbedding;
|
|
86
|
+
resolveExtensionVectorAdapter:typeof resolveExtensionVectorAdapter;
|
|
87
|
+
assertVector:typeof assertVector;
|
|
88
|
+
executeExtensionEmbedding:typeof executeExtensionEmbedding;
|
|
89
|
+
resolveExtensionEmbeddingModel:typeof resolveExtensionEmbeddingModel;
|
|
90
|
+
resolveReindexEmbeddingIdentity:typeof resolveReindexEmbeddingIdentity;
|
|
91
|
+
executeReindexEmbedding:typeof executeReindexEmbedding;
|
|
92
|
+
collectLedgerOrphanIds:typeof collectLedgerOrphanIds;
|
|
93
|
+
resetVectorStoreForReindex:typeof resetVectorStoreForReindex;
|
|
94
|
+
pruneReindexOrphanVectors:typeof pruneReindexOrphanVectors;
|
|
95
|
+
upsertReindexVectors:typeof upsertReindexVectors;
|
|
96
96
|
};
|
|
97
|
-
declare function resolveExtensionSearchEmbedding(settings:
|
|
98
|
-
name:
|
|
99
|
-
embedBatch?:
|
|
100
|
-
embed?:
|
|
97
|
+
declare function resolveExtensionSearchEmbedding(settings:PmSettings):{
|
|
98
|
+
name:string;
|
|
99
|
+
embedBatch?:ExtensionEmbedBatch;
|
|
100
|
+
embed?:ExtensionEmbedOne;
|
|
101
101
|
} | null;
|
|
102
|
-
declare function resolveExtensionVectorAdapter(settings:
|
|
103
|
-
declare function assertVector(value:
|
|
104
|
-
declare function executeExtensionEmbedding(extensionEmbedding:
|
|
105
|
-
name:
|
|
106
|
-
embedBatch?:
|
|
107
|
-
embed?:
|
|
108
|
-
},
|
|
109
|
-
declare function resolveExtensionEmbeddingModel(settings:
|
|
110
|
-
declare function resolveReindexEmbeddingIdentity(settings:
|
|
111
|
-
name:
|
|
112
|
-
} | null):
|
|
113
|
-
declare function collectLedgerOrphanIds(ledgerEntries:
|
|
102
|
+
declare function resolveExtensionVectorAdapter(settings:PmSettings):ExtensionVectorAdapter | null;
|
|
103
|
+
declare function assertVector(value:unknown,context:string):number[];
|
|
104
|
+
declare function executeExtensionEmbedding(extensionEmbedding:{
|
|
105
|
+
name:string;
|
|
106
|
+
embedBatch?:ExtensionEmbedBatch;
|
|
107
|
+
embed?:ExtensionEmbedOne;
|
|
108
|
+
},settings:PmSettings,corpusInputs:string[]):Promise<number[][]>;
|
|
109
|
+
declare function resolveExtensionEmbeddingModel(settings:PmSettings):string;
|
|
110
|
+
declare function resolveReindexEmbeddingIdentity(settings:PmSettings,activeEmbeddingProvider:ReturnType<typeof resolveEmbeddingProviders>["active"],extensionEmbedding:{
|
|
111
|
+
name:string;
|
|
112
|
+
} | null):VectorizationEmbeddingIdentity;
|
|
113
|
+
declare function collectLedgerOrphanIds(ledgerEntries:Record<string,string>,currentIds:Set<string>):string[];
|
|
114
114
|
/** Embed the selected corpus through extension or built-in providers, preserving cardinality and execution receipts. */
|
|
115
|
-
declare function executeReindexEmbedding(settings:
|
|
116
|
-
name:
|
|
117
|
-
embedBatch?:
|
|
118
|
-
embed?:
|
|
119
|
-
} | null,
|
|
120
|
-
declare function resetVectorStoreForReindex(activeVectorStore:
|
|
121
|
-
declare function pruneReindexOrphanVectors(activeVectorStore:
|
|
122
|
-
declare function upsertReindexVectors(params:
|
|
123
|
-
requestedMode:
|
|
124
|
-
activeVectorStore:
|
|
125
|
-
extensionVectorAdapter:
|
|
126
|
-
settings:
|
|
127
|
-
points:
|
|
128
|
-
id:
|
|
129
|
-
vector:
|
|
130
|
-
payload:
|
|
115
|
+
declare function executeReindexEmbedding(settings:PmSettings,requestedMode:"keyword" | "semantic" | "hybrid",activeEmbeddingProvider:ReturnType<typeof resolveEmbeddingProviders>["active"],extensionEmbedding:{
|
|
116
|
+
name:string;
|
|
117
|
+
embedBatch?:ExtensionEmbedBatch;
|
|
118
|
+
embed?:ExtensionEmbedOne;
|
|
119
|
+
} | null,documents:ItemDocument[],semanticWarnings:string[],semanticSummary:ReindexResult["semantic"],progressEnabled:boolean):Promise<ReindexEmbeddingExecutionResult>;
|
|
120
|
+
declare function resetVectorStoreForReindex(activeVectorStore:ReturnType<typeof resolveVectorStores>["active"],extensionVectorAdapter:ExtensionVectorAdapter | null,ledgerEntries:Record<string,string>,settings:PmSettings,semanticWarnings:string[],vectorDimension?:number):Promise<void>;
|
|
121
|
+
declare function pruneReindexOrphanVectors(activeVectorStore:ReturnType<typeof resolveVectorStores>["active"],extensionVectorAdapter:ExtensionVectorAdapter | null,orphanIds:string[],settings:PmSettings,semanticWarnings:string[]):Promise<void>;
|
|
122
|
+
declare function upsertReindexVectors(params:{
|
|
123
|
+
requestedMode:ReindexMode;
|
|
124
|
+
activeVectorStore:ReturnType<typeof resolveVectorStores>["active"];
|
|
125
|
+
extensionVectorAdapter:ExtensionVectorAdapter | null;
|
|
126
|
+
settings:PmSettings;
|
|
127
|
+
points:Array<{
|
|
128
|
+
id:string;
|
|
129
|
+
vector:number[];
|
|
130
|
+
payload:Record<string,unknown>;
|
|
131
131
|
}>;
|
|
132
|
-
semanticWarnings:
|
|
133
|
-
semanticSummary:
|
|
134
|
-
progressEnabled:
|
|
135
|
-
}):
|
|
132
|
+
semanticWarnings:string[];
|
|
133
|
+
semanticSummary:ReindexResult["semantic"];
|
|
134
|
+
progressEnabled:boolean;
|
|
135
|
+
}):Promise<void>;
|
|
136
136
|
/** Implements run reindex for the public runtime surface of this module. */
|
|
137
|
-
export declare function runReindex(options:
|
|
137
|
+
export declare function runReindex(options:ReindexOptions,global:GlobalOptions):Promise<ReindexResult>;
|
|
138
138
|
export {};
|
|
@@ -1,74 +1,74 @@
|
|
|
1
1
|
/** One original attempt in a caller-defined recurrence family. */
|
|
2
2
|
export interface ReliabilityAttempt {
|
|
3
3
|
/** Unique occurrence identity; retries retain the original occurrence separately. */
|
|
4
|
-
id:
|
|
4
|
+
id:string;
|
|
5
5
|
/** Stable family identity independent of the occurrence's lifecycle. */
|
|
6
|
-
family:
|
|
6
|
+
family:string;
|
|
7
7
|
/** Recorded start instant, used for half-open window membership. */
|
|
8
|
-
started_at:
|
|
8
|
+
started_at:string;
|
|
9
9
|
/** Original outcome; a successful retry must not replace a failure. */
|
|
10
|
-
outcome:
|
|
10
|
+
outcome:"success" | "failure" | "pending";
|
|
11
11
|
/** Observed repair instant, when supported by independent evidence. */
|
|
12
|
-
repaired_at?:
|
|
12
|
+
repaired_at?:string;
|
|
13
13
|
/** Failure-only cause; omit on success/pending and leave unknown without classification. */
|
|
14
|
-
cause?:
|
|
14
|
+
cause?:"product" | "infrastructure" | "unknown";
|
|
15
15
|
}
|
|
16
16
|
/** Explicit population and thresholds for a reproducible reliability query. */
|
|
17
17
|
export interface ReliabilityWindowPolicy {
|
|
18
18
|
/** Inclusive UTC window boundary. */
|
|
19
|
-
window_start:
|
|
19
|
+
window_start:string;
|
|
20
20
|
/** Exclusive UTC window boundary and repair-observation cutoff. */
|
|
21
|
-
window_end:
|
|
21
|
+
window_end:string;
|
|
22
22
|
/** Expected families, including families with no observed attempts. */
|
|
23
|
-
families:
|
|
23
|
+
families:readonly string[];
|
|
24
24
|
/** Maximum permitted original-attempt failure fraction in [0, 1). */
|
|
25
|
-
max_failure_rate:
|
|
25
|
+
max_failure_rate:number;
|
|
26
26
|
/** Minimum completed attempts required to establish coverage. */
|
|
27
|
-
min_completed_attempts:
|
|
27
|
+
min_completed_attempts:number;
|
|
28
28
|
}
|
|
29
29
|
/** Bounded aggregate evidence for one recurrence family. */
|
|
30
30
|
export interface ReliabilityFamilyReport {
|
|
31
31
|
/** Stable identity from the declared population. */
|
|
32
|
-
family:
|
|
32
|
+
family:string;
|
|
33
33
|
/** All original attempts in the selected window. */
|
|
34
|
-
attempts:
|
|
34
|
+
attempts:number;
|
|
35
35
|
/** Attempts with a terminal original outcome. */
|
|
36
|
-
completed:
|
|
36
|
+
completed:number;
|
|
37
37
|
/** Originally failed attempts, including repaired occurrences. */
|
|
38
|
-
failed:
|
|
38
|
+
failed:number;
|
|
39
39
|
/** Attempts whose original outcome remains pending. */
|
|
40
|
-
pending:
|
|
40
|
+
pending:number;
|
|
41
41
|
/** Null denotes absent completed evidence, distinct from zero failures. */
|
|
42
|
-
failure_rate:
|
|
42
|
+
failure_rate:number | null;
|
|
43
43
|
/** UTC dates carrying at least one original failure. */
|
|
44
|
-
affected_days:
|
|
44
|
+
affected_days:string[];
|
|
45
45
|
/** Sorted observed repair durations in minutes; missing repairs are excluded. */
|
|
46
|
-
repair_minutes:
|
|
46
|
+
repair_minutes:number[];
|
|
47
47
|
/** Failures without a repair observed before the query cutoff. */
|
|
48
|
-
unresolved:
|
|
48
|
+
unresolved:number;
|
|
49
49
|
/** Cause counts retain unclassified failures instead of guessing attribution. */
|
|
50
|
-
causes:
|
|
50
|
+
causes:Record<"product" | "infrastructure" | "unknown",number>;
|
|
51
51
|
/** Coverage or rate findings that enforce the declared policy. */
|
|
52
|
-
violations:
|
|
52
|
+
violations:Array<"insufficient_completed_attempts" | "failure_rate">;
|
|
53
53
|
/** True only when both coverage and the rate satisfy policy. */
|
|
54
|
-
ok:
|
|
54
|
+
ok:boolean;
|
|
55
55
|
}
|
|
56
56
|
/** Reproducible aggregate verdict suitable for a package, gate, or recorded measurement. */
|
|
57
57
|
export interface ReliabilityWindowReport {
|
|
58
58
|
/** Versioned result schema for persisted evidence. */
|
|
59
|
-
schema:
|
|
59
|
+
schema:"pm-reliability-window/1";
|
|
60
60
|
/** Normalized inclusive query boundary. */
|
|
61
|
-
window_start:
|
|
61
|
+
window_start:string;
|
|
62
62
|
/** Normalized exclusive query boundary. */
|
|
63
|
-
window_end:
|
|
63
|
+
window_end:string;
|
|
64
64
|
/** True only when every expected family satisfies policy. */
|
|
65
|
-
ok:
|
|
65
|
+
ok:boolean;
|
|
66
66
|
/** Reports preserve the caller's declared family order. */
|
|
67
|
-
families:
|
|
67
|
+
families:ReliabilityFamilyReport[];
|
|
68
68
|
}
|
|
69
69
|
/**
|
|
70
70
|
* Evaluate original attempts in [start, end), keeping repair and cause evidence separate.
|
|
71
71
|
* Reject duplicate identities, undeclared families, invalid outcomes and chronology.
|
|
72
72
|
* Empty families fail coverage; they never masquerade as healthy zero-rate evidence.
|
|
73
73
|
*/
|
|
74
|
-
export declare function evaluateReliabilityWindow(attempts:
|
|
74
|
+
export declare function evaluateReliabilityWindow(attempts:readonly ReliabilityAttempt[],policy:ReliabilityWindowPolicy):ReliabilityWindowReport;
|
|
@@ -2,35 +2,35 @@ import type { ItemMetadata } from "../../types/index.js";
|
|
|
2
2
|
/** One unclaimed in-progress item whose recorded activity exceeded policy. */
|
|
3
3
|
export interface StaleInProgressItem {
|
|
4
4
|
/** Stable item identifier. */
|
|
5
|
-
id:
|
|
5
|
+
id:string;
|
|
6
6
|
/** Most recent valid item or history timestamp. */
|
|
7
|
-
last_activity_at:
|
|
7
|
+
last_activity_at:string;
|
|
8
8
|
/** Whole hours elapsed at scan time. */
|
|
9
|
-
age_hours:
|
|
9
|
+
age_hours:number;
|
|
10
10
|
}
|
|
11
11
|
/** Read-only stale-work diagnostic returned to SDK and health consumers. */
|
|
12
12
|
export interface StaleInProgressScan {
|
|
13
13
|
/** Policy threshold applied by the scan. */
|
|
14
|
-
threshold_hours:
|
|
14
|
+
threshold_hours:number;
|
|
15
15
|
/** Number of stale items. */
|
|
16
|
-
count:
|
|
16
|
+
count:number;
|
|
17
17
|
/** Deterministically ordered stale items. */
|
|
18
|
-
items:
|
|
18
|
+
items:StaleInProgressItem[];
|
|
19
19
|
/** Agent-facing recovery guidance. */
|
|
20
|
-
remediation:
|
|
20
|
+
remediation:string;
|
|
21
21
|
}
|
|
22
22
|
/** Inputs for the pure stale-work classifier. */
|
|
23
23
|
export interface InspectStaleInProgressOptions {
|
|
24
24
|
/** Status id configured as the active lifecycle state. */
|
|
25
|
-
in_progress_status?:
|
|
25
|
+
in_progress_status?:string;
|
|
26
26
|
/** Age threshold in hours. */
|
|
27
|
-
threshold_hours:
|
|
27
|
+
threshold_hours:number;
|
|
28
28
|
/** Scan timestamp, injectable for deterministic tests. */
|
|
29
|
-
now?:
|
|
29
|
+
now?:Date;
|
|
30
30
|
/** Optional latest-history timestamp lookup. */
|
|
31
|
-
last_history_activity?:
|
|
31
|
+
last_history_activity?:(item:ItemMetadata) => string | undefined;
|
|
32
32
|
}
|
|
33
33
|
/** Classify stale unclaimed in-progress items without filesystem access. */
|
|
34
|
-
export declare function inspectStaleInProgressItems(items:
|
|
34
|
+
export declare function inspectStaleInProgressItems(items:readonly ItemMetadata[],options:InspectStaleInProgressOptions):StaleInProgressScan;
|
|
35
35
|
/** Scan tracker history and metadata for stale unclaimed in-progress work. */
|
|
36
|
-
export declare function scanStaleInProgressItems(pmRoot:
|
|
36
|
+
export declare function scanStaleInProgressItems(pmRoot:string,items:readonly ItemMetadata[],options:Omit<InspectStaleInProgressOptions,"last_history_activity">):Promise<StaleInProgressScan>;
|
|
@@ -9,19 +9,19 @@ import { type RuntimeStatusRegistry } from "../../core/schema/runtime-schema.js"
|
|
|
9
9
|
/** Bounded evidence describing roleless status definitions and affected items. */
|
|
10
10
|
export interface StatusRoleDiagnostics {
|
|
11
11
|
/** Total number of registered status ids that have no lifecycle role. */
|
|
12
|
-
roleless_status_count:
|
|
12
|
+
roleless_status_count:number;
|
|
13
13
|
/** Registered status ids that have no lifecycle role. */
|
|
14
|
-
roleless_statuses:
|
|
14
|
+
roleless_statuses:string[];
|
|
15
15
|
/** Whether roleless status ids were omitted from the bounded sample. */
|
|
16
|
-
roleless_statuses_truncated:
|
|
16
|
+
roleless_statuses_truncated:boolean;
|
|
17
17
|
/** Number of items whose status resolves to a roleless definition. */
|
|
18
|
-
affected_item_count:
|
|
18
|
+
affected_item_count:number;
|
|
19
19
|
/** Bounded, deterministic sample of affected item ids. */
|
|
20
|
-
affected_item_ids:
|
|
20
|
+
affected_item_ids:string[];
|
|
21
21
|
/** Whether affected item ids were omitted from the bounded sample. */
|
|
22
|
-
affected_item_ids_truncated:
|
|
22
|
+
affected_item_ids_truncated:boolean;
|
|
23
23
|
}
|
|
24
24
|
/** Inspect role registration and affected items without mutating the tracker. */
|
|
25
|
-
export declare function inspectStatusRoleAssignments(statusRegistry:
|
|
25
|
+
export declare function inspectStatusRoleAssignments(statusRegistry:RuntimeStatusRegistry,items:readonly ItemMetadata[],itemLimit?:number):StatusRoleDiagnostics;
|
|
26
26
|
/** Convert role diagnostics into the stable health/validate warning token. */
|
|
27
|
-
export declare function buildStatusRoleWarnings(diagnostics:
|
|
27
|
+
export declare function buildStatusRoleWarnings(diagnostics:StatusRoleDiagnostics):string[];
|
|
@@ -2,77 +2,77 @@ import { type ItemDocumentFormatOptions } from "../../core/item/item-format.js";
|
|
|
2
2
|
/** Documents one unreadable item-file finding surfaced by the storage-integrity check. */
|
|
3
3
|
export interface UnreadableItemFileRow {
|
|
4
4
|
/** Tracker-relative path of the item file that failed to parse. */
|
|
5
|
-
path:
|
|
5
|
+
path:string;
|
|
6
6
|
/** Item id derived from the file name. */
|
|
7
|
-
id:
|
|
7
|
+
id:string;
|
|
8
8
|
}
|
|
9
9
|
/** Documents one history-stream finding surfaced by the storage-integrity check. */
|
|
10
10
|
export interface HistoryStreamIntegrityRow {
|
|
11
11
|
/** Item id whose history stream is affected. */
|
|
12
|
-
id:
|
|
12
|
+
id:string;
|
|
13
13
|
/** Tracker-relative path of the history stream. */
|
|
14
|
-
path:
|
|
14
|
+
path:string;
|
|
15
15
|
/** Line number of the first offending content, when line-addressable. */
|
|
16
|
-
line?:
|
|
16
|
+
line?:number;
|
|
17
17
|
/** Failure detail (conflict marker text or parse failure reason). */
|
|
18
|
-
detail:
|
|
18
|
+
detail:string;
|
|
19
19
|
}
|
|
20
20
|
/** Documents one resurrection-candidate finding: a live item whose history says it was deleted. */
|
|
21
21
|
export interface ResurrectedItemRow {
|
|
22
22
|
/** Live item id whose newest history operation is a delete. */
|
|
23
|
-
id:
|
|
23
|
+
id:string;
|
|
24
24
|
/** Timestamp of the recorded delete operation. */
|
|
25
|
-
deleted_at:
|
|
25
|
+
deleted_at:string;
|
|
26
26
|
/** Author of the recorded delete operation. */
|
|
27
|
-
deleted_by:
|
|
27
|
+
deleted_by:string;
|
|
28
28
|
}
|
|
29
29
|
/** Documents one duplicate-item-id finding: one id claimed by multiple item documents (cross-branch add/add collision or duplicated format variant). */
|
|
30
30
|
export interface DuplicateItemIdRow {
|
|
31
31
|
/** Item id claimed by more than one on-disk document. */
|
|
32
|
-
id:
|
|
32
|
+
id:string;
|
|
33
33
|
/** Tracker-relative paths of every document claiming the id, sorted for determinism. */
|
|
34
|
-
paths:
|
|
34
|
+
paths:string[];
|
|
35
35
|
}
|
|
36
36
|
/** Documents one unparseable configuration/schema file finding. */
|
|
37
37
|
export interface UnparseableConfigRow {
|
|
38
38
|
/** Tracker-relative path of the configuration file. */
|
|
39
|
-
path:
|
|
39
|
+
path:string;
|
|
40
40
|
/** Failure detail (conflict marker location or JSON parse failure). */
|
|
41
|
-
detail:
|
|
41
|
+
detail:string;
|
|
42
42
|
}
|
|
43
43
|
/** Documents the storage-integrity scan result consumed by the validate check builder. */
|
|
44
44
|
export interface StorageIntegrityScanResult {
|
|
45
45
|
/** Number of item files present on disk across all type folders. */
|
|
46
|
-
item_files_on_disk:
|
|
46
|
+
item_files_on_disk:number;
|
|
47
47
|
/** Number of distinct item ids present on disk. */
|
|
48
|
-
item_ids_on_disk:
|
|
48
|
+
item_ids_on_disk:number;
|
|
49
49
|
/** Number of items the standard read path successfully parsed. */
|
|
50
|
-
parsed_items:
|
|
50
|
+
parsed_items:number;
|
|
51
51
|
/** Item files whose ids the standard read path could not parse (silently skipped elsewhere). */
|
|
52
|
-
unreadable_item_files:
|
|
52
|
+
unreadable_item_files:UnreadableItemFileRow[];
|
|
53
53
|
/** Ids claimed by more than one item document (post-merge add/add id collisions across type folders or format variants; GH-600). */
|
|
54
|
-
duplicate_item_ids:
|
|
54
|
+
duplicate_item_ids:DuplicateItemIdRow[];
|
|
55
55
|
/** Number of history streams scanned. */
|
|
56
|
-
history_streams_scanned:
|
|
56
|
+
history_streams_scanned:number;
|
|
57
57
|
/** History streams containing unresolved merge-conflict markers. */
|
|
58
|
-
history_conflict_marker_streams:
|
|
58
|
+
history_conflict_marker_streams:HistoryStreamIntegrityRow[];
|
|
59
59
|
/** History streams that cannot be read or contain an entry that is not a JSON object. */
|
|
60
|
-
history_unparseable_streams:
|
|
60
|
+
history_unparseable_streams:HistoryStreamIntegrityRow[];
|
|
61
61
|
/** Live items whose newest history operation is a delete (delete/modify merge resurrection candidates). */
|
|
62
|
-
resurrected_items:
|
|
62
|
+
resurrected_items:ResurrectedItemRow[];
|
|
63
63
|
/** Streams whose final entry is a non-empty history_repair reconciliation patch — the post-repair divergence signal (informational, not a failure). */
|
|
64
|
-
history_repair_reconciliations:
|
|
64
|
+
history_repair_reconciliations:number;
|
|
65
65
|
/** Number of configuration/schema files scanned. */
|
|
66
|
-
config_files_scanned:
|
|
66
|
+
config_files_scanned:number;
|
|
67
67
|
/** Configuration/schema files that cannot be parsed (silent-defaults fallback risk). */
|
|
68
|
-
unparseable_config_files:
|
|
68
|
+
unparseable_config_files:UnparseableConfigRow[];
|
|
69
69
|
}
|
|
70
70
|
/** Runtime schema context used to parse every physical item file exactly as the ordinary read path does. */
|
|
71
71
|
export interface StorageIntegrityItemParseOptions {
|
|
72
72
|
/** Active runtime schema, including unknown-field policy and custom field definitions. */
|
|
73
|
-
schema?:
|
|
73
|
+
schema?:ItemDocumentFormatOptions["schema"];
|
|
74
74
|
/** Item fields contributed by active extensions and therefore valid under a rejecting schema. */
|
|
75
|
-
extensionFieldNames?:
|
|
75
|
+
extensionFieldNames?:readonly string[];
|
|
76
76
|
}
|
|
77
77
|
/**
|
|
78
78
|
* Scan tracker storage for integrity failures the ordinary read path masks.
|
|
@@ -81,4 +81,4 @@ extensionFieldNames?: readonly string[];
|
|
|
81
81
|
* unreadable document that `pm get` would hard-error on while list-based
|
|
82
82
|
* commands silently skip it.
|
|
83
83
|
*/
|
|
84
|
-
export declare function scanStorageIntegrity(pmRoot:
|
|
84
|
+
export declare function scanStorageIntegrity(pmRoot:string,parsedItemIds:ReadonlySet<string>,typeToFolder:Record<string,string>,itemParseOptions?:StorageIntegrityItemParseOptions):Promise<StorageIntegrityScanResult>;
|
|
@@ -2,18 +2,18 @@ import { realpath } from "node:fs/promises";
|
|
|
2
2
|
/** Read-only result describing clone-local tracker artifacts present in Git's index. */
|
|
3
3
|
export interface TrackedRuntimeCacheScan {
|
|
4
4
|
/** Enclosing Git worktree root, omitted from serialized diagnostics. */
|
|
5
|
-
git_workspace_root:
|
|
5
|
+
git_workspace_root:string | null;
|
|
6
6
|
/** Tracker root relative to the Git worktree, or null when it is outside Git. */
|
|
7
|
-
tracker_relative_root:
|
|
7
|
+
tracker_relative_root:string | null;
|
|
8
8
|
/** Tracked runtime artifact paths relative to the Git worktree. */
|
|
9
|
-
tracked_paths:
|
|
9
|
+
tracked_paths:string[];
|
|
10
10
|
/** Number of tracked runtime artifacts. */
|
|
11
|
-
tracked_path_count:
|
|
11
|
+
tracked_path_count:number;
|
|
12
12
|
/** Exact index-only remediation command, or null when no artifacts are tracked. */
|
|
13
|
-
remediation_command:
|
|
13
|
+
remediation_command:string | null;
|
|
14
14
|
}
|
|
15
15
|
/** Resolves a tracker root while retaining a deterministic fallback for missing paths. */
|
|
16
|
-
export declare function resolveCanonicalTrackerRoot(pmRoot:
|
|
16
|
+
export declare function resolveCanonicalTrackerRoot(pmRoot:string,resolver?:typeof realpath):Promise<string>;
|
|
17
17
|
/**
|
|
18
18
|
* Find tracked files below every clone-local tracker directory.
|
|
19
19
|
*
|
|
@@ -21,4 +21,4 @@ export declare function resolveCanonicalTrackerRoot(pmRoot: string, resolver?: t
|
|
|
21
21
|
* unavailable Git executable yields an empty scan rather than turning project
|
|
22
22
|
* health into an infrastructure failure.
|
|
23
23
|
*/
|
|
24
|
-
export declare function scanTrackedRuntimeCache(pmRoot:
|
|
24
|
+
export declare function scanTrackedRuntimeCache(pmRoot:string):Promise<TrackedRuntimeCacheScan>;
|