@unbrained/pm-cli 2026.8.11 → 2026.8.13

package/dist/sdk/query/get.js

@@ -4,7 +4,7 @@
  * Implements the SDK-owned item query shared by every surface.
  */
 
-!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]="f68f4074-51ba-5065-8cca-fe16acd48927")}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]="89176e36-40ea-5ec2-b291-d1cf042c4140")}catch(e){}}();
 import { pathExists, getActiveExtensionRegistrations, toItemRecord, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, TYPE_TO_FOLDER, PmCliError, buildItemNotFoundError, listAllItemMetadataLight, locateItem, readLocatedItem, getHistoryPath, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { readHistoryEntries } from "../history-read.js";
 import { recordContextUsageTouches } from "../context-usage.js";
@@ -13,6 +13,7 @@ import { buildItemSchedule, } from "../item-schedule.js";
 import { getItemAt } from "../history-read.js";
 import { parseIntegerLimit } from "./parsers.js";
 import { runList } from "./list.js";
+import { registerOutputMaterialFieldGroups } from "../output-projection.js";
 const GET_DEPTH_VALUES = ["brief", "standard", "deep"];
 const AUTOMATIC_CHILD_ROLLUP_TYPES = new Set([
     "epic",
@@ -38,6 +39,21 @@ function itemCollectionCounts(item) {
     ]));
     return lengths;
 }
+function itemMaterialFieldGroups(item, body) {
+    const collectionCounts = itemCollectionCounts(item);
+    return [
+        ...(body.length > 0 ? ["body"] : []),
+        ...Object.entries(collectionCounts).flatMap(([name, count]) => count > 0 ? [name] : []),
+        ...(collectionCounts.files + collectionCounts.tests + collectionCounts.docs > 0
+            ? ["linked"]
+            : []),
+        "children",
+        ...(typeof item.assignee === "string" && item.assignee.trim().length > 0
+            ? ["claim_state"]
+            : []),
+        ...(buildItemSchedule(item) ? ["schedule"] : []),
+    ];
+}
 /** Decide whether a normal read should pay for a workspace-wide child projection. */
 function shouldAutoIncludeGetChildren(itemType) {
     const normalizedType = itemType.trim().toLowerCase();
@@ -414,6 +430,7 @@ export async function runGet(id, global, options = {}) {
             // Derived usage feedback must never make the source-of-truth read fail.
         }
     }
+    registerOutputMaterialFieldGroups(result, itemMaterialFieldGroups(context.metadata, context.body));
     return result;
 }
 /** Public contract for test-only get command policy helpers. */
@@ -421,4 +438,4 @@ export const _testOnlyGetCommand = {
     shouldAutoIncludeGetChildren,
 };
 //# sourceMappingURL=get.js.map
-//# debugId=f68f4074-51ba-5065-8cca-fe16acd48927
+//# debugId=89176e36-40ea-5ec2-b291-d1cf042c4140

package/dist/sdk/read-output-contracts.d.ts

@@ -19,6 +19,8 @@ export interface PmReadOutputOptions {
     outputFormat?: "json" | "toon";
     /** Caller-carried cross-call budget and served-fact state. */
     outputSession?: string | PmReadOutputSessionState;
+    /** Include row selector and encoding discovery metadata. */
+    outputRowContract?: boolean;
 }
 /** Compatibility spelling retained for a command-specific output control. */
 export interface PmReadOutputLegacyAlias {
@@ -130,7 +132,7 @@ export type PmReadOutputResultFor<Result, Options> = "outputBudget" extends keyo
 /** Canonical CLI flags that opt a read invocation into universal output shaping. */
 export declare const PM_READ_OUTPUT_OPTION_FLAGS: readonly string[];
 /** Canonical control that composes the four per-call dimensions across reads. */
-export declare const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS: readonly ["--output-session"];
+export declare const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS: readonly ["--output-session", "--output-row-contract"];
 /** Universal output contract for every built-in read surface. */
 export declare const PM_READ_OUTPUT_SURFACE_CONTRACTS: readonly PmReadOutputSurfaceContract[];
 /** Resolve a command or list/context alias to its canonical read-output surface. */
@@ -139,6 +141,8 @@ export declare function resolveReadOutputSurface(command: string): PmReadOutputS
 export declare function validateReadOutputOptions(command: string, options: Record<string, unknown>): void;
 /** Resolve canonical and compatibility controls into the universal dimension set. */
 export declare function resolveReadOutputDimensions(command: string, options: Record<string, unknown>): PmResolvedReadOutputDimensions | undefined;
+/** Recompute read and optional session receipts after a final envelope projection. */
+export declare function stabilizeReadOutputReceiptEstimates(result: Record<string, unknown>, options: Record<string, unknown>): Record<string, unknown>;
 /** Apply universal field, row, and token bounds and attach an exact receipt. */
 export declare function applyReadOutputDimensions<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result): PmReadOutputResult<Result>;
 /** Narrow a universal read result to its budget-omission branch. */

package/dist/sdk/read-output-contracts.js

@@ -5,7 +5,7 @@
  * surface without coupling package authors to command-specific option names.
  */
 
-!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]="819ac44d-0add-581c-90e8-ac6e8247b04b")}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]="0ab0c72c-cac0-5670-93d1-7a446f8a2301")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { compactReadOutputToBudget, updateReadOutputReceiptEstimate, } from "./read-output-budget.js";
@@ -58,6 +58,7 @@ export const PM_READ_OUTPUT_OPTION_FLAGS = Object.freeze(PM_READ_OUTPUT_DIMENSIO
 /** Canonical control that composes the four per-call dimensions across reads. */
 export const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS = Object.freeze([
     "--output-session",
+    "--output-row-contract",
 ]);
 const LEGACY_FLAGS_BY_COMMAND = {
     list: {
@@ -216,6 +217,8 @@ const CANONICAL_OPTION_KEYS = [
     "output_format",
     "outputSession",
     "output_session",
+    "outputRowContract",
+    "output_row_contract",
 ];
 const HYBRID_READ_MUTATION_KEYS = {
     comments: ["add", "body", "stdin", "file", "edit", "delete"],
@@ -580,6 +583,18 @@ function attachReadOutputSessionContracts(result, state, receipt) {
     }
     return withSession;
 }
+/** Recompute read and optional session receipts after a final envelope projection. */
+export function stabilizeReadOutputReceiptEstimates(result, options) {
+    if (!isRecord(result.read_output))
+        return result;
+    const receipt = result.read_output;
+    const session = parseReadOutputSession(options.outputSession ?? options.output_session);
+    if (session === undefined) {
+        updateReadOutputReceiptEstimate(result, receipt);
+        return result;
+    }
+    return attachReadOutputSessionContracts(result, session, receipt);
+}
 /** Apply field, amount, and repeat projections to every declared row path. */
 function projectReadOutputRows(result, resolved, session) {
     let projected = { ...result };
@@ -695,4 +710,4 @@ export function resolveReadOutputEncoding(command, options) {
         : undefined;
 }
 //# sourceMappingURL=read-output-contracts.js.map
-//# debugId=819ac44d-0add-581c-90e8-ac6e8247b04b
+//# debugId=0ab0c72c-cac0-5670-93d1-7a446f8a2301

package/dist/sdk/read-output-session.d.ts

@@ -46,6 +46,8 @@ export interface PmReadOutputSessionReceipt {
     seen_before_count: number;
     /** Number of newly delivered item facts retained in this envelope. */
     new_item_count: number;
+    /** Newly delivered identities omitted from next_state after its capacity filled. */
+    seen_item_overflow_count?: number;
     /** Number of repeated item rows replaced by references. */
     suppressed_repeat_count: number;
     /** Stable reference syntax used by suppressed rows. */

package/dist/sdk/read-output-session.js

@@ -5,7 +5,7 @@
  * budgets and resolvable references to item facts served by earlier reads.
  */
 
-!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]="04ad0d11-1fb7-5eb4-8ff0-d81a7090c4ff")}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]="642f6dec-c0b2-5377-a401-dfa4f8ef6a2a")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { mapReadOutputRows, readOutputRowCollections, } from "./read-output-rows.js";
@@ -141,9 +141,13 @@ export function applyReadOutputSessionReferences(result, state) {
 /** Attach a fixed-point session receipt and return the exact charged tokens. */
 export function attachReadOutputSessionReceipt(result, state) {
     const { deliveredIds, suppressedRepeatCount } = summarizeReadOutputSessionRows(result);
-    const nextSeen = [
-        ...new Set([...state.seen_item_ids, ...deliveredIds]),
-    ].sort();
+    const alreadySeen = new Set(state.seen_item_ids);
+    const newlySeen = [...deliveredIds]
+        .filter((id) => !alreadySeen.has(id))
+        .sort();
+    const retainedNewIds = newlySeen.slice(0, PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS - state.seen_item_ids.length);
+    const nextSeen = [...state.seen_item_ids, ...retainedNewIds].sort();
+    const seenItemOverflowCount = newlySeen.length - retainedNewIds.length;
     const receipt = {
         contract_version: 1,
         id: state.id,
@@ -158,6 +162,9 @@ export function attachReadOutputSessionReceipt(result, state) {
         exhausted: false,
         seen_before_count: state.seen_item_ids.length,
         new_item_count: deliveredIds.size,
+        ...(seenItemOverflowCount === 0
+            ? {}
+            : { seen_item_overflow_count: seenItemOverflowCount }),
         suppressed_repeat_count: suppressedRepeatCount,
         reference_format: "session:<session-id>:<item-id>",
         restore_reference_with: "pm get <item-id> --brief",
@@ -197,4 +204,4 @@ export function readOutputSessionRemainingTokens(state) {
     return Math.max(0, state.token_budget - state.spent_tokens);
 }
 //# sourceMappingURL=read-output-session.js.map
-//# debugId=04ad0d11-1fb7-5eb4-8ff0-d81a7090c4ff
+//# debugId=642f6dec-c0b2-5377-a401-dfa4f8ef6a2a

package/dist/sdk/relationship-history.js

@@ -5,13 +5,13 @@
  * optimistic concurrency, deterministic replay, snapshots, and cursor pages.
  */
 
-!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]="c53bb1b7-12b9-5370-a85b-cdd8bef57936")}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]="bb5dfa6f-b60f-55f2-ae17-3dbcaaff1b47")}catch(e){}}();
 import { createQueryFingerprint, decodeQueryCursorState, paginateQueryRows, } from "./pagination.js";
 import { constants } from "node:fs";
 import { lstat, mkdir, open } from "node:fs/promises";
 import path from "node:path";
 import { acquireLock } from "../core/lock/lock.js";
-import { writeFileAtomic } from "../core/fs/fs-utils.js";
+import { isFileMissingError, writeFileAtomic } from "../core/fs/fs-utils.js";
 import { stableStringify } from "../core/shared/serialization.js";
 import { RelationshipGraph, createRelationshipKindRegistry, } from "./relationships.js";
 function requiredText(value, field) {
@@ -298,7 +298,7 @@ async function resolveRelationshipEventStorePath(pmRoot, relativePath = "relatio
                 throw new TypeError("Relationship event path must not contain symbolic links");
         }
         catch (error) {
-            if (error.code === "ENOENT")
+            if (isFileMissingError(error))
                 break;
             throw error;
         }
@@ -314,7 +314,7 @@ async function loadRelationshipEventLog(target, nodes, registry) {
         raw = await handle.readFile("utf8");
     }
     catch (error) {
-        if (error.code === "ENOENT")
+        if (isFileMissingError(error))
             return { log, raw: "" };
         throw error;
     }
@@ -517,4 +517,4 @@ export class RelationshipEventStore {
     }
 }
 //# sourceMappingURL=relationship-history.js.map
-//# debugId=c53bb1b7-12b9-5370-a85b-cdd8bef57936
+//# debugId=bb5dfa6f-b60f-55f2-ae17-3dbcaaff1b47

package/dist/sdk/runtime-primitives.d.ts

@@ -16,10 +16,10 @@ export { resolveRegisteredSearchProvider, resolveRegisteredVectorStoreAdapter, }
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
 export { type HistoryDiffValueEntry, computeHistoryDiff, patchPathToChangedField, } from "../core/history/history-diff.js";
 export { enforceHistoryStreamPolicyForItem, enforceHistoryStreamPolicyForItems, } from "../core/history/history-stream-policy.js";
-export { appendHistoryEntry, createHistoryEntry, hashDocument, hashEmptyDocument, } from "../core/history/history.js";
+export { appendHistoryEntry, CURRENT_HISTORY_ITEM_HASH_VERSION, createHistoryEntry, hashDocument, hashDocumentForVersion, hashEmptyDocument, SUPPORTED_HISTORY_ITEM_HASH_VERSIONS, type HistoryItemHashVersion, } from "../core/history/history.js";
 export { readHistoryEntries } from "../core/history/read.js";
 export { appendWorkspaceAuditEvent, appendWorkspaceHistoryChange, getWorkspaceHistoryPath, mutateWorkspaceJsonWithHistory, WORKSPACE_HISTORY_ID, writeWorkspaceJsonWithHistory, type WorkspaceAuditEventOptions, type WorkspaceHistoryChange, type WorkspaceJsonMutation, type WorkspaceJsonMutationOptions, type WorkspaceJsonWriteOptions, } from "../core/history/workspace-history.js";
-export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, } from "../core/history/replay.js";
+export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, verifyHistoryChainWithVersion, } from "../core/history/replay.js";
 export { resolveBodyFileContent } from "../core/io/body-file.js";
 export { generateItemId, normalizeItemId, normalizeRawItemId, } from "../core/item/id.js";
 export { canonicalDocument, normalizeItemMetadata, parseItemDocument, serializeItemDocument, } from "../core/item/item-format.js";
@@ -72,7 +72,7 @@ export { splitCommaList } from "../core/shared/split-comma-list.js";
 export { compareTimestampStrings, nowIso, resolveIsoOrRelative, } from "../core/shared/time.js";
 export { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
 export { type CachedDocumentCandidate, listAllDocumentCandidatesCached, } from "../core/store/item-metadata-cache.js";
-export { buildItemNotFoundError, createMutationGuardSdk, deleteItem, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
+export { buildItemNotFoundError, createMutationGuardSdk, deleteItem, listAllItemMetadata, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
 export { isTerminalPlanMode, shouldCompletePlanOnClose, } from "../core/item/plan-lifecycle.js";
 export { getHistoryPath, getItemPath, getSettingsPath, resolveImplicitPmRoot, resolvePmRoot, } from "../core/store/paths.js";
 export { persistSelectedItemFormat, readSettings, readSettingsWithMetadata, writeSettings, } from "../core/store/settings.js";

package/dist/sdk/runtime-primitives.js

@@ -7,7 +7,7 @@
  * prefer the typed operations exported by the main SDK barrel.
  */
 
-!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]="16d4bbae-03b7-5316-8e26-77f33affdcf6")}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]="78779372-1987-54d0-9ae4-775b52641a26")}catch(e){}}();
 export { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, } from "../core/checkpoint/mutation-checkpoint.js";
 export { flattenFlagListValue, resolveFlagValueKind, } from "../core/extensions/flag-value-types.js";
 export { createUnknownSubcommandError, } from "./agent/subcommand-recovery.js";
@@ -18,10 +18,10 @@ export { resolveRegisteredSearchProvider, resolveRegisteredVectorStoreAdapter, }
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
 export { computeHistoryDiff, patchPathToChangedField, } from "../core/history/history-diff.js";
 export { enforceHistoryStreamPolicyForItem, enforceHistoryStreamPolicyForItems, } from "../core/history/history-stream-policy.js";
-export { appendHistoryEntry, createHistoryEntry, hashDocument, hashEmptyDocument, } from "../core/history/history.js";
+export { appendHistoryEntry, CURRENT_HISTORY_ITEM_HASH_VERSION, createHistoryEntry, hashDocument, hashDocumentForVersion, hashEmptyDocument, SUPPORTED_HISTORY_ITEM_HASH_VERSIONS, } from "../core/history/history.js";
 export { readHistoryEntries } from "../core/history/read.js";
 export { appendWorkspaceAuditEvent, appendWorkspaceHistoryChange, getWorkspaceHistoryPath, mutateWorkspaceJsonWithHistory, WORKSPACE_HISTORY_ID, writeWorkspaceJsonWithHistory, } from "../core/history/workspace-history.js";
-export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, } from "../core/history/replay.js";
+export { normalizeReplayPatchOps, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, verifyHistoryChain, verifyHistoryChainWithVersion, } from "../core/history/replay.js";
 export { resolveBodyFileContent } from "../core/io/body-file.js";
 export { generateItemId, normalizeItemId, normalizeRawItemId, } from "../core/item/id.js";
 export { canonicalDocument, normalizeItemMetadata, parseItemDocument, serializeItemDocument, } from "../core/item/item-format.js";
@@ -73,7 +73,7 @@ export { splitCommaList } from "../core/shared/split-comma-list.js";
 export { compareTimestampStrings, nowIso, resolveIsoOrRelative, } from "../core/shared/time.js";
 export { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
 export { listAllDocumentCandidatesCached, } from "../core/store/item-metadata-cache.js";
-export { buildItemNotFoundError, createMutationGuardSdk, deleteItem, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
+export { buildItemNotFoundError, createMutationGuardSdk, deleteItem, listAllItemMetadata, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
 export { isTerminalPlanMode, shouldCompletePlanOnClose, } from "../core/item/plan-lifecycle.js";
 export { getHistoryPath, getItemPath, getSettingsPath, resolveImplicitPmRoot, resolvePmRoot, } from "../core/store/paths.js";
 export { persistSelectedItemFormat, readSettings, readSettingsWithMetadata, writeSettings, } from "../core/store/settings.js";
@@ -81,4 +81,4 @@ export { maybeRunFirstUseTelemetryPrompt } from "../core/telemetry/consent.js";
 export { deriveTelemetryCommandResolution, } from "../core/telemetry/observability.js";
 export { emitTelemetryErrorEvent, finishTelemetryCommand, startTelemetryCommand, } from "../core/telemetry/runtime.js";
 //# sourceMappingURL=runtime-primitives.js.map
-//# debugId=16d4bbae-03b7-5316-8e26-77f33affdcf6
+//# debugId=78779372-1987-54d0-9ae4-775b52641a26

package/dist/sdk/runtime-stats-options.js

@@ -1,9 +1,10 @@
 
-!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]="dbabff08-1bb7-539b-b1c1-c10584aa0a67")}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]="0e63298a-d2d7-5217-af50-a206348b4cd4")}catch(e){}}();
 import { readRuntimeString, readRuntimeStringArray } from "./runtime-input.js";
 /** Convert a flat runtime option bag into the canonical typed stats payload. */
 export function statsCommandOptionsFromRuntime(options) {
     return {
+        includeEmpty: options.includeEmpty === true,
         storage: options.storage === true,
         metadataCoverage: options.metadataCoverage === true,
         fieldUtilization: options.fieldUtilization === true,
@@ -35,4 +36,4 @@ export function statsCommandOptionsFromRuntime(options) {
     };
 }
 //# sourceMappingURL=runtime-stats-options.js.map
-//# debugId=dbabff08-1bb7-539b-b1c1-c10584aa0a67
+//# debugId=0e63298a-d2d7-5217-af50-a206348b4cd4

package/dist/sdk/runtime.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Runtime.
  */
 
-!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]="a294f940-5bb9-55a4-bf2c-64842a3a177b")}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]="7c27b516-1714-5f2b-8304-98e8372280be")}catch(e){}}();
 export { PM_GITIGNORE_END, PM_GITIGNORE_START, ensurePmGitignore, getPmGitignoreBlock, } from "./workspace.js";
 export { SEARCH_EXTENSION_FLAG_DEFINITIONS } from "./extension-contracts.js";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -33,7 +33,7 @@ import { applyContextIntentProjection, attachReadOutputContracts, } from "./cont
 import { runWithDiscoveredContextIntentContracts, } from "./context-intent-runtime.js";
 import { validateReadOutputOptions, } from "./read-output-contracts.js";
 export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";
-import { runActivity } from "./query/activity.js";
+import { normalizeActivityProjectionOptions, runActivity, } from "./query/activity.js";
 import { runAssuranceDispatch } from "./governance/assurance-action.js";
 import { runAggregate, } from "./query/aggregate.js";
 import { runAppend } from "./lifecycle/append.js";
@@ -1456,12 +1456,8 @@ function runMcpConfigAction(ctx) {
         "project", configAction, readString(ctx.args, "key") ?? readString(ctx.options, "key"), ctx.options, ctx.global, readString(ctx.args, "value") ?? readString(ctx.options, "value"));
 }
 function runMcpActivityAction(ctx) {
-    const activityOptions = { ...ctx.options };
-    if (activityOptions.compact === undefined) {
-        activityOptions.compact = activityOptions.full === true ? false : true;
-    }
-    delete activityOptions.full;
-    return runActivity(activityOptions, ctx.global);
+    const options = ctx.options;
+    return runActivity(normalizeActivityProjectionOptions(options), ctx.global);
 }
 function parseMcpIntegerPrefix(value, label) {
     if (typeof value === "number") {
@@ -1934,4 +1930,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=a294f940-5bb9-55a4-bf2c-64842a3a177b
+//# debugId=7c27b516-1714-5f2b-8304-98e8372280be

package/dist/sdk/schema-migration.js

@@ -7,11 +7,11 @@
  * guarantees.
  */
 
-!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]="7d175791-016d-59b6-a44d-a70371f36751")}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]="cd777de3-665f-5e01-ac98-8986f2a5a4c2")}catch(e){}}();
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { pathExists, readFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
+import { isFileMissingError, pathExists, readFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
 import { appendWorkspaceHistoryChange } from "../core/history/workspace-history.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
 import { parseFieldsFile, serializeFieldsFile, } from "../core/schema/fields-file.js";
@@ -681,7 +681,7 @@ async function collectSchemaReferenceState(params) {
         if (typeof error !== "object" ||
             error === null ||
             !("code" in error) ||
-            error.code !== "ENOENT") {
+            !isFileMissingError(error)) {
             throw error;
         }
     }
@@ -855,4 +855,4 @@ export const schemaMigrationTestOnly = {
     validateAndStoreMigrationPlan,
 };
 //# sourceMappingURL=schema-migration.js.map
-//# debugId=7d175791-016d-59b6-a44d-a70371f36751
+//# debugId=cd777de3-665f-5e01-ac98-8986f2a5a4c2

package/dist/sdk/stats.d.ts

@@ -1,5 +1,5 @@
 import { type ContentFieldUtilizationReport } from "../core/governance/content-fields.js";
-import { type GroupedBreakdown, type MetadataCoverageReport } from "../core/governance/metadata-coverage.js";
+import { type CoverageItem, type GroupedBreakdown, type LifecycleClassifier, type MetadataCoverageReport } from "../core/governance/metadata-coverage.js";
 import { type HistoryStorageStats } from "../core/history/history-storage-stats.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
 import type { ItemStatus, ItemType } from "../types/index.js";
@@ -7,6 +7,8 @@ import { type ImprovementDirection, type ImprovementLedgerResult, type RecordImp
 import { type FleetAttributionAnalytics, type ProvenanceCoverageAnalytics } from "./history-analytics.js";
 /** Documents the stats command options payload exchanged by command, SDK, and package integrations. */
 export interface StatsCommandOptions {
+    /** Restore zero-count item-type and status buckets for schema-governance dashboards. */
+    includeEmpty?: boolean;
     /** Include aggregate per-stream history storage metrics (sizes, depth, oldest/newest). */
     storage?: boolean;
     /** Include metadata coverage percentages (AC, estimates, resolution, tags, parent) overall and by type. */
@@ -52,6 +54,29 @@ export interface StatsCommandOptions {
     /** Minimum close or explicit-value denominator required for rates. */
     minimumSample?: number;
 }
+/** Compact, tabular lifecycle row used by the default stats type distribution. */
+export interface StatsTypeLifecycleRow {
+    /** Item type represented by this row. */
+    type: string;
+    /** Total items of this type across every lifecycle bucket. */
+    total: number;
+    /** Items in the default open lifecycle bucket. */
+    open: number;
+    /** Items in active non-default lifecycle states. */
+    in_progress: number;
+    /** Items in blocked lifecycle states. */
+    blocked: number;
+    /** Items in draft lifecycle states. */
+    draft: number;
+    /** Items in completed lifecycle states. */
+    closed: number;
+    /** Items in canceled lifecycle states. */
+    canceled: number;
+    /** Items whose custom status is outside the recognized lifecycle buckets. */
+    other: number;
+}
+/** Screen-sized type distribution rendered as one canonical TOON table. */
+export type StatsTypeBreakdown = StatsTypeLifecycleRow[];
 /** Documents the stats result payload exchanged by command, SDK, and package integrations. */
 export interface StatsResult {
     /** Value that configures or reports totals for this contract. */
@@ -61,9 +86,11 @@ export interface StatsResult {
         history_entries: number;
     };
     /** Schema type that determines the shape and validation rules for this value. */
-    by_type: Record<ItemType, number>;
+    by_type: StatsTypeBreakdown;
     /** Item counts grouped by lifecycle status. */
-    by_status: Record<ItemStatus, number>;
+    by_status: Partial<Record<ItemStatus, number>>;
+    /** Total zero-count type and status buckets omitted from the default projection. */
+    omitted_zero_buckets: number;
     /** Present only with --metadata-coverage: per-field coverage overall and by type. */
     metadata_coverage?: MetadataCoverageReport;
     /** Present only with --by-assignee/--by-tag/--by-priority: lifecycle-bucketed group breakdowns. */
@@ -89,6 +116,11 @@ export interface StatsResult {
 }
 declare function zeroByType(itemTypes: string[]): Record<ItemType, number>;
 declare function zeroByStatus(statuses: string[]): Record<ItemStatus, number>;
+declare function projectStatsDistributions(items: readonly CoverageItem[], itemTypes: readonly string[], statuses: readonly string[], classifier: LifecycleClassifier, includeEmpty: boolean): {
+    byType: StatsTypeBreakdown;
+    byStatus: Partial<Record<ItemStatus, number>>;
+    omitted: number;
+};
 declare function countNonEmptyLines(raw: string): number;
 declare function readHistoryStreamContents(pmRoot: string): Promise<Array<{
     id: string;
@@ -100,6 +132,7 @@ export declare const _testOnly: {
     zeroByStatus: typeof zeroByStatus;
     countNonEmptyLines: typeof countNonEmptyLines;
     readHistoryStreamContents: typeof readHistoryStreamContents;
+    projectStatsDistributions: typeof projectStatsDistributions;
 };
 /** Implements run stats for the public runtime surface of this module. */
 export declare function runStats(global: GlobalOptions, options?: StatsCommandOptions): Promise<StatsResult>;

package/dist/sdk/stats.js

@@ -4,7 +4,7 @@
  * Implements the pm stats 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]="a4de53c1-bb22-591f-a064-142c642a2443")}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]="d28c7ac7-9801-5b0c-84c9-51deede398be")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { getActiveExtensionRegistrations, runActiveOnReadHooks, } from "../core/extensions/index.js";
@@ -36,6 +36,53 @@ function zeroByStatus(statuses) {
         return acc;
     }, {});
 }
+function projectStatsDistributions(items, itemTypes, statuses, classifier, includeEmpty) {
+    const grouped = groupItemsByDimension(items, "type", classifier);
+    const presentTypes = new Set(grouped.rows.map((row) => row.key));
+    const missingTypes = itemTypes.filter((type) => !presentTypes.has(type));
+    const groupedRows = includeEmpty
+        ? [
+            ...grouped.rows,
+            ...missingTypes.map((type) => ({
+                label: type,
+                key: type,
+                total: 0,
+                buckets: {
+                    open: 0,
+                    in_progress: 0,
+                    blocked: 0,
+                    draft: 0,
+                    closed: 0,
+                    canceled: 0,
+                    other: 0,
+                },
+            })),
+        ]
+        : grouped.rows;
+    const byType = groupedRows.map((row) => ({
+        type: row.key ?? row.label,
+        total: row.total,
+        open: row.buckets.open,
+        in_progress: row.buckets.in_progress,
+        blocked: row.buckets.blocked,
+        draft: row.buckets.draft,
+        closed: row.buckets.closed,
+        canceled: row.buckets.canceled,
+        other: row.buckets.other,
+    }));
+    const counts = zeroByStatus([...statuses]);
+    for (const item of items)
+        counts[item.status] += 1;
+    const byStatus = Object.fromEntries(Object.entries(counts).filter(([, count]) => includeEmpty || count > 0));
+    return {
+        byType,
+        byStatus,
+        omitted: includeEmpty
+            ? 0
+            : missingTypes.length +
+                Object.values(counts).filter((count) => count === 0).length,
+    };
+}
 function countNonEmptyLines(raw) {
     if (raw.trim().length === 0) {
         return 0;
@@ -75,6 +122,7 @@ export const _testOnly = {
     zeroByStatus,
     countNonEmptyLines,
     readHistoryStreamContents,
+    projectStatsDistributions,
 };
 async function recordStatsObservations(global, options) {
     const recorded = [];
@@ -129,12 +177,13 @@ async function requestedHistoryAnalytics(pmRoot, items, settings, terminalStatus
             : undefined,
     };
 }
-function assembleStatsResult(totals, byType, byStatus, optional) {
+function assembleStatsResult(totals, byType, byStatus, omittedZeroBuckets, optional) {
     const hasBreakdowns = Object.keys(optional.breakdowns).length > 0;
     return {
         totals,
         by_type: byType,
         by_status: byStatus,
+        omitted_zero_buckets: omittedZeroBuckets,
         ...(optional.metadataCoverage
             ? { metadata_coverage: optional.metadataCoverage }
             : {}),
@@ -180,16 +229,8 @@ export async function runStats(global, options = {}) {
         itemIds: items.map((item) => item.id),
         commandLabel: "stats",
     });
-    const byType = zeroByType(typeRegistry.types);
-    const byStatus = zeroByStatus(statusRegistry.definitions.map((definition) => definition.id));
-    // zeroByType/zeroByStatus pre-seed a bucket for every registry type/status, and
-    // the light item-metadata reader drops any item whose type/status falls outside
-    // the active registry (parse rejects them) — so every item's bucket is already
-    // present here and no on-the-fly initialization is reachable.
-    for (const item of items) {
-        byType[item.type] += 1;
-        byStatus[item.status] += 1;
-    }
+    const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);
+    const distributions = projectStatsDistributions(items, typeRegistry.types, statusRegistry.definitions.map((definition) => definition.id), classifier, options.includeEmpty === true);
     const streams = await readHistoryStreamContents(pmRoot);
     let historyEntries = 0;
     for (const stream of streams) {
@@ -198,7 +239,6 @@ export async function runStats(global, options = {}) {
     const storage = options.storage
         ? computeHistoryStorageStats(streams)
         : undefined;
-    const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);
     const metadataCoverage = options.metadataCoverage
         ? computeMetadataCoverage(items, classifier)
         : undefined;
@@ -219,7 +259,7 @@ export async function runStats(global, options = {}) {
         items: items.length,
         history_streams: streams.length,
         history_entries: historyEntries,
-    }, byType, byStatus, {
+    }, distributions.byType, distributions.byStatus, distributions.omitted, {
         metadataCoverage,
         breakdowns,
         storage,
@@ -231,4 +271,4 @@ export async function runStats(global, options = {}) {
     });
 }
 //# sourceMappingURL=stats.js.map
-//# debugId=a4de53c1-bb22-591f-a064-142c642a2443
+//# debugId=d28c7ac7-9801-5b0c-84c9-51deede398be

package/dist/sdk/test/execution.d.ts

@@ -35,6 +35,8 @@ export interface TestCommandOptions {
     addJson?: string[];
     /** Value that configures or reports remove for this contract. */
     remove?: string[];
+    /** Remove linked tests by their stable 1-based list position. */
+    removeIndex?: Array<string | number>;
     /** Value that configures or reports list for this contract. */
     list?: boolean;
     /** Value that configures or reports run for this contract. */
@@ -146,6 +148,8 @@ export interface TestResult {
     changed: boolean;
     /** Value that configures or reports count for this contract. */
     count: number;
+    /** Number of linked-test entries removed by this mutation. */
+    removed?: number;
     /** Measurements supplied for the current producing run. */
     measurements?: TestRunMeasurement[];
     /** Existing and current measurements below the selected threshold. */