cleargate 0.2.0 → 0.2.1

package/dist/MANIFEST.json

@@ -1,6 +1,6 @@
 {
-  "cleargate_version": "0.2.0",
-  "generated_at": "2026-04-19T16:46:17.751Z",
+  "cleargate_version": "0.2.1",
+  "generated_at": "2026-04-19T18:33:06.178Z",
   "files": [
     {
       "path": ".claude/agents/architect.md",
@@ -46,7 +46,7 @@
     },
     {
       "path": ".claude/agents/reporter.md",
-      "sha256": "a83497454969e81015e7d0415e86a3bcf48cafb13741ed7f18b603f9e54cfb80",
+      "sha256": "a9b7e248fd1baaef7fb0c23d4ba92bc94bcd46e9261a6dabbd183477fab96359",
       "tier": "agent",
       "overwrite_policy": "always",
       "preserve_on_uninstall": false
@@ -81,7 +81,7 @@
     },
     {
       "path": ".claude/skills/flashcard/SKILL.md",
-      "sha256": "56d6bf3797516ac26ada15876ef2f4cf43842b3af7300abef502a75bd177639e",
+      "sha256": "4c0fe5bb74697e1eb1f37203ff44b8e6a800f024a2f8c3fc8542aa206cd2c777",
       "tier": "skill",
       "overwrite_policy": "always",
       "preserve_on_uninstall": false
@@ -151,7 +151,7 @@
     },
     {
       "path": ".cleargate/templates/story.md",
-      "sha256": "3e722c51f706177f08c16b56ef984090c7841102f70384bb47d5442846991fe8",
+      "sha256": "6c32fcabc9332cb928ac3b8fbfe618751b0a4cb05cd0f16463c3c4e22f8a67f1",
       "tier": "template",
       "overwrite_policy": "merge-3way",
       "preserve_on_uninstall": false

package/dist/cli.cjs

@@ -33,7 +33,7 @@ var import_commander = require("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.",
@@ -541,6 +541,7 @@ function getCodebaseVersion(opts) {
 var fs4 = __toESM(require("fs/promises"), 1);
 
 // src/wiki/parse-frontmatter.ts
+var import_js_yaml = __toESM(require("js-yaml"), 1);
 function parseFrontmatter(raw) {
   const lines = raw.split("\n");
   if (lines[0] !== "---") {
@@ -556,71 +557,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 };
   }
-  return { fm, body: bodyLines.join("\n") };
+  let parsed;
+  try {
+    parsed = import_js_yaml.default.load(yamlText, { schema: import_js_yaml.default.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: parsed, body };
 }
 
 // src/lib/frontmatter-yaml.ts
+var import_js_yaml2 = __toESM(require("js-yaml"), 1);
 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 = import_js_yaml2.default.dump(fm, {
+    schema: import_js_yaml2.default.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");
@@ -2217,7 +2192,7 @@ function loadWikiPages(wikiRoot) {
 var fs16 = __toESM(require("fs"), 1);
 var path17 = __toESM(require("path"), 1);
 var import_node_child_process3 = require("child_process");
-var import_js_yaml = __toESM(require("js-yaml"), 1);
+var import_js_yaml3 = __toESM(require("js-yaml"), 1);
 
 // src/lib/work-item-type.ts
 var FM_KEY_MAP = [
@@ -2464,7 +2439,7 @@ function parseCachedGateResult(raw) {
   if (typeof raw === "string") {
     if (!raw.startsWith("{")) return null;
     try {
-      const parsed = import_js_yaml.default.load(raw);
+      const parsed = import_js_yaml3.default.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"] };
@@ -2947,15 +2922,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 = path20.join(cwd, ".cleargate", "delivery", "pending-sync");
@@ -2980,9 +2963,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 = "";
@@ -3047,15 +3028,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;
@@ -3117,7 +3106,7 @@ async function doctorHandler(flags, cli) {
 // src/commands/gate.ts
 var fs21 = __toESM(require("fs"), 1);
 var path22 = __toESM(require("path"), 1);
-var import_js_yaml3 = __toESM(require("js-yaml"), 1);
+var import_js_yaml5 = __toESM(require("js-yaml"), 1);
 
 // src/lib/readiness-predicates.ts
 var fs19 = __toESM(require("fs"), 1);
@@ -3445,7 +3434,7 @@ function evalStatusOf(parsed, opts, projectRoot) {
 
 // src/lib/frontmatter-cache.ts
 var fs20 = __toESM(require("fs/promises"), 1);
-var import_js_yaml2 = __toESM(require("js-yaml"), 1);
+var import_js_yaml4 = __toESM(require("js-yaml"), 1);
 async function readCachedGate(absPath) {
   let raw;
   try {
@@ -3459,20 +3448,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());
@@ -3490,29 +3466,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}
@@ -3521,24 +3490,31 @@ ${body}` : `${fmBlock}
 `;
   await fs20.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 = import_js_yaml2.default.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 = import_js_yaml4.default.load(val, { schema: import_js_yaml4.default.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
@@ -3549,7 +3525,7 @@ function loadGateBlocks(gatesDocPath) {
   let match;
   while ((match = fenceRe.exec(raw)) !== null) {
     const yamlContent = match[1];
-    const parsed = import_js_yaml3.default.load(yamlContent);
+    const parsed = import_js_yaml5.default.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);
@@ -3877,7 +3853,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) {
@@ -3913,7 +3889,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}"`);
     }
@@ -3952,15 +3928,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;
@@ -4013,12 +4003,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) {