@unbrained/pm-cli 2026.8.11 → 2026.8.13

package/dist/core/telemetry/runtime.js

@@ -4,15 +4,17 @@
  * Captures consent-aware telemetry and observability events 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]="fea9d81b-3deb-51f4-9ec3-76396ae1307d")}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]="26ea62d9-874d-5826-9822-83c5523b673b")}catch(e){}}();
 import crypto from "node:crypto";
 import { spawn } from "node:child_process";
 import { mkdirSync, rmSync, statSync } from "node:fs";
 import { mkdir, readdir, rm, stat } from "node:fs/promises";
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
 import os from "node:os";
 import path from "node:path";
 import { resolvePmPackageRootFromModule } from "../packages/root.js";
-import { appendLineAtomic, readFileIfExists, writeFileAtomic, } from "../fs/fs-utils.js";
+import { isFileMissingError, appendLineAtomic, readFileIfExists, writeFileAtomic, } from "../fs/fs-utils.js";
 import { resolveTelemetryErrorCategory, } from "../shared/constants.js";
 import { nowIso } from "../shared/time.js";
 import { detectAgentIdentity, readAuthorEnvironment, } from "../shared/author.js";
@@ -22,11 +24,10 @@ import { deriveTelemetryCommandResolution, deriveTelemetryCommandTaxonomy, infer
 const TELEMETRY_QUEUE_RELATIVE_PATH = path.join("runtime", "telemetry", "events.jsonl");
 const TELEMETRY_STATE_RELATIVE_PATH = path.join("runtime", "telemetry", "state.json");
 const TELEMETRY_OTEL_SPANS_RELATIVE_PATH = path.join("runtime", "telemetry", "otel-spans.jsonl");
-// Kept small so a worst-case batch against a blackholed collector
-// (TELEMETRY_OTEL_SPANS_FLUSH_BATCH_SIZE * TELEMETRY_HTTP_TIMEOUT_MS plus the
-// preceding event flush) stays well under TELEMETRY_FLUSH_LOCK_STALE_MS (60s).
-// Otherwise a later command could treat the still-held flush lock as stale and
-// start a second concurrent worker.
+// OTLP requests run concurrently, while event and OTLP phases run sequentially.
+// The maximum configurable HTTP timeout therefore keeps two worst-case network
+// phases below TELEMETRY_FLUSH_LOCK_STALE_MS (60s), preventing a later command
+// from treating a live worker's lock as stale and starting a second worker.
 const TELEMETRY_OTEL_SPANS_FLUSH_BATCH_SIZE = 8;
 const TELEMETRY_OTEL_SPANS_MAX_PENDING = 500;
 /** Public contract for telemetry schema version, shared by SDK and presentation-layer consumers. */
@@ -35,7 +36,9 @@ const TELEMETRY_CLIENT_SCHEMA_VERSION = 1;
 const TELEMETRY_FLUSH_BATCH_SIZE = 100;
 const TELEMETRY_MAX_RETRY_DELAY_MS = 3_600_000;
 const TELEMETRY_RETRY_BASE_DELAY_MS = 30_000;
-const TELEMETRY_HTTP_TIMEOUT_MS = 5_000;
+const TELEMETRY_HTTP_TIMEOUT_DEFAULT_MS = 20_000;
+const TELEMETRY_HTTP_TIMEOUT_MIN_MS = 1_000;
+const TELEMETRY_HTTP_TIMEOUT_MAX_MS = 25_000;
 const MILLISECONDS_PER_DAY = 86_400_000;
 const TELEMETRY_MAX_EVENT_BYTES = 65_536;
 const TELEMETRY_SANITIZE_MAX_DEPTH = 6;
@@ -58,6 +61,8 @@ const PM_TELEMETRY_OTEL_DISABLED_VALUES = new Set(["1", "true", "yes", "on"]);
 const PM_TELEMETRY_INLINE_FLUSH_ENV = "PM_TELEMETRY_INLINE_FLUSH";
 const PM_TELEMETRY_FLUSH_CHILD_ENV = "PM_TELEMETRY_FLUSH_CHILD";
 const PM_TELEMETRY_SOURCE_CONTEXT_ENV = "PM_TELEMETRY_SOURCE_CONTEXT";
+const PM_TELEMETRY_HTTP_TIMEOUT_MS_ENV = "PM_TELEMETRY_HTTP_TIMEOUT_MS";
+const NATIVE_FETCH = globalThis.fetch;
 /** Supported values accepted by the pm telemetry source context contract. */
 export const PM_TELEMETRY_SOURCE_CONTEXT_VALUES = [
     "user",
@@ -390,6 +395,80 @@ function normalizeCaptureLevel(value) {
 function parseBooleanTrueLike(value) {
     return BOOLEAN_TRUE_VALUES.has((value ?? "").trim().toLowerCase());
 }
+/** Resolve the background event and OTLP request timeout within the flush-lock safety envelope. */
+function resolveTelemetryHttpTimeoutMs() {
+    const rawConfigured = process.env[PM_TELEMETRY_HTTP_TIMEOUT_MS_ENV]?.trim();
+    if (!rawConfigured) {
+        return TELEMETRY_HTTP_TIMEOUT_DEFAULT_MS;
+    }
+    const configured = Number(rawConfigured);
+    if (!Number.isFinite(configured)) {
+        return TELEMETRY_HTTP_TIMEOUT_DEFAULT_MS;
+    }
+    return Math.min(TELEMETRY_HTTP_TIMEOUT_MAX_MS, Math.max(TELEMETRY_HTTP_TIMEOUT_MIN_MS, Math.trunc(configured)));
+}
+/** POST a JSON payload with one total timeout that covers DNS, connection, TLS, and response completion. */
+async function postTelemetryJson(endpoint, headers, body) {
+    const url = new URL(endpoint);
+    // A replaced global fetch is an intentional runtime adapter used by the
+    // repository's deterministic tests and by embedders that instrument network
+    // traffic. Production retains the native HTTP transport below so Node's
+    // independent built-in-fetch connect timeout cannot preempt our bound.
+    if (globalThis.fetch !== NATIVE_FETCH) {
+        const controller = new AbortController();
+        let timeout;
+        const deadline = new Promise((_resolve, reject) => {
+            timeout = setTimeout(() => {
+                controller.abort();
+                reject(new Error("telemetry_http_timeout"));
+            }, resolveTelemetryHttpTimeoutMs());
+        });
+        try {
+            const response = await Promise.race([
+                globalThis.fetch(endpoint, {
+                    method: "POST",
+                    headers,
+                    body,
+                    signal: controller.signal,
+                }),
+                deadline,
+            ]);
+            return response.status;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    const request = url.protocol === "https:"
+        ? httpsRequest
+        : url.protocol === "http:"
+            ? httpRequest
+            : undefined;
+    if (!request) {
+        throw new Error(`telemetry_http_protocol_unsupported_${url.protocol}`);
+    }
+    return new Promise((resolve, reject) => {
+        const timeoutMs = resolveTelemetryHttpTimeoutMs();
+        const requestOptions = {
+            method: "POST",
+            headers: {
+                ...headers,
+                "content-length": Buffer.byteLength(body),
+            },
+            signal: AbortSignal.timeout(timeoutMs),
+            autoSelectFamilyAttemptTimeout: Math.min(5_000, timeoutMs),
+        };
+        const clientRequest = request(url, requestOptions, (response) => {
+            response.once("error", reject);
+            // Client responses always carry an HTTP status code; Node's shared
+            // IncomingMessage type is also used for server requests where it is absent.
+            response.once("end", () => resolve(response.statusCode));
+            response.resume();
+        });
+        clientRequest.once("error", reject);
+        clientRequest.end(body);
+    });
+}
 function normalizePmVersion(value) {
     const trimmed = typeof value === "string" ? value.trim() : "";
     return trimmed.length > 0 ? trimmed : "0.0.0";
@@ -1214,14 +1293,9 @@ async function flushPendingOtelSpans(globalPmRoot, retentionDays) {
     // and safe under Node's single-threaded event loop.
     await Promise.all(due.map(async (span) => {
         try {
-            const response = await fetch(span.endpoint, {
-                method: "POST",
-                headers: { "content-type": "application/json" },
-                body: JSON.stringify(span.payload),
-                signal: AbortSignal.timeout(TELEMETRY_HTTP_TIMEOUT_MS),
-            });
-            if (!response.ok) {
-                throw new Error(`local_otel_export_http_${response.status}`);
+            const status = await postTelemetryJson(span.endpoint, { "content-type": "application/json" }, JSON.stringify(span.payload));
+            if (status < 200 || status >= 300) {
+                throw new Error(`local_otel_export_http_${status}`);
             }
             succeededIds.add(span.id);
             succeededCount += 1;
@@ -1398,17 +1472,12 @@ async function flushQueue(globalPmRoot, endpoint, retentionDays) {
         requestHeaders["x-pm-telemetry-key"] = ingestKey;
     }
     try {
-        const response = await fetch(normalizedEndpoint, {
-            method: "POST",
-            headers: requestHeaders,
-            body: JSON.stringify({
-                schema_version: TELEMETRY_SCHEMA_VERSION,
-                events: dueEntries.map((entry) => entry.event),
-            }),
-            signal: AbortSignal.timeout(TELEMETRY_HTTP_TIMEOUT_MS),
-        });
-        if (!response.ok) {
-            throw new Error(`telemetry_flush_http_${response.status}`);
+        const status = await postTelemetryJson(normalizedEndpoint, requestHeaders, JSON.stringify({
+            schema_version: TELEMETRY_SCHEMA_VERSION,
+            events: dueEntries.map((entry) => entry.event),
+        }));
+        if (status < 200 || status >= 300) {
+            throw new Error(`telemetry_flush_http_${status}`);
         }
     }
     catch (error) {
@@ -1519,7 +1588,7 @@ function createDirectoryLock(lockPath) {
         if (code === "EEXIST") {
             return false;
         }
-        if (code !== "ENOENT") {
+        if (!isFileMissingError(error)) {
             return false;
         }
     }
@@ -1547,7 +1616,7 @@ function acquireTelemetryFlushSpawnGate(globalPmRoot) {
         removeDirectoryLockBestEffort(lockPath);
     }
     catch (error) {
-        if (errorCode(error) !== "ENOENT") {
+        if (!isFileMissingError(error)) {
             return false;
         }
     }
@@ -1586,11 +1655,13 @@ export const _testOnly = {
     looksLikeEmailToken,
     otelSpansQueuePath,
     parseBooleanTrueLike,
+    postTelemetryJson,
     parsePendingOtelSpanLines,
     prunePendingOtelSpans,
     reconcilePendingOtelSpansAfterFlush,
     retentionCutoffMs,
     resolveOtelTracesEndpoint,
+    resolveTelemetryHttpTimeoutMs,
     rewritePendingOtelSpans,
     normalizeForHash,
     normalizeCaptureLevel,
@@ -1915,4 +1986,4 @@ export async function emitTelemetryErrorEvent(context) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=fea9d81b-3deb-51f4-9ec3-76396ae1307d
+//# debugId=26ea62d9-874d-5826-9822-83c5523b673b

package/dist/sdk/agent/command-recovery.d.ts

@@ -1,3 +1,5 @@
+/** Resolve a recovery command without interpreting global option values as command tokens. */
+export declare function resolveRecoveryCommandName(invocationArgv: string[] | undefined): string | undefined;
 /** Resolve the truthful placeholder for a missing flag from its contract. */
 export declare function resolveMissingOptionPlaceholder(commandName: string, missingLabel: string): string | null | undefined;
 /** Preserve an attempted argv vector and insert each missing option before `--`. */

package/dist/sdk/agent/command-recovery.js

@@ -6,13 +6,21 @@
  * supplied arguments are preserved byte-for-token.
  */
 
-!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]="ab87f46c-c9b4-51d1-a712-fbce7c79fca9")}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]="4973a995-60f0-5990-9927-371dc6716063")}catch(e){}}();
 import { renderPmCommand } from "../command-line.js";
 import { resolveSubcommandFlagContractsForCommand } from "../cli-contracts.js";
+import { parseBootstrapCommandName } from "../cli-bootstrap.js";
 function normalizeMissingFlag(label) {
     const match = label.trim().match(/--[a-z0-9][a-z0-9_-]*/i);
     return match?.[0]?.replaceAll("_", "-").toLowerCase();
 }
+/** Resolve a recovery command without interpreting global option values as command tokens. */
+export function resolveRecoveryCommandName(invocationArgv) {
+    if (!Array.isArray(invocationArgv) || invocationArgv.length === 0) {
+        return undefined;
+    }
+    return parseBootstrapCommandName(invocationArgv);
+}
 /** Resolve the truthful placeholder for a missing flag from its contract. */
 export function resolveMissingOptionPlaceholder(commandName, missingLabel) {
     const flag = normalizeMissingFlag(missingLabel);
@@ -49,4 +57,4 @@ export function renderMissingOptionRetry(invocationArgv, commandName, missingLab
         : renderPmCommand(retry);
 }
 //# sourceMappingURL=command-recovery.js.map
-//# debugId=ab87f46c-c9b4-51d1-a712-fbce7c79fca9
+//# debugId=4973a995-60f0-5990-9927-371dc6716063

package/dist/sdk/annotations.js

@@ -4,9 +4,9 @@
  * Implements the pm annotation command 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]="13cf8bd9-0aee-5838-a6eb-de9f87ddfac7")}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]="0af9967c-ca72-563a-9518-2e68da0c0fe0")}catch(e){}}();
 import { readFile } from "node:fs/promises";
-import { pathExists } from "../core/fs/fs-utils.js";
+import { isFileAbsentError, pathExists } from "../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
 import { createStdinTokenResolver, parseCsvKv } from "../core/item/parse.js";
@@ -114,7 +114,7 @@ async function resolveAnnotationTextSource(options, noun) {
         return { value: await readFile(filePath, "utf8"), emptyFlag: "--file" };
     }
     catch (error) {
-        if (isErrnoError(error) && error.code === "ENOENT") {
+        if (isErrnoError(error) && isFileAbsentError(error)) {
             throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);
         }
         const detail = error instanceof Error ? error.message : String(error);
@@ -399,4 +399,4 @@ function renderAnnotationResult(id, collectionKey, allEntries, limit, includeMet
     };
 }
 //# sourceMappingURL=annotations.js.map
-//# debugId=13cf8bd9-0aee-5838-a6eb-de9f87ddfac7
+//# debugId=0af9967c-ca72-563a-9518-2e68da0c0fe0

package/dist/sdk/cli-bootstrap.d.ts

@@ -31,6 +31,8 @@ export interface BootstrapGlobalOptions {
     outputFormat?: "toon" | "json";
     /** Caller-carried cross-call budget and served-item state. */
     outputSession?: string;
+    /** Whether machine-readable row discovery metadata is requested. */
+    outputRowContract?: boolean;
     /** Invocation-wide mutation author override. */
     author?: string;
     /** Whether `--author` was present without its required value. */

package/dist/sdk/cli-bootstrap.js

@@ -4,7 +4,7 @@
  * Provides public bootstrap argument normalization for embedded CLI hosts.
  */
 
-!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]="eac8ed6b-43c4-54fa-820a-220154001a6b")}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]="7b3209a8-8580-542c-9e80-21d04df3f61f")}catch(e){}}();
 import { EXECUTABLE_COMMAND_ALIASES, resolveSubcommandFlagContractsForCommand, } from "./cli-contracts.js";
 export { EXECUTABLE_COMMAND_ALIASES };
 import { levenshteinDistanceWithinLimit } from "../core/shared/levenshtein.js";
@@ -47,6 +47,7 @@ const BOOTSTRAP_BOOLEAN_FLAGS = new Set([
     "--quiet",
     "--lean",
     "--token-accounting",
+    "--output-row-contract",
 ]);
 /** Consume one bootstrap-global token and update the accumulated parse state. */
 function consumeBootstrapGlobalToken(argv, index, state) {
@@ -95,6 +96,9 @@ export function parseBootstrapGlobalOptions(argv) {
         quiet: state.booleanFlags.has("--quiet"),
         lean: state.booleanFlags.has("--lean"),
         tokenAccounting: state.booleanFlags.has("--token-accounting"),
+        ...(state.booleanFlags.has("--output-row-contract")
+            ? { outputRowContract: true }
+            : {}),
         ...(state.outputValues.get("--output-include") === undefined
             ? {}
             : { outputInclude: state.outputValues.get("--output-include") }),
@@ -886,4 +890,4 @@ export const _testOnly = {
     resolveCanonicalFlag,
 };
 //# sourceMappingURL=cli-bootstrap.js.map
-//# debugId=eac8ed6b-43c4-54fa-820a-220154001a6b
+//# debugId=7b3209a8-8580-542c-9e80-21d04df3f61f

package/dist/sdk/cli-contracts/completeness.js

@@ -7,7 +7,7 @@
  * a hand-picked test list.
  */
 
-!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]="11dade38-a681-599f-b3b7-8d121418366d")}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]="cf238c71-1626-5e48-9207-7acf22c0d680")}catch(e){}}();
 import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
 import { resolveSubcommandFlagContractsForCommand, } from "./flag-contracts.js";
 import { pmToolActionParameterKeys } from "./tool-schema.js";
@@ -23,6 +23,7 @@ const CLI_TRANSPORT_FLAGS = new Set([
     "--output-budget",
     "--output-format",
     "--output-session",
+    "--output-row-contract",
     "--no-changed-fields",
     "--no-extensions",
     "--no-pager",
@@ -79,6 +80,7 @@ const ACTION_POSITIONAL_PARAMETERS = {
     assurance: {
         id: "<id>",
         kind: "<kind>",
+        preset: "[kind]|[id]",
         subcommand: "<action>",
     },
     event: { title: "<title>" },
@@ -94,7 +96,12 @@ const ACTION_POSITIONAL_PARAMETERS = {
     },
 };
 const ACTION_FLAG_PARAMETER_OVERRIDES = {
-    assurance: { "--tree": "treeId" },
+    assurance: {
+        "--tree": "treeId",
+        "--owner": "owner",
+        "--apply": "apply",
+        "--enforcement": "enforcement",
+    },
     init: {
         "--id-prefix": "idPrefix",
         "--no-merge-fence": "mergeFence",
@@ -376,4 +383,4 @@ export function analyzeSdkCliParameterCompleteness(source = {}) {
     });
 }
 //# sourceMappingURL=completeness.js.map
-//# debugId=11dade38-a681-599f-b3b7-8d121418366d
+//# debugId=cf238c71-1626-5e48-9207-7acf22c0d680

package/dist/sdk/cli-contracts/enum-contracts.d.ts

@@ -19,7 +19,7 @@ export declare const PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS: readonly ["none", "
 /** Restricts pm extension sandbox profile contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionSandboxProfileContract = (typeof PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS)[number];
 /** Public contract for pm extension policy surface contracts, shared by SDK and presentation-layer consumers. */
-export declare const PM_EXTENSION_POLICY_SURFACE_CONTRACTS: 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 PM_EXTENSION_POLICY_SURFACE_CONTRACTS: 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"];
 /** Restricts pm extension policy surface contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionPolicySurfaceContract = (typeof PM_EXTENSION_POLICY_SURFACE_CONTRACTS)[number];
 /** Public contract for pm core command names, shared by SDK and presentation-layer consumers. */

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

@@ -7,7 +7,7 @@
  * flag surface stays single-sourced across the CLI, SDK, and MCP boundaries.
  */
 
-!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]="48d9a5c7-f747-5fac-a534-01a4b3b7af2c")}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]="a5a2c81f-8870-5111-b13c-74c362098d54")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { RESERVED_EXTENSION_HOST_FLAGS } from "../../core/extensions/reserved-host-flags.js";
 function normalizeFlagAliasKey(flag) {
@@ -392,7 +392,7 @@ export const SCHEMA_FLAG_CONTRACTS = [
     // add-type --infer flags (title-prefix type inference).
     { flag: "--infer" },
     { flag: "--min-count" },
-    { flag: "--apply" },
+    { flag: "--apply", value_type: "boolean" },
     // Lossless schema evolution flags.
     { flag: "--to" },
     { flag: "--migration-id", aliases: ["--migration_id"] },
@@ -875,6 +875,7 @@ export const TEST_FLAG_CONTRACTS = [
     { flag: "--add" },
     { flag: "--add-json" },
     { flag: "--remove" },
+    { flag: "--remove-index", repeatable: true },
     { flag: "--run" },
     { flag: "--match" },
     { flag: "--only-index" },
@@ -940,6 +941,7 @@ export const GC_FLAG_CONTRACTS = [
 ];
 /** Public contract for stats flag contracts, shared by SDK and presentation-layer consumers. */
 export const STATS_FLAG_CONTRACTS = [
+    { flag: "--include-empty" },
     { flag: "--storage" },
     { flag: "--metadata-coverage" },
     { flag: "--field-utilization" },
@@ -1016,6 +1018,9 @@ export const ASSURANCE_FLAG_CONTRACTS = [
     { flag: "--dry-run" },
     { flag: "--author", value_name: "value" },
     { flag: "--message", value_name: "value" },
+    { flag: "--owner", value_name: "item-id" },
+    { flag: "--apply", value_type: "boolean" },
+    { flag: "--enforcement", value_name: "level" },
 ];
 const ITEM_OWNERSHIP_AND_ISSUE_FLAG_CONTRACTS = [
     { flag: "--assignee" },
@@ -1391,6 +1396,7 @@ export const ACTIVITY_FLAG_CONTRACTS = [
     { flag: "--limit" },
     { flag: "--unbounded" },
     { flag: "--compact" },
+    { flag: "--raw" },
     { flag: "--full" },
     { flag: "--provenance" },
     { flag: "--provenance-summary" },
@@ -1811,4 +1817,4 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     return normalizeUniqueStringList(all).join(" ");
 }
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=48d9a5c7-f747-5fac-a534-01a4b3b7af2c
+//# debugId=a5a2c81f-8870-5111-b13c-74c362098d54

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