@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,9 +1,9 @@
|
|
|
1
1
|
/** Current serialized assurance registry format. */
|
|
2
|
-
export declare const ASSURANCE_DOCUMENT_VERSION:
|
|
2
|
+
export declare const ASSURANCE_DOCUMENT_VERSION:1;
|
|
3
3
|
/** Supported lifecycle points that can evaluate a gate. */
|
|
4
|
-
export declare const ASSURANCE_GATE_TRIGGERS:
|
|
4
|
+
export declare const ASSURANCE_GATE_TRIGGERS:readonly ["pre-commit","pre-push","pre-merge","ci","pre-release","post-release","scheduled","on-claim","on-close"];
|
|
5
5
|
/** Supported discriminants for built-in, delegated, and derived measurements. */
|
|
6
|
-
export declare const ASSURANCE_MEASUREMENT_SOURCE_KINDS:
|
|
6
|
+
export declare const ASSURANCE_MEASUREMENT_SOURCE_KINDS:readonly ["items","dependency_kind","prose_edge_gap","graph","validate","health","history","links","provider","derived"];
|
|
7
7
|
/** Gate lifecycle trigger. */
|
|
8
8
|
export type AssuranceGateTrigger = (typeof ASSURANCE_GATE_TRIGGERS)[number];
|
|
9
9
|
/** Assertion enforcement strength. */
|
|
@@ -17,444 +17,444 @@ export type AssuranceValue = number | string[];
|
|
|
17
17
|
/** Minimal dependency row used by built-in relationship measurements. */
|
|
18
18
|
export interface AssuranceDependencyRecord {
|
|
19
19
|
/** Target item id. */
|
|
20
|
-
id:
|
|
20
|
+
id:string;
|
|
21
21
|
/** Typed relationship kind. */
|
|
22
|
-
kind:
|
|
22
|
+
kind:string;
|
|
23
23
|
/** Provenance channel that created or justified the edge. */
|
|
24
|
-
source_kind?:
|
|
24
|
+
source_kind?:string;
|
|
25
25
|
}
|
|
26
26
|
/** Minimal item projection consumed by built-in measurement sources. */
|
|
27
27
|
export interface AssuranceItemRecord {
|
|
28
28
|
/** Stable item id. */
|
|
29
|
-
id:
|
|
29
|
+
id:string;
|
|
30
30
|
/** Lifecycle status. */
|
|
31
|
-
status:
|
|
31
|
+
status:string;
|
|
32
32
|
/** Item type. */
|
|
33
|
-
type:
|
|
33
|
+
type:string;
|
|
34
34
|
/** Optional tags. */
|
|
35
|
-
tags?:
|
|
35
|
+
tags?:string[];
|
|
36
36
|
/** Optional priority. */
|
|
37
|
-
priority?:
|
|
37
|
+
priority?:string | number;
|
|
38
38
|
/** Typed relationships. */
|
|
39
|
-
dependencies?:
|
|
39
|
+
dependencies?:AssuranceDependencyRecord[];
|
|
40
40
|
/** Linked files. */
|
|
41
|
-
files?:
|
|
41
|
+
files?:object[];
|
|
42
42
|
/** Linked tests. */
|
|
43
|
-
tests?:
|
|
43
|
+
tests?:object[];
|
|
44
44
|
/** Linked docs. */
|
|
45
|
-
docs?:
|
|
45
|
+
docs?:object[];
|
|
46
46
|
/** Extension-owned metadata remains filterable. */
|
|
47
|
-
[key:
|
|
47
|
+
[key:string]:unknown;
|
|
48
48
|
}
|
|
49
49
|
/** Minimal immutable-history row consumed by history measurements. */
|
|
50
50
|
export interface AssuranceHistoryRecord {
|
|
51
51
|
/** Mutation operation. */
|
|
52
|
-
op:
|
|
52
|
+
op:string;
|
|
53
53
|
/** Mutation author. */
|
|
54
|
-
author:
|
|
54
|
+
author:string;
|
|
55
55
|
/** Optional detected harness. */
|
|
56
|
-
agent_harness?:
|
|
56
|
+
agent_harness?:string;
|
|
57
57
|
/** Optional detected model. */
|
|
58
|
-
agent_model?:
|
|
58
|
+
agent_model?:string;
|
|
59
59
|
/** Extensible history metadata. */
|
|
60
|
-
[key:
|
|
60
|
+
[key:string]:unknown;
|
|
61
61
|
}
|
|
62
62
|
/** Item-population measurement source. */
|
|
63
63
|
export interface AssuranceItemsSource {
|
|
64
64
|
/** Source discriminant. */
|
|
65
|
-
kind:
|
|
65
|
+
kind:"items";
|
|
66
66
|
/** Allowed statuses. */
|
|
67
|
-
statuses?:
|
|
67
|
+
statuses?:string[];
|
|
68
68
|
/** Allowed item types. */
|
|
69
|
-
types?:
|
|
69
|
+
types?:string[];
|
|
70
70
|
/** Tags that must all be present. */
|
|
71
|
-
tags?:
|
|
71
|
+
tags?:string[];
|
|
72
72
|
/** Optional metadata field. */
|
|
73
|
-
field?:
|
|
73
|
+
field?:string;
|
|
74
74
|
/** Required exact value for field. */
|
|
75
|
-
equals?:
|
|
75
|
+
equals?:string | number | boolean | null;
|
|
76
76
|
/** Presence predicate for the selected field. */
|
|
77
|
-
state?:
|
|
77
|
+
state?:"present" | "missing";
|
|
78
78
|
}
|
|
79
79
|
/** Typed relationship-count source. */
|
|
80
80
|
export interface AssuranceDependencyKindSource {
|
|
81
81
|
/** Source discriminant. */
|
|
82
|
-
kind:
|
|
82
|
+
kind:"dependency_kind";
|
|
83
83
|
/** Relationship kind to count. */
|
|
84
|
-
dependency_kind:
|
|
84
|
+
dependency_kind:string;
|
|
85
85
|
/** Require an exact dependency provenance channel. */
|
|
86
|
-
source_kind?:
|
|
86
|
+
source_kind?:string;
|
|
87
87
|
/** Require a dependency provenance channel with this prefix. */
|
|
88
|
-
source_kind_prefix?:
|
|
88
|
+
source_kind_prefix?:string;
|
|
89
89
|
/** Require dependency provenance to be present or missing. */
|
|
90
|
-
source_kind_state?:
|
|
90
|
+
source_kind_state?:"present" | "missing";
|
|
91
91
|
}
|
|
92
92
|
/** Evidence-backed exemption from prose-to-edge parity. */
|
|
93
93
|
export interface AssuranceProseEdgeExemption {
|
|
94
94
|
/** Holder whose prose contains the reference. */
|
|
95
|
-
holder_id:
|
|
95
|
+
holder_id:string;
|
|
96
96
|
/** Optional referenced item; omission exempts every matching pair on the holder. */
|
|
97
|
-
target_id?:
|
|
97
|
+
target_id?:string;
|
|
98
98
|
/** Optional literal that must occur in the same prose segment as the reference. */
|
|
99
|
-
text_contains?:
|
|
99
|
+
text_contains?:string;
|
|
100
100
|
/** Reviewable explanation for why no typed edge should exist. */
|
|
101
|
-
reason:
|
|
101
|
+
reason:string;
|
|
102
102
|
}
|
|
103
103
|
/** Prose-reference parity source evaluated directly over authoritative item rows. */
|
|
104
104
|
export interface AssuranceProseEdgeGapSource {
|
|
105
105
|
/** Source discriminant. */
|
|
106
|
-
kind:
|
|
106
|
+
kind:"prose_edge_gap";
|
|
107
107
|
/** Explicit false-positive ledger; every row requires a reason. */
|
|
108
|
-
exemptions?:
|
|
108
|
+
exemptions?:AssuranceProseEdgeExemption[];
|
|
109
109
|
/** Maximum diagnostic contributors retained after the counts are computed. */
|
|
110
|
-
sample_limit?:
|
|
110
|
+
sample_limit?:number;
|
|
111
111
|
}
|
|
112
112
|
/** Graph-analytics source delegated to a host adapter. */
|
|
113
113
|
export interface AssuranceGraphSource {
|
|
114
114
|
/** Source discriminant. */
|
|
115
|
-
kind:
|
|
115
|
+
kind:"graph";
|
|
116
116
|
/** Graph analytic to execute. */
|
|
117
|
-
operation:
|
|
117
|
+
operation:string;
|
|
118
118
|
/** Numeric or labelled-set field to select. */
|
|
119
|
-
field:
|
|
119
|
+
field:string;
|
|
120
120
|
/** Optional analytic arguments. */
|
|
121
|
-
parameters?:
|
|
121
|
+
parameters?:Record<string,string | number | boolean>;
|
|
122
122
|
}
|
|
123
123
|
/** Validator source delegated to a host adapter. */
|
|
124
124
|
export interface AssuranceValidateSource {
|
|
125
125
|
/** Source discriminant. */
|
|
126
|
-
kind:
|
|
126
|
+
kind:"validate";
|
|
127
127
|
/** Stable validator check id. */
|
|
128
|
-
check:
|
|
128
|
+
check:string;
|
|
129
129
|
/** Numeric field within the check result. */
|
|
130
|
-
field:
|
|
130
|
+
field:string;
|
|
131
131
|
}
|
|
132
132
|
/** Health-check source delegated to a host adapter. */
|
|
133
133
|
export interface AssuranceHealthSource {
|
|
134
134
|
/** Source discriminant. */
|
|
135
|
-
kind:
|
|
135
|
+
kind:"health";
|
|
136
136
|
/** Stable health check id. */
|
|
137
|
-
check:
|
|
137
|
+
check:string;
|
|
138
138
|
/** Numeric field within the check result. */
|
|
139
|
-
field:
|
|
139
|
+
field:string;
|
|
140
140
|
}
|
|
141
141
|
/** Immutable-history population source. */
|
|
142
142
|
export interface AssuranceHistorySource {
|
|
143
143
|
/** Source discriminant. */
|
|
144
|
-
kind:
|
|
144
|
+
kind:"history";
|
|
145
145
|
/** Optional operation filter. */
|
|
146
|
-
op?:
|
|
146
|
+
op?:string;
|
|
147
147
|
/** Optional author filter. */
|
|
148
|
-
author?:
|
|
148
|
+
author?:string;
|
|
149
149
|
/** Optional harness filter. */
|
|
150
|
-
harness?:
|
|
150
|
+
harness?:string;
|
|
151
151
|
/** Optional model filter. */
|
|
152
|
-
model?:
|
|
152
|
+
model?:string;
|
|
153
153
|
}
|
|
154
154
|
/** Linked evidence population source. */
|
|
155
155
|
export interface AssuranceLinksSource {
|
|
156
156
|
/** Source discriminant. */
|
|
157
|
-
kind:
|
|
157
|
+
kind:"links";
|
|
158
158
|
/** Evidence collection to inspect. */
|
|
159
|
-
link:
|
|
159
|
+
link:"files" | "tests" | "docs";
|
|
160
160
|
/** Count items with or without at least one link. */
|
|
161
|
-
state:
|
|
161
|
+
state:"present" | "missing";
|
|
162
162
|
}
|
|
163
163
|
/** Extension- or host-contributed measurement source. */
|
|
164
164
|
export interface AssuranceProviderSource {
|
|
165
165
|
/** Source discriminant. */
|
|
166
|
-
kind:
|
|
166
|
+
kind:"provider";
|
|
167
167
|
/** Stable provider id. */
|
|
168
|
-
provider:
|
|
168
|
+
provider:string;
|
|
169
169
|
/** Provider-owned measurement key. */
|
|
170
|
-
key:
|
|
170
|
+
key:string;
|
|
171
171
|
/** Provider-owned JSON-compatible parameters. */
|
|
172
|
-
parameters?:
|
|
172
|
+
parameters?:Record<string,string | number | boolean | null>;
|
|
173
173
|
}
|
|
174
174
|
/** Reference to another measurement inside a derived expression. */
|
|
175
175
|
export interface AssuranceMeasurementReference {
|
|
176
176
|
/** Referenced measurement id. */
|
|
177
|
-
measurement:
|
|
177
|
+
measurement:string;
|
|
178
178
|
}
|
|
179
179
|
/** Literal numeric term inside a derived expression. */
|
|
180
180
|
export interface AssuranceLiteralExpression {
|
|
181
181
|
/** Literal number. */
|
|
182
|
-
literal:
|
|
182
|
+
literal:number;
|
|
183
183
|
}
|
|
184
184
|
/** Arithmetic expression over measurement references and literals. */
|
|
185
185
|
export interface AssuranceArithmeticExpression {
|
|
186
186
|
/** Deterministic arithmetic operation. */
|
|
187
|
-
operator:
|
|
187
|
+
operator:"add" | "subtract" | "multiply" | "divide" | "min" | "max";
|
|
188
188
|
/** Ordered operands. */
|
|
189
|
-
operands:
|
|
189
|
+
operands:AssuranceDerivedExpression[];
|
|
190
190
|
}
|
|
191
191
|
/** Recursive derived-measurement expression. */
|
|
192
192
|
export type AssuranceDerivedExpression = AssuranceMeasurementReference | AssuranceLiteralExpression | AssuranceArithmeticExpression;
|
|
193
193
|
/** Derived arithmetic source. */
|
|
194
194
|
export interface AssuranceDerivedSource {
|
|
195
195
|
/** Source discriminant. */
|
|
196
|
-
kind:
|
|
196
|
+
kind:"derived";
|
|
197
197
|
/** Arithmetic expression. */
|
|
198
|
-
expression:
|
|
198
|
+
expression:AssuranceDerivedExpression;
|
|
199
199
|
}
|
|
200
200
|
/** Complete measurement source vocabulary. */
|
|
201
201
|
export type AssuranceMeasurementSource = AssuranceItemsSource | AssuranceDependencyKindSource | AssuranceProseEdgeGapSource | AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceHistorySource | AssuranceLinksSource | AssuranceProviderSource | AssuranceDerivedSource;
|
|
202
202
|
/** Persisted measurement declaration. */
|
|
203
203
|
export interface AssuranceMeasurementDefinition {
|
|
204
204
|
/** Stable registry id. */
|
|
205
|
-
id:
|
|
205
|
+
id:string;
|
|
206
206
|
/** Optional intent description. */
|
|
207
|
-
description?:
|
|
207
|
+
description?:string;
|
|
208
208
|
/** Measurement source. */
|
|
209
|
-
source:
|
|
209
|
+
source:AssuranceMeasurementSource;
|
|
210
210
|
/** Maximum abstract compute units accepted for one evaluation. */
|
|
211
|
-
max_cost?:
|
|
211
|
+
max_cost?:number;
|
|
212
212
|
}
|
|
213
213
|
/** Explicit population scope asserted by a bound. */
|
|
214
214
|
export type AssuranceScope = {
|
|
215
|
-
kind:
|
|
215
|
+
kind:"all";
|
|
216
216
|
} | {
|
|
217
|
-
kind:
|
|
217
|
+
kind:"active";
|
|
218
218
|
} | {
|
|
219
219
|
/** Scope discriminant. */
|
|
220
|
-
kind:
|
|
220
|
+
kind:"filter";
|
|
221
221
|
/** Saved measurement whose population defines the scope. */
|
|
222
|
-
measurement_id:
|
|
222
|
+
measurement_id:string;
|
|
223
223
|
};
|
|
224
224
|
/** One assertion negative-control case. */
|
|
225
225
|
export interface AssuranceNegativeControlCase {
|
|
226
226
|
/** Synthetic observation. */
|
|
227
|
-
observed:
|
|
227
|
+
observed:AssuranceValue;
|
|
228
228
|
/** Expected comparator result. */
|
|
229
|
-
expected:
|
|
229
|
+
expected:"pass" | "fail";
|
|
230
230
|
}
|
|
231
231
|
/** Required negative-control suite proving a bound can both pass and fail. */
|
|
232
232
|
export interface AssuranceNegativeControl {
|
|
233
233
|
/** Synthetic comparator cases. */
|
|
234
|
-
cases:
|
|
234
|
+
cases:AssuranceNegativeControlCase[];
|
|
235
235
|
}
|
|
236
236
|
/** Persisted assertion declaration. Exactly one polarity field is valid. */
|
|
237
237
|
export interface AssuranceAssertionDefinition {
|
|
238
238
|
/** Stable registry id. */
|
|
239
|
-
id:
|
|
239
|
+
id:string;
|
|
240
240
|
/** Registry key of the observation constrained by this guarantee. */
|
|
241
|
-
measurement_id:
|
|
241
|
+
measurement_id:string;
|
|
242
242
|
/** pm item that owns this guarantee. */
|
|
243
|
-
owner_item_id:
|
|
243
|
+
owner_item_id:string;
|
|
244
244
|
/** Explicit asserted population scope. */
|
|
245
|
-
scope:
|
|
245
|
+
scope:AssuranceScope;
|
|
246
246
|
/** Maximum permitted value. */
|
|
247
|
-
ceiling?:
|
|
247
|
+
ceiling?:number;
|
|
248
248
|
/** Minimum permitted value. */
|
|
249
|
-
floor?:
|
|
249
|
+
floor?:number;
|
|
250
250
|
/** Exact permitted scalar or labelled set. */
|
|
251
|
-
equals?:
|
|
251
|
+
equals?:AssuranceValue;
|
|
252
252
|
/** Require numeric zero. */
|
|
253
|
-
zero?:
|
|
253
|
+
zero?:true;
|
|
254
254
|
/** Require no decrease from the numeric baseline. */
|
|
255
|
-
monotone_nondecreasing?:
|
|
255
|
+
monotone_nondecreasing?:number;
|
|
256
256
|
/** Require no increase from the numeric baseline. */
|
|
257
|
-
monotone_nonincreasing?:
|
|
257
|
+
monotone_nonincreasing?:number;
|
|
258
258
|
/** Require the observed labelled set to be a subset. */
|
|
259
|
-
subset_of?:
|
|
259
|
+
subset_of?:string[];
|
|
260
260
|
/** Behavior after owner termination. */
|
|
261
|
-
lifetime?:
|
|
261
|
+
lifetime?:AssuranceLifetime;
|
|
262
262
|
/** Required explanation when lifetime retires. */
|
|
263
|
-
retire_reason?:
|
|
263
|
+
retire_reason?:string;
|
|
264
264
|
/** Enforcement strength. */
|
|
265
|
-
enforcement:
|
|
265
|
+
enforcement:AssuranceEnforcement;
|
|
266
266
|
/** Required proof that the comparator distinguishes good and bad values. */
|
|
267
|
-
negative_control:
|
|
267
|
+
negative_control:AssuranceNegativeControl;
|
|
268
268
|
/** Decision item authorizing a loosening update. */
|
|
269
|
-
authorization_decision?:
|
|
269
|
+
authorization_decision?:string;
|
|
270
270
|
}
|
|
271
271
|
/** Persisted gate declaration. */
|
|
272
272
|
export interface AssuranceGateDefinition {
|
|
273
273
|
/** Stable registry id. */
|
|
274
|
-
id:
|
|
274
|
+
id:string;
|
|
275
275
|
/** Assertion ids evaluated by this gate. */
|
|
276
|
-
assertion_ids:
|
|
276
|
+
assertion_ids:string[];
|
|
277
277
|
/** Lifecycle triggers allowed to run it. */
|
|
278
|
-
triggers:
|
|
278
|
+
triggers:AssuranceGateTrigger[];
|
|
279
279
|
/** Optional description. */
|
|
280
|
-
description?:
|
|
280
|
+
description?:string;
|
|
281
281
|
/** Explicit provider allow-list and trigger-specific execution policy. */
|
|
282
|
-
provider_policy?:
|
|
282
|
+
provider_policy?:{
|
|
283
283
|
/** Provider ids this gate may invoke. An empty set refuses every provider. */
|
|
284
|
-
allowed_providers:
|
|
284
|
+
allowed_providers:string[];
|
|
285
285
|
/** Trigger rules; an omitted rule refuses provider execution for that trigger. */
|
|
286
|
-
triggers:
|
|
286
|
+
triggers:Partial<Record<AssuranceGateTrigger,{
|
|
287
287
|
/** Highest provider cost class allowed at this trigger. */
|
|
288
|
-
max_cost_class:
|
|
288
|
+
max_cost_class:AssuranceProviderCostClass;
|
|
289
289
|
/** Whether network-declaring providers may run. */
|
|
290
|
-
allow_network:
|
|
290
|
+
allow_network:boolean;
|
|
291
291
|
}>>;
|
|
292
292
|
};
|
|
293
293
|
}
|
|
294
294
|
/** Complete persisted assurance registry. */
|
|
295
295
|
export interface AssuranceDocument {
|
|
296
296
|
/** Storage format version. */
|
|
297
|
-
version:
|
|
297
|
+
version:typeof ASSURANCE_DOCUMENT_VERSION;
|
|
298
298
|
/** Measurement declarations. */
|
|
299
|
-
measurements:
|
|
299
|
+
measurements:AssuranceMeasurementDefinition[];
|
|
300
300
|
/** Assertion declarations. */
|
|
301
|
-
assertions:
|
|
301
|
+
assertions:AssuranceAssertionDefinition[];
|
|
302
302
|
/** Gate declarations. */
|
|
303
|
-
gates:
|
|
303
|
+
gates:AssuranceGateDefinition[];
|
|
304
304
|
}
|
|
305
305
|
/** Atomic set of ordinary declarations used by presets and accepted proposals. */
|
|
306
306
|
export interface AssuranceDeclarationBundle {
|
|
307
307
|
/** Measurement declarations to create without overwriting divergent ids. */
|
|
308
|
-
measurements:
|
|
308
|
+
measurements:AssuranceMeasurementDefinition[];
|
|
309
309
|
/** Assertion declarations to create without overwriting divergent ids. */
|
|
310
|
-
assertions:
|
|
310
|
+
assertions:AssuranceAssertionDefinition[];
|
|
311
311
|
/** Gate declarations to create without overwriting divergent ids. */
|
|
312
|
-
gates:
|
|
312
|
+
gates:AssuranceGateDefinition[];
|
|
313
313
|
}
|
|
314
314
|
/** Audited receipt for one atomic assurance bundle application. */
|
|
315
315
|
export interface AssuranceBundleMutationReceipt {
|
|
316
316
|
/** Whether persistence changed. */
|
|
317
|
-
changed:
|
|
317
|
+
changed:boolean;
|
|
318
318
|
/** Stable ids created by the bundle. */
|
|
319
|
-
created_ids:
|
|
319
|
+
created_ids:string[];
|
|
320
320
|
/** Stable ids already present with byte-equivalent declarations. */
|
|
321
|
-
unchanged_ids:
|
|
321
|
+
unchanged_ids:string[];
|
|
322
322
|
}
|
|
323
323
|
/** Host adapter result for graph, validate, health, or provider sources. */
|
|
324
324
|
export interface AssuranceExternalMeasurementResult {
|
|
325
325
|
/** Observed value. */
|
|
326
|
-
value:
|
|
326
|
+
value:AssuranceValue;
|
|
327
327
|
/** Population denominator. */
|
|
328
|
-
population_size:
|
|
328
|
+
population_size:number;
|
|
329
329
|
/** Abstract compute units charged by the adapter. */
|
|
330
|
-
cost:
|
|
330
|
+
cost:number;
|
|
331
331
|
/** Optional contributors that moved the value. */
|
|
332
|
-
contributors?:
|
|
332
|
+
contributors?:string[];
|
|
333
333
|
/** Optional exact named sub-populations within the observed value. */
|
|
334
|
-
partitions?:
|
|
334
|
+
partitions?:Readonly<Record<string,number>>;
|
|
335
335
|
}
|
|
336
336
|
/** SDK evaluation inputs supplied by a host. */
|
|
337
337
|
export interface AssuranceEvaluationContext {
|
|
338
338
|
/** Commit, tree, snapshot, or workspace identity being judged. */
|
|
339
|
-
tree_id:
|
|
339
|
+
tree_id:string;
|
|
340
340
|
/** Item rows for built-in sources. */
|
|
341
|
-
items:
|
|
341
|
+
items:AssuranceItemRecord[];
|
|
342
342
|
/** Immutable history rows for built-in history sources. */
|
|
343
|
-
history:
|
|
343
|
+
history:AssuranceHistoryRecord[];
|
|
344
344
|
/** Status ids that make an assertion owner terminal. */
|
|
345
|
-
terminal_statuses?:
|
|
345
|
+
terminal_statuses?:string[];
|
|
346
346
|
/** Host-declared capabilities for provider-policy enforcement. */
|
|
347
|
-
provider_capabilities?:
|
|
348
|
-
cost_class:
|
|
349
|
-
network:
|
|
347
|
+
provider_capabilities?:Readonly<Record<string,{
|
|
348
|
+
cost_class:AssuranceProviderCostClass;
|
|
349
|
+
network:boolean;
|
|
350
350
|
}>>;
|
|
351
351
|
/** External source adapter. Implementations must enforce an appropriate timeout. */
|
|
352
|
-
external:
|
|
352
|
+
external:(source:AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceProviderSource) => Promise<AssuranceExternalMeasurementResult>;
|
|
353
353
|
}
|
|
354
354
|
/** Compute receipt for one measurement. */
|
|
355
355
|
export interface AssuranceMeasurementCost {
|
|
356
356
|
/** Total abstract units. */
|
|
357
|
-
units:
|
|
357
|
+
units:number;
|
|
358
358
|
/** Item rows scanned. */
|
|
359
|
-
items_scanned:
|
|
359
|
+
items_scanned:number;
|
|
360
360
|
/** History rows scanned. */
|
|
361
|
-
history_entries:
|
|
361
|
+
history_entries:number;
|
|
362
362
|
/** External provider calls. */
|
|
363
|
-
provider_calls:
|
|
363
|
+
provider_calls:number;
|
|
364
364
|
/** Wall-clock duration. */
|
|
365
|
-
duration_ms:
|
|
365
|
+
duration_ms:number;
|
|
366
366
|
}
|
|
367
367
|
/** Evaluated measurement receipt. */
|
|
368
368
|
export interface AssuranceMeasurementResult {
|
|
369
369
|
/** Measurement id. */
|
|
370
|
-
id:
|
|
370
|
+
id:string;
|
|
371
371
|
/** Stable fingerprint of the exact declaration that produced this result. */
|
|
372
|
-
definition_fingerprint:
|
|
372
|
+
definition_fingerprint:string;
|
|
373
373
|
/** Observed value. */
|
|
374
|
-
value:
|
|
374
|
+
value:AssuranceValue;
|
|
375
375
|
/** Population denominator. */
|
|
376
|
-
population_size:
|
|
376
|
+
population_size:number;
|
|
377
377
|
/** Compute receipt. */
|
|
378
|
-
cost:
|
|
378
|
+
cost:AssuranceMeasurementCost;
|
|
379
379
|
/** Optional contributors. */
|
|
380
|
-
contributors:
|
|
380
|
+
contributors:string[];
|
|
381
381
|
/** Optional exact named sub-populations within the observed value. */
|
|
382
|
-
partitions?:
|
|
382
|
+
partitions?:Readonly<Record<string,number>>;
|
|
383
383
|
}
|
|
384
384
|
/** Structured assertion bound. */
|
|
385
385
|
export interface AssuranceBound {
|
|
386
386
|
/** Comparator applied to the observed value and declared bound. */
|
|
387
|
-
polarity:
|
|
387
|
+
polarity:"ceiling" | "floor" | "equals" | "zero" | "monotone_nondecreasing" | "monotone_nonincreasing" | "subset_of";
|
|
388
388
|
/** Declared bound value. */
|
|
389
|
-
value:
|
|
389
|
+
value:AssuranceValue;
|
|
390
390
|
}
|
|
391
391
|
/** One assertion row inside a gate verdict. */
|
|
392
392
|
export interface AssuranceAssertionVerdict {
|
|
393
393
|
/** Stable guarantee key that produced this evaluation row. */
|
|
394
|
-
assertion_id:
|
|
394
|
+
assertion_id:string;
|
|
395
395
|
/** Stable observation key used to obtain the evaluated value. */
|
|
396
|
-
measurement_id:
|
|
396
|
+
measurement_id:string;
|
|
397
397
|
/** Stable fingerprint of the measurement declaration used for this verdict. */
|
|
398
|
-
measurement_definition_fingerprint:
|
|
398
|
+
measurement_definition_fingerprint:string;
|
|
399
399
|
/** Explicit scope. */
|
|
400
|
-
scope:
|
|
400
|
+
scope:AssuranceScope;
|
|
401
401
|
/** Population denominator. */
|
|
402
|
-
population_size:
|
|
402
|
+
population_size:number;
|
|
403
403
|
/** Numeric or labelled-set value captured for the judged population. */
|
|
404
|
-
observed:
|
|
404
|
+
observed:AssuranceValue;
|
|
405
405
|
/** Structured bound. */
|
|
406
|
-
bound:
|
|
406
|
+
bound:AssuranceBound;
|
|
407
407
|
/** Signed numeric distance when applicable. */
|
|
408
|
-
distance:
|
|
408
|
+
distance:number | null;
|
|
409
409
|
/** Assertion result. */
|
|
410
|
-
verdict:
|
|
410
|
+
verdict:"pass" | "fail" | "retired";
|
|
411
411
|
/** Enforcement strength. */
|
|
412
|
-
enforcement:
|
|
412
|
+
enforcement:AssuranceEnforcement;
|
|
413
413
|
/** Whether negative controls proved the comparator. */
|
|
414
|
-
negative_control_proven:
|
|
414
|
+
negative_control_proven:boolean;
|
|
415
415
|
/** Compute receipt. */
|
|
416
|
-
cost:
|
|
416
|
+
cost:AssuranceMeasurementCost;
|
|
417
417
|
/** Optional contributors. */
|
|
418
|
-
contributors:
|
|
418
|
+
contributors:string[];
|
|
419
419
|
/** Optional exact named sub-populations within the observed value. */
|
|
420
|
-
partitions?:
|
|
420
|
+
partitions?:Readonly<Record<string,number>>;
|
|
421
421
|
}
|
|
422
422
|
/** Complete gate verdict shared by every presentation and execution surface. */
|
|
423
423
|
export interface AssuranceGateVerdict {
|
|
424
424
|
/** Stable lifecycle-policy key that produced this verdict. */
|
|
425
|
-
gate_id:
|
|
425
|
+
gate_id:string;
|
|
426
426
|
/** Judged tree identity. */
|
|
427
|
-
tree_id:
|
|
427
|
+
tree_id:string;
|
|
428
428
|
/** Evaluation trigger. */
|
|
429
|
-
trigger:
|
|
429
|
+
trigger:AssuranceGateTrigger;
|
|
430
430
|
/** Whether history persistence was intentionally skipped. */
|
|
431
|
-
dry_run:
|
|
431
|
+
dry_run:boolean;
|
|
432
432
|
/** ISO timestamp. */
|
|
433
|
-
evaluated_at:
|
|
433
|
+
evaluated_at:string;
|
|
434
434
|
/** Overall result. */
|
|
435
|
-
verdict:
|
|
435
|
+
verdict:"pass" | "warn" | "block";
|
|
436
436
|
/** Stable process exit code. */
|
|
437
|
-
exit_code:
|
|
437
|
+
exit_code:0 | 1;
|
|
438
438
|
/** Per-assertion receipts. */
|
|
439
|
-
assertions:
|
|
439
|
+
assertions:AssuranceAssertionVerdict[];
|
|
440
440
|
/** Total assertions evaluated before any transport projection or compaction. */
|
|
441
|
-
assertions_total:
|
|
441
|
+
assertions_total:number;
|
|
442
442
|
/** Stable selector for iterating assertion evidence across transports. */
|
|
443
|
-
row_contract:
|
|
444
|
-
row_keys:
|
|
445
|
-
jq_selector:
|
|
443
|
+
row_contract:{
|
|
444
|
+
row_keys:["assertions"];
|
|
445
|
+
jq_selector:".assertions[]";
|
|
446
446
|
};
|
|
447
447
|
/** Aggregate compute receipt. */
|
|
448
|
-
cost:
|
|
448
|
+
cost:AssuranceMeasurementCost;
|
|
449
449
|
}
|
|
450
450
|
/** Mutation attribution accepted by registry and verdict writes. */
|
|
451
451
|
export interface AssuranceMutationOptions {
|
|
452
452
|
/** Explicit author override; normal callers omit it for harness detection. */
|
|
453
|
-
author?:
|
|
453
|
+
author?:string;
|
|
454
454
|
/** Optional audited rationale. */
|
|
455
|
-
message?:
|
|
455
|
+
message?:string;
|
|
456
456
|
/** Decision item ids the caller has verified as authorization. */
|
|
457
|
-
authorized_decision_ids?:
|
|
457
|
+
authorized_decision_ids?:string[];
|
|
458
458
|
}
|
|
459
459
|
/** Declaration collection kind. */
|
|
460
460
|
export type AssuranceDeclarationKind = "measurement" | "assertion" | "gate";
|
|
@@ -463,58 +463,58 @@ export type AssuranceDeclaration = AssuranceMeasurementDefinition | AssuranceAss
|
|
|
463
463
|
/** Registry mutation receipt. */
|
|
464
464
|
export interface AssuranceMutationReceipt {
|
|
465
465
|
/** Whether serialized state changed. */
|
|
466
|
-
changed:
|
|
466
|
+
changed:boolean;
|
|
467
467
|
/** Mutation outcome. */
|
|
468
|
-
action:
|
|
468
|
+
action:"created" | "updated" | "removed";
|
|
469
469
|
/** Declaration kind. */
|
|
470
|
-
kind:
|
|
470
|
+
kind:AssuranceDeclarationKind;
|
|
471
471
|
/** Declaration id. */
|
|
472
|
-
id:
|
|
472
|
+
id:string;
|
|
473
473
|
}
|
|
474
474
|
/** Return true when an assertion update weakens scope, bound, lifetime, or enforcement. */
|
|
475
|
-
export declare function assuranceAssertionUpdateIsLoosening(before:
|
|
475
|
+
export declare function assuranceAssertionUpdateIsLoosening(before:AssuranceAssertionDefinition,after:AssuranceAssertionDefinition):boolean;
|
|
476
476
|
/** Validate and return one measurement declaration. */
|
|
477
|
-
export declare function validateMeasurementDefinition(definition:
|
|
477
|
+
export declare function validateMeasurementDefinition(definition:AssuranceMeasurementDefinition):AssuranceMeasurementDefinition;
|
|
478
478
|
/** Validate and return one assertion declaration. */
|
|
479
|
-
export declare function validateAssertionDefinition(definition:
|
|
479
|
+
export declare function validateAssertionDefinition(definition:AssuranceAssertionDefinition):AssuranceAssertionDefinition;
|
|
480
480
|
/** Validate and return one gate declaration. */
|
|
481
|
-
export declare function validateGateDefinition(definition:
|
|
481
|
+
export declare function validateGateDefinition(definition:AssuranceGateDefinition):AssuranceGateDefinition;
|
|
482
482
|
/** Validate registry references, uniqueness, and declaration-local contracts. */
|
|
483
|
-
export declare function validateAssuranceDocument(document:
|
|
483
|
+
export declare function validateAssuranceDocument(document:AssuranceDocument):AssuranceDocument;
|
|
484
484
|
/** Create an empty, valid assurance registry. */
|
|
485
|
-
export declare function createEmptyAssuranceDocument():
|
|
485
|
+
export declare function createEmptyAssuranceDocument():AssuranceDocument;
|
|
486
486
|
/** Evaluate one measurement with cycle detection and a complete cost receipt. */
|
|
487
|
-
export declare function evaluateMeasurement(definition:
|
|
487
|
+
export declare function evaluateMeasurement(definition:AssuranceMeasurementDefinition,context:AssuranceEvaluationContext,definitions?:AssuranceMeasurementDefinition[]):Promise<AssuranceMeasurementResult>;
|
|
488
488
|
/** Evaluate one assertion against a precomputed measurement receipt. */
|
|
489
|
-
export declare function evaluateAssuranceAssertion(definition:
|
|
490
|
-
/** Whether the owning item is terminal. */ owner_terminal?:
|
|
491
|
-
}):
|
|
489
|
+
export declare function evaluateAssuranceAssertion(definition:AssuranceAssertionDefinition,measurement:AssuranceMeasurementResult,options?:{
|
|
490
|
+
/** Whether the owning item is terminal. */ owner_terminal?:boolean;
|
|
491
|
+
}):AssuranceAssertionVerdict;
|
|
492
492
|
/** Evaluate a named gate into one presentation-independent verdict document. */
|
|
493
|
-
export declare function evaluateAssuranceGate(gateId:
|
|
494
|
-
/** Trigger being evaluated. */ trigger:
|
|
495
|
-
/** Skip persistence in the caller. */ dry_run?:
|
|
496
|
-
}):
|
|
493
|
+
export declare function evaluateAssuranceGate(gateId:string,document:AssuranceDocument,context:AssuranceEvaluationContext,options:{
|
|
494
|
+
/** Trigger being evaluated. */ trigger:AssuranceGateTrigger;
|
|
495
|
+
/** Skip persistence in the caller. */ dry_run?:boolean;
|
|
496
|
+
}):Promise<AssuranceGateVerdict>;
|
|
497
497
|
/** Read all declarations of one kind with a stable row selector receipt. */
|
|
498
|
-
export declare function listAssuranceDeclarations(pmRoot:
|
|
499
|
-
items:
|
|
500
|
-
count:
|
|
501
|
-
row_contract:
|
|
502
|
-
row_keys:
|
|
503
|
-
jq_selector:
|
|
498
|
+
export declare function listAssuranceDeclarations(pmRoot:string,kind:AssuranceDeclarationKind):Promise<{
|
|
499
|
+
items:AssuranceDeclaration[];
|
|
500
|
+
count:number;
|
|
501
|
+
row_contract:{
|
|
502
|
+
row_keys:["items"];
|
|
503
|
+
jq_selector:".items[]";
|
|
504
504
|
};
|
|
505
505
|
}>;
|
|
506
506
|
/** Read one named declaration or fail loudly. */
|
|
507
|
-
export declare function getAssuranceDeclaration(pmRoot:
|
|
507
|
+
export declare function getAssuranceDeclaration(pmRoot:string,kind:AssuranceDeclarationKind,id:string):Promise<AssuranceDeclaration>;
|
|
508
508
|
/** Create or update one declaration through audited singleton persistence. */
|
|
509
|
-
export declare function putAssuranceDeclaration(pmRoot:
|
|
509
|
+
export declare function putAssuranceDeclaration(pmRoot:string,kind:AssuranceDeclarationKind,definition:AssuranceDeclaration,options?:AssuranceMutationOptions):Promise<AssuranceMutationReceipt>;
|
|
510
510
|
/** Apply a declaration bundle atomically, idempotently, and without replacing divergent ids. */
|
|
511
|
-
export declare function putAssuranceDeclarationBundle(pmRoot:
|
|
511
|
+
export declare function putAssuranceDeclarationBundle(pmRoot:string,bundle:AssuranceDeclarationBundle,options?:AssuranceMutationOptions):Promise<AssuranceBundleMutationReceipt>;
|
|
512
512
|
/** Remove an unreferenced declaration through audited singleton persistence. */
|
|
513
|
-
export declare function removeAssuranceDeclaration(pmRoot:
|
|
513
|
+
export declare function removeAssuranceDeclaration(pmRoot:string,kind:AssuranceDeclarationKind,id:string,options?:AssuranceMutationOptions):Promise<AssuranceMutationReceipt>;
|
|
514
514
|
/** Append one immutable gate verdict without changing registry state. */
|
|
515
|
-
export declare function recordAssuranceVerdict(pmRoot:
|
|
515
|
+
export declare function recordAssuranceVerdict(pmRoot:string,verdict:AssuranceGateVerdict,options?:AssuranceMutationOptions):Promise<void>;
|
|
516
516
|
/** Query durable assurance verdicts from the verified workspace stream. */
|
|
517
|
-
export declare function listAssuranceVerdicts(pmRoot:
|
|
518
|
-
/** Optional gate filter. */ gate_id?:
|
|
519
|
-
/** Maximum newest matching verdicts returned. */ limit?:
|
|
520
|
-
}):
|
|
517
|
+
export declare function listAssuranceVerdicts(pmRoot:string,options?:{
|
|
518
|
+
/** Optional gate filter. */ gate_id?:string;
|
|
519
|
+
/** Maximum newest matching verdicts returned. */ limit?:number;
|
|
520
|
+
}):Promise<AssuranceGateVerdict[]>;
|