@unbrained/pm-cli 2026.8.11 → 2026.8.13

package/dist/sdk/completion.js

@@ -4,11 +4,11 @@
  * Implements the pm completion command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="381bfd99-bd9b-5f8f-9783-65c2bf2cd810")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fca471b1-155a-5fc4-9aa9-d45e5f1315dd")}catch(e){}}();
 import { EXIT_CODE, PmCliError } from "./runtime-primitives.js";
 import { listPmCommandsForTier } from "./agent-capability-contracts.js";
 import { SCAFFOLD_CAPABILITIES } from "./extension/scaffold.js";
-import { AGGREGATE_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, toCompletionFlagString, } from "./cli-contracts.js";
+import { AGGREGATE_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, toCompletionFlagString, } from "./cli-contracts.js";
 import { BUILTIN_ITEM_TYPE_VALUES, STATUS_VALUES } from "../types/index.js";
 import { listGuideTopicIds } from "./guide-topics.js";
 const VALID_SHELLS = ["bash", "zsh", "fish"];
@@ -38,6 +38,7 @@ const DUPLICATES_FLAGS = toCompletionFlagString(DUPLICATES_FLAG_CONTRACTS);
 const GRAPH_FLAGS = toCompletionFlagString(GRAPH_FLAG_CONTRACTS);
 const GUIDE_FLAGS = toCompletionFlagString(GUIDE_FLAG_CONTRACTS);
 const SEARCH_FLAGS = toCompletionFlagString(SEARCH_FLAG_CONTRACTS);
+const STATS_FLAGS = toCompletionFlagString(STATS_FLAG_CONTRACTS);
 const HEALTH_FLAGS = toCompletionFlagString(HEALTH_FLAG_CONTRACTS);
 const INIT_FLAGS = toCompletionFlagString(INIT_FLAG_CONTRACTS);
 const CONTRACTS_FLAGS = toCompletionFlagString(CONTRACTS_FLAG_CONTRACTS);
@@ -623,7 +624,7 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         `      COMPREPLY=(${compgen(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index ${GRAPH_FLAGS}`)})`,
         "      ;;",
         "    test)",
-        `      COMPREPLY=(${compgen("--add --add-json --remove --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--add --add-json --remove --remove-index --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    test-all)",
         `      COMPREPLY=(${compgen("--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
@@ -677,7 +678,7 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         `      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    stats)",
-        `      COMPREPLY=(${compgen("--storage --metadata-coverage --field-utilization --by-assignee --by-tag --by-priority --tag-prefix --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen(STATS_FLAGS)})`,
         "      ;;",
         "    close|close-task)",
         `      COMPREPLY=(${compgen(CLOSE_MUTATION_FLAGS)})`,
@@ -788,6 +789,7 @@ _pm() {
     '--output-budget[Set the universal estimated-token ceiling]:tokens' \\
     '--output-format[Select the universal read encoding]:(toon json)' \\
     '--output-session[Carry cross-call read budget and served-item state]:state' \\
+    '--output-row-contract[Include row schema metadata in read output]' \\
     '--no-changed-fields[Omit changed_fields array from mutation output]' \\
     '--pm-path[Explicit tracker storage path for this command]:path:_files -/' \\
     '--path[Compatibility alias for --pm-path]:path:_files -/' \\
@@ -1304,13 +1306,14 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--to[Upper timestamp bound (ISO/date string or relative)]:date' \\
             '--limit[Max entries]:number' \\
             '--compact[Condensed activity projection]' \\
+            '--raw[Emit raw compact per-event activity output]' \\
             '--full[Show full activity entries]' \\
             '--provenance[Patch-free identity and agent provenance projection]' \\
             '--provenance-summary[Include bounded provenance completeness counts]' \\
             '*--harness[Filter by recorded or vocabulary-resolved harness]:harness' \\
             '*--agent-instance[Filter by privacy-safe agent instance]:instance' \\
             '*--provenance-filter[Filter by exact declared provenance value]:dimension=value' \\
-            '--stream[Emit line-delimited JSON rows]:mode' \\
+            '--stream[Emit line-delimited JSON rows (requires --json)]:mode' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
@@ -1336,6 +1339,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         stats)
           _arguments \\
+            '--include-empty[Include registered zero-count type and status buckets]' \\
             '--storage[Include aggregate history-stream storage metrics]' \\
             '--metadata-coverage[Include metadata coverage percentages overall and by type]' \\
             '--field-utilization[Include content-field utilization rates across all items]' \\
@@ -1460,6 +1464,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--add[Add linked test entry]:entry' \\
             '--add-json[Add linked test entry from JSON object/array]:json' \\
             '--remove[Remove linked test entry by command/path]:entry' \\
+            '--remove-index[Remove linked test entry by 1-based index]:index' \\
             '--list[List linked tests without mutating]' \\
             '--run[Run linked tests]' \\
             '--match[Run linked tests whose command/path contains substring]:substring' \\
@@ -1819,6 +1824,7 @@ complete -c pm -l output-limit -d 'Set the universal read row ceiling' -r
 complete -c pm -l output-budget -d 'Set the universal estimated-token ceiling' -r
 complete -c pm -l output-format -d 'Select the universal read encoding' -r -a 'toon json'
 complete -c pm -l output-session -d 'Carry cross-call read budget and served-item state' -r
+complete -c pm -l output-row-contract -d 'Include row schema metadata in read output'
 complete -c pm -l no-changed-fields -d 'Omit changed_fields array from mutation output'
 complete -c pm -l id-only -d 'Print only id and status for single-item mutation output'
 complete -c pm -l pm-path -d 'Explicit tracker storage path for this command' -r
@@ -2369,13 +2375,14 @@ complete -c pm -n '__fish_seen_subcommand_from activity' -l from -d 'Lower times
 complete -c pm -n '__fish_seen_subcommand_from activity' -l to -d 'Upper timestamp bound (ISO/date string or relative)' -r
 complete -c pm -n '__fish_seen_subcommand_from activity' -l limit -d 'Max activity entries' -r
 complete -c pm -n '__fish_seen_subcommand_from activity' -l compact -d 'Condensed activity projection'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l raw -d 'Emit raw compact per-event activity output'
 complete -c pm -n '__fish_seen_subcommand_from activity' -l full -d 'Show full activity entries'
 complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance -d 'Patch-free identity and agent provenance projection'
 complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance-summary -d 'Include bounded provenance completeness counts'
 complete -c pm -n '__fish_seen_subcommand_from activity' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
 complete -c pm -n '__fish_seen_subcommand_from activity' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
 complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance-filter -d 'Filter by exact declared provenance value' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l stream -d 'Emit line-delimited JSON rows'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l stream -d 'Emit line-delimited JSON rows (requires --json)'
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l action -d 'Filter schema by tool action' -r
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l command -d 'Scope output to one command (narrow-by-default)' -r
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l summary -d 'Return compact command intent summary'
@@ -2433,6 +2440,7 @@ complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l forc
 complete -c pm -n '__fish_seen_subcommand_from test' -l add -d 'Add linked test entry' -r
 complete -c pm -n '__fish_seen_subcommand_from test' -l add-json -d 'Add linked test entry from JSON object/array' -r
 complete -c pm -n '__fish_seen_subcommand_from test' -l remove -d 'Remove linked test entry' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l remove-index -d 'Remove linked test entry by 1-based index' -r
 complete -c pm -n '__fish_seen_subcommand_from test' -l list -d 'List linked tests without mutating'
 complete -c pm -n '__fish_seen_subcommand_from test' -l run -d 'Run linked tests'
 complete -c pm -n '__fish_seen_subcommand_from test' -l match -d 'Run linked tests whose command/path contains substring' -r
@@ -2489,6 +2497,7 @@ complete -c pm -n '__fish_seen_subcommand_from gc' -l dry-run -d 'Preview cleanu
 complete -c pm -n '__fish_seen_subcommand_from gc' -l scope -d 'Limit cleanup to index/embeddings/runtime/locks scopes' -r
 
 # stats flags
+complete -c pm -n '__fish_seen_subcommand_from stats' -l include-empty -d 'Include registered zero-count type and status buckets'
 complete -c pm -n '__fish_seen_subcommand_from stats' -l storage -d 'Include aggregate history-stream storage metrics'
 complete -c pm -n '__fish_seen_subcommand_from stats' -l metadata-coverage -d 'Include metadata coverage percentages overall and by type'
 complete -c pm -n '__fish_seen_subcommand_from stats' -l field-utilization -d 'Include content-field utilization rates across all items'
@@ -2753,4 +2762,4 @@ export function runCompletion(shell, itemTypes = [], tags = [], eagerTagExpansio
     };
 }
 //# sourceMappingURL=completion.js.map
-//# debugId=381bfd99-bd9b-5f8f-9783-65c2bf2cd810
+//# debugId=fca471b1-155a-5fc4-9aa9-d45e5f1315dd

package/dist/sdk/compose.d.ts

@@ -25,7 +25,7 @@
  * declarative (`composeExtension`) authoring styles live together. Both are
  * re-exported from the SDK barrel, so the public API is unchanged.
  */
-import type { AfterCommandHook, BeforeCommandHook, BeforeMutationHook, CommandDefinition, CommandOverride, ExtensionApi, ExtensionCapability, ExtensionManifest, ExtensionServiceName, Exporter, FlagDefinition, ImportExportRegistrationOptions, Importer, OnIndexHook, OnReadHook, OnWriteHook, OutputRendererFormat, ParserOverride, PreflightOverride, ScopedPreflightOverrideDefinition, RendererOverride, ScopedRendererOverrideDefinition, SchemaFieldDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SearchProviderDefinition, ServiceOverride, VectorStoreAdapterDefinition } from "../core/extensions/loader.js";
+import type { AfterCommandHook, BeforeCommandHook, BeforeMutationHook, CommandDefinition, CommandOverride, ExtensionApi, ExtensionCapability, ExtensionManifest, ExtensionServiceName, Exporter, FlagDefinition, ImportExportRegistrationOptions, Importer, OnIndexHook, OnReadHook, OnWriteHook, OutputRendererFormat, ParserOverride, PreflightOverride, ScopedPreflightOverrideDefinition, RendererOverride, ScopedRendererOverrideDefinition, SchemaFieldDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SearchProviderDefinition, ServiceOverride, VectorStoreAdapterDefinition, AssuranceMeasurementProviderDefinition } from "../core/extensions/loader.js";
 import type { ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
 import type { ProjectProfileRegistrationInput } from "../core/profile/profile-presets.js";
 import type { PmMaxVersionExceededMode } from "../core/extensions/extension-types.js";
@@ -152,6 +152,8 @@ export interface ExtensionBlueprint {
     searchProviders?: SearchProviderDefinition[];
     /** Vector store adapters registered via `api.registerVectorStoreAdapter(adapter)`. */
     vectorStoreAdapters?: VectorStoreAdapterDefinition[];
+    /** Assurance measurement providers registered via `api.registerAssuranceMeasurementProvider(provider)`. */
+    assuranceProviders?: AssuranceMeasurementProviderDefinition[];
     /** Importers registered via `api.registerImporter(name, importer, options?)`. */
     importers?: ExtensionBlueprintImporter[];
     /** Exporters registered via `api.registerExporter(name, exporter, options?)`. */

package/dist/sdk/compose.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="142a413a-35a6-5861-9063-0c196a176eaa")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fb438c6a-1927-54c3-98dd-dd7423df6722")}catch(e){}}();
 import { normalizeKnownExtensionCapability, resolveLegacyExtensionCapabilityAlias, } from "../core/extensions/extension-capability-aliases.js";
 import { normalizeCommandName } from "../core/extensions/extension-runtime-helpers.js";
 import { RESERVED_ITEM_FIELD_NAMES } from "../core/extensions/item-fields.js";
@@ -100,6 +100,9 @@ function registerBlueprintRetrievalSurfaces(api, blueprint) {
     for (const adapter of blueprint.vectorStoreAdapters ?? []) {
         api.registerVectorStoreAdapter(adapter);
     }
+    for (const provider of blueprint.assuranceProviders ?? []) {
+        api.registerAssuranceMeasurementProvider(provider);
+    }
     for (const entry of blueprint.importers ?? []) {
         api.registerImporter(entry.name, entry.importer, entry.options);
     }
@@ -281,6 +284,7 @@ export function mergeExtensionBlueprints(...blueprints) {
     assign("profiles", mergeArraySurface(blueprints.map((blueprint) => blueprint.profiles)));
     assign("searchProviders", mergeArraySurface(blueprints.map((blueprint) => blueprint.searchProviders)));
     assign("vectorStoreAdapters", mergeArraySurface(blueprints.map((blueprint) => blueprint.vectorStoreAdapters)));
+    assign("assuranceProviders", mergeArraySurface(blueprints.map((blueprint) => blueprint.assuranceProviders)));
     assign("importers", mergeArraySurface(blueprints.map((blueprint) => blueprint.importers)));
     assign("exporters", mergeArraySurface(blueprints.map((blueprint) => blueprint.exporters)));
     assign("hooks", mergeHookSurfaces(blueprints.map((blueprint) => blueprint.hooks)));
@@ -357,6 +361,7 @@ const BLUEPRINT_FIELD_CAPABILITIES = [
     ["preflights", "preflight"],
     ["searchProviders", "search"],
     ["vectorStoreAdapters", "search"],
+    ["assuranceProviders", "services"],
     ["importers", "importers"],
     ["exporters", "importers"],
 ];
@@ -509,6 +514,13 @@ function collectBlueprintRendererOwnership(renderers) {
         .sort((left, right) => left.format.localeCompare(right.format));
     return ownership.length > 0 ? { renderer_ownership: ownership } : {};
 }
+function collectBlueprintAssuranceProviders(providers) {
+    if (!providers || providers.length === 0)
+        return {};
+    return {
+        assurance_providers: sortUnique(providers.map((provider) => provider.id)),
+    };
+}
 function collectBlueprintSurfaceSummary(blueprint, importers, exporters) {
     return {
         item_types: sortUnique((blueprint.itemTypes ?? []).map((type) => type.name)),
@@ -526,6 +538,7 @@ function collectBlueprintSurfaceSummary(blueprint, importers, exporters) {
         exporters: sortUnique(exporters.map((entry) => normalizeCommandName(entry.name))),
         search_providers: sortUnique((blueprint.searchProviders ?? []).map((provider) => provider.name)),
         vector_store_adapters: sortUnique((blueprint.vectorStoreAdapters ?? []).map((adapter) => adapter.name)),
+        ...collectBlueprintAssuranceProviders(blueprint.assuranceProviders),
         parser_overrides: sortUnique(Object.keys(blueprint.parsers ?? {}).map((command) => normalizeCommandName(command))),
         service_overrides: sortUnique(Object.keys(blueprint.services ?? {}).map((service) => String(service).trim().toLowerCase())),
         renderer_overrides: sortUnique(Object.keys(blueprint.renderers ?? {}).map((format) => String(format).trim().toLowerCase())),
@@ -612,6 +625,7 @@ const BLUEPRINT_LINTABLE_SURFACE_FIELDS = [
     "profiles",
     "searchProviders",
     "vectorStoreAdapters",
+    "assuranceProviders",
     "importers",
     "exporters",
 ];
@@ -1057,4 +1071,4 @@ export function preflightExtension(blueprint, options = {}) {
     };
 }
 //# sourceMappingURL=compose.js.map
-//# debugId=142a413a-35a6-5861-9063-0c196a176eaa
+//# debugId=fb438c6a-1927-54c3-98dd-dd7423df6722

package/dist/sdk/context-intent-contracts.js

@@ -5,11 +5,11 @@
  * workspace configuration, and packages.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e48a306e-debb-5e66-ae9b-68bf17fa405f")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fa03d543-ff0d-5556-8558-9bed82838a58")}catch(e){}}();
 import { AsyncLocalStorage } from "node:async_hooks";
 import { attachOutputOmissionReceipt } from "./output-projection.js";
 import { encodeQueryCursor } from "./pagination.js";
-import { applyReadOutputDimensions } from "./read-output-contracts.js";
+import { applyReadOutputDimensions, stabilizeReadOutputReceiptEstimates, } from "./read-output-contracts.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 /** Built-in intent projections shared by CLI, SDK, MCP, and package authors. */
@@ -590,14 +590,55 @@ function collapseContinuationMetadata(options, result) {
     };
     return projected;
 }
+/** Return whether one projected value is a mutable output record. */
+function isOutputRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Read one numeric fixed-point estimate from an optional receipt. */
+function receiptEstimate(value, field) {
+    if (!isOutputRecord(value))
+        return undefined;
+    return typeof value[field] === "number" ? value[field] : undefined;
+}
+/** Stabilize every token receipt after suppressing discovery-only metadata. */
+function stabilizeSuppressedRowContractReceipts(result, options) {
+    let finalized = result;
+    for (let iteration = 0; iteration < 8; iteration += 1) {
+        const previousContextEstimate = receiptEstimate(finalized.context_intent, "estimated_tokens");
+        const previousReadEstimate = receiptEstimate(finalized.read_output, "estimated_tokens");
+        const previousSessionEstimate = receiptEstimate(finalized.read_session, "spent_this_call_tokens");
+        if (isOutputRecord(finalized.context_intent)) {
+            updateContextIntentEstimate(finalized, finalized.context_intent);
+        }
+        finalized = stabilizeReadOutputReceiptEstimates(finalized, options);
+        if (receiptEstimate(finalized.context_intent, "estimated_tokens") ===
+            previousContextEstimate &&
+            receiptEstimate(finalized.read_output, "estimated_tokens") ===
+                previousReadEstimate &&
+            receiptEstimate(finalized.read_session, "spent_this_call_tokens") ===
+                previousSessionEstimate) {
+            break;
+        }
+    }
+    return finalized;
+}
 /** Attach universal row, omission, and optional intent-budget contracts in rendering order. */
 export function attachReadOutputContracts(command, options, result) {
     const disclosedResult = attachOutputOmissionReceipt(command, result);
-    return typeof disclosedResult === "object" &&
+    const projected = typeof disclosedResult === "object" &&
         disclosedResult !== null &&
         !Array.isArray(disclosedResult)
         ? applyReadOutputDimensions(command ?? "", options, collapseContinuationMetadata(options, attachContextIntentReceipt(command ?? "", options, disclosedResult)))
         : disclosedResult;
+    if (options.outputRowContract === true ||
+        options.output_row_contract === true ||
+        typeof projected !== "object" ||
+        projected === null ||
+        Array.isArray(projected) ||
+        !Object.hasOwn(projected, "row_contract")) {
+        return projected;
+    }
+    return stabilizeSuppressedRowContractReceipts(Object.fromEntries(Object.entries(projected).filter(([key]) => key !== "row_contract")), options);
 }
 //# sourceMappingURL=context-intent-contracts.js.map
-//# debugId=e48a306e-debb-5e66-ae9b-68bf17fa405f
+//# debugId=fa03d543-ff0d-5556-8558-9bed82838a58

package/dist/sdk/context-signal-store.js

@@ -6,7 +6,8 @@
  * history, while stale, absent, or corrupt snapshots rebuild transparently.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2a0f64cf-f6a4-5304-921d-c83b98d3a31f")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3d0a558b-6a01-5bca-a2f7-21766be6d67c")}catch(e){}}();
+import { isFileAbsentError } from "../core/fs/fs-utils.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -187,7 +188,7 @@ export class JsonFileContextSignalStoreAdapter {
             return JSON.parse(await fs.readFile(this.filePath, "utf8"));
         }
         catch (error) {
-            if (isRecord(error) && error.code === "ENOENT") {
+            if (isRecord(error) && isFileAbsentError(error)) {
                 return null;
             }
             throw error;
@@ -310,4 +311,4 @@ export async function readWorkspaceContextSignals(items, options) {
     return store.readOrRebuild(items, { ...options, sourceCursor, source });
 }
 //# sourceMappingURL=context-signal-store.js.map
-//# debugId=2a0f64cf-f6a4-5304-921d-c83b98d3a31f
+//# debugId=3d0a558b-6a01-5bca-a2f7-21766be6d67c

package/dist/sdk/core.d.ts

@@ -6,6 +6,7 @@
 export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, canonicalDocument, classifyItemFormatVersion, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, isPmCliExpectedError, normalizeItemFormatVersion, normalizeItemId, normalizeStatusInput, nowIso, runAction, serializeItemDocument, aggregate, append, claim, claimNext, close, comments, context, copy, create, deleteItem, deps, docs, files, filesDiscover, focus, get, graph, learnings, list, next, notes, release, restore, search, update, type AggregateOptions, type AggregateResult, type AggregateRow, type AssuranceActionInput, type AssuranceActionResult, type AppendCommandOptions, type AppendResult, type ClaimNextOptions, type ClaimResult, type CloseResult, type CommentsCommandOptions, type CommentsResult, type ContextOptions, type ContextResult, type CopyResult, type CreateResult, type Dependency, type DeleteResult, type DepsCommandOptions, type DepsResult, type DocsCommandOptions, type DocsResult, type FilesCommandOptions, type FilesDiscoverOptions, type FilesDiscoverResult, type FilesResult, type FocusResult, type GetOptions, type GetResult, type ItemFormatVersionScanEntry, type ItemFormatVersionScanResult, type ItemFormatVersionStatus, type LearningsCommandOptions, type LearningsResult, type ListOptions, type ListResult, type NextOptions, type NextResult, type NotesCommandOptions, type NotesResult, type PmActionInput, type PmActionName, type PmActionOptions, type PmClientOptions, type ReleaseResult, type RestoreResult, type SearchOptions, type SearchResult, type UpdateResult, } from "./runtime.js";
 export * from "./core-governance.js";
 export * from "./agent-session-context.js";
+export { isAlreadyClaimedError } from "./lifecycle/claim.js";
 export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
 export { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
 export type { PmReadOutputBudgetExceeded, PmReadOutputDimension, PmReadOutputLegacyAlias, PmReadOutputOptions, PmReadOutputReceipt, PmReadOutputResult, PmReadOutputResultFor, PmReadOutputSurface, PmReadOutputSurfaceContract, } from "./read-output-contracts.js";

package/dist/sdk/core.js

@@ -4,11 +4,12 @@
  * Provides the stable item lifecycle client and universal project data types.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c2f56389-6238-5b5c-add8-00296fe401b6")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2e0a2422-64c7-5ad3-867c-04479171fa27")}catch(e){}}();
 export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, canonicalDocument, classifyItemFormatVersion, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, isPmCliExpectedError, normalizeItemFormatVersion, normalizeItemId, normalizeStatusInput, nowIso, runAction, serializeItemDocument, aggregate, append, claim, claimNext, close, comments, context, copy, create, deleteItem, deps, docs, files, filesDiscover, focus, get, graph, learnings, list, next, notes, release, restore, search, update, } from "./runtime.js";
 export * from "./core-governance.js";
 export * from "./agent-session-context.js";
+export { isAlreadyClaimedError } from "./lifecycle/claim.js";
 export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
 export { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
 //# sourceMappingURL=core.js.map
-//# debugId=c2f56389-6238-5b5c-add8-00296fe401b6
+//# debugId=2e0a2422-64c7-5ad3-867c-04479171fa27

package/dist/sdk/extension/install-runtime.js

@@ -4,12 +4,12 @@
  * Provides cross-platform extension copy safety and owner-bound install locks.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9c598dc3-e766-595d-80f1-6d55e1667d6b")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="263602a2-c000-5df7-80d2-6f095985496f")}catch(e){}}();
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-import { pathExists } from "../../core/fs/fs-utils.js";
+import { isFileAbsentError, pathExists } from "../../core/fs/fs-utils.js";
 import { isPathWithinDirectory } from "../../core/fs/path-utils.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
@@ -173,7 +173,7 @@ const readExtensionInstallLockOwnerToken = async (lockPath) => {
         ownerContents = await fs.readFile(path.join(lockPath, "owner.json"), "utf8");
     }
     catch (error) {
-        if (!isErrnoCode(error, "ENOENT"))
+        if (!isFileAbsentError(error))
             throw error;
         return null;
     }
@@ -308,4 +308,4 @@ export const withExtensionInstallLock = async (settingsRoot, destinationDirector
     }
 };
 //# sourceMappingURL=install-runtime.js.map
-//# debugId=9c598dc3-e766-595d-80f1-6d55e1667d6b
+//# debugId=263602a2-c000-5df7-80d2-6f095985496f

package/dist/sdk/extension/managed-state.js

@@ -4,7 +4,8 @@
  * Implements extension package-management support for Managed State.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5d60cd29-09fb-515c-acaa-b5a2b136d8ab")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="159d7bbd-1d2a-503d-b3ce-f32dcc6f6547")}catch(e){}}();
+import { isFileMissingError } from "../../core/fs/fs-utils.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -204,7 +205,7 @@ export async function readManagedExtensionState(extensionsRoot) {
         if (typeof error === "object" &&
             error !== null &&
             "code" in error &&
-            error.code === "ENOENT") {
+            isFileMissingError(error)) {
             return {
                 path: statePath,
                 state: fallback,
@@ -249,4 +250,4 @@ export async function persistManagedContributionInventory(extensionsRoot, state,
     return updated;
 }
 //# sourceMappingURL=managed-state.js.map
-//# debugId=5d60cd29-09fb-515c-acaa-b5a2b136d8ab
+//# debugId=159d7bbd-1d2a-503d-b3ce-f32dcc6f6547

package/dist/sdk/extension-contracts.d.ts

@@ -19,7 +19,7 @@ export type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];
 /** Canonical extension governance policy modes. */
 export declare const EXTENSION_POLICY_MODES: readonly ["off", "warn", "enforce"];
 /** Canonical extension registration surfaces governed by policy. */
-export declare const EXTENSION_POLICY_SURFACES: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.beforemutation", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.relationshipkinds", "schema.migrations", "schema.profiles", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore"];
+export declare const EXTENSION_POLICY_SURFACES: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.beforemutation", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.relationshipkinds", "schema.migrations", "schema.profiles", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore", "services.assuranceprovider"];
 /** Canonical extension trust modes shared by authoring and runtime consumers. */
 export declare const EXTENSION_TRUST_MODES: readonly ["off", "warn", "enforce"];
 /** Canonical extension sandbox profiles shared by authoring and runtime consumers. */

package/dist/sdk/flag-invocation-contracts.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3b72f4a5-9e0b-5f8e-8ee9-e45cd83d6f92")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0e2d29be-ff70-5e69-9bba-bef5ecd05fa1")}catch(e){}}();
 const FLAG_DESCRIPTIONS = Object.freeze({
     "--body": "Set the item body.",
     "--body-file": "Read the item body from a file.",
@@ -71,7 +71,8 @@ function flagTakesValue(contract) {
         contract.value_type === "number" ||
         contract.list === true ||
         contract.repeatable === true;
-    const inferredBoolean = contract.flag === "--stdin" ||
+    const inferredBoolean = contract.value_type === "boolean" ||
+        contract.flag === "--stdin" ||
         contract.flag === "--stdin-json" ||
         BOOLEAN_FLAG_PREFIXES.some((prefix) => contract.flag.startsWith(prefix));
     return explicitlyValued || !inferredBoolean;
@@ -88,9 +89,7 @@ export function enrichCliFlagInvocationContract(command, contract) {
         description,
         takes_value: takesValue,
         value_required: takesValue,
-        ...(takesValue
-            ? { value_name: contract.value_name ?? "value" }
-            : {}),
+        ...(takesValue ? { value_name: contract.value_name ?? "value" } : {}),
         value_type: takesValue ? (contract.value_type ?? "string") : "boolean",
         required: contract.required === true,
         repeatable: contract.repeatable === true || contract.list === true,
@@ -107,4 +106,4 @@ export function enrichCliFlagInvocationContracts(command, contracts) {
     return contracts.map((contract) => enrichCliFlagInvocationContract(command, contract));
 }
 //# sourceMappingURL=flag-invocation-contracts.js.map
-//# debugId=3b72f4a5-9e0b-5f8e-8ee9-e45cd83d6f92
+//# debugId=0e2d29be-ff70-5e69-9bba-bef5ecd05fa1

package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module sdk/generated-error-code-catalog-part-1
+ *
+ * Generated by scripts/generate-error-code-catalog.mjs. Do not edit manually.
+ */
+import type { PmErrorCodeContract } from "../error-code-catalog.js";
+/** Generated partition 1 of the exhaustive error-code catalog. */
+export declare const PM_ERROR_CODE_CATALOG_PART_1: PmErrorCodeContract[];