@unbrained/pm-cli 2026.7.5 → 2026.7.6

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

@@ -1,243 +0,0 @@
-import {
-  hashDocument,
-  toItemRecord
-} from "./chunk-3U3VEWK6.js";
-import {
-  canonicalDocument
-} from "./chunk-EZFKWSC7.js";
-import {
-  orderObject,
-  sha256Hex,
-  stableStringify
-} from "./chunk-P5YORJRH.js";
-import {
-  FRONT_MATTER_KEY_ORDER
-} from "./chunk-5VVUKE3U.js";
-
-// dist/core/history/replay.js
-import jsonPatch from "fast-json-patch";
-!(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] = "cf6461d3-7d73-5aa9-afa3-65f14d708e4c");
-  } catch (e2) {
-  }
-})();
-var EMPTY_REPLAY_DOCUMENT = {
-  metadata: {},
-  body: ""
-};
-function cloneEmptyReplayDocument() {
-  return structuredClone(EMPTY_REPLAY_DOCUMENT);
-}
-function replayHash(document) {
-  try {
-    return hashDocument(replayToItemDocument(document));
-  } catch {
-    return sha256Hex(stableStringify({ replay_fallback: true, metadata: document.metadata, body: document.body }));
-  }
-}
-function replayToItemDocument(document) {
-  return {
-    metadata: document.metadata,
-    body: document.body
-  };
-}
-function replayToCanonicalItemDocument(document, options = {}) {
-  return canonicalDocument(replayToItemDocument(document), options);
-}
-function toReplayDocument(document) {
-  if (!document.metadata || Object.keys(document.metadata).length === 0) {
-    return {
-      metadata: {},
-      body: document.body ?? ""
-    };
-  }
-  const canonical = canonicalDocument(document);
-  return {
-    metadata: orderObject(toItemRecord(canonical.metadata), FRONT_MATTER_KEY_ORDER),
-    body: canonical.body
-  };
-}
-function normalizeReplayPatchPath(path) {
-  if (path === "/front_matter") {
-    return "/metadata";
-  }
-  if (path.startsWith("/front_matter/")) {
-    return `/metadata/${path.slice("/front_matter/".length)}`;
-  }
-  return path;
-}
-function isHistoryPatchOp(value) {
-  return typeof value === "object" && value !== null && typeof value.op === "string" && typeof value.path === "string";
-}
-function normalizeReplayPatchOps(patch) {
-  if (!Array.isArray(patch)) {
-    return [];
-  }
-  return patch.filter(isHistoryPatchOp).map((operation) => ({
-    ...operation,
-    path: normalizeReplayPatchPath(operation.path),
-    from: typeof operation.from === "string" ? normalizeReplayPatchPath(operation.from) : void 0
-  }));
-}
-function isReplayDocumentShape(value) {
-  return typeof value === "object" && value !== null && "metadata" in value && "body" in value && typeof value.body === "string" && typeof value.metadata === "object" && value.metadata !== null;
-}
-function tryApplyReplayPatch(current, patch) {
-  try {
-    const normalizedPatch = normalizeReplayPatchOps(patch);
-    const applied = jsonPatch.applyPatch(structuredClone(current), normalizedPatch, true, false).newDocument;
-    if (!isReplayDocumentShape(applied)) {
-      return { ok: false, error: new Error("history_replay_invalid_document_shape") };
-    }
-    return { ok: true, document: { metadata: applied.metadata, body: applied.body } };
-  } catch (error) {
-    return { ok: false, error };
-  }
-}
-function verifyHistoryChain(entries) {
-  let replay = cloneEmptyReplayDocument();
-  for (let index = 0; index < entries.length; index += 1) {
-    const entry = entries[index];
-    if (replayHash(replay) !== entry.before_hash) {
-      return {
-        ok: false,
-        errors: [`verify_failed:before_hash_mismatch:entry_${index + 1}`]
-      };
-    }
-    const applied = tryApplyReplayPatch(replay, entry.patch);
-    if (!applied.ok) {
-      return {
-        ok: false,
-        errors: [`verify_failed:patch_apply_failed:entry_${index + 1}`]
-      };
-    }
-    replay = applied.document;
-    if (replayHash(replay) !== entry.after_hash) {
-      return {
-        ok: false,
-        errors: [`verify_failed:after_hash_mismatch:entry_${index + 1}`]
-      };
-    }
-  }
-  return { ok: true, errors: [] };
-}
-function tryApplySingleOp(document, op) {
-  try {
-    const applied = jsonPatch.applyPatch(structuredClone(document), [op], true, false).newDocument;
-    return { ok: true, document: applied };
-  } catch {
-    return { ok: false };
-  }
-}
-function lenientApplyReplayPatch(current, patch) {
-  let working = structuredClone(current);
-  let convertedReplaceToAdd = 0;
-  let skippedOps = 0;
-  for (const op of normalizeReplayPatchOps(patch)) {
-    const direct = tryApplySingleOp(working, op);
-    if (direct.ok) {
-      working = direct.document;
-      continue;
-    }
-    if (op.op === "replace") {
-      const asAdd = tryApplySingleOp(working, { ...op, op: "add" });
-      if (asAdd.ok) {
-        working = asAdd.document;
-        convertedReplaceToAdd += 1;
-        continue;
-      }
-    }
-    skippedOps += 1;
-  }
-  const candidate = working;
-  const document = {
-    metadata: typeof candidate.metadata === "object" && candidate.metadata !== null ? candidate.metadata : {},
-    body: typeof candidate.body === "string" ? candidate.body : current.body
-  };
-  return { document, convertedReplaceToAdd, skippedOps };
-}
-function reanchorHistoryEntries(entries) {
-  let replay = cloneEmptyReplayDocument();
-  const rewritten = [];
-  const details = [];
-  let entriesRehashed = 0;
-  let entriesPatchRepaired = 0;
-  let convertedReplaceToAdd = 0;
-  let skippedOps = 0;
-  for (let index = 0; index < entries.length; index += 1) {
-    const entry = entries[index];
-    const beforeHash = replayHash(replay);
-    const strict = tryApplyReplayPatch(replay, entry.patch);
-    let next;
-    let outPatch;
-    let patchRepaired = false;
-    let entryConverted = 0;
-    let entrySkipped = 0;
-    if (strict.ok) {
-      next = strict.document;
-      outPatch = entry.patch;
-    } else {
-      const lenient = lenientApplyReplayPatch(replay, entry.patch);
-      next = lenient.document;
-      outPatch = jsonPatch.compare(replay, next);
-      patchRepaired = true;
-      entryConverted = lenient.convertedReplaceToAdd;
-      entrySkipped = lenient.skippedOps;
-      convertedReplaceToAdd += entryConverted;
-      skippedOps += entrySkipped;
-      entriesPatchRepaired += 1;
-    }
-    const afterHash = replayHash(next);
-    const rehashed = beforeHash !== entry.before_hash || afterHash !== entry.after_hash;
-    if (rehashed) {
-      entriesRehashed += 1;
-    }
-    rewritten.push({
-      ...entry,
-      patch: outPatch,
-      before_hash: beforeHash,
-      after_hash: afterHash
-    });
-    details.push({
-      index: index + 1,
-      rehashed,
-      patch_repaired: patchRepaired,
-      converted_replace_to_add: entryConverted,
-      skipped_ops: entrySkipped
-    });
-    replay = next;
-  }
-  return {
-    entries: rewritten,
-    finalDocument: replay,
-    entriesRehashed,
-    entriesPatchRepaired,
-    convertedReplaceToAdd,
-    skippedOps,
-    details
-  };
-}
-function historyEntriesToRaw(entries) {
-  if (entries.length === 0) {
-    return "";
-  }
-  return `${entries.map((entry) => JSON.stringify(entry)).join("\n")}
-`;
-}
-
-export {
-  EMPTY_REPLAY_DOCUMENT,
-  cloneEmptyReplayDocument,
-  replayHash,
-  replayToItemDocument,
-  replayToCanonicalItemDocument,
-  toReplayDocument,
-  normalizeReplayPatchOps,
-  tryApplyReplayPatch,
-  verifyHistoryChain,
-  reanchorHistoryEntries,
-  historyEntriesToRaw
-};
-//# sourceMappingURL=chunk-D3UCE7RW.js.map

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

@@ -1,275 +0,0 @@
-import {
-  CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS
-} from "./chunk-UI5BJ6DO.js";
-import {
-  nowIso
-} from "./chunk-DRBV5UC2.js";
-import {
-  PmCliError
-} from "./chunk-P5YORJRH.js";
-import {
-  EXIT_CODE,
-  getSettingsPath,
-  pathExists,
-  readFileIfExists,
-  resolvePmRoot,
-  writeFileAtomic
-} from "./chunk-5VVUKE3U.js";
-
-// dist/cli/commands/templates.js
-import fs from "node:fs/promises";
-import path from "node:path";
-!(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] = "4ac1eb25-6b3f-549e-b7f5-6b4c53071b9a");
-  } catch (e2) {
-  }
-})();
-var TEMPLATE_DIRECTORY_NAME = "templates";
-var TEMPLATE_FILE_EXTENSION = ".json";
-var TEMPLATE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
-var TEMPLATE_OPTION_REPEATABLE_KEYS = CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS.map((entry) => entry.target);
-var TEMPLATE_OPTION_REPEATABLE_KEY_SET = new Set(TEMPLATE_OPTION_REPEATABLE_KEYS);
-var BUILTIN_TEMPLATE_TIMESTAMP = "1970-01-01T00:00:00.000Z";
-var BUILTIN_TEMPLATES = {
-  bug: {
-    type: "Issue",
-    priority: "1",
-    tags: "bug",
-    acceptanceCriteria: "Bug no longer reproduces with the steps below and a regression test guards it.",
-    expectedResult: "Describe the correct behavior.",
-    actualResult: "Describe the observed (buggy) behavior.",
-    body: "## Repro steps\n1. \n2. \n3. \n\n## Expected\n\n## Actual\n"
-  },
-  feature: {
-    type: "Feature",
-    priority: "2",
-    tags: "feature",
-    acceptanceCriteria: "Feature is shipped behind agreed scope with tests and docs updated.",
-    whyNow: "Explain why this is worth doing now (impact / urgency).",
-    body: "## Goal\n\n## Why now\n\n## Out of scope\n"
-  },
-  spike: {
-    type: "Task",
-    priority: "2",
-    tags: "spike",
-    estimatedMinutes: "120",
-    acceptanceCriteria: "Timeboxed investigation complete; findings and a recommendation are recorded.",
-    body: "## Question to answer\n\n## Timebox\n2h\n\n## Findings\n\n## Recommendation\n"
-  },
-  chore: {
-    type: "Chore",
-    priority: "3",
-    tags: "chore",
-    acceptanceCriteria: "Maintenance task done with no behavior change and green checks.",
-    body: "## What\n\n## Why\n"
-  }
-};
-function normalizeTemplateName(rawName) {
-  const name = rawName.trim();
-  if (!TEMPLATE_NAME_PATTERN.test(name)) {
-    throw new PmCliError(`Invalid template name "${rawName}". Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._-]*.`, EXIT_CODE.USAGE);
-  }
-  return name;
-}
-function templatesDirectory(pmRoot) {
-  return path.join(pmRoot, TEMPLATE_DIRECTORY_NAME);
-}
-function templatePath(pmRoot, normalizedName) {
-  return path.join(templatesDirectory(pmRoot), `${normalizedName}${TEMPLATE_FILE_EXTENSION}`);
-}
-async function ensureTrackerInitialized(pmRoot) {
-  if (!await pathExists(getSettingsPath(pmRoot))) {
-    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-  }
-}
-function sortTemplateOptions(options) {
-  return Object.fromEntries(Object.entries(options).sort(([left], [right]) => left.localeCompare(right)));
-}
-function extractTemplateOptions(rawOptions) {
-  const next = {};
-  for (const [key, value] of Object.entries(rawOptions)) {
-    if (value === void 0) {
-      continue;
-    }
-    if (TEMPLATE_OPTION_REPEATABLE_KEY_SET.has(key)) {
-      if (typeof value === "string") {
-        next[key] = [value];
-        continue;
-      }
-      if (!Array.isArray(value)) {
-        continue;
-      }
-      const values = value.filter((entry) => typeof entry === "string");
-      if (values.length > 0) {
-        next[key] = values;
-      }
-      continue;
-    }
-    if (typeof value === "string") {
-      next[key] = value;
-      continue;
-    }
-    if (Array.isArray(value) && value.every((entry) => typeof entry === "string")) {
-      next[key] = [...value];
-    }
-  }
-  return sortTemplateOptions(next);
-}
-function parseStoredTemplateOptions(rawOptions, templateName) {
-  if (typeof rawOptions !== "object" || rawOptions === null || Array.isArray(rawOptions)) {
-    throw new PmCliError(`Template "${templateName}" has invalid options payload.`, EXIT_CODE.GENERIC_FAILURE);
-  }
-  const optionsRecord = rawOptions;
-  const normalized = {};
-  for (const [key, value] of Object.entries(optionsRecord)) {
-    const normalizedKey = key.trim();
-    if (normalizedKey.length === 0) {
-      throw new PmCliError(`Template "${templateName}" contains an empty option key.`, EXIT_CODE.GENERIC_FAILURE);
-    }
-    if (typeof value === "string") {
-      normalized[normalizedKey] = value;
-      continue;
-    }
-    if (Array.isArray(value) && value.every((entry) => typeof entry === "string")) {
-      normalized[normalizedKey] = [...value];
-      continue;
-    }
-    throw new PmCliError(`Template "${templateName}" contains invalid value for option "${normalizedKey}".`, EXIT_CODE.GENERIC_FAILURE);
-  }
-  return sortTemplateOptions(normalized);
-}
-function parseStoredTemplateDocument(raw, normalizedName) {
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    throw new PmCliError(`Template "${normalizedName}" contains invalid JSON.`, EXIT_CODE.GENERIC_FAILURE);
-  }
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    throw new PmCliError(`Template "${normalizedName}" has invalid document shape.`, EXIT_CODE.GENERIC_FAILURE);
-  }
-  const record = parsed;
-  const options = parseStoredTemplateOptions(record.options, normalizedName);
-  const now = nowIso();
-  return {
-    name: typeof record.name === "string" && record.name.trim().length > 0 ? record.name.trim() : normalizedName,
-    created_at: typeof record.created_at === "string" ? record.created_at : now,
-    updated_at: typeof record.updated_at === "string" ? record.updated_at : now,
-    options
-  };
-}
-function builtinTemplateDocument(normalizedName) {
-  const options = BUILTIN_TEMPLATES[normalizedName];
-  if (!options) {
-    return null;
-  }
-  return {
-    name: normalizedName,
-    created_at: BUILTIN_TEMPLATE_TIMESTAMP,
-    updated_at: BUILTIN_TEMPLATE_TIMESTAMP,
-    options: sortTemplateOptions({ ...options })
-  };
-}
-async function resolveTemplateDocument(pmRoot, normalizedName) {
-  const raw = await readFileIfExists(templatePath(pmRoot, normalizedName));
-  if (raw !== null) {
-    return { document: parseStoredTemplateDocument(raw, normalizedName), source: "user" };
-  }
-  const builtin = builtinTemplateDocument(normalizedName);
-  if (builtin) {
-    return { document: builtin, source: "builtin" };
-  }
-  throw new PmCliError(`Template "${normalizedName}" not found`, EXIT_CODE.NOT_FOUND);
-}
-async function readStoredTemplateDocument(pmRoot, normalizedName) {
-  const raw = await readFileIfExists(templatePath(pmRoot, normalizedName));
-  if (raw === null) {
-    throw new PmCliError(`Template "${normalizedName}" not found`, EXIT_CODE.NOT_FOUND);
-  }
-  return parseStoredTemplateDocument(raw, normalizedName);
-}
-async function loadCreateTemplateOptions(pmRoot, rawTemplateName) {
-  const normalizedName = normalizeTemplateName(rawTemplateName);
-  const { document } = await resolveTemplateDocument(pmRoot, normalizedName);
-  return document.options;
-}
-async function runTemplatesSave(rawTemplateName, options, global2) {
-  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
-  await ensureTrackerInitialized(pmRoot);
-  const normalizedName = normalizeTemplateName(rawTemplateName);
-  const nextOptions = extractTemplateOptions(options);
-  if (Object.keys(nextOptions).length === 0) {
-    throw new PmCliError("templates save requires at least one create option flag", EXIT_CODE.USAGE);
-  }
-  const now = nowIso();
-  const storedPath = templatePath(pmRoot, normalizedName);
-  let createdAt = now;
-  if (await pathExists(storedPath)) {
-    const existing = await readStoredTemplateDocument(pmRoot, normalizedName);
-    createdAt = existing.created_at;
-  }
-  const document = {
-    name: normalizedName,
-    created_at: createdAt,
-    updated_at: now,
-    options: nextOptions
-  };
-  await fs.mkdir(templatesDirectory(pmRoot), { recursive: true });
-  await writeFileAtomic(storedPath, `${JSON.stringify(document, null, 2)}
-`);
-  return {
-    name: document.name,
-    created_at: document.created_at,
-    updated_at: document.updated_at,
-    path: storedPath,
-    options: document.options
-  };
-}
-async function readUserTemplateNames(pmRoot) {
-  const dirPath = templatesDirectory(pmRoot);
-  if (!await pathExists(dirPath)) {
-    return [];
-  }
-  const entries = await fs.readdir(dirPath);
-  return entries.filter((entry) => entry.toLowerCase().endsWith(TEMPLATE_FILE_EXTENSION)).map((entry) => entry.slice(0, -TEMPLATE_FILE_EXTENSION.length)).filter((entry) => TEMPLATE_NAME_PATTERN.test(entry));
-}
-async function runTemplatesList(global2) {
-  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
-  await ensureTrackerInitialized(pmRoot);
-  const userTemplates = await readUserTemplateNames(pmRoot);
-  const userTemplateSet = new Set(userTemplates);
-  const builtinTemplates = Object.keys(BUILTIN_TEMPLATES).filter((name) => !userTemplateSet.has(name));
-  const sortedUser = [...userTemplates].sort((left, right) => left.localeCompare(right));
-  const sortedBuiltin = [...builtinTemplates].sort((left, right) => left.localeCompare(right));
-  const templates = [.../* @__PURE__ */ new Set([...sortedUser, ...sortedBuiltin])].sort((left, right) => left.localeCompare(right));
-  return {
-    templates,
-    count: templates.length,
-    builtin_templates: sortedBuiltin,
-    user_templates: sortedUser
-  };
-}
-async function runTemplatesShow(rawTemplateName, global2) {
-  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
-  await ensureTrackerInitialized(pmRoot);
-  const normalizedName = normalizeTemplateName(rawTemplateName);
-  const { document, source } = await resolveTemplateDocument(pmRoot, normalizedName);
-  return {
-    name: document.name,
-    source,
-    created_at: document.created_at,
-    updated_at: document.updated_at,
-    path: source === "builtin" ? `builtin:${normalizedName}` : templatePath(pmRoot, normalizedName),
-    options: document.options
-  };
-}
-
-export {
-  loadCreateTemplateOptions,
-  runTemplatesSave,
-  runTemplatesList,
-  runTemplatesShow
-};
-//# sourceMappingURL=chunk-DC3QJQWI.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/templates.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/templates\n *\n * Implements the pm templates command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport {\n  CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n} from \"../../sdk/cli-contracts.js\";\n\nconst TEMPLATE_DIRECTORY_NAME = \"templates\";\nconst TEMPLATE_FILE_EXTENSION = \".json\";\nconst TEMPLATE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;\n\nconst TEMPLATE_OPTION_REPEATABLE_KEYS = CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS.map((entry) => entry.target);\nconst TEMPLATE_OPTION_REPEATABLE_KEY_SET = new Set<string>(TEMPLATE_OPTION_REPEATABLE_KEYS);\n\ntype TemplateOptionValue = string | string[];\n/**\n * Restricts create template options values accepted by command, SDK, and storage contracts.\n */\nexport type CreateTemplateOptions = Record<string, TemplateOptionValue>;\n/**\n * Restricts template source values accepted by command, SDK, and storage contracts.\n */\nexport type TemplateSource = \"builtin\" | \"user\";\n\nconst BUILTIN_TEMPLATE_TIMESTAMP = \"1970-01-01T00:00:00.000Z\";\nconst BUILTIN_TEMPLATES: Readonly<Record<string, CreateTemplateOptions>> = {\n  bug: {\n    type: \"Issue\",\n    priority: \"1\",\n    tags: \"bug\",\n    acceptanceCriteria: \"Bug no longer reproduces with the steps below and a regression test guards it.\",\n    expectedResult: \"Describe the correct behavior.\",\n    actualResult: \"Describe the observed (buggy) behavior.\",\n    body: \"## Repro steps\\n1. \\n2. \\n3. \\n\\n## Expected\\n\\n## Actual\\n\",\n  },\n  feature: {\n    type: \"Feature\",\n    priority: \"2\",\n    tags: \"feature\",\n    acceptanceCriteria: \"Feature is shipped behind agreed scope with tests and docs updated.\",\n    whyNow: \"Explain why this is worth doing now (impact / urgency).\",\n    body: \"## Goal\\n\\n## Why now\\n\\n## Out of scope\\n\",\n  },\n  spike: {\n    type: \"Task\",\n    priority: \"2\",\n    tags: \"spike\",\n    estimatedMinutes: \"120\",\n    acceptanceCriteria: \"Timeboxed investigation complete; findings and a recommendation are recorded.\",\n    body: \"## Question to answer\\n\\n## Timebox\\n2h\\n\\n## Findings\\n\\n## Recommendation\\n\",\n  },\n  chore: {\n    type: \"Chore\",\n    priority: \"3\",\n    tags: \"chore\",\n    acceptanceCriteria: \"Maintenance task done with no behavior change and green checks.\",\n    body: \"## What\\n\\n## Why\\n\",\n  },\n};\n\ninterface StoredCreateTemplateDocument {\n  name: string;\n  created_at: string;\n  updated_at: string;\n  options: CreateTemplateOptions;\n}\n\nexport const _testOnly = {\n  normalizeTemplateName,\n  extractTemplateOptions,\n  parseStoredTemplateDocument,\n  builtinTemplateDocument,\n  readStoredTemplateDocument,\n};\n\n/**\n * Documents the templates save result payload exchanged by command, SDK, and package integrations.\n */\nexport interface TemplatesSaveResult {\n  name: string;\n  created_at: string;\n  updated_at: string;\n  path: string;\n  options: CreateTemplateOptions;\n}\n\n/**\n * Documents the templates list result payload exchanged by command, SDK, and package integrations.\n */\nexport interface TemplatesListResult {\n  templates: string[];\n  count: number;\n  builtin_templates: string[];\n  user_templates: string[];\n}\n\n/**\n * Documents the templates show result payload exchanged by command, SDK, and package integrations.\n */\nexport interface TemplatesShowResult {\n  name: string;\n  source: TemplateSource;\n  created_at: string;\n  updated_at: string;\n  path: string;\n  options: CreateTemplateOptions;\n}\n\nfunction normalizeTemplateName(rawName: string): string {\n  const name = rawName.trim();\n  if (!TEMPLATE_NAME_PATTERN.test(name)) {\n    throw new PmCliError(\n      `Invalid template name \"${rawName}\". Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._-]*.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return name;\n}\n\nfunction templatesDirectory(pmRoot: string): string {\n  return path.join(pmRoot, TEMPLATE_DIRECTORY_NAME);\n}\n\nfunction templatePath(pmRoot: string, normalizedName: string): string {\n  return path.join(templatesDirectory(pmRoot), `${normalizedName}${TEMPLATE_FILE_EXTENSION}`);\n}\n\nasync function ensureTrackerInitialized(pmRoot: string): Promise<void> {\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n}\n\nfunction sortTemplateOptions(options: CreateTemplateOptions): CreateTemplateOptions {\n  return Object.fromEntries(\n    Object.entries(options).sort(([left], [right]) => left.localeCompare(right)),\n  ) as CreateTemplateOptions;\n}\n\nfunction extractTemplateOptions(rawOptions: Record<string, unknown>): CreateTemplateOptions {\n  const next: CreateTemplateOptions = {};\n  for (const [key, value] of Object.entries(rawOptions)) {\n    if (value === undefined) {\n      continue;\n    }\n    if (TEMPLATE_OPTION_REPEATABLE_KEY_SET.has(key)) {\n      if (typeof value === \"string\") {\n        next[key] = [value];\n        continue;\n      }\n      if (!Array.isArray(value)) {\n        continue;\n      }\n      const values = value.filter((entry): entry is string => typeof entry === \"string\");\n      if (values.length > 0) {\n        next[key] = values;\n      }\n      continue;\n    }\n    if (typeof value === \"string\") {\n      next[key] = value;\n      continue;\n    }\n    if (Array.isArray(value) && value.every((entry) => typeof entry === \"string\")) {\n      next[key] = [...value];\n    }\n  }\n  return sortTemplateOptions(next);\n}\n\nfunction parseStoredTemplateOptions(rawOptions: unknown, templateName: string): CreateTemplateOptions {\n  if (typeof rawOptions !== \"object\" || rawOptions === null || Array.isArray(rawOptions)) {\n    throw new PmCliError(`Template \"${templateName}\" has invalid options payload.`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  const optionsRecord = rawOptions as Record<string, unknown>;\n  const normalized: CreateTemplateOptions = {};\n  for (const [key, value] of Object.entries(optionsRecord)) {\n    const normalizedKey = key.trim();\n    if (normalizedKey.length === 0) {\n      throw new PmCliError(\n        `Template \"${templateName}\" contains an empty option key.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    if (typeof value === \"string\") {\n      normalized[normalizedKey] = value;\n      continue;\n    }\n    if (Array.isArray(value) && value.every((entry) => typeof entry === \"string\")) {\n      normalized[normalizedKey] = [...value];\n      continue;\n    }\n    throw new PmCliError(\n      `Template \"${templateName}\" contains invalid value for option \"${normalizedKey}\".`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  return sortTemplateOptions(normalized);\n}\n\nfunction parseStoredTemplateDocument(raw: string, normalizedName: string): StoredCreateTemplateDocument {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new PmCliError(`Template \"${normalizedName}\" contains invalid JSON.`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new PmCliError(`Template \"${normalizedName}\" has invalid document shape.`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  const record = parsed as Record<string, unknown>;\n  const options = parseStoredTemplateOptions(record.options, normalizedName);\n  const now = nowIso();\n  return {\n    name: typeof record.name === \"string\" && record.name.trim().length > 0 ? record.name.trim() : normalizedName,\n    created_at: typeof record.created_at === \"string\" ? record.created_at : now,\n    updated_at: typeof record.updated_at === \"string\" ? record.updated_at : now,\n    options,\n  };\n}\n\nfunction builtinTemplateDocument(normalizedName: string): StoredCreateTemplateDocument | null {\n  const options = BUILTIN_TEMPLATES[normalizedName];\n  if (!options) {\n    return null;\n  }\n  return {\n    name: normalizedName,\n    created_at: BUILTIN_TEMPLATE_TIMESTAMP,\n    updated_at: BUILTIN_TEMPLATE_TIMESTAMP,\n    options: sortTemplateOptions({ ...options }),\n  };\n}\n\ninterface ResolvedTemplateDocument {\n  document: StoredCreateTemplateDocument;\n  source: TemplateSource;\n}\n\nasync function resolveTemplateDocument(pmRoot: string, normalizedName: string): Promise<ResolvedTemplateDocument> {\n  const raw = await readFileIfExists(templatePath(pmRoot, normalizedName));\n  if (raw !== null) {\n    return { document: parseStoredTemplateDocument(raw, normalizedName), source: \"user\" };\n  }\n  const builtin = builtinTemplateDocument(normalizedName);\n  if (builtin) {\n    return { document: builtin, source: \"builtin\" };\n  }\n  throw new PmCliError(`Template \"${normalizedName}\" not found`, EXIT_CODE.NOT_FOUND);\n}\n\nasync function readStoredTemplateDocument(pmRoot: string, normalizedName: string): Promise<StoredCreateTemplateDocument> {\n  const raw = await readFileIfExists(templatePath(pmRoot, normalizedName));\n  if (raw === null) {\n    throw new PmCliError(`Template \"${normalizedName}\" not found`, EXIT_CODE.NOT_FOUND);\n  }\n  return parseStoredTemplateDocument(raw, normalizedName);\n}\n\n/**\n * Implements load create template options for the public runtime surface of this module.\n */\nexport async function loadCreateTemplateOptions(pmRoot: string, rawTemplateName: string): Promise<CreateTemplateOptions> {\n  const normalizedName = normalizeTemplateName(rawTemplateName);\n  const { document } = await resolveTemplateDocument(pmRoot, normalizedName);\n  return document.options;\n}\n\n/**\n * Implements run templates save for the public runtime surface of this module.\n */\nexport async function runTemplatesSave(\n  rawTemplateName: string,\n  options: Record<string, unknown>,\n  global: GlobalOptions,\n): Promise<TemplatesSaveResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  await ensureTrackerInitialized(pmRoot);\n  const normalizedName = normalizeTemplateName(rawTemplateName);\n  const nextOptions = extractTemplateOptions(options);\n  if (Object.keys(nextOptions).length === 0) {\n    throw new PmCliError(\"templates save requires at least one create option flag\", EXIT_CODE.USAGE);\n  }\n\n  const now = nowIso();\n  const storedPath = templatePath(pmRoot, normalizedName);\n  let createdAt = now;\n  if (await pathExists(storedPath)) {\n    const existing = await readStoredTemplateDocument(pmRoot, normalizedName);\n    createdAt = existing.created_at;\n  }\n\n  const document: StoredCreateTemplateDocument = {\n    name: normalizedName,\n    created_at: createdAt,\n    updated_at: now,\n    options: nextOptions,\n  };\n  await fs.mkdir(templatesDirectory(pmRoot), { recursive: true });\n  await writeFileAtomic(storedPath, `${JSON.stringify(document, null, 2)}\\n`);\n  return {\n    name: document.name,\n    created_at: document.created_at,\n    updated_at: document.updated_at,\n    path: storedPath,\n    options: document.options,\n  };\n}\n\nasync function readUserTemplateNames(pmRoot: string): Promise<string[]> {\n  const dirPath = templatesDirectory(pmRoot);\n  if (!(await pathExists(dirPath))) {\n    return [];\n  }\n  const entries = await fs.readdir(dirPath);\n  return entries\n    .filter((entry) => entry.toLowerCase().endsWith(TEMPLATE_FILE_EXTENSION))\n    .map((entry) => entry.slice(0, -TEMPLATE_FILE_EXTENSION.length))\n    .filter((entry) => TEMPLATE_NAME_PATTERN.test(entry));\n}\n\n/**\n * Implements run templates list for the public runtime surface of this module.\n */\nexport async function runTemplatesList(global: GlobalOptions): Promise<TemplatesListResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  await ensureTrackerInitialized(pmRoot);\n  const userTemplates = await readUserTemplateNames(pmRoot);\n  const userTemplateSet = new Set<string>(userTemplates);\n  const builtinTemplates = Object.keys(BUILTIN_TEMPLATES).filter((name) => !userTemplateSet.has(name));\n  const sortedUser = [...userTemplates].sort((left, right) => left.localeCompare(right));\n  const sortedBuiltin = [...builtinTemplates].sort((left, right) => left.localeCompare(right));\n  const templates = [...new Set([...sortedUser, ...sortedBuiltin])].sort((left, right) => left.localeCompare(right));\n  return {\n    templates,\n    count: templates.length,\n    builtin_templates: sortedBuiltin,\n    user_templates: sortedUser,\n  };\n}\n\n/**\n * Implements run templates show for the public runtime surface of this module.\n */\nexport async function runTemplatesShow(rawTemplateName: string, global: GlobalOptions): Promise<TemplatesShowResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  await ensureTrackerInitialized(pmRoot);\n  const normalizedName = normalizeTemplateName(rawTemplateName);\n  const { document, source } = await resolveTemplateDocument(pmRoot, normalizedName);\n  return {\n    name: document.name,\n    source,\n    created_at: document.created_at,\n    updated_at: document.updated_at,\n    path: source === \"builtin\" ? `builtin:${normalizedName}` : templatePath(pmRoot, normalizedName),\n    options: document.options,\n  };\n}\n"],
-  "mappings": "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",
-  "names": ["global"]
-}