@unbrained/pm-cli 2026.7.19 → 2026.7.20

package/dist/cli-bundle/chunks/{chunk-IGBBTPM5.js → chunk-TOBGV45Y.js}

@@ -1,9 +1,9 @@
 
-!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]="74723401-1f8b-51b4-ab46-a5cd94e0f9f2")}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]="a810fa9a-5882-5c6c-a0e8-52338dae3ad9")}catch(e){}}();
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   toDefaultFolder
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/core/schema/item-types-file.js
 var BUILTIN_NAME_LOOKUP = new Map(BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]));
@@ -258,6 +258,6 @@ export {
   buildInvalidTypeHint,
   buildInvalidTypeError
 };
-//# sourceMappingURL=chunk-IGBBTPM5.js.map
+//# sourceMappingURL=chunk-TOBGV45Y.js.map
 
-//# debugId=74723401-1f8b-51b4-ab46-a5cd94e0f9f2
+//# debugId=a810fa9a-5882-5c6c-a0e8-52338dae3ad9

package/dist/cli-bundle/chunks/chunk-TOBGV45Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/schema/item-types-file.ts"],"sourcesContent":["/**\n * @module core/schema/item-types-file\n *\n * Resolves configurable schema, fields, statuses, and workflows for Item Types File.\n */\nimport { BUILTIN_ITEM_TYPE_VALUES } from \"../../types/index.js\";\nimport type { ItemTypeDefinition } from \"../../types/index.js\";\nimport { toDefaultFolder } from \"../item/type-registry.js\";\n\nexport type { ItemTypeDefinition } from \"../../types/index.js\";\n\n/** Pure logic for the `pm schema add-type` command and the create/update invalid-type discoverability hint. The CLI command file (schema.ts) handles IO/governance; everything testable and side-effect-free lives here so it can be coverage-gated to 100%. */\n\nconst BUILTIN_NAME_LOOKUP = new Map<string, string>(\n  BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]),\n);\n\n/** The shape persisted at `.agents/pm/schema/types.json`. */\nexport interface ItemTypesFile {\n  /** Value that configures or reports definitions for this contract. */\n  definitions: ItemTypeDefinition[];\n}\n\n/** Documents the normalized add type input payload exchanged by command, SDK, and package integrations. */\nexport interface NormalizedAddTypeInput {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Default status id newly created items of this type receive. */\n  defaultStatus?: string;\n  /** Value that configures or reports folder for this contract. */\n  folder?: string;\n  /** Value that configures or reports aliases for this contract. */\n  aliases: string[];\n}\n\n/** Documents the raw add type input payload exchanged by command, SDK, and package integrations. */\nexport interface RawAddTypeInput {\n  /** Value that configures or reports name for this contract. */\n  name: string | undefined;\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Default status id newly created items of this type receive. */\n  defaultStatus?: string;\n  /** Value that configures or reports folder for this contract. */\n  folder?: string;\n  /** Value that configures or reports aliases for this contract. */\n  aliases?: string[];\n}\n\n/** Documents the upsert item type result payload exchanged by command, SDK, and package integrations. */\nexport interface UpsertItemTypeResult {\n  /** Value that configures or reports file for this contract. */\n  file: ItemTypesFile;\n  /** The definition as stored after the upsert (existing fields preserved). */\n  definition: ItemTypeDefinition;\n  /** True when an existing definition with the same (case-insensitive) name was replaced. */\n  replaced: boolean;\n  /** The canonical name of the replaced definition (only present when `replaced`). Lets the caller detect a silent recase (e.g. \"Spike\" -> \"spike\") and warn. */\n  previousName?: string;\n}\n\n/** Custom item type names (and aliases) must be a single letter-led identifier token: letters, digits, hyphen, or underscore — no whitespace or other punctuation. This keeps names copy-pasteable as shell arguments and folder slugs deterministic, matching the single-token PascalCase shape of every built-in type. Folder/slug overlap between two distinct valid tokens (e.g. \"Spike\"/\"Spikes\", \"code-review\"/\"code_review\") is rejected separately by assertTypeFolderAvailable. */\nconst TYPE_NAME_TOKEN_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;\n\nfunction assertValidTypeToken(value: string, label: string): void {\n  if (!TYPE_NAME_TOKEN_PATTERN.test(value)) {\n    throw new Error(\n      `${label} \"${value}\" is not a valid identifier. Use a single letter-led token of letters, digits, hyphen, or underscore with no spaces or punctuation (e.g. \"Spike\" or \"code-review\").`,\n    );\n  }\n}\n\n/** Documents the remove item type result payload exchanged by command, SDK, and package integrations. */\nexport interface RemoveItemTypeResult {\n  /** Value that configures or reports file for this contract. */\n  file: ItemTypesFile;\n  /** True when a matching definition existed and was dropped from the file. */\n  removed: boolean;\n  /** The removed definition, when one matched (case-insensitively) the requested name. */\n  definition?: ItemTypeDefinition;\n}\n\n/** Returns the canonical built-in name when `name` collides (case-insensitively) with a reserved built-in item type, otherwise undefined. */\nexport function matchBuiltinTypeName(name: string): string | undefined {\n  return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase());\n}\n\n/** Coerces a persisted `aliases` value into a string array, tolerating malformed data (a non-array, or an array containing non-string entries) without throwing or exploding a stray string into character aliases. */\nfunction coerceAliasArray(value: unknown): string[] {\n  return Array.isArray(value)\n    ? value.filter((entry): entry is string => typeof entry === \"string\")\n    : [];\n}\n\n/** Escapes a value for safe interpolation inside a double-quoted shell string so suggested copy-pasteable commands stay well-formed for names containing `\"`, `` ` ``, `$`, or `\\`. */\nexport function escapeForDoubleQuotes(value: string): string {\n  return value.replace(/[\\\\\"`$]/g, (char) => `\\\\${char}`);\n}\n\nfunction dedupeAliases(values: Iterable<string>): string[] {\n  const seen = new Map<string, string>();\n  for (const value of values) {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const key = trimmed.toLowerCase();\n    if (!seen.has(key)) {\n      seen.set(key, trimmed);\n    }\n  }\n  return [...seen.values()].sort((left, right) => left.localeCompare(right));\n}\n\n/** Validates and normalizes raw add-type CLI input. Throws a plain Error with a stable message when the name is missing/empty or collides with a built-in; the CLI layer maps these to PmCliError exit codes. */\nexport function normalizeAddTypeInput(\n  raw: RawAddTypeInput,\n): NormalizedAddTypeInput {\n  const name = (raw.name ?? \"\").trim();\n  if (name.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  assertValidTypeToken(name, \"Type name\");\n  const builtinMatch = matchBuiltinTypeName(name);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot redefine built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const description = raw.description?.trim();\n  const defaultStatus = raw.defaultStatus?.trim();\n  const folder = raw.folder?.trim();\n  const aliases = dedupeAliases(raw.aliases ?? []);\n  for (const alias of aliases) {\n    assertValidTypeToken(alias, \"Alias\");\n    const aliasBuiltin = matchBuiltinTypeName(alias);\n    if (aliasBuiltin) {\n      throw new Error(\n        `Alias \"${alias}\" collides with built-in item type \"${aliasBuiltin}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n      );\n    }\n  }\n  return {\n    name,\n    description:\n      description && description.length > 0 ? description : undefined,\n    defaultStatus:\n      defaultStatus && defaultStatus.length > 0 ? defaultStatus : undefined,\n    folder: folder && folder.length > 0 ? folder : undefined,\n    aliases,\n  };\n}\n\n/** Throws when the requested name or any alias collides (case-insensitively) with the canonical name or an alias of a DIFFERENT existing definition. Such collisions would make `pm create`/`pm update --type` resolve ambiguously (the runtime registry keys a single lowercase alias map), so they are rejected. Tokens belonging to the same-named definition being upserted are ignored, keeping re-runs idempotent. */\nexport function assertAliasesAvailable(\n  input: NormalizedAddTypeInput,\n  existing: ItemTypesFile,\n): void {\n  const selfLower = input.name.toLowerCase();\n  const taken = new Map<string, string>();\n  for (const definition of existing.definitions) {\n    if (typeof definition.name !== \"string\") {\n      continue;\n    }\n    const definitionName = definition.name.trim();\n    if (\n      definitionName.length === 0 ||\n      definitionName.toLowerCase() === selfLower\n    ) {\n      continue;\n    }\n    taken.set(definitionName.toLowerCase(), definitionName);\n    for (const alias of coerceAliasArray(definition.aliases)) {\n      if (alias.trim().length > 0) {\n        taken.set(alias.trim().toLowerCase(), definitionName);\n      }\n    }\n  }\n  const nameOwner = taken.get(selfLower);\n  if (nameOwner) {\n    throw new Error(\n      `Type name \"${input.name}\" collides with an alias of existing item type \"${nameOwner}\".`,\n    );\n  }\n  for (const alias of input.aliases) {\n    const owner = taken.get(alias.toLowerCase());\n    if (owner) {\n      throw new Error(\n        `Alias \"${alias}\" already maps to existing item type \"${owner}\".`,\n      );\n    }\n  }\n}\n\n/** Resolves the storage folder a definition would use: an explicit non-empty `folder` wins, otherwise the deterministic slug derived from the name (the same derivation the runtime registry applies, single-sourced from type-registry.toDefaultFolder). */\nfunction resolveDefinitionFolder(name: string, folder: unknown): string {\n  if (typeof folder === \"string\" && folder.trim().length > 0) {\n    return folder.trim().toLowerCase();\n  }\n  return toDefaultFolder(name).toLowerCase();\n}\n\n/**\n * Throws when the requested type's storage folder would collide with a\n * DIFFERENT existing definition's folder. Two distinct type names can slug to\n * one folder (\"Spike\"/\"Spikes\", \"code-review\"/\"code_review\"), which would make\n * their item files share a directory and silently corrupt the taxonomy. The\n * same-named definition being upserted is ignored (folder reuse on re-run is\n * expected). Resolving the collision is a matter of passing a distinct\n * `--folder`, so the error says so.\n *\n * `reservedFolders` carries the folders already owned by built-in and extension\n * types (folder-slug → owner name); a custom type whose slug matches one of\n * those (e.g. \"Tasks\" → \"tasks\", owned by the built-in Task) is just as\n * corrupting as a custom-vs-custom collision, so both are checked.\n */\nexport function assertTypeFolderAvailable(\n  input: NormalizedAddTypeInput,\n  existing: ItemTypesFile,\n  reservedFolders?: ReadonlyMap<string, string>,\n): void {\n  const selfLower = input.name.toLowerCase();\n  const inputFolder = resolveDefinitionFolder(input.name, input.folder);\n  const fail = (ownerName: string): never => {\n    throw new Error(\n      `Item type \"${input.name}\" would store items in folder \"${inputFolder}\", which already belongs to existing item type \"${ownerName}\". Pass a distinct --folder to keep their storage separate.`,\n    );\n  };\n  for (const definition of existing.definitions) {\n    if (typeof definition.name !== \"string\") {\n      continue;\n    }\n    const definitionName = definition.name.trim();\n    if (\n      definitionName.length === 0 ||\n      definitionName.toLowerCase() === selfLower\n    ) {\n      continue;\n    }\n    if (\n      resolveDefinitionFolder(definitionName, definition.folder) === inputFolder\n    ) {\n      fail(definitionName);\n    }\n  }\n  const reservedOwner = reservedFolders?.get(inputFolder);\n  if (\n    reservedOwner !== undefined &&\n    reservedOwner.toLowerCase() !== selfLower\n  ) {\n    fail(reservedOwner);\n  }\n}\n\n/** Coerces an arbitrary parsed value from types.json into an ItemTypesFile. Accepts the canonical `{ definitions: [...] }` shape, a bare array of definitions, or a nested `{ item_types: { definitions: [...] } }` form, and tolerates a missing/invalid file by returning an empty definitions list. */\nexport function parseItemTypesFile(\n  raw: string | null | undefined,\n): ItemTypesFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { definitions: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/types.json contains invalid JSON.\");\n  }\n  return { definitions: extractDefinitions(parsed) };\n}\n\nfunction extractDefinitions(parsed: unknown): ItemTypeDefinition[] {\n  const candidate = selectDefinitionsArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: ItemTypeDefinition[] = [];\n  for (const entry of candidate) {\n    if (typeof entry !== \"object\" || entry === null || Array.isArray(entry)) {\n      continue;\n    }\n    const record = entry as Record<string, unknown>;\n    if (typeof record.name !== \"string\" || record.name.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as ItemTypeDefinition);\n  }\n  return definitions;\n}\n\nfunction selectDefinitionsArray(parsed: unknown): unknown[] | undefined {\n  if (Array.isArray(parsed)) {\n    return parsed;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return undefined;\n  }\n  const record = parsed as Record<string, unknown>;\n  if (Array.isArray(record.definitions)) {\n    return record.definitions;\n  }\n  if (typeof record.item_types === \"object\" && record.item_types !== null) {\n    const nested = record.item_types as Record<string, unknown>;\n    if (Array.isArray(nested.definitions)) {\n      return nested.definitions;\n    }\n  }\n  return undefined;\n}\n\n/** Idempotent UPSERT of a custom item type into the parsed file. Matching is case-insensitive by name. When a definition already exists, fields supplied in `input` override the previous values; aliases are merged (deduped); other fields not addressed by add-type flags are preserved untouched. */\nexport function upsertItemType(\n  file: ItemTypesFile,\n  input: NormalizedAddTypeInput,\n): UpsertItemTypeResult {\n  const lowerName = input.name.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) =>\n      typeof definition.name === \"string\" &&\n      definition.name.trim().toLowerCase() === lowerName,\n  );\n  const existing = existingIndex >= 0 ? definitions[existingIndex] : undefined;\n\n  const mergedAliases = dedupeAliases([\n    ...coerceAliasArray(existing?.aliases),\n    ...input.aliases,\n  ]);\n\n  const next: ItemTypeDefinition = {\n    ...existing,\n    name: input.name,\n  };\n  if (input.folder !== undefined) {\n    next.folder = input.folder;\n  }\n  if (mergedAliases.length > 0) {\n    next.aliases = mergedAliases;\n  } else if (next.aliases !== undefined) {\n    delete next.aliases;\n  }\n  applyAttribute(next, \"description\", input.description);\n  applyAttribute(next, \"default_status\", input.defaultStatus);\n\n  if (existingIndex >= 0) {\n    definitions[existingIndex] = next;\n  } else {\n    definitions.push(next);\n  }\n  definitions.sort((left, right) => left.name.localeCompare(right.name));\n\n  return {\n    file: { definitions },\n    definition: next,\n    replaced: existingIndex >= 0,\n    ...(existing && typeof existing.name === \"string\"\n      ? { previousName: existing.name }\n      : {}),\n  };\n}\n\n/** Removes a custom item type definition from the parsed file by name (case-insensitive). Throws a plain Error when `name` is empty or collides with a reserved built-in type (built-ins are not stored in the file and must never be deletable). Returns `removed: false` when no matching custom definition exists so the CLI layer can treat the call as an idempotent no-op. */\nexport function removeItemType(\n  file: ItemTypesFile,\n  name: string | undefined,\n): RemoveItemTypeResult {\n  const trimmed = (name ?? \"\").trim();\n  if (trimmed.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  const builtinMatch = matchBuiltinTypeName(trimmed);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot remove built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const lowerName = trimmed.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) =>\n      typeof definition.name === \"string\" &&\n      definition.name.trim().toLowerCase() === lowerName,\n  );\n  if (existingIndex < 0) {\n    return { file: { definitions }, removed: false };\n  }\n  const [definition] = definitions.splice(existingIndex, 1);\n  return { file: { definitions }, removed: true, definition };\n}\n\nfunction applyAttribute(\n  definition: ItemTypeDefinition,\n  key: string,\n  value: string | undefined,\n): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value !== undefined) {\n    record[key] = value;\n  }\n}\n\n/** Serializes the item types file with a trailing newline (matches the rest of the schema scaffold files written by pm). */\nexport function serializeItemTypesFile(file: ItemTypesFile): string {\n  return `${JSON.stringify({ definitions: file.definitions }, null, 2)}\\n`;\n}\n\n/** Appends a discoverable hint to the \"Invalid type\" error so agents learn that custom types exist and how to register one. Quotes are chosen so the printed line is copy-pasteable as a shell command. */\nexport function buildInvalidTypeHint(\n  name: string,\n  typesFilePath?: string,\n): string {\n  const safeName = name.trim().length > 0 ? name.trim() : name;\n  const target = typesFilePath?.trim() || \".agents/pm/schema/types.json\";\n  return `To register a custom type, run: pm schema add-type \"${escapeForDoubleQuotes(safeName)}\" (writes ${target}).`;\n}\n\n/**\n * Builds the full invalid-type error message used by create/update: the\n * existing \"Invalid type ... Allowed: ...\" line plus the discoverable hint.\n * `typesFilePath` should be the resolved schema/types.json path for the active\n * tracker (see {@link resolveItemTypesFilePath}) so the hint reflects a custom\n * `--pm-path` instead of the hardcoded `.agents/pm` default.\n */\nexport function buildInvalidTypeError(\n  name: string,\n  allowedTypes: readonly string[],\n  typesFilePath?: string,\n): string {\n  return `Invalid type value \"${name}\". Allowed: ${allowedTypes.join(\", \")}. ${buildInvalidTypeHint(name, typesFilePath)}`;\n}\n"],"names":["definition"],"mappings":"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","debugId":"a810fa9a-5882-5c6c-a0e8-52338dae3ad9"}

package/dist/cli-bundle/chunks/{chunk-W6IEJXNC.js → chunk-TVYYO5A7.js}

@@ -1,7 +1,7 @@
 import {
   isTerminalStatus,
   normalizeStatusForRegistry
-} from "./chunk-RLLOZAM2.js";
+} from "./chunk-IY6VZ3IW.js";
 
 // dist/core/item/actionability.js
 !(function() {
@@ -159,4 +159,4 @@ export {
   collectDependencyBlockedIds,
   computeActionabilityReport
 };
-//# sourceMappingURL=chunk-W6IEJXNC.js.map
+//# sourceMappingURL=chunk-TVYYO5A7.js.map

package/dist/cli-bundle/chunks/chunk-TYHJDFYW.js

@@ -0,0 +1,109 @@
+import {
+  cloneEmptyReplayDocument,
+  tryApplyReplayPatch
+} from "./chunk-E6LEMURX.js";
+
+// dist/core/history/history-diff.js
+!(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] = "86354a77-3238-519c-818f-c2989d885298");
+  } catch (e2) {
+  }
+})();
+function decodeJsonPointerSegment(segment) {
+  return segment.replaceAll("~1", "/").replaceAll("~0", "~");
+}
+function patchPathToChangedField(path) {
+  if (path === "/body" || path.startsWith("/body/"))
+    return "body";
+  if (path === "/metadata" || path.startsWith("/metadata/") || path === "/front_matter" || path.startsWith("/front_matter/")) {
+    const segment2 = path.replace(/^\/(?:metadata|front_matter)\/?/, "").split("/")[0];
+    if (!segment2)
+      return "metadata";
+    return decodeJsonPointerSegment(segment2);
+  }
+  const segment = path.replace(/^\//, "").split("/")[0];
+  return segment ? decodeJsonPointerSegment(segment) : "root";
+}
+function readFieldValue(doc, field) {
+  if (field === "body")
+    return doc.body;
+  if (field === "metadata")
+    return doc.metadata;
+  if (field === "root")
+    return doc;
+  return doc.metadata[field];
+}
+function computeHistoryDiff(fullEntries, options) {
+  const windowStartIndex = options?.windowStartIndex ?? 0;
+  const fieldFilter = options?.field;
+  if (fullEntries.length === 0 || windowStartIndex >= fullEntries.length) {
+    return [];
+  }
+  let current = cloneEmptyReplayDocument();
+  const result = [];
+  for (let p = 0; p < fullEntries.length; p += 1) {
+    const entry = fullEntries[p];
+    const beforeDoc = current;
+    const applied = tryApplyReplayPatch(current, entry.patch);
+    let afterDoc;
+    if (applied.ok) {
+      afterDoc = applied.document;
+      current = afterDoc;
+    } else {
+      afterDoc = beforeDoc;
+    }
+    const changedFieldSet = /* @__PURE__ */ new Set();
+    for (const patchOp of entry.patch) {
+      changedFieldSet.add(patchPathToChangedField(patchOp.path));
+      if (patchOp.from !== void 0) {
+        changedFieldSet.add(patchPathToChangedField(patchOp.from));
+      }
+    }
+    const sortedFields = [...changedFieldSet].sort((a, b) => a.localeCompare(b));
+    if (p >= windowStartIndex) {
+      if (fieldFilter !== void 0) {
+        if (!changedFieldSet.has(fieldFilter)) {
+          continue;
+        }
+        const change = {
+          field: fieldFilter,
+          before: readFieldValue(beforeDoc, fieldFilter),
+          after: readFieldValue(afterDoc, fieldFilter)
+        };
+        result.push({
+          index: p + 1,
+          ts: entry.ts,
+          op: entry.op,
+          author: entry.author,
+          patch_ops: entry.patch.length,
+          changed_fields: [fieldFilter],
+          changes: [change]
+        });
+      } else {
+        const changes = sortedFields.map((field) => ({
+          field,
+          before: readFieldValue(beforeDoc, field),
+          after: readFieldValue(afterDoc, field)
+        }));
+        result.push({
+          index: p + 1,
+          ts: entry.ts,
+          op: entry.op,
+          author: entry.author,
+          patch_ops: entry.patch.length,
+          changed_fields: sortedFields,
+          changes
+        });
+      }
+    }
+  }
+  return result;
+}
+
+export {
+  patchPathToChangedField,
+  computeHistoryDiff
+};
+//# sourceMappingURL=chunk-TYHJDFYW.js.map

package/dist/cli-bundle/chunks/chunk-TYHJDFYW.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/history/history-diff.ts"],
+  "sourcesContent": ["/**\n * @module core/history/history-diff\n *\n * Implements append-only history and replay behavior for History Diff.\n */\nimport {\n  cloneEmptyReplayDocument,\n  tryApplyReplayPatch,\n  type ReplayDocument,\n} from \"./replay.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\n/** Documents the history field change payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryFieldChange {\n  /** Value that configures or reports field for this contract. */\n  field: string;\n  // before and after are the raw field values captured by replaying the history chain.\n  // `undefined` is intentional: it signals that the field was absent in the document at\n  // that point (e.g. after a JSON-Patch `remove` op). JSON serialization will omit\n  // undefined values, which correctly communicates \"field did not exist\".\n  /** Value that configures or reports before for this contract. */\n  before: unknown;\n  /** Value that configures or reports after for this contract. */\n  after: unknown;\n}\n\n/** Documents the history diff value entry payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryDiffValueEntry {\n  /** 1-based position in the FULL stream (fullEntries index + 1). */\n  index: number;\n  /** Value that configures or reports ts for this contract. */\n  ts: string;\n  /** Value that configures or reports op for this contract. */\n  op: string;\n  /** Value that configures or reports author for this contract. */\n  author: string;\n  /** Number of JSON-patch operations in this entry (entry.patch.length). */\n  patch_ops: number;\n  /** Unique field names touched by this entry, sorted by localeCompare. */\n  changed_fields: string[];\n  /** Per-field before/after values, sorted by field name (localeCompare). */\n  changes: HistoryFieldChange[];\n}\n\n// ---------------------------------------------------------------------------\n// JSON-Pointer helpers (ported from src/cli/commands/history.ts so the\n// orchestrator can replace the private copy there with an import from here).\n// ---------------------------------------------------------------------------\n\nfunction decodeJsonPointerSegment(segment: string): string {\n  return segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n}\n\n/**\n * Map a JSON-Patch path string to a human-readable changed-field name.\n *\n * Rules (in priority order):\n *  - \"/body\" or \"/body/…\"                      → \"body\"\n *  - \"/metadata/…\" or \"/front_matter/…\"\n *      with a first segment                     → that decoded segment (e.g. \"status\")\n *      without a first segment (bare prefix)    → \"metadata\"\n *  - \"/\" (root pointer, empty segment after strip) → \"root\"\n *  - anything else                               → decoded first path segment\n */\nexport function patchPathToChangedField(path: string): string {\n  if (path === \"/body\" || path.startsWith(\"/body/\")) return \"body\";\n  if (\n    path === \"/metadata\" ||\n    path.startsWith(\"/metadata/\") ||\n    path === \"/front_matter\" ||\n    path.startsWith(\"/front_matter/\")\n  ) {\n    const segment = path\n      .replace(/^\\/(?:metadata|front_matter)\\/?/, \"\")\n      .split(\"/\")[0];\n    if (!segment) return \"metadata\";\n    return decodeJsonPointerSegment(segment);\n  }\n  const segment = path.replace(/^\\//, \"\").split(\"/\")[0];\n  return segment ? decodeJsonPointerSegment(segment) : \"root\";\n}\n\n// ---------------------------------------------------------------------------\n// Field-value reader\n// ---------------------------------------------------------------------------\n\n/**\n * Extract the before/after value for a logical field from a replay document.\n *\n * - \"body\"     → doc.body\n * - \"metadata\" → doc.metadata (the whole object, for a bare /metadata replace)\n * - \"root\"     → the whole document (for a bare \"/\" patch op)\n * - other      → doc.metadata[field] (may be undefined when the field was absent)\n */\nfunction readFieldValue(doc: ReplayDocument, field: string): unknown {\n  if (field === \"body\") return doc.body;\n  if (field === \"metadata\") return doc.metadata;\n  if (field === \"root\") return doc;\n  return doc.metadata[field];\n}\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Replay a full history entry stream and produce enriched diff entries with\n * per-field before/after values.\n *\n * @param fullEntries   The complete ordered history chain to replay.\n * @param options.windowStartIndex  0-based index into fullEntries at which the\n *   DISPLAYED window begins. Entries before this index are still replayed (so\n *   state is accurate) but are not emitted. Defaults to 0.\n * @param options.field  When supplied, only entries that changed this field are\n *   emitted, and each emitted entry's `changes` and `changed_fields` are\n *   restricted to that single field.\n */\nexport function computeHistoryDiff(\n  fullEntries: HistoryEntry[],\n  options?: { windowStartIndex?: number; field?: string },\n): HistoryDiffValueEntry[] {\n  const windowStartIndex = options?.windowStartIndex ?? 0;\n  const fieldFilter = options?.field;\n\n  if (fullEntries.length === 0 || windowStartIndex >= fullEntries.length) {\n    return [];\n  }\n\n  let current = cloneEmptyReplayDocument();\n  const result: HistoryDiffValueEntry[] = [];\n\n  for (let p = 0; p < fullEntries.length; p += 1) {\n    const entry = fullEntries[p];\n\n    // Capture before state.\n    const beforeDoc = current;\n\n    // Attempt to apply patch.\n    const applied = tryApplyReplayPatch(current, entry.patch);\n    let afterDoc: ReplayDocument;\n    if (applied.ok) {\n      afterDoc = applied.document;\n      current = afterDoc;\n    } else {\n      // Patch failed — use before state as after (cannot trust partial result).\n      // Do NOT advance current; keep prior replay state.\n      afterDoc = beforeDoc;\n    }\n\n    // Collect changed field names from patch paths (and from: paths for move/copy).\n    const changedFieldSet = new Set<string>();\n    for (const patchOp of entry.patch) {\n      changedFieldSet.add(patchPathToChangedField(patchOp.path));\n      if (patchOp.from !== undefined) {\n        changedFieldSet.add(patchPathToChangedField(patchOp.from));\n      }\n    }\n    const sortedFields = [...changedFieldSet].sort((a, b) =>\n      a.localeCompare(b),\n    );\n\n    // Only emit entries in the display window.\n    if (p >= windowStartIndex) {\n      // Apply field filter: skip this entry entirely if it doesn't touch the\n      // requested field; otherwise narrow down to only that field.\n      if (fieldFilter !== undefined) {\n        if (!changedFieldSet.has(fieldFilter)) {\n          // This entry does not touch the requested field — skip it.\n          continue;\n        }\n        // Emit only the filtered field.\n        const change: HistoryFieldChange = {\n          field: fieldFilter,\n          before: readFieldValue(beforeDoc, fieldFilter),\n          after: readFieldValue(afterDoc, fieldFilter),\n        };\n        result.push({\n          index: p + 1,\n          ts: entry.ts,\n          op: entry.op,\n          author: entry.author,\n          patch_ops: entry.patch.length,\n          changed_fields: [fieldFilter],\n          changes: [change],\n        });\n      } else {\n        // Emit all changed fields.\n        const changes: HistoryFieldChange[] = sortedFields.map((field) => ({\n          field,\n          before: readFieldValue(beforeDoc, field),\n          after: readFieldValue(afterDoc, field),\n        }));\n        result.push({\n          index: p + 1,\n          ts: entry.ts,\n          op: entry.op,\n          author: entry.author,\n          patch_ops: entry.patch.length,\n          changed_fields: sortedFields,\n          changes,\n        });\n      }\n    }\n  }\n\n  return result;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;AAiDA,SAAS,yBAAyB,SAAe;AAC/C,SAAO,QAAQ,WAAW,MAAM,GAAG,EAAE,WAAW,MAAM,GAAG;AAC3D;AAaM,SAAU,wBAAwB,MAAY;AAClD,MAAI,SAAS,WAAW,KAAK,WAAW,QAAQ;AAAG,WAAO;AAC1D,MACE,SAAS,eACT,KAAK,WAAW,YAAY,KAC5B,SAAS,mBACT,KAAK,WAAW,gBAAgB,GAChC;AACA,UAAMA,WAAU,KACb,QAAQ,mCAAmC,EAAE,EAC7C,MAAM,GAAG,EAAE,CAAC;AACf,QAAI,CAACA;AAAS,aAAO;AACrB,WAAO,yBAAyBA,QAAO;EACzC;AACA,QAAM,UAAU,KAAK,QAAQ,OAAO,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACpD,SAAO,UAAU,yBAAyB,OAAO,IAAI;AACvD;AAcA,SAAS,eAAe,KAAqB,OAAa;AACxD,MAAI,UAAU;AAAQ,WAAO,IAAI;AACjC,MAAI,UAAU;AAAY,WAAO,IAAI;AACrC,MAAI,UAAU;AAAQ,WAAO;AAC7B,SAAO,IAAI,SAAS,KAAK;AAC3B;AAkBM,SAAU,mBACd,aACA,SAAuD;AAEvD,QAAM,mBAAmB,SAAS,oBAAoB;AACtD,QAAM,cAAc,SAAS;AAE7B,MAAI,YAAY,WAAW,KAAK,oBAAoB,YAAY,QAAQ;AACtE,WAAO,CAAA;EACT;AAEA,MAAI,UAAU,yBAAwB;AACtC,QAAM,SAAkC,CAAA;AAExC,WAAS,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK,GAAG;AAC9C,UAAM,QAAQ,YAAY,CAAC;AAG3B,UAAM,YAAY;AAGlB,UAAM,UAAU,oBAAoB,SAAS,MAAM,KAAK;AACxD,QAAI;AACJ,QAAI,QAAQ,IAAI;AACd,iBAAW,QAAQ;AACnB,gBAAU;IACZ,OAAO;AAGL,iBAAW;IACb;AAGA,UAAM,kBAAkB,oBAAI,IAAG;AAC/B,eAAW,WAAW,MAAM,OAAO;AACjC,sBAAgB,IAAI,wBAAwB,QAAQ,IAAI,CAAC;AACzD,UAAI,QAAQ,SAAS,QAAW;AAC9B,wBAAgB,IAAI,wBAAwB,QAAQ,IAAI,CAAC;MAC3D;IACF;AACA,UAAM,eAAe,CAAC,GAAG,eAAe,EAAE,KAAK,CAAC,GAAG,MACjD,EAAE,cAAc,CAAC,CAAC;AAIpB,QAAI,KAAK,kBAAkB;AAGzB,UAAI,gBAAgB,QAAW;AAC7B,YAAI,CAAC,gBAAgB,IAAI,WAAW,GAAG;AAErC;QACF;AAEA,cAAM,SAA6B;UACjC,OAAO;UACP,QAAQ,eAAe,WAAW,WAAW;UAC7C,OAAO,eAAe,UAAU,WAAW;;AAE7C,eAAO,KAAK;UACV,OAAO,IAAI;UACX,IAAI,MAAM;UACV,IAAI,MAAM;UACV,QAAQ,MAAM;UACd,WAAW,MAAM,MAAM;UACvB,gBAAgB,CAAC,WAAW;UAC5B,SAAS,CAAC,MAAM;SACjB;MACH,OAAO;AAEL,cAAM,UAAgC,aAAa,IAAI,CAAC,WAAW;UACjE;UACA,QAAQ,eAAe,WAAW,KAAK;UACvC,OAAO,eAAe,UAAU,KAAK;UACrC;AACF,eAAO,KAAK;UACV,OAAO,IAAI;UACX,IAAI,MAAM;UACV,IAAI,MAAM;UACV,QAAQ,MAAM;UACd,WAAW,MAAM,MAAM;UACvB,gBAAgB;UAChB;SACD;MACH;IACF;EACF;AAEA,SAAO;AACT;",
+  "names": ["segment"]
+}

package/dist/cli-bundle/chunks/{chunk-DOASIOQR.js → chunk-UQLXSG72.js}

@@ -1,6 +1,6 @@
 import {
   createRelationshipKindRegistry
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/sdk/relationship-analytics.js
 !(function() {
@@ -286,4 +286,4 @@ export {
   analyzeKnowledgeGraph,
   compareRelationshipSnapshots
 };
-//# sourceMappingURL=chunk-DOASIOQR.js.map
+//# sourceMappingURL=chunk-UQLXSG72.js.map

package/dist/cli-bundle/chunks/{chunk-IDUTGRDM.js → chunk-URXVHN3L.js}

@@ -1,6 +1,6 @@
 // dist/core/schema/type-workflows.js
 
-!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]="682cdb08-f71c-57df-9d72-8ba95a81c069")}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]="39c639fc-defa-54d2-a310-dad8a424f4cc")}catch(e){}}();
 function normalizeStatusToken(value) {
   return typeof value === "string" ? value.trim().toLowerCase().replaceAll(/[\s-]+/g, "_") : "";
 }
@@ -87,6 +87,6 @@ export {
   evaluateTransition,
   describeAllowedTransitions
 };
-//# sourceMappingURL=chunk-IDUTGRDM.js.map
+//# sourceMappingURL=chunk-URXVHN3L.js.map
 
-//# debugId=682cdb08-f71c-57df-9d72-8ba95a81c069
+//# debugId=39c639fc-defa-54d2-a310-dad8a424f4cc

package/dist/cli-bundle/chunks/chunk-URXVHN3L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/schema/type-workflows.ts"],"sourcesContent":["/**\n * @module core/schema/type-workflows\n *\n * Resolves configurable schema, fields, statuses, and workflows for Type Workflows.\n */\nimport type {\n  RuntimeSchemaSettings,\n  TypeWorkflowDefinition,\n} from \"../../types/index.js\";\n\n/**\n * Per-type allowed-transition support (governance.workflow_enforcement).\n *\n * Rule semantics:\n * - A type with NO matching type_workflows entry is UNRESTRICTED (every\n *   transition is allowed).\n * - A type WITH an entry allows only the listed [from, to] pairs. from/to are\n *   compared as normalized status ids (resolved through the status registry's\n *   alias_to_id map when available, otherwise via token normalization).\n * - A same-status no-op (from === to) is ALWAYS allowed.\n *\n * This module is intentionally dependency-light and fully unit-testable; the\n * CLI enforcement point (src/cli/commands/update.ts) is the only consumer.\n */\n\nexport interface NormalizedTypeWorkflow {\n  /** Lower-cased type name used for case-insensitive matching. */\n  type: string;\n  /** Allowed [from, to] pairs as normalized status ids. */\n  allowed_transitions: [string, string][];\n}\n\n/** Minimal status-registry surface needed to resolve a status token to its id. */\nexport interface StatusTokenResolver {\n  /** Value that configures or reports alias to id for this contract. */\n  alias_to_id: Map<string, string>;\n}\n\n/** Documents the evaluate transition input payload exchanged by command, SDK, and package integrations. */\nexport interface EvaluateTransitionInput {\n  /** Value that configures or reports type name for this contract. */\n  typeName: string;\n  /** Status id the workflow transition starts from. */\n  fromStatus: string;\n  /** Status id the workflow transition moves to. */\n  toStatus: string;\n  /** Value that configures or reports type workflows for this contract. */\n  typeWorkflows: NormalizedTypeWorkflow[];\n  /** Value that configures or reports status registry for this contract. */\n  statusRegistry?: StatusTokenResolver;\n}\n\n/** Documents the evaluate transition result payload exchanged by command, SDK, and package integrations. */\nexport interface EvaluateTransitionResult {\n  /** Whether the transition is permitted. */\n  allowed: boolean;\n  /** Whether a matching per-type rule constrained the transition. */\n  hasRule: boolean;\n  /** Allowed [from, to] pairs for the matched type (normalized ids). Empty when the type is unrestricted. */\n  allowedTransitions: [string, string][];\n}\n\n/** Normalize a status token the same way runtime-schema statuses are normalized. */\nexport function normalizeStatusToken(value: unknown): string {\n  return typeof value === \"string\"\n    ? value\n        .trim()\n        .toLowerCase()\n        .replaceAll(/[\\s-]+/g, \"_\")\n    : \"\";\n}\n\nfunction normalizeTypeName(value: unknown): string {\n  return typeof value === \"string\" ? value.trim().toLowerCase() : \"\";\n}\n\nfunction resolveStatusId(\n  value: string,\n  statusRegistry: StatusTokenResolver | undefined,\n): string {\n  const token = normalizeStatusToken(value);\n  if (token.length === 0) {\n    return \"\";\n  }\n  return statusRegistry?.alias_to_id?.get(token) ?? token;\n}\n\n/**\n * Normalize the raw type_workflows from a runtime schema into a deduped,\n * lower-cased-type list with normalized status tokens.\n *\n * An entry is kept when it has a valid (non-empty) `type` AND its\n * `allowed_transitions` is an ARRAY — even when that array is empty. An explicit\n * empty array is a deliberate DENY-ALL rule (only same-status no-ops are\n * permitted, see evaluateTransition), so it must NOT collapse into \"no rule\"\n * (which would leave the type unrestricted). Entries with a missing/empty type\n * or a non-array `allowed_transitions` are dropped, as are malformed/short pairs.\n */\nexport function resolveTypeWorkflows(\n  schema: Pick<RuntimeSchemaSettings, \"type_workflows\"> | undefined,\n): NormalizedTypeWorkflow[] {\n  const rawWorkflows: TypeWorkflowDefinition[] = Array.isArray(\n    schema?.type_workflows,\n  )\n    ? schema!.type_workflows!\n    : [];\n  const byType = new Map<\n    string,\n    { pairs: [string, string][]; denyAll: boolean }\n  >();\n  for (const entry of rawWorkflows) {\n    const type = normalizeTypeName(entry?.type);\n    if (type.length === 0) {\n      continue;\n    }\n    if (!Array.isArray(entry?.allowed_transitions)) {\n      continue;\n    }\n    const pairs = entry.allowed_transitions;\n    const record = byType.get(type) ?? { pairs: [], denyAll: false };\n    // Only an explicitly empty array is an intentional deny-all; a nonempty array\n    // whose pairs are all malformed is a typo and must be dropped (not deny-all).\n    if (pairs.length === 0) {\n      record.denyAll = true;\n    }\n    for (const pair of pairs) {\n      if (!Array.isArray(pair) || pair.length !== 2) {\n        continue;\n      }\n      const from = normalizeStatusToken(pair[0]);\n      const to = normalizeStatusToken(pair[1]);\n      if (from.length === 0 || to.length === 0) {\n        continue;\n      }\n      if (\n        record.pairs.some(\n          (candidate) => candidate[0] === from && candidate[1] === to,\n        )\n      ) {\n        continue;\n      }\n      record.pairs.push([from, to]);\n    }\n    byType.set(type, record);\n  }\n  return [...byType.entries()]\n    .filter(([, record]) => record.pairs.length > 0 || record.denyAll)\n    .map(([type, record]) => ({ type, allowed_transitions: record.pairs }))\n    .sort((left, right) => left.type.localeCompare(right.type));\n}\n\n/** Evaluate whether a status transition is allowed for the given item type. Returns hasRule=false (allowed) when the type is unrestricted. */\nexport function evaluateTransition(\n  input: EvaluateTransitionInput,\n): EvaluateTransitionResult {\n  const typeName = normalizeTypeName(input.typeName);\n  const matched = input.typeWorkflows.find(\n    (workflow) => workflow.type === typeName,\n  );\n  if (!matched) {\n    return { allowed: true, hasRule: false, allowedTransitions: [] };\n  }\n  const from = resolveStatusId(input.fromStatus, input.statusRegistry);\n  const to = resolveStatusId(input.toStatus, input.statusRegistry);\n  // A no-op self-transition is always permitted, even under a restricting rule.\n  if (from.length > 0 && from === to) {\n    return {\n      allowed: true,\n      hasRule: true,\n      allowedTransitions: matched.allowed_transitions,\n    };\n  }\n  const allowed = matched.allowed_transitions.some((pair) => {\n    const ruleFrom = resolveStatusId(pair[0], input.statusRegistry);\n    const ruleTo = resolveStatusId(pair[1], input.statusRegistry);\n    return ruleFrom === from && ruleTo === to;\n  });\n  return {\n    allowed,\n    hasRule: true,\n    allowedTransitions: matched.allowed_transitions,\n  };\n}\n\n/** Render the allowed transitions for an error/warning hint. */\nexport function describeAllowedTransitions(\n  allowedTransitions: [string, string][],\n): string {\n  if (allowedTransitions.length === 0) {\n    return \"(no transitions allowed)\";\n  }\n  return allowedTransitions\n    .map((pair) => `${pair[0]} -> ${pair[1]}`)\n    .join(\", \");\n}\n"],"names":[],"mappings":"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","debugId":"39c639fc-defa-54d2-a310-dad8a424f4cc"}

package/dist/cli-bundle/chunks/{chunk-7CHWLT2J.js → chunk-UVN66B3M.js}

@@ -1,7 +1,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/core/shared/numeric-parsers.js
 !(function() {
@@ -24,4 +24,4 @@ function parseLimit(raw, label = "--limit") {
 export {
   parseLimit
 };
-//# sourceMappingURL=chunk-7CHWLT2J.js.map
+//# sourceMappingURL=chunk-UVN66B3M.js.map

package/dist/cli-bundle/chunks/{chunk-Q6JPYR7I.js → chunk-UX6SSO2I.js}

@@ -1,7 +1,7 @@
 import {
   renameArtifactsResultKey,
   runLinkedArtifacts
-} from "./chunk-K2L6FZBX.js";
+} from "./chunk-RJO3YAFM.js";
 
 // dist/sdk/docs.js
 !(function() {
@@ -24,4 +24,4 @@ async function runDocs(id, options, global2) {
 export {
   runDocs
 };
-//# sourceMappingURL=chunk-Q6JPYR7I.js.map
+//# sourceMappingURL=chunk-UX6SSO2I.js.map

package/dist/cli-bundle/chunks/{chunk-JPWUZOMR.js → chunk-UZDQXNUB.js}

@@ -1,5 +1,5 @@
 
-!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]="ebed3dd6-7ac3-5ba9-81af-461fa44a9c47")}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]="57709eb3-e447-5777-876c-5164ce6a821d")}catch(e){}}();
 import {
   KNOWN_EXTENSION_CAPABILITIES,
   KNOWN_EXTENSION_POLICY_MODES,
@@ -11,7 +11,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/sdk/cli-contracts/command-aliases.js
 var EXECUTABLE_COMMAND_ALIASES = {
@@ -774,6 +774,26 @@ var UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
       }
     ]
   },
+  {
+    target: "addAc",
+    keys: ["addAc", "add_ac"],
+    option: "--add-ac <value>",
+    description: "Add one semicolon-free acceptance criterion without replacing the existing list (repeatable)",
+    repeatable: true,
+    aliasOptions: [
+      { option: "--add_ac <value>", description: "Alias for --add-ac" }
+    ]
+  },
+  {
+    target: "removeAc",
+    keys: ["removeAc", "remove_ac"],
+    option: "--remove-ac <value>",
+    description: "Remove one semicolon-free acceptance criterion by exact text match (repeatable)",
+    repeatable: true,
+    aliasOptions: [
+      { option: "--remove_ac <value>", description: "Alias for --remove-ac" }
+    ]
+  },
   {
     target: "definitionOfReady",
     keys: ["definitionOfReady", "definition_of_ready"],
@@ -1200,6 +1220,7 @@ var PM_CORE_COMMAND_NAMES = [
   "history-redact",
   "history-repair",
   "history-compact",
+  "merge",
   "schema",
   "profile",
   "activity",
@@ -1460,7 +1481,7 @@ var TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
   { param: "limit", flag: "--limit" },
   { param: "after", flag: "--after" }
 ];
-var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
+var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE = [
   { param: "parent", flag: "--parent" },
   { param: "reviewer", flag: "--reviewer" },
   { param: "risk", flag: "--risk" },
@@ -1495,7 +1516,9 @@ var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
   { param: "outcome", flag: "--outcome" },
   { param: "whyNow", flag: "--why-now" }
 ];
-var TOOL_CREATE_OPTION_CONTRACTS = [
+var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = cloneOptionContracts(TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE);
+var TOOL_CREATE_OPTION_CONTRACT_SOURCE = [
+  { param: "id", flag: "--id" },
   { param: "title", flag: "--title" },
   { param: "description", flag: "--description", allowEmpty: true },
   { param: "type", flag: "--type" },
@@ -1541,7 +1564,8 @@ var TOOL_CREATE_OPTION_CONTRACTS = [
   { param: "clearEvents", flag: "--clear-events" },
   { param: "clearTypeOptions", flag: "--clear-type-options" }
 ];
-var TOOL_UPDATE_OPTION_CONTRACTS = [
+var TOOL_CREATE_OPTION_CONTRACTS = cloneOptionContracts(TOOL_CREATE_OPTION_CONTRACT_SOURCE);
+var TOOL_UPDATE_OPTION_CONTRACT_SOURCE = [
   { param: "title", flag: "--title" },
   { param: "description", flag: "--description", allowEmpty: true },
   { param: "body", flag: "--body", allowEmpty: true },
@@ -1559,6 +1583,8 @@ var TOOL_UPDATE_OPTION_CONTRACTS = [
     flag: "--acceptance-criteria",
     allowEmpty: true
   },
+  { param: "addAc", flag: "--add-ac", repeatable: true },
+  { param: "removeAc", flag: "--remove-ac", repeatable: true },
   { param: "author", flag: "--author" },
   { param: "message", flag: "--message", allowEmpty: true },
   { param: "assignee", flag: "--assignee" },
@@ -1588,7 +1614,8 @@ var TOOL_UPDATE_OPTION_CONTRACTS = [
   { param: "clearEvents", flag: "--clear-events" },
   { param: "clearTypeOptions", flag: "--clear-type-options" }
 ];
-var TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS = [
+var TOOL_UPDATE_OPTION_CONTRACTS = cloneOptionContracts(TOOL_UPDATE_OPTION_CONTRACT_SOURCE);
+var TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE = [
   { param: "filterStatus", flag: "--filter-status" },
   { param: "filterType", flag: "--filter-type" },
   { param: "filterTag", flag: "--filter-tag" },
@@ -1631,8 +1658,8 @@ var TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS = [
   { param: "limit", flag: "--limit" },
   { param: "offset", flag: "--offset" }
 ];
-var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS)];
-var TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS = [...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS)];
+var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE);
+var TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS = cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE);
 var TOOL_CALENDAR_OPTION_CONTRACTS = [
   { param: "view", flag: "--view" },
   { param: "date", flag: "--date" },
@@ -1950,8 +1977,16 @@ var HISTORY_FLAG_CONTRACTS = [
   { flag: "--diff" },
   { flag: "--field" },
   { flag: "--verify" },
+  { flag: "--strict-exit" },
+  { flag: "--fail-on-warn" },
   { flag: "--format" }
 ];
+var MERGE_FLAG_CONTRACTS = [
+  { flag: "--dry-run" },
+  { flag: "--output" },
+  { flag: "--item-path" },
+  { flag: "--prefer" }
+];
 var HISTORY_REDACT_FLAG_CONTRACTS = [
   { flag: "--literal" },
   { flag: "--regex" },
@@ -2454,7 +2489,8 @@ var VALIDATE_FLAG_CONTRACTS = [
   { flag: "--fix-scope" },
   { flag: "--prune-missing" },
   { flag: "--check-history-drift" },
-  { flag: "--check-command-references" }
+  { flag: "--check-command-references" },
+  { flag: "--check-storage-integrity" }
 ];
 var CREATE_FLAG_CONTRACTS = [
   { short: "-t", flag: "--title" },
@@ -2583,6 +2619,8 @@ var UPDATE_FLAG_CONTRACTS = [
   { flag: "--acceptance-criteria" },
   { flag: "--acceptance_criteria" },
   { flag: "--ac" },
+  { flag: "--add-ac", aliases: ["--add_ac"] },
+  { flag: "--remove-ac", aliases: ["--remove_ac"] },
   { flag: "--assignee" },
   { flag: "--parent" },
   { flag: "--reviewer" },
@@ -2704,6 +2742,8 @@ var UPDATE_MANY_FLAG_CONTRACTS = [
   { flag: "--acceptance-criteria" },
   { flag: "--acceptance_criteria" },
   { flag: "--ac" },
+  { flag: "--add-ac", aliases: ["--add_ac"] },
+  { flag: "--remove-ac", aliases: ["--remove_ac"] },
   { flag: "--definition-of-ready" },
   { flag: "--definition_of_ready" },
   { flag: "--order" },
@@ -3001,6 +3041,7 @@ var SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
   ["history-redact", HISTORY_REDACT_FLAG_CONTRACTS],
   ["history-repair", HISTORY_REPAIR_FLAG_CONTRACTS],
   ["history-compact", HISTORY_COMPACT_FLAG_CONTRACTS],
+  ["merge", MERGE_FLAG_CONTRACTS],
   ["schema", SCHEMA_FLAG_CONTRACTS],
   ["profile", PROFILE_FLAG_CONTRACTS],
   ["plan", PLAN_FLAG_CONTRACTS],
@@ -3172,6 +3213,8 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   tags: { type: "string" },
   addTags: { type: "array", items: { type: "string" } },
   removeTags: { type: "array", items: { type: "string" } },
+  addAc: { type: "array", items: { type: "string" } },
+  removeAc: { type: "array", items: { type: "string" } },
   body: { type: "string" },
   deadline: { type: "string" },
   estimate: { anyOf: [{ type: "string" }, { type: "number" }] },
@@ -3875,6 +3918,14 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "Tags to add to the existing list without replacing it. Each entry may be CSV or a JSON array.",
     examples: [["agent-ux"], ["fix", "security"]]
   },
+  addAc: {
+    description: "Acceptance criteria appended individually without replacing the existing list (one criterion per entry).",
+    examples: [["error path covered by a regression test"]]
+  },
+  removeAc: {
+    description: "Acceptance criteria removed individually by exact text match (one criterion per entry).",
+    examples: [["superseded manual QA step"]]
+  },
   removeTags: {
     description: "Tags to remove from the existing list. Each entry may be CSV or a JSON array.",
     examples: [["stale"], ["legacy", "wontfix"]]
@@ -4057,7 +4108,7 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "For focus action: clear the session focused item instead of setting it (mutually exclusive with id)."
   },
   gcScope: {
-    description: "Repeatable gc scope selector values (index, embeddings, runtime, locks, checkpoints).",
+    description: "Repeatable gc scope selector values (index, embeddings, runtime, locks, checkpoints, transactions).",
     examples: [
       ["index", "embeddings"],
       ["runtime"],
@@ -4646,6 +4697,16 @@ var NEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
   "includeDecisions"
 ]);
 var AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = ["author", "message", "force"];
+var CLOSE_ACTION_OPTION_KEYS = [
+  "text",
+  "reason",
+  "closeReason",
+  "duplicateOf",
+  "validateClose",
+  "resolution",
+  "expectedResult",
+  "actualResult"
+];
 var LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = [
   "author",
   "assignee",
@@ -4986,14 +5047,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   close: {
     required: ["id"],
     optional: [
-      "text",
-      "reason",
-      "closeReason",
-      "duplicateOf",
-      "validateClose",
-      "resolution",
-      "expectedResult",
-      "actualResult",
+      ...CLOSE_ACTION_OPTION_KEYS,
       ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS
     ]
   },
@@ -5577,6 +5631,7 @@ export {
   FILES_FLAG_CONTRACTS,
   DOCS_FLAG_CONTRACTS,
   HISTORY_FLAG_CONTRACTS,
+  MERGE_FLAG_CONTRACTS,
   HISTORY_REDACT_FLAG_CONTRACTS,
   HISTORY_REPAIR_FLAG_CONTRACTS,
   HISTORY_COMPACT_FLAG_CONTRACTS,
@@ -5651,6 +5706,6 @@ export {
   PM_TOOL_PARAMETERS_SCHEMA,
   PM_PROVIDER_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-JPWUZOMR.js.map
+//# sourceMappingURL=chunk-UZDQXNUB.js.map
 
-//# debugId=ebed3dd6-7ac3-5ba9-81af-461fa44a9c47
+//# debugId=57709eb3-e447-5777-876c-5164ce6a821d