agent-work-loop 0.0.0 → 0.6.23

package/dist/chunk-I77CXOEX.js

@@ -0,0 +1,693 @@
+import {
+  getCriterion,
+  loadState,
+  writeState
+} from "./chunk-4OCSYHYB.js";
+import {
+  resolveProjectRoot,
+  run
+} from "./chunk-UOPWVM2H.js";
+import {
+  caps,
+  card,
+  makeColors,
+  recordsDir,
+  signal
+} from "./chunk-7SYRDDTX.js";
+
+// src/commands/record.ts
+import crypto from "crypto";
+import fs from "fs";
+import path from "path";
+var NARRATIVE_KINDS = [
+  "gate-caught",
+  "reviewer-caught",
+  "spike-prevented",
+  "blocked-discarded",
+  "tool-failed"
+];
+var GATE1_DECISIONS = ["approved", "modified", "rejected", "split"];
+var GATE2_DECISIONS = ["approved", "more-work", "abandoned"];
+var AWL_FEEDBACK_AREAS = [
+  "commit",
+  "review",
+  "gate",
+  "verify",
+  "state",
+  "init",
+  "cli",
+  "\uAE30\uD0C0"
+];
+var AWL_FEEDBACK_SEVERITIES = ["high", "medium", "low"];
+var REFACTOR_KINDS = [
+  "split",
+  "dedup",
+  "abstraction",
+  "rename",
+  "inline",
+  "\uAE30\uD0C0"
+];
+var DEFER_SEVERITIES = ["high", "medium", "low"];
+function shouldDefer(severity, threshold = "high") {
+  const levels = DEFER_SEVERITIES;
+  const sevRank = levels.indexOf(severity);
+  if (sevRank === -1) {
+    return true;
+  }
+  const thrRank = levels.indexOf(threshold);
+  const effectiveThr = thrRank === -1 ? 0 : thrRank;
+  return sevRank <= effectiveThr;
+}
+var SCHEMAS = {
+  audit: { required: ["scope", "findings"], arrays: ["findings"] },
+  spike: { required: ["question", "found"] },
+  criteria: { required: ["items"], arrays: ["items"] },
+  // WI-U: why/how/alternatives 는 diff 크기(diffTier)에 따라 조건부로 요구된다
+  // (buildRecord 의 attempt 전용 분기가 처리). what/result 만 무조건 필수.
+  // result:'verified' 는 코드 변경 없이 확인만 한 가드/검증형 완료조건 — 직전 커밋을
+  // 재지 않고 why/how 를 면제한다(what 만으로 통과, 피드백 F-3).
+  attempt: { required: ["what", "result"] },
+  blocked: { required: ["what", "why", "tried", "lesson"], arrays: ["tried"] },
+  // WI-S: target/verdict(이분법) 를 reviewId/criteria/findings/cheatingDetected/
+  // verifyPassedBefore 로 전면 교체 — target≈criteria, verdict≈findings.length 로
+  // 정보 손실 없이 표현되므로 예전 필드는 없앤다(과거 기록은 append-only 로 그대로
+  // 유효하게 남는다, D-33 원칙). criteria 만 비어있지 않은 배열을 강제한다 —
+  // findings/cheatingDetected 는 존재는 필수지만 빈 배열(지적/부정행위 없음)도
+  // 정당한 결과라 비어있어도 통과한다.
+  review: {
+    required: ["reviewId", "criteria", "findings", "cheatingDetected", "verifyPassedBefore"],
+    arrays: ["criteria"],
+    arraysAllowEmpty: ["findings", "cheatingDetected"]
+  },
+  decision: { required: ["question", "decision", "rationale"] },
+  "gotcha-applied": { required: ["gotchaId", "what"] },
+  "gotcha-missed": { required: ["gotchaId", "what", "why"] },
+  narrative: { required: ["kind", "counterfactual"] },
+  gate: { required: ["gate", "decision", "presentedCriteria"], arrays: ["presentedCriteria"] },
+  clarify: { required: ["questions"], arrays: ["questions"] },
+  // awl-feedback(0.6.x): awl 도구 자체가 아팠던 점. gotcha(작업 코드 교훈)와 다른
+  // 종류다 — records/ 에 쌓이고 gotcha 로 승격되지 않는다. area 가 모으기의 키.
+  // suggestion 은 선택(개선 아이디어, 강제 아님 — 번역은 사람 몫).
+  "awl-feedback": { required: ["area", "what", "impact", "severity"] },
+  // 자율 통과를 보류하고 사람에게 최종 문의할 중요 항목(보류 큐).
+  // recommendation(자율로 택했을 권장 결정)/gate(어느 게이트)/addresses 는 선택(D-15).
+  defer: { required: ["severity", "what", "why"] },
+  // 반복 루프 리팩토링 체크포인트에서 실제 리팩토링이 일어났을 때 남긴다
+  // (loop-refactor-checkpoint). kind 가 성격, what 이 무엇을 정리했나.
+  refactor: { required: ["what", "kind"] }
+};
+var RECORD_TYPES = Object.keys(SCHEMAS);
+var BANNED_QUALITATIVE_WORDS = [
+  "\uC800\uC704\uD5D8",
+  "\uC8FC\uC694\uD55C",
+  "\uC801\uC808\uD55C",
+  "\uAC00\uB2A5\uD55C \uB9CC\uD07C",
+  "\uD544\uC694\uC2DC"
+];
+function isHangulSyllable(ch) {
+  const code = ch.codePointAt(0) ?? 0;
+  return code >= 44032 && code <= 55203;
+}
+function includesBannedWord(text, word) {
+  let idx = text.indexOf(word);
+  while (idx !== -1) {
+    const before = idx > 0 ? text[idx - 1] : void 0;
+    const after = idx + word.length < text.length ? text[idx + word.length] : void 0;
+    const attachedToHangul = before !== void 0 && isHangulSyllable(before) || after !== void 0 && isHangulSyllable(after);
+    if (!attachedToHangul) {
+      return true;
+    }
+    idx = text.indexOf(word, idx + 1);
+  }
+  return false;
+}
+function newRecordId() {
+  return `rec_${crypto.randomBytes(9).toString("hex")}`;
+}
+function buildRecord(type, data, defaults) {
+  const missing = [];
+  const project = typeof data.project === "string" && data.project.trim() !== "" && data.project || defaults.project;
+  if (!project) {
+    missing.push("project");
+  }
+  const workitem = typeof data.workitem === "string" && data.workitem.trim() !== "" && data.workitem || defaults.workitem;
+  const schema = SCHEMAS[type];
+  for (const field of schema.required) {
+    const v = data[field];
+    if (v === void 0 || v === null || v === "") {
+      missing.push(field);
+    } else if (schema.arrays?.includes(field) && (!Array.isArray(v) || v.length === 0)) {
+      missing.push(`${field} (\uBE44\uC5B4\uC788\uC9C0 \uC54A\uC740 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD568)`);
+    } else if (schema.arraysAllowEmpty?.includes(field) && !Array.isArray(v)) {
+      missing.push(`${field} (\uBC30\uC5F4\uC774\uC5B4\uC57C \uD568)`);
+    }
+  }
+  if (type === "criteria" && Array.isArray(data.items)) {
+    for (const item of data.items) {
+      const text = JSON.stringify(item);
+      for (const word of BANNED_QUALITATIVE_WORDS) {
+        if (includesBannedWord(text, word)) {
+          missing.push(
+            `items(${String(item?.id ?? "?")}) \uC5D0 \uAE08\uC9C0\uB41C \uC9C8\uC801 \uD45C\uD604 "${word}" \u2014 \uC5F4\uAC70 \uAC00\uB2A5\uD558\uAC70\uB098 \uC218\uCE58\uD654 \uAC00\uB2A5\uD558\uAC8C \uB2E4\uC2DC \uC4F0\uC138\uC694`
+          );
+        }
+      }
+    }
+  }
+  if (type === "attempt") {
+    const tier = typeof data.diffTier === "string" ? data.diffTier : void 0;
+    const isFailed = data.result === "failed";
+    const isVerified = data.result === "verified";
+    const requiresFullDetail = isFailed || !isVerified && tier !== "minimal";
+    if (requiresFullDetail) {
+      for (const field of ["why", "how"]) {
+        const v = data[field];
+        if (v === void 0 || v === null || v === "") {
+          missing.push(field);
+        }
+      }
+    }
+    if (tier === "detailed") {
+      const alt = data.alternatives;
+      if (!Array.isArray(alt) || alt.length === 0) {
+        missing.push(
+          "alternatives (\uBE44\uC5B4\uC788\uC9C0 \uC54A\uC740 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD568 \u2014 diff \uAC00 \uD06C\uBA74 \uC124\uACC4 \uB300\uC548\uC744 \uB0A8\uACA8\uC57C \uD569\uB2C8\uB2E4)"
+        );
+      }
+    }
+  }
+  if (type === "decision" && data.performanceSensitive === true) {
+    const alt = data.alternatives;
+    if (!Array.isArray(alt) || alt.length === 0) {
+      missing.push(
+        "alternatives (\uBE44\uC5B4\uC788\uC9C0 \uC54A\uC740 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD568 \u2014 performanceSensitive:true \uC778 \uACB0\uC815\uC740 \uB300\uC548\uC744 \uB0A8\uACA8\uC57C \uD569\uB2C8\uB2E4)"
+      );
+    }
+  }
+  if (type === "narrative") {
+    const kindMissing = data.kind === void 0 || data.kind === null || data.kind === "";
+    if (!kindMissing && !NARRATIVE_KINDS.includes(data.kind)) {
+      missing.push(`kind (\uB2E4\uC74C \uC911 \uD558\uB098\uC5EC\uC57C \uD568: ${NARRATIVE_KINDS.join(", ")})`);
+    }
+  }
+  if (type === "gate") {
+    const gateMissing = data.gate === void 0 || data.gate === null || data.gate === "";
+    if (!gateMissing && data.gate !== 1 && data.gate !== 2) {
+      missing.push("gate (1 \uB610\uB294 2\uC5EC\uC57C \uD568)");
+    }
+    const decisionMissing = data.decision === void 0 || data.decision === null || data.decision === "";
+    if (!decisionMissing && (data.gate === 1 || data.gate === 2)) {
+      const allowed = data.gate === 1 ? GATE1_DECISIONS : GATE2_DECISIONS;
+      if (!allowed.includes(data.decision)) {
+        missing.push(
+          `decision (gate ${data.gate} \uC5D0\uC11C\uB294 \uB2E4\uC74C \uC911 \uD558\uB098\uC5EC\uC57C \uD568: ${allowed.join(", ")})`
+        );
+      }
+    }
+  }
+  if (type === "awl-feedback") {
+    const areaMissing = data.area === void 0 || data.area === null || data.area === "";
+    if (!areaMissing && !AWL_FEEDBACK_AREAS.includes(data.area)) {
+      missing.push(`area (\uB2E4\uC74C \uC911 \uD558\uB098\uC5EC\uC57C \uD568: ${AWL_FEEDBACK_AREAS.join(", ")})`);
+    }
+    const sevMissing = data.severity === void 0 || data.severity === null || data.severity === "";
+    if (!sevMissing && !AWL_FEEDBACK_SEVERITIES.includes(data.severity)) {
+      missing.push(`severity (\uB2E4\uC74C \uC911 \uD558\uB098\uC5EC\uC57C \uD568: ${AWL_FEEDBACK_SEVERITIES.join(", ")})`);
+    }
+  }
+  if (type === "defer") {
+    const sevMissing = data.severity === void 0 || data.severity === null || data.severity === "";
+    if (!sevMissing && !DEFER_SEVERITIES.includes(data.severity)) {
+      missing.push(`severity (\uB2E4\uC74C \uC911 \uD558\uB098\uC5EC\uC57C \uD568: ${DEFER_SEVERITIES.join(", ")})`);
+    }
+  }
+  if (type === "refactor") {
+    const kindMissing = data.kind === void 0 || data.kind === null || data.kind === "";
+    if (!kindMissing && !REFACTOR_KINDS.includes(data.kind)) {
+      missing.push(`kind (\uB2E4\uC74C \uC911 \uD558\uB098\uC5EC\uC57C \uD568: ${REFACTOR_KINDS.join(", ")})`);
+    }
+  }
+  if (missing.length > 0) {
+    return { missing };
+  }
+  const { workitem: _dataWorkitem, ...dataWithoutWorkitem } = data;
+  const record = {
+    id: defaults.id,
+    at: defaults.at,
+    project,
+    type,
+    ...dataWithoutWorkitem
+  };
+  record.project = project;
+  record.type = type;
+  record.id = defaults.id;
+  record.at = defaults.at;
+  if (workitem) {
+    record.workitem = workitem;
+  }
+  return { record, missing: [] };
+}
+function resolveBlockedBaseline(data, state) {
+  const focus = typeof data.criterion === "string" && data.criterion || (typeof state.currentFocus === "string" ? state.currentFocus : void 0);
+  if (!focus) {
+    return void 0;
+  }
+  const crit = getCriterion(state, focus);
+  return crit && typeof crit.baseline === "string" ? crit.baseline : void 0;
+}
+function detailTierFor(size) {
+  if (size.files >= 3 || size.lines >= 50) {
+    return "detailed";
+  }
+  if (size.files <= 1 && size.lines < 10) {
+    return "minimal";
+  }
+  return "brief";
+}
+async function measureDiffSize(cwd, args) {
+  const r = await run({ cmd: "git", args, cwd, timeoutMs: 1e4 });
+  if (r.exitCode !== 0) {
+    return null;
+  }
+  const rows = r.stdout.split("\n").filter((l) => l.trim() !== "");
+  let lines = 0;
+  for (const row of rows) {
+    const [add, del] = row.split("	");
+    lines += (Number(add) || 0) + (Number(del) || 0);
+  }
+  return { files: rows.length, lines };
+}
+function computeCoverage(auditRecords, criteria, criteriaRecords = []) {
+  const findingIds = /* @__PURE__ */ new Set();
+  for (const r of auditRecords) {
+    const findings = Array.isArray(r.findings) ? r.findings : [];
+    for (const f of findings) {
+      if (f && typeof f === "object" && typeof f.id === "string") {
+        findingIds.add(f.id);
+      }
+    }
+  }
+  const addressedRefs = /* @__PURE__ */ new Set();
+  const stateHasAddresses = /* @__PURE__ */ new Set();
+  for (const c of criteria) {
+    if (Array.isArray(c.addresses)) {
+      stateHasAddresses.add(String(c.id));
+      for (const a of c.addresses) {
+        if (typeof a === "string") {
+          addressedRefs.add(a);
+        }
+      }
+    }
+  }
+  for (const rec of criteriaRecords) {
+    const items = Array.isArray(rec.items) ? rec.items : [];
+    for (const item of items) {
+      const id = item && typeof item === "object" ? item.id : void 0;
+      if (typeof id !== "string" || stateHasAddresses.has(id)) {
+        continue;
+      }
+      const addresses = item.addresses;
+      if (Array.isArray(addresses)) {
+        for (const a of addresses) {
+          if (typeof a === "string") {
+            addressedRefs.add(a);
+          }
+        }
+      }
+    }
+  }
+  const auditFindingIds = [...findingIds];
+  const addressedIds = auditFindingIds.filter((id) => addressedRefs.has(id));
+  const excludedIds = auditFindingIds.filter((id) => !addressedRefs.has(id));
+  return { auditFindingIds, addressedIds, excludedIds };
+}
+function monthFile(at) {
+  const month = at.slice(0, 7);
+  return path.join(recordsDir(), `${month}.jsonl`);
+}
+function appendRecord(record) {
+  const file = monthFile(String(record.at));
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.appendFileSync(file, `${JSON.stringify(record)}
+`);
+  return file;
+}
+async function captureDiff(id, at, cwd) {
+  const r = await run({ cmd: "git", args: ["diff", "HEAD"], cwd, timeoutMs: 1e4 });
+  if (r.exitCode !== 0 && r.stdout.trim() === "") {
+    return null;
+  }
+  const diffsDir = path.join(recordsDir(), "diffs");
+  fs.mkdirSync(diffsDir, { recursive: true });
+  const name = `${at.slice(0, 10)}-${id}.patch`;
+  fs.writeFileSync(path.join(diffsDir, name), r.stdout);
+  return path.join("diffs", name);
+}
+function selectMonthFiles(files, filter = {}) {
+  const jsonl = files.filter((f) => f.endsWith(".jsonl"));
+  const monthOf = (f) => f.slice(0, 7);
+  if (Array.isArray(filter.months)) {
+    const set = new Set(filter.months);
+    return jsonl.filter((f) => set.has(monthOf(f)));
+  }
+  if (filter.from !== void 0 || filter.to !== void 0) {
+    const from = filter.from ?? "0000-00";
+    const to = filter.to ?? "9999-99";
+    return jsonl.filter((f) => {
+      const m = monthOf(f);
+      return m >= from && m <= to;
+    });
+  }
+  return jsonl;
+}
+function readRecords(filter = {}) {
+  const dir = recordsDir();
+  let files;
+  try {
+    files = selectMonthFiles(fs.readdirSync(dir), filter);
+  } catch {
+    return [];
+  }
+  const records = [];
+  for (const f of files.sort()) {
+    let text;
+    try {
+      text = fs.readFileSync(path.join(dir, f), "utf8");
+    } catch {
+      continue;
+    }
+    for (const line of text.split("\n")) {
+      if (line.trim() === "") {
+        continue;
+      }
+      try {
+        records.push(JSON.parse(line));
+      } catch {
+      }
+    }
+  }
+  const filtered = records.filter((r) => {
+    if (filter.type && r.type !== filter.type) {
+      return false;
+    }
+    if (filter.workitem && r.workitem !== filter.workitem) {
+      return false;
+    }
+    return true;
+  });
+  filtered.sort((a, b) => String(b.at).localeCompare(String(a.at)));
+  return filtered;
+}
+function collectDeferred(records) {
+  const levels = DEFER_SEVERITIES;
+  const rank = (s) => {
+    const i = levels.indexOf(s);
+    return i === -1 ? levels.length : i;
+  };
+  return records.filter((r) => r.type === "defer").map((r) => ({
+    severity: String(r.severity ?? ""),
+    what: String(r.what ?? ""),
+    why: String(r.why ?? ""),
+    recommendation: typeof r.recommendation === "string" ? r.recommendation : void 0,
+    gate: r.gate,
+    addresses: r.addresses,
+    at: String(r.at ?? "")
+  })).sort((a, b) => {
+    const d = rank(a.severity) - rank(b.severity);
+    return d !== 0 ? d : b.at.localeCompare(a.at);
+  });
+}
+function renderDeferSummary(items) {
+  if (items.length === 0) {
+    return "\uBCF4\uB958 \uD050\uAC00 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4(\uC0AC\uB78C \uD655\uC778\uC774 \uD544\uC694\uD55C \uC911\uC694 \uD56D\uBAA9 \uC5C6\uC74C).";
+  }
+  const lines = [`\uBCF4\uB958 ${items.length}\uAC74 \u2014 \uC0AC\uB78C \uCD5C\uC885 \uD655\uC778 \uD544\uC694:`];
+  for (const it of items) {
+    lines.push(`  [${it.severity}] ${it.what}`);
+    lines.push(`      \uC65C \uC911\uC694: ${it.why}`);
+    if (it.recommendation !== void 0) {
+      lines.push(`      \uAD8C\uC7A5(\uC790\uC728 \uC2DC): ${it.recommendation}`);
+    }
+  }
+  return lines.join("\n");
+}
+function runDeferSummary(opts) {
+  const projectRoot = resolveProjectRoot();
+  let workitem = opts.workitem;
+  if (workitem === void 0 && projectRoot) {
+    const state = loadState(projectRoot);
+    workitem = typeof state.workitem === "string" && state.workitem.trim() !== "" ? state.workitem : void 0;
+  }
+  const items = collectDeferred(readRecords({ type: "defer", workitem }));
+  if (opts.json === true) {
+    process.stdout.write(`${JSON.stringify({ workitem, count: items.length, items }, null, 2)}
+`);
+    return;
+  }
+  process.stdout.write(`${renderDeferSummary(items)}
+`);
+}
+function hasApprovedGate1(workitem) {
+  if (typeof workitem !== "string" || workitem === "") {
+    return false;
+  }
+  return readRecords({ type: "gate", workitem }).some(
+    (r) => r.gate === 1 && r.decision === "approved"
+  );
+}
+function summaryOf(r) {
+  if (r.type === "review" && typeof r.reviewId === "string") {
+    const findings = Array.isArray(r.findings) ? r.findings.length : 0;
+    const cheating = Array.isArray(r.cheatingDetected) ? r.cheatingDetected.length : 0;
+    const cheatingNote = cheating > 0 ? `, \uBD80\uC815\uD589\uC704 ${cheating}\uAC74` : "";
+    return `${r.reviewId} \u2014 findings ${findings}\uAC74${cheatingNote}`;
+  }
+  const cand = r.what ?? r.scope ?? r.question ?? r.target ?? r.decision ?? "(\uC694\uC57D \uC5C6\uC74C)";
+  return String(cand);
+}
+function renderRecords(records, c) {
+  const color = makeColors(c.color);
+  if (records.length === 0) {
+    return card("\uAE30\uB85D", ["\uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."], c);
+  }
+  const out = [];
+  for (const r of records) {
+    const type = String(r.type).padEnd(9, " ");
+    const wi = r.workitem ? `${String(r.workitem)} ` : "";
+    const date = String(r.at).slice(0, 10);
+    out.push(`${color.dim(date)}  ${color.bold(type)} ${color.dim(wi)}${summaryOf(r)}`);
+  }
+  out.push("");
+  out.push(color.dim("\uC0C1\uC138\uB294 awl records --json \uB610\uB294 ~/.awl/records/ \uB97C \uBCF4\uC138\uC694."));
+  return card(`\uAE30\uB85D ${records.length}\uAC1C \xB7 \uCD5C\uADFC\uC21C`, out, c);
+}
+async function runRecord(type, opts) {
+  if (!RECORD_TYPES.includes(type)) {
+    process.stderr.write(
+      `
+  ${signal(caps(), "error")} \uC54C \uC218 \uC5C6\uB294 \uAE30\uB85D \uD0C0\uC785: ${type}
+  \uAC00\uB2A5: ${RECORD_TYPES.join(", ")}
+`
+    );
+    process.exit(1);
+  }
+  let data = {};
+  try {
+    if (opts.file) {
+      data = JSON.parse(fs.readFileSync(opts.file, "utf8"));
+    } else if (opts.json) {
+      data = JSON.parse(opts.json);
+    }
+  } catch (e) {
+    process.stderr.write(
+      `
+  ${signal(caps(), "error")} \uB370\uC774\uD130 JSON \uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${String(e)}
+`
+    );
+    process.exit(1);
+  }
+  if (typeof data !== "object" || data === null) {
+    process.stderr.write(`
+  ${signal(caps(), "error")} \uB370\uC774\uD130\uB294 JSON \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4.
+`);
+    process.exit(1);
+  }
+  const projectRoot = resolveProjectRoot();
+  let projectFromConfig;
+  let currentWorkitem;
+  let state = {};
+  if (projectRoot) {
+    projectFromConfig = loadProjectName(projectRoot);
+    state = loadState(projectRoot);
+    currentWorkitem = typeof state.workitem === "string" && state.workitem.trim() !== "" ? state.workitem : void 0;
+  }
+  const dataWorkitem = typeof data.workitem === "string" && data.workitem.trim() !== "" ? data.workitem : void 0;
+  const cliWorkitem = typeof opts.workitem === "string" && opts.workitem.trim() !== "" ? opts.workitem : void 0;
+  const defaultWorkitem = cliWorkitem ?? currentWorkitem;
+  if (!dataWorkitem && !defaultWorkitem) {
+    const hint = projectRoot ? "" : " (\uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4 \u2014 awl init \uC744 \uC2E4\uD589\uD588\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694.)";
+    process.stderr.write(
+      `
+  ${signal(caps(), "error")} \uD65C\uC131 \uC6CC\uD06C\uC544\uC774\uD15C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.${hint} awl work new <id> [\uC124\uBA85] \uC73C\uB85C \uC2DC\uC791\uD558\uC138\uC694.
+  (\uC774 \uAE30\uB85D \uD558\uB098\uB9CC \uB2E4\uB978 \uC6CC\uD06C\uC544\uC774\uD15C\uC73C\uB85C \uB0A8\uAE30\uB824\uBA74 --workitem <id> \uB97C \uC4F0\uC138\uC694)
+`
+    );
+    process.exit(1);
+  }
+  const id = newRecordId();
+  const at = (/* @__PURE__ */ new Date()).toISOString();
+  if (opts.diff && type === "blocked" && projectRoot && data.diff === void 0) {
+    const rel = await captureDiff(id, at, projectRoot);
+    if (rel) {
+      data.diff = rel;
+    }
+  }
+  if (type === "blocked" && projectRoot && data.baseline === void 0) {
+    const baseline = resolveBlockedBaseline(data, state);
+    if (baseline) {
+      data.baseline = baseline;
+    }
+  }
+  if (type === "attempt" && projectRoot && data.diffTier === void 0 && data.result !== "verified") {
+    const diffArgs = data.result === "failed" ? ["diff", "--numstat", "HEAD"] : ["show", "--numstat", "--format=", "HEAD"];
+    const size = await measureDiffSize(projectRoot, diffArgs);
+    if (size) {
+      const tier = detailTierFor(size);
+      data.diffTier = tier;
+      const guidance = tier === "minimal" ? "what \uB9CC \uC788\uC73C\uBA74 \uB429\uB2C8\uB2E4." : tier === "detailed" ? "what/why/how \uC640 alternatives(\uC124\uACC4 \uB300\uC548)\uB97C \uCC44\uC6B0\uC138\uC694." : "what/why/how \uB97C \uCC44\uC6B0\uC138\uC694.";
+      process.stderr.write(`
+  \uC774 \uBCC0\uACBD\uC740 ${size.lines}\uC904/${size.files}\uD30C\uC77C\uC785\uB2C8\uB2E4. ${guidance}
+`);
+    }
+  }
+  const { record, missing } = buildRecord(type, data, {
+    project: projectFromConfig,
+    workitem: defaultWorkitem,
+    id,
+    at
+  });
+  if (!record) {
+    process.stderr.write(
+      `
+  ${signal(caps(), "error")} \uAE30\uB85D\uC744 \uAC70\uBD80\uD588\uC2B5\uB2C8\uB2E4. \uBE60\uC9C4 \uD544\uC218 \uD544\uB4DC: ${missing.join(", ")}
+`
+    );
+    process.stderr.write(
+      `  ${type} \uC5D0 \uD544\uC694\uD55C \uD544\uB4DC: ${SCHEMAS[type].required.join(", ")}
+`
+    );
+    process.exit(1);
+  }
+  if (type === "gate" && data.gate === 1) {
+    const workitemForCheck = typeof record.workitem === "string" ? record.workitem : void 0;
+    if (workitemForCheck) {
+      const criteria = Array.isArray(state.criteria) ? state.criteria : [];
+      const auditRecords = readRecords({ type: "audit", workitem: workitemForCheck });
+      const criteriaRecords = readRecords({ type: "criteria", workitem: workitemForCheck });
+      const coverage = computeCoverage(auditRecords, criteria, criteriaRecords);
+      if (coverage.excludedIds.length > 0) {
+        const presented = Array.isArray(data.presentedExclusions) ? data.presentedExclusions : [];
+        const presentedIds = new Set(
+          presented.map((p) => typeof p === "string" ? p : p?.id).filter((id2) => typeof id2 === "string")
+        );
+        const uncovered = coverage.excludedIds.filter((id2) => !presentedIds.has(id2));
+        if (uncovered.length > 0) {
+          process.stderr.write(
+            `
+  ${signal(caps(), "error")} \uAC8C\uC774\uD2B8 1 \uAE30\uB85D\uC744 \uAC70\uBD80\uD588\uC2B5\uB2C8\uB2E4. \uB2E4\uC74C \uBC1C\uACAC\uC774 \uC644\uB8CC \uC870\uAC74\uC758 addresses \uC5D0\uB3C4, presentedExclusions \uC5D0\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4: ${uncovered.join(", ")}
+  \uC644\uB8CC \uC870\uAC74\uC5D0 addresses \uB85C \uC5F0\uACB0\uD558\uAC70\uB098, presentedExclusions \uC5D0 \uB2F4\uC544 \uC0AC\uB78C\uC5D0\uAC8C \uC81C\uC2DC\uD558\uC138\uC694.
+`
+          );
+          process.exit(1);
+        }
+      }
+    }
+  }
+  const file = appendRecord(record);
+  if (projectRoot && type === "gate" && data.gate === 1 && data.decision === "approved") {
+    writeState(projectRoot, { ...state, phase: "loop", loop: "loop" });
+  }
+  if (type === "gate" && data.gate === 2) {
+    const passedCount = Array.isArray(state.criteria) ? state.criteria.filter((c) => c.status === "passed").length : 0;
+    const workitemForCheck = typeof record.workitem === "string" ? record.workitem : void 0;
+    if (passedCount >= 3 && workitemForCheck) {
+      const hasReview = readRecords({ type: "review", workitem: workitemForCheck }).length > 0;
+      if (!hasReview) {
+        process.stderr.write(
+          `
+  ${signal(caps(), "warn")} \uC644\uB8CC \uC870\uAC74 ${passedCount}\uAC1C\uAC00 \uD1B5\uACFC\uD588\uC73C\uB098 \uB9AC\uBDF0 \uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.
+  \uB9AC\uBDF0\uB97C \uAC74\uB108\uB6F0\uC5C8\uC2B5\uB2C8\uAE4C?
+`
+        );
+      }
+    }
+    const criteria = Array.isArray(state.criteria) ? state.criteria : [];
+    const allPassedFirstTry = criteria.length > 0 && criteria.every((c) => c.status === "passed" && (Number(c.attempts) || 0) === 0);
+    if (allPassedFirstTry) {
+      const auditRecords = workitemForCheck ? readRecords({ type: "audit", workitem: workitemForCheck }) : [];
+      const criteriaRecords = workitemForCheck ? readRecords({ type: "criteria", workitem: workitemForCheck }) : [];
+      const coverage = computeCoverage(auditRecords, criteria, criteriaRecords);
+      process.stderr.write(
+        `
+  \uC644\uB8CC \uC870\uAC74 ${criteria.length}\uAC1C \uC804\uBD80 1\uCC28 \uD1B5\uACFC. \uB9C9\uD798 0\uAC74.
+  \uC870\uC0AC\uC5D0\uC11C \uBC1C\uACAC\uD55C ${coverage.auditFindingIds.length}\uAC74 \uC911 ${coverage.addressedIds.length}\uAC74\uC744 \uB2E4\uB918\uC2B5\uB2C8\uB2E4.
+  \uC644\uB8CC \uC870\uAC74\uC774 \uCDA9\uBD84\uD788 \uC57C\uC2EC\uCC3C\uC2B5\uB2C8\uAE4C?
+`
+      );
+    }
+  }
+  process.stdout.write(`${JSON.stringify({ id, at, file })}
+`);
+}
+function loadProjectName(projectRoot) {
+  try {
+    const p = path.join(projectRoot, ".awl", "config.json");
+    const j = JSON.parse(fs.readFileSync(p, "utf8"));
+    return typeof j.project === "string" ? j.project : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function runRecords(opts) {
+  const records = readRecords({ type: opts.type, workitem: opts.workitem });
+  if (opts.json) {
+    process.stdout.write(`${JSON.stringify(records, null, 2)}
+`);
+    return;
+  }
+  process.stdout.write(`${renderRecords(records, caps())}
+`);
+}
+
+export {
+  NARRATIVE_KINDS,
+  GATE1_DECISIONS,
+  GATE2_DECISIONS,
+  AWL_FEEDBACK_AREAS,
+  AWL_FEEDBACK_SEVERITIES,
+  REFACTOR_KINDS,
+  DEFER_SEVERITIES,
+  shouldDefer,
+  SCHEMAS,
+  RECORD_TYPES,
+  BANNED_QUALITATIVE_WORDS,
+  newRecordId,
+  buildRecord,
+  resolveBlockedBaseline,
+  detailTierFor,
+  measureDiffSize,
+  computeCoverage,
+  monthFile,
+  appendRecord,
+  captureDiff,
+  selectMonthFiles,
+  readRecords,
+  collectDeferred,
+  renderDeferSummary,
+  runDeferSummary,
+  hasApprovedGate1,
+  renderRecords,
+  runRecord,
+  loadProjectName,
+  runRecords
+};