@unbrained/pm-cli 2026.7.19 → 2026.7.20

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

@@ -0,0 +1,334 @@
+
+!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]="85f534fd-62b4-5641-8729-6dcd58b50e94")}catch(e){}}();
+import {
+  acquireLock,
+  getActiveExtensionRegistrations,
+  nowIso,
+  readSettings,
+  resolveGovernanceKnobs
+} from "./chunk-POG76WWZ.js";
+import {
+  EXIT_CODE,
+  PmCliError,
+  getSettingsPath,
+  pathExists,
+  resolveItemTypeRegistry,
+  resolvePmRoot
+} from "./chunk-HYW67VJ5.js";
+
+// dist/sdk/workspace.js
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+var PM_GITIGNORE_START = "# pm-cli:runtime-cache:start";
+var PM_GITIGNORE_END = "# pm-cli:runtime-cache:end";
+var PM_GITIGNORE_DEFAULT_TRACKER_ROOT = ".agents/pm";
+var PM_GITIGNORE_RUNTIME_DIRECTORIES = [
+  "runtime/",
+  "search/",
+  "locks/",
+  "transactions/",
+  "checkpoints/"
+];
+function normalizeTrackerRelativeRoot(trackerRelativeRoot) {
+  return trackerRelativeRoot.replaceAll("\\", "/").replace(/^\.\/+/, "").replace(/\/+$/, "");
+}
+function isPathOutsideRoot(relativePath) {
+  const normalized = relativePath.replaceAll("\\", "/");
+  return path.isAbsolute(relativePath) || normalized === ".." || normalized.startsWith("../");
+}
+function getPmGitignoreBlock(trackerRelativeRoot = PM_GITIGNORE_DEFAULT_TRACKER_ROOT) {
+  const root = normalizeTrackerRelativeRoot(trackerRelativeRoot);
+  return [
+    PM_GITIGNORE_START,
+    ...PM_GITIGNORE_RUNTIME_DIRECTORIES.map((directory) => `${root}/${directory}`),
+    PM_GITIGNORE_END
+  ].join("\n");
+}
+async function ensurePmGitignore(workspaceRoot, options = {}) {
+  const gitignorePath = path.join(workspaceRoot, ".gitignore");
+  let trackerRelativeRoot = PM_GITIGNORE_DEFAULT_TRACKER_ROOT;
+  if (options.pmRoot !== void 0) {
+    const relative = normalizeTrackerRelativeRoot(path.relative(path.resolve(workspaceRoot), path.resolve(options.pmRoot)));
+    if (isPathOutsideRoot(relative)) {
+      return { path: gitignorePath, changed: false };
+    }
+    if (relative.length > 0) {
+      trackerRelativeRoot = relative;
+    }
+  }
+  let current = "";
+  try {
+    current = await readFile(gitignorePath, "utf8");
+  } catch (error) {
+    if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) {
+      throw error;
+    }
+  }
+  const start = current.indexOf(PM_GITIGNORE_START);
+  const end = current.indexOf(PM_GITIGNORE_END);
+  const withoutManagedBlock = start >= 0 && end >= start ? `${current.slice(0, start)}${current.slice(end + PM_GITIGNORE_END.length)}` : current;
+  const prefix = withoutManagedBlock.trimEnd();
+  const next = `${prefix.length > 0 ? `${prefix}
+
+` : ""}${getPmGitignoreBlock(trackerRelativeRoot)}
+`;
+  if (next === current) {
+    return { path: gitignorePath, changed: false };
+  }
+  await writeFile(gitignorePath, next, "utf8");
+  return { path: gitignorePath, changed: true };
+}
+
+// dist/sdk/merge/install.js
+import { readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import path2 from "node:path";
+import { promisify } from "node:util";
+var execFileAsync = promisify(execFile);
+var PM_GITATTRIBUTES_START = "# pm-cli:merge-drivers:start";
+var PM_GITATTRIBUTES_END = "# pm-cli:merge-drivers:end";
+var MERGE_FENCE_LOCK_ID = "merge-fence";
+var MERGE_DRIVER_DEFINITIONS = [
+  {
+    key: "pm-item-toon",
+    name: "pm field-aware TOON item document merge",
+    artifact: "item",
+    itemPath: "item.toon"
+  },
+  {
+    key: "pm-item-markdown",
+    name: "pm field-aware JSON-markdown item document merge",
+    artifact: "item",
+    itemPath: "item.md"
+  },
+  {
+    key: "pm-history",
+    name: "pm append-only history stream merge",
+    artifact: "history",
+    itemPath: void 0
+  },
+  {
+    key: "pm-relationship",
+    name: "pm append-only relationship event store merge",
+    artifact: "relationship",
+    itemPath: void 0
+  },
+  {
+    key: "pm-json",
+    name: "pm key-level JSON config merge",
+    artifact: "json",
+    itemPath: void 0
+  }
+];
+async function resolveGitWorkspaceRoot(cwd) {
+  try {
+    const { stdout } = await execFileAsync("git", ["rev-parse", "--show-toplevel"], { cwd, encoding: "utf8", windowsHide: true, timeout: 1e4 });
+    return stdout.trim();
+  } catch {
+    throw new PmCliError("pm merge install requires a git repository (merge drivers are git configuration).", EXIT_CODE.USAGE);
+  }
+}
+function toPosixRelative(fromPath, toPath) {
+  return path2.relative(fromPath, toPath).replaceAll("\\", "/");
+}
+function quoteGitAttributePattern(value) {
+  return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+}
+function buildMergeAttributePatterns(trackerRelativeRoot, typeFolders) {
+  const prefix = trackerRelativeRoot.length > 0 ? `${trackerRelativeRoot}/` : "";
+  const patterns = [];
+  for (const folder of typeFolders) {
+    patterns.push(`${quoteGitAttributePattern(`${prefix}${folder}/*.toon`)} merge=pm-item-toon`);
+    patterns.push(`${quoteGitAttributePattern(`${prefix}${folder}/*.md`)} merge=pm-item-markdown`);
+  }
+  patterns.push(`${quoteGitAttributePattern(`${prefix}**/*.jsonl`)} merge=pm-relationship`);
+  patterns.push(`${quoteGitAttributePattern(`${prefix}history/*.jsonl`)} merge=pm-history`);
+  patterns.push(`${quoteGitAttributePattern(`${prefix}settings.json`)} merge=pm-json`);
+  patterns.push(`${quoteGitAttributePattern(`${prefix}schema/*.json`)} merge=pm-json`);
+  return patterns;
+}
+async function reconcileGitattributesBlock(workspaceRoot, patterns, dryRun) {
+  const gitattributesPath = path2.join(workspaceRoot, ".gitattributes");
+  let current = "";
+  try {
+    current = await readFile2(gitattributesPath, "utf8");
+  } catch (error) {
+    if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) {
+      throw error;
+    }
+  }
+  const block = [
+    PM_GITATTRIBUTES_START,
+    ...patterns,
+    PM_GITATTRIBUTES_END
+  ].join("\n");
+  const start = current.indexOf(PM_GITATTRIBUTES_START);
+  const end = current.indexOf(PM_GITATTRIBUTES_END);
+  const withoutManagedBlock = start >= 0 && end > start ? `${current.slice(0, start)}${current.slice(end + PM_GITATTRIBUTES_END.length)}` : current.replace(PM_GITATTRIBUTES_START, "").replace(PM_GITATTRIBUTES_END, "");
+  const prefix = withoutManagedBlock.trimEnd();
+  const next = `${prefix.length > 0 ? `${prefix}
+
+` : ""}${block}
+`;
+  if (next === current) {
+    return { path: gitattributesPath, changed: false };
+  }
+  if (!dryRun) {
+    await writeFile2(gitattributesPath, next, "utf8");
+  }
+  return { path: gitattributesPath, changed: true };
+}
+async function auditMergeAttributeFence(pmRoot, typeFolders) {
+  const resolvedRoot = path2.resolve(pmRoot);
+  let fenceDirectory = null;
+  let fenceContent = "";
+  let directory = resolvedRoot;
+  for (let depth = 0; depth < 8; depth += 1) {
+    const candidate = path2.join(directory, ".gitattributes");
+    try {
+      const raw = await readFile2(candidate, "utf8");
+      if (raw.includes(PM_GITATTRIBUTES_START)) {
+        fenceDirectory = directory;
+        fenceContent = raw;
+        break;
+      }
+    } catch {
+    }
+    const parent = path2.dirname(directory);
+    if (parent === directory) {
+      break;
+    }
+    directory = parent;
+  }
+  if (fenceDirectory === null) {
+    return { status: "not_installed", missing_patterns: [], stale_patterns: [] };
+  }
+  const fencePath = path2.join(fenceDirectory, ".gitattributes");
+  const start = fenceContent.indexOf(PM_GITATTRIBUTES_START);
+  const end = fenceContent.indexOf(PM_GITATTRIBUTES_END);
+  const committed = end > start ? fenceContent.slice(start + PM_GITATTRIBUTES_START.length, end).split("\n").map((line) => line.trim()).filter((line) => line.length > 0) : [];
+  const expected = buildMergeAttributePatterns(toPosixRelative(fenceDirectory, resolvedRoot), typeFolders);
+  const committedSet = new Set(committed);
+  const expectedSet = new Set(expected);
+  const missing = expected.filter((line) => !committedSet.has(line));
+  const stale = committed.filter((line) => !expectedSet.has(line));
+  return {
+    status: missing.length > 0 || stale.length > 0 ? "drift" : "ok",
+    path: fencePath,
+    missing_patterns: missing,
+    stale_patterns: stale
+  };
+}
+async function refreshMergeAttributeFenceIfInstalled(pmRoot) {
+  let workspaceRoot;
+  try {
+    workspaceRoot = await resolveGitWorkspaceRoot(path2.resolve(pmRoot));
+  } catch {
+    return { status: "no_git" };
+  }
+  const trackerRelativeRoot = toPosixRelative(workspaceRoot, path2.resolve(pmRoot));
+  const lockSettings = await readSettings(pmRoot);
+  const owner = (process.env.PM_AUTHOR ?? lockSettings.author_default).trim();
+  const releaseLock = await acquireLock(pmRoot, MERGE_FENCE_LOCK_ID, lockSettings.locks.ttl_seconds, owner.length > 0 ? owner : "unknown", false, resolveGovernanceKnobs(lockSettings).force_required_for_stale_lock, lockSettings.locks.wait_ms);
+  try {
+    const gitattributesPath = path2.join(workspaceRoot, ".gitattributes");
+    let current;
+    try {
+      current = await readFile2(gitattributesPath, "utf8");
+    } catch (error) {
+      if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+        return { status: "not_installed", path: gitattributesPath };
+      }
+      throw error;
+    }
+    if (!current.includes(PM_GITATTRIBUTES_START)) {
+      return { status: "not_installed", path: gitattributesPath };
+    }
+    const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+    const typeFolders = [
+      ...new Set(Object.values(typeRegistry.type_to_folder))
+    ].sort((left, right) => left.localeCompare(right));
+    const outcome = await reconcileGitattributesBlock(workspaceRoot, buildMergeAttributePatterns(trackerRelativeRoot, typeFolders), false);
+    return {
+      status: outcome.changed ? "refreshed" : "unchanged",
+      path: outcome.path
+    };
+  } finally {
+    await releaseLock();
+  }
+}
+async function runMergeInstall(options, global) {
+  const pmRoot = resolvePmRoot(process.cwd(), global.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const dryRun = options.dryRun === true;
+  const workspaceRoot = await resolveGitWorkspaceRoot(process.cwd());
+  const trackerRelativeRoot = toPosixRelative(workspaceRoot, path2.resolve(pmRoot));
+  if (isPathOutsideRoot(trackerRelativeRoot)) {
+    throw new PmCliError(`Tracker root ${pmRoot} is outside the git repository ${workspaceRoot}; there is nothing to configure for this repository.`, EXIT_CODE.USAGE);
+  }
+  const settings = await readSettings(pmRoot);
+  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+  const typeFolders = [
+    ...new Set(Object.values(typeRegistry.type_to_folder))
+  ].sort((left, right) => left.localeCompare(right));
+  const patterns = buildMergeAttributePatterns(trackerRelativeRoot, typeFolders);
+  const gitattributes = await reconcileGitattributesBlock(workspaceRoot, patterns, dryRun);
+  const gitConfigEntries = [];
+  for (const definition of MERGE_DRIVER_DEFINITIONS) {
+    gitConfigEntries.push({
+      key: `merge.${definition.key}.name`,
+      value: definition.name
+    });
+    gitConfigEntries.push({
+      key: `merge.${definition.key}.driver`,
+      value: `pm merge driver ${definition.artifact} "%O" "%A" "%B"${definition.itemPath === void 0 ? "" : ` --item-path ${definition.itemPath}`}`
+    });
+  }
+  if (!dryRun) {
+    for (const entry of gitConfigEntries) {
+      await execFileAsync("git", ["config", entry.key, entry.value], {
+        cwd: workspaceRoot,
+        encoding: "utf8",
+        windowsHide: true,
+        timeout: 1e4
+      });
+    }
+  }
+  return {
+    ok: true,
+    dry_run: dryRun,
+    workspace_root: workspaceRoot,
+    gitattributes: {
+      path: gitattributes.path,
+      changed: gitattributes.changed,
+      patterns
+    },
+    git_config: gitConfigEntries,
+    guidance: [
+      "Commit .gitattributes so every branch and collaborator shares the merge mapping.",
+      'git config is per-clone: each collaborator (and each fresh worktree/clone) runs "pm merge install" once.',
+      'After merging branches, run "pm validate" and, if history drift is reported, "pm history-repair --all" to reconcile item state with merged history.',
+      "Custom item types registered later refresh this fence automatically (pm schema add-type/remove-type); rerun pm merge install only after out-of-band type-folder edits."
+    ],
+    generated_at: nowIso()
+  };
+}
+
+export {
+  PM_GITIGNORE_START,
+  PM_GITIGNORE_END,
+  getPmGitignoreBlock,
+  ensurePmGitignore,
+  PM_GITATTRIBUTES_START,
+  PM_GITATTRIBUTES_END,
+  buildMergeAttributePatterns,
+  auditMergeAttributeFence,
+  refreshMergeAttributeFenceIfInstalled,
+  runMergeInstall
+};
+//# sourceMappingURL=chunk-CFHAODHQ.js.map
+
+//# debugId=85f534fd-62b4-5641-8729-6dcd58b50e94

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../sdk/workspace.ts","../../../../../../../../sdk/merge/install.ts"],"sourcesContent":["/**\n * @module sdk/workspace\n *\n * Maintains repository-scaffold contracts shared by the public SDK and CLI.\n */\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** Opening marker for the init-owned ignore block. */\nexport const PM_GITIGNORE_START = \"# pm-cli:runtime-cache:start\";\n/** Closing marker for the init-owned ignore block. */\nexport const PM_GITIGNORE_END = \"# pm-cli:runtime-cache:end\";\n\n/** Default workspace-relative tracker root used when no custom root is resolved. */\nexport const PM_GITIGNORE_DEFAULT_TRACKER_ROOT = \".agents/pm\";\n\n/**\n * Tracker-relative directories that hold per-clone runtime state (caches,\n * search indexes, locks, crash-recovery receipts). They must never be\n * committed: they churn on every command and conflict on every concurrent\n * branch merge. `transactions/` (SDK workspace-transaction journals) and\n * `checkpoints/` (bulk-mutation rollback receipts) are per-branch recovery\n * state with their own GC (`pm gc --scope transactions|checkpoints`), so\n * keeping them untracked is the recorded merge-safety disposition.\n */\nexport const PM_GITIGNORE_RUNTIME_DIRECTORIES = [\n  \"runtime/\",\n  \"search/\",\n  \"locks/\",\n  \"transactions/\",\n  \"checkpoints/\",\n] as const;\n\n/** Result of reconciling the init-owned repository ignore block. */\nexport interface EnsurePmGitignoreResult {\n  /** Absolute path to the reconciled file. */\n  path: string;\n  /** Whether the file content changed. */\n  changed: boolean;\n}\n\nfunction normalizeTrackerRelativeRoot(trackerRelativeRoot: string): string {\n  return trackerRelativeRoot\n    .replaceAll(\"\\\\\", \"/\")\n    .replace(/^\\.\\/+/, \"\")\n    .replace(/\\/+$/, \"\");\n}\n\n/** Return whether a relative path escapes its owning root, without rejecting valid names such as `..pm`. */\nexport function isPathOutsideRoot(relativePath: string): boolean {\n  const normalized = relativePath.replaceAll(\"\\\\\", \"/\");\n  return (\n    path.isAbsolute(relativePath) ||\n    normalized === \"..\" ||\n    normalized.startsWith(\"../\")\n  );\n}\n\n/** Return the canonical pm ignore block rendered for the given workspace-relative tracker root (defaults to `.agents/pm`), primarily for documentation and tests. */\nexport function getPmGitignoreBlock(\n  trackerRelativeRoot: string = PM_GITIGNORE_DEFAULT_TRACKER_ROOT,\n): string {\n  const root = normalizeTrackerRelativeRoot(trackerRelativeRoot);\n  return [\n    PM_GITIGNORE_START,\n    ...PM_GITIGNORE_RUNTIME_DIRECTORIES.map(\n      (directory) => `${root}/${directory}`,\n    ),\n    PM_GITIGNORE_END,\n  ].join(\"\\n\");\n}\n\n/**\n * Idempotently create or replace the fenced pm cache block in a workspace\n * `.gitignore`. When `pmRoot` is provided the ignored runtime directories are\n * rendered under the resolved workspace-relative tracker root, so custom-root\n * workspaces (`--pm-path`/`PM_PATH`) stop committing runtime caches (GH-598).\n * A tracker root outside the workspace needs no ignore rules here, so the\n * file is left untouched.\n */\nexport async function ensurePmGitignore(\n  workspaceRoot: string,\n  options: {\n    /** Absolute tracker root; rendered relative to the workspace root. */\n    pmRoot?: string;\n  } = {},\n): Promise<EnsurePmGitignoreResult> {\n  const gitignorePath = path.join(workspaceRoot, \".gitignore\");\n  let trackerRelativeRoot = PM_GITIGNORE_DEFAULT_TRACKER_ROOT;\n  if (options.pmRoot !== undefined) {\n    const relative = normalizeTrackerRelativeRoot(\n      path.relative(path.resolve(workspaceRoot), path.resolve(options.pmRoot)),\n    );\n    if (isPathOutsideRoot(relative)) {\n      return { path: gitignorePath, changed: false };\n    }\n    if (relative.length > 0) {\n      trackerRelativeRoot = relative;\n    }\n  }\n  let current = \"\";\n  try {\n    current = await readFile(gitignorePath, \"utf8\");\n  } catch (error: unknown) {\n    if (\n      !(error instanceof Error && \"code\" in error && error.code === \"ENOENT\")\n    ) {\n      throw error;\n    }\n  }\n  const start = current.indexOf(PM_GITIGNORE_START);\n  const end = current.indexOf(PM_GITIGNORE_END);\n  const withoutManagedBlock =\n    start >= 0 && end >= start\n      ? `${current.slice(0, start)}${current.slice(end + PM_GITIGNORE_END.length)}`\n      : current;\n  const prefix = withoutManagedBlock.trimEnd();\n  const next = `${prefix.length > 0 ? `${prefix}\\n\\n` : \"\"}${getPmGitignoreBlock(trackerRelativeRoot)}\\n`;\n  if (next === current) {\n    return { path: gitignorePath, changed: false };\n  }\n  await writeFile(gitignorePath, next, \"utf8\");\n  return { path: gitignorePath, changed: true };\n}\n","/**\n * @module sdk/merge/install\n *\n * Installs the tracker's git merge configuration into a repository: a fenced\n * `.gitattributes` block mapping every mergeable tracker artifact class to a\n * pm merge driver, plus the local `git config` driver definitions that make\n * those attributes effective. Idempotent and re-runnable; schema type\n * mutations refresh the fenced block automatically once it is installed.\n */\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport { execFile } from \"node:child_process\";\nimport path from \"node:path\";\nimport { promisify } from \"node:util\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { acquireLock } from \"../../core/lock/lock.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  readSettings,\n  resolveGovernanceKnobs,\n} from \"../../core/store/settings.js\";\nimport { isPathOutsideRoot } from \"../workspace.js\";\n\nconst execFileAsync = promisify(execFile);\n\n/** Opening marker for the pm-owned merge-driver `.gitattributes` block. */\nexport const PM_GITATTRIBUTES_START = \"# pm-cli:merge-drivers:start\";\n/** Closing marker for the pm-owned merge-driver `.gitattributes` block. */\nexport const PM_GITATTRIBUTES_END = \"# pm-cli:merge-drivers:end\";\n\nconst MERGE_FENCE_LOCK_ID = \"merge-fence\";\n\nconst MERGE_DRIVER_DEFINITIONS = [\n  {\n    key: \"pm-item-toon\",\n    name: \"pm field-aware TOON item document merge\",\n    artifact: \"item\",\n    itemPath: \"item.toon\",\n  },\n  {\n    key: \"pm-item-markdown\",\n    name: \"pm field-aware JSON-markdown item document merge\",\n    artifact: \"item\",\n    itemPath: \"item.md\",\n  },\n  {\n    key: \"pm-history\",\n    name: \"pm append-only history stream merge\",\n    artifact: \"history\",\n    itemPath: undefined,\n  },\n  {\n    key: \"pm-relationship\",\n    name: \"pm append-only relationship event store merge\",\n    artifact: \"relationship\",\n    itemPath: undefined,\n  },\n  {\n    key: \"pm-json\",\n    name: \"pm key-level JSON config merge\",\n    artifact: \"json\",\n    itemPath: undefined,\n  },\n] as const;\n\n/** Documents the merge install options payload exchanged by command, SDK, and package integrations. */\nexport interface MergeInstallOptions {\n  /** Preview the `.gitattributes` and `git config` changes without writing anything. */\n  dryRun?: boolean;\n}\n\n/** Documents the merge install result payload exchanged by command, SDK, and package integrations. */\nexport interface MergeInstallResult {\n  /** Whether the installation completed (or, for dry runs, would complete) without errors. */\n  ok: boolean;\n  /** Whether this run was a preview only. */\n  dry_run: boolean;\n  /** Repository root the merge configuration was installed into. */\n  workspace_root: string;\n  /** `.gitattributes` reconciliation outcome. */\n  gitattributes: {\n    path: string;\n    changed: boolean;\n    patterns: string[];\n  };\n  /** Local `git config` merge-driver definitions applied (or previewed). */\n  git_config: Array<{ key: string; value: string }>;\n  /** Guidance for completing the multi-branch workflow setup. */\n  guidance: string[];\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\nasync function resolveGitWorkspaceRoot(cwd: string): Promise<string> {\n  try {\n    const { stdout } = await execFileAsync(\n      \"git\",\n      [\"rev-parse\", \"--show-toplevel\"],\n      { cwd, encoding: \"utf8\", windowsHide: true, timeout: 10_000 },\n    );\n    return stdout.trim();\n  } catch {\n    throw new PmCliError(\n      \"pm merge install requires a git repository (merge drivers are git configuration).\",\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\nfunction toPosixRelative(fromPath: string, toPath: string): string {\n  return path.relative(fromPath, toPath).replaceAll(\"\\\\\", \"/\");\n}\n\n/** Encode one Git attributes pattern with C-style quoting so whitespace, backslashes, and quotation marks remain part of the repository path instead of being parsed as attribute separators. */\nfunction quoteGitAttributePattern(value: string): string {\n  return `\"${value.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll('\"', '\\\\\"')}\"`;\n}\n\n/**\n * Build the complete fenced `.gitattributes` pattern list for a tracker rooted\n * at `trackerRelativeRoot` (git-root-relative POSIX path, empty when the\n * tracker root IS the git root). This is the single coverage contract shared\n * by `pm merge install` (which writes the fence) and the validate\n * merge-fence-drift detection (which compares the committed fence against the\n * active schema's type folders), so schema-added custom types can never\n * silently diverge from the installed fence without a warning.\n */\nexport function buildMergeAttributePatterns(\n  trackerRelativeRoot: string,\n  typeFolders: string[],\n): string[] {\n  const prefix =\n    trackerRelativeRoot.length > 0 ? `${trackerRelativeRoot}/` : \"\";\n  const patterns: string[] = [];\n  for (const folder of typeFolders) {\n    patterns.push(\n      `${quoteGitAttributePattern(`${prefix}${folder}/*.toon`)} merge=pm-item-toon`,\n    );\n    patterns.push(\n      `${quoteGitAttributePattern(`${prefix}${folder}/*.md`)} merge=pm-item-markdown`,\n    );\n  }\n  // RelationshipEventStore deliberately accepts a caller-chosen relativePath\n  // anywhere below the tracker root. Cover all tracker JSONL first, then let\n  // the more-specific history rule below override it. This keeps custom event\n  // stores protected without guessing package-owned paths.\n  patterns.push(\n    `${quoteGitAttributePattern(`${prefix}**/*.jsonl`)} merge=pm-relationship`,\n  );\n  patterns.push(\n    `${quoteGitAttributePattern(`${prefix}history/*.jsonl`)} merge=pm-history`,\n  );\n  patterns.push(\n    `${quoteGitAttributePattern(`${prefix}settings.json`)} merge=pm-json`,\n  );\n  patterns.push(\n    `${quoteGitAttributePattern(`${prefix}schema/*.json`)} merge=pm-json`,\n  );\n  return patterns;\n}\n\nasync function reconcileGitattributesBlock(\n  workspaceRoot: string,\n  patterns: string[],\n  dryRun: boolean,\n): Promise<{ path: string; changed: boolean }> {\n  const gitattributesPath = path.join(workspaceRoot, \".gitattributes\");\n  let current = \"\";\n  try {\n    current = await readFile(gitattributesPath, \"utf8\");\n  } catch (error: unknown) {\n    if (\n      !(error instanceof Error && \"code\" in error && error.code === \"ENOENT\")\n    ) {\n      throw error;\n    }\n  }\n  const block = [\n    PM_GITATTRIBUTES_START,\n    ...patterns,\n    PM_GITATTRIBUTES_END,\n  ].join(\"\\n\");\n  const start = current.indexOf(PM_GITATTRIBUTES_START);\n  const end = current.indexOf(PM_GITATTRIBUTES_END);\n  const withoutManagedBlock =\n    start >= 0 && end > start\n      ? `${current.slice(0, start)}${current.slice(end + PM_GITATTRIBUTES_END.length)}`\n      : current\n          .replace(PM_GITATTRIBUTES_START, \"\")\n          .replace(PM_GITATTRIBUTES_END, \"\");\n  const prefix = withoutManagedBlock.trimEnd();\n  const next = `${prefix.length > 0 ? `${prefix}\\n\\n` : \"\"}${block}\\n`;\n  if (next === current) {\n    return { path: gitattributesPath, changed: false };\n  }\n  if (!dryRun) {\n    await writeFile(gitattributesPath, next, \"utf8\");\n  }\n  return { path: gitattributesPath, changed: true };\n}\n\n/** Result of comparing the committed merge-fence block against the coverage the active schema requires. */\nexport interface MergeFenceAuditResult {\n  /** Audit outcome: no fence installed (nothing to audit), fence matches, or fence drifted from the active schema/type folders. */\n  status: \"not_installed\" | \"ok\" | \"drift\";\n  /** `.gitattributes` file containing the fence, when one was found. */\n  path?: string;\n  /** Expected attribute lines absent from the committed fence (for example a schema-added type folder). */\n  missing_patterns: string[];\n  /** Committed fence lines no longer produced by the coverage contract (for example a removed type folder). */\n  stale_patterns: string[];\n}\n\n/**\n * Audit the committed `.gitattributes` merge fence against the coverage the\n * active schema requires, without touching git configuration. The fence file\n * is discovered by walking up from the tracker root (bounded), so the audit\n * stays filesystem-only and safe to run inside `pm validate`. A `drift`\n * result means items of some type folder (or a tracker JSONL store) would\n * merge under git's default text driver despite the fence being installed.\n */\nexport async function auditMergeAttributeFence(\n  pmRoot: string,\n  typeFolders: string[],\n): Promise<MergeFenceAuditResult> {\n  const resolvedRoot = path.resolve(pmRoot);\n  let fenceDirectory: string | null = null;\n  let fenceContent = \"\";\n  let directory = resolvedRoot;\n  for (let depth = 0; depth < 8; depth += 1) {\n    const candidate = path.join(directory, \".gitattributes\");\n    try {\n      const raw = await readFile(candidate, \"utf8\");\n      if (raw.includes(PM_GITATTRIBUTES_START)) {\n        fenceDirectory = directory;\n        fenceContent = raw;\n        break;\n      }\n    } catch {\n      // No .gitattributes at this level; keep walking up.\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) {\n      break;\n    }\n    directory = parent;\n  }\n  if (fenceDirectory === null) {\n    return { status: \"not_installed\", missing_patterns: [], stale_patterns: [] };\n  }\n  const fencePath = path.join(fenceDirectory, \".gitattributes\");\n  const start = fenceContent.indexOf(PM_GITATTRIBUTES_START);\n  const end = fenceContent.indexOf(PM_GITATTRIBUTES_END);\n  const committed =\n    end > start\n      ? fenceContent\n          .slice(start + PM_GITATTRIBUTES_START.length, end)\n          .split(\"\\n\")\n          .map((line) => line.trim())\n          .filter((line) => line.length > 0)\n      : [];\n  const expected = buildMergeAttributePatterns(\n    toPosixRelative(fenceDirectory, resolvedRoot),\n    typeFolders,\n  );\n  const committedSet = new Set(committed);\n  const expectedSet = new Set(expected);\n  const missing = expected.filter((line) => !committedSet.has(line));\n  const stale = committed.filter((line) => !expectedSet.has(line));\n  return {\n    status: missing.length > 0 || stale.length > 0 ? \"drift\" : \"ok\",\n    path: fencePath,\n    missing_patterns: missing,\n    stale_patterns: stale,\n  };\n}\n\n/** Outcome of an automatic merge-fence refresh attempted after a schema type mutation. */\nexport interface MergeFenceRefreshOutcome {\n  /** What happened: the fence was rewritten, already matched, was never installed (actionable hint), or there is no git repository to configure. */\n  status: \"refreshed\" | \"unchanged\" | \"not_installed\" | \"no_git\";\n  /** `.gitattributes` path examined, when a git repository was found. */\n  path?: string;\n}\n\n/**\n * Refresh the fenced `.gitattributes` merge-driver block after a schema type\n * mutation, but only when `pm merge install` already ran (the fence markers\n * are present). Without this, custom item types registered after install\n * would write items into folders with no merge attribute — silently\n * reintroducing the whole-file conflict class for exactly those items. Repos\n * that never installed the fence get a `not_installed` outcome so callers can\n * surface an actionable hint instead of mutating git configuration nobody\n * asked for.\n */\nexport async function refreshMergeAttributeFenceIfInstalled(\n  pmRoot: string,\n): Promise<MergeFenceRefreshOutcome> {\n  let workspaceRoot: string;\n  try {\n    workspaceRoot = await resolveGitWorkspaceRoot(path.resolve(pmRoot));\n  } catch {\n    return { status: \"no_git\" };\n  }\n  const trackerRelativeRoot = toPosixRelative(\n    workspaceRoot,\n    path.resolve(pmRoot),\n  );\n  const lockSettings = await readSettings(pmRoot);\n  const owner = (process.env.PM_AUTHOR ?? lockSettings.author_default).trim();\n  const releaseLock = await acquireLock(\n    pmRoot,\n    MERGE_FENCE_LOCK_ID,\n    lockSettings.locks.ttl_seconds,\n    owner.length > 0 ? owner : \"unknown\",\n    false,\n    resolveGovernanceKnobs(lockSettings).force_required_for_stale_lock,\n    lockSettings.locks.wait_ms,\n  );\n  try {\n    const gitattributesPath = path.join(workspaceRoot, \".gitattributes\");\n    let current: string;\n    try {\n      current = await readFile(gitattributesPath, \"utf8\");\n    } catch (error: unknown) {\n      if (\n        error instanceof Error &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      ) {\n        return { status: \"not_installed\", path: gitattributesPath };\n      }\n      throw error;\n    }\n    if (!current.includes(PM_GITATTRIBUTES_START)) {\n      return { status: \"not_installed\", path: gitattributesPath };\n    }\n    // Re-read after acquiring the dedicated fence lock so every concurrent\n    // refresher computes from the latest committed type registry.\n    const settings = await readSettings(pmRoot);\n    const typeRegistry = resolveItemTypeRegistry(\n      settings,\n      getActiveExtensionRegistrations(),\n    );\n    const typeFolders = [\n      ...new Set(Object.values(typeRegistry.type_to_folder)),\n    ].sort((left, right) => left.localeCompare(right));\n    const outcome = await reconcileGitattributesBlock(\n      workspaceRoot,\n      buildMergeAttributePatterns(trackerRelativeRoot, typeFolders),\n      false,\n    );\n    return {\n      status: outcome.changed ? \"refreshed\" : \"unchanged\",\n      path: outcome.path,\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\n/**\n * Install (or preview) the repository merge configuration for tracker data:\n * writes the fenced merge-driver block into `.gitattributes` (committed and\n * shared with every branch) and defines the `merge.pm-*.driver` entries in the\n * repository-local git config (per-clone, so every collaborator runs this once\n * per checkout). Requires an initialized tracker and a git repository.\n */\nexport async function runMergeInstall(\n  options: MergeInstallOptions,\n  global: GlobalOptions,\n): Promise<MergeInstallResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const dryRun = options.dryRun === true;\n  const workspaceRoot = await resolveGitWorkspaceRoot(process.cwd());\n  const trackerRelativeRoot = toPosixRelative(\n    workspaceRoot,\n    path.resolve(pmRoot),\n  );\n  if (isPathOutsideRoot(trackerRelativeRoot)) {\n    throw new PmCliError(\n      `Tracker root ${pmRoot} is outside the git repository ${workspaceRoot}; there is nothing to configure for this repository.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const typeFolders = [\n    ...new Set(Object.values(typeRegistry.type_to_folder)),\n  ].sort((left, right) => left.localeCompare(right));\n  const patterns = buildMergeAttributePatterns(\n    trackerRelativeRoot,\n    typeFolders,\n  );\n  const gitattributes = await reconcileGitattributesBlock(\n    workspaceRoot,\n    patterns,\n    dryRun,\n  );\n\n  const gitConfigEntries: Array<{ key: string; value: string }> = [];\n  for (const definition of MERGE_DRIVER_DEFINITIONS) {\n    gitConfigEntries.push({\n      key: `merge.${definition.key}.name`,\n      value: definition.name,\n    });\n    gitConfigEntries.push({\n      key: `merge.${definition.key}.driver`,\n      value: `pm merge driver ${definition.artifact} \"%O\" \"%A\" \"%B\"${definition.itemPath === undefined ? \"\" : ` --item-path ${definition.itemPath}`}`,\n    });\n  }\n  if (!dryRun) {\n    for (const entry of gitConfigEntries) {\n      await execFileAsync(\"git\", [\"config\", entry.key, entry.value], {\n        cwd: workspaceRoot,\n        encoding: \"utf8\",\n        windowsHide: true,\n        timeout: 10_000,\n      });\n    }\n  }\n\n  return {\n    ok: true,\n    dry_run: dryRun,\n    workspace_root: workspaceRoot,\n    gitattributes: {\n      path: gitattributes.path,\n      changed: gitattributes.changed,\n      patterns,\n    },\n    git_config: gitConfigEntries,\n    guidance: [\n      \"Commit .gitattributes so every branch and collaborator shares the merge mapping.\",\n      'git config is per-clone: each collaborator (and each fresh worktree/clone) runs \"pm merge install\" once.',\n      'After merging branches, run \"pm validate\" and, if history drift is reported, \"pm history-repair --all\" to reconcile item state with merged history.',\n      \"Custom item types registered later refresh this fence automatically (pm schema add-type/remove-type); rerun pm merge install only after out-of-band type-folder edits.\",\n    ],\n    generated_at: nowIso(),\n  };\n}\n"],"names":["readFile","writeFile","path","path","readFile","writeFile"],"mappings":";;;;;;;;;;;;;;;;;;;AAKA,SAAS,UAAU,iBAAiB;AACpC,OAAO,UAAU;AAGV,IAAM,qBAAqB;AAE3B,IAAM,mBAAmB;AAGzB,IAAM,oCAAoC;AAW1C,IAAM,mCAAmC;EAC9C;EACA;EACA;EACA;EACA;;AAWF,SAAS,6BAA6B,qBAA2B;AAC/D,SAAO,oBACJ,WAAW,MAAM,GAAG,EACpB,QAAQ,UAAU,EAAE,EACpB,QAAQ,QAAQ,EAAE;AACvB;AAGM,SAAU,kBAAkB,cAAoB;AACpD,QAAM,aAAa,aAAa,WAAW,MAAM,GAAG;AACpD,SACE,KAAK,WAAW,YAAY,KAC5B,eAAe,QACf,WAAW,WAAW,KAAK;AAE/B;AAGM,SAAU,oBACd,sBAA8B,mCAAiC;AAE/D,QAAM,OAAO,6BAA6B,mBAAmB;AAC7D,SAAO;IACL;IACA,GAAG,iCAAiC,IAClC,CAAC,cAAc,GAAG,IAAI,IAAI,SAAS,EAAE;IAEvC;IACA,KAAK,IAAI;AACb;AAUA,eAAsB,kBACpB,eACA,UAGI,CAAA,GAAE;AAEN,QAAM,gBAAgB,KAAK,KAAK,eAAe,YAAY;AAC3D,MAAI,sBAAsB;AAC1B,MAAI,QAAQ,WAAW,QAAW;AAChC,UAAM,WAAW,6BACf,KAAK,SAAS,KAAK,QAAQ,aAAa,GAAG,KAAK,QAAQ,QAAQ,MAAM,CAAC,CAAC;AAE1E,QAAI,kBAAkB,QAAQ,GAAG;AAC/B,aAAO,EAAE,MAAM,eAAe,SAAS,MAAK;IAC9C;AACA,QAAI,SAAS,SAAS,GAAG;AACvB,4BAAsB;IACxB;EACF;AACA,MAAI,UAAU;AACd,MAAI;AACF,cAAU,MAAM,SAAS,eAAe,MAAM;EAChD,SAAS,OAAgB;AACvB,QACE,EAAE,iBAAiB,SAAS,UAAU,SAAS,MAAM,SAAS,WAC9D;AACA,YAAM;IACR;EACF;AACA,QAAM,QAAQ,QAAQ,QAAQ,kBAAkB;AAChD,QAAM,MAAM,QAAQ,QAAQ,gBAAgB;AAC5C,QAAM,sBACJ,SAAS,KAAK,OAAO,QACjB,GAAG,QAAQ,MAAM,GAAG,KAAK,CAAC,GAAG,QAAQ,MAAM,MAAM,iBAAiB,MAAM,CAAC,KACzE;AACN,QAAM,SAAS,oBAAoB,QAAO;AAC1C,QAAM,OAAO,GAAG,OAAO,SAAS,IAAI,GAAG,MAAM;;IAAS,EAAE,GAAG,oBAAoB,mBAAmB,CAAC;;AACnG,MAAI,SAAS,SAAS;AACpB,WAAO,EAAE,MAAM,eAAe,SAAS,MAAK;EAC9C;AACA,QAAM,UAAU,eAAe,MAAM,MAAM;AAC3C,SAAO,EAAE,MAAM,eAAe,SAAS,KAAI;AAC7C;;;AClHA,SAAS,YAAAA,WAAU,aAAAC,kBAAiB;AACpC,SAAS,gBAAgB;AACzB,OAAOC,WAAU;AACjB,SAAS,iBAAiB;AAgB1B,IAAM,gBAAgB,UAAU,QAAQ;AAGjC,IAAM,yBAAyB;AAE/B,IAAM,uBAAuB;AAEpC,IAAM,sBAAsB;AAE5B,IAAM,2BAA2B;EAC/B;IACE,KAAK;IACL,MAAM;IACN,UAAU;IACV,UAAU;;EAEZ;IACE,KAAK;IACL,MAAM;IACN,UAAU;IACV,UAAU;;EAEZ;IACE,KAAK;IACL,MAAM;IACN,UAAU;IACV,UAAU;;EAEZ;IACE,KAAK;IACL,MAAM;IACN,UAAU;IACV,UAAU;;EAEZ;IACE,KAAK;IACL,MAAM;IACN,UAAU;IACV,UAAU;;;AAgCd,eAAe,wBAAwB,KAAW;AAChD,MAAI;AACF,UAAM,EAAE,OAAM,IAAK,MAAM,cACvB,OACA,CAAC,aAAa,iBAAiB,GAC/B,EAAE,KAAK,UAAU,QAAQ,aAAa,MAAM,SAAS,IAAM,CAAE;AAE/D,WAAO,OAAO,KAAI;EACpB,QAAQ;AACN,UAAM,IAAI,WACR,qFACA,UAAU,KAAK;EAEnB;AACF;AAEA,SAAS,gBAAgB,UAAkB,QAAc;AACvD,SAAOC,MAAK,SAAS,UAAU,MAAM,EAAE,WAAW,MAAM,GAAG;AAC7D;AAGA,SAAS,yBAAyB,OAAa;AAC7C,SAAO,IAAI,MAAM,WAAW,MAAM,MAAM,EAAE,WAAW,KAAK,KAAK,CAAC;AAClE;AAWM,SAAU,4BACd,qBACA,aAAqB;AAErB,QAAM,SACJ,oBAAoB,SAAS,IAAI,GAAG,mBAAmB,MAAM;AAC/D,QAAM,WAAqB,CAAA;AAC3B,aAAW,UAAU,aAAa;AAChC,aAAS,KACP,GAAG,yBAAyB,GAAG,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB;AAE/E,aAAS,KACP,GAAG,yBAAyB,GAAG,MAAM,GAAG,MAAM,OAAO,CAAC,yBAAyB;EAEnF;AAKA,WAAS,KACP,GAAG,yBAAyB,GAAG,MAAM,YAAY,CAAC,wBAAwB;AAE5E,WAAS,KACP,GAAG,yBAAyB,GAAG,MAAM,iBAAiB,CAAC,mBAAmB;AAE5E,WAAS,KACP,GAAG,yBAAyB,GAAG,MAAM,eAAe,CAAC,gBAAgB;AAEvE,WAAS,KACP,GAAG,yBAAyB,GAAG,MAAM,eAAe,CAAC,gBAAgB;AAEvE,SAAO;AACT;AAEA,eAAe,4BACb,eACA,UACA,QAAe;AAEf,QAAM,oBAAoBA,MAAK,KAAK,eAAe,gBAAgB;AACnE,MAAI,UAAU;AACd,MAAI;AACF,cAAU,MAAMC,UAAS,mBAAmB,MAAM;EACpD,SAAS,OAAgB;AACvB,QACE,EAAE,iBAAiB,SAAS,UAAU,SAAS,MAAM,SAAS,WAC9D;AACA,YAAM;IACR;EACF;AACA,QAAM,QAAQ;IACZ;IACA,GAAG;IACH;IACA,KAAK,IAAI;AACX,QAAM,QAAQ,QAAQ,QAAQ,sBAAsB;AACpD,QAAM,MAAM,QAAQ,QAAQ,oBAAoB;AAChD,QAAM,sBACJ,SAAS,KAAK,MAAM,QAChB,GAAG,QAAQ,MAAM,GAAG,KAAK,CAAC,GAAG,QAAQ,MAAM,MAAM,qBAAqB,MAAM,CAAC,KAC7E,QACG,QAAQ,wBAAwB,EAAE,EAClC,QAAQ,sBAAsB,EAAE;AACzC,QAAM,SAAS,oBAAoB,QAAO;AAC1C,QAAM,OAAO,GAAG,OAAO,SAAS,IAAI,GAAG,MAAM;;IAAS,EAAE,GAAG,KAAK;;AAChE,MAAI,SAAS,SAAS;AACpB,WAAO,EAAE,MAAM,mBAAmB,SAAS,MAAK;EAClD;AACA,MAAI,CAAC,QAAQ;AACX,UAAMC,WAAU,mBAAmB,MAAM,MAAM;EACjD;AACA,SAAO,EAAE,MAAM,mBAAmB,SAAS,KAAI;AACjD;AAsBA,eAAsB,yBACpB,QACA,aAAqB;AAErB,QAAM,eAAeF,MAAK,QAAQ,MAAM;AACxC,MAAI,iBAAgC;AACpC,MAAI,eAAe;AACnB,MAAI,YAAY;AAChB,WAAS,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG;AACzC,UAAM,YAAYA,MAAK,KAAK,WAAW,gBAAgB;AACvD,QAAI;AACF,YAAM,MAAM,MAAMC,UAAS,WAAW,MAAM;AAC5C,UAAI,IAAI,SAAS,sBAAsB,GAAG;AACxC,yBAAiB;AACjB,uBAAe;AACf;MACF;IACF,QAAQ;IAER;AACA,UAAM,SAASD,MAAK,QAAQ,SAAS;AACrC,QAAI,WAAW,WAAW;AACxB;IACF;AACA,gBAAY;EACd;AACA,MAAI,mBAAmB,MAAM;AAC3B,WAAO,EAAE,QAAQ,iBAAiB,kBAAkB,CAAA,GAAI,gBAAgB,CAAA,EAAE;EAC5E;AACA,QAAM,YAAYA,MAAK,KAAK,gBAAgB,gBAAgB;AAC5D,QAAM,QAAQ,aAAa,QAAQ,sBAAsB;AACzD,QAAM,MAAM,aAAa,QAAQ,oBAAoB;AACrD,QAAM,YACJ,MAAM,QACF,aACG,MAAM,QAAQ,uBAAuB,QAAQ,GAAG,EAChD,MAAM,IAAI,EACV,IAAI,CAAC,SAAS,KAAK,KAAI,CAAE,EACzB,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,IACnC,CAAA;AACN,QAAM,WAAW,4BACf,gBAAgB,gBAAgB,YAAY,GAC5C,WAAW;AAEb,QAAM,eAAe,IAAI,IAAI,SAAS;AACtC,QAAM,cAAc,IAAI,IAAI,QAAQ;AACpC,QAAM,UAAU,SAAS,OAAO,CAAC,SAAS,CAAC,aAAa,IAAI,IAAI,CAAC;AACjE,QAAM,QAAQ,UAAU,OAAO,CAAC,SAAS,CAAC,YAAY,IAAI,IAAI,CAAC;AAC/D,SAAO;IACL,QAAQ,QAAQ,SAAS,KAAK,MAAM,SAAS,IAAI,UAAU;IAC3D,MAAM;IACN,kBAAkB;IAClB,gBAAgB;;AAEpB;AAoBA,eAAsB,sCACpB,QAAc;AAEd,MAAI;AACJ,MAAI;AACF,oBAAgB,MAAM,wBAAwBA,MAAK,QAAQ,MAAM,CAAC;EACpE,QAAQ;AACN,WAAO,EAAE,QAAQ,SAAQ;EAC3B;AACA,QAAM,sBAAsB,gBAC1B,eACAA,MAAK,QAAQ,MAAM,CAAC;AAEtB,QAAM,eAAe,MAAM,aAAa,MAAM;AAC9C,QAAM,SAAS,QAAQ,IAAI,aAAa,aAAa,gBAAgB,KAAI;AACzE,QAAM,cAAc,MAAM,YACxB,QACA,qBACA,aAAa,MAAM,aACnB,MAAM,SAAS,IAAI,QAAQ,WAC3B,OACA,uBAAuB,YAAY,EAAE,+BACrC,aAAa,MAAM,OAAO;AAE5B,MAAI;AACF,UAAM,oBAAoBA,MAAK,KAAK,eAAe,gBAAgB;AACnE,QAAI;AACJ,QAAI;AACF,gBAAU,MAAMC,UAAS,mBAAmB,MAAM;IACpD,SAAS,OAAgB;AACvB,UACE,iBAAiB,SACjB,UAAU,SACV,MAAM,SAAS,UACf;AACA,eAAO,EAAE,QAAQ,iBAAiB,MAAM,kBAAiB;MAC3D;AACA,YAAM;IACR;AACA,QAAI,CAAC,QAAQ,SAAS,sBAAsB,GAAG;AAC7C,aAAO,EAAE,QAAQ,iBAAiB,MAAM,kBAAiB;IAC3D;AAGA,UAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,UAAM,eAAe,wBACnB,UACA,gCAA+B,CAAE;AAEnC,UAAM,cAAc;MAClB,GAAG,IAAI,IAAI,OAAO,OAAO,aAAa,cAAc,CAAC;MACrD,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;AACjD,UAAM,UAAU,MAAM,4BACpB,eACA,4BAA4B,qBAAqB,WAAW,GAC5D,KAAK;AAEP,WAAO;MACL,QAAQ,QAAQ,UAAU,cAAc;MACxC,MAAM,QAAQ;;EAElB;AACE,UAAM,YAAW;EACnB;AACF;AASA,eAAsB,gBACpB,SACA,QAAqB;AAErB,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,OAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WACR,iCAAiC,MAAM,wBACvC,UAAU,SAAS;EAEvB;AACA,QAAM,SAAS,QAAQ,WAAW;AAClC,QAAM,gBAAgB,MAAM,wBAAwB,QAAQ,IAAG,CAAE;AACjE,QAAM,sBAAsB,gBAC1B,eACAD,MAAK,QAAQ,MAAM,CAAC;AAEtB,MAAI,kBAAkB,mBAAmB,GAAG;AAC1C,UAAM,IAAI,WACR,gBAAgB,MAAM,kCAAkC,aAAa,wDACrE,UAAU,KAAK;EAEnB;AAEA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBACnB,UACA,gCAA+B,CAAE;AAEnC,QAAM,cAAc;IAClB,GAAG,IAAI,IAAI,OAAO,OAAO,aAAa,cAAc,CAAC;IACrD,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;AACjD,QAAM,WAAW,4BACf,qBACA,WAAW;AAEb,QAAM,gBAAgB,MAAM,4BAC1B,eACA,UACA,MAAM;AAGR,QAAM,mBAA0D,CAAA;AAChE,aAAW,cAAc,0BAA0B;AACjD,qBAAiB,KAAK;MACpB,KAAK,SAAS,WAAW,GAAG;MAC5B,OAAO,WAAW;KACnB;AACD,qBAAiB,KAAK;MACpB,KAAK,SAAS,WAAW,GAAG;MAC5B,OAAO,mBAAmB,WAAW,QAAQ,kBAAkB,WAAW,aAAa,SAAY,KAAK,gBAAgB,WAAW,QAAQ,EAAE;KAC9I;EACH;AACA,MAAI,CAAC,QAAQ;AACX,eAAW,SAAS,kBAAkB;AACpC,YAAM,cAAc,OAAO,CAAC,UAAU,MAAM,KAAK,MAAM,KAAK,GAAG;QAC7D,KAAK;QACL,UAAU;QACV,aAAa;QACb,SAAS;OACV;IACH;EACF;AAEA,SAAO;IACL,IAAI;IACJ,SAAS;IACT,gBAAgB;IAChB,eAAe;MACb,MAAM,cAAc;MACpB,SAAS,cAAc;MACvB;;IAEF,YAAY;IACZ,UAAU;MACR;MACA;MACA;MACA;;IAEF,cAAc,OAAM;;AAExB","debugId":"85f534fd-62b4-5641-8729-6dcd58b50e94"}

package/dist/cli-bundle/chunks/{chunk-TELI67UP.js → chunk-CQTQKUUV.js}

@@ -1,17 +1,17 @@
 
-!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]="cbfdae67-6c63-5c92-8320-1617c5fcb471")}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]="81f07347-d5fa-5f79-8f92-bd1939a0b091")}catch(e){}}();
 import {
   isErrnoError,
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-Y2VSGFT4.js";
+} from "./chunk-HB3P4M52.js";
 import {
   createStdinTokenResolver
-} from "./chunk-SVAWG7EE.js";
+} from "./chunk-J4FBIFU6.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/cli/commands/comments.js
 import { readFile } from "node:fs/promises";
@@ -92,9 +92,6 @@ async function resolveCommentInput(options, stdinResolver) {
 async function runComments(id, options, global) {
   const stdinResolver = createStdinTokenResolver();
   const commentInput = await resolveCommentInput(options, stdinResolver);
-  if (commentInput.mode === "list" && options.message !== void 0) {
-    throw new PmCliError("--message labels a comment mutation but does not provide comment text. Pass text positionally or with --add, --stdin, or --file.", EXIT_CODE.USAGE);
-  }
   const shouldParseText = commentInput.mode === "add" || commentInput.mode === "edit";
   const rawValue = commentInput.value ?? "";
   return runAnnotationCommand(id, options, global, {
@@ -123,6 +120,6 @@ async function runComments(id, options, global) {
 export {
   runComments
 };
-//# sourceMappingURL=chunk-TELI67UP.js.map
+//# sourceMappingURL=chunk-CQTQKUUV.js.map
 
-//# debugId=cbfdae67-6c63-5c92-8320-1617c5fcb471
+//# debugId=81f07347-d5fa-5f79-8f92-bd1939a0b091

package/dist/cli-bundle/chunks/{chunk-TELI67UP.js.map → chunk-CQTQKUUV.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/comments.ts"],"sourcesContent":["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\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 { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport {\n  isErrnoError,\n  parseAnnotationTextInput,\n  runAnnotationCommand,\n} from \"../../sdk/annotations.js\";\n\n/** Documents the comments command options payload exchanged by command, SDK, and package integrations. */\nexport interface CommentsCommandOptions {\n  /** Value that configures or reports add for this contract. */\n  add?: string;\n  /** Value that configures or reports stdin for this contract. */\n  stdin?: boolean;\n  /** Value that configures or reports file for this contract. */\n  file?: string;\n  /** Value that configures or reports edit for this contract. */\n  edit?: number;\n  /** Value that configures or reports delete for this contract. */\n  delete?: number;\n  /** Value that configures or reports limit for this contract. */\n  limit?: string;\n  /** Value that configures or reports include meta for this contract. */\n  includeMeta?: boolean;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the comments result payload exchanged by command, SDK, and package integrations. */\nexport interface CommentsResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports comments for this contract. */\n  comments: Comment[];\n  /** Value that configures or reports count for this contract. */\n  count: number;\n  /** Number of total entries represented by this result. */\n  total_count?: number;\n  /** Number of returned entries represented by this result. */\n  returned_count?: number;\n  /** Whether more applies to this operation. */\n  has_more?: boolean;\n  /** Value that configures or reports limit for this contract. */\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\n      \"Specify comment text using only one input source: --add, --stdin, or --file\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(\n        `--file path not found: ${filePath}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(\n      `Failed to read --file path \"${filePath}\": ${detail}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const editIndex = options.edit;\n  const deleteIndex = options.delete;\n  const hasEdit = editIndex !== undefined;\n  const hasDelete = deleteIndex !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\n      \"Specify only one of --edit or --delete\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (editIndex !== undefined && (!Number.isInteger(editIndex) || editIndex < 1)) {\n    throw new PmCliError(\"--edit must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  if (deleteIndex !== undefined && (!Number.isInteger(deleteIndex) || deleteIndex < 1)) {\n    throw new PmCliError(\"--delete must be a positive integer\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\n        \"--delete does not take comment text\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return { mode: \"delete\", index: deleteIndex };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: editIndex,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode =\n    textSource.emptyFlag === \"--add\"\n      ? \"add\"\n      : textSource.emptyFlag === \"--stdin\"\n        ? \"stdin\"\n        : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/** Implements run comments for the public runtime surface of this module. */\nexport async function runComments(\n  id: string,\n  options: CommentsCommandOptions,\n  global: GlobalOptions,\n): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n  if (commentInput.mode === \"list\" && options.message !== undefined) {\n    throw new PmCliError(\n      \"--message labels a comment mutation but does not provide comment text. Pass text positionally or with --add, --stdin, or --file.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const shouldParseText =\n    commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      rawValue: options.add ?? rawValue,\n      value: shouldParseText\n        ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true })\n        : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    bypassOwnershipConflict: Boolean(\n      commentInput.mode === \"add\" &&\n        (options as CommentsCommandOptions & {\n          ownershipAppendBypass?: boolean;\n        }).ownershipAppendBypass,\n    ),\n    conflictGuidance: {\n      required:\n        \"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"review note\" --author \"reviewer\" --force'],\n      nextSteps: [\n        \"Use an installed package's narrow append-only ownership bypass when available.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],"names":["textSource"],"mappings":"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","debugId":"cbfdae67-6c63-5c92-8320-1617c5fcb471"}
+{"version":3,"sources":["../../../../../../../../cli/commands/comments.ts"],"sourcesContent":["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\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 { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport {\n  isErrnoError,\n  parseAnnotationTextInput,\n  runAnnotationCommand,\n} from \"../../sdk/annotations.js\";\n\n/** Documents the comments command options payload exchanged by command, SDK, and package integrations. */\nexport interface CommentsCommandOptions {\n  /** Value that configures or reports add for this contract. */\n  add?: string;\n  /** Value that configures or reports stdin for this contract. */\n  stdin?: boolean;\n  /** Value that configures or reports file for this contract. */\n  file?: string;\n  /** Value that configures or reports edit for this contract. */\n  edit?: number;\n  /** Value that configures or reports delete for this contract. */\n  delete?: number;\n  /** Value that configures or reports limit for this contract. */\n  limit?: string;\n  /** Value that configures or reports include meta for this contract. */\n  includeMeta?: boolean;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the comments result payload exchanged by command, SDK, and package integrations. */\nexport interface CommentsResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports comments for this contract. */\n  comments: Comment[];\n  /** Value that configures or reports count for this contract. */\n  count: number;\n  /** Number of total entries represented by this result. */\n  total_count?: number;\n  /** Number of returned entries represented by this result. */\n  returned_count?: number;\n  /** Whether more applies to this operation. */\n  has_more?: boolean;\n  /** Value that configures or reports limit for this contract. */\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\n      \"Specify comment text using only one input source: --add, --stdin, or --file\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(\n        `--file path not found: ${filePath}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(\n      `Failed to read --file path \"${filePath}\": ${detail}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const editIndex = options.edit;\n  const deleteIndex = options.delete;\n  const hasEdit = editIndex !== undefined;\n  const hasDelete = deleteIndex !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\n      \"Specify only one of --edit or --delete\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (editIndex !== undefined && (!Number.isInteger(editIndex) || editIndex < 1)) {\n    throw new PmCliError(\"--edit must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  if (deleteIndex !== undefined && (!Number.isInteger(deleteIndex) || deleteIndex < 1)) {\n    throw new PmCliError(\"--delete must be a positive integer\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\n        \"--delete does not take comment text\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return { mode: \"delete\", index: deleteIndex };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: editIndex,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode =\n    textSource.emptyFlag === \"--add\"\n      ? \"add\"\n      : textSource.emptyFlag === \"--stdin\"\n        ? \"stdin\"\n        : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/** Implements run comments for the public runtime surface of this module. */\nexport async function runComments(\n  id: string,\n  options: CommentsCommandOptions,\n  global: GlobalOptions,\n): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n  const shouldParseText =\n    commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      rawValue: options.add ?? rawValue,\n      value: shouldParseText\n        ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true })\n        : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    bypassOwnershipConflict: Boolean(\n      commentInput.mode === \"add\" &&\n        (options as CommentsCommandOptions & {\n          ownershipAppendBypass?: boolean;\n        }).ownershipAppendBypass,\n    ),\n    conflictGuidance: {\n      required:\n        \"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"review note\" --author \"reviewer\" --force'],\n      nextSteps: [\n        \"Use an installed package's narrow append-only ownership bypass when available.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],"names":["textSource"],"mappings":"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","debugId":"81f07347-d5fa-5f79-8f92-bd1939a0b091"}

package/dist/cli-bundle/chunks/{chunk-ZUCBPXNA.js → chunk-D6NXDNP3.js}

@@ -1,6 +1,6 @@
 import {
   runCreate
-} from "./chunk-3QNUDDY2.js";
+} from "./chunk-KZEANWJS.js";
 import {
   splitCommaList
 } from "./chunk-D6HZN36B.js";
@@ -11,7 +11,7 @@ import {
   nowIso,
   readLocatedItem,
   readSettings
-} from "./chunk-RLLOZAM2.js";
+} from "./chunk-IY6VZ3IW.js";
 import {
   EXIT_CODE,
   PLAN_HARNESS_VALUES,
@@ -24,13 +24,13 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveTypeName
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/cli/commands/plan.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] = "5ec672ec-6e36-5040-aa20-ef02ed65ee3a");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f86441d5-65b5-52e7-83f4-beb6ac484e6d");
   } catch (e2) {
   }
 })();
@@ -1493,4 +1493,4 @@ export {
   resolvePlanTemplateSteps,
   runPlan
 };
-//# sourceMappingURL=chunk-ZUCBPXNA.js.map
+//# sourceMappingURL=chunk-D6NXDNP3.js.map