@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/init-agent-guidance.js

@@ -1,497 +1,3 @@
-/**
- * @module sdk/init-agent-guidance
- *
- * Implements the pm init agent guidance command surface and its agent-facing runtime behavior.
- */
-
-!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]="542cd5ac-e4a7-51fe-8521-d0bacd9e6a07")}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, writeFileAtomic } from "../core/fs/fs-utils.js";
-/** Supported values accepted by the init agent guidance mode contract. */
-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 -->";
-const AGENT_GUIDANCE_ADD_LATER_HINT = "Add workflow guidance later: pm init --agent-guidance add";
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    toPortableRelativePath,
-    ensureTrailingNewline,
-    detectLineEnding,
-    findGuidanceBlockRange,
-    buildAgentGuidanceBlock,
-    upsertAgentGuidanceBlock,
-    resolveProjectRoot,
-    resolveTargetGuidancePath,
-    parsePromptChoice,
-    pushUnique,
-    promptForGuidanceWrite,
-    normalizeAgentGuidanceState,
-    applyAgentGuidanceState,
-    writeGuidanceFile,
-    setAgentGuidanceReadlineFactoryForTests,
-};
-let createAgentGuidanceReadlineInterface = () => readline.createInterface({ input, output });
-function setAgentGuidanceReadlineFactoryForTests(factory) {
-    createAgentGuidanceReadlineInterface =
-        factory ?? (() => readline.createInterface({ input, output }));
-}
-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, projectTestCommand = "<your project test command>") {
-    const lines = [
-        AGENT_GUIDANCE_START_MARKER,
-        "## pm Workflow (Agent Quickstart)",
-        "",
-        '- Cold start with the measured canonical orientation: `pm context --limit 10 --for orient`; before item mutation, also run `pm search "<keywords>" --limit 10`, `pm list --status open --limit 20`, and `pm list --status in_progress --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="${projectTestCommand}"\`.`,
-        '- Verify and close: `pm test <id> --run --progress`, then atomically record closure evidence with `pm close <id> "<reason>" --resolution "<what changed>" --expected "<expected outcome>" --actual "<observed outcome>" --validate-close warn`, then `pm release <id>`.',
-        "- Author identity is automatic for supported agent harnesses; use `--author` only for an explicit override.",
-        "",
-        AGENT_GUIDANCE_END_MARKER,
-        "",
-    ];
-    return lines.join(lineEnding);
-}
-function upsertAgentGuidanceBlock(existingContent, projectTestCommand = "<your project test command>") {
-    const lineEnding = detectLineEnding(existingContent);
-    const nextBlock = buildAgentGuidanceBlock(lineEnding, projectTestCommand);
-    const existingRange = findGuidanceBlockRange(existingContent);
-    if (existingRange) {
-        const trailingContent = existingContent.slice(existingRange.end_index);
-        const normalizedTrailingContent = trailingContent.startsWith("\r\n")
-            ? trailingContent.slice(2)
-            : trailingContent.startsWith("\n")
-                ? trailingContent.slice(1)
-                : trailingContent;
-        const nextContent = ensureTrailingNewline(`${existingContent.slice(0, existingRange.start_index)}${nextBlock}${normalizedTrailingContent}`);
-        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,
-    };
-}
-/** Resolve an executable linked-test command from a target repository's own files. */
-export async function resolveProjectTestCommand(projectRoot) {
-    if (await pathExists(path.join(projectRoot, "scripts", "run-tests.mjs"))) {
-        return "node scripts/run-tests.mjs test";
-    }
-    let packageDocument;
-    try {
-        packageDocument = JSON.parse(await fs.readFile(path.join(projectRoot, "package.json"), "utf8"));
-    }
-    catch {
-        return "<your project test command>";
-    }
-    const manifest = normalizeProjectPackageManifest(packageDocument);
-    if (manifest === undefined) {
-        return "<your project test command>";
-    }
-    const packageManager = manifest.packageManager?.split("@")[0];
-    if (packageManager === "pnpm") {
-        return "pnpm test";
-    }
-    if (packageManager === "bun") {
-        return "bun run test";
-    }
-    if (packageManager === "yarn") {
-        return "yarn test";
-    }
-    if (packageManager === "npm")
-        return "npm test";
-    if (await pathExists(path.join(projectRoot, "pnpm-lock.yaml"))) {
-        return "pnpm test";
-    }
-    if ((await pathExists(path.join(projectRoot, "bun.lock"))) ||
-        (await pathExists(path.join(projectRoot, "bun.lockb")))) {
-        return "bun run test";
-    }
-    if (await pathExists(path.join(projectRoot, "yarn.lock")))
-        return "yarn test";
-    return "npm test";
-}
-/** Validate the minimal package manifest shape needed for executable test guidance. */
-function normalizeProjectPackageManifest(value) {
-    if (typeof value !== "object" || value === null || !("scripts" in value)) {
-        return undefined;
-    }
-    const scripts = value.scripts;
-    if (typeof scripts !== "object" ||
-        scripts === null ||
-        !("test" in scripts) ||
-        typeof scripts.test !== "string" ||
-        scripts.test.trim().length === 0) {
-        return undefined;
-    }
-    return {
-        scripts: { test: scripts.test },
-        ...("packageManager" in value && typeof value.packageManager === "string"
-            ? { packageManager: value.packageManager }
-            : {}),
-    };
-}
-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 = createAgentGuidanceReadlineInterface();
-    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, projectRoot = path.dirname(filePath)) {
-    const exists = await pathExists(filePath);
-    const currentContent = exists ? await fs.readFile(filePath, "utf8") : "";
-    const nextContent = upsertAgentGuidanceBlock(currentContent, await resolveProjectTestCommand(projectRoot));
-    if (!nextContent.changed) {
-        return { changed: false, warnings: [] };
-    }
-    await writeFileAtomic(filePath, nextContent.next_content);
-    return {
-        changed: true,
-        warnings: await runActiveOnWriteHooks({
-            path: filePath,
-            scope: "project",
-            op: "init:agent_guidance_file",
-        }),
-    };
-}
-function buildInitAgentGuidanceSummary(params) {
-    return {
-        mode: params.mode,
-        present: params.scans.some((entry) => entry.has_guidance),
-        prompted: params.prompted,
-        applied: params.applied,
-        skipped: params.skipped,
-        declined: params.state.declined,
-        prompt_completed: params.state.prompt_completed,
-        template_version: params.state.template_version,
-        target_file: params.targetRelativePath,
-        checked_files: params.scans.map((entry) => toPortableRelativePath(params.projectRoot, entry.file_path)),
-        files_with_guidance: params.scans
-            .filter((entry) => entry.has_guidance)
-            .map((entry) => toPortableRelativePath(params.projectRoot, entry.file_path)),
-        missing_files: params.scans
-            .filter((entry) => !entry.exists)
-            .map((entry) => toPortableRelativePath(params.projectRoot, entry.file_path)),
-    };
-}
-async function refreshGuidanceScansAfterApply(applied, scans, projectRoot) {
-    return applied ? await scanGuidanceFiles(projectRoot) : scans;
-}
-function markAgentGuidanceRunState(flow, checkedFiles, partial) {
-    flow.state = {
-        ...flow.state,
-        ...partial,
-        template_version: AGENT_GUIDANCE_TEMPLATE_VERSION,
-        last_checked_files: checkedFiles,
-    };
-}
-async function addAgentGuidanceBlockIfMissing(flow, context) {
-    if (context.presentBefore) {
-        return;
-    }
-    const writeResult = await writeGuidanceFile(context.targetPath, context.projectRoot);
-    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 || 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: false,
-            declined_at: "",
-        });
-    }
-}
-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: "",
-        });
-        return;
-    }
-    flow.skipped = true;
-    markAgentGuidanceRunState(flow, context.checkedFiles, {
-        prompt_completed: true,
-        declined: true,
-        declined_at: 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;
-    }
-    handleNonInteractiveMissingAgentGuidance(flow);
-    return flow;
-}
-/** Implements run init agent guidance for the public runtime surface of this module. */
-export 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,
-        projectRoot,
-    });
-    const stateUpdate = applyAgentGuidanceState(options.settings, flow.state);
-    scans = await refreshGuidanceScansAfterApply(flow.applied, scans, projectRoot);
-    const summary = buildInitAgentGuidanceSummary({
-        mode: options.mode,
-        scans,
-        projectRoot,
-        targetRelativePath,
-        prompted: flow.prompted,
-        applied: flow.applied,
-        skipped: flow.skipped,
-        state: flow.state,
-    });
-    return {
-        summary,
-        warnings: flow.warnings,
-        next_steps: flow.nextSteps,
-        settings_changed: stateUpdate.changed,
-    };
-}
+!(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]="e5ae3e66-4a45-5c62-9144-46f8f5bff7cf")}catch(e2){}})();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,writeFileAtomic}from"../core/fs/fs-utils.js";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 -->";const AGENT_GUIDANCE_ADD_LATER_HINT="Add workflow guidance later: pm init --agent-guidance add";const _testOnly={toPortableRelativePath,ensureTrailingNewline,detectLineEnding,findGuidanceBlockRange,buildAgentGuidanceBlock,upsertAgentGuidanceBlock,resolveProjectRoot,resolveTargetGuidancePath,parsePromptChoice,pushUnique,promptForGuidanceWrite,normalizeAgentGuidanceState,applyAgentGuidanceState,writeGuidanceFile,setAgentGuidanceReadlineFactoryForTests};let createAgentGuidanceReadlineInterface=()=>readline.createInterface({input,output});function setAgentGuidanceReadlineFactoryForTests(factory){createAgentGuidanceReadlineInterface=factory??(()=>readline.createInterface({input,output}))}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}
+`}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,projectTestCommand="<your project test command>"){const lines=[AGENT_GUIDANCE_START_MARKER,"## pm Workflow (Agent Quickstart)","",'- Cold start with the measured canonical orientation: `pm context --limit 10 --for orient`; before item mutation, also run `pm search "<keywords>" --limit 10`, `pm list --status open --limit 20`, and `pm list --status in_progress --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="${projectTestCommand}"\`.`,'- Verify and close: `pm test <id> --run --progress`, then atomically record closure evidence with `pm close <id> "<reason>" --resolution "<what changed>" --expected "<expected outcome>" --actual "<observed outcome>" --validate-close warn`, then `pm release <id>`.',"- Author identity is automatic for supported agent harnesses; use `--author` only for an explicit override.","",AGENT_GUIDANCE_END_MARKER,""];return lines.join(lineEnding)}function upsertAgentGuidanceBlock(existingContent,projectTestCommand="<your project test command>"){const lineEnding=detectLineEnding(existingContent);const nextBlock=buildAgentGuidanceBlock(lineEnding,projectTestCommand);const existingRange=findGuidanceBlockRange(existingContent);if(existingRange){const trailingContent=existingContent.slice(existingRange.end_index);const normalizedTrailingContent=trailingContent.startsWith("\r\n")?trailingContent.slice(2):trailingContent.startsWith("\n")?trailingContent.slice(1):trailingContent;const nextContent2=ensureTrailingNewline(`${existingContent.slice(0,existingRange.start_index)}${nextBlock}${normalizedTrailingContent}`);return{next_content:nextContent2,changed:nextContent2!==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}}async function resolveProjectTestCommand(projectRoot){if(await pathExists(path.join(projectRoot,"scripts","run-tests.mjs"))){return"node scripts/run-tests.mjs test"}let packageDocument;try{packageDocument=JSON.parse(await fs.readFile(path.join(projectRoot,"package.json"),"utf8"))}catch{return"<your project test command>"}const manifest=normalizeProjectPackageManifest(packageDocument);if(manifest===void 0){return"<your project test command>"}const packageManager=manifest.packageManager?.split("@")[0];if(packageManager==="pnpm"){return"pnpm test"}if(packageManager==="bun"){return"bun run test"}if(packageManager==="yarn"){return"yarn test"}if(packageManager==="npm")return"npm test";if(await pathExists(path.join(projectRoot,"pnpm-lock.yaml"))){return"pnpm test"}if(await pathExists(path.join(projectRoot,"bun.lock"))||await pathExists(path.join(projectRoot,"bun.lockb"))){return"bun run test"}if(await pathExists(path.join(projectRoot,"yarn.lock")))return"yarn test";return"npm test"}function normalizeProjectPackageManifest(value){if(typeof value!=="object"||value===null||!("scripts"in value)){return void 0}const scripts=value.scripts;if(typeof scripts!=="object"||scripts===null||!("test"in scripts)||typeof scripts.test!=="string"||scripts.test.trim().length===0){return void 0}return{scripts:{test:scripts.test},..."packageManager"in value&&typeof value.packageManager==="string"?{packageManager:value.packageManager}:{}}}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=createAgentGuidanceReadlineInterface();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,projectRoot=path.dirname(filePath)){const exists=await pathExists(filePath);const currentContent=exists?await fs.readFile(filePath,"utf8"):"";const nextContent=upsertAgentGuidanceBlock(currentContent,await resolveProjectTestCommand(projectRoot));if(!nextContent.changed){return{changed:false,warnings:[]}}await writeFileAtomic(filePath,nextContent.next_content);return{changed:true,warnings:await runActiveOnWriteHooks({path:filePath,scope:"project",op:"init:agent_guidance_file"})}}function buildInitAgentGuidanceSummary(params){return{mode:params.mode,present:params.scans.some(entry=>entry.has_guidance),prompted:params.prompted,applied:params.applied,skipped:params.skipped,declined:params.state.declined,prompt_completed:params.state.prompt_completed,template_version:params.state.template_version,target_file:params.targetRelativePath,checked_files:params.scans.map(entry=>toPortableRelativePath(params.projectRoot,entry.file_path)),files_with_guidance:params.scans.filter(entry=>entry.has_guidance).map(entry=>toPortableRelativePath(params.projectRoot,entry.file_path)),missing_files:params.scans.filter(entry=>!entry.exists).map(entry=>toPortableRelativePath(params.projectRoot,entry.file_path))}}async function refreshGuidanceScansAfterApply(applied,scans,projectRoot){return applied?await scanGuidanceFiles(projectRoot):scans}function markAgentGuidanceRunState(flow,checkedFiles,partial){flow.state={...flow.state,...partial,template_version:AGENT_GUIDANCE_TEMPLATE_VERSION,last_checked_files:checkedFiles}}async function addAgentGuidanceBlockIfMissing(flow,context){if(context.presentBefore){return}const writeResult=await writeGuidanceFile(context.targetPath,context.projectRoot);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||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:false,declined_at:""})}}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:""});return}flow.skipped=true;markAgentGuidanceRunState(flow,context.checkedFiles,{prompt_completed:true,declined:true,declined_at: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}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,projectRoot});const stateUpdate=applyAgentGuidanceState(options.settings,flow.state);scans=await refreshGuidanceScansAfterApply(flow.applied,scans,projectRoot);const summary=buildInitAgentGuidanceSummary({mode:options.mode,scans,projectRoot,targetRelativePath,prompted:flow.prompted,applied:flow.applied,skipped:flow.skipped,state:flow.state});return{summary,warnings:flow.warnings,next_steps:flow.nextSteps,settings_changed:stateUpdate.changed}}export{INIT_AGENT_GUIDANCE_MODE_VALUES,_testOnly,resolveProjectTestCommand,runInitAgentGuidance};
 //# sourceMappingURL=init-agent-guidance.js.map
-//# debugId=542cd5ac-e4a7-51fe-8521-d0bacd9e6a07