cleargate 0.2.0 → 0.2.1

package/dist/cli.js

@@ -9,7 +9,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "cleargate",
-  version: "0.2.0",
+  version: "0.2.1",
   private: false,
   type: "module",
   description: "Planning framework for Claude Code agents \u2014 sprint/epic/story protocol, four-agent loop (architect/developer/qa/reporter), Karpathy-style awareness wiki.",
@@ -358,6 +358,7 @@ function getCodebaseVersion(opts) {
 import * as fs3 from "fs/promises";
 
 // src/wiki/parse-frontmatter.ts
+import yaml from "js-yaml";
 function parseFrontmatter(raw) {
   const lines = raw.split("\n");
   if (lines[0] !== "---") {
@@ -373,71 +374,45 @@ function parseFrontmatter(raw) {
   if (closeIdx === -1) {
     throw new Error("parseFrontmatter: missing closing ---");
   }
-  const fmLines = lines.slice(1, closeIdx);
+  const yamlText = lines.slice(1, closeIdx).join("\n");
   const bodyLines = lines.slice(closeIdx + 1);
   if (bodyLines[0] === "") bodyLines.shift();
-  const fm = {};
-  for (const line of fmLines) {
-    if (line.trim() === "" || line.trim().startsWith("#")) continue;
-    const colon = line.indexOf(":");
-    if (colon === -1) continue;
-    const key = line.slice(0, colon).trim();
-    const val = line.slice(colon + 1).trim();
-    if (val === "" || val === "[]") {
-      fm[key] = [];
-      continue;
-    }
-    if (val.startsWith("[") && val.endsWith("]")) {
-      const inner = val.slice(1, -1).trim();
-      if (inner === "") {
-        fm[key] = [];
-        continue;
-      }
-      fm[key] = inner.split(",").map((s) => s.trim().replace(/^["']|["']$/g, ""));
-      continue;
-    }
-    if (val.startsWith("{")) {
-      fm[key] = val;
-      continue;
-    }
-    fm[key] = val.replace(/^["']|["']$/g, "");
+  const body = bodyLines.join("\n");
+  if (yamlText.trim() === "") {
+    return { fm: {}, body };
+  }
+  let parsed;
+  try {
+    parsed = yaml.load(yamlText, { schema: yaml.CORE_SCHEMA });
+  } catch (err) {
+    throw new Error(`parseFrontmatter: invalid YAML: ${err.message}`);
+  }
+  if (parsed === null || parsed === void 0) {
+    return { fm: {}, body };
+  }
+  if (typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("parseFrontmatter: frontmatter is not a YAML mapping");
   }
-  return { fm, body: bodyLines.join("\n") };
+  return { fm: parsed, body };
 }
 
 // src/lib/frontmatter-yaml.ts
+import yaml2 from "js-yaml";
 function serializeFrontmatter(fm) {
-  const lines = ["---"];
-  for (const [key, val] of Object.entries(fm)) {
-    if (val === null) {
-      lines.push(`${key}: null`);
-    } else if (typeof val === "boolean") {
-      lines.push(`${key}: ${val}`);
-    } else if (typeof val === "number") {
-      lines.push(`${key}: ${val}`);
-    } else if (Array.isArray(val)) {
-      if (val.length === 0) {
-        lines.push(`${key}: []`);
-      } else {
-        const items = val.map((v) => `"${String(v)}"`).join(", ");
-        lines.push(`${key}: [${items}]`);
-      }
-    } else {
-      const s = String(val);
-      if (s.startsWith("{")) {
-        lines.push(`${key}: ${s}`);
-      } else {
-        const needsQuotes = /[:#\[\]{}&*!|>'"%@`\n]/.test(s) || s.trim() !== s || s === "" || s === "null" || s === "true" || s === "false";
-        if (needsQuotes) {
-          lines.push(`${key}: "${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`);
-        } else {
-          lines.push(`${key}: ${s}`);
-        }
-      }
-    }
-  }
-  lines.push("---");
-  return lines.join("\n");
+  if (Object.keys(fm).length === 0) {
+    return "---\n---";
+  }
+  const yamlBody = yaml2.dump(fm, {
+    schema: yaml2.CORE_SCHEMA,
+    lineWidth: -1,
+    noRefs: true,
+    noCompatMode: true,
+    quotingType: '"',
+    forceQuotes: false
+  });
+  return `---
+${yamlBody.replace(/\n+$/, "")}
+---`;
 }
 function toIsoSecond(d) {
   return d.toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -2034,7 +2009,7 @@ function loadWikiPages(wikiRoot) {
 import * as fs15 from "fs";
 import * as path15 from "path";
 import { spawnSync as spawnSync3 } from "child_process";
-import yaml from "js-yaml";
+import yaml3 from "js-yaml";
 
 // src/lib/work-item-type.ts
 var FM_KEY_MAP = [
@@ -2281,7 +2256,7 @@ function parseCachedGateResult(raw) {
   if (typeof raw === "string") {
     if (!raw.startsWith("{")) return null;
     try {
-      const parsed = yaml.load(raw);
+      const parsed = yaml3.load(raw);
       if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
       const p = parsed;
       return { pass: p["pass"], failing_criteria: p["failing_criteria"], last_gate_check: p["last_gate_check"] };
@@ -2764,15 +2739,23 @@ function emitSummary(driftMap, verbose, stdout) {
 var SESSION_START_MAX_ITEMS = 10;
 var SESSION_START_MAX_CHARS = 400;
 function parseCachedGateResult2(raw) {
-  try {
-    const parsed = JSON.parse(raw);
-    return {
-      pass: parsed.pass ?? null,
-      failing_criteria: parsed.failing_criteria ?? []
-    };
-  } catch {
+  if (raw == null) return null;
+  let parsed = null;
+  if (typeof raw === "object" && !Array.isArray(raw)) {
+    parsed = raw;
+  } else if (typeof raw === "string") {
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      return null;
+    }
+  } else {
     return null;
   }
+  return {
+    pass: parsed.pass ?? null,
+    failing_criteria: parsed.failing_criteria ?? []
+  };
 }
 async function runSessionStart(cwd, stdout) {
   const pendingSyncDir = path18.join(cwd, ".cleargate", "delivery", "pending-sync");
@@ -2797,9 +2780,7 @@ async function runSessionStart(cwd, stdout) {
     } catch {
       continue;
     }
-    const gateRaw = fm["cached_gate_result"];
-    if (typeof gateRaw !== "string") continue;
-    const gate2 = parseCachedGateResult2(gateRaw);
+    const gate2 = parseCachedGateResult2(fm["cached_gate_result"]);
     if (!gate2 || gate2.pass !== false) continue;
     const idKeys = ["story_id", "epic_id", "proposal_id", "cr_id", "bug_id", "sprint_id"];
     let itemId = "";
@@ -2864,15 +2845,23 @@ async function runPricing(filePath, cwd, stdout, stderr, exit) {
     return;
   }
   const draftTokensRaw = fm["draft_tokens"];
-  if (!draftTokensRaw || typeof draftTokensRaw !== "string") {
+  if (!draftTokensRaw) {
     stdout("draft_tokens unpopulated \u2014 run cleargate stamp-tokens first");
     exit(1);
     return;
   }
   let draftTokens;
-  try {
-    draftTokens = JSON.parse(draftTokensRaw);
-  } catch {
+  if (typeof draftTokensRaw === "object" && !Array.isArray(draftTokensRaw)) {
+    draftTokens = draftTokensRaw;
+  } else if (typeof draftTokensRaw === "string") {
+    try {
+      draftTokens = JSON.parse(draftTokensRaw);
+    } catch {
+      stdout("draft_tokens unpopulated \u2014 run cleargate stamp-tokens first");
+      exit(1);
+      return;
+    }
+  } else {
     stdout("draft_tokens unpopulated \u2014 run cleargate stamp-tokens first");
     exit(1);
     return;
@@ -2934,7 +2923,7 @@ async function doctorHandler(flags, cli) {
 // src/commands/gate.ts
 import * as fs20 from "fs";
 import * as path20 from "path";
-import yaml3 from "js-yaml";
+import yaml5 from "js-yaml";
 
 // src/lib/readiness-predicates.ts
 import * as fs18 from "fs";
@@ -3262,7 +3251,7 @@ function evalStatusOf(parsed, opts, projectRoot) {
 
 // src/lib/frontmatter-cache.ts
 import * as fs19 from "fs/promises";
-import yaml2 from "js-yaml";
+import yaml4 from "js-yaml";
 async function readCachedGate(absPath) {
   let raw;
   try {
@@ -3276,20 +3265,7 @@ async function readCachedGate(absPath) {
   } catch {
     return null;
   }
-  const cached = fm["cached_gate_result"];
-  if (cached === void 0 || cached === null) return null;
-  if (typeof cached === "string") {
-    return parseCachedGateString(cached);
-  }
-  if (typeof cached === "object" && !Array.isArray(cached)) {
-    const c = cached;
-    return {
-      pass: Boolean(c["pass"]),
-      failing_criteria: Array.isArray(c["failing_criteria"]) ? c["failing_criteria"] : [],
-      last_gate_check: String(c["last_gate_check"] ?? "")
-    };
-  }
-  return null;
+  return coerceCachedGate(fm["cached_gate_result"]);
 }
 async function writeCachedGate(absPath, result, opts) {
   const nowFn = opts?.now ?? (() => /* @__PURE__ */ new Date());
@@ -3307,29 +3283,22 @@ async function writeCachedGate(absPath, result, opts) {
   } catch {
     throw new Error(`writeCachedGate: failed to parse frontmatter in ${absPath}`);
   }
-  const existingCached = fm["cached_gate_result"];
-  if (existingCached !== void 0 && existingCached !== null) {
-    try {
-      const existingParsed = typeof existingCached === "string" ? parseCachedGateString(existingCached) : null;
-      if (existingParsed && JSON.stringify(existingParsed) === JSON.stringify(newResult)) {
-        return;
-      }
-    } catch {
-    }
+  const existing = coerceCachedGate(fm["cached_gate_result"]);
+  if (existing && JSON.stringify(existing) === JSON.stringify(newResult)) {
+    return;
   }
-  const cachedStr = serializeCachedGate(newResult);
   const newFm = {};
   let inserted = false;
   for (const [k, v] of Object.entries(fm)) {
     if (k === "cached_gate_result") {
-      newFm["cached_gate_result"] = cachedStr;
+      newFm["cached_gate_result"] = newResult;
       inserted = true;
     } else {
       newFm[k] = v;
     }
   }
   if (!inserted) {
-    newFm["cached_gate_result"] = cachedStr;
+    newFm["cached_gate_result"] = newResult;
   }
   const fmBlock = serializeFrontmatter(newFm);
   const newContent = body.length > 0 ? `${fmBlock}
@@ -3338,24 +3307,31 @@ ${body}` : `${fmBlock}
 `;
   await fs19.writeFile(absPath, newContent, "utf8");
 }
-function serializeCachedGate(result) {
-  const criteriaStr = result.failing_criteria.length === 0 ? "[]" : "[" + result.failing_criteria.map((c) => `{id: ${JSON.stringify(c.id)}, detail: ${JSON.stringify(c.detail)}}`).join(", ") + "]";
-  return `{pass: ${result.pass}, failing_criteria: ${criteriaStr}, last_gate_check: ${JSON.stringify(result.last_gate_check)}}`;
-}
-function parseCachedGateString(s) {
-  if (!s.startsWith("{")) return null;
-  try {
-    const parsed = yaml2.load(s);
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
-    const p = parsed;
+function coerceCachedGate(val) {
+  if (val === void 0 || val === null) return null;
+  if (typeof val === "object" && !Array.isArray(val)) {
+    const c = val;
     return {
-      pass: Boolean(p["pass"]),
-      failing_criteria: Array.isArray(p["failing_criteria"]) ? p["failing_criteria"] : [],
-      last_gate_check: String(p["last_gate_check"] ?? "")
+      pass: Boolean(c["pass"]),
+      failing_criteria: Array.isArray(c["failing_criteria"]) ? c["failing_criteria"] : [],
+      last_gate_check: String(c["last_gate_check"] ?? "")
     };
-  } catch {
-    return null;
   }
+  if (typeof val === "string" && val.startsWith("{")) {
+    try {
+      const parsed = yaml4.load(val, { schema: yaml4.CORE_SCHEMA });
+      if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
+      const p = parsed;
+      return {
+        pass: Boolean(p["pass"]),
+        failing_criteria: Array.isArray(p["failing_criteria"]) ? p["failing_criteria"] : [],
+        last_gate_check: String(p["last_gate_check"] ?? "")
+      };
+    } catch {
+      return null;
+    }
+  }
+  return null;
 }
 
 // src/commands/gate.ts
@@ -3366,7 +3342,7 @@ function loadGateBlocks(gatesDocPath) {
   let match;
   while ((match = fenceRe.exec(raw)) !== null) {
     const yamlContent = match[1];
-    const parsed = yaml3.load(yamlContent);
+    const parsed = yaml5.load(yamlContent);
     const block = Array.isArray(parsed) ? parsed[0] : parsed;
     if (block && typeof block === "object" && "work_item_type" in block && "transition" in block && "severity" in block && "criteria" in block) {
       blocks.push(block);
@@ -3694,7 +3670,7 @@ async function stampTokensHandler(file, opts, cli) {
     exitFn(1);
     return;
   }
-  const existingDraftTokens = parseDraftTokens(fm["draft_tokens"]);
+  const existingDraftTokens = coerceDraftTokens(fm["draft_tokens"]);
   const existingLastStamp = existingDraftTokens?.last_stamp ?? null;
   const buckets = readLedgerForWorkItem(workItemId, { sprintRunsRoot: cli?.sprintRunsRoot });
   if (existingLastStamp && buckets.length > 0) {
@@ -3730,7 +3706,7 @@ async function stampTokensHandler(file, opts, cli) {
   if (opts.dryRun) {
     stdoutFn(`[dry-run] stamp-tokens would write draft_tokens for ${workItemId}:`);
     const draftTokensVal = newFm["draft_tokens"];
-    stdoutFn(`  draft_tokens: ${String(draftTokensVal)}`);
+    stdoutFn(`  draft_tokens: ${JSON.stringify(draftTokensVal)}`);
     if (stampError) {
       stdoutFn(`  stamp_error: "${stampError}"`);
     }
@@ -3769,15 +3745,29 @@ function extractWorkItemId(fm, absPath) {
   }
   return null;
 }
-function parseDraftTokens(val) {
+function coerceDraftTokens(val) {
   if (val == null) return null;
-  if (typeof val !== "string") return null;
-  try {
-    const parsed = JSON.parse(val);
-    return parsed;
-  } catch {
-    return null;
+  if (typeof val === "object" && !Array.isArray(val)) {
+    const o = val;
+    return {
+      input: typeof o["input"] === "number" ? o["input"] : null,
+      output: typeof o["output"] === "number" ? o["output"] : null,
+      cache_creation: typeof o["cache_creation"] === "number" ? o["cache_creation"] : null,
+      cache_read: typeof o["cache_read"] === "number" ? o["cache_read"] : null,
+      model: typeof o["model"] === "string" ? o["model"] : null,
+      last_stamp: typeof o["last_stamp"] === "string" ? o["last_stamp"] : "",
+      sessions: Array.isArray(o["sessions"]) ? o["sessions"] : []
+    };
   }
+  if (typeof val === "string") {
+    try {
+      const parsed = JSON.parse(val);
+      return parsed;
+    } catch {
+      return null;
+    }
+  }
+  return null;
 }
 function aggregateBuckets(buckets, nowIso) {
   let totalInput = 0;
@@ -3830,12 +3820,9 @@ function buildNewFrontmatter(existingFm, tokens, stampError) {
   if (stampError) {
     newFm["stamp_error"] = stampError;
   }
-  newFm["draft_tokens"] = serializeDraftTokens(tokens);
+  newFm["draft_tokens"] = tokens;
   return newFm;
 }
-function serializeDraftTokens(tokens) {
-  return JSON.stringify(tokens);
-}
 function buildSerializedContent(fm, body) {
   const fmBlock = serializeFrontmatter(fm);
   if (body.length > 0) {