@unbrained/pm-cli 2026.8.9 → 2026.8.10

package/dist/core/schema/fields-file.js

@@ -4,9 +4,11 @@
  * Resolves configurable schema, fields, statuses, and workflows for Fields File.
  */
 
-!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]="79b35844-ab8e-5b6f-9975-4dd85b210bcb")}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]="575b0c3a-9ce1-504f-a24e-d8854e898f17")}catch(e){}}();
 import { RUNTIME_FIELD_COMMAND_VALUES, RUNTIME_FIELD_TYPE_VALUES, } from "../../types/index.js";
 import { ITEM_METADATA_KEY_ORDER } from "../shared/constants.js";
+import { normalizeStatusToken as normalizeFieldKey } from "./status-token.js";
+export { normalizeStatusToken as normalizeFieldKey } from "./status-token.js";
 /**
  * Pure logic for the `pm schema add-field` / `pm schema remove-field` commands
  * and the `list-fields` / `show-field` inspectors. The CLI command file
@@ -52,15 +54,6 @@ export const BUILTIN_FIELD_KEYS = new Set([
 ]);
 /** The default commands a field is wired onto when `--commands` is omitted, matching the runtime default in runtime-schema.ts (normalizeRuntimeFieldDefinition). */
 const DEFAULT_FIELD_COMMANDS = ["create", "update"];
-/** Normalizes a field key using the same rule as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */
-export function normalizeFieldKey(value) {
-    return typeof value === "string"
-        ? value
-            .trim()
-            .toLowerCase()
-            .replaceAll(/[\s-]+/g, "_")
-        : "";
-}
 /** Normalizes a CLI flag token: strip a leading `--`, lowercase, and collapse whitespace/underscore runs to a single hyphen (matches normalizeCliToken in runtime-schema.ts). */
 function normalizeCliToken(value) {
     if (typeof value !== "string") {
@@ -293,4 +286,4 @@ function applyBooleanFlag(definition, key, value) {
     }
 }
 //# sourceMappingURL=fields-file.js.map
-//# debugId=79b35844-ab8e-5b6f-9975-4dd85b210bcb
+//# debugId=575b0c3a-9ce1-504f-a24e-d8854e898f17

package/dist/core/schema/runtime-schema.js

@@ -4,11 +4,12 @@
  * Resolves configurable schema, fields, statuses, and workflows for Runtime Schema.
  */
 
-!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]="febba42b-dfd0-549a-a6d9-c30edb321d9d")}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]="a9ff482a-f9f9-5e35-88d0-240db815ec08")}catch(e){}}();
 import path from "node:path";
 import { pathExists, readFileIfExists, writeFileAtomic, } from "../fs/fs-utils.js";
 import { DEFAULT_STATUS_DEFINITIONS, DEFAULT_WORKFLOW_DEFINITION, } from "../shared/constants.js";
 import { RUNTIME_FIELD_COMMAND_VALUES, RUNTIME_FIELD_TYPE_VALUES, RUNTIME_STATUS_ROLE_VALUES, RUNTIME_UNKNOWN_FIELD_POLICY_VALUES, STATUS_VALUES, } from "../../types/index.js";
+import { normalizeStatusToken } from "./status-token.js";
 /** Fallback runtime schema file paths used when callers do not provide an override. */
 export const DEFAULT_RUNTIME_SCHEMA_FILE_PATHS = Object.freeze({
     types: "schema/types.json",
@@ -39,14 +40,6 @@ function normalizeStringList(values) {
             .filter((value) => value.length > 0)),
     ].sort((left, right) => left.localeCompare(right));
 }
-function normalizeStatusToken(value) {
-    return typeof value === "string"
-        ? value
-            .trim()
-            .toLowerCase()
-            .replaceAll(/[\s-]+/g, "_")
-        : "";
-}
 function normalizeStatusId(value) {
     if (typeof value !== "string" || value.length === 0) {
         return undefined;
@@ -698,4 +691,4 @@ export function statusIsTerminal(status, registry) {
     return registry.terminal_statuses.has(normalized);
 }
 //# sourceMappingURL=runtime-schema.js.map
-//# debugId=febba42b-dfd0-549a-a6d9-c30edb321d9d
+//# debugId=a9ff482a-f9f9-5e35-88d0-240db815ec08

package/dist/core/schema/status-defs-file.d.ts

@@ -1,4 +1,5 @@
 import type { RuntimeStatusDefinition, RuntimeStatusRole } from "../../types/index.js";
+export { normalizeStatusToken } from "./status-token.js";
 export type { RuntimeStatusDefinition, RuntimeStatusRole, } from "../../types/index.js";
 /** The 5 lifecycle status ids that ship as built-in defaults and may never be removed (their normalized ids match DEFAULT_RUNTIME_STATUS_DEFINITIONS: open/in_progress/blocked/closed/canceled). `draft` is also a default but the acceptance criteria enumerate the 5 terminal/active ids explicitly, so the guard derives the full set from the canonical defaults to stay in sync. */
 export declare const BUILTIN_STATUS_IDS: ReadonlySet<string>;
@@ -51,8 +52,6 @@ export interface RemoveStatusDefResult {
     /** The removed definition, when one matched the requested id. */
     definition?: RuntimeStatusDefinition;
 }
-/** Normalizes a status token using the same rules as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */
-export declare function normalizeStatusToken(value: unknown): string;
 /**
  * Validates and normalizes raw add-status CLI input. Throws a plain Error with a
  * stable message when the id is missing/empty or a role is not one of

package/dist/core/schema/status-defs-file.js

@@ -4,10 +4,11 @@
  * Resolves configurable schema, fields, statuses, and workflows for Status Defs File.
  */
 
-!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]="f81297bd-06ac-5aa4-9e1b-802fb50c9cd0")}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]="3eac0218-43c9-5bd2-8eaf-589d02d2c8ad")}catch(e){}}();
 import { RUNTIME_STATUS_ROLE_VALUES } from "../../types/index.js";
 import { DEFAULT_RUNTIME_STATUS_DEFINITIONS } from "./runtime-schema.js";
-import { evictOldestMemoEntries } from "../shared/memo.js";
+import { normalizeStatusToken } from "./status-token.js";
+export { normalizeStatusToken } from "./status-token.js";
 /**
  * Pure logic for the `pm schema add-status` / `pm schema remove-status`
  * commands. The CLI command file (schema.ts) owns IO/governance; everything
@@ -20,37 +21,8 @@ import { evictOldestMemoEntries } from "../shared/memo.js";
  * into the persisted file.
  */
 const RUNTIME_STATUS_ROLE_SET = new Set(RUNTIME_STATUS_ROLE_VALUES);
-/**
- * Memo for {@link normalizeStatusToken}. Status ranking inside sort comparators
- * normalizes the same handful of status strings O(n log n) times per corpus scan, and
- * the trim/lowercase/regex pipeline shows up in list/next/context profiles. The cap
- * bounds memory in long-lived hosts against unbounded arbitrary inputs; half-eviction keeps the
- * newest-inserted half when the cap is hit. Declared before
- * BUILTIN_STATUS_IDS, whose module-level initializer already normalizes tokens.
- */
-const STATUS_TOKEN_MEMO_MAX_ENTRIES = 2_000;
-const statusTokenMemo = new Map();
 /** The 5 lifecycle status ids that ship as built-in defaults and may never be removed (their normalized ids match DEFAULT_RUNTIME_STATUS_DEFINITIONS: open/in_progress/blocked/closed/canceled). `draft` is also a default but the acceptance criteria enumerate the 5 terminal/active ids explicitly, so the guard derives the full set from the canonical defaults to stay in sync. */
 export const BUILTIN_STATUS_IDS = new Set(DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition) => normalizeStatusToken(definition.id)).filter((id) => id.length > 0));
-/** Normalizes a status token using the same rules as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */
-export function normalizeStatusToken(value) {
-    if (typeof value !== "string") {
-        return "";
-    }
-    const memoized = statusTokenMemo.get(value);
-    if (memoized !== undefined) {
-        return memoized;
-    }
-    const normalized = value
-        .trim()
-        .toLowerCase()
-        .replaceAll(/[\s-]+/g, "_");
-    if (statusTokenMemo.size >= STATUS_TOKEN_MEMO_MAX_ENTRIES) {
-        evictOldestMemoEntries(statusTokenMemo);
-    }
-    statusTokenMemo.set(value, normalized);
-    return normalized;
-}
 function dedupeTokens(values) {
     const seen = new Set();
     for (const value of values) {
@@ -250,4 +222,4 @@ export function assertStatusTokensAvailable(input, resolvedAliasToId) {
     }
 }
 //# sourceMappingURL=status-defs-file.js.map
-//# debugId=f81297bd-06ac-5aa4-9e1b-802fb50c9cd0
+//# debugId=3eac0218-43c9-5bd2-8eaf-589d02d2c8ad

package/dist/core/schema/status-token.d.ts

@@ -0,0 +1,2 @@
+/** Lowercase a status token and collapse whitespace or hyphen runs to one underscore. */
+export declare function normalizeStatusToken(value: unknown): string;

package/dist/core/schema/status-token.js

@@ -0,0 +1,32 @@
+/**
+ * @module core/schema/status-token
+ *
+ * Owns the canonical bounded status-token normalization primitive used by
+ * schema files, runtime registries, workflows, and package-facing SDK 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]="d6056922-237d-525a-b354-687493a4e123")}catch(e){}}();
+import { evictOldestMemoEntries } from "../shared/memo.js";
+const STATUS_TOKEN_MEMO_MAX_ENTRIES = 2_000;
+const statusTokenMemo = new Map();
+/** Lowercase a status token and collapse whitespace or hyphen runs to one underscore. */
+export function normalizeStatusToken(value) {
+    if (typeof value !== "string") {
+        return "";
+    }
+    const memoized = statusTokenMemo.get(value);
+    if (memoized !== undefined) {
+        return memoized;
+    }
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replaceAll(/[\s-]+/g, "_");
+    if (statusTokenMemo.size >= STATUS_TOKEN_MEMO_MAX_ENTRIES) {
+        evictOldestMemoEntries(statusTokenMemo);
+    }
+    statusTokenMemo.set(value, normalized);
+    return normalized;
+}
+//# sourceMappingURL=status-token.js.map
+//# debugId=d6056922-237d-525a-b354-687493a4e123

package/dist/core/schema/type-workflows.d.ts

@@ -4,6 +4,7 @@
  * Resolves configurable schema, fields, statuses, and workflows for Type Workflows.
  */
 import type { RuntimeSchemaSettings } from "../../types/index.js";
+export { normalizeStatusToken } from "./status-token.js";
 /**
  * Per-type allowed-transition support (governance.workflow_enforcement).
  *
@@ -51,8 +52,6 @@ export interface EvaluateTransitionResult {
     /** Allowed [from, to] pairs for the matched type (normalized ids). Empty when the type is unrestricted. */
     allowedTransitions: [string, string][];
 }
-/** Normalize a status token the same way runtime-schema statuses are normalized. */
-export declare function normalizeStatusToken(value: unknown): string;
 /**
  * Normalize the raw type_workflows from a runtime schema into a deduped,
  * lower-cased-type list with normalized status tokens.

package/dist/core/schema/type-workflows.js

@@ -1,14 +1,7 @@
-/** Normalize a status token the same way runtime-schema statuses are normalized. */
 
-!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]="8370105a-2103-5425-8dd8-b621107f3bd8")}catch(e){}}();
-export function normalizeStatusToken(value) {
-    return typeof value === "string"
-        ? value
-            .trim()
-            .toLowerCase()
-            .replaceAll(/[\s-]+/g, "_")
-        : "";
-}
+!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]="c4e316a0-823d-5722-9e15-6d741ae44f1b")}catch(e){}}();
+import { normalizeStatusToken } from "./status-token.js";
+export { normalizeStatusToken } from "./status-token.js";
 function normalizeTypeName(value) {
     return typeof value === "string" ? value.trim().toLowerCase() : "";
 }
@@ -109,4 +102,4 @@ export function describeAllowedTransitions(allowedTransitions) {
         .join(", ");
 }
 //# sourceMappingURL=type-workflows.js.map
-//# debugId=8370105a-2103-5425-8dd8-b621107f3bd8
+//# debugId=c4e316a0-823d-5722-9e15-6d741ae44f1b

package/dist/core/shared/author.d.ts

@@ -24,7 +24,7 @@ export type AgentProvenanceAbsenceReason = "harness_unavailable" | "resolver_fai
 /** Machine-readable resolution outcome for one provenance dimension. */
 export interface AgentProvenanceOutcome {
     /** Whether the dimension resolved without retaining private source material. */
-    status: "resolved" | "unavailable" | "failed";
+    status: "resolved" | "unavailable" | "not_configured" | "failed";
     /** Stable bounded reason for absent or rejected values. */
     reason?: AgentProvenanceAbsenceReason;
     /** Resolver name when a bounded local resolver was attempted. */

package/dist/core/shared/author.js

@@ -4,7 +4,7 @@
  * Provides shared primitives and utilities for Author.
  */
 
-!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]="a89b5501-1909-5ea8-b34b-8ca9b4bc5dd5")}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]="6c075a14-1a65-59c7-a9c6-af348e30f821")}catch(e){}}();
 import { AsyncLocalStorage } from "node:async_hooks";
 import { createHash } from "node:crypto";
 import fs from "node:fs";
@@ -241,7 +241,10 @@ const AGENT_ROLE_VALUES = new Set([
 function normalizeProvenanceValue(dimension, value) {
     if (dimension !== "role" || value === undefined)
         return value;
-    const normalized = value.trim().toLowerCase().replaceAll(/[_\s]+/gu, "-");
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replaceAll(/[_\s]+/gu, "-");
     return AGENT_ROLE_VALUES.has(normalized) ? normalized : undefined;
 }
 function boundedProvenanceValue(provenance, dimension) {
@@ -310,13 +313,23 @@ function resolveProvenanceProbe(dimension, signals, env, descriptor) {
     }
     if (resolver === "ai_agent_version") {
         const value = nonBlank(env.AI_AGENT);
-        if (!value)
+        if (!value ||
+            !descriptor ||
+            !literalSignalMatches(value, descriptor.harness)) {
             return undefined;
+        }
         const match = /(?:^|[@/\s])v?(\d+\.\d+(?:\.\d+)?(?:[-+][A-Za-z0-9.-]+)?)$/u.exec(value);
         return match?.[1]?.slice(0, 256);
     }
     return undefined;
 }
+function provenanceResolverHasInput(resolver, descriptor, env) {
+    if (resolver === "ai_agent_version") {
+        const value = nonBlank(env.AI_AGENT);
+        return (value !== undefined && literalSignalMatches(value, descriptor.harness));
+    }
+    return nonBlank(env.CLAUDE_CODE_SESSION_ID) !== undefined;
+}
 function effectiveHarnessDetectionSignals(signals) {
     if (signals)
         return signals;
@@ -522,9 +535,7 @@ function resolveProvenanceOutcome(dimension, identity, descriptor, env, probesEn
         };
     }
     if (resolver) {
-        const resolverHasInput = resolver === "ai_agent_version"
-            ? nonBlank(env.AI_AGENT) !== undefined
-            : nonBlank(env.CLAUDE_CODE_SESSION_ID) !== undefined;
+        const resolverHasInput = provenanceResolverHasInput(resolver, descriptor, env);
         const status = resolverHasInput && probesEnabled ? "failed" : "unavailable";
         const reason = !resolverHasInput
             ? "harness_unavailable"
@@ -534,7 +545,9 @@ function resolveProvenanceOutcome(dimension, identity, descriptor, env, probesEn
         return { status, reason, resolver, rule_version: "v1" };
     }
     return {
-        status: "unavailable",
+        status: descriptor?.provenance_unavailable_dimensions.includes(dimension)
+            ? "unavailable"
+            : "not_configured",
         reason: descriptor?.provenance_unavailable_dimensions.includes(dimension)
             ? "harness_unavailable"
             : "resolver_not_configured",
@@ -680,4 +693,4 @@ export function resolveAuthor(candidate, fallback) {
     return identity.author;
 }
 //# sourceMappingURL=author.js.map
-//# debugId=a89b5501-1909-5ea8-b34b-8ca9b4bc5dd5
+//# debugId=6c075a14-1a65-59c7-a9c6-af348e30f821

package/dist/core/shared/errors.d.ts

@@ -60,6 +60,10 @@ export interface PmCliErrorContext {
     examples?: string[];
     /** Value that configures or reports next steps for this contract. */
     nextSteps?: string[];
+    /** Exact selectors that could not be matched by a lossless removal. */
+    unmatched?: string[];
+    /** Local dependency targets that could not be resolved before mutation. */
+    unresolved_targets?: string[];
     /** Available history bounds for a failed point-in-time read or restore target. */
     valid_range?: {
         /** Earliest available one-based version, or null for an empty stream. */

package/dist/core/shared/errors.js

@@ -1,6 +1,6 @@
 /** Implements the exported pm cli error runtime abstraction for core/shared/errors.ts. */
 
-!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]="c2c9251e-86bf-5a92-acdb-581e59d269d8")}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]="31191ce6-fb17-5b76-aa3d-3c3773cd85e0")}catch(e){}}();
 export class PmCliError extends Error {
     /** Value that configures or reports exit code for this contract. */
     exitCode;
@@ -18,4 +18,4 @@ export class PmCliError extends Error {
     }
 }
 //# sourceMappingURL=errors.js.map
-//# debugId=c2c9251e-86bf-5a92-acdb-581e59d269d8
+//# debugId=31191ce6-fb17-5b76-aa3d-3c3773cd85e0

package/dist/core/shared/text-normalization.d.ts

@@ -8,4 +8,4 @@ export declare function normalizeLowercaseWhitespace(value: string): string;
 /** Implements tokenize alpha numeric for the public runtime surface of this module. */
 export declare function tokenizeAlphaNumeric(value: string): string[];
 /** Implements jaccard similarity for the public runtime surface of this module. */
-export declare function jaccardSimilarity(leftTokens: string[], rightTokens: string[]): number;
+export declare function jaccardSimilarity(leftTokens: readonly string[], rightTokens: readonly string[]): number;

package/dist/core/shared/text-normalization.js

@@ -5,7 +5,7 @@
  */
 /** Normalizes text to lowercase whitespace-collapsed form for stable matching and comparison. */
 
-!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]="7288620a-5aa7-50f9-a271-45b2722a4887")}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]="3ad30a32-0f83-5473-b0a3-349e271d8378")}catch(e){}}();
 export function normalizeLowercaseWhitespace(value) {
     return value.trim().toLowerCase().replace(/\s+/g, " ");
 }
@@ -36,4 +36,4 @@ export function jaccardSimilarity(leftTokens, rightTokens) {
     return intersection / union;
 }
 //# sourceMappingURL=text-normalization.js.map
-//# debugId=7288620a-5aa7-50f9-a271-45b2722a4887
+//# debugId=3ad30a32-0f83-5473-b0a3-349e271d8378

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

@@ -0,0 +1,4 @@
+/** 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 `--`. */
+export declare function renderMissingOptionRetry(invocationArgv: string[], commandName: string, missingLabels: string[]): string | undefined;

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

@@ -0,0 +1,52 @@
+/**
+ * @module sdk/command-recovery
+ *
+ * Builds executable recovery commands from tokenized argv and declared CLI
+ * flag domains. Display labels are normalized back to real flag tokens and
+ * 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){}}();
+import { renderPmCommand } from "../command-line.js";
+import { resolveSubcommandFlagContractsForCommand } from "../cli-contracts.js";
+function normalizeMissingFlag(label) {
+    const match = label.trim().match(/--[a-z0-9][a-z0-9_-]*/i);
+    return match?.[0]?.replaceAll("_", "-").toLowerCase();
+}
+/** Resolve the truthful placeholder for a missing flag from its contract. */
+export function resolveMissingOptionPlaceholder(commandName, missingLabel) {
+    const flag = normalizeMissingFlag(missingLabel);
+    if (!flag)
+        return undefined;
+    const contract = resolveSubcommandFlagContractsForCommand(commandName).find((entry) => entry.flag === flag || entry.aliases?.includes(flag));
+    if (!contract)
+        return "<value>";
+    if (contract.value_type === "boolean") {
+        return null;
+    }
+    return `<${contract.value_name ?? "value"}>`;
+}
+/** Preserve an attempted argv vector and insert each missing option before `--`. */
+export function renderMissingOptionRetry(invocationArgv, commandName, missingLabels) {
+    const retry = [...invocationArgv];
+    const terminatorIndex = retry.indexOf("--");
+    let insertionIndex = terminatorIndex < 0 ? retry.length : terminatorIndex;
+    for (const label of missingLabels) {
+        const flag = normalizeMissingFlag(label);
+        if (!flag ||
+            retry
+                .slice(0, insertionIndex)
+                .some((token) => token === flag || token.startsWith(`${flag}=`))) {
+            continue;
+        }
+        const placeholder = resolveMissingOptionPlaceholder(commandName, flag);
+        const recoveredOption = placeholder ? [flag, placeholder] : [flag];
+        retry.splice(insertionIndex, 0, ...recoveredOption);
+        insertionIndex += recoveredOption.length;
+    }
+    return retry.length === invocationArgv.length
+        ? undefined
+        : renderPmCommand(retry);
+}
+//# sourceMappingURL=command-recovery.js.map
+//# debugId=ab87f46c-c9b4-51d1-a712-fbce7c79fca9

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

@@ -0,0 +1,4 @@
+/** Score one command path for a guessed command token; lower is better. */
+export declare function scoreCommandPathMatch(commandPath: string, queryToken: string): number;
+/** Rank available command paths for one guessed token. */
+export declare function rankCommandPaths(commandPaths: string[], queryToken: string): string[];

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

@@ -0,0 +1,67 @@
+/**
+ * @module sdk/command-suggestions
+ *
+ * Provides deterministic, agent-oriented command suggestion ranking. Semantic
+ * verb aliases rank first, bounded edit distance second, and substring matches
+ * last so `log` never prefers `catalog` over item history commands.
+ */
+
+!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]="71e5a870-f62f-5252-b4e9-e1a42e36009f")}catch(e){}}();
+import { levenshteinDistanceWithinLimit } from "../../core/shared/levenshtein.js";
+const COMMAND_SYNONYMS = {
+    add: ["create", "append"],
+    fetch: ["get"],
+    inspect: ["get", "health"],
+    log: ["history", "comments", "notes"],
+    ls: ["list"],
+    pause: ["release"],
+    read: ["get"],
+    remove: ["delete"],
+    rm: ["delete"],
+    show: ["get"],
+};
+/** Score one command path for a guessed command token; lower is better. */
+export function scoreCommandPathMatch(commandPath, queryToken) {
+    const normalizedPath = commandPath.trim().toLowerCase();
+    const normalizedToken = queryToken.trim().toLowerCase();
+    if (normalizedToken.length === 0)
+        return Number.POSITIVE_INFINITY;
+    const segments = normalizedPath.split(" ");
+    const semanticIndex = COMMAND_SYNONYMS[normalizedToken]?.indexOf(normalizedPath);
+    if (semanticIndex !== undefined && semanticIndex >= 0)
+        return semanticIndex;
+    if (normalizedPath === normalizedToken)
+        return 10;
+    if (segments.includes(normalizedToken))
+        return 11;
+    if (segments.some((segment) => segment.startsWith(normalizedToken)))
+        return 12;
+    const maxDistance = normalizedToken.length >= 5 ? 2 : 1;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const segment of segments) {
+        const distance = levenshteinDistanceWithinLimit(segment, normalizedToken, maxDistance);
+        if (distance !== null)
+            bestDistance = Math.min(bestDistance, distance);
+    }
+    if (Number.isFinite(bestDistance))
+        return 20 + bestDistance;
+    if (normalizedPath.includes(normalizedToken))
+        return 30;
+    return Number.POSITIVE_INFINITY;
+}
+/** Rank available command paths for one guessed token. */
+export function rankCommandPaths(commandPaths, queryToken) {
+    return commandPaths
+        .map((path) => ({ path, score: scoreCommandPathMatch(path, queryToken) }))
+        .filter((entry) => Number.isFinite(entry.score))
+        .sort((left, right) => {
+        if (left.score !== right.score)
+            return left.score - right.score;
+        if (left.path === right.path)
+            return 0;
+        return left.path < right.path ? -1 : 1;
+    })
+        .map((entry) => entry.path);
+}
+//# sourceMappingURL=command-suggestions.js.map
+//# debugId=71e5a870-f62f-5252-b4e9-e1a42e36009f

package/dist/sdk/agent/create-option-policy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module sdk/create-option-policy
+ *
+ * Defines explicit-empty assertions for repeatable create options. A strict
+ * schema can require that an agent considers a collection without forcing it
+ * to invent an entry: the corresponding `--clear-*` flag is an auditable,
+ * truthful answer that the collection is intentionally empty.
+ */
+/** Return the explicit-empty flag for a repeatable create option. */
+export declare function resolveCreateExplicitEmptyFlag(optionKey: string): string | undefined;
+/** Return whether a create option can be satisfied by an explicit empty set. */
+export declare function supportsCreateExplicitEmpty(optionKey: string): boolean;

package/dist/sdk/agent/create-option-policy.js

@@ -0,0 +1,32 @@
+/**
+ * @module sdk/create-option-policy
+ *
+ * Defines explicit-empty assertions for repeatable create options. A strict
+ * schema can require that an agent considers a collection without forcing it
+ * to invent an entry: the corresponding `--clear-*` flag is an auditable,
+ * truthful answer that the collection is intentionally empty.
+ */
+
+!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]="002f45a2-edc3-5aa0-9af8-d9b1dfecc097")}catch(e){}}();
+const CREATE_REPEATABLE_CLEAR_FLAGS = {
+    comment: "--clear-comments",
+    dep: "--clear-deps",
+    doc: "--clear-docs",
+    event: "--clear-events",
+    file: "--clear-files",
+    learning: "--clear-learnings",
+    note: "--clear-notes",
+    reminder: "--clear-reminders",
+    test: "--clear-tests",
+    typeOption: "--clear-type-options",
+};
+/** Return the explicit-empty flag for a repeatable create option. */
+export function resolveCreateExplicitEmptyFlag(optionKey) {
+    return CREATE_REPEATABLE_CLEAR_FLAGS[optionKey];
+}
+/** Return whether a create option can be satisfied by an explicit empty set. */
+export function supportsCreateExplicitEmpty(optionKey) {
+    return resolveCreateExplicitEmptyFlag(optionKey) !== undefined;
+}
+//# sourceMappingURL=create-option-policy.js.map
+//# debugId=002f45a2-edc3-5aa0-9af8-d9b1dfecc097

package/dist/sdk/agent/item-addressing.d.ts

@@ -0,0 +1,19 @@
+/** Result of normalizing one item-addressed invocation. */
+export interface ItemAddressInvocationResult {
+    /** Canonical argv with an `--id` value moved into positional-id location. */
+    argv: string[];
+    /** Whether argv changed. */
+    changed: boolean;
+    /** Whether both positional and named item ids were supplied. */
+    conflict: boolean;
+    /** Resolved named item id when one was present. */
+    itemId?: string;
+}
+/** Return whether a command participates in the shared item-id alias contract. */
+export declare function supportsItemIdAlias(commandName: string | undefined): boolean;
+/**
+ * Normalize `pm <command> --id <value>` to the command's positional id form.
+ * The transformation is lossless for every other argument and reports a
+ * conflict instead of guessing when both forms are present.
+ */
+export declare function normalizeItemAddressInvocation(argv: string[]): ItemAddressInvocationResult;