mancode 0.3.10 → 0.3.12

package/dist/{v3-adapter-3GJT3AID.js → v3-adapter-DDZB3Y6S.js}

@@ -1,27 +1,41 @@
 import {
+  V3_ADAPTER_FILE_TARGETS,
   V3_ADAPTER_MANAGED_MARKER,
   V3_ADAPTER_VERSION,
+  V3_MODE_ENTRY_MANAGED_MARKER,
+  V3_MODE_NAMES,
   applyV3AdapterFilePlan,
+  assertV3AdapterInstallable,
+  assertV3AdapterTargetSafe,
   inspectV3Adapter,
   inspectV3AdapterVersions,
   installV3Adapter,
   planV3AdapterFiles,
   removeV3Adapter,
   renderV3Bootstrap,
+  renderV3ModeEntry,
   stageV3Adapter,
-  v3AdapterTargetPath
-} from "./chunk-KEIW7AEP.js";
+  v3AdapterTargetPath,
+  v3ModeEntryPath
+} from "./chunk-CFC3HBNA.js";
 export {
+  V3_ADAPTER_FILE_TARGETS,
   V3_ADAPTER_MANAGED_MARKER,
   V3_ADAPTER_VERSION,
+  V3_MODE_ENTRY_MANAGED_MARKER,
+  V3_MODE_NAMES,
   applyV3AdapterFilePlan,
+  assertV3AdapterInstallable,
+  assertV3AdapterTargetSafe,
   inspectV3Adapter,
   inspectV3AdapterVersions,
   installV3Adapter,
   planV3AdapterFiles,
   removeV3Adapter,
   renderV3Bootstrap,
+  renderV3ModeEntry,
   stageV3Adapter,
-  v3AdapterTargetPath
+  v3AdapterTargetPath,
+  v3ModeEntryPath
 };
-//# sourceMappingURL=v3-adapter-3GJT3AID.js.map
+//# sourceMappingURL=v3-adapter-DDZB3Y6S.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mancode",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "AI coding agent workflow harness. Five modes from practice to playoffs: stop over-engineering, reuse project context, and add multi-agent code review.",
   "type": "module",
   "license": "AGPL-3.0-only",

package/dist/chunk-KEIW7AEP.js

@@ -1,597 +0,0 @@
-// src/installers/v3-adapter.ts
-import {
-  lstat,
-  mkdir,
-  readFile,
-  rename,
-  rm,
-  writeFile
-} from "fs/promises";
-import path from "path";
-
-// src/installers/managed-block.ts
-var DEFAULT_MANCODE_START_MARKER = "<!-- mancode:start -->";
-var DEFAULT_MANCODE_END_MARKER = "<!-- mancode:end -->";
-function removeManagedBlock(existing, startMarker = DEFAULT_MANCODE_START_MARKER, endMarker = DEFAULT_MANCODE_END_MARKER) {
-  const start = findMarkerLine(existing, startMarker);
-  const end = findMarkerLine(existing, endMarker);
-  if (start === null && end === null) return existing;
-  if (start === null || end === null) return existing;
-  if (end.start < start.start) return existing;
-  const before = existing.slice(0, start.start);
-  const after = existing.slice(end.end);
-  const merged = `${before}${after}`;
-  return cleanUpOrphanedNewlines(merged);
-}
-function hasManagedBlock(existing, startMarker = DEFAULT_MANCODE_START_MARKER, endMarker = DEFAULT_MANCODE_END_MARKER) {
-  const start = findMarkerLine(existing, startMarker);
-  const end = findMarkerLine(existing, endMarker);
-  return start !== null && end !== null && end.start > start.start;
-}
-function cleanUpOrphanedNewlines(content) {
-  const trimmed = content.replace(/\n{3,}/gu, "\n\n").replace(/\n+$/u, "\n");
-  return trimmed || "";
-}
-function replaceManagedBlock(existing, block, startMarker = DEFAULT_MANCODE_START_MARKER, endMarker = DEFAULT_MANCODE_END_MARKER) {
-  const normalizedBlock = normalizeManagedBlock(block, startMarker, endMarker);
-  const start = findMarkerLine(existing, startMarker);
-  const end = findMarkerLine(existing, endMarker);
-  if (start === null !== (end === null)) {
-    throw new Error("managed block is malformed: missing start or end marker");
-  }
-  if (start === null && end === null) {
-    const trimmedExisting = trimTrailingNewlines(existing);
-    if (!trimmedExisting) return `${normalizedBlock}
-`;
-    return `${trimmedExisting}
-
-${normalizedBlock}
-`;
-  }
-  if (!start || !end) {
-    throw new Error("managed block is malformed: missing start or end marker");
-  }
-  if (end.start < start.start) {
-    throw new Error("managed block is malformed: end marker precedes start");
-  }
-  return `${existing.slice(0, start.start)}${normalizedBlock}${existing.slice(
-    end.end
-  )}`;
-}
-function normalizeManagedBlock(block, startMarker, endMarker) {
-  const trimmedBlock = block.trim();
-  const hasStart = trimmedBlock.startsWith(startMarker);
-  const hasEnd = trimmedBlock.endsWith(endMarker);
-  if (hasStart && hasEnd) return trimmedBlock;
-  if (hasStart || hasEnd) {
-    throw new Error("managed block content includes only one marker");
-  }
-  return `${startMarker}
-${trimmedBlock}
-${endMarker}`;
-}
-function trimTrailingNewlines(value) {
-  return value.replace(/\n+$/u, "");
-}
-function findMarkerLine(content, marker) {
-  let offset = 0;
-  let inFence = null;
-  for (const lineWithBreak of content.matchAll(/[^\n]*(?:\n|$)/gu)) {
-    const rawLine = lineWithBreak[0];
-    if (!rawLine) break;
-    const line = rawLine.replace(/\n$/u, "").replace(/\r$/u, "");
-    const fence = line.match(/^(`{3,}|~{3,})/u)?.[1];
-    if (fence) {
-      const char = fence[0];
-      if (!inFence) {
-        inFence = { char, length: fence.length };
-      } else if (inFence.char === char && fence.length >= inFence.length) {
-        inFence = null;
-      }
-    } else if (!inFence && line === marker) {
-      return {
-        start: offset,
-        end: offset + marker.length
-      };
-    }
-    offset += rawLine.length;
-  }
-  return null;
-}
-
-// src/installers/v3-adapter.ts
-var V3_ADAPTER_VERSION = "3";
-var V3_ADAPTER_MANAGED_MARKER = "<!-- Managed by mancode:v3-adapter. Do not edit this marker. -->";
-var V3_CODEX_START_MARKER = "<!-- mancode:v3:codex:start -->";
-var V3_CODEX_END_MARKER = "<!-- mancode:v3:codex:end -->";
-var V3_ZCODE_START_MARKER = "<!-- mancode:v3:zcode:start -->";
-var V3_ZCODE_END_MARKER = "<!-- mancode:v3:zcode:end -->";
-var V3_COPILOT_START_MARKER = "<!-- mancode:v3:copilot:start -->";
-var V3_COPILOT_END_MARKER = "<!-- mancode:v3:copilot:end -->";
-var RETRIABLE_ADAPTER_READ_CODES = /* @__PURE__ */ new Set(["EACCES", "EBUSY", "EPERM"]);
-var ADAPTER_READ_MAX_ATTEMPTS = 4;
-var ADAPTER_READ_RETRY_DELAY_MS = 25;
-var V3_ADAPTER_FILE_TARGETS = [
-  "claude-skill",
-  "cursor-rule",
-  "agents",
-  "copilot-instructions"
-];
-async function planV3AdapterFiles(projectRoot) {
-  const root = path.resolve(projectRoot);
-  const existing = /* @__PURE__ */ new Map();
-  for (const target of V3_ADAPTER_FILE_TARGETS) {
-    existing.set(target, await readAdapterTarget(root, target));
-  }
-  const agents = existing.get("agents") ?? "";
-  const nextAgents = replaceManagedV3BlockText(
-    replaceManagedV3BlockText(
-      agents,
-      V3_CODEX_START_MARKER,
-      V3_CODEX_END_MARKER,
-      renderV3Bootstrap("codex")
-    ),
-    V3_ZCODE_START_MARKER,
-    V3_ZCODE_END_MARKER,
-    renderV3Bootstrap("zcode")
-  );
-  const plans = [
-    managedFilePlan(
-      "claude-skill",
-      existing.get("claude-skill") ?? null,
-      renderClaudeSkill(renderV3Bootstrap("claude-code"))
-    ),
-    managedFilePlan(
-      "cursor-rule",
-      existing.get("cursor-rule") ?? null,
-      renderCursorRule(renderV3Bootstrap("cursor"))
-    ),
-    {
-      target: "agents",
-      beforeContent: existing.get("agents") ?? null,
-      targetContent: nextAgents
-    },
-    {
-      target: "copilot-instructions",
-      beforeContent: existing.get("copilot-instructions") ?? null,
-      targetContent: replaceManagedV3BlockText(
-        existing.get("copilot-instructions") ?? "",
-        V3_COPILOT_START_MARKER,
-        V3_COPILOT_END_MARKER,
-        renderV3Bootstrap("copilot")
-      )
-    }
-  ];
-  return plans;
-}
-async function applyV3AdapterFilePlan(projectRoot, plan) {
-  const root = path.resolve(projectRoot);
-  if (!V3_ADAPTER_FILE_TARGETS.includes(plan.target)) {
-    throw new Error("MANCODE_V3_ADAPTER_TARGET_INVALID");
-  }
-  if (typeof plan.targetContent !== "string" || !plan.targetContent.trim()) {
-    throw new Error("MANCODE_V3_ADAPTER_TARGET_INVALID");
-  }
-  const target = v3AdapterTargetPath(root, plan.target);
-  await mkdir(path.dirname(target), { recursive: true });
-  await atomicWrite(target, plan.targetContent);
-}
-async function stageV3Adapter(projectRoot, platform) {
-  const root = path.resolve(projectRoot);
-  const target = targetFor(platform);
-  const content = await renderV3AdapterCandidate(root, platform);
-  const stagingTarget = path.join(
-    ".mancode",
-    "staging",
-    "adapters",
-    "v3",
-    platform,
-    target
-  );
-  const destination = path.join(root, stagingTarget);
-  await mkdir(path.dirname(destination), { recursive: true });
-  await atomicWrite(destination, content);
-  return { platform, target, stagingTarget };
-}
-function v3AdapterTargetPath(projectRoot, target) {
-  const root = path.resolve(projectRoot);
-  switch (target) {
-    case "claude-skill":
-      return path.join(root, ".claude", "skills", "mancode-v3", "SKILL.md");
-    case "cursor-rule":
-      return path.join(root, ".cursor", "rules", "mancode-v3.mdc");
-    case "agents":
-      return path.join(root, "AGENTS.md");
-    case "copilot-instructions":
-      return path.join(root, ".github", "copilot-instructions.md");
-  }
-}
-async function installV3Adapter(projectRoot, platform) {
-  const root = path.resolve(projectRoot);
-  const content = renderV3Bootstrap(platform);
-  switch (platform) {
-    case "claude-code":
-      await writeManagedFile(
-        path.join(root, ".claude", "skills", "mancode-v3", "SKILL.md"),
-        renderClaudeSkill(content)
-      );
-      break;
-    case "cursor":
-      await writeManagedFile(
-        path.join(root, ".cursor", "rules", "mancode-v3.mdc"),
-        renderCursorRule(content)
-      );
-      break;
-    case "codex":
-      await replaceManagedV3Block(
-        path.join(root, "AGENTS.md"),
-        V3_CODEX_START_MARKER,
-        V3_CODEX_END_MARKER,
-        content
-      );
-      break;
-    case "copilot":
-      await replaceManagedV3Block(
-        path.join(root, ".github", "copilot-instructions.md"),
-        V3_COPILOT_START_MARKER,
-        V3_COPILOT_END_MARKER,
-        content
-      );
-      break;
-    case "zcode":
-      await replaceManagedV3Block(
-        path.join(root, "AGENTS.md"),
-        V3_ZCODE_START_MARKER,
-        V3_ZCODE_END_MARKER,
-        content
-      );
-      break;
-  }
-  return inspectV3Adapter(root, platform);
-}
-async function inspectV3Adapter(projectRoot, platform) {
-  const root = path.resolve(projectRoot);
-  const target = targetFor(platform);
-  const installed = await adapterTargetPresent(root, platform);
-  return {
-    version: V3_ADAPTER_VERSION,
-    installed,
-    ready: installed,
-    target,
-    detail: installed ? "V3 bootstrap is present; session identity is explicit-required." : "V3 bootstrap is not installed.",
-    capabilities: capabilitiesFor(platform)
-  };
-}
-async function inspectV3AdapterVersions(projectRoot) {
-  const platforms = [
-    "claude-code",
-    "codex",
-    "cursor",
-    "copilot",
-    "zcode"
-  ];
-  const entries = await Promise.all(
-    platforms.map(async (platform) => {
-      const status = await inspectV3Adapter(projectRoot, platform);
-      return [platform, status.ready ? status.version : "missing"];
-    })
-  );
-  return Object.fromEntries(entries);
-}
-async function removeV3Adapter(projectRoot, platform) {
-  const root = path.resolve(projectRoot);
-  switch (platform) {
-    case "claude-code":
-      await removeManagedFile(
-        path.join(root, ".claude", "skills", "mancode-v3", "SKILL.md")
-      );
-      return;
-    case "cursor":
-      await removeManagedFile(
-        path.join(root, ".cursor", "rules", "mancode-v3.mdc")
-      );
-      return;
-    case "codex":
-      await removeManagedV3Block(
-        path.join(root, "AGENTS.md"),
-        V3_CODEX_START_MARKER,
-        V3_CODEX_END_MARKER
-      );
-      return;
-    case "copilot":
-      await removeManagedV3Block(
-        path.join(root, ".github", "copilot-instructions.md"),
-        V3_COPILOT_START_MARKER,
-        V3_COPILOT_END_MARKER
-      );
-      return;
-    case "zcode":
-      await removeManagedV3Block(
-        path.join(root, "AGENTS.md"),
-        V3_ZCODE_START_MARKER,
-        V3_ZCODE_END_MARKER
-      );
-  }
-}
-function renderV3Bootstrap(platform) {
-  const platformLabel = platformLabelFor(platform);
-  const modeEntry = capabilitiesFor(platform).nativeModeEntry ? "Use the platform mode entry only as a shortcut; resolve a Context Pack first." : "This platform has no native V3 mode entry; use the CLI commands explicitly.";
-  return [
-    "# mancode V3 bootstrap",
-    "",
-    V3_ADAPTER_MANAGED_MARKER,
-    "",
-    `- Platform: ${platformLabel}. This file is a non-authoritative bootstrap.`,
-    "- Locate the project root before running mancode commands.",
-    `- Create or supply an explicit session: \`mancode context session new --client ${platform}\` or \`--session <id>\`.`,
-    "- Read current task context with `mancode context show --purpose orient --session <id>`; for anonymous diagnosis, include an explicit `--task <namespace:id>`.",
-    "- For a mode entry, request the matching Context Pack purpose: `plan`, `implement`, `review`, `verify`, or `handoff`.",
-    "- Perform mutations only through `mancode workflow`, `mancode team`, and `mancode context` commands with their required revision and session arguments.",
-    "- Do not persist task, mode, or session state in this adapter file or any legacy state file.",
-    `- ${modeEntry}`,
-    `- No approved session or prompt hook is assumed. After a real-host spike is recorded for ${platform}, a verified host may provide MANCODE_HOST_SESSION_KEY; otherwise mutations require an explicit \`--session\`.`
-  ].join("\n");
-}
-async function renderV3AdapterCandidate(root, platform) {
-  switch (platform) {
-    case "claude-code": {
-      const existing = await readAdapterTarget(root, "claude-skill");
-      return managedFilePlan(
-        "claude-skill",
-        existing,
-        renderClaudeSkill(renderV3Bootstrap(platform))
-      ).targetContent;
-    }
-    case "cursor": {
-      const existing = await readAdapterTarget(root, "cursor-rule");
-      return managedFilePlan(
-        "cursor-rule",
-        existing,
-        renderCursorRule(renderV3Bootstrap(platform))
-      ).targetContent;
-    }
-    case "codex": {
-      const existing = await readAdapterTarget(root, "agents") ?? "";
-      return replaceManagedV3BlockText(
-        existing,
-        V3_CODEX_START_MARKER,
-        V3_CODEX_END_MARKER,
-        renderV3Bootstrap(platform)
-      );
-    }
-    case "copilot": {
-      const existing = await readAdapterTarget(root, "copilot-instructions") ?? "";
-      return replaceManagedV3BlockText(
-        existing,
-        V3_COPILOT_START_MARKER,
-        V3_COPILOT_END_MARKER,
-        renderV3Bootstrap(platform)
-      );
-    }
-    case "zcode": {
-      const existing = await readAdapterTarget(root, "agents") ?? "";
-      return replaceManagedV3BlockText(
-        existing,
-        V3_ZCODE_START_MARKER,
-        V3_ZCODE_END_MARKER,
-        renderV3Bootstrap(platform)
-      );
-    }
-  }
-}
-function renderClaudeSkill(content) {
-  return [
-    "---",
-    "name: mancode-v3",
-    'description: "Stable bootstrap for mancode V3 context and workflow commands."',
-    "---",
-    "",
-    content,
-    ""
-  ].join("\n");
-}
-function renderCursorRule(content) {
-  return [
-    "---",
-    'description: "Stable bootstrap for mancode V3 context and workflow commands."',
-    "alwaysApply: true",
-    'globs: "**/*"',
-    "---",
-    "",
-    content,
-    ""
-  ].join("\n");
-}
-async function adapterTargetPresent(root, platform) {
-  switch (platform) {
-    case "claude-code":
-      return managedFilePresent(
-        path.join(root, ".claude", "skills", "mancode-v3", "SKILL.md")
-      );
-    case "cursor":
-      return managedFilePresent(
-        path.join(root, ".cursor", "rules", "mancode-v3.mdc")
-      );
-    case "codex":
-      return managedBlockPresent(
-        path.join(root, "AGENTS.md"),
-        V3_CODEX_START_MARKER,
-        V3_CODEX_END_MARKER
-      );
-    case "copilot":
-      return managedBlockPresent(
-        path.join(root, ".github", "copilot-instructions.md"),
-        V3_COPILOT_START_MARKER,
-        V3_COPILOT_END_MARKER
-      );
-    case "zcode":
-      return managedBlockPresent(
-        path.join(root, "AGENTS.md"),
-        V3_ZCODE_START_MARKER,
-        V3_ZCODE_END_MARKER
-      );
-  }
-}
-async function writeManagedFile(filePath, content) {
-  const existing = await readTextIfExists(filePath);
-  if (existing !== null && !existing.includes(V3_ADAPTER_MANAGED_MARKER)) {
-    throw new Error("MANCODE_V3_ADAPTER_TARGET_USER_AUTHORED");
-  }
-  await mkdir(path.dirname(filePath), { recursive: true });
-  await atomicWrite(filePath, content);
-}
-async function removeManagedFile(filePath) {
-  const existing = await readTextIfExists(filePath);
-  if (existing?.includes(V3_ADAPTER_MANAGED_MARKER)) {
-    await rm(filePath, { force: true });
-  }
-}
-async function replaceManagedV3Block(filePath, startMarker, endMarker, content) {
-  const existing = await readTextIfExists(filePath) ?? "";
-  const block = [startMarker, content, endMarker].join("\n");
-  await mkdir(path.dirname(filePath), { recursive: true });
-  await atomicWrite(
-    filePath,
-    replaceManagedBlock(existing, block, startMarker, endMarker)
-  );
-}
-function replaceManagedV3BlockText(existing, startMarker, endMarker, content) {
-  return replaceManagedBlock(
-    existing,
-    [startMarker, content, endMarker].join("\n"),
-    startMarker,
-    endMarker
-  );
-}
-function managedFilePlan(target, beforeContent, targetContent) {
-  if (beforeContent !== null && !beforeContent.includes(V3_ADAPTER_MANAGED_MARKER)) {
-    throw new Error("MANCODE_V3_ADAPTER_TARGET_USER_AUTHORED");
-  }
-  return { target, beforeContent, targetContent };
-}
-async function readAdapterTarget(root, target) {
-  const filePath = v3AdapterTargetPath(root, target);
-  try {
-    const entry = await lstat(filePath);
-    if (!entry.isFile() || entry.isSymbolicLink()) {
-      throw new Error("MANCODE_ARTIFACT_PATH_UNSAFE");
-    }
-  } catch (error) {
-    if (isNodeError(error) && error.code === "ENOENT") return null;
-    throw error;
-  }
-  return readFile(filePath, "utf8");
-}
-async function removeManagedV3Block(filePath, startMarker, endMarker) {
-  const existing = await readTextIfExists(filePath);
-  if (existing === null || !hasManagedBlock(existing, startMarker, endMarker)) {
-    return;
-  }
-  const cleaned = removeManagedBlock(existing, startMarker, endMarker);
-  if (cleaned.trim()) {
-    await atomicWrite(filePath, `${cleaned.trimEnd()}
-`);
-  } else {
-    await rm(filePath, { force: true });
-  }
-}
-async function managedFilePresent(filePath) {
-  const content = await readTextIfExists(filePath);
-  return content?.includes(V3_ADAPTER_MANAGED_MARKER) ?? false;
-}
-async function managedBlockPresent(filePath, startMarker, endMarker) {
-  const content = await readTextIfExists(filePath);
-  return content !== null && hasManagedBlock(content, startMarker, endMarker);
-}
-async function readTextIfExists(filePath) {
-  for (let attempt = 1; attempt <= ADAPTER_READ_MAX_ATTEMPTS; attempt += 1) {
-    try {
-      return await readFile(filePath, "utf8");
-    } catch (error) {
-      if (isNodeError(error) && error.code === "ENOENT") return null;
-      if (!isRetriableAdapterReadError(error) || attempt === ADAPTER_READ_MAX_ATTEMPTS) {
-        throw error;
-      }
-      await delay(ADAPTER_READ_RETRY_DELAY_MS * attempt);
-    }
-  }
-  throw new Error("MANCODE_V3_ADAPTER_READ_RETRY_EXHAUSTED");
-}
-async function atomicWrite(filePath, content) {
-  const temporary = path.join(
-    path.dirname(filePath),
-    `.${path.basename(filePath)}.${process.pid}.${Date.now()}.tmp`
-  );
-  try {
-    await writeFile(temporary, content, { encoding: "utf8", flag: "wx" });
-    await rename(temporary, filePath);
-  } finally {
-    await rm(temporary, { force: true }).catch(() => void 0);
-  }
-}
-function targetFor(platform) {
-  switch (platform) {
-    case "claude-code":
-      return ".claude/skills/mancode-v3/SKILL.md";
-    case "cursor":
-      return ".cursor/rules/mancode-v3.mdc";
-    case "codex":
-    case "zcode":
-      return "AGENTS.md";
-    case "copilot":
-      return ".github/copilot-instructions.md";
-  }
-}
-function platformLabelFor(platform) {
-  switch (platform) {
-    case "claude-code":
-      return "Claude Code";
-    case "cursor":
-      return "Cursor";
-    case "codex":
-      return "Codex";
-    case "copilot":
-      return "GitHub Copilot";
-    case "zcode":
-      return "ZCode";
-  }
-}
-function capabilitiesFor(platform) {
-  return {
-    nativeModeEntry: platform === "claude-code" || platform === "cursor",
-    sessionHook: false,
-    promptHook: false,
-    sessionIdentity: "explicit-required"
-  };
-}
-function isNodeError(error) {
-  return typeof error === "object" && error !== null && "code" in error;
-}
-function isRetriableAdapterReadError(error) {
-  return isNodeError(error) && RETRIABLE_ADAPTER_READ_CODES.has(error.code ?? "");
-}
-async function delay(milliseconds) {
-  await new Promise((resolve) => {
-    setTimeout(resolve, milliseconds);
-  });
-}
-
-export {
-  DEFAULT_MANCODE_START_MARKER,
-  DEFAULT_MANCODE_END_MARKER,
-  removeManagedBlock,
-  hasManagedBlock,
-  replaceManagedBlock,
-  V3_ADAPTER_VERSION,
-  V3_ADAPTER_MANAGED_MARKER,
-  planV3AdapterFiles,
-  applyV3AdapterFilePlan,
-  stageV3Adapter,
-  v3AdapterTargetPath,
-  installV3Adapter,
-  inspectV3Adapter,
-  inspectV3AdapterVersions,
-  removeV3Adapter,
-  renderV3Bootstrap
-};
-//# sourceMappingURL=chunk-KEIW7AEP.js.map