@unbrained/pm-cli 2026.7.3 → 2026.7.4

package/dist/cli-bundle/chunks/{chunk-Z5F6XZXE.js → chunk-EB4BBEZD.js}

@@ -3,10 +3,10 @@ import {
   normalizeReplayPatchOps,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-T4XBKJ3F.js";
+} from "./chunk-HL742IBM.js";
 import {
   parseLimit
-} from "./chunk-4PFVUUYV.js";
+} from "./chunk-3MLQZI3H.js";
 import {
   enforceHistoryStreamPolicyForItem,
   hashDocument,
@@ -14,10 +14,10 @@ import {
   locateItem,
   normalizeItemId,
   readLocatedItem
-} from "./chunk-6KRFL33E.js";
+} from "./chunk-CN4OAA2G.js";
 import {
   findFirstMergeConflictMarker
-} from "./chunk-3W2HJKJX.js";
+} from "./chunk-CQFZRLXQ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -30,7 +30,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/core/history/history-diff.js
 !(function() {
@@ -272,4 +272,4 @@ export {
   readHistoryEntries,
   runHistory
 };
-//# sourceMappingURL=chunk-Z5F6XZXE.js.map
+//# sourceMappingURL=chunk-EB4BBEZD.js.map

package/dist/cli-bundle/chunks/{chunk-ERG65A2L.js → chunk-EH23N5FX.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-L4SLHV6G.js";
+} from "./chunk-SL2ANJSV.js";
 
 // dist/core/item/parent-reference-policy.js
 function normalizeParentReferencePolicy(value) {
@@ -75,6 +75,6 @@ export {
   normalizeSprintReleaseFormatPolicy,
   validateSprintOrReleaseValue
 };
-//# sourceMappingURL=chunk-ERG65A2L.js.map
+//# sourceMappingURL=chunk-EH23N5FX.js.map
 
 //# debugId=988af926-d0be-5a81-992f-a0200bb8aebe

package/dist/cli-bundle/chunks/{chunk-SU2E4AWU.js → chunk-FDNJMYZB.js}

@@ -5,10 +5,10 @@ import {
   normalizeReplayPatchOps,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-7CLLC75T.js";
+} from "./chunk-Y2VSCQ77.js";
 import {
   parseLimit
-} from "./chunk-YSGTMDWC.js";
+} from "./chunk-NHKXOMZ5.js";
 import {
   enforceHistoryStreamPolicyForItem,
   hashDocument,
@@ -16,10 +16,10 @@ import {
   locateItem,
   normalizeItemId,
   readLocatedItem
-} from "./chunk-4WB6S4YX.js";
+} from "./chunk-UYLA5ROU.js";
 import {
   findFirstMergeConflictMarker
-} from "./chunk-YSDFIY7N.js";
+} from "./chunk-AOP2EMK3.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -32,7 +32,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-L4SLHV6G.js";
+} from "./chunk-SL2ANJSV.js";
 
 // dist/core/history/history-diff.js
 function decodeJsonPointerSegment(segment) {
@@ -260,6 +260,6 @@ export {
   readHistoryEntries,
   runHistory
 };
-//# sourceMappingURL=chunk-SU2E4AWU.js.map
+//# sourceMappingURL=chunk-FDNJMYZB.js.map
 
 //# debugId=ca4bcf24-adc9-5932-bf2d-2277eca28407

package/dist/cli-bundle/chunks/{chunk-CXR3CMBQ.js → chunk-FMWQRMHS.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-L4SLHV6G.js";
+} from "./chunk-SL2ANJSV.js";
 
 // dist/core/shared/memo.js
 function evictOldestMemoEntries(memo) {
@@ -231,6 +231,6 @@ export {
   compareTimestampStrings,
   resolveIsoOrRelative
 };
-//# sourceMappingURL=chunk-CXR3CMBQ.js.map
+//# sourceMappingURL=chunk-FMWQRMHS.js.map
 
 //# debugId=8b8a7dc0-b7eb-5093-a13c-9d1adf4f3023

package/dist/cli-bundle/chunks/{chunk-T4XBKJ3F.js → chunk-HL742IBM.js}

@@ -1,16 +1,16 @@
 import {
   hashDocument,
   toItemRecord
-} from "./chunk-6KRFL33E.js";
+} from "./chunk-CN4OAA2G.js";
 import {
   canonicalDocument
-} from "./chunk-3W2HJKJX.js";
+} from "./chunk-CQFZRLXQ.js";
 import {
   FRONT_MATTER_KEY_ORDER,
   orderObject,
   sha256Hex,
   stableStringify
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/core/history/replay.js
 import jsonPatch from "fast-json-patch";
@@ -238,4 +238,4 @@ export {
   reanchorHistoryEntries,
   historyEntriesToRaw
 };
-//# sourceMappingURL=chunk-T4XBKJ3F.js.map
+//# sourceMappingURL=chunk-HL742IBM.js.map

package/dist/cli-bundle/chunks/{chunk-YF746GTH.js → chunk-J4KNRDI3.js}

@@ -5,21 +5,21 @@ import {
 } from "./chunk-P4SESZGT.js";
 import {
   ensureTypeFolderScaffold
-} from "./chunk-EJ2OCBHF.js";
+} from "./chunk-YZWXMDNH.js";
 import {
   buildExtensionDescribeResult,
   scaffoldExtensionProject
-} from "./chunk-6CDCWKSX.js";
+} from "./chunk-M34MVAOP.js";
 import {
   normalizeExtensionNameForMatch,
   normalizeManagedDirectoryName,
   normalizeStringList,
   parseExtensionManifest,
   validateExtensionDirectory
-} from "./chunk-QNNQAAZ5.js";
+} from "./chunk-6QY2NA2M.js";
 import {
   nowIso
-} from "./chunk-CXR3CMBQ.js";
+} from "./chunk-FMWQRMHS.js";
 import {
   EXIT_CODE,
   EXTENSION_CAPABILITY_CONTRACT,
@@ -40,7 +40,7 @@ import {
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   writeSettings
-} from "./chunk-L4SLHV6G.js";
+} from "./chunk-SL2ANJSV.js";
 
 // dist/cli/commands/extension.js
 import { execFile as execFile2 } from "node:child_process";
@@ -3388,6 +3388,6 @@ export {
   runExtension,
   _testOnly
 };
-//# sourceMappingURL=chunk-YF746GTH.js.map
+//# sourceMappingURL=chunk-J4KNRDI3.js.map
 
 //# debugId=cf15ae81-2815-5bb4-99ed-f5da84702f95

package/dist/cli-bundle/chunks/{chunk-KS6ATO47.js → chunk-JYLFF7GJ.js}

@@ -1,19 +1,19 @@
 import {
   runExtension
-} from "./chunk-TQ6AX5SQ.js";
+} from "./chunk-UGDONITK.js";
 import {
   TYPE_PRESET_NAMES,
   normalizeTypePresetName,
   resolveTypePresetDefinitions
-} from "./chunk-JPATY4SE.js";
+} from "./chunk-SBNT6SLO.js";
 import {
   parseItemTypesFile,
   serializeItemTypesFile,
   upsertItemType
-} from "./chunk-6NYJGMTY.js";
+} from "./chunk-A2W3XKAD.js";
 import {
   normalizePrefix
-} from "./chunk-6KRFL33E.js";
+} from "./chunk-CN4OAA2G.js";
 import {
   DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
   EXIT_CODE,
@@ -33,7 +33,7 @@ import {
   runActiveOnWriteHooks,
   writeFileAtomic,
   writeSettings
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/cli/commands/init.js
 import fs2 from "node:fs/promises";
@@ -49,7 +49,7 @@ import { stdin as input, stdout as output } from "node:process";
 !(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] = "2d5c3490-b204-56e4-a0b7-c515c05d4b1d");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "7987916d-4294-5753-925d-ceb787be0783");
   } catch (e2) {
   }
 })();
@@ -73,6 +73,7 @@ var AGENT_GUIDANCE_TEMPLATE_VERSION = 1;
 var AGENT_GUIDANCE_START_MARKER_PREFIX = "<!-- pm-cli:agent-guidance:start:";
 var AGENT_GUIDANCE_START_MARKER = `<!-- pm-cli:agent-guidance:start:v${AGENT_GUIDANCE_TEMPLATE_VERSION} -->`;
 var AGENT_GUIDANCE_END_MARKER = "<!-- pm-cli:agent-guidance:end -->";
+var AGENT_GUIDANCE_ADD_LATER_HINT = "Add workflow guidance later: pm init --agent-guidance add";
 var createAgentGuidanceReadlineInterface = () => readline.createInterface({ input, output });
 function toPortableRelativePath(projectRoot, targetPath) {
   const relative = path.relative(projectRoot, targetPath);
@@ -270,113 +271,155 @@ function buildInitAgentGuidanceSummary(params) {
 async function refreshGuidanceScansAfterApply(applied, scans, projectRoot) {
   return applied ? await scanGuidanceFiles(projectRoot) : scans;
 }
-async function runInitAgentGuidance(options) {
-  const warnings = [];
-  const nextSteps = [];
-  const projectRoot = resolveProjectRoot(options.pm_root, options.cwd);
-  let scans = await scanGuidanceFiles(projectRoot);
-  const targetPath = resolveTargetGuidancePath(scans, projectRoot);
-  const targetRelativePath = toPortableRelativePath(projectRoot, targetPath);
-  const addLaterHint = "Add workflow guidance later: pm init --agent-guidance add";
-  let prompted = false;
-  let applied = false;
-  let skipped = false;
-  let state = normalizeAgentGuidanceState(options.settings);
-  const checkedFiles = scans.map((entry) => toPortableRelativePath(projectRoot, entry.file_path));
-  const presentBefore = scans.some((entry) => entry.has_guidance);
-  const markState = (partial) => {
-    state = {
-      ...state,
-      ...partial,
-      template_version: AGENT_GUIDANCE_TEMPLATE_VERSION,
-      last_checked_files: checkedFiles
-    };
+function markAgentGuidanceRunState(flow, checkedFiles, partial) {
+  flow.state = {
+    ...flow.state,
+    ...partial,
+    template_version: AGENT_GUIDANCE_TEMPLATE_VERSION,
+    last_checked_files: checkedFiles
   };
-  if (options.mode === "status") {
-    if (!presentBefore) {
-      warnings.push("agent_guidance:missing");
-      pushUnique(nextSteps, addLaterHint);
-    }
-  } else if (options.mode === "skip") {
-    skipped = true;
-    markState({
+}
+async function addAgentGuidanceBlockIfMissing(flow, context) {
+  if (context.presentBefore) {
+    return;
+  }
+  const writeResult = await writeGuidanceFile(context.targetPath);
+  flow.warnings.push(...writeResult.warnings);
+  if (writeResult.changed) {
+    flow.applied = true;
+    flow.warnings.push(`agent_guidance:added:${context.targetRelativePath}`);
+  }
+}
+function handleAgentGuidanceStatusMode(flow, presentBefore) {
+  if (!presentBefore) {
+    flow.warnings.push("agent_guidance:missing");
+    pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);
+  }
+}
+function handleAgentGuidanceSkipMode(flow, checkedFiles) {
+  flow.skipped = true;
+  markAgentGuidanceRunState(flow, checkedFiles, {
+    prompt_completed: true,
+    declined: true,
+    declined_at: flow.state.declined_at || (/* @__PURE__ */ new Date()).toISOString()
+  });
+  flow.warnings.push("agent_guidance:explicit_skip");
+  pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);
+}
+async function handleAgentGuidanceAddMode(flow, context) {
+  await addAgentGuidanceBlockIfMissing(flow, context);
+  markAgentGuidanceRunState(flow, context.checkedFiles, {
+    prompt_completed: true,
+    declined: false,
+    declined_at: ""
+  });
+}
+function handlePresentAgentGuidance(flow, checkedFiles) {
+  if (flow.state.declined) {
+    markAgentGuidanceRunState(flow, checkedFiles, {
       prompt_completed: true,
-      declined: true,
-      declined_at: state.declined_at.length > 0 ? state.declined_at : (/* @__PURE__ */ new Date()).toISOString()
+      declined: false,
+      declined_at: ""
     });
-    warnings.push("agent_guidance:explicit_skip");
-    pushUnique(nextSteps, addLaterHint);
-  } else if (options.mode === "add") {
-    if (!presentBefore) {
-      const writeResult = await writeGuidanceFile(targetPath);
-      warnings.push(...writeResult.warnings);
-      if (writeResult.changed) {
-        applied = true;
-        warnings.push(`agent_guidance:added:${targetRelativePath}`);
-      }
-    }
-    markState({
+  }
+}
+function handleDeclinedAgentGuidance(flow) {
+  flow.skipped = true;
+  flow.warnings.push("agent_guidance:skipped_declined");
+  pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);
+}
+async function handleInteractiveAgentGuidancePrompt(flow, context) {
+  flow.prompted = true;
+  const approved = await promptForGuidanceWrite(context.targetRelativePath);
+  if (approved) {
+    await addAgentGuidanceBlockIfMissing(flow, context);
+    markAgentGuidanceRunState(flow, context.checkedFiles, {
       prompt_completed: true,
       declined: false,
       declined_at: ""
     });
-  } else if (presentBefore) {
-    if (state.declined) {
-      markState({
-        prompt_completed: true,
-        declined: false,
-        declined_at: ""
-      });
-    }
-  } else if (state.prompt_completed && state.declined) {
-    skipped = true;
-    warnings.push("agent_guidance:skipped_declined");
-    pushUnique(nextSteps, addLaterHint);
-  } else if (options.interactive) {
-    prompted = true;
-    const approved = await promptForGuidanceWrite(targetRelativePath);
-    if (approved) {
-      const writeResult = await writeGuidanceFile(targetPath);
-      warnings.push(...writeResult.warnings);
-      if (writeResult.changed) {
-        applied = true;
-        warnings.push(`agent_guidance:added:${targetRelativePath}`);
-      }
-      markState({
-        prompt_completed: true,
-        declined: false,
-        declined_at: ""
-      });
-    } else {
-      skipped = true;
-      markState({
-        prompt_completed: true,
-        declined: true,
-        declined_at: (/* @__PURE__ */ new Date()).toISOString()
-      });
-      warnings.push("agent_guidance:declined");
-      pushUnique(nextSteps, addLaterHint);
-    }
-  } else {
-    warnings.push("agent_guidance:missing_non_interactive");
-    pushUnique(nextSteps, addLaterHint);
+    return;
+  }
+  flow.skipped = true;
+  markAgentGuidanceRunState(flow, context.checkedFiles, {
+    prompt_completed: true,
+    declined: true,
+    declined_at: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  flow.warnings.push("agent_guidance:declined");
+  pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);
+}
+function handleNonInteractiveMissingAgentGuidance(flow) {
+  flow.warnings.push("agent_guidance:missing_non_interactive");
+  pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);
+}
+async function applyAgentGuidanceMode(initialState, context) {
+  const flow = {
+    warnings: [],
+    nextSteps: [],
+    prompted: false,
+    applied: false,
+    skipped: false,
+    state: initialState
+  };
+  if (context.mode === "status") {
+    handleAgentGuidanceStatusMode(flow, context.presentBefore);
+    return flow;
+  }
+  if (context.mode === "skip") {
+    handleAgentGuidanceSkipMode(flow, context.checkedFiles);
+    return flow;
+  }
+  if (context.mode === "add") {
+    await handleAgentGuidanceAddMode(flow, context);
+    return flow;
+  }
+  if (context.presentBefore) {
+    handlePresentAgentGuidance(flow, context.checkedFiles);
+    return flow;
+  }
+  if (flow.state.prompt_completed && flow.state.declined) {
+    handleDeclinedAgentGuidance(flow);
+    return flow;
+  }
+  if (context.interactive) {
+    await handleInteractiveAgentGuidancePrompt(flow, context);
+    return flow;
   }
-  const stateUpdate = applyAgentGuidanceState(options.settings, state);
-  scans = await refreshGuidanceScansAfterApply(applied, scans, projectRoot);
+  handleNonInteractiveMissingAgentGuidance(flow);
+  return flow;
+}
+async function runInitAgentGuidance(options) {
+  const projectRoot = resolveProjectRoot(options.pm_root, options.cwd);
+  let scans = await scanGuidanceFiles(projectRoot);
+  const targetPath = resolveTargetGuidancePath(scans, projectRoot);
+  const targetRelativePath = toPortableRelativePath(projectRoot, targetPath);
+  const checkedFiles = scans.map((entry) => toPortableRelativePath(projectRoot, entry.file_path));
+  const presentBefore = scans.some((entry) => entry.has_guidance);
+  const flow = await applyAgentGuidanceMode(normalizeAgentGuidanceState(options.settings), {
+    mode: options.mode,
+    interactive: options.interactive,
+    targetPath,
+    targetRelativePath,
+    checkedFiles,
+    presentBefore
+  });
+  const stateUpdate = applyAgentGuidanceState(options.settings, flow.state);
+  scans = await refreshGuidanceScansAfterApply(flow.applied, scans, projectRoot);
   const summary = buildInitAgentGuidanceSummary({
     mode: options.mode,
     scans,
     projectRoot,
     targetRelativePath,
-    prompted,
-    applied,
-    skipped,
-    state
+    prompted: flow.prompted,
+    applied: flow.applied,
+    skipped: flow.skipped,
+    state: flow.state
   });
   return {
     summary,
-    warnings,
-    next_steps: nextSteps,
+    warnings: flow.warnings,
+    next_steps: flow.nextSteps,
     settings_changed: stateUpdate.changed
   };
 }
@@ -385,7 +428,7 @@ async function runInitAgentGuidance(options) {
 !(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] = "a0acfeba-010e-51e0-bc49-90e4854fe975");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "df631c25-0bdb-52e7-aec4-a83f25fdfa91");
   } catch (e2) {
   }
 })();
@@ -900,7 +943,7 @@ async function runInit(prefixArg, global2, options = {}) {
   const settingsPath = path2.join(pmRoot, "settings.json");
   const settingsExists = await pathExists(settingsPath);
   const normalizedOptions = normalizeInitCommandOptions(options);
-  let settingsResolution = await resolveInitSettings({
+  const settingsResolution = await resolveInitSettings({
     pmRoot,
     settingsPath,
     settingsExists,
@@ -957,4 +1000,4 @@ export {
   _testOnly,
   runInit
 };
-//# sourceMappingURL=chunk-KS6ATO47.js.map
+//# sourceMappingURL=chunk-JYLFF7GJ.js.map