agent-work-loop 0.0.0 → 0.6.23

package/dist/chunk-G5LAJ5TV.js

@@ -0,0 +1,453 @@
+import {
+  computeDurationMs
+} from "./chunk-F5LHXBH7.js";
+import {
+  computeCoverage,
+  readRecords
+} from "./chunk-I77CXOEX.js";
+import {
+  loadState
+} from "./chunk-4OCSYHYB.js";
+import {
+  requireConfig
+} from "./chunk-UOPWVM2H.js";
+import {
+  caps,
+  generationsDir,
+  gotchasDir,
+  legacyDeltasDir,
+  lockFile,
+  makeColors,
+  signal
+} from "./chunk-7SYRDDTX.js";
+
+// src/commands/evolve.ts
+import fs from "fs";
+import path from "path";
+function acquireLock() {
+  const p = lockFile();
+  try {
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const fd = fs.openSync(p, "wx");
+    fs.writeSync(fd, JSON.stringify({ pid: process.pid }));
+    fs.closeSync(fd);
+    return true;
+  } catch (e) {
+    if (e.code === "EEXIST") {
+      return false;
+    }
+    throw e;
+  }
+}
+function releaseLock() {
+  try {
+    fs.unlinkSync(lockFile());
+  } catch {
+  }
+}
+var GOTCHA_RELATION_TYPES = ["duplicates", "refines", "supersedes"];
+function normalizeRelations(raw) {
+  if (raw === void 0 || raw === null) {
+    return { ok: true };
+  }
+  if (!Array.isArray(raw)) {
+    return { ok: false, error: "relations \uB294 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4." };
+  }
+  const out = [];
+  for (const item of raw) {
+    if (typeof item !== "object" || item === null) {
+      return { ok: false, error: "relations \uD56D\uBAA9\uC740 {type,target} \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4." };
+    }
+    const r = item;
+    if (typeof r.type !== "string" || !GOTCHA_RELATION_TYPES.includes(r.type)) {
+      return {
+        ok: false,
+        error: `relations.type \uC740 ${GOTCHA_RELATION_TYPES.join("/")} \uC911 \uD558\uB098\uC5EC\uC57C \uD569\uB2C8\uB2E4.`
+      };
+    }
+    if (typeof r.target !== "string" || r.target.trim() === "") {
+      return { ok: false, error: "relations.target(\uB300\uC0C1 gotcha id)\uC774 \uD544\uC694\uD569\uB2C8\uB2E4." };
+    }
+    out.push({ type: r.type, target: r.target });
+  }
+  return { ok: true, relations: out.length > 0 ? out : void 0 };
+}
+function remapDeltaId(id) {
+  if (typeof id !== "string") {
+    return id;
+  }
+  const m = /^D-(\d+)$/.exec(id);
+  return m ? `G-${m[1]}` : id;
+}
+function migrateDeltasToGotchas() {
+  if (fs.existsSync(gotchasDir())) {
+    return { migrated: false, count: 0 };
+  }
+  const dDir = legacyDeltasDir();
+  let files;
+  try {
+    files = fs.readdirSync(dDir).filter((f) => f.endsWith(".json"));
+  } catch {
+    return { migrated: false, count: 0 };
+  }
+  if (files.length === 0) {
+    return { migrated: false, count: 0 };
+  }
+  const backupDir = `${dDir}.backup-${Date.now()}`;
+  fs.mkdirSync(backupDir, { recursive: true });
+  for (const f of files) {
+    fs.copyFileSync(path.join(dDir, f), path.join(backupDir, f));
+  }
+  fs.mkdirSync(gotchasDir(), { recursive: true });
+  let count = 0;
+  for (const f of files) {
+    try {
+      const raw = JSON.parse(fs.readFileSync(path.join(dDir, f), "utf8"));
+      const migrated = {
+        ...raw,
+        id: remapDeltaId(raw.id),
+        ...raw.sameAs !== void 0 ? { sameAs: remapDeltaId(raw.sameAs) } : {}
+      };
+      fs.writeFileSync(
+        path.join(gotchasDir(), `${migrated.id}.json`),
+        `${JSON.stringify(migrated, null, 2)}
+`
+      );
+      count += 1;
+    } catch {
+    }
+  }
+  return { migrated: true, count, backupDir };
+}
+function loadGotchaList() {
+  migrateDeltasToGotchas();
+  let files;
+  try {
+    files = fs.readdirSync(gotchasDir()).filter((f) => f.endsWith(".json"));
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const f of files.sort()) {
+    try {
+      out.push(JSON.parse(fs.readFileSync(path.join(gotchasDir(), f), "utf8")));
+    } catch {
+    }
+  }
+  return out;
+}
+function writeGotcha(g) {
+  fs.mkdirSync(gotchasDir(), { recursive: true });
+  fs.writeFileSync(path.join(gotchasDir(), `${g.id}.json`), `${JSON.stringify(g, null, 2)}
+`);
+}
+function nextGotchaId(gotchas) {
+  let max = 0;
+  for (const g of gotchas) {
+    const m = /^G-(\d+)$/.exec(g.id);
+    if (m?.[1]) {
+      max = Math.max(max, Number(m[1]));
+    }
+  }
+  return `G-${String(max + 1).padStart(3, "0")}`;
+}
+function gotchaCluster(seedId, gotchas, maxHops = Number.POSITIVE_INFINITY) {
+  const byId = new Map(gotchas.map((g) => [g.id, g]));
+  const adj = /* @__PURE__ */ new Map();
+  const link = (a, b) => {
+    if (!adj.has(a)) adj.set(a, /* @__PURE__ */ new Set());
+    if (!adj.has(b)) adj.set(b, /* @__PURE__ */ new Set());
+    adj.get(a)?.add(b);
+    adj.get(b)?.add(a);
+  };
+  for (const g of gotchas) {
+    if (g.sameAs) link(g.id, g.sameAs);
+    for (const r of g.relations ?? []) link(g.id, r.target);
+  }
+  const visited = /* @__PURE__ */ new Set([seedId]);
+  let frontier = [seedId];
+  let hop = 0;
+  while (frontier.length > 0 && hop < maxHops) {
+    const next = [];
+    for (const id of frontier) {
+      for (const nb of adj.get(id) ?? []) {
+        if (!visited.has(nb)) {
+          visited.add(nb);
+          next.push(nb);
+        }
+      }
+    }
+    frontier = next;
+    hop += 1;
+  }
+  visited.delete(seedId);
+  const out = [];
+  for (const id of visited) {
+    const g = byId.get(id);
+    if (g) out.push(g);
+  }
+  return out;
+}
+function gotchasBySource(workitem, gotchas) {
+  return gotchas.filter((g) => {
+    const src = g.source;
+    return src !== void 0 && src.workitem === workitem;
+  });
+}
+function collectEvolve(project, workitem, state, scope) {
+  const records = readRecords({ ...workitem ? { workitem } : {}, ...scope ?? {} });
+  const blocked = records.filter((r) => r.type === "blocked");
+  const reviews = records.filter((r) => r.type === "review");
+  const retried = records.filter(
+    (r) => r.type === "attempt" && typeof r.attempt === "number" && r.attempt >= 2
+  );
+  const gotchaApplied = records.filter((r) => r.type === "gotcha-applied").length;
+  const gotchaMissed = records.filter((r) => r.type === "gotcha-missed").length;
+  const refactorCount = records.filter((r) => r.type === "refactor").length;
+  const awlFeedbackRecords = records.filter((r) => r.type === "awl-feedback");
+  const criteria = Array.isArray(state.criteria) ? state.criteria : [];
+  const num = (v) => typeof v === "number" ? v : 0;
+  const criteriaTotal = criteria.length;
+  const attemptsSum = criteria.reduce((s, c) => s + num(c.attempts), 0);
+  const blockedCount = criteria.filter((c) => c.status === "blocked").length;
+  const proceduralErrors = criteria.reduce((s, c) => s + num(c.proceduralErrors), 0);
+  const allGotchas = loadGotchaList();
+  const existingGotchas = allGotchas.map((g) => ({
+    id: g.id,
+    lesson: g.lesson,
+    count: g.count
+  }));
+  const relatedIds = /* @__PURE__ */ new Set();
+  if (workitem) {
+    for (const g of gotchasBySource(workitem, allGotchas)) {
+      relatedIds.add(g.id);
+      for (const rel of gotchaCluster(g.id, allGotchas)) {
+        relatedIds.add(rel.id);
+      }
+    }
+  }
+  const relatedGotchas = allGotchas.filter((g) => relatedIds.has(g.id)).map((g) => ({ id: g.id, lesson: g.lesson, count: g.count }));
+  const auditRecords = records.filter((r) => r.type === "audit");
+  const criteriaRecords = records.filter((r) => r.type === "criteria");
+  const gate1 = records.find((r) => r.type === "gate" && r.gate === 1);
+  const coverage = computeCoverage(auditRecords, criteria, criteriaRecords);
+  const coverageMetrics = {
+    auditFindingsTotal: coverage.auditFindingIds.length,
+    addressed: coverage.addressedIds.length,
+    excluded: coverage.excludedIds.length,
+    excludedApprovedByHuman: Boolean(gate1) && gate1?.auto !== true
+  };
+  const metrics = {
+    criteriaTotal,
+    avgAttempts: criteriaTotal > 0 ? Math.round(attemptsSum / criteriaTotal * 100) / 100 : 0,
+    blockedRatio: criteriaTotal > 0 ? Math.round(blockedCount / criteriaTotal * 100) / 100 : 0,
+    reviewRejects: reviews.length,
+    proceduralErrors,
+    gotchaApplied,
+    gotchaMissed,
+    refactorCount,
+    coverage: coverageMetrics
+  };
+  const awlFeedback = {
+    prompt: "\uC774\uBC88 \uC6CC\uD06C\uC544\uC774\uD15C\uC5D0\uC11C awl \uB3C4\uAD6C \uC790\uCCB4(\uC791\uC5C5 \uB300\uC0C1 \uCF54\uB4DC\uAC00 \uC544\uB2C8\uB77C)\uAC00 \uBD88\uD3B8\uD588\uB358 \uC810\uC774 \uC788\uB098? \uC788\uC73C\uBA74 awl record awl-feedback \uC73C\uB85C \uB0A8\uACA8\uB77C(area/what/impact/severity, suggestion \uC740 \uC120\uD0DD). \uC5C6\uC73C\uBA74 \uB118\uC5B4\uAC00\uB77C \u2014 \uB9E4\uB044\uB7EC\uC6E0\uC73C\uBA74 \uC88B\uC740 \uC2E0\uD638\uB2E4. gotcha(\uC791\uC5C5 \uCF54\uB4DC \uAD50\uD6C8)\uC640 \uB2E4\uB978 \uC885\uB958\uB2E4.",
+    recorded: awlFeedbackRecords
+  };
+  return {
+    workitem,
+    project,
+    blocked,
+    reviews,
+    retried,
+    existingGotchas,
+    relatedGotchas,
+    metrics,
+    awlFeedback
+  };
+}
+function writeGeneration(project, workitem, metrics, at, extra) {
+  const dir = generationsDir(project);
+  fs.mkdirSync(dir, { recursive: true });
+  const stamp = at.replace(/[:.]/g, "-");
+  const wi = workitem?.trim() ? workitem : "unknown";
+  const name = `${stamp}-${wi}.json`;
+  const file = path.join(dir, name);
+  fs.writeFileSync(
+    file,
+    `${JSON.stringify({ workitem: wi, at, ...metrics, ...extra }, null, 2)}
+`
+  );
+  return file;
+}
+function recordGotcha(input, at) {
+  const gotchas = loadGotchaList();
+  if (input.sameAs) {
+    const existing = gotchas.find((g) => g.id === input.sameAs);
+    if (existing) {
+      existing.count += 1;
+      existing.history = [...existing.history ?? [], { at, source: input.source }];
+      writeGotcha(existing);
+      return { gotcha: existing, repeated: existing.count >= 2, created: false };
+    }
+  }
+  const id = nextGotchaId(gotchas);
+  const gotcha = {
+    id,
+    lesson: input.lesson,
+    context: input.context,
+    source: input.source,
+    sameAs: input.sameAs,
+    ...input.relations && input.relations.length > 0 ? { relations: input.relations } : {},
+    count: 1,
+    createdAt: at,
+    history: [{ at, source: input.source }]
+  };
+  writeGotcha(gotcha);
+  return { gotcha, repeated: false, created: true };
+}
+function renderRepeatNotice(gotcha, c) {
+  const color = makeColors(c.color);
+  const first = gotcha.history?.[0]?.source;
+  const last = gotcha.history?.[gotcha.history.length - 1]?.source;
+  const fmt = (s) => s ? `${s.workitem ?? "?"} (${s.project ?? "?"})` : "?";
+  return [
+    "",
+    `  gotcha ${color.bold(gotcha.id)} \uC774 ${gotcha.count}\uD68C \uBC18\uBCF5\uB410\uC2B5\uB2C8\uB2E4.`,
+    "",
+    `    "${gotcha.lesson}"`,
+    "",
+    `    \uCC98\uC74C: ${fmt(first)}`,
+    `    \uC774\uBC88: ${fmt(last)}`,
+    "",
+    `  ${color.dim(`awl rules promote ${gotcha.id} \uC73C\uB85C \uADDC\uCE59\uC744 \uB9CC\uB4E4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`)}`,
+    "  (\uC790\uB3D9 \uC2B9\uACA9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC0AC\uB78C\uC774 \uD655\uC778\uD569\uB2C8\uB2E4.)"
+  ].join("\n");
+}
+function runEvolveCollect(opts) {
+  const { projectRoot, config } = requireConfig();
+  if (!acquireLock()) {
+    process.stderr.write(
+      `
+  ${signal(caps(), "warn")} \uB2E4\uB978 evolve \uAC00 \uC2E4\uD589 \uC911\uC785\uB2C8\uB2E4(~/.awl/.lock). \uB05D\uB09C \uB4A4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.
+`
+    );
+    process.exit(1);
+  }
+  try {
+    const workitem = opts.workitem ?? null;
+    const state = loadState(projectRoot);
+    const scope = opts.months !== void 0 || opts.from !== void 0 || opts.to !== void 0 ? { months: opts.months, from: opts.from, to: opts.to } : void 0;
+    const collection = collectEvolve(config.project, workitem, state, scope);
+    const at = (/* @__PURE__ */ new Date()).toISOString();
+    const extra = {};
+    if (state.workitemExperiment !== void 0) {
+      extra.experiment = state.workitemExperiment;
+    }
+    if (typeof state.workitemCreatedAt === "string") {
+      extra.startedAt = state.workitemCreatedAt;
+      const dur = computeDurationMs(state.workitemCreatedAt, at);
+      if (dur !== void 0) {
+        extra.durationMs = dur;
+      }
+    }
+    writeGeneration(config.project, workitem, collection.metrics, at, extra);
+    process.stdout.write(`${JSON.stringify(collection, null, 2)}
+`);
+  } finally {
+    releaseLock();
+  }
+}
+function runEvolveRecord(jsonInput) {
+  let parsed;
+  try {
+    parsed = JSON.parse(jsonInput);
+  } catch (e) {
+    process.stderr.write(
+      `
+  ${signal(caps(), "error")} \uAD50\uD6C8 JSON \uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${String(e)}
+`
+    );
+    process.exit(1);
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    process.stderr.write(`
+  ${signal(caps(), "error")} \uAD50\uD6C8\uC740 JSON \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4.
+`);
+    process.exit(1);
+  }
+  const data = parsed;
+  if (typeof data.lesson !== "string" || data.lesson.trim() === "") {
+    process.stderr.write(
+      `
+  ${signal(caps(), "error")} lesson(\uC7AC\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uAD50\uD6C8 \uBB38\uC7A5)\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.
+`
+    );
+    process.exit(1);
+  }
+  let source = data.source;
+  if (source === void 0) {
+    const { projectRoot, config } = requireConfig();
+    const state = loadState(projectRoot);
+    source = {
+      project: config.project,
+      ...typeof state.workitem === "string" ? { workitem: state.workitem } : {}
+    };
+  }
+  const rel = normalizeRelations(data.relations);
+  if (!rel.ok) {
+    process.stderr.write(`
+  ${signal(caps(), "error")} ${rel.error}
+`);
+    process.exit(1);
+  }
+  if (!acquireLock()) {
+    process.stderr.write(
+      `
+  ${signal(caps(), "warn")} \uB2E4\uB978 evolve \uAC00 \uC2E4\uD589 \uC911\uC785\uB2C8\uB2E4(~/.awl/.lock).
+`
+    );
+    process.exit(1);
+  }
+  try {
+    const input = {
+      lesson: data.lesson,
+      context: typeof data.context === "string" ? data.context : void 0,
+      source,
+      sameAs: typeof data.sameAs === "string" ? data.sameAs : void 0,
+      ...rel.relations ? { relations: rel.relations } : {}
+    };
+    const result = recordGotcha(input, (/* @__PURE__ */ new Date()).toISOString());
+    if (result.repeated) {
+      process.stdout.write(`${renderRepeatNotice(result.gotcha, caps())}
+`);
+    } else if (result.created) {
+      process.stdout.write(`
+  \uAD50\uD6C8 ${result.gotcha.id} \uC744 \uAE30\uB85D\uD588\uC2B5\uB2C8\uB2E4.
+`);
+    } else {
+      process.stdout.write(
+        `
+  \uAD50\uD6C8 ${result.gotcha.id} \uC758 \uBC18\uBCF5\uC744 \uAE30\uB85D\uD588\uC2B5\uB2C8\uB2E4(${result.gotcha.count}\uD68C).
+`
+      );
+    }
+  } finally {
+    releaseLock();
+  }
+}
+
+export {
+  acquireLock,
+  releaseLock,
+  GOTCHA_RELATION_TYPES,
+  normalizeRelations,
+  migrateDeltasToGotchas,
+  loadGotchaList,
+  nextGotchaId,
+  gotchaCluster,
+  gotchasBySource,
+  collectEvolve,
+  writeGeneration,
+  recordGotcha,
+  runEvolveCollect,
+  runEvolveRecord
+};