@unbrained/pm-cli 2026.8.11 → 2026.8.12

package/dist/sdk/cli-contracts/registration-helpers.d.ts

@@ -70,22 +70,39 @@ export declare function printActivityJsonStream(result: ActivityCommandResult, o
 export declare function normalizeSearchOptions(options: Record<string, unknown>): Record<string, unknown>;
 /** Implements normalize search keywords input for the public runtime surface of this module. */
 export declare function normalizeSearchKeywordsInput(keywords: string[]): string;
-/** Implements normalize activity options for the public runtime surface of this module. */
-export declare function normalizeActivityOptions(options: Record<string, unknown>): {
+/** Canonical Commander-normalized activity query options. */
+export interface NormalizedActivityOptions {
+    /** Exact item identifier filter. */
     id?: string;
+    /** Exact immutable history operation filter. */
     op?: string;
+    /** Exact recorded author filter. */
     author?: string;
+    /** Inclusive activity window lower bound. */
     from?: string;
+    /** Inclusive activity window upper bound. */
     to?: string;
+    /** Maximum projected row count encoded as Commander text. */
     limit?: string;
+    /** Select the compact raw-event projection. */
     compact?: boolean;
+    /** Select a raw event projection instead of the item digest. */
+    raw?: boolean;
+    /** Disable the default projection row bound. */
     unbounded?: boolean;
+    /** Select privacy-safe provenance event rows. */
     provenance?: boolean;
+    /** Include constant-size provenance completeness metrics. */
     provenanceSummary?: boolean;
+    /** Canonical harness filters supplied by Commander. */
     harness?: string[];
+    /** Privacy-safe agent invocation fingerprint filters. */
     agentInstance?: string[];
+    /** Exact provenance dimension predicates. */
     provenanceFilter?: string[];
-};
+}
+/** Implements normalize activity options for the public runtime surface of this module. */
+export declare function normalizeActivityOptions(options: Record<string, unknown>): NormalizedActivityOptions;
 /** Implements resolve activity stream mode for the public runtime surface of this module. */
 export declare function resolveActivityStreamMode(raw: unknown): boolean;
 /** Implements normalize context options for the public runtime surface of this module. */

package/dist/sdk/cli-contracts/registration-helpers.js

@@ -4,7 +4,7 @@
  * Provides CLI runtime support for Registration Helpers.
  */
 
-!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]="5f92dd0d-4eb1-5a7b-8891-931dd15deb81")}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]="daefefd1-3b0b-513d-8b8c-ab17f90b995a")}catch(e){}}();
 import { Option } from "commander";
 import { pathExists, refreshSearchArtifactsForMutation, shouldRunSearchRefreshInForeground, EXIT_CODE, PmCliError, printError, printResult, writeStdout, getSettingsPath, resolvePmRoot, readSettings, runActiveServiceOverride, setActiveCommandResult, } from "../runtime-primitives.js";
 import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "../cli-contracts.js";
@@ -100,7 +100,7 @@ export function getGlobalOptions(command) {
         : typeof reader.opts === "function"
             ? reader.opts()
             : {};
-    return {
+    const normalized = {
         json: opts.json === true ? true : undefined,
         quiet: Boolean(opts.quiet),
         noChangedFields: opts.changedFields === false,
@@ -112,20 +112,19 @@ export function getGlobalOptions(command) {
         outputLimit: readStringCommandOption(opts, "outputLimit"),
         outputBudget: readStringCommandOption(opts, "outputBudget"),
         outputSession: readStringCommandOption(opts, "outputSession"),
+        ...(opts.outputRowContract === true ? { outputRowContract: true } : {}),
         ...(opts.outputFormat === "toon" || opts.outputFormat === "json"
             ? { outputFormat: opts.outputFormat }
             : {}),
-        path: typeof opts.pmPath === "string"
-            ? opts.pmPath
-            : typeof opts.path === "string"
-                ? opts.path
-                : undefined,
+        path: readStringCommandOption(opts, "pmPath") ??
+            readStringCommandOption(opts, "path"),
         noExtensions: opts.extensions === false,
         noPager: Boolean(opts.noPager),
         profile: Boolean(opts.profile),
         ...(commandPath.length > 0 ? { command: commandPath } : {}),
         ...(typeof opts.author === "string" ? { author: opts.author } : {}),
     };
+    return normalized;
 }
 /** Implements get command path for the public runtime surface of this module. */
 export function getCommandPath(command) {
@@ -239,6 +238,7 @@ export function buildBackgroundTestCommandArgs(id, options) {
     pushRepeatableValueFlag(args, "--add", options.add);
     pushRepeatableValueFlag(args, "--add-json", options.addJson);
     pushRepeatableValueFlag(args, "--remove", options.remove);
+    pushRepeatableValueFlag(args, "--remove-index", options.removeIndex);
     pushOptionalValueFlag(args, "--match", options.match);
     pushOptionalValueFlag(args, "--only-index", options.onlyIndex);
     pushOptionalBooleanFlag(args, "--only-last", options.onlyLast);
@@ -792,7 +792,7 @@ export function normalizeSearchKeywordsInput(keywords) {
 /** Implements normalize activity options for the public runtime surface of this module. */
 export function normalizeActivityOptions(options) {
     const readActivityString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, target));
-    return {
+    const normalized = {
         id: readActivityString("id"),
         op: readActivityString("op"),
         author: readActivityString("author"),
@@ -801,9 +801,14 @@ export function normalizeActivityOptions(options) {
         limit: readActivityString("limit"),
         compact: options.full === true || options.provenance === true
             ? false
-            : options.compact === false
-                ? false
-                : true,
+            : options.compact === true || options.raw === true
+                ? true
+                : undefined,
+        ...(options.raw === true ||
+            options.compact === true ||
+            options.full === true
+            ? { raw: true }
+            : {}),
         unbounded: optionTrue(options, "unbounded"),
         provenance: optionTrue(options, "provenance"),
         provenanceSummary: optionTrue(options, "provenanceSummary"),
@@ -817,6 +822,7 @@ export function normalizeActivityOptions(options) {
             ? options.provenanceFilter
             : undefined,
     };
+    return Object.fromEntries(Object.entries(normalized).filter(([, value]) => value !== undefined));
 }
 const ACTIVITY_STREAM_ENABLED_VALUES = new Set([
     "",
@@ -978,4 +984,4 @@ export const _testOnly = {
     collectMutationItemIds,
 };
 //# sourceMappingURL=registration-helpers.js.map
-//# debugId=5f92dd0d-4eb1-5a7b-8891-931dd15deb81
+//# debugId=daefefd1-3b0b-513d-8b8c-ab17f90b995a

package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts

@@ -73,6 +73,9 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         equals: {
                             type: string[];
                         };
+                        state: {
+                            enum: string[];
+                        };
                         dependency_kind?: undefined;
                         operation?: undefined;
                         parameters?: undefined;
@@ -81,7 +84,6 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                         expression?: undefined;
@@ -103,6 +105,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         tags?: undefined;
                         field?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         operation?: undefined;
                         parameters?: undefined;
                         op?: undefined;
@@ -110,7 +113,6 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                         expression?: undefined;
@@ -138,13 +140,13 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         types?: undefined;
                         tags?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         dependency_kind?: undefined;
                         op?: undefined;
                         author?: undefined;
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                         expression?: undefined;
@@ -176,11 +178,11 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         tags?: undefined;
                         field?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         dependency_kind?: undefined;
                         operation?: undefined;
                         parameters?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                         expression?: undefined;
@@ -241,6 +243,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         tags?: undefined;
                         field?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         dependency_kind?: undefined;
                         operation?: undefined;
                         op?: undefined;
@@ -248,7 +251,6 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         expression?: undefined;
                     };
                     allOf?: undefined;
@@ -269,6 +271,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         tags?: undefined;
                         field?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         dependency_kind?: undefined;
                         operation?: undefined;
                         parameters?: undefined;
@@ -277,7 +280,6 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                     };

package/dist/sdk/cli-contracts/schemas/assurance-definition.js

@@ -4,7 +4,7 @@
  * Defines the strict JSON Schema accepted by assurance definition mutations.
  */
 
-!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]="13e7d51c-8464-578c-8780-5ddb6e029705")}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]="2d81fb20-890a-553b-b761-d60caf56b502")}catch(e){}}();
 const ASSURANCE_VALUE_SCHEMA = {
     oneOf: [{ type: "number" }, { type: "array", items: { type: "string" } }],
 };
@@ -14,7 +14,7 @@ const ITEMS_FIELD_CONDITIONAL_SCHEMA = {
 // Keep the JSON Schema keyword visible while avoiding unicorn/no-thenable,
 // which intentionally rejects object literals with a `then` property.
 Reflect.set(ITEMS_FIELD_CONDITIONAL_SCHEMA, "then", {
-    required: ["equals"],
+    oneOf: [{ required: ["equals"] }, { required: ["state"] }],
 });
 /** JSON Schema for measurement, assertion, and gate assurance definitions. */
 export const ASSURANCE_DEFINITION_SCHEMA = {
@@ -41,6 +41,7 @@ export const ASSURANCE_DEFINITION_SCHEMA = {
                                 tags: { type: "array", items: { type: "string" } },
                                 field: { type: "string" },
                                 equals: { type: ["string", "number", "boolean", "null"] },
+                                state: { enum: ["present", "missing"] },
                             },
                         },
                         {
@@ -248,4 +249,4 @@ export const ASSURANCE_DEFINITION_SCHEMA = {
     ],
 };
 //# sourceMappingURL=assurance-definition.js.map
-//# debugId=13e7d51c-8464-578c-8780-5ddb6e029705
+//# debugId=2d81fb20-890a-553b-b761-d60caf56b502

package/dist/sdk/cli-contracts/tool-option-contracts.js

@@ -1,6 +1,6 @@
 /** Returns fresh option contract objects so exported arrays cannot share mutable entries. */
 
-!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]="26955ae3-1aca-503e-9492-46652285d17a")}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]="e2028eff-b29e-5850-87b1-4a3e06f28964")}catch(e){}}();
 function cloneOptionContracts(contracts) {
     return contracts.map((contract) => ({ ...contract }));
 }
@@ -351,6 +351,7 @@ export const TOOL_ACTIVITY_OPTION_CONTRACTS = [
     { param: "limit", flag: "--limit" },
     { param: "unbounded", flag: "--unbounded" },
     { param: "compact", flag: "--compact" },
+    { param: "raw", flag: "--raw" },
     { param: "full", flag: "--full" },
     { param: "provenance", flag: "--provenance" },
     { param: "provenanceSummary", flag: "--provenance-summary" },
@@ -423,4 +424,4 @@ export const TOOL_GRAPH_OPTION_CONTRACTS = [
     { param: "summary", flag: "--summary" },
 ];
 //# sourceMappingURL=tool-option-contracts.js.map
-//# debugId=26955ae3-1aca-503e-9492-46652285d17a
+//# debugId=e2028eff-b29e-5850-87b1-4a3e06f28964

package/dist/sdk/cli-contracts/tool-parameter-tables.js

@@ -4,7 +4,7 @@
  * Defines SDK command-contract metadata for Tool Parameter Tables.
  */
 
-!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]="28d82e94-0359-5ae8-87f1-145f412df35e")}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]="6cdf1fd1-7328-5bae-9238-d317f6efba8a")}catch(e){}}();
 import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
 import { PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS } from "../read-output-session.js";
 import { ASSURANCE_DEFINITION_SCHEMA } from "./schemas/assurance-definition.js";
@@ -55,6 +55,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
             },
         ],
     },
+    outputRowContract: { type: "boolean" },
     path: { type: "string" },
     pmExecutable: { type: "string" },
     timeoutMs: { type: "number" },
@@ -260,8 +261,10 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     semanticWeight: { anyOf: [{ type: "string" }, { type: "number" }] },
     op: { type: "string" },
     compact: { type: "boolean" },
+    raw: { type: "boolean" },
     brief: { type: "boolean" },
     full: { type: "boolean" },
+    includeEmpty: { type: "boolean" },
     view: { type: "string", enum: ["agenda", "day", "week", "month"] },
     date: { type: "string" },
     from: { type: "string" },
@@ -370,6 +373,10 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     verboseAuthorEvents: { type: "boolean" },
     match: { type: "string" },
     onlyIndex: { anyOf: [{ type: "string" }, { type: "number" }] },
+    removeIndex: {
+        type: "array",
+        items: { anyOf: [{ type: "string" }, { type: "number" }] },
+    },
     onlyLast: { type: "boolean" },
     envSet: { type: "array", items: { type: "string" } },
     envClear: { type: "array", items: { type: "string" } },
@@ -934,6 +941,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
             },
         ],
     },
+    outputRowContract: {
+        description: "Include the row selector and TOON row-encoding contract on a read result.",
+    },
     profile: {
         description: "Emit deterministic timing diagnostics to stderr.",
     },
@@ -1299,6 +1309,10 @@ export const PM_TOOL_PARAMETER_METADATA = {
         description: "Run only the 1-based linked-test index from pm test <id> --list order.",
         examples: [1, "2"],
     },
+    removeIndex: {
+        description: "Remove linked tests by their 1-based positions from pm test <id> --list order; repeatable and lossless for commands containing commas or equals signs.",
+        examples: [[1], ["2", "4"]],
+    },
     onlyLast: {
         description: "Run only the most recently added linked-test entry.",
     },
@@ -1656,6 +1670,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     compact: {
         description: "Render compact projection output for search and list-family actions.",
     },
+    raw: {
+        description: "For activity, restore the compact per-event stream instead of the default item digest.",
+    },
     brief: {
         description: "Emit compact low-token output for commands that support terse projections or health details.",
         examples: [true],
@@ -1663,6 +1680,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     full: {
         description: "Enable command-specific full/detail output mode when supported, such as deep item reads for get or full payload mode for search/history.",
     },
+    includeEmpty: {
+        description: "For stats, restore zero-count registered type and lifecycle-status buckets.",
+    },
     fields: {
         description: "Comma-separated projection fields for get, search, list-family, or context outputs. Valid field names are command-specific (e.g. score/matched_fields apply to search; context projects focus-row fields such as priority/deadline/completion_pct).",
         examples: [
@@ -1999,4 +2019,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=28d82e94-0359-5ae8-87f1-145f412df35e
+//# debugId=6cdf1fd1-7328-5bae-9238-d317f6efba8a

package/dist/sdk/cli-contracts/tool-schema.d.ts

@@ -90,8 +90,8 @@ export interface PmActionToolInputSchemaOptions {
  * `PM_TOOL_PARAMETERS_SCHEMA`, eliminating a hand-maintained MCP schema table.
  */
 export declare function buildPmActionToolInputSchema(action: PmToolAction, options?: PmActionToolInputSchemaOptions): Record<string, unknown>;
-/** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and the contract tests all bind to one constant instead of re-typing the `"4.0.2"` literal (pm-r9sz). Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
-export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.6.0";
+/** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and contract tests bind to one version constant. Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
+export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.7.0";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.

package/dist/sdk/cli-contracts/tool-schema.js

@@ -7,7 +7,7 @@
  * consumers from a single source of truth.
  */
 
-!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]="9882d78a-8742-5d50-b345-debe47322b65")}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]="5a184f36-a305-59f1-8c68-ef53cea1df1e")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
 import { TOOL_CREATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, } from "./tool-option-contracts.js";
@@ -31,6 +31,7 @@ const PM_TOOL_READ_OUTPUT_PARAMETER_KEYS = [
     "outputBudget",
     "outputFormat",
     "outputSession",
+    "outputRowContract",
 ];
 /** Canonical top-level MCP properties that take precedence over runtime custom fields. */
 export const PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES = new Set([
@@ -959,6 +960,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "add",
             "addJson",
             "remove",
+            "removeIndex",
             "run",
             "match",
             "onlyIndex",
@@ -1027,6 +1029,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     },
     stats: {
         optional: [
+            "includeEmpty",
             "storage",
             "metadataCoverage",
             "fieldUtilization",
@@ -1472,8 +1475,8 @@ function createLazyContractSchema(build) {
         },
     });
 }
-/** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and the contract tests all bind to one constant instead of re-typing the `"4.0.2"` literal (pm-r9sz). Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
-export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.6.0";
+/** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and contract tests bind to one version constant. Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
+export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.7.0";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.
@@ -1555,4 +1558,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=9882d78a-8742-5d50-b345-debe47322b65
+//# debugId=5a184f36-a305-59f1-8c68-ef53cea1df1e

package/dist/sdk/cli-program.js

@@ -4,7 +4,7 @@
  * Builds the reusable Commander root that embeds pm's universal global contracts.
  */
 
-!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]="a410d336-c332-56fc-9a5d-7841a2b3dfa5")}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]="b799c7c2-21b8-5c19-8565-7166e6f06a90")}catch(e){}}();
 import { Command } from "commander";
 import { writeStdout } from "../core/output/output.js";
 /** Create a fresh pm root program suitable for one-shot CLI or embedded hosts. */
@@ -30,6 +30,7 @@ export function createPmCliProgram(version) {
         .option("--output-budget <tokens>", "Bound estimated tokens in read output")
         .option("--output-format <toon|json>", "Select the read-output encoding")
         .option("--output-session <state>", "Carry a JSON session budget and served-item ledger across read calls")
+        .option("--output-row-contract", "Include the machine-readable row selector and TOON encoding contract")
         .option("--quiet", "Suppress stdout output")
         .option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)")
         .option("--full-changed-fields", "Restore the legacy full mutation envelope and changed_fields array")
@@ -44,4 +45,4 @@ export function createPmCliProgram(version) {
         .exitOverride();
 }
 //# sourceMappingURL=cli-program.js.map
-//# debugId=a410d336-c332-56fc-9a5d-7841a2b3dfa5
+//# debugId=b799c7c2-21b8-5c19-8565-7166e6f06a90

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