@unbrained/pm-cli 2026.5.30 → 2026.6.5

package/dist/core/checkpoint/mutation-checkpoint.d.ts

@@ -0,0 +1,44 @@
+export interface MutationCheckpointItem {
+    id: string;
+    target_updated_at: string;
+}
+export interface LoadedMutationCheckpoint {
+    /** The full on-disk record so callers can read their command-specific fields. */
+    record: Record<string, unknown>;
+    /** Validated item list (id + target_updated_at). */
+    items: MutationCheckpointItem[];
+    /** Absolute path the checkpoint was read from. */
+    path: string;
+    id: string;
+    created_at: string;
+    author: string;
+}
+export interface CheckpointRollbackRow {
+    id: string;
+    status: "restored" | "failed";
+    changed_fields?: string[];
+    warnings?: string[];
+    error?: string;
+}
+export interface CheckpointRollbackResult {
+    rows: CheckpointRollbackRow[];
+    restored_ids: string[];
+    failed_count: number;
+}
+/** Restore a single item to its captured pre-mutation timestamp. */
+export type CheckpointRestoreFn = (id: string, targetUpdatedAt: string) => Promise<{
+    changed_fields?: string[];
+    warnings?: string[];
+}>;
+export declare function normalizeCheckpointId(raw: string): string;
+export declare function createCheckpointId(prefix: string, nowValue: string): string;
+export declare function checkpointDirectoryPath(pmRoot: string, subdir: string): string;
+export declare function checkpointFilePath(pmRoot: string, subdir: string, checkpointId: string): string;
+export declare function writeMutationCheckpoint(pmRoot: string, subdir: string, checkpointId: string, payload: unknown): Promise<string>;
+export declare function loadMutationCheckpoint(pmRoot: string, subdir: string, rawCheckpointId: string, schemaVersion: number): Promise<LoadedMutationCheckpoint>;
+/**
+ * Restore every checkpointed item to its captured pre-mutation timestamp,
+ * collecting per-item rows. A single item's failure is recorded and does not
+ * abort the remaining restores.
+ */
+export declare function restoreCheckpointItems(items: MutationCheckpointItem[], restore: CheckpointRestoreFn): Promise<CheckpointRollbackResult>;

package/dist/core/checkpoint/mutation-checkpoint.js

@@ -0,0 +1,119 @@
+
+!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]="703d6134-bb1d-5d13-8150-c611bbdf82d2")}catch(e){}}();
+import { mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { pathExists, writeFileAtomic } from "../fs/fs-utils.js";
+import { EXIT_CODE } from "../shared/constants.js";
+import { PmCliError } from "../shared/errors.js";
+import { toErrorMessage } from "../shared/primitives.js";
+import { nowIso } from "../shared/time.js";
+export function normalizeCheckpointId(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new PmCliError("--rollback requires a non-empty checkpoint ID", EXIT_CODE.USAGE);
+    }
+    if (!/^[a-zA-Z0-9._-]+$/.test(trimmed)) {
+        throw new PmCliError("--rollback checkpoint ID must match [a-zA-Z0-9._-]+", EXIT_CODE.USAGE);
+    }
+    return trimmed;
+}
+export function createCheckpointId(prefix, nowValue) {
+    const compactTimestamp = nowValue.replace(/[-:.TZ]/g, "").slice(0, 14);
+    const randomSuffix = Math.random().toString(36).slice(2, 8);
+    return `${prefix}-${compactTimestamp}-${randomSuffix}`;
+}
+export function checkpointDirectoryPath(pmRoot, subdir) {
+    return path.join(pmRoot, "checkpoints", subdir);
+}
+export function checkpointFilePath(pmRoot, subdir, checkpointId) {
+    return path.join(checkpointDirectoryPath(pmRoot, subdir), `${checkpointId}.json`);
+}
+export async function writeMutationCheckpoint(pmRoot, subdir, checkpointId, payload) {
+    const checkpointDir = checkpointDirectoryPath(pmRoot, subdir);
+    await mkdir(checkpointDir, { recursive: true });
+    const filePath = checkpointFilePath(pmRoot, subdir, checkpointId);
+    await writeFileAtomic(filePath, `${JSON.stringify(payload, null, 2)}\n`);
+    return filePath;
+}
+function parseCheckpointItems(record, checkpointId) {
+    if (!Array.isArray(record.items)) {
+        throw new PmCliError(`Checkpoint ${checkpointId} is missing items`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    return record.items.map((entry) => {
+        if (!entry || typeof entry !== "object") {
+            throw new PmCliError(`Checkpoint ${checkpointId} contains an invalid item entry`, EXIT_CODE.GENERIC_FAILURE);
+        }
+        const row = entry;
+        if (typeof row.id !== "string" || row.id.trim().length === 0) {
+            throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without ID`, EXIT_CODE.GENERIC_FAILURE);
+        }
+        if (typeof row.target_updated_at !== "string" || row.target_updated_at.trim().length === 0) {
+            throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without target_updated_at`, EXIT_CODE.GENERIC_FAILURE);
+        }
+        return { id: row.id.trim(), target_updated_at: row.target_updated_at.trim() };
+    });
+}
+export async function loadMutationCheckpoint(pmRoot, subdir, rawCheckpointId, schemaVersion) {
+    const normalizedId = normalizeCheckpointId(rawCheckpointId);
+    const filePath = checkpointFilePath(pmRoot, subdir, normalizedId);
+    if (!(await pathExists(filePath))) {
+        throw new PmCliError(`Checkpoint ${normalizedId} not found`, EXIT_CODE.NOT_FOUND);
+    }
+    const raw = await readFile(filePath, "utf8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new PmCliError(`Checkpoint ${normalizedId} contains invalid JSON: ${toErrorMessage(error)}`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    if (!parsed || typeof parsed !== "object") {
+        throw new PmCliError(`Checkpoint ${normalizedId} is invalid`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    const record = parsed;
+    if (record.schema_version !== schemaVersion) {
+        throw new PmCliError(`Checkpoint ${normalizedId} has unsupported schema version`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    const items = parseCheckpointItems(record, normalizedId);
+    return {
+        record,
+        items,
+        path: filePath,
+        id: typeof record.id === "string" ? record.id : normalizedId,
+        // Defensive recovery for malformed checkpoint metadata; normal writes
+        // always include these fields, so fallbacks keep rollback inspectable.
+        created_at: typeof record.created_at === "string" ? record.created_at : nowIso(),
+        author: typeof record.author === "string" ? record.author : "unknown",
+    };
+}
+/**
+ * Restore every checkpointed item to its captured pre-mutation timestamp,
+ * collecting per-item rows. A single item's failure is recorded and does not
+ * abort the remaining restores.
+ */
+export async function restoreCheckpointItems(items, restore) {
+    const rows = [];
+    const restoredIds = [];
+    for (const entry of items) {
+        try {
+            const restored = await restore(entry.id, entry.target_updated_at);
+            rows.push({
+                id: entry.id,
+                status: "restored",
+                changed_fields: restored.changed_fields,
+                warnings: restored.warnings,
+            });
+            restoredIds.push(entry.id);
+        }
+        catch (error) {
+            rows.push({ id: entry.id, status: "failed", error: toErrorMessage(error) });
+        }
+    }
+    return {
+        rows,
+        restored_ids: restoredIds,
+        failed_count: rows.filter((row) => row.status === "failed").length,
+    };
+}
+//# sourceMappingURL=mutation-checkpoint.js.map
+//# debugId=703d6134-bb1d-5d13-8150-c611bbdf82d2

package/dist/core/checkpoint/mutation-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-checkpoint.js","sources":["core/checkpoint/mutation-checkpoint.ts"],"sourceRoot":"/","sourcesContent":["import { mkdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { nowIso } from \"../shared/time.js\";\n\n// Shared checkpoint + rollback machinery for bulk-mutation commands\n// (`update-many`, `close-many`). Each command owns its own checkpoint payload\n// shape (the extra fields it records) but reuses the common id/path/validation\n// helpers and the restore loop so the durable rollback contract — capture each\n// matched item's pre-mutation updated_at, then restore-to-timestamp on\n// rollback — stays identical across commands and is not duplicated.\n\nexport interface MutationCheckpointItem {\n  id: string;\n  target_updated_at: string;\n}\n\nexport interface LoadedMutationCheckpoint {\n  /** The full on-disk record so callers can read their command-specific fields. */\n  record: Record<string, unknown>;\n  /** Validated item list (id + target_updated_at). */\n  items: MutationCheckpointItem[];\n  /** Absolute path the checkpoint was read from. */\n  path: string;\n  id: string;\n  created_at: string;\n  author: string;\n}\n\nexport interface CheckpointRollbackRow {\n  id: string;\n  status: \"restored\" | \"failed\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\nexport interface CheckpointRollbackResult {\n  rows: CheckpointRollbackRow[];\n  restored_ids: string[];\n  failed_count: number;\n}\n\n/** Restore a single item to its captured pre-mutation timestamp. */\nexport type CheckpointRestoreFn = (\n  id: string,\n  targetUpdatedAt: string,\n) => Promise<{ changed_fields?: string[]; warnings?: string[] }>;\n\nexport function normalizeCheckpointId(raw: string): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    throw new PmCliError(\"--rollback requires a non-empty checkpoint ID\", EXIT_CODE.USAGE);\n  }\n  if (!/^[a-zA-Z0-9._-]+$/.test(trimmed)) {\n    throw new PmCliError(\"--rollback checkpoint ID must match [a-zA-Z0-9._-]+\", EXIT_CODE.USAGE);\n  }\n  return trimmed;\n}\n\nexport function createCheckpointId(prefix: string, nowValue: string): string {\n  const compactTimestamp = nowValue.replace(/[-:.TZ]/g, \"\").slice(0, 14);\n  const randomSuffix = Math.random().toString(36).slice(2, 8);\n  return `${prefix}-${compactTimestamp}-${randomSuffix}`;\n}\n\nexport function checkpointDirectoryPath(pmRoot: string, subdir: string): string {\n  return path.join(pmRoot, \"checkpoints\", subdir);\n}\n\nexport function checkpointFilePath(pmRoot: string, subdir: string, checkpointId: string): string {\n  return path.join(checkpointDirectoryPath(pmRoot, subdir), `${checkpointId}.json`);\n}\n\nexport async function writeMutationCheckpoint(\n  pmRoot: string,\n  subdir: string,\n  checkpointId: string,\n  payload: unknown,\n): Promise<string> {\n  const checkpointDir = checkpointDirectoryPath(pmRoot, subdir);\n  await mkdir(checkpointDir, { recursive: true });\n  const filePath = checkpointFilePath(pmRoot, subdir, checkpointId);\n  await writeFileAtomic(filePath, `${JSON.stringify(payload, null, 2)}\\n`);\n  return filePath;\n}\n\nfunction parseCheckpointItems(record: Record<string, unknown>, checkpointId: string): MutationCheckpointItem[] {\n  if (!Array.isArray(record.items)) {\n    throw new PmCliError(`Checkpoint ${checkpointId} is missing items`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  return record.items.map((entry) => {\n    if (!entry || typeof entry !== \"object\") {\n      throw new PmCliError(`Checkpoint ${checkpointId} contains an invalid item entry`, EXIT_CODE.GENERIC_FAILURE);\n    }\n    const row = entry as Record<string, unknown>;\n    if (typeof row.id !== \"string\" || row.id.trim().length === 0) {\n      throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without ID`, EXIT_CODE.GENERIC_FAILURE);\n    }\n    if (typeof row.target_updated_at !== \"string\" || row.target_updated_at.trim().length === 0) {\n      throw new PmCliError(\n        `Checkpoint ${checkpointId} contains an item entry without target_updated_at`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    return { id: row.id.trim(), target_updated_at: row.target_updated_at.trim() };\n  });\n}\n\nexport async function loadMutationCheckpoint(\n  pmRoot: string,\n  subdir: string,\n  rawCheckpointId: string,\n  schemaVersion: number,\n): Promise<LoadedMutationCheckpoint> {\n  const normalizedId = normalizeCheckpointId(rawCheckpointId);\n  const filePath = checkpointFilePath(pmRoot, subdir, normalizedId);\n  if (!(await pathExists(filePath))) {\n    throw new PmCliError(`Checkpoint ${normalizedId} not found`, EXIT_CODE.NOT_FOUND);\n  }\n  const raw = await readFile(filePath, \"utf8\");\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Checkpoint ${normalizedId} contains invalid JSON: ${toErrorMessage(error)}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  if (!parsed || typeof parsed !== \"object\") {\n    throw new PmCliError(`Checkpoint ${normalizedId} is invalid`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  const record = parsed as Record<string, unknown>;\n  if (record.schema_version !== schemaVersion) {\n    throw new PmCliError(`Checkpoint ${normalizedId} has unsupported schema version`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  const items = parseCheckpointItems(record, normalizedId);\n  return {\n    record,\n    items,\n    path: filePath,\n    id: typeof record.id === \"string\" ? record.id : normalizedId,\n    // Defensive recovery for malformed checkpoint metadata; normal writes\n    // always include these fields, so fallbacks keep rollback inspectable.\n    created_at: typeof record.created_at === \"string\" ? record.created_at : nowIso(),\n    author: typeof record.author === \"string\" ? record.author : \"unknown\",\n  };\n}\n\n/**\n * Restore every checkpointed item to its captured pre-mutation timestamp,\n * collecting per-item rows. A single item's failure is recorded and does not\n * abort the remaining restores.\n */\nexport async function restoreCheckpointItems(\n  items: MutationCheckpointItem[],\n  restore: CheckpointRestoreFn,\n): Promise<CheckpointRollbackResult> {\n  const rows: CheckpointRollbackRow[] = [];\n  const restoredIds: string[] = [];\n  for (const entry of items) {\n    try {\n      const restored = await restore(entry.id, entry.target_updated_at);\n      rows.push({\n        id: entry.id,\n        status: \"restored\",\n        changed_fields: restored.changed_fields,\n        warnings: restored.warnings,\n      });\n      restoredIds.push(entry.id);\n    } catch (error: unknown) {\n      rows.push({ id: entry.id, status: \"failed\", error: toErrorMessage(error) });\n    }\n  }\n  return {\n    rows,\n    restored_ids: restoredIds,\n    failed_count: rows.filter((row) => row.status === \"failed\").length,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"703d6134-bb1d-5d13-8150-c611bbdf82d2"}

package/dist/core/config/positional-value.js

@@ -10,7 +10,7 @@
  * good error messages.
  */
 
-!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]="2395fa10-67f6-5cde-969a-336588fccb3e")}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]="fd40ea7d-d52d-54b7-ab73-89bebc4a762e")}catch(e){}}();
 const FORMAT_KEYS = new Set(["item_format"]);
 const CRITERIA_KEYS = new Set([
     "definition_of_done",
@@ -29,6 +29,8 @@ const POLICY_KEYS = new Set([
     "governance_ownership_enforcement",
     "governance_create_mode_default",
     "governance_close_validation_default",
+    "governance_create_default_type",
+    "governance_workflow_enforcement",
     "governance_parent_reference_policy",
     "governance_metadata_validation_profile",
     "governance_force_required_for_stale_lock",
@@ -106,4 +108,4 @@ export function resolveConfigPositionalValue(canonicalKeyOrAlias, value) {
     return { routable: true, flag: "policy", value: policyValue };
 }
 //# sourceMappingURL=positional-value.js.map
-//# debugId=2395fa10-67f6-5cde-969a-336588fccb3e
+//# debugId=fd40ea7d-d52d-54b7-ab73-89bebc4a762e

package/dist/core/config/positional-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"positional-value.js","sources":["core/config/positional-value.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Pure routing helper for the optional positional `value` argument of `pm config set`.\n *\n * `pm config set <key> <value>` is the intuitive form agents reach for, but config\n * VALUES are actually carried by typed flags (`--format`, `--policy`, `--criterion`).\n * This module maps a config key (kebab or snake form, canonical or alias) plus a raw\n * positional value onto the typed flag it should populate, applying enabled/disabled\n * synonyms (off/on/true/false) for boolean-style policy keys. The existing per-key\n * validators in config.ts still run on the routed value, so bad values keep their\n * good error messages.\n */\n\n/** The typed flag a positional value routes to. */\nexport type ConfigPositionalFlag = \"format\" | \"policy\" | \"criterion\";\n\n/** Successful routing of a positional value to a single-value typed flag. */\nexport interface ConfigPositionalScalarRouted {\n  routable: true;\n  flag: \"format\" | \"policy\";\n  /** Normalized scalar value for single-value flags. */\n  value: string;\n}\n\n/** Successful routing of a positional value to the criteria-list flag. */\nexport interface ConfigPositionalListRouted {\n  routable: true;\n  flag: \"criterion\";\n  /** Criteria-list flag (`--criterion`) value, supplied as a values array. */\n  values: string[];\n}\n\nexport type ConfigPositionalRouted = ConfigPositionalScalarRouted | ConfigPositionalListRouted;\n\n/** A key whose value cannot be carried by a single positional (e.g. `context`). */\nexport interface ConfigPositionalNotRoutable {\n  routable: false;\n  /** Human/agent-facing reason + the flags to use instead. */\n  reason: string;\n}\n\nexport type ConfigPositionalResult = ConfigPositionalRouted | ConfigPositionalNotRoutable;\n\n/** Canonical snake-case config keys this helper understands. */\ntype CanonicalConfigKey =\n  | \"definition_of_done\"\n  | \"item_format\"\n  | \"history_missing_stream_policy\"\n  | \"sprint_release_format_policy\"\n  | \"parent_reference_policy\"\n  | \"metadata_validation_profile\"\n  | \"metadata_required_fields\"\n  | \"lifecycle_stale_blocker_reason_patterns\"\n  | \"lifecycle_closure_like_blocked_reason_patterns\"\n  | \"lifecycle_closure_like_resolution_patterns\"\n  | \"lifecycle_closure_like_actual_result_patterns\"\n  | \"governance_preset\"\n  | \"governance_ownership_enforcement\"\n  | \"governance_create_mode_default\"\n  | \"governance_close_validation_default\"\n  | \"governance_parent_reference_policy\"\n  | \"governance_metadata_validation_profile\"\n  | \"governance_force_required_for_stale_lock\"\n  | \"test_result_tracking\"\n  | \"telemetry_tracking\"\n  | \"context\";\n\nconst FORMAT_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\"item_format\"]);\n\nconst CRITERIA_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"definition_of_done\",\n  \"metadata_required_fields\",\n  \"lifecycle_stale_blocker_reason_patterns\",\n  \"lifecycle_closure_like_blocked_reason_patterns\",\n  \"lifecycle_closure_like_resolution_patterns\",\n  \"lifecycle_closure_like_actual_result_patterns\",\n]);\n\nconst POLICY_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"history_missing_stream_policy\",\n  \"sprint_release_format_policy\",\n  \"parent_reference_policy\",\n  \"metadata_validation_profile\",\n  \"governance_preset\",\n  \"governance_ownership_enforcement\",\n  \"governance_create_mode_default\",\n  \"governance_close_validation_default\",\n  \"governance_parent_reference_policy\",\n  \"governance_metadata_validation_profile\",\n  \"governance_force_required_for_stale_lock\",\n  \"test_result_tracking\",\n  \"telemetry_tracking\",\n]);\n\n/**\n * Policy keys whose only valid values are enabled/disabled. For these we accept the\n * intuitive synonyms off/on/true/false. Other policy keys pass through unchanged so\n * their own validators report the precise allowed set.\n */\nconst ENABLED_DISABLED_POLICY_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"governance_force_required_for_stale_lock\",\n  \"test_result_tracking\",\n  \"telemetry_tracking\",\n]);\n\nconst ENABLED_DISABLED_SYNONYMS: Record<string, string> = {\n  off: \"disabled\",\n  on: \"enabled\",\n  true: \"enabled\",\n  false: \"disabled\",\n  enabled: \"enabled\",\n  disabled: \"disabled\",\n};\n\n/** Normalize any kebab/snake key form to the canonical snake key (or undefined). */\nfunction toCanonicalKey(keyOrAlias: string): CanonicalConfigKey | undefined {\n  const normalized = keyOrAlias.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (\n    FORMAT_KEYS.has(normalized as CanonicalConfigKey) ||\n    CRITERIA_KEYS.has(normalized as CanonicalConfigKey) ||\n    POLICY_KEYS.has(normalized as CanonicalConfigKey) ||\n    normalized === \"context\"\n  ) {\n    return normalized as CanonicalConfigKey;\n  }\n  return undefined;\n}\n\n/**\n * Map an enabled/disabled-style value through its synonyms (case-insensitive). Values\n * that are not synonyms pass through unchanged so the downstream validator can reject\n * them with its own message.\n */\nfunction normalizeEnabledDisabled(value: string): string {\n  const normalized = value.trim().toLowerCase();\n  return ENABLED_DISABLED_SYNONYMS[normalized] ?? value;\n}\n\n/**\n * Resolve which typed flag a positional `pm config set <key> <value>` value should\n * populate, plus the normalized value.\n *\n * Returns `{ routable: false, reason }` for keys that require multiple/structured\n * flags (e.g. `context`). Unknown keys also return `routable: false` so the caller\n * can fall back to the existing invalid-key path.\n */\nexport function resolveConfigPositionalValue(\n  canonicalKeyOrAlias: string,\n  value: string,\n): ConfigPositionalResult {\n  const key = toCanonicalKey(canonicalKeyOrAlias);\n  if (key === undefined) {\n    return {\n      routable: false,\n      reason: `Unknown config key \"${canonicalKeyOrAlias}\" cannot route a positional value.`,\n    };\n  }\n\n  if (key === \"context\") {\n    return {\n      routable: false,\n      reason:\n        'Config set context does not accept a positional value. Use --default-depth, --activity-limit, --stale-threshold-days, or --section-<name> flags.',\n    };\n  }\n\n  if (FORMAT_KEYS.has(key)) {\n    return { routable: true, flag: \"format\", value };\n  }\n\n  if (CRITERIA_KEYS.has(key)) {\n    return { routable: true, flag: \"criterion\", values: [value] };\n  }\n\n  // policy key\n  const policyValue = ENABLED_DISABLED_POLICY_KEYS.has(key) ? normalizeEnabledDisabled(value) : value;\n  return { routable: true, flag: \"policy\", value: policyValue };\n}\n"],"names":[],"mappings":"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","debugId":"2395fa10-67f6-5cde-969a-336588fccb3e"}
+{"version":3,"file":"positional-value.js","sources":["core/config/positional-value.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Pure routing helper for the optional positional `value` argument of `pm config set`.\n *\n * `pm config set <key> <value>` is the intuitive form agents reach for, but config\n * VALUES are actually carried by typed flags (`--format`, `--policy`, `--criterion`).\n * This module maps a config key (kebab or snake form, canonical or alias) plus a raw\n * positional value onto the typed flag it should populate, applying enabled/disabled\n * synonyms (off/on/true/false) for boolean-style policy keys. The existing per-key\n * validators in config.ts still run on the routed value, so bad values keep their\n * good error messages.\n */\n\n/** The typed flag a positional value routes to. */\nexport type ConfigPositionalFlag = \"format\" | \"policy\" | \"criterion\";\n\n/** Successful routing of a positional value to a single-value typed flag. */\nexport interface ConfigPositionalScalarRouted {\n  routable: true;\n  flag: \"format\" | \"policy\";\n  /** Normalized scalar value for single-value flags. */\n  value: string;\n}\n\n/** Successful routing of a positional value to the criteria-list flag. */\nexport interface ConfigPositionalListRouted {\n  routable: true;\n  flag: \"criterion\";\n  /** Criteria-list flag (`--criterion`) value, supplied as a values array. */\n  values: string[];\n}\n\nexport type ConfigPositionalRouted = ConfigPositionalScalarRouted | ConfigPositionalListRouted;\n\n/** A key whose value cannot be carried by a single positional (e.g. `context`). */\nexport interface ConfigPositionalNotRoutable {\n  routable: false;\n  /** Human/agent-facing reason + the flags to use instead. */\n  reason: string;\n}\n\nexport type ConfigPositionalResult = ConfigPositionalRouted | ConfigPositionalNotRoutable;\n\n/** Canonical snake-case config keys this helper understands. */\ntype CanonicalConfigKey =\n  | \"definition_of_done\"\n  | \"item_format\"\n  | \"history_missing_stream_policy\"\n  | \"sprint_release_format_policy\"\n  | \"parent_reference_policy\"\n  | \"metadata_validation_profile\"\n  | \"metadata_required_fields\"\n  | \"lifecycle_stale_blocker_reason_patterns\"\n  | \"lifecycle_closure_like_blocked_reason_patterns\"\n  | \"lifecycle_closure_like_resolution_patterns\"\n  | \"lifecycle_closure_like_actual_result_patterns\"\n  | \"governance_preset\"\n  | \"governance_ownership_enforcement\"\n  | \"governance_create_mode_default\"\n  | \"governance_close_validation_default\"\n  | \"governance_create_default_type\"\n  | \"governance_workflow_enforcement\"\n  | \"governance_parent_reference_policy\"\n  | \"governance_metadata_validation_profile\"\n  | \"governance_force_required_for_stale_lock\"\n  | \"test_result_tracking\"\n  | \"telemetry_tracking\"\n  | \"context\";\n\nconst FORMAT_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\"item_format\"]);\n\nconst CRITERIA_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"definition_of_done\",\n  \"metadata_required_fields\",\n  \"lifecycle_stale_blocker_reason_patterns\",\n  \"lifecycle_closure_like_blocked_reason_patterns\",\n  \"lifecycle_closure_like_resolution_patterns\",\n  \"lifecycle_closure_like_actual_result_patterns\",\n]);\n\nconst POLICY_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"history_missing_stream_policy\",\n  \"sprint_release_format_policy\",\n  \"parent_reference_policy\",\n  \"metadata_validation_profile\",\n  \"governance_preset\",\n  \"governance_ownership_enforcement\",\n  \"governance_create_mode_default\",\n  \"governance_close_validation_default\",\n  \"governance_create_default_type\",\n  \"governance_workflow_enforcement\",\n  \"governance_parent_reference_policy\",\n  \"governance_metadata_validation_profile\",\n  \"governance_force_required_for_stale_lock\",\n  \"test_result_tracking\",\n  \"telemetry_tracking\",\n]);\n\n/**\n * Policy keys whose only valid values are enabled/disabled. For these we accept the\n * intuitive synonyms off/on/true/false. Other policy keys pass through unchanged so\n * their own validators report the precise allowed set.\n */\nconst ENABLED_DISABLED_POLICY_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"governance_force_required_for_stale_lock\",\n  \"test_result_tracking\",\n  \"telemetry_tracking\",\n]);\n\nconst ENABLED_DISABLED_SYNONYMS: Record<string, string> = {\n  off: \"disabled\",\n  on: \"enabled\",\n  true: \"enabled\",\n  false: \"disabled\",\n  enabled: \"enabled\",\n  disabled: \"disabled\",\n};\n\n/** Normalize any kebab/snake key form to the canonical snake key (or undefined). */\nfunction toCanonicalKey(keyOrAlias: string): CanonicalConfigKey | undefined {\n  const normalized = keyOrAlias.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (\n    FORMAT_KEYS.has(normalized as CanonicalConfigKey) ||\n    CRITERIA_KEYS.has(normalized as CanonicalConfigKey) ||\n    POLICY_KEYS.has(normalized as CanonicalConfigKey) ||\n    normalized === \"context\"\n  ) {\n    return normalized as CanonicalConfigKey;\n  }\n  return undefined;\n}\n\n/**\n * Map an enabled/disabled-style value through its synonyms (case-insensitive). Values\n * that are not synonyms pass through unchanged so the downstream validator can reject\n * them with its own message.\n */\nfunction normalizeEnabledDisabled(value: string): string {\n  const normalized = value.trim().toLowerCase();\n  return ENABLED_DISABLED_SYNONYMS[normalized] ?? value;\n}\n\n/**\n * Resolve which typed flag a positional `pm config set <key> <value>` value should\n * populate, plus the normalized value.\n *\n * Returns `{ routable: false, reason }` for keys that require multiple/structured\n * flags (e.g. `context`). Unknown keys also return `routable: false` so the caller\n * can fall back to the existing invalid-key path.\n */\nexport function resolveConfigPositionalValue(\n  canonicalKeyOrAlias: string,\n  value: string,\n): ConfigPositionalResult {\n  const key = toCanonicalKey(canonicalKeyOrAlias);\n  if (key === undefined) {\n    return {\n      routable: false,\n      reason: `Unknown config key \"${canonicalKeyOrAlias}\" cannot route a positional value.`,\n    };\n  }\n\n  if (key === \"context\") {\n    return {\n      routable: false,\n      reason:\n        'Config set context does not accept a positional value. Use --default-depth, --activity-limit, --stale-threshold-days, or --section-<name> flags.',\n    };\n  }\n\n  if (FORMAT_KEYS.has(key)) {\n    return { routable: true, flag: \"format\", value };\n  }\n\n  if (CRITERIA_KEYS.has(key)) {\n    return { routable: true, flag: \"criterion\", values: [value] };\n  }\n\n  // policy key\n  const policyValue = ENABLED_DISABLED_POLICY_KEYS.has(key) ? normalizeEnabledDisabled(value) : value;\n  return { routable: true, flag: \"policy\", value: policyValue };\n}\n"],"names":[],"mappings":"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","debugId":"fd40ea7d-d52d-54b7-ab73-89bebc4a762e"}

package/dist/core/diagnostics/remediation.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Shared machine-executable remediation registry.
+ *
+ * `pm health` and `pm validate` both emit stable, colon-delimited warning tokens
+ * (for example `history_drift_missing_stream:pm-abcd` or
+ * `validate_resolution_missing_fields:3`). Agents that gate on these commands
+ * previously had to hardcode the mapping from a warning code to the `pm` command
+ * that fixes it. This module is the single source of truth for that mapping so
+ * `pm health --json` (per-check `remediation_map`) and `pm validate --fix-hints`
+ * (per-check `fix_hints`) can both surface executable remediation without any
+ * duplicated, drift-prone lookup tables.
+ *
+ * Semantics of {@link RemediationEntry.command}: the suggested next `pm` command
+ * an operator/agent should run to resolve findings with that code. Per-item
+ * findings use an `<id>` placeholder (callers that have the concrete id may
+ * substitute it); findings whose only fix is a manual file edit point at the
+ * most useful diagnostic/repair command and describe the manual step in
+ * {@link RemediationEntry.summary}.
+ */
+export interface RemediationEntry {
+    /**
+     * Stable warning-code prefix this entry resolves. A warning matches when it
+     * equals this code or begins with `<code>:`. Registry codes are mutually
+     * exclusive under that colon-boundary rule (no code is a `:`-delimited prefix
+     * of another — e.g. `settings:id_prefix_empty` is distinct from a bare
+     * `settings`, which is intentionally not registered), so `resolveRemediation`
+     * uses first-match with no ordering dependency.
+     */
+    readonly code: string;
+    /** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */
+    readonly command: string;
+    /** One-line description of what the command does / which manual step it covers. */
+    readonly summary: string;
+}
+/**
+ * Registry of every non-extension `pm health` / `pm validate` warning code and
+ * its remediation. Extension findings keep their richer, contextual
+ * `details.triage.remediation` produced by the extension health triage and are
+ * intentionally excluded here (see pm-0hnu: "all non-extension checks").
+ */
+export declare const REMEDIATION_REGISTRY: readonly RemediationEntry[];
+/**
+ * Resolve the remediation entry for a warning token, or `undefined` when no
+ * entry is registered. A warning matches an entry when it equals the entry code
+ * or begins with `<code>:` (the colon boundary keeps sibling codes such as
+ * `validate_lifecycle_dependency_cycles` and
+ * `validate_lifecycle_dependency_cycles_error` disjoint).
+ *
+ * First match is intentional and correct: registry codes are mutually exclusive
+ * under the colon-boundary rule, so at most one entry can ever match a warning
+ * and order is irrelevant. That invariant is enforced by a test (see
+ * remediation-registry.spec.ts "keeps every registry code mutually exclusive"),
+ * which is why this stays a simple linear scan rather than a longest-prefix
+ * search — a longest-prefix tie-break is unreachable with disjoint codes.
+ *
+ * Accepts unknown input defensively (this is an exported helper SDK consumers
+ * may call from untyped JS): a non-string `warning` resolves to `undefined`.
+ */
+export declare function resolveRemediation(warning: string): RemediationEntry | undefined;
+/**
+ * Build a compact `remediation_map` (code -> command) for a set of warning
+ * tokens. First match wins per code; unknown codes are skipped. Used by
+ * `pm health --json` per-check details and as the source of deduped executable
+ * commands for `pm validate --fix-hints`.
+ */
+export declare function buildRemediationMap(warnings: Iterable<string>): Record<string, string>;
+/**
+ * Build a deduped, ordered list of executable remediation commands for a set of
+ * warning tokens (one command per distinct matched code). Used by
+ * `pm validate --fix-hints` for checks that do not already emit per-row
+ * remediation commands.
+ */
+export declare function buildRemediationCommands(warnings: Iterable<string>): string[];