agent-work-loop 0.0.0 → 0.6.23

package/dist/chunk-IXMAFR4Y.js

@@ -0,0 +1,771 @@
+import {
+  gatherVersionInputs
+} from "./chunk-C7BR2DCS.js";
+import {
+  checkVersions
+} from "./chunk-YTAHVR4P.js";
+import {
+  loadProjectName,
+  readRecords
+} from "./chunk-I77CXOEX.js";
+import {
+  loadState,
+  readStateLock
+} from "./chunk-4OCSYHYB.js";
+import {
+  CommandNotFoundError,
+  run,
+  tokenize
+} from "./chunk-UOPWVM2H.js";
+import {
+  caps,
+  card,
+  clipToWidth,
+  findProjectRoot,
+  globalRoot,
+  gotchasDir,
+  installedEngineVersion,
+  makeColors,
+  makeSymbols,
+  makeTokens,
+  projectsFile,
+  rulesDir,
+  signal,
+  visibleWidth
+} from "./chunk-7SYRDDTX.js";
+
+// src/commands/doctor.ts
+import fs from "fs";
+import path from "path";
+function exists(p) {
+  try {
+    return fs.existsSync(p);
+  } catch {
+    return false;
+  }
+}
+function isDirectory(p) {
+  try {
+    return fs.statSync(p).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function readJson(p) {
+  try {
+    return JSON.parse(fs.readFileSync(p, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function countEntries(dir, ext) {
+  try {
+    return fs.readdirSync(dir).filter((f) => !f.startsWith(".") && (ext ? f.endsWith(ext) : true)).length;
+  } catch {
+    return 0;
+  }
+}
+async function gitBranch(projectRoot) {
+  try {
+    const r = await run({
+      cmd: "git",
+      args: ["symbolic-ref", "--short", "HEAD"],
+      cwd: projectRoot,
+      timeoutMs: 5e3
+    });
+    if (r.exitCode !== 0) {
+      return null;
+    }
+    const branch = r.stdout.trim();
+    return branch || null;
+  } catch {
+    return null;
+  }
+}
+async function gitDirtyFiles(projectRoot) {
+  try {
+    const r = await run({
+      cmd: "git",
+      args: ["status", "--porcelain", "-z"],
+      cwd: projectRoot,
+      timeoutMs: 5e3
+    });
+    if (r.exitCode !== 0) {
+      return null;
+    }
+    const tokens = r.stdout.split("\0").filter((t) => t !== "");
+    const files = [];
+    let skipNext = false;
+    for (const token of tokens) {
+      if (skipNext) {
+        skipNext = false;
+        continue;
+      }
+      const status = token.slice(0, 2);
+      files.push(token.slice(3));
+      skipNext = status.includes("R") || status.includes("C");
+    }
+    return files;
+  } catch {
+    return null;
+  }
+}
+async function gitHasCommits(projectRoot) {
+  try {
+    const r = await run({
+      cmd: "git",
+      args: ["rev-parse", "--verify", "--quiet", "HEAD"],
+      cwd: projectRoot,
+      timeoutMs: 5e3
+    });
+    return r.exitCode === 0;
+  } catch {
+    return false;
+  }
+}
+function detectRecordTrailGap(input) {
+  return input.hasCommits && !input.activeWorkitem && input.gateAttemptRecords === 0;
+}
+var MIN_DECISIVE_FILES = 3;
+var MAJORITY_THRESHOLD = 0.8;
+function classifyBasename(nameNoExt) {
+  if (nameNoExt.includes("-")) {
+    return "kebab-case";
+  }
+  if (nameNoExt.includes("_")) {
+    return "snake_case";
+  }
+  if (/^[A-Z]/.test(nameNoExt)) {
+    return "PascalCase";
+  }
+  if (/[A-Z]/.test(nameNoExt)) {
+    return "camelCase";
+  }
+  return "ambiguous";
+}
+var CODE_EXTENSIONS = /* @__PURE__ */ new Set([
+  "ts",
+  "tsx",
+  "js",
+  "jsx",
+  "mjs",
+  "cjs",
+  "py",
+  "go",
+  "rs",
+  "java",
+  "rb",
+  "php",
+  "c",
+  "cpp",
+  "h",
+  "hpp",
+  "cs",
+  "kt",
+  "swift"
+]);
+var IGNORE_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  ".awl",
+  ".awl-worktrees",
+  "coverage"
+]);
+var STATE_SIZE_WARN_BYTES = 1024 * 1024;
+function listSourceFiles(projectRoot) {
+  const root = fs.existsSync(path.join(projectRoot, "src")) ? path.join(projectRoot, "src") : projectRoot;
+  const out = [];
+  const walk = (dir, depth) => {
+    if (depth > 8) {
+      return;
+    }
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (e.isDirectory()) {
+        if (!IGNORE_DIRS.has(e.name)) {
+          walk(path.join(dir, e.name), depth + 1);
+        }
+      } else if (e.isFile()) {
+        const ext = e.name.split(".").pop() ?? "";
+        if (CODE_EXTENSIONS.has(ext)) {
+          out.push(path.join(dir, e.name));
+        }
+      }
+    }
+  };
+  walk(root, 0);
+  return out;
+}
+function detectNamingConvention(filenames) {
+  const counts = {};
+  let decisiveTotal = 0;
+  for (const raw of filenames) {
+    const nameNoExt = raw.replace(/\.[^./]+$/, "");
+    const cls = classifyBasename(nameNoExt);
+    if (cls === "ambiguous") {
+      continue;
+    }
+    counts[cls] = (counts[cls] ?? 0) + 1;
+    decisiveTotal += 1;
+  }
+  if (decisiveTotal < MIN_DECISIVE_FILES) {
+    return { convention: null, reason: "insufficient_data", counts, decisiveTotal };
+  }
+  const sorted = Object.entries(counts).sort((a, b) => b[1] - a[1]);
+  const top = sorted[0];
+  if (top && top[1] / decisiveTotal >= MAJORITY_THRESHOLD) {
+    return {
+      convention: top[0],
+      reason: "detected",
+      counts,
+      decisiveTotal
+    };
+  }
+  return { convention: null, reason: "mixed", counts, decisiveTotal };
+}
+var MIN_FILES_FOR_THRESHOLD = 5;
+var IQR_MULTIPLIER = 1.5;
+function percentile(sorted, p) {
+  const pos = p * (sorted.length - 1);
+  const lower = Math.floor(pos);
+  const upper = Math.ceil(pos);
+  const weight = pos - lower;
+  const lowerVal = sorted[lower];
+  if (upper >= sorted.length) {
+    return lowerVal;
+  }
+  const upperVal = sorted[upper];
+  return lowerVal + (upperVal - lowerVal) * weight;
+}
+function computeFileSizeOutliers(files) {
+  if (files.length < MIN_FILES_FOR_THRESHOLD) {
+    return { threshold: null, outliers: [] };
+  }
+  const sortedLines = [...files].map((f) => f.lines).sort((a, b) => a - b);
+  const q1 = percentile(sortedLines, 0.25);
+  const q3 = percentile(sortedLines, 0.75);
+  const iqr = q3 - q1;
+  const threshold = q3 + IQR_MULTIPLIER * iqr;
+  const outliers = files.filter((f) => f.lines > threshold);
+  return { threshold, outliers };
+}
+function countFileLines(projectRoot) {
+  const out = [];
+  for (const abs of listSourceFiles(projectRoot)) {
+    try {
+      const lines = fs.readFileSync(abs, "utf8").split("\n").length;
+      out.push({ path: path.relative(projectRoot, abs), lines });
+    } catch {
+    }
+  }
+  return out;
+}
+function isAwlConfig(c) {
+  if (typeof c !== "object" || c === null) {
+    return false;
+  }
+  const o = c;
+  if (typeof o.engineVersion !== "string") {
+    return false;
+  }
+  if (o.verify !== void 0 && (typeof o.verify !== "object" || o.verify === null)) {
+    return false;
+  }
+  return true;
+}
+var INIT_HINT = "awl init \uC744 \uC2E4\uD589\uD558\uC138\uC694";
+function collectEnv(checks) {
+  const major = Number(process.versions.node.split(".")[0]);
+  checks.push({
+    group: "\uD658\uACBD",
+    name: "Node",
+    status: major >= 18 ? "ok" : "fail",
+    value: `v${process.versions.node}`,
+    hint: major >= 18 ? void 0 : "Node 18 \uC774\uC0C1\uC774 \uD544\uC694\uD569\uB2C8\uB2E4"
+  });
+  checks.push({
+    group: "\uD658\uACBD",
+    name: "\uD50C\uB7AB\uD3FC",
+    status: "ok",
+    value: `${process.platform} ${process.arch}`
+  });
+  const c = caps();
+  checks.push({
+    group: "\uD658\uACBD",
+    name: "\uD130\uBBF8\uB110",
+    status: "ok",
+    value: `\uC720\uB2C8\uCF54\uB4DC ${c.unicode ? "\uC9C0\uC6D0" : "\uBBF8\uC9C0\uC6D0"}, \uC0C9 ${c.color ? "\uC9C0\uC6D0" : "\uBBF8\uC9C0\uC6D0"}`
+  });
+}
+function collectGlobal(checks, versionResult) {
+  const root = globalRoot();
+  if (!exists(root)) {
+    checks.push({
+      group: "\uC804\uC5ED \uC124\uCE58",
+      name: "~/.awl",
+      status: "missing",
+      value: "\uC5C6\uC74C",
+      hint: INIT_HINT
+    });
+    return;
+  }
+  checks.push({ group: "\uC804\uC5ED \uC124\uCE58", name: "~/.awl", status: "ok", value: "\uC788\uC74C" });
+  const probe = path.join(root, `.doctor-write-${process.pid}`);
+  try {
+    fs.writeFileSync(probe, "ok");
+    fs.unlinkSync(probe);
+    checks.push({ group: "\uC804\uC5ED \uC124\uCE58", name: "\uC4F0\uAE30 \uAD8C\uD55C", status: "ok", value: "\uAC00\uB2A5" });
+  } catch {
+    checks.push({
+      group: "\uC804\uC5ED \uC124\uCE58",
+      name: "\uC4F0\uAE30 \uAD8C\uD55C",
+      status: "fail",
+      value: "\uBD88\uAC00",
+      hint: "~/.awl \uC5D0 \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uAD8C\uD55C\uC744 \uD655\uC778\uD558\uC138\uC694"
+    });
+  }
+  const engineVer = installedEngineVersion();
+  const binaryMismatch = findMismatch(versionResult, "binary-vs-engine");
+  checks.push({
+    group: "\uC804\uC5ED \uC124\uCE58",
+    name: "\uC5D4\uC9C4 \uBC84\uC804",
+    status: engineVer ? binaryMismatch ? "warn" : "ok" : "missing",
+    value: engineVer ?? "\uC5C6\uC74C",
+    hint: binaryMismatch ? binaryMismatch.hint : engineVer ? void 0 : INIT_HINT
+  });
+  const buildMismatch = findMismatch(versionResult, "build");
+  if (buildMismatch) {
+    checks.push({
+      group: "\uC804\uC5ED \uC124\uCE58",
+      name: "\uBE4C\uB4DC \uBB34\uACB0\uC131",
+      status: "warn",
+      value: `package ${buildMismatch.a} / engine \uC18C\uC2A4 ${buildMismatch.b}`,
+      hint: buildMismatch.hint
+    });
+  }
+  checks.push({
+    group: "\uC804\uC5ED \uC124\uCE58",
+    name: "\uADDC\uCE59",
+    status: "info",
+    value: `${countEntries(path.join(rulesDir(), "active"))}\uAC1C`
+  });
+  checks.push({
+    group: "\uC804\uC5ED \uC124\uCE58",
+    name: "\uAD50\uD6C8",
+    status: "info",
+    value: `${countEntries(gotchasDir(), ".json")}\uAC1C`
+  });
+  let projectCount = 0;
+  const projects = readJson(projectsFile());
+  if (Array.isArray(projects)) {
+    projectCount = projects.length;
+  } else if (projects && typeof projects === "object") {
+    projectCount = Object.keys(projects).length;
+  }
+  checks.push({ group: "\uC804\uC5ED \uC124\uCE58", name: "\uD504\uB85C\uC81D\uD2B8", status: "info", value: `${projectCount}\uAC1C` });
+}
+async function collectProject(checks, projectRoot, versionResult) {
+  if (!projectRoot) {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "\uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8",
+      status: "info",
+      value: "\uC544\uB2D8 (.git/.awl \uC5C6\uC74C)"
+    });
+    return;
+  }
+  checks.push({
+    group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+    name: "\uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8",
+    status: "info",
+    value: projectRoot
+  });
+  const branch = await gitBranch(projectRoot);
+  checks.push({
+    group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+    name: "\uBE0C\uB79C\uCE58",
+    status: "info",
+    value: branch ?? "\uC54C \uC218 \uC5C6\uC74C (\uD655\uC778 \uC2E4\uD328)"
+  });
+  const dirtyFiles = await gitDirtyFiles(projectRoot);
+  if (dirtyFiles === null) {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "\uC6CC\uD0B9\uD2B8\uB9AC",
+      status: "info",
+      value: "\uD655\uC778 \uC548 \uB428 (git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2C8\uAC70\uB098 \uD655\uC778 \uC2E4\uD328)"
+    });
+  } else if (dirtyFiles.length === 0) {
+    checks.push({ group: "\uC774 \uD504\uB85C\uC81D\uD2B8", name: "\uC6CC\uD0B9\uD2B8\uB9AC", status: "ok", value: "\uD074\uB9B0" });
+  } else {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "\uC6CC\uD0B9\uD2B8\uB9AC",
+      status: "warn",
+      value: `\uBBF8\uCEE4\uBC0B \uBCC0\uACBD ${dirtyFiles.length}\uAC1C`,
+      hint: `${dirtyFiles.slice(0, 5).join(", ")}${dirtyFiles.length > 5 ? " \uB4F1" : ""} \u2014 \uC0C8 \uC6CC\uD06C\uC544\uC774\uD15C\uC744 \uC2DC\uC791\uD558\uAE30 \uC804\uC5D0 awl work new --worktree \uB85C \uACA9\uB9AC\uD558\uB294 \uAC78 \uACE0\uB824\uD558\uC138\uC694.`
+    });
+  }
+  const configPath = path.join(projectRoot, ".awl", "config.json");
+  if (!exists(configPath)) {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "config.json",
+      status: "missing",
+      value: "\uC5C6\uC74C",
+      hint: INIT_HINT
+    });
+    return;
+  }
+  const raw = readJson(configPath);
+  if (!isAwlConfig(raw)) {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "config.json",
+      status: "fail",
+      value: "\uD615\uC2DD \uC624\uB958",
+      hint: "config.json \uD615\uC2DD\uC744 \uD655\uC778\uD558\uC138\uC694"
+    });
+    return;
+  }
+  checks.push({ group: "\uC774 \uD504\uB85C\uC81D\uD2B8", name: "config.json", status: "ok", value: "\uC788\uC74C" });
+  const recordedNaming = typeof raw.namingConvention === "string" ? raw.namingConvention : void 0;
+  if (recordedNaming) {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "\uB124\uC774\uBC0D \uCEE8\uBCA4\uC158",
+      status: "info",
+      value: recordedNaming
+    });
+  } else {
+    const naming = detectNamingConvention(
+      listSourceFiles(projectRoot).map((p) => path.basename(p))
+    );
+    if (naming.reason === "detected" && naming.convention) {
+      checks.push({
+        group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+        name: "\uB124\uC774\uBC0D \uCEE8\uBCA4\uC158",
+        status: "info",
+        value: `${naming.convention} (${naming.counts[naming.convention]}/${naming.decisiveTotal} \uD30C\uC77C, \uBBF8\uAE30\uB85D)`,
+        hint: `config.json \uC5D0 \uAE30\uB85D\uD558\uB824\uBA74: awl config set namingConvention ${naming.convention}`
+      });
+    } else if (naming.reason === "mixed") {
+      checks.push({ group: "\uC774 \uD504\uB85C\uC81D\uD2B8", name: "\uB124\uC774\uBC0D \uCEE8\uBCA4\uC158", status: "info", value: "\uD63C\uC7AC" });
+    } else {
+      checks.push({
+        group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+        name: "\uB124\uC774\uBC0D \uCEE8\uBCA4\uC158",
+        status: "info",
+        value: "\uD310\uB2E8 \uBCF4\uB958 (\uD30C\uC77C \uBD80\uC871)"
+      });
+    }
+  }
+  const sizeReport = computeFileSizeOutliers(countFileLines(projectRoot));
+  if (sizeReport.threshold === null) {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "\uD30C\uC77C \uD06C\uAE30",
+      status: "info",
+      value: "\uD310\uB2E8 \uBCF4\uB958 (\uD30C\uC77C \uBD80\uC871)"
+    });
+  } else if (sizeReport.outliers.length === 0) {
+    checks.push({ group: "\uC774 \uD504\uB85C\uC81D\uD2B8", name: "\uD30C\uC77C \uD06C\uAE30", status: "ok", value: "\uC774\uC0C1\uCE58 \uC5C6\uC74C" });
+  } else {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "\uD30C\uC77C \uD06C\uAE30",
+      status: "warn",
+      value: `\uC774\uC0C1\uCE58 ${sizeReport.outliers.length}\uAC1C (\uC784\uACC4\uAC12 ${Math.round(sizeReport.threshold)}\uC904)`,
+      hint: `${sizeReport.outliers.slice(0, 5).map((o) => `${o.path}(${o.lines}\uC904)`).join(
+        ", "
+      )}${sizeReport.outliers.length > 5 ? " \uB4F1" : ""} \u2014 \uB9AC\uD329\uD130 \uD6C4\uBCF4\uB85C \uACE0\uB824\uD574\uBCFC \uB9CC\uD569\uB2C8\uB2E4(\uAC15\uC81C \uC544\uB2D8).`
+    });
+  }
+  const installed = installedEngineVersion();
+  if (installed !== null) {
+    const projectMismatch = findMismatch(versionResult, "project-vs-engine");
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "\uC5D4\uC9C4 \uBC84\uC804 \uC77C\uCE58",
+      status: projectMismatch ? "warn" : "ok",
+      value: projectMismatch ? `config ${raw.engineVersion} / \uC124\uCE58 ${installed}` : raw.engineVersion,
+      hint: projectMismatch?.hint
+    });
+  }
+  for (const [vname, spec] of Object.entries(raw.verify ?? {})) {
+    if (!spec || typeof spec.cmd !== "string") {
+      continue;
+    }
+    const first = tokenize(spec.cmd)[0] ?? "";
+    if (!first) {
+      checks.push({
+        group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+        name: `\uAC80\uC99D: ${vname}`,
+        status: "warn",
+        value: "\uBA85\uB839 \uBE44\uC5B4 \uC788\uC74C"
+      });
+      continue;
+    }
+    const cwd = spec.cwd ? path.isAbsolute(spec.cwd) ? spec.cwd : path.join(projectRoot, spec.cwd) : void 0;
+    if (cwd && !isDirectory(cwd)) {
+      checks.push({
+        group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+        name: `\uAC80\uC99D: ${vname}`,
+        status: "missing",
+        value: "cwd \uC5C6\uC74C",
+        hint: `cwd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: ${spec.cwd}`
+      });
+      continue;
+    }
+    try {
+      await run({ cmd: first, args: ["--version"], cwd, timeoutMs: 3e3 });
+      checks.push({
+        group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+        name: `\uAC80\uC99D: ${vname}`,
+        status: "ok",
+        value: `${first} \uC2E4\uD589 \uAC00\uB2A5`
+      });
+    } catch (e) {
+      if (e instanceof CommandNotFoundError) {
+        checks.push({
+          group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+          name: `\uAC80\uC99D: ${vname}`,
+          status: "missing",
+          value: "\uBA85\uB839 \uC5C6\uC74C",
+          hint: `\uBA85\uB839\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${e.command}`
+        });
+      } else {
+        checks.push({
+          group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+          name: `\uAC80\uC99D: ${vname}`,
+          status: "warn",
+          value: "\uD655\uC778 \uC2E4\uD328",
+          hint: "\uAC80\uC99D \uBA85\uB839\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4"
+        });
+      }
+    }
+  }
+  const statePath = path.join(projectRoot, ".awl", "state.json");
+  if (!exists(statePath)) {
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "state.json",
+      status: "info",
+      value: "\uC5C6\uC74C (\uC544\uC9C1 \uC2DC\uC791 \uC804)"
+    });
+  } else {
+    const st = readJson(statePath);
+    if (st && typeof st === "object") {
+      const o = st;
+      const pos = typeof o.phase === "string" && o.phase || typeof o.step === "string" && o.step || typeof o.position === "string" && o.position || "\uC788\uC74C";
+      checks.push({ group: "\uC774 \uD504\uB85C\uC81D\uD2B8", name: "state.json", status: "ok", value: String(pos) });
+    } else {
+      checks.push({ group: "\uC774 \uD504\uB85C\uC81D\uD2B8", name: "state.json", status: "warn", value: "\uD615\uC2DD \uC624\uB958" });
+    }
+    let stateBytes = null;
+    try {
+      stateBytes = fs.statSync(statePath).size;
+    } catch {
+      stateBytes = null;
+    }
+    if (stateBytes !== null && stateBytes > STATE_SIZE_WARN_BYTES) {
+      checks.push({
+        group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+        name: "state.json \uD06C\uAE30",
+        status: "warn",
+        value: `${(stateBytes / (1024 * 1024)).toFixed(1)}MB`,
+        hint: "state.json \uC774 \uBE44\uC815\uC0C1\uC801\uC73C\uB85C \uD07D\uB2C8\uB2E4 \u2014 commit --start \uAC00 \uC800\uC7A5\uD558\uB294 untracked \uC2A4\uB0C5\uC0F7 \uB204\uC801\uC774 \uC6D0\uC778\uC77C \uC218 \uC788\uC2B5\uB2C8\uB2E4. .awl-worktrees/ \uB97C .gitignore \uC5D0 \uB123\uACE0(awl init \uC7AC\uC2E4\uD589) \uC644\uB8CC\uB41C \uC6CC\uD06C\uC544\uC774\uD15C\uC744 \uC815\uB9AC\uD558\uC138\uC694."
+      });
+    }
+  }
+  const worktreesDir = path.join(projectRoot, ".awl-worktrees");
+  let leftoverWorktrees = [];
+  try {
+    leftoverWorktrees = fs.readdirSync(worktreesDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+  } catch {
+  }
+  if (leftoverWorktrees.length > 0) {
+    const shown = leftoverWorktrees.slice(0, 3).join(", ");
+    checks.push({
+      group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+      name: "\uC6CC\uD06C\uD2B8\uB9AC \uC794\uC874",
+      status: "warn",
+      value: `${leftoverWorktrees.length}\uAC1C`,
+      hint: `.awl-worktrees/ \uC5D0 \uC6CC\uD06C\uD2B8\uB9AC\uAC00 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4(${shown}${leftoverWorktrees.length > 3 ? " \uB4F1" : ""}). \uC644\uB8CC\uB41C \uC6CC\uD06C\uC544\uC774\uD15C\uC774\uBA74 git worktree remove \uB85C \uC815\uB9AC\uD558\uC138\uC694.`
+    });
+  }
+  const trailProjectName = loadProjectName(projectRoot);
+  if (trailProjectName) {
+    const trailState = loadState(projectRoot);
+    const activeWorkitem = typeof trailState.workitem === "string" && trailState.workitem.trim() !== "" ? trailState.workitem : null;
+    const gateAttemptRecords = readRecords().filter(
+      (r) => r.project === trailProjectName && (r.type === "gate" || r.type === "attempt")
+    ).length;
+    const hasCommits = await gitHasCommits(projectRoot);
+    if (detectRecordTrailGap({ hasCommits, activeWorkitem, gateAttemptRecords })) {
+      checks.push({
+        group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+        name: "record \uD2B8\uB808\uC77C",
+        status: "warn",
+        value: "\uACF5\uBC31 (\uD65C\uC131 \uC6CC\uD06C\uC544\uC774\uD15C \uC5C6\uC774 \uCEE4\uBC0B \uC774\uB825)",
+        hint: "\uCD5C\uADFC \uCEE4\uBC0B\uC5D0 \uB300\uC751\uD558\uB294 record(gate/attempt)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 /awl-loop(work new\u2192gate\u2192commit)\uB85C \uD310\uB2E8 \uADFC\uAC70\uB97C \uB0A8\uAE30\uC138\uC694."
+      });
+    }
+  }
+  try {
+    const recs = readRecords();
+    const lastAt = recs.length > 0 ? String(recs[0]?.at ?? "") : "";
+    let stateMtime = "";
+    try {
+      stateMtime = fs.statSync(statePath).mtime.toISOString();
+    } catch {
+    }
+    const lock = readStateLock(projectRoot);
+    if (lastAt || stateMtime || lock) {
+      const fmt = (iso) => iso ? iso.slice(0, 16).replace("T", " ") : "\uC5C6\uC74C";
+      const lockNote = lock ? ` \xB7 \uB2E4\uB978 \uC138\uC158\uC774 state \uC4F0\uB294 \uC911(${lock.token})` : "";
+      checks.push({
+        group: "\uC774 \uD504\uB85C\uC81D\uD2B8",
+        name: "\uCD5C\uADFC \uD65C\uB3D9",
+        status: lock ? "warn" : "info",
+        value: `\uAE30\uB85D ${fmt(lastAt)} \xB7 state ${fmt(stateMtime)}${lockNote}`,
+        hint: lock ? `\uC9C0\uAE08 \uB2E4\uB978 awl \uD504\uB85C\uC138\uC2A4(${lock.token})\uAC00 state \uB97C \uC4F0\uB294 \uC911\uC785\uB2C8\uB2E4(.awl/state.lock). \uBCD1\uB82C \uC138\uC158\uC774\uBA74 AWL_HOME \uC744 \uBD84\uB9AC\uD558\uC138\uC694.` : "\uC5EC\uB7EC \uC138\uC158\uC774 \uAC19\uC740 \uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C awl \uC744 \uB3CC\uB9AC\uBA74 records(\uC804\uC5ED \uACF5\uC720)\xB7state \uAC00 \uB4A4\uC11E\uC77C \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uBCD1\uB82C\uB85C \uC791\uC5C5 \uC911\uC774\uBA74 AWL_HOME \uC744 \uBD84\uB9AC\uD558\uC138\uC694."
+      });
+    }
+  } catch {
+  }
+}
+function collectAgents(checks, base, versionResult) {
+  const claudeDir = path.join(base, ".claude");
+  checks.push({
+    group: "\uC5D0\uC774\uC804\uD2B8",
+    name: "Claude Code",
+    status: "info",
+    value: exists(claudeDir) ? "\uAC10\uC9C0\uB428 (.claude/ \uC788\uC74C)" : "\uC5C6\uC74C"
+  });
+  const agentsMd = path.join(base, "AGENTS.md");
+  checks.push({
+    group: "\uC5D0\uC774\uC804\uD2B8",
+    name: "Codex",
+    status: "info",
+    value: exists(agentsMd) ? "\uAC10\uC9C0\uB428 (AGENTS.md \uC788\uC74C)" : "\uC5C6\uC74C"
+  });
+  const skillDir = path.join(base, ".claude", "skills", "awl-loop");
+  const claudeInstalled = exists(skillDir);
+  const claudeMismatch = findMismatch(versionResult, "claude-skill-vs-engine");
+  checks.push({
+    group: "\uC5D0\uC774\uC804\uD2B8",
+    name: "Claude \uC2A4\uD0AC \uBC84\uC804",
+    status: !claudeInstalled ? "warn" : claudeMismatch ? "warn" : "ok",
+    value: !claudeInstalled ? "\uC124\uCE58 \uC548 \uB428" : claudeMismatch ? claudeMismatch.a : "\uC5D4\uC9C4\uACFC \uC77C\uCE58",
+    hint: !claudeInstalled ? "awl init \uC5D0\uC11C \uC124\uCE58\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4" : claudeMismatch?.hint
+  });
+  const codexInstalled = exists(agentsMd) && fs.readFileSync(agentsMd, "utf8").includes("awl-loop:start");
+  const codexMismatch = findMismatch(versionResult, "codex-skill-vs-engine");
+  checks.push({
+    group: "\uC5D0\uC774\uC804\uD2B8",
+    name: "Codex \uC2A4\uD0AC \uBC84\uC804",
+    status: !codexInstalled ? "warn" : codexMismatch ? "warn" : "ok",
+    value: !codexInstalled ? "\uC124\uCE58 \uC548 \uB428" : codexMismatch ? codexMismatch.a : "\uC5D4\uC9C4\uACFC \uC77C\uCE58",
+    hint: !codexInstalled ? "awl init \uC5D0\uC11C \uC124\uCE58\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4" : codexMismatch?.hint
+  });
+}
+function findMismatch(result, kind) {
+  return result.mismatches.find((m) => m.kind === kind);
+}
+async function collectChecks() {
+  const checks = [];
+  let projectRoot = null;
+  try {
+    projectRoot = findProjectRoot();
+  } catch {
+    projectRoot = null;
+  }
+  const versionResult = checkVersions(gatherVersionInputs(projectRoot));
+  collectEnv(checks);
+  collectGlobal(checks, versionResult);
+  await collectProject(checks, projectRoot, versionResult);
+  collectAgents(checks, projectRoot ?? process.cwd(), versionResult);
+  const problems = checks.filter((c) => c.status === "missing" || c.status === "fail");
+  return { ok: problems.length === 0, checks };
+}
+function renderText(report, c) {
+  const color = makeColors(c.color);
+  const t = makeTokens(c);
+  const { checks } = report;
+  const s = makeSymbols(c);
+  const statusText = (ch) => {
+    const hint = clipToWidth(ch.hint ?? "", 52);
+    switch (ch.status) {
+      case "ok":
+        return signal(c, "ok");
+      case "missing":
+      case "fail":
+        return `${signal(c, "error")} ${hint}`;
+      case "warn":
+        return `${signal(c, "warn")} ${hint}`;
+      default:
+        return "";
+    }
+  };
+  const lines = [];
+  const maxWidth = c.tty ? Math.max(56, Math.min(96, (process.stdout.columns ?? 100) - 4)) : 96;
+  const groups = [...new Set(checks.map((ch) => ch.group))];
+  for (const group of groups) {
+    lines.push(color.bold(group));
+    const groupChecks = checks.filter((x) => x.group === group);
+    for (let i = 0; i < groupChecks.length; i++) {
+      const ch = groupChecks[i];
+      const status = statusText(ch);
+      const branch = i === groupChecks.length - 1 ? s.lastBranch : s.branch;
+      const base = `${branch} ${ch.name}: ${t.emphasis(ch.value ?? "(\uC5C6\uC74C)")}`;
+      let line = clipToWidth(
+        base,
+        status ? Math.max(24, maxWidth - visibleWidth(status) - 2) : maxWidth
+      );
+      if (status) {
+        line += `  ${status}`;
+      }
+      lines.push(line);
+    }
+    lines.push("");
+  }
+  const problems = report.checks.filter((ch) => ch.status === "missing" || ch.status === "fail");
+  if (problems.length === 0) {
+    lines.push(`${signal(c, "ok")} \uBAA8\uB450 \uC815\uC0C1\uC785\uB2C8\uB2E4.`);
+  } else {
+    const action = problems.some((p) => (p.hint ?? "").includes("init")) ? "awl init \uC744 \uC2E4\uD589\uD558\uC138\uC694." : "\uC704 \uC548\uB0B4\uB97C \uD655\uC778\uD558\uC138\uC694.";
+    lines.push(`${signal(c, "error")} ${color.red(`\uBB38\uC81C ${problems.length}\uAC1C.`)} ${action}`);
+  }
+  return card("Agent Work Loop \xB7 \uC9C4\uB2E8", lines, c);
+}
+async function runDoctor(opts) {
+  const report = await collectChecks();
+  if (opts.json) {
+    process.stdout.write(`${JSON.stringify(report, null, 2)}
+`);
+  } else {
+    process.stdout.write(`${renderText(report, caps())}
+`);
+  }
+  process.exit(report.ok ? 0 : 1);
+}
+
+export {
+  gitBranch,
+  gitDirtyFiles,
+  gitHasCommits,
+  detectRecordTrailGap,
+  detectNamingConvention,
+  computeFileSizeOutliers,
+  collectChecks,
+  renderText,
+  runDoctor
+};