@difflab/pi 0.7.1 → 0.8.0

package/dist/index.d.ts

@@ -6,7 +6,6 @@ export { checkConventionalSubject, CONVENTIONAL_COMMIT, runMiseGates } from './g
 export { assertReviewEventSupported, createLocalReviewBackend, createRemoteReviewBackend, githubReviewSubmissionEndpoint, hasGitlabDraftNotes, parseGitlabDiffRefs, } from './review';
 export { mcp } from './mcp';
 export { mise } from './extensions/misex';
-export { createModeController, discoverAgentModes, resolveAgentMode } from './modes';
 export { pi } from './pi';
 export { loadReviewPublicationState, reviewBodyFingerprint, reviewCommentFingerprint, reviewReplyFingerprint, saveReviewPublicationState, unpublishedReviewComments, } from './review';
 export { computeProjectSlug, ensureStore, plansDir, reviewsDir, sessionsDir, storeDir, storeGlobalRoot } from './store';
@@ -17,7 +16,6 @@ export { dedupeFindings, findingSchema, findingsSchema, yymmdd, localReviewAutho
 export { ensureMcpAdapters, ensureMise, ensureMiseDeps, ensureMiseHooks, ensurePiAgents, ensurePiPlugins, ensurePiSkills, setupPi, } from './setup';
 export { loadTemplate, renderTemplate, templateRelativePath } from './templates';
 export type { DiffpiAgentConfig, DiffpiConfig, DiffpiConfigPaths, LoadedDiffpiConfig } from './config';
-export type { AgentMode, ModeCatalog, ModeController, ModeListOptions, ModePromptStrategy, ModeSelectionResult, ModeThinkingLevel, } from './modes';
 export type { CommandResult } from './extensions/processx';
 export type { ForgeProvider, Ide, LaunchOptions, LaunchResult, Mux, VcsInfo } from './environment';
 export type { Forge, OpenPrOptions, PrRef, VcsBackend } from './vcs';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,15 +15,6 @@ var zx = {
 
 // src/fsx.ts
 import { readdir, readFile } from "node:fs/promises";
-async function readDirectoryIfExists(path) {
-  try {
-    return await readdir(path, { withFileTypes: true });
-  } catch (error) {
-    if (isMissingPath(error))
-      return [];
-    throw error;
-  }
-}
 async function readTextIfExists(path) {
   try {
     return await readFile(path, "utf8");
@@ -2108,361 +2099,10 @@ async function getOptionalFile2(path) {
 function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
-// src/modes.ts
-import {
-  getAgentDir,
-  parseFrontmatter as parseFrontmatter2
-} from "@earendil-works/pi-coding-agent";
-import { readFile as readFile9 } from "node:fs/promises";
-import { homedir as homedir6 } from "node:os";
-import { basename as basename4, extname, join as join11 } from "node:path";
-async function discoverAgentModes(options) {
-  const agentDir = options.agentDir ?? getAgentDir();
-  const homeDir = options.homeDir ?? homedir6();
-  const modes = new Map;
-  const diagnostics = [];
-  await loadAgentModes(options.bundledAgentsDir ?? BUNDLED_AGENTS_DIR, "diffpi agent", modes, diagnostics);
-  await loadAgentModes(join11(agentDir, "agents"), "user agent", modes, diagnostics);
-  if (options.includeSkills) {
-    await loadSkillModes(join11(homeDir, ".agents", "skills"), "user skill", modes, diagnostics);
-    await loadSkillModes(join11(agentDir, "skills"), "pi user skill", modes, diagnostics);
-  }
-  if (options.projectTrusted === true) {
-    if (options.includeSkills) {
-      await loadSkillModes(join11(options.cwd, ".agents", "skills"), "project skill", modes, diagnostics);
-      await loadSkillModes(join11(options.cwd, ".pi", "skills"), "pi project skill", modes, diagnostics);
-    }
-    await loadAgentModes(join11(options.cwd, ".agents", "agents"), "project agent", modes, diagnostics);
-    await loadAgentModes(join11(options.cwd, ".pi", "agents"), "pi project agent", modes, diagnostics);
-  }
-  const userConfig = await loadDiffpiConfig({ homeDir });
-  const configuredModes = [...modes.values()].map((mode) => ({
-    ...mode,
-    modelPreferences: resolveAgentModelPreferences(mode.id, mode.modelPreferences, userConfig.config)
-  }));
-  return {
-    modes: configuredModes.sort((left, right) => left.id.localeCompare(right.id)),
-    diagnostics
-  };
-}
-function resolveAgentMode(modes, requested) {
-  const name = requested.trim();
-  if (!name)
-    return { ok: false, message: "Agent name is required." };
-  const exact = modes.find((mode) => mode.id === name);
-  if (exact)
-    return { ok: true, active: exact, message: `Active inline agent: ${exact.id}.` };
-  const lowerName = name.toLowerCase();
-  const matches = modes.filter((mode) => mode.id.toLowerCase() === lowerName);
-  if (matches.length === 1) {
-    const active = matches[0];
-    return { ok: true, active, message: `Active inline agent: ${active.id}.` };
-  }
-  if (matches.length > 1) {
-    return {
-      ok: false,
-      message: `Inline agent "${name}" is ambiguous. Use one of: ${matches.map((mode) => mode.id).join(", ")}.`
-    };
-  }
-  return { ok: false, message: `Unknown inline agent "${name}". Run /skill:mode or diffpi_modes_list.` };
-}
-function createModeController(pi, options = {}) {
-  let active;
-  let baseline;
-  const updateStatus = (ctx) => {
-    const model = ctx.model ? ` · ${ctx.model.provider}/${ctx.model.id}` : "";
-    const label = active?.label.toUpperCase() ?? "DEFAULT";
-    const badge = `AGENT ${label}${model}`;
-    ctx.ui.setStatus(MODE_STATUS_KEY, undefined);
-    ctx.ui.setWidget?.(MODE_WIDGET_KEY, [badge], { placement: "belowEditor" });
-  };
-  const list = (ctx, listOptions = {}) => discoverAgentModes({
-    cwd: ctx.cwd,
-    agentDir: options.agentDir,
-    bundledAgentsDir: options.bundledAgentsDir,
-    homeDir: options.homeDir,
-    projectTrusted: ctx.isProjectTrusted(),
-    includeSkills: listOptions.includeSkills
-  });
-  return {
-    list,
-    async set(agent, ctx) {
-      const catalog = await list(ctx, { includeSkills: agent.includes(":") });
-      const result = resolveAgentMode(catalog.modes, agent);
-      if (!result.ok || !result.active)
-        return result;
-      const previousActive = active;
-      const previousBaseline = baseline;
-      baseline ??= captureRuntime(pi, ctx);
-      if (active && baseline)
-        await restoreRuntime(pi, baseline, ctx);
-      active = result.active;
-      try {
-        const runtimeMessage = await applyModeRuntime(pi, active, ctx);
-        pi.appendEntry(MODE_STATE_ENTRY, { active, baseline });
-        updateStatus(ctx);
-        return { ...result, message: `${result.message} ${runtimeMessage}` };
-      } catch (error) {
-        await restoreRuntime(pi, baseline, ctx);
-        active = undefined;
-        baseline = undefined;
-        if (previousActive && previousBaseline) {
-          try {
-            active = previousActive;
-            baseline = previousBaseline;
-            await applyModeRuntime(pi, active, ctx);
-          } catch {
-            active = undefined;
-            baseline = undefined;
-          }
-        }
-        if (!active)
-          pi.appendEntry(MODE_STATE_ENTRY, { active: null });
-        updateStatus(ctx);
-        return { ok: false, message: error instanceof Error ? error.message : String(error) };
-      }
-    },
-    async unset(ctx) {
-      if (!active)
-        return { ok: true, message: "Inline agent is already clear." };
-      if (baseline)
-        await restoreRuntime(pi, baseline, ctx);
-      active = undefined;
-      pi.appendEntry(MODE_STATE_ENTRY, { active: null });
-      baseline = undefined;
-      updateStatus(ctx);
-      return { ok: true, message: "Inline agent cleared. The previous model, thinking, tools, and prompt resume." };
-    },
-    async restore(ctx) {
-      const previousActive = active;
-      const previousBaseline = baseline;
-      const entry = [...ctx.sessionManager.getBranch()].reverse().find((candidate) => candidate.type === "custom" && candidate.customType === MODE_STATE_ENTRY);
-      const restored = entry?.data?.active;
-      const restoredBaseline = entry?.data?.baseline;
-      if (isAgentModeSnapshot(restored)) {
-        const catalog = await list(ctx, { includeSkills: restored.id.includes(":") });
-        const current = catalog.modes.find((mode) => mode.id === restored.id);
-        active = current ?? normalizeAgentModeSnapshot(restored);
-        baseline = isModeBaseline(restoredBaseline) ? restoredBaseline : previousBaseline;
-        try {
-          await applyModeRuntime(pi, active, ctx);
-        } catch (error) {
-          const fallbackBaseline = previousBaseline ?? (isModeBaseline(restoredBaseline) ? restoredBaseline : undefined);
-          if (fallbackBaseline)
-            await restoreRuntime(pi, fallbackBaseline, ctx);
-          active = undefined;
-          baseline = undefined;
-          throw error;
-        }
-      } else {
-        if (previousActive && previousBaseline)
-          pi.setActiveTools(previousBaseline.tools);
-        active = undefined;
-        baseline = undefined;
-      }
-      updateStatus(ctx);
-    },
-    refresh(ctx) {
-      updateStatus(ctx);
-    },
-    apply(systemPrompt) {
-      if (!active)
-        return systemPrompt;
-      if (active.promptStrategy === "replace")
-        return active.systemPrompt;
-      return `${systemPrompt}
-
-## Active inline agent: ${active.label}
-
-${active.systemPrompt}`;
-    },
-    getActive() {
-      return active;
-    },
-    getStatus(ctx) {
-      return {
-        active: active?.id,
-        model: ctx.model ? { provider: ctx.model.provider, id: ctx.model.id } : undefined,
-        thinkingLevel: pi.getThinkingLevel(),
-        activeTools: pi.getActiveTools(),
-        capabilityError: active ? validateModeRuntime(pi, active, ctx) : undefined
-      };
-    }
-  };
-}
-var MODE_STATE_ENTRY = "diffpi-mode-state";
-var MODE_STATUS_KEY = "diffpi-mode";
-var MODE_WIDGET_KEY = "diffpi-mode-badge";
-var MODE_CONTROL_TOOLS = [
-  "ask_user_question",
-  "diffpi_modes_list",
-  "diffpi_modes_set",
-  "diffpi_modes_unset",
-  "diffpi_modes_status"
-];
-var BUNDLED_AGENTS_DIR = resolveBundledAgentsDir();
-var THINKING_LEVELS = new Set(["off", "minimal", "low", "medium", "high", "xhigh", "max"]);
-async function applyModeRuntime(pi, mode, ctx) {
-  let selectedModel;
-  if (mode.modelPreferences.length > 0) {
-    const scoped = ctx.scopedModels.length > 0 ? ctx.scopedModels.map((entry) => entry.model) : undefined;
-    const availableModels = scoped ?? ctx.modelRegistry.getAvailable();
-    for (const preference of mode.modelPreferences) {
-      const model = findPreferredModel(availableModels, preference);
-      if (model && await pi.setModel(model)) {
-        selectedModel = `${model.provider}/${model.id}`;
-        break;
-      }
-    }
-  }
-  if (mode.thinkingLevel)
-    pi.setThinkingLevel(mode.thinkingLevel);
-  if (mode.tools.length > 0) {
-    const availableTools = new Set(pi.getAllTools().map((tool) => tool.name));
-    const selectedTools = [...new Set([...mode.tools, ...MODE_CONTROL_TOOLS])].filter((tool) => availableTools.has(tool));
-    if (selectedTools.length > 0)
-      pi.setActiveTools(selectedTools);
-  }
-  const availableTools = new Set(pi.getAllTools().map((tool) => tool.name));
-  const unavailableTools = mode.requiredTools.filter((tool) => !availableTools.has(tool));
-  const activeTools = new Set(pi.getActiveTools());
-  const missingTools = mode.requiredTools.filter((tool) => !activeTools.has(tool));
-  const forbiddenTools = mode.forbiddenTools.filter((tool) => activeTools.has(tool));
-  if (unavailableTools.length > 0 || missingTools.length > 0 || forbiddenTools.length > 0)
-    throw new Error(`Profile preflight failed: missing required tools [${[...new Set([...unavailableTools, ...missingTools])].join(", ")}]${forbiddenTools.length > 0 ? `; forbidden tools active [${forbiddenTools.join(", ")}]` : ""}`);
-  if (mode.requireModel && !selectedModel)
-    throw new Error("Profile preflight failed: requested model was not selected.");
-  if (mode.requireThinking && (!mode.thinkingLevel || pi.getThinkingLevel() !== mode.thinkingLevel))
-    throw new Error(`Profile preflight failed: thinking level ${mode.thinkingLevel ?? "unset"} was not applied.`);
-  const parts = [];
-  if (mode.modelPreferences.length > 0) {
-    parts.push(selectedModel ? `Model: ${selectedModel}.` : "No preferred model was available; kept the current model.");
-  }
-  if (mode.thinkingLevel)
-    parts.push(`Thinking: ${mode.thinkingLevel}.`);
-  if (mode.tools.length > 0)
-    parts.push("Applied the profile tool set.");
-  return parts.join(" ") || "The profile changes the prompt only.";
-}
-function validateModeRuntime(pi, mode, ctx) {
-  const activeTools = new Set(pi.getActiveTools());
-  const missingTools = mode.requiredTools.filter((tool) => !activeTools.has(tool));
-  const forbiddenTools = mode.forbiddenTools.filter((tool) => activeTools.has(tool));
-  if (missingTools.length > 0 || forbiddenTools.length > 0)
-    return `Profile capability check failed: missing required tools [${missingTools.join(", ")}]${forbiddenTools.length > 0 ? `; forbidden tools active [${forbiddenTools.join(", ")}]` : ""}`;
-  if (mode.requireModel && mode.modelPreferences.length > 0) {
-    const actual = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "unset";
-    const available = ctx.scopedModels.length > 0 ? ctx.scopedModels.map((entry) => entry.model) : ctx.modelRegistry.getAvailable();
-    const expected = mode.modelPreferences.map((preference) => findPreferredModel(available, preference)).find(Boolean);
-    if (!expected || `${expected.provider}/${expected.id}` !== actual)
-      return `Profile capability check failed: requested model was not active (actual ${actual}).`;
-  }
-  if (mode.requireThinking && (!mode.thinkingLevel || pi.getThinkingLevel() !== mode.thinkingLevel))
-    return `Profile capability check failed: thinking level ${mode.thinkingLevel ?? "unset"} was not applied.`;
-  return;
-}
-async function restoreRuntime(pi, state, ctx) {
-  if (state.model) {
-    const model = ctx.modelRegistry.find(state.model.provider, state.model.id);
-    if (model)
-      await pi.setModel(model);
-  }
-  pi.setThinkingLevel(state.thinkingLevel);
-  pi.setActiveTools(state.tools);
-  const restoredTools = pi.getActiveTools();
-  if (state.tools.some((tool) => !restoredTools.includes(tool)))
-    throw new Error("Failed to restore the previous active tool set.");
-}
-function captureRuntime(pi, ctx) {
-  return {
-    model: ctx.model ? { provider: ctx.model.provider, id: ctx.model.id } : undefined,
-    thinkingLevel: pi.getThinkingLevel(),
-    tools: pi.getActiveTools()
-  };
-}
-async function loadSkillModes(skillsDir, source, modes, diagnostics) {
-  const entries = await readDirectoryIfExists(skillsDir);
-  for (const entry of entries.filter((item) => item.isDirectory()).sort((a, b) => a.name.localeCompare(b.name))) {
-    await loadAgentModes(join11(skillsDir, entry.name, "agents"), `${source} ${entry.name}`, modes, diagnostics, entry.name);
-  }
-}
-async function loadAgentModes(directory, source, modes, diagnostics, skillName) {
-  const entries = await readDirectoryIfExists(directory);
-  for (const entry of entries.filter((item) => item.isFile() && item.name.endsWith(".md")).sort((a, b) => a.name.localeCompare(b.name))) {
-    const path = join11(directory, entry.name);
-    try {
-      const content = await readFile9(path, "utf8");
-      const { frontmatter, body } = parseFrontmatter2(content.startsWith("\uFEFF") ? content.slice(1) : content);
-      if (frontmatter.enabled === false || frontmatter.inline === false)
-        continue;
-      const name = getFrontmatterText(frontmatter.name) ?? basename4(path, extname(path));
-      const systemPrompt = body.trim();
-      if (!name || name.includes(":") || !systemPrompt) {
-        diagnostics.push(`Skipped ${path}: agent name must not contain ":" and prompt body is required.`);
-        continue;
-      }
-      const id = skillName ? `${skillName}:${name}` : name;
-      modes.set(id, {
-        id,
-        label: getFrontmatterText(frontmatter.display_name) ?? name,
-        description: getFrontmatterText(frontmatter.description) ?? `Inline agent from ${basename4(path)}`,
-        systemPrompt,
-        promptStrategy: frontmatter.prompt_mode === "append" ? "append" : "replace",
-        modelPreferences: [
-          ...getFrontmatterList(frontmatter.model),
-          ...getFrontmatterList(frontmatter.model_fallbacks)
-        ],
-        thinkingLevel: getThinkingLevel(frontmatter.thinking),
-        requiredTools: getFrontmatterList(frontmatter.required_tools),
-        forbiddenTools: getFrontmatterList(frontmatter.forbidden_tools),
-        requireModel: frontmatter.required_model === true,
-        requireThinking: frontmatter.required_thinking === true,
-        tools: getFrontmatterList(frontmatter.tools),
-        source,
-        sourcePath: path
-      });
-    } catch (error) {
-      diagnostics.push(`Skipped ${path}: ${error instanceof Error ? error.message : String(error)}`);
-    }
-  }
-}
-function getFrontmatterText(value) {
-  return typeof value === "string" && value.trim() ? value.trim() : undefined;
-}
-function getFrontmatterList(value) {
-  const values = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : [];
-  return values.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
-}
-function getThinkingLevel(value) {
-  const level = getFrontmatterText(value);
-  return level && THINKING_LEVELS.has(level) ? level : undefined;
-}
-function normalizeAgentModeSnapshot(value) {
-  return {
-    ...value,
-    requiredTools: Array.isArray(value.requiredTools) ? value.requiredTools : [],
-    forbiddenTools: Array.isArray(value.forbiddenTools) ? value.forbiddenTools : [],
-    requireModel: value.requireModel === true,
-    requireThinking: value.requireThinking === true
-  };
-}
-function isAgentModeSnapshot(value) {
-  if (!value || typeof value !== "object")
-    return false;
-  const candidate = value;
-  return typeof candidate.id === "string" && typeof candidate.label === "string" && typeof candidate.description === "string" && typeof candidate.systemPrompt === "string" && (candidate.promptStrategy === "append" || candidate.promptStrategy === "replace") && Array.isArray(candidate.modelPreferences) && (candidate.thinkingLevel === undefined || THINKING_LEVELS.has(candidate.thinkingLevel)) && (candidate.requiredTools === undefined || Array.isArray(candidate.requiredTools)) && (candidate.forbiddenTools === undefined || Array.isArray(candidate.forbiddenTools)) && (candidate.requireModel === undefined || typeof candidate.requireModel === "boolean") && (candidate.requireThinking === undefined || typeof candidate.requireThinking === "boolean") && Array.isArray(candidate.tools) && typeof candidate.source === "string" && typeof candidate.sourcePath === "string";
-}
-function isModeBaseline(value) {
-  if (!value || typeof value !== "object")
-    return false;
-  const candidate = value;
-  const model = candidate.model;
-  return (model === undefined || typeof model.provider === "string" && typeof model.id === "string") && candidate.thinkingLevel !== undefined && THINKING_LEVELS.has(candidate.thinkingLevel) && Array.isArray(candidate.tools) && candidate.tools.every((tool) => typeof tool === "string");
-}
 // src/pi.ts
 import { mkdir as mkdir5, writeFile as writeFile6 } from "node:fs/promises";
-import { homedir as homedir7 } from "node:os";
-import { dirname as dirname6, join as join12 } from "node:path";
+import { homedir as homedir6 } from "node:os";
+import { dirname as dirname6, join as join11 } from "node:path";
 var pi = {
   executableCheck: findPiExecutable,
   packageList: listPiPackages,
@@ -2475,7 +2115,7 @@ var pi = {
   configEnsure: ensurePiConfig
 };
 async function ensurePiAgent(filename, content, agentDir = resolvePiAgentDir(), dryRun = false) {
-  const path = join12(agentDir, "agents", filename);
+  const path = join11(agentDir, "agents", filename);
   const currentText = await readTextIfExists(path);
   const changed = currentText !== content;
   if (changed && !dryRun) {
@@ -2484,10 +2124,10 @@ async function ensurePiAgent(filename, content, agentDir = resolvePiAgentDir(),
   }
   return { path, changed, existed: currentText !== undefined, planned: changed && dryRun };
 }
-async function checkGlobalPiSkill(name, agentDir = resolvePiAgentDir(), sharedSkillsDir = join12(homedir7(), ".agents", "skills")) {
-  const roots = [join12(agentDir, "skills"), sharedSkillsDir];
+async function checkGlobalPiSkill(name, agentDir = resolvePiAgentDir(), sharedSkillsDir = join11(homedir6(), ".agents", "skills")) {
+  const roots = [join11(agentDir, "skills"), sharedSkillsDir];
   for (const root of roots) {
-    if (await readTextIfExists(join12(root, name, "SKILL.md")) !== undefined)
+    if (await readTextIfExists(join11(root, name, "SKILL.md")) !== undefined)
       return true;
   }
   return false;
@@ -2536,8 +2176,8 @@ function hasPiPackage(listOutput, source) {
 async function installPiPackage(executable, source) {
   await runChecked(executable, ["install", source]);
 }
-function resolvePiAgentDir(homeDir = homedir7()) {
-  return process.env.PI_CODING_AGENT_DIR ?? (process.env.XDG_CONFIG_HOME ? join12(process.env.XDG_CONFIG_HOME, "pi") : join12(homeDir, ".pi", "agent"));
+function resolvePiAgentDir(homeDir = homedir6()) {
+  return process.env.PI_CODING_AGENT_DIR ?? (process.env.XDG_CONFIG_HOME ? join11(process.env.XDG_CONFIG_HOME, "pi") : join11(homeDir, ".pi", "agent"));
 }
 function parseJsonObject(content, path) {
   if (!content?.trim())
@@ -2550,27 +2190,27 @@ function parseJsonObject(content, path) {
   throw new Error(`Expected valid JSON object in ${path}.`);
 }
 // src/plan/verify.ts
-import { readFile as readFile10, readdir as readdir2, stat } from "node:fs/promises";
-import { basename as basename5, dirname as dirname7, join as join13, resolve as resolve4 } from "node:path";
+import { readFile as readFile9, readdir as readdir2, stat } from "node:fs/promises";
+import { basename as basename4, dirname as dirname7, join as join12, resolve as resolve4 } from "node:path";
 async function verifyLivePlan(requested, cwd = process.cwd()) {
   const path = resolve4(cwd, requested);
   let planPath = path;
   try {
     if ((await stat(path)).isDirectory())
-      planPath = join13(path, "PLAN.md");
+      planPath = join12(path, "PLAN.md");
   } catch {}
   const issues = [];
   const briefPaths = [];
   const planDir = dirname7(planPath);
-  if (basename5(planPath) !== "PLAN.md") {
+  if (basename4(planPath) !== "PLAN.md") {
     addIssue(issues, planPath, 0, "path", "Select PLAN.md or its directory.");
     return { planPath, briefPaths, ok: false, issues };
   }
-  if (!/^\d{6}(?:-[a-z0-9]+)+$/.test(basename5(planDir)) || basename5(dirname7(planDir)) !== "plan" || basename5(dirname7(dirname7(planDir))) !== ".diffpi")
+  if (!/^\d{6}(?:-[a-z0-9]+)+$/.test(basename4(planDir)) || basename4(dirname7(planDir)) !== "plan" || basename4(dirname7(dirname7(planDir))) !== ".diffpi")
     addIssue(issues, planPath, 0, "layout", "Place PLAN.md under .diffpi/plan/<YYMMDD[-ticket]-short-slug>/.");
   let source;
   try {
-    source = await readFile10(planPath, "utf8");
+    source = await readFile9(planPath, "utf8");
   } catch {
     addIssue(issues, planPath, 0, "missing-plan", "PLAN.md is not readable.");
     return { planPath, briefPaths, ok: false, issues };
@@ -2584,7 +2224,7 @@ async function verifyLivePlan(requested, cwd = process.cwd()) {
     if (!planLines[line]?.startsWith(`### Phase ${index + 1}: `))
       addIssue(issues, planPath, line + 1, "phase-order", "Number phase headings from 1 without gaps.");
   }
-  const implementation = join13(planDir, "implementation");
+  const implementation = join12(planDir, "implementation");
   let rootEntries = [];
   let briefEntries = [];
   try {
@@ -2593,18 +2233,18 @@ async function verifyLivePlan(requested, cwd = process.cwd()) {
   } catch {}
   for (const entry of rootEntries) {
     if (entry !== "PLAN.md" && entry !== "implementation")
-      addIssue(issues, join13(planDir, entry), 0, "layout", "Only PLAN.md and implementation/ belong in the plan directory.");
+      addIssue(issues, join12(planDir, entry), 0, "layout", "Only PLAN.md and implementation/ belong in the plan directory.");
   }
   for (const entry of briefEntries) {
     const ordinal = /^phase-(\d+)\.md$/.exec(entry)?.[1];
     if (!ordinal || !Number(ordinal) || Number(ordinal) > phases.length || entry !== `phase-${Number(ordinal)}.md`)
-      addIssue(issues, join13(implementation, entry), 0, "extra-brief", "Only matching numbered phase briefs belong in implementation/.");
+      addIssue(issues, join12(implementation, entry), 0, "extra-brief", "Only matching numbered phase briefs belong in implementation/.");
   }
   for (let index = 0;index < phases.length; index++) {
-    const brief = join13(implementation, `phase-${index + 1}.md`);
+    const brief = join12(implementation, `phase-${index + 1}.md`);
     briefPaths.push(brief);
     try {
-      const lines = visibleLines(await readFile10(brief, "utf8"));
+      const lines = visibleLines(await readFile9(brief, "utf8"));
       if (!/^# Phase \d+:\s*\S/.test(lines[0] ?? "") || !lines[0]?.startsWith(`# Phase ${index + 1}: `))
         addIssue(issues, brief, 1, "phase-title", `Start with # Phase ${index + 1}: <title>.`);
       checkHeadings(lines, brief, ["Objective", "Files Affected", "Tasks", "Implementation Constraints"], issues);
@@ -2636,10 +2276,10 @@ function checkHeadings(lines, file, names, issues) {
     addIssue(issues, file, found[0]?.line ?? 0, "headings", `Expected headings, in order: ${expected.join(", ")}.`);
 }
 // src/setup.ts
-import { parseFrontmatter as parseFrontmatter3 } from "@earendil-works/pi-coding-agent";
-import { readdir as readdir3, readFile as readFile11 } from "node:fs/promises";
-import { homedir as homedir8 } from "node:os";
-import { basename as basename6, join as join14 } from "node:path";
+import { parseFrontmatter as parseFrontmatter2 } from "@earendil-works/pi-coding-agent";
+import { readdir as readdir3, readFile as readFile10 } from "node:fs/promises";
+import { homedir as homedir7 } from "node:os";
+import { basename as basename5, join as join13 } from "node:path";
 var MISE_DEPENDENCIES = [
   { name: "node", tool: "node", spec: "node@22", minimumVersion: "22.19.0" },
   { name: "zellij", tool: "zellij", spec: "zellij@latest", minimumVersion: undefined },
@@ -2672,14 +2312,14 @@ var PI_SKILL_SOURCES = [
   { repository: "cloudvoyant/codevoyant", skills: ["git"] }
 ];
 var MCP_ADAPTER_PACKAGE = "npm:pi-mcp-adapter";
-var BUNDLED_AGENTS_DIR2 = resolveBundledAgentsDir();
+var BUNDLED_AGENTS_DIR = resolveBundledAgentsDir();
 var FORGE_DEPENDENCIES = {
   github: { name: "gh", tool: "gh", spec: "gh@latest", minimumVersion: undefined },
   gitlab: { name: "glab", tool: "glab", spec: "glab@latest", minimumVersion: undefined }
 };
 async function ensureMise(options = {}) {
-  const homeDir = options.homeDir ?? homedir8();
-  const current = await mise.executableCheck() ?? await mise.executableCheck(join14(homeDir, ".local", "bin", "mise"));
+  const homeDir = options.homeDir ?? homedir7();
+  const current = await mise.executableCheck() ?? await mise.executableCheck(join13(homeDir, ".local", "bin", "mise"));
   if (current)
     return { executable: current, action: createSetupAction("mise", "ready", current) };
   reportProgress(options, "Installing mise");
@@ -2728,9 +2368,9 @@ async function ensureMiseDeps(miseExecutable, options = {}) {
 async function ensurePiPlugins(options = {}) {
   const actions = await ensurePiPackages(PI_PACKAGES, options);
   const agentDir = options.agentDir ?? pi.agentDir(options.homeDir);
-  const webSearch = await pi.configEnsure(join14(agentDir, "web-search.json"), (config) => ({ ...config, workflow: "auto-summary" }), options.dryRun);
+  const webSearch = await pi.configEnsure(join13(agentDir, "web-search.json"), (config) => ({ ...config, workflow: "auto-summary" }), options.dryRun);
   actions.push(getConfigSetupAction("web search settings", webSearch));
-  const lsp = await pi.configEnsure(join14(agentDir, "pi-lsp.json"), (config) => ({
+  const lsp = await pi.configEnsure(join13(agentDir, "pi-lsp.json"), (config) => ({
     ...config,
     progressive: { ...getRecord(config.progressive), enabled: true, inject: "none" }
   }), options.dryRun);
@@ -2739,13 +2379,13 @@ async function ensurePiPlugins(options = {}) {
 }
 async function ensurePiAgents(options = {}) {
   const agentDir = options.agentDir ?? pi.agentDir(options.homeDir);
-  const bundledAgentsDir = options.bundledAgentsDir ?? BUNDLED_AGENTS_DIR2;
+  const bundledAgentsDir = options.bundledAgentsDir ?? BUNDLED_AGENTS_DIR;
   const userConfig = await loadDiffpiConfig({ homeDir: options.homeDir });
   const entries = (await readdir3(bundledAgentsDir, { withFileTypes: true })).filter((entry) => entry.isFile() && entry.name.startsWith("diffpi-") && entry.name.endsWith(".md")).sort((left, right) => left.name.localeCompare(right.name));
   const actions = [];
   for (const entry of entries) {
-    const id = basename6(entry.name, ".md").replace(/^diffpi-/, "");
-    const source = await readFile11(join14(bundledAgentsDir, entry.name), "utf8");
+    const id = basename5(entry.name, ".md").replace(/^diffpi-/, "");
+    const source = await readFile10(join13(bundledAgentsDir, entry.name), "utf8");
     const content = materializeAgentModels(source, id, userConfig.config, options.availableModels);
     const result = await pi.agentEnsure(entry.name, content, agentDir, options.dryRun);
     actions.push(getConfigSetupAction(`pi agent ${id}`, result));
@@ -2754,7 +2394,7 @@ async function ensurePiAgents(options = {}) {
 }
 async function ensurePiSkills(miseExecutable, options = {}) {
   const agentDir = options.agentDir ?? pi.agentDir(options.homeDir);
-  const sharedSkillsDir = join14(options.homeDir ?? homedir8(), ".agents", "skills");
+  const sharedSkillsDir = join13(options.homeDir ?? homedir7(), ".agents", "skills");
   const actions = [];
   for (const source of PI_SKILL_SOURCES) {
     const missing = [];
@@ -2870,7 +2510,7 @@ async function gitlabMcpHost(projectDir) {
   }
 }
 function materializeAgentModels(content, agentId, config, availableModels) {
-  const { frontmatter } = parseFrontmatter3(content.startsWith("\uFEFF") ? content.slice(1) : content);
+  const { frontmatter } = parseFrontmatter2(content.startsWith("\uFEFF") ? content.slice(1) : content);
   const profilePreferences = [...getTextList(frontmatter.model), ...getTextList(frontmatter.model_fallbacks)];
   const preferences = resolveAgentModelPreferences(agentId, profilePreferences, config);
   let selectedIndex = availableModels === undefined && preferences.length > 0 ? 0 : -1;
@@ -2950,7 +2590,7 @@ function reportProgress(options, message) {
   options.onProgress?.(message);
 }
 async function packageVersion2() {
-  const source = await readFile11(join14(resolveBundledAgentsDir(), "..", "package.json"), "utf8");
+  const source = await readFile10(join13(resolveBundledAgentsDir(), "..", "package.json"), "utf8");
   let value;
   try {
     value = JSON.parse(source);
@@ -2965,13 +2605,13 @@ function getRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 // src/templates.ts
-import { readFile as readFile12 } from "node:fs/promises";
-import { homedir as homedir9 } from "node:os";
-import { join as join15, normalize } from "node:path";
+import { readFile as readFile11 } from "node:fs/promises";
+import { homedir as homedir8 } from "node:os";
+import { join as join14, normalize } from "node:path";
 async function loadTemplate(name, options = {}) {
   const relative = templateRelativePath(name);
-  const userPath = join15(options.homeDir ?? homedir9(), ".difflab", "diffpi", "templates", relative);
-  const bundledPath = join15(options.bundledDir ?? resolveBundledTemplatesDir(), relative);
+  const userPath = join14(options.homeDir ?? homedir8(), ".difflab", "diffpi", "templates", relative);
+  const bundledPath = join14(options.bundledDir ?? resolveBundledTemplatesDir(), relative);
   const user = await readOptionalFile(userPath);
   if (user !== undefined)
     return { name, path: userPath, source: "user", content: user };
@@ -2992,7 +2632,7 @@ function templateRelativePath(name) {
 }
 async function readOptionalFile(path) {
   try {
-    return await readFile12(path, "utf8");
+    return await readFile11(path, "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return;
@@ -3015,7 +2655,6 @@ export {
   createForge,
   createForgeBackend,
   createLocalReviewBackend,
-  createModeController,
   createRemoteReviewBackend,
   createVcsBackend,
   dedupeFindings,
@@ -3025,7 +2664,6 @@ export {
   detectVcs,
   diffpiConfigPaths,
   diffpiLaunchName,
-  discoverAgentModes,
   ensureMcpAdapters,
   ensureMise,
   ensureMiseDeps,
@@ -3062,7 +2700,6 @@ export {
   renderReviewDoc,
   renderTemplate,
   renderThreadArtifact,
-  resolveAgentMode,
   resolveAgentModelPreferences,
   resolvePrSession,
   resolveReviewSession,

package/dist/tools/ci.d.ts

@@ -1,6 +1,6 @@
 import type { ToolDefinition } from '@earendil-works/pi-coding-agent';
 export declare const watchCiTool: ToolDefinition<import("typebox").TSchema, {
-    status: "passed" | "failed" | "skipped";
+    status: "skipped" | "passed" | "failed";
     detail: string;
 }, any> & ToolDefinition<any, any, any>;
 //# sourceMappingURL=ci.d.ts.map

package/dist/tools/doctor.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from '@earendil-works/pi-coding-agent';
+export declare const diffpiDoctorTool: ToolDefinition;
+//# sourceMappingURL=doctor.d.ts.map