@unbrained/pm-cli 2026.5.14 → 2026.5.24

package/dist/cli/commands/init-agent-guidance.js

@@ -0,0 +1,336 @@
+
+!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]="5a5676f5-f102-5fdd-9b33-04645e8971c2")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { runActiveOnWriteHooks } from "../../core/extensions/index.js";
+import { pathExists } from "../../core/fs/fs-utils.js";
+export const INIT_AGENT_GUIDANCE_MODE_VALUES = ["ask", "add", "skip", "status"];
+const AGENT_GUIDANCE_TARGET_FILENAMES = ["AGENTS.md", "CLAUDE.md"];
+const AGENT_GUIDANCE_REQUIRED_TOKENS = [
+    "pm init",
+    "pm context",
+    "pm search",
+    "pm create",
+    "pm claim",
+    "pm files",
+    "pm docs",
+    "pm test --run",
+    "pm close",
+    "pm release",
+    "pm_author",
+];
+const AGENT_GUIDANCE_REQUIRED_TOKEN_THRESHOLD = 8;
+const AGENT_GUIDANCE_TEMPLATE_VERSION = 1;
+const AGENT_GUIDANCE_START_MARKER_PREFIX = "<!-- pm-cli:agent-guidance:start:";
+const AGENT_GUIDANCE_START_MARKER = `<!-- pm-cli:agent-guidance:start:v${AGENT_GUIDANCE_TEMPLATE_VERSION} -->`;
+const AGENT_GUIDANCE_END_MARKER = "<!-- pm-cli:agent-guidance:end -->";
+function toPortableRelativePath(projectRoot, targetPath) {
+    const relative = path.relative(projectRoot, targetPath);
+    if (relative.length === 0) {
+        return path.basename(targetPath);
+    }
+    return relative.split(path.sep).join("/");
+}
+function ensureTrailingNewline(value) {
+    return value.endsWith("\n") ? value : `${value}\n`;
+}
+function detectLineEnding(value) {
+    return value.includes("\r\n") ? "\r\n" : "\n";
+}
+function findGuidanceBlockRange(content) {
+    const startIndex = content.indexOf(AGENT_GUIDANCE_START_MARKER_PREFIX);
+    if (startIndex === -1) {
+        return null;
+    }
+    const endMarkerIndex = content.indexOf(AGENT_GUIDANCE_END_MARKER, startIndex);
+    if (endMarkerIndex === -1) {
+        return null;
+    }
+    return {
+        start_index: startIndex,
+        end_index: endMarkerIndex + AGENT_GUIDANCE_END_MARKER.length,
+    };
+}
+function hasGuidanceMarker(content) {
+    return findGuidanceBlockRange(content) !== null;
+}
+function buildAgentGuidanceBlock(lineEnding) {
+    const lines = [
+        AGENT_GUIDANCE_START_MARKER,
+        "## pm Workflow (Agent Quickstart)",
+        "",
+        "- Orient before mutate: `pm context --limit 10`, `pm search \"<keywords>\" --limit 10`, `pm list-open --limit 20`.",
+        "- Claim and execute: `pm claim <id>` then `pm update <id> --status in_progress`.",
+        "- Link evidence while coding: `pm files <id> --add ...`, `pm docs <id> --add ...`, `pm test <id> --add command=\"node scripts/run-tests.mjs test -- ...\"`.",
+        "- Verify and close: `pm test <id> --run --progress`, `pm close <id> \"<evidence>\" --validate-close warn`, `pm release <id>`.",
+        "- Set `PM_AUTHOR=<stable-agent-id>` before mutation commands.",
+        "",
+        AGENT_GUIDANCE_END_MARKER,
+        "",
+    ];
+    return lines.join(lineEnding);
+}
+function upsertAgentGuidanceBlock(existingContent) {
+    const lineEnding = detectLineEnding(existingContent);
+    const nextBlock = buildAgentGuidanceBlock(lineEnding);
+    const existingRange = findGuidanceBlockRange(existingContent);
+    if (existingRange) {
+        const nextContent = ensureTrailingNewline(`${existingContent.slice(0, existingRange.start_index)}${nextBlock}${existingContent.slice(existingRange.end_index)}`);
+        return {
+            next_content: nextContent,
+            changed: nextContent !== existingContent,
+        };
+    }
+    const separator = existingContent.length === 0 ? "" : existingContent.endsWith("\n") ? "\n" : "\n\n";
+    const nextContent = ensureTrailingNewline(`${existingContent}${separator}${nextBlock}`);
+    return {
+        next_content: nextContent,
+        changed: nextContent !== existingContent,
+    };
+}
+function resolveProjectRoot(pmRoot, cwd) {
+    const parent = path.dirname(pmRoot);
+    if (path.basename(pmRoot) === "pm" && path.basename(parent) === ".agents") {
+        return path.dirname(parent);
+    }
+    return path.resolve(cwd, pmRoot);
+}
+function resolveTargetGuidancePath(scans, projectRoot) {
+    const existingAgents = scans.find((entry) => path.basename(entry.file_path) === "AGENTS.md" && entry.exists);
+    if (existingAgents) {
+        return existingAgents.file_path;
+    }
+    const existingAny = scans.find((entry) => entry.exists);
+    if (existingAny) {
+        return existingAny.file_path;
+    }
+    return path.join(projectRoot, "AGENTS.md");
+}
+function parsePromptChoice(answer, currentDefault) {
+    const normalized = answer.trim().toLowerCase();
+    if (normalized.length === 0) {
+        return currentDefault;
+    }
+    if (normalized === "y" || normalized === "yes") {
+        return true;
+    }
+    if (normalized === "n" || normalized === "no") {
+        return false;
+    }
+    return currentDefault;
+}
+async function promptForGuidanceWrite(targetRelativePath) {
+    const rl = readline.createInterface({ input, output });
+    try {
+        output.write("\nAgent guidance check\n");
+        output.write("No AGENTS.md/CLAUDE.md file currently contains compact pm workflow guidance.\n");
+        const answer = await rl.question(`Add a compact pm workflow section to ${targetRelativePath}? [Y/n] `);
+        output.write("\n");
+        return parsePromptChoice(answer, true);
+    }
+    finally {
+        rl.close();
+    }
+}
+function normalizeAgentGuidanceState(settings) {
+    const current = settings.agent_guidance;
+    return {
+        prompt_completed: current?.prompt_completed === true,
+        declined: current?.declined === true,
+        declined_at: typeof current?.declined_at === "string" ? current.declined_at : "",
+        template_version: typeof current?.template_version === "number" && Number.isInteger(current.template_version) && current.template_version > 0
+            ? current.template_version
+            : AGENT_GUIDANCE_TEMPLATE_VERSION,
+        last_checked_files: Array.isArray(current?.last_checked_files)
+            ? [...new Set(current.last_checked_files.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right))
+            : [],
+    };
+}
+async function scanGuidanceFiles(projectRoot) {
+    const scans = [];
+    for (const filename of AGENT_GUIDANCE_TARGET_FILENAMES) {
+        const filePath = path.join(projectRoot, filename);
+        const exists = await pathExists(filePath);
+        if (!exists) {
+            scans.push({
+                file_path: filePath,
+                exists,
+                has_guidance: false,
+                has_marker: false,
+            });
+            continue;
+        }
+        const content = await fs.readFile(filePath, "utf8");
+        const contentLower = content.toLowerCase();
+        const tokenHits = AGENT_GUIDANCE_REQUIRED_TOKENS.filter((token) => contentLower.includes(token));
+        const hasMarker = hasGuidanceMarker(content);
+        scans.push({
+            file_path: filePath,
+            exists,
+            has_guidance: hasMarker || tokenHits.length >= AGENT_GUIDANCE_REQUIRED_TOKEN_THRESHOLD,
+            has_marker: hasMarker,
+        });
+    }
+    return scans;
+}
+function pushUnique(target, value) {
+    if (!target.includes(value)) {
+        target.push(value);
+    }
+}
+function applyAgentGuidanceState(settings, currentState) {
+    const existing = normalizeAgentGuidanceState(settings);
+    const changed = JSON.stringify(existing) !== JSON.stringify(currentState);
+    if (changed) {
+        settings.agent_guidance = currentState;
+    }
+    return { changed, state: currentState };
+}
+async function writeGuidanceFile(filePath) {
+    const exists = await pathExists(filePath);
+    const currentContent = exists ? await fs.readFile(filePath, "utf8") : "";
+    const nextContent = upsertAgentGuidanceBlock(currentContent);
+    if (!nextContent.changed) {
+        return { changed: false, warnings: [] };
+    }
+    await fs.writeFile(filePath, nextContent.next_content, "utf8");
+    return {
+        changed: true,
+        warnings: await runActiveOnWriteHooks({
+            path: filePath,
+            scope: "project",
+            op: "init:agent_guidance_file",
+        }),
+    };
+}
+export 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,
+        };
+    };
+    if (options.mode === "status") {
+        if (!presentBefore) {
+            warnings.push("agent_guidance:missing");
+            pushUnique(nextSteps, addLaterHint);
+        }
+    }
+    else if (options.mode === "skip") {
+        skipped = true;
+        markState({
+            prompt_completed: true,
+            declined: true,
+            declined_at: state.declined_at.length > 0 ? state.declined_at : new Date().toISOString(),
+        });
+        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({
+            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: new Date().toISOString(),
+            });
+            warnings.push("agent_guidance:declined");
+            pushUnique(nextSteps, addLaterHint);
+        }
+    }
+    else {
+        warnings.push("agent_guidance:missing_non_interactive");
+        pushUnique(nextSteps, addLaterHint);
+    }
+    const stateUpdate = applyAgentGuidanceState(options.settings, state);
+    if (applied) {
+        scans = await scanGuidanceFiles(projectRoot);
+    }
+    const summary = {
+        mode: options.mode,
+        present: scans.some((entry) => entry.has_guidance),
+        prompted,
+        applied,
+        skipped,
+        declined: state.declined,
+        prompt_completed: state.prompt_completed,
+        template_version: state.template_version,
+        target_file: targetRelativePath,
+        checked_files: scans.map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),
+        files_with_guidance: scans
+            .filter((entry) => entry.has_guidance)
+            .map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),
+        missing_files: scans
+            .filter((entry) => !entry.exists)
+            .map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),
+    };
+    return {
+        summary,
+        warnings,
+        next_steps: nextSteps,
+        settings_changed: stateUpdate.changed,
+    };
+}
+//# sourceMappingURL=init-agent-guidance.js.map
+//# debugId=5a5676f5-f102-5fdd-9b33-04645e8971c2

package/dist/cli/commands/init-agent-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-agent-guidance.js","sources":["cli/commands/init-agent-guidance.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport readline from \"node:readline/promises\";\nimport { stdin as input, stdout as output } from \"node:process\";\nimport { runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport type { PmSettings } from \"../../types/index.js\";\n\nexport type InitAgentGuidanceMode = \"ask\" | \"add\" | \"skip\" | \"status\";\n\nexport const INIT_AGENT_GUIDANCE_MODE_VALUES: InitAgentGuidanceMode[] = [\"ask\", \"add\", \"skip\", \"status\"];\n\nconst AGENT_GUIDANCE_TARGET_FILENAMES = [\"AGENTS.md\", \"CLAUDE.md\"] as const;\nconst AGENT_GUIDANCE_REQUIRED_TOKENS = [\n  \"pm init\",\n  \"pm context\",\n  \"pm search\",\n  \"pm create\",\n  \"pm claim\",\n  \"pm files\",\n  \"pm docs\",\n  \"pm test --run\",\n  \"pm close\",\n  \"pm release\",\n  \"pm_author\",\n] as const;\nconst AGENT_GUIDANCE_REQUIRED_TOKEN_THRESHOLD = 8;\nconst AGENT_GUIDANCE_TEMPLATE_VERSION = 1;\nconst AGENT_GUIDANCE_START_MARKER_PREFIX = \"<!-- pm-cli:agent-guidance:start:\";\nconst AGENT_GUIDANCE_START_MARKER = `<!-- pm-cli:agent-guidance:start:v${AGENT_GUIDANCE_TEMPLATE_VERSION} -->`;\nconst AGENT_GUIDANCE_END_MARKER = \"<!-- pm-cli:agent-guidance:end -->\";\n\ninterface AgentGuidanceFileScan {\n  file_path: string;\n  exists: boolean;\n  has_guidance: boolean;\n  has_marker: boolean;\n}\n\ninterface AgentGuidanceBlockRange {\n  start_index: number;\n  end_index: number;\n}\n\nexport interface InitAgentGuidanceSummary {\n  mode: InitAgentGuidanceMode;\n  present: boolean;\n  prompted: boolean;\n  applied: boolean;\n  skipped: boolean;\n  declined: boolean;\n  prompt_completed: boolean;\n  template_version: number;\n  target_file: string;\n  checked_files: string[];\n  files_with_guidance: string[];\n  missing_files: string[];\n}\n\nexport interface RunInitAgentGuidanceOptions {\n  pm_root: string;\n  cwd: string;\n  mode: InitAgentGuidanceMode;\n  interactive: boolean;\n  settings: PmSettings;\n}\n\nexport interface RunInitAgentGuidanceResult {\n  summary: InitAgentGuidanceSummary;\n  warnings: string[];\n  next_steps: string[];\n  settings_changed: boolean;\n}\n\nfunction toPortableRelativePath(projectRoot: string, targetPath: string): string {\n  const relative = path.relative(projectRoot, targetPath);\n  if (relative.length === 0) {\n    return path.basename(targetPath);\n  }\n  return relative.split(path.sep).join(\"/\");\n}\n\nfunction ensureTrailingNewline(value: string): string {\n  return value.endsWith(\"\\n\") ? value : `${value}\\n`;\n}\n\nfunction detectLineEnding(value: string): \"\\n\" | \"\\r\\n\" {\n  return value.includes(\"\\r\\n\") ? \"\\r\\n\" : \"\\n\";\n}\n\nfunction findGuidanceBlockRange(content: string): AgentGuidanceBlockRange | null {\n  const startIndex = content.indexOf(AGENT_GUIDANCE_START_MARKER_PREFIX);\n  if (startIndex === -1) {\n    return null;\n  }\n  const endMarkerIndex = content.indexOf(AGENT_GUIDANCE_END_MARKER, startIndex);\n  if (endMarkerIndex === -1) {\n    return null;\n  }\n  return {\n    start_index: startIndex,\n    end_index: endMarkerIndex + AGENT_GUIDANCE_END_MARKER.length,\n  };\n}\n\nfunction hasGuidanceMarker(content: string): boolean {\n  return findGuidanceBlockRange(content) !== null;\n}\n\nfunction buildAgentGuidanceBlock(lineEnding: \"\\n\" | \"\\r\\n\"): string {\n  const lines = [\n    AGENT_GUIDANCE_START_MARKER,\n    \"## pm Workflow (Agent Quickstart)\",\n    \"\",\n    \"- Orient before mutate: `pm context --limit 10`, `pm search \\\"<keywords>\\\" --limit 10`, `pm list-open --limit 20`.\",\n    \"- Claim and execute: `pm claim <id>` then `pm update <id> --status in_progress`.\",\n    \"- Link evidence while coding: `pm files <id> --add ...`, `pm docs <id> --add ...`, `pm test <id> --add command=\\\"node scripts/run-tests.mjs test -- ...\\\"`.\",\n    \"- Verify and close: `pm test <id> --run --progress`, `pm close <id> \\\"<evidence>\\\" --validate-close warn`, `pm release <id>`.\",\n    \"- Set `PM_AUTHOR=<stable-agent-id>` before mutation commands.\",\n    \"\",\n    AGENT_GUIDANCE_END_MARKER,\n    \"\",\n  ];\n  return lines.join(lineEnding);\n}\n\nfunction upsertAgentGuidanceBlock(existingContent: string): { next_content: string; changed: boolean } {\n  const lineEnding = detectLineEnding(existingContent);\n  const nextBlock = buildAgentGuidanceBlock(lineEnding);\n  const existingRange = findGuidanceBlockRange(existingContent);\n  if (existingRange) {\n    const nextContent = ensureTrailingNewline(\n      `${existingContent.slice(0, existingRange.start_index)}${nextBlock}${existingContent.slice(existingRange.end_index)}`,\n    );\n    return {\n      next_content: nextContent,\n      changed: nextContent !== existingContent,\n    };\n  }\n  const separator = existingContent.length === 0 ? \"\" : existingContent.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n  const nextContent = ensureTrailingNewline(`${existingContent}${separator}${nextBlock}`);\n  return {\n    next_content: nextContent,\n    changed: nextContent !== existingContent,\n  };\n}\n\nfunction resolveProjectRoot(pmRoot: string, cwd: string): string {\n  const parent = path.dirname(pmRoot);\n  if (path.basename(pmRoot) === \"pm\" && path.basename(parent) === \".agents\") {\n    return path.dirname(parent);\n  }\n  return path.resolve(cwd, pmRoot);\n}\n\nfunction resolveTargetGuidancePath(scans: AgentGuidanceFileScan[], projectRoot: string): string {\n  const existingAgents = scans.find((entry) => path.basename(entry.file_path) === \"AGENTS.md\" && entry.exists);\n  if (existingAgents) {\n    return existingAgents.file_path;\n  }\n  const existingAny = scans.find((entry) => entry.exists);\n  if (existingAny) {\n    return existingAny.file_path;\n  }\n  return path.join(projectRoot, \"AGENTS.md\");\n}\n\nfunction parsePromptChoice(answer: string, currentDefault: boolean): boolean {\n  const normalized = answer.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return currentDefault;\n  }\n  if (normalized === \"y\" || normalized === \"yes\") {\n    return true;\n  }\n  if (normalized === \"n\" || normalized === \"no\") {\n    return false;\n  }\n  return currentDefault;\n}\n\nasync function promptForGuidanceWrite(targetRelativePath: string): Promise<boolean> {\n  const rl = readline.createInterface({ input, output });\n  try {\n    output.write(\"\\nAgent guidance check\\n\");\n    output.write(\"No AGENTS.md/CLAUDE.md file currently contains compact pm workflow guidance.\\n\");\n    const answer = await rl.question(`Add a compact pm workflow section to ${targetRelativePath}? [Y/n] `);\n    output.write(\"\\n\");\n    return parsePromptChoice(answer, true);\n  } finally {\n    rl.close();\n  }\n}\n\nfunction normalizeAgentGuidanceState(settings: PmSettings): PmSettings[\"agent_guidance\"] {\n  const current = settings.agent_guidance;\n  return {\n    prompt_completed: current?.prompt_completed === true,\n    declined: current?.declined === true,\n    declined_at: typeof current?.declined_at === \"string\" ? current.declined_at : \"\",\n    template_version:\n      typeof current?.template_version === \"number\" && Number.isInteger(current.template_version) && current.template_version > 0\n        ? current.template_version\n        : AGENT_GUIDANCE_TEMPLATE_VERSION,\n    last_checked_files: Array.isArray(current?.last_checked_files)\n      ? [...new Set(current.last_checked_files.map((value) => value.trim()).filter((value) => value.length > 0))].sort(\n          (left, right) => left.localeCompare(right),\n        )\n      : [],\n  };\n}\n\nasync function scanGuidanceFiles(projectRoot: string): Promise<AgentGuidanceFileScan[]> {\n  const scans: AgentGuidanceFileScan[] = [];\n  for (const filename of AGENT_GUIDANCE_TARGET_FILENAMES) {\n    const filePath = path.join(projectRoot, filename);\n    const exists = await pathExists(filePath);\n    if (!exists) {\n      scans.push({\n        file_path: filePath,\n        exists,\n        has_guidance: false,\n        has_marker: false,\n      });\n      continue;\n    }\n    const content = await fs.readFile(filePath, \"utf8\");\n    const contentLower = content.toLowerCase();\n    const tokenHits = AGENT_GUIDANCE_REQUIRED_TOKENS.filter((token) => contentLower.includes(token));\n    const hasMarker = hasGuidanceMarker(content);\n    scans.push({\n      file_path: filePath,\n      exists,\n      has_guidance: hasMarker || tokenHits.length >= AGENT_GUIDANCE_REQUIRED_TOKEN_THRESHOLD,\n      has_marker: hasMarker,\n    });\n  }\n  return scans;\n}\n\nfunction pushUnique(target: string[], value: string): void {\n  if (!target.includes(value)) {\n    target.push(value);\n  }\n}\n\nfunction applyAgentGuidanceState(\n  settings: PmSettings,\n  currentState: PmSettings[\"agent_guidance\"],\n): { changed: boolean; state: PmSettings[\"agent_guidance\"] } {\n  const existing = normalizeAgentGuidanceState(settings);\n  const changed = JSON.stringify(existing) !== JSON.stringify(currentState);\n  if (changed) {\n    settings.agent_guidance = currentState;\n  }\n  return { changed, state: currentState };\n}\n\nasync function writeGuidanceFile(filePath: string): Promise<{ changed: boolean; warnings: string[] }> {\n  const exists = await pathExists(filePath);\n  const currentContent = exists ? await fs.readFile(filePath, \"utf8\") : \"\";\n  const nextContent = upsertAgentGuidanceBlock(currentContent);\n  if (!nextContent.changed) {\n    return { changed: false, warnings: [] };\n  }\n  await fs.writeFile(filePath, nextContent.next_content, \"utf8\");\n  return {\n    changed: true,\n    warnings: await runActiveOnWriteHooks({\n      path: filePath,\n      scope: \"project\",\n      op: \"init:agent_guidance_file\",\n    }),\n  };\n}\n\nexport async function runInitAgentGuidance(options: RunInitAgentGuidanceOptions): Promise<RunInitAgentGuidanceResult> {\n  const warnings: string[] = [];\n  const nextSteps: string[] = [];\n  const projectRoot = resolveProjectRoot(options.pm_root, options.cwd);\n  let scans = await scanGuidanceFiles(projectRoot);\n  const targetPath = resolveTargetGuidancePath(scans, projectRoot);\n  const targetRelativePath = toPortableRelativePath(projectRoot, targetPath);\n  const addLaterHint = \"Add workflow guidance later: pm init --agent-guidance add\";\n  let prompted = false;\n  let applied = false;\n  let skipped = false;\n  let state = normalizeAgentGuidanceState(options.settings);\n  const checkedFiles = scans.map((entry) => toPortableRelativePath(projectRoot, entry.file_path));\n  const presentBefore = scans.some((entry) => entry.has_guidance);\n\n  const markState = (partial: Partial<PmSettings[\"agent_guidance\"]>): void => {\n    state = {\n      ...state,\n      ...partial,\n      template_version: AGENT_GUIDANCE_TEMPLATE_VERSION,\n      last_checked_files: checkedFiles,\n    };\n  };\n\n  if (options.mode === \"status\") {\n    if (!presentBefore) {\n      warnings.push(\"agent_guidance:missing\");\n      pushUnique(nextSteps, addLaterHint);\n    }\n  } else if (options.mode === \"skip\") {\n    skipped = true;\n    markState({\n      prompt_completed: true,\n      declined: true,\n      declined_at: state.declined_at.length > 0 ? state.declined_at : new Date().toISOString(),\n    });\n    warnings.push(\"agent_guidance:explicit_skip\");\n    pushUnique(nextSteps, addLaterHint);\n  } else if (options.mode === \"add\") {\n    if (!presentBefore) {\n      const writeResult = await writeGuidanceFile(targetPath);\n      warnings.push(...writeResult.warnings);\n      if (writeResult.changed) {\n        applied = true;\n        warnings.push(`agent_guidance:added:${targetRelativePath}`);\n      }\n    }\n    markState({\n      prompt_completed: true,\n      declined: false,\n      declined_at: \"\",\n    });\n  } else if (presentBefore) {\n    if (state.declined) {\n      markState({\n        prompt_completed: true,\n        declined: false,\n        declined_at: \"\",\n      });\n    }\n  } else if (state.prompt_completed && state.declined) {\n    skipped = true;\n    warnings.push(\"agent_guidance:skipped_declined\");\n    pushUnique(nextSteps, addLaterHint);\n  } else if (options.interactive) {\n    prompted = true;\n    const approved = await promptForGuidanceWrite(targetRelativePath);\n    if (approved) {\n      const writeResult = await writeGuidanceFile(targetPath);\n      warnings.push(...writeResult.warnings);\n      if (writeResult.changed) {\n        applied = true;\n        warnings.push(`agent_guidance:added:${targetRelativePath}`);\n      }\n      markState({\n        prompt_completed: true,\n        declined: false,\n        declined_at: \"\",\n      });\n    } else {\n      skipped = true;\n      markState({\n        prompt_completed: true,\n        declined: true,\n        declined_at: new Date().toISOString(),\n      });\n      warnings.push(\"agent_guidance:declined\");\n      pushUnique(nextSteps, addLaterHint);\n    }\n  } else {\n    warnings.push(\"agent_guidance:missing_non_interactive\");\n    pushUnique(nextSteps, addLaterHint);\n  }\n\n  const stateUpdate = applyAgentGuidanceState(options.settings, state);\n  if (applied) {\n    scans = await scanGuidanceFiles(projectRoot);\n  }\n\n  const summary: InitAgentGuidanceSummary = {\n    mode: options.mode,\n    present: scans.some((entry) => entry.has_guidance),\n    prompted,\n    applied,\n    skipped,\n    declined: state.declined,\n    prompt_completed: state.prompt_completed,\n    template_version: state.template_version,\n    target_file: targetRelativePath,\n    checked_files: scans.map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),\n    files_with_guidance: scans\n      .filter((entry) => entry.has_guidance)\n      .map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),\n    missing_files: scans\n      .filter((entry) => !entry.exists)\n      .map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),\n  };\n\n  return {\n    summary,\n    warnings,\n    next_steps: nextSteps,\n    settings_changed: stateUpdate.changed,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"5a5676f5-f102-5fdd-9b33-04645e8971c2"}

package/dist/cli/commands/init.d.ts

@@ -1,5 +1,14 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 import type { GovernancePreset, PmSettings } from "../../types/index.js";
+import { type InitAgentGuidanceSummary } from "./init-agent-guidance.js";
+export interface InitInstalledPackagesSummary {
+    installed_all: boolean;
+    installed_count: number;
+    packages: Array<{
+        alias: string;
+        ok: boolean;
+    }>;
+}
 export interface InitResult {
     ok: boolean;
     path: string;
@@ -8,10 +17,43 @@ export interface InitResult {
     warnings: string[];
     governance_preset: GovernancePreset;
     wizard_used: boolean;
+    installed_packages?: InitInstalledPackagesSummary;
+    next_steps: string[];
+    agent_guidance: InitAgentGuidanceSummary;
 }
 export interface InitCommandOptions {
     preset?: string;
     defaults?: boolean;
     author?: string;
+    withPackages?: boolean;
+    agentGuidance?: string;
+}
+/**
+ * Concise projection of an InitResult for the default (toon) renderer. It keeps
+ * every piece of information that only init can surface — the resolved path, id
+ * prefix, governance preset, telemetry capture level, created-directory count,
+ * the full warnings list (including `already_exists:` markers), agent-guidance
+ * summary, and next steps — but replaces the verbose full settings tree (~190
+ * lines) with a compact `settings` summary. Use --verbose for the full tree.
+ */
+export interface InitConciseResult {
+    ok: boolean;
+    path: string;
+    id_prefix: string;
+    governance_preset: GovernancePreset;
+    telemetry: {
+        enabled: boolean;
+        capture_level: string;
+    };
+    output_format: string;
+    created_dirs_count: number;
+    created_dirs: string[];
+    warnings: string[];
+    wizard_used: boolean;
+    installed_packages?: InitInstalledPackagesSummary;
+    next_steps: string[];
+    agent_guidance: InitAgentGuidanceSummary;
+    hint: string;
 }
+export declare function summarizeInitResult(result: InitResult): InitConciseResult;
 export declare function runInit(prefixArg: string | undefined, global: GlobalOptions, options?: InitCommandOptions): Promise<InitResult>;

package/dist/cli/commands/init.js

@@ -1,3 +1,5 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e4370e86-cea8-5bf3-837b-de4b3c51daa1")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import readline from "node:readline/promises";
@@ -11,6 +13,29 @@ import { EXIT_CODE, GOVERNANCE_PRESET_DEFAULTS, PM_REQUIRED_SUBDIRS, SETTINGS_DE
 import { PmCliError } from "../../core/shared/errors.js";
 import { resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings, writeSettings } from "../../core/store/settings.js";
+import { runExtension } from "./extension.js";
+import { INIT_AGENT_GUIDANCE_MODE_VALUES, runInitAgentGuidance, } from "./init-agent-guidance.js";
+export function summarizeInitResult(result) {
+    return {
+        ok: result.ok,
+        path: result.path,
+        id_prefix: result.settings.id_prefix,
+        governance_preset: result.governance_preset,
+        telemetry: {
+            enabled: result.settings.telemetry.enabled,
+            capture_level: result.settings.telemetry.capture_level,
+        },
+        output_format: result.settings.output.default_format,
+        created_dirs_count: result.created_dirs.length,
+        created_dirs: result.created_dirs,
+        warnings: result.warnings,
+        wizard_used: result.wizard_used,
+        ...(result.installed_packages ? { installed_packages: result.installed_packages } : {}),
+        next_steps: result.next_steps,
+        agent_guidance: result.agent_guidance,
+        hint: "Re-run with --verbose for the full settings tree.",
+    };
+}
 function cloneDefaults() {
     return structuredClone(SETTINGS_DEFAULTS);
 }
@@ -41,6 +66,19 @@ function normalizeOptionalInitAuthor(rawValue) {
     }
     return normalized;
 }
+function normalizeInitAgentGuidanceMode(rawValue) {
+    if (rawValue === undefined) {
+        return "ask";
+    }
+    const normalized = rawValue.trim().toLowerCase().replaceAll("-", "_");
+    if (normalized.length === 0) {
+        throw new PmCliError("--agent-guidance must not be empty", EXIT_CODE.USAGE);
+    }
+    if (normalized === "ask" || normalized === "add" || normalized === "skip" || normalized === "status") {
+        return normalized;
+    }
+    throw new PmCliError(`Invalid --agent-guidance value "${rawValue}". Allowed: ${INIT_AGENT_GUIDANCE_MODE_VALUES.join(", ")}`, EXIT_CODE.USAGE);
+}
 function parseYesNoChoice(answer, currentDefault) {
     const normalized = answer.trim().toLowerCase();
     if (normalized.length === 0) {
@@ -63,6 +101,19 @@ function applyGovernancePreset(settings, preset) {
     settings.validation.parent_reference = knobs.parent_reference;
     settings.validation.metadata_profile = knobs.metadata_profile;
 }
+function summarizeInstalledPackages(result) {
+    const details = result.details;
+    return {
+        installed_all: details.installed_all === true,
+        installed_count: typeof details.installed_count === "number" ? details.installed_count : 0,
+        packages: Array.isArray(details.packages)
+            ? details.packages.map((entry) => ({
+                alias: typeof entry.alias === "string" ? entry.alias : "",
+                ok: entry.ok === true,
+            }))
+            : [],
+    };
+}
 async function runInitWizard(initialPrefix, telemetryDefault) {
     const rl = readline.createInterface({ input, output });
     try {
@@ -122,6 +173,8 @@ export async function runInit(prefixArg, global, options = {}) {
     const presetFromOption = normalizeInitGovernancePreset(options.preset);
     const useDefaults = options.defaults === true;
     const authorFromOption = normalizeOptionalInitAuthor(options.author);
+    const installBundledPackages = options.withPackages === true;
+    const agentGuidanceMode = normalizeInitAgentGuidanceMode(options.agentGuidance);
     let chosenPreset = presetFromOption;
     let chosenTelemetryEnabled;
     let settings;
@@ -169,6 +222,17 @@ export async function runInit(prefixArg, global, options = {}) {
         }
         await writeSettings(pmRoot, settings);
     }
+    const agentGuidanceResult = await runInitAgentGuidance({
+        pm_root: pmRoot,
+        cwd,
+        mode: agentGuidanceMode,
+        interactive: process.stdin.isTTY === true && process.stdout.isTTY === true,
+        settings,
+    });
+    warnings.push(...agentGuidanceResult.warnings);
+    if (agentGuidanceResult.settings_changed) {
+        await writeSettings(pmRoot, settings);
+    }
     const runtimeSchemaScaffold = await ensureRuntimeSchemaFileScaffold(pmRoot, settings.schema);
     for (const createdPath of runtimeSchemaScaffold.created_paths) {
         createdDirs.push(createdPath);
@@ -198,6 +262,33 @@ export async function runInit(prefixArg, global, options = {}) {
             op: "init:ensure_dir",
         })));
     }
+    let installedPackages;
+    if (installBundledPackages) {
+        const packageInstallResult = await runExtension("all", { install: true, project: true }, global);
+        warnings.push(...packageInstallResult.warnings);
+        installedPackages = summarizeInstalledPackages(packageInstallResult);
+        if (!installedPackages.installed_all || installedPackages.packages.some((entry) => !entry.ok)) {
+            throw new PmCliError("pm init --with-packages did not install all bundled packages successfully.", EXIT_CODE.GENERIC_FAILURE);
+        }
+    }
+    const nextSteps = [
+        'Create your first item: pm create --type Task --title "<title>"',
+        'List active items: pm list',
+        'Get agent-friendly project context: pm context',
+    ];
+    if (!installBundledPackages) {
+        nextSteps.push("Add optional packages for richer workflows: pm install calendar --project, pm install templates --project, pm install guide-shell --project");
+        nextSteps.push("Or install everything bundled: pm init --with-packages (idempotent on re-run)");
+    }
+    else {
+        nextSteps.push("Explore newly-available commands: pm cal, pm templates, pm guide");
+    }
+    nextSteps.push("Set PM_AUTHOR=<your-agent-id> so mutations attribute to the right caller.");
+    for (const guidanceNextStep of agentGuidanceResult.next_steps) {
+        if (!nextSteps.includes(guidanceNextStep)) {
+            nextSteps.push(guidanceNextStep);
+        }
+    }
     return {
         ok: true,
         path: pmRoot,
@@ -206,6 +297,10 @@ export async function runInit(prefixArg, global, options = {}) {
         warnings,
         governance_preset: settings.governance.preset,
         wizard_used: wizardUsed,
+        ...(installedPackages ? { installed_packages: installedPackages } : {}),
+        next_steps: nextSteps,
+        agent_guidance: agentGuidanceResult.summary,
     };
 }
-//# sourceMappingURL=init.js.map
+//# sourceMappingURL=init.js.map
+//# debugId=e4370e86-cea8-5bf3-837b-de4b3c51daa1