aiopt 0.3.7 → 0.3.9

package/dist/cli.js

@@ -656,7 +656,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "aiopt",
-      version: "0.3.7",
+      version: "0.3.9",
       description: "Pre-deploy LLM cost accident guardrail (serverless local CLI)",
       bin: {
         aiopt: "dist/cli.js"
@@ -697,19 +697,19 @@ __export(install_exports, {
   runInstall: () => runInstall
 });
 function ensureDir2(p) {
-  import_fs5.default.mkdirSync(p, { recursive: true });
+  import_fs6.default.mkdirSync(p, { recursive: true });
 }
 function writeFile(filePath, content, force) {
-  if (!force && import_fs5.default.existsSync(filePath)) return { wrote: false, reason: "exists" };
-  ensureDir2(import_path6.default.dirname(filePath));
-  import_fs5.default.writeFileSync(filePath, content);
+  if (!force && import_fs6.default.existsSync(filePath)) return { wrote: false, reason: "exists" };
+  ensureDir2(import_path7.default.dirname(filePath));
+  import_fs6.default.writeFileSync(filePath, content);
   return { wrote: true };
 }
 function runInstall(cwd, opts) {
   const force = Boolean(opts.force);
-  const aioptDir = import_path6.default.join(cwd, "aiopt");
-  const policiesDir = import_path6.default.join(aioptDir, "policies");
-  const outDir = import_path6.default.join(cwd, "aiopt-output");
+  const aioptDir = import_path7.default.join(cwd, "aiopt");
+  const policiesDir = import_path7.default.join(aioptDir, "policies");
+  const outDir = import_path7.default.join(cwd, "aiopt-output");
   ensureDir2(aioptDir);
   ensureDir2(policiesDir);
   ensureDir2(outDir);
@@ -765,7 +765,7 @@ return {
 };
 \`\`\`
 `;
-  const r1 = writeFile(import_path6.default.join(aioptDir, "README.md"), readme, force);
+  const r1 = writeFile(import_path7.default.join(aioptDir, "README.md"), readme, force);
   created.push({ path: "aiopt/README.md", status: r1.wrote ? "created" : "skipped" });
   const config = {
     version: 1,
@@ -775,7 +775,7 @@ return {
     policies_dir: "./aiopt/policies",
     rate_table: { path: "./rates/rate_table.json" }
   };
-  const r2 = writeFile(import_path6.default.join(aioptDir, "aiopt.config.json"), JSON.stringify(config, null, 2) + "\n", force);
+  const r2 = writeFile(import_path7.default.join(aioptDir, "aiopt.config.json"), JSON.stringify(config, null, 2) + "\n", force);
   created.push({ path: "aiopt/aiopt.config.json", status: r2.wrote ? "created" : "skipped" });
   const routing = {
     version: 1,
@@ -806,15 +806,15 @@ return {
     reduce_top_percentile: 0.2,
     assumed_reduction_ratio: 0.25
   };
-  const p1 = writeFile(import_path6.default.join(policiesDir, "routing.json"), JSON.stringify(routing, null, 2) + "\n", force);
-  const p2 = writeFile(import_path6.default.join(policiesDir, "retry.json"), JSON.stringify(retry, null, 2) + "\n", force);
-  const p3 = writeFile(import_path6.default.join(policiesDir, "output.json"), JSON.stringify(output, null, 2) + "\n", force);
-  const p4 = writeFile(import_path6.default.join(policiesDir, "context.json"), JSON.stringify(context, null, 2) + "\n", force);
+  const p1 = writeFile(import_path7.default.join(policiesDir, "routing.json"), JSON.stringify(routing, null, 2) + "\n", force);
+  const p2 = writeFile(import_path7.default.join(policiesDir, "retry.json"), JSON.stringify(retry, null, 2) + "\n", force);
+  const p3 = writeFile(import_path7.default.join(policiesDir, "output.json"), JSON.stringify(output, null, 2) + "\n", force);
+  const p4 = writeFile(import_path7.default.join(policiesDir, "context.json"), JSON.stringify(context, null, 2) + "\n", force);
   created.push({ path: "aiopt/policies/routing.json", status: p1.wrote ? "created" : "skipped" });
   created.push({ path: "aiopt/policies/retry.json", status: p2.wrote ? "created" : "skipped" });
   created.push({ path: "aiopt/policies/output.json", status: p3.wrote ? "created" : "skipped" });
   created.push({ path: "aiopt/policies/context.json", status: p4.wrote ? "created" : "skipped" });
-  const wrapperPath = import_path6.default.join(aioptDir, "aiopt-wrapper.js");
+  const wrapperPath = import_path7.default.join(aioptDir, "aiopt-wrapper.js");
   const wrapper = `// AIOpt Wrapper (guardrails) \u2014 local-only (CommonJS)
 
 const fs = require('fs');
@@ -968,9 +968,9 @@ module.exports = { guardedCall };
   ;
   const w = writeFile(wrapperPath, wrapper, force);
   created.push({ path: "aiopt/aiopt-wrapper.js", status: w.wrote ? "created" : "skipped" });
-  const usagePath = import_path6.default.join(outDir, "usage.jsonl");
-  if (force || !import_fs5.default.existsSync(usagePath)) {
-    import_fs5.default.writeFileSync(usagePath, "");
+  const usagePath = import_path7.default.join(outDir, "usage.jsonl");
+  if (force || !import_fs6.default.existsSync(usagePath)) {
+    import_fs6.default.writeFileSync(usagePath, "");
     created.push({ path: "aiopt-output/usage.jsonl", status: "created" });
     if (opts.seedSample) {
       const sample = {
@@ -990,19 +990,19 @@ module.exports = { guardedCall };
         latency_ms: 1,
         meta: { feature_tag: "demo", routed_from: null, policy_hits: ["install-sample"] }
       };
-      import_fs5.default.appendFileSync(usagePath, JSON.stringify(sample) + "\n");
+      import_fs6.default.appendFileSync(usagePath, JSON.stringify(sample) + "\n");
     }
   } else {
     created.push({ path: "aiopt-output/usage.jsonl", status: "skipped" });
   }
   return { created };
 }
-var import_fs5, import_path6;
+var import_fs6, import_path7;
 var init_install = __esm({
   "src/install.ts"() {
     "use strict";
-    import_fs5 = __toESM(require("fs"));
-    import_path6 = __toESM(require("path"));
+    import_fs6 = __toESM(require("fs"));
+    import_path7 = __toESM(require("path"));
   }
 });
 
@@ -1013,10 +1013,10 @@ __export(doctor_exports, {
 });
 function canWrite(dir) {
   try {
-    import_fs6.default.mkdirSync(dir, { recursive: true });
-    const p = import_path7.default.join(dir, `.aiopt-write-test-${Date.now()}`);
-    import_fs6.default.writeFileSync(p, "ok");
-    import_fs6.default.unlinkSync(p);
+    import_fs7.default.mkdirSync(dir, { recursive: true });
+    const p = import_path8.default.join(dir, `.aiopt-write-test-${Date.now()}`);
+    import_fs7.default.writeFileSync(p, "ok");
+    import_fs7.default.unlinkSync(p);
     return true;
   } catch {
     return false;
@@ -1024,7 +1024,7 @@ function canWrite(dir) {
 }
 function tailLines(filePath, n) {
   try {
-    const raw = import_fs6.default.readFileSync(filePath, "utf8");
+    const raw = import_fs7.default.readFileSync(filePath, "utf8");
     const lines = raw.split(/\r?\n/).filter((l) => l.trim().length > 0);
     return lines.slice(Math.max(0, lines.length - n));
   } catch {
@@ -1032,15 +1032,15 @@ function tailLines(filePath, n) {
   }
 }
 function runDoctor(cwd) {
-  const aioptDir = import_path7.default.join(cwd, "aiopt");
-  const policiesDir = import_path7.default.join(aioptDir, "policies");
-  const outDir = import_path7.default.join(cwd, "aiopt-output");
-  const usagePath = import_path7.default.join(outDir, "usage.jsonl");
+  const aioptDir = import_path8.default.join(cwd, "aiopt");
+  const policiesDir = import_path8.default.join(aioptDir, "policies");
+  const outDir = import_path8.default.join(cwd, "aiopt-output");
+  const usagePath = import_path8.default.join(outDir, "usage.jsonl");
   const checks = [];
-  checks.push({ name: "aiopt/ exists", ok: import_fs6.default.existsSync(aioptDir) });
-  checks.push({ name: "aiopt/policies exists", ok: import_fs6.default.existsSync(policiesDir) });
+  checks.push({ name: "aiopt/ exists", ok: import_fs7.default.existsSync(aioptDir) });
+  checks.push({ name: "aiopt/policies exists", ok: import_fs7.default.existsSync(policiesDir) });
   checks.push({ name: "aiopt-output/ writable", ok: canWrite(outDir) });
-  checks.push({ name: "usage.jsonl exists", ok: import_fs6.default.existsSync(usagePath), detail: usagePath });
+  checks.push({ name: "usage.jsonl exists", ok: import_fs7.default.existsSync(usagePath), detail: usagePath });
   const last5raw = tailLines(usagePath, 5);
   const last5 = last5raw.length === 0 ? [{ status: "(empty usage.jsonl)" }] : last5raw.map((l) => {
     try {
@@ -1078,12 +1078,12 @@ function runDoctor(cwd) {
   const ok = checks.every((c) => c.ok);
   return { ok, checks, last5 };
 }
-var import_fs6, import_path7;
+var import_fs7, import_path8;
 var init_doctor = __esm({
   "src/doctor.ts"() {
     "use strict";
-    import_fs6 = __toESM(require("fs"));
-    import_path7 = __toESM(require("path"));
+    import_fs7 = __toESM(require("fs"));
+    import_path8 = __toESM(require("path"));
   }
 });
 
@@ -1138,7 +1138,7 @@ function verifyLicenseKey(key, publicKeyPem) {
   }
 }
 function defaultLicensePath(cwd) {
-  return import_path8.default.join(cwd, "aiopt", "license.json");
+  return import_path9.default.join(cwd, "aiopt", "license.json");
 }
 function writeLicenseFile(p, key, payload, verified) {
   const out = {
@@ -1147,19 +1147,19 @@ function writeLicenseFile(p, key, payload, verified) {
     verified,
     verified_at: (/* @__PURE__ */ new Date()).toISOString()
   };
-  import_fs7.default.mkdirSync(import_path8.default.dirname(p), { recursive: true });
-  import_fs7.default.writeFileSync(p, JSON.stringify(out, null, 2));
+  import_fs8.default.mkdirSync(import_path9.default.dirname(p), { recursive: true });
+  import_fs8.default.writeFileSync(p, JSON.stringify(out, null, 2));
 }
 function readLicenseFile(p) {
-  return JSON.parse(import_fs7.default.readFileSync(p, "utf8"));
+  return JSON.parse(import_fs8.default.readFileSync(p, "utf8"));
 }
-var import_crypto, import_fs7, import_path8, DEFAULT_PUBLIC_KEY_PEM;
+var import_crypto, import_fs8, import_path9, DEFAULT_PUBLIC_KEY_PEM;
 var init_license = __esm({
   "src/license.ts"() {
     "use strict";
     import_crypto = __toESM(require("crypto"));
-    import_fs7 = __toESM(require("fs"));
-    import_path8 = __toESM(require("path"));
+    import_fs8 = __toESM(require("fs"));
+    import_path9 = __toESM(require("path"));
     DEFAULT_PUBLIC_KEY_PEM = `-----BEGIN PUBLIC KEY-----
 MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz1LLE/pXIx5TloDa0LAf
 jg9NSIW6STWhsAFP2ZzXgpWoQ3cCmW6xcB/4QNEmPpGlfMWhyRfkxsdKuhnjUMTg
@@ -1189,13 +1189,13 @@ function parseFileUri(uri) {
   }
 }
 function runGate(outDir, cwd) {
-  const sarifPath = import_path9.default.join(outDir, "aiopt.sarif");
-  if (!import_fs8.default.existsSync(sarifPath)) {
+  const sarifPath = import_path10.default.join(outDir, "aiopt.sarif");
+  if (!import_fs9.default.existsSync(sarifPath)) {
     return { violations: 0, top3: [] };
   }
   let sarif;
   try {
-    sarif = JSON.parse(import_fs8.default.readFileSync(sarifPath, "utf8"));
+    sarif = JSON.parse(import_fs9.default.readFileSync(sarifPath, "utf8"));
   } catch {
     return { violations: 0, top3: [] };
   }
@@ -1211,8 +1211,8 @@ function runGate(outDir, cwd) {
     const line = Number(loc?.region?.startLine || 1);
     let file = parseFileUri(uri);
     try {
-      const abs = import_path9.default.isAbsolute(file) ? file : import_path9.default.resolve(file);
-      file = import_path9.default.relative(cwd, abs) || file;
+      const abs = import_path10.default.isAbsolute(file) ? file : import_path10.default.resolve(file);
+      file = import_path10.default.relative(cwd, abs) || file;
     } catch {
     }
     locs.push({ file, line: Number.isFinite(line) && line > 0 ? line : 1 });
@@ -1224,7 +1224,7 @@ function formatGateStdout(r, outDir) {
   const lines = [];
   if (r.violations <= 0) {
     lines.push("OK: no policy violations");
-    lines.push(`Artifacts: ${import_path9.default.join(outDir, "report.md")} | ${import_path9.default.join(outDir, "aiopt.sarif")}`);
+    lines.push(`Artifacts: ${import_path10.default.join(outDir, "report.md")} | ${import_path10.default.join(outDir, "aiopt.sarif")}`);
     return { text: lines.join("\n"), exitCode: 0 };
   }
   lines.push(`FAIL: policy violations=${r.violations}`);
@@ -1234,12 +1234,12 @@ function formatGateStdout(r, outDir) {
   const text = lines.slice(0, 10).join("\n");
   return { text, exitCode: 1 };
 }
-var import_fs8, import_path9;
+var import_fs9, import_path10;
 var init_gate = __esm({
   "src/gate.ts"() {
     "use strict";
-    import_fs8 = __toESM(require("fs"));
-    import_path9 = __toESM(require("path"));
+    import_fs9 = __toESM(require("fs"));
+    import_path10 = __toESM(require("path"));
   }
 });
 
@@ -1249,15 +1249,15 @@ __export(fix_exports, {
   runFix: () => runFix
 });
 function isTextLike2(p) {
-  const ext = import_path10.default.extname(p).toLowerCase();
+  const ext = import_path11.default.extname(p).toLowerCase();
   return [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"].includes(ext);
 }
 function walk2(root, out) {
-  const items = import_fs9.default.readdirSync(root, { withFileTypes: true });
+  const items = import_fs10.default.readdirSync(root, { withFileTypes: true });
   for (const it of items) {
     if (it.name.startsWith(".")) continue;
     if (DEFAULT_EXCLUDES2.has(it.name)) continue;
-    const full = import_path10.default.join(root, it.name);
+    const full = import_path11.default.join(root, it.name);
     if (it.isDirectory()) walk2(full, out);
     else out.push(full);
   }
@@ -1326,9 +1326,9 @@ function applyModelRouting(content) {
   return { changed, next };
 }
 function tmpFilePath(original) {
-  const base = import_path10.default.basename(original);
+  const base = import_path11.default.basename(original);
   const rand = Math.random().toString(16).slice(2);
-  return import_path10.default.join(import_os.default.tmpdir(), `aiopt-fix-${base}-${rand}`);
+  return import_path11.default.join(import_os2.default.tmpdir(), `aiopt-fix-${base}-${rand}`);
 }
 function diffNoIndex(oldPath, newPath) {
   try {
@@ -1372,7 +1372,7 @@ function runFix(cwd, opts) {
     if (!isTextLike2(file)) continue;
     let st;
     try {
-      st = import_fs9.default.statSync(file);
+      st = import_fs10.default.statSync(file);
     } catch {
       continue;
     }
@@ -1380,7 +1380,7 @@ function runFix(cwd, opts) {
     if (st.size > 1024 * 1024) continue;
     let content = "";
     try {
-      content = import_fs9.default.readFileSync(file, "utf8");
+      content = import_fs10.default.readFileSync(file, "utf8");
     } catch {
       continue;
     }
@@ -1389,8 +1389,8 @@ function runFix(cwd, opts) {
     const next = r2.next;
     if (next === content) continue;
     const tmp = tmpFilePath(file);
-    import_fs9.default.writeFileSync(tmp, next);
-    const rel = import_path10.default.relative(cwd, file).replace(/\\/g, "/");
+    import_fs10.default.writeFileSync(tmp, next);
+    const rel = import_path11.default.relative(cwd, file).replace(/\\/g, "/");
     const d0 = diffNoIndex(file, tmp);
     const d = normalizePatchPaths(d0, rel);
     if (d && d.trim().length > 0) {
@@ -1398,20 +1398,20 @@ function runFix(cwd, opts) {
       changedFiles.push(rel);
     }
     try {
-      import_fs9.default.unlinkSync(tmp);
+      import_fs10.default.unlinkSync(tmp);
     } catch {
     }
     if (patches.join("\n").length > 5e5) break;
   }
-  import_fs9.default.mkdirSync(opts.outDir, { recursive: true });
-  const patchPath = import_path10.default.join(opts.outDir, "aiopt.patch");
+  import_fs10.default.mkdirSync(opts.outDir, { recursive: true });
+  const patchPath = import_path11.default.join(opts.outDir, "aiopt.patch");
   const header = [
     "# AIOpt patch (generated)",
     "# - retry cap: reduce high retry/attempt counts to 3",
     "# - model routing: cheap default via AIOPT_MODEL env override",
     ""
   ].join("\n");
-  import_fs9.default.writeFileSync(patchPath, header + patches.join("\n"));
+  import_fs10.default.writeFileSync(patchPath, header + patches.join("\n"));
   if (opts.apply) {
     try {
       const inside = (0, import_child_process.execSync)("git rev-parse --is-inside-work-tree", { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
@@ -1430,13 +1430,13 @@ function runFix(cwd, opts) {
   }
   return { ok: true, applied: false, patchPath, changedFiles };
 }
-var import_fs9, import_path10, import_os, import_child_process, DEFAULT_EXCLUDES2;
+var import_fs10, import_path11, import_os2, import_child_process, DEFAULT_EXCLUDES2;
 var init_fix = __esm({
   "src/fix.ts"() {
     "use strict";
-    import_fs9 = __toESM(require("fs"));
-    import_path10 = __toESM(require("path"));
-    import_os = __toESM(require("os"));
+    import_fs10 = __toESM(require("fs"));
+    import_path11 = __toESM(require("path"));
+    import_os2 = __toESM(require("os"));
     import_child_process = require("child_process");
     DEFAULT_EXCLUDES2 = /* @__PURE__ */ new Set([
       ".git",
@@ -1669,7 +1669,7 @@ var init_guard = __esm({
 // src/collect.ts
 function exists(p) {
   try {
-    return import_fs10.default.existsSync(p);
+    return import_fs11.default.existsSync(p);
   } catch {
     return false;
   }
@@ -1677,7 +1677,7 @@ function exists(p) {
 function safeReadJsonl(p) {
   const out = [];
   try {
-    const txt = import_fs10.default.readFileSync(p, "utf8");
+    const txt = import_fs11.default.readFileSync(p, "utf8");
     for (const line of txt.split(/\r?\n/)) {
       if (!line.trim()) continue;
       try {
@@ -1692,11 +1692,11 @@ function safeReadJsonl(p) {
 function listJsonlFiles(dir) {
   const out = [];
   try {
-    for (const name of import_fs10.default.readdirSync(dir)) {
-      const full = import_path11.default.join(dir, name);
+    for (const name of import_fs11.default.readdirSync(dir)) {
+      const full = import_path12.default.join(dir, name);
       let st;
       try {
-        st = import_fs10.default.statSync(full);
+        st = import_fs11.default.statSync(full);
       } catch {
         continue;
       }
@@ -1707,18 +1707,18 @@ function listJsonlFiles(dir) {
   return out;
 }
 function findOpenClawSessionLogs() {
-  const home = import_os2.default.homedir();
-  const root = import_path11.default.join(home, ".openclaw", "agents");
+  const home = import_os3.default.homedir();
+  const root = import_path12.default.join(home, ".openclaw", "agents");
   if (!exists(root)) return [];
   const found = [];
   let agents = [];
   try {
-    agents = import_fs10.default.readdirSync(root);
+    agents = import_fs11.default.readdirSync(root);
   } catch {
     agents = [];
   }
   for (const a of agents) {
-    const sessDir = import_path11.default.join(root, a, "sessions");
+    const sessDir = import_path12.default.join(root, a, "sessions");
     if (!exists(sessDir)) continue;
     for (const f of listJsonlFiles(sessDir)) found.push(f);
   }
@@ -1790,18 +1790,18 @@ function collectToUsageJsonl(outPath) {
     uniq.push(e);
   }
   uniq.sort((a, b) => Date.parse(a.ts) - Date.parse(b.ts));
-  import_fs10.default.mkdirSync(import_path11.default.dirname(outPath), { recursive: true });
+  import_fs11.default.mkdirSync(import_path12.default.dirname(outPath), { recursive: true });
   const lines = uniq.map((e) => JSON.stringify(e)).join("\n") + (uniq.length ? "\n" : "");
-  import_fs10.default.writeFileSync(outPath, lines);
+  import_fs11.default.writeFileSync(outPath, lines);
   return { outPath, sources, eventsWritten: uniq.length };
 }
-var import_fs10, import_path11, import_os2;
+var import_fs11, import_path12, import_os3;
 var init_collect = __esm({
   "src/collect.ts"() {
     "use strict";
-    import_fs10 = __toESM(require("fs"));
-    import_path11 = __toESM(require("path"));
-    import_os2 = __toESM(require("os"));
+    import_fs11 = __toESM(require("fs"));
+    import_path12 = __toESM(require("path"));
+    import_os3 = __toESM(require("os"));
   }
 });
 
@@ -1813,8 +1813,8 @@ __export(dashboard_exports, {
 async function startDashboard(cwd, opts) {
   const host = "127.0.0.1";
   const port = opts.port || 3010;
-  const outDir = import_path12.default.join(cwd, "aiopt-output");
-  const file = (name) => import_path12.default.join(outDir, name);
+  const outDir = import_path13.default.join(cwd, "aiopt-output");
+  const file = (name) => import_path13.default.join(outDir, name);
   let lastCollect = null;
   let lastCollectError = null;
   let lastAutoGen = null;
@@ -1822,7 +1822,7 @@ async function startDashboard(cwd, opts) {
   function ensureUsageFile() {
     try {
       const usagePath = file("usage.jsonl");
-      if (import_fs11.default.existsSync(usagePath)) return;
+      if (import_fs12.default.existsSync(usagePath)) return;
       const r = collectToUsageJsonl(usagePath);
       lastCollect = { ts: (/* @__PURE__ */ new Date()).toISOString(), outPath: r.outPath, sources: r.sources, eventsWritten: r.eventsWritten };
       lastCollectError = null;
@@ -1831,11 +1831,11 @@ async function startDashboard(cwd, opts) {
     }
   }
   function loadRateTable2() {
-    const p = import_path12.default.join(__dirname, "..", "rates", "rate_table.json");
-    return JSON.parse(import_fs11.default.readFileSync(p, "utf8"));
+    const p = import_path13.default.join(__dirname, "..", "rates", "rate_table.json");
+    return JSON.parse(import_fs12.default.readFileSync(p, "utf8"));
   }
   function readEvents(usagePath) {
-    if (!import_fs11.default.existsSync(usagePath)) return [];
+    if (!import_fs12.default.existsSync(usagePath)) return [];
     return isCsvPath(usagePath) ? readCsv(usagePath) : readJsonl(usagePath);
   }
   function ensureScanAndGuard() {
@@ -1843,7 +1843,7 @@ async function startDashboard(cwd, opts) {
     try {
       const usagePath = file("usage.jsonl");
       const rt = loadRateTable2();
-      const needScan = !import_fs11.default.existsSync(file("report.json")) || !import_fs11.default.existsSync(file("report.md"));
+      const needScan = !import_fs12.default.existsSync(file("report.json")) || !import_fs12.default.existsSync(file("report.md"));
       if (needScan) {
         const events = readEvents(usagePath);
         const { analysis, savings, policy, meta } = analyze(rt, events);
@@ -1851,14 +1851,14 @@ async function startDashboard(cwd, opts) {
         writeOutputs(outDir, analysis, savings, policy, { ...meta, cwd, cliVersion: "dashboard" });
         did.push("scan");
       }
-      const needGuard = !import_fs11.default.existsSync(file("guard-last.txt")) || !import_fs11.default.existsSync(file("guard-last.json"));
+      const needGuard = !import_fs12.default.existsSync(file("guard-last.txt")) || !import_fs12.default.existsSync(file("guard-last.json"));
       if (needGuard) {
         const events = readEvents(usagePath);
         const r = runGuard(rt, { baselineEvents: events, candidate: {} });
         const ts = (/* @__PURE__ */ new Date()).toISOString();
-        import_fs11.default.writeFileSync(file("guard-last.txt"), r.message);
-        import_fs11.default.writeFileSync(file("guard-last.json"), JSON.stringify({ ts, exitCode: r.exitCode }, null, 2));
-        import_fs11.default.appendFileSync(file("guard-history.jsonl"), JSON.stringify({ ts, exitCode: r.exitCode, mode: "dashboard", baseline: usagePath, candidate: null }) + "\n");
+        import_fs12.default.writeFileSync(file("guard-last.txt"), r.message);
+        import_fs12.default.writeFileSync(file("guard-last.json"), JSON.stringify({ ts, exitCode: r.exitCode }, null, 2));
+        import_fs12.default.appendFileSync(file("guard-history.jsonl"), JSON.stringify({ ts, exitCode: r.exitCode, mode: "dashboard", baseline: usagePath, candidate: null }) + "\n");
         did.push("guard");
       }
       if (did.length) lastAutoGen = { ts: (/* @__PURE__ */ new Date()).toISOString(), did };
@@ -1871,15 +1871,15 @@ async function startDashboard(cwd, opts) {
   ensureScanAndGuard();
   function readOrNull(p) {
     try {
-      if (!import_fs11.default.existsSync(p)) return null;
-      return import_fs11.default.readFileSync(p, "utf8");
+      if (!import_fs12.default.existsSync(p)) return null;
+      return import_fs12.default.readFileSync(p, "utf8");
     } catch {
       return null;
     }
   }
   function statOrNull(p) {
     try {
-      const st = import_fs11.default.statSync(p);
+      const st = import_fs12.default.statSync(p);
       return { size: st.size, mtimeMs: st.mtimeMs };
     } catch {
       return null;
@@ -1958,6 +1958,8 @@ async function startDashboard(cwd, opts) {
         <span class="muted">\xB7</span>
         <button id="btnRefresh" style="all:unset; cursor:pointer; padding:2px 8px; border:1px solid rgba(255,255,255,.16); border-radius:999px; background:rgba(255,255,255,.04); font-size:12px">Refresh</button>
         <button id="btnLive" style="all:unset; cursor:pointer; padding:2px 8px; border:1px solid rgba(255,255,255,.16); border-radius:999px; background:rgba(255,255,255,.04); font-size:12px">Live: Off</button>
+        <span class="muted">\xB7</span>
+        <a href="https://github.com/tkddlr0716-collab/aiopt/issues/new?template=dashboard_feedback.yml" target="_blank">Feedback</a>
       </div>
     </div>
 
@@ -2272,7 +2274,7 @@ load();
         ensureUsageFile();
         ensureScanAndGuard();
         const expected = ["guard-last.txt", "guard-last.json", "report.json", "report.md", "usage.jsonl", "guard-history.jsonl"];
-        const missing = expected.filter((f) => !import_fs11.default.existsSync(file(f)));
+        const missing = expected.filter((f) => !import_fs12.default.existsSync(file(f)));
         res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
         res.end(JSON.stringify({ baseDir: cwd, outDir, missing, collect: lastCollect, collectError: lastCollectError, autoGen: lastAutoGen, autoGenError: lastAutoGenError }, null, 2));
         return;
@@ -2305,7 +2307,7 @@ load();
         globalThis.__aioptDashCache = globalThis.__aioptDashCache || {};
         const cache = globalThis.__aioptDashCache;
         if (!cache.usage || cache.usage.mtimeMs !== st.mtimeMs) {
-          const txt2 = import_fs11.default.readFileSync(usagePath, "utf8");
+          const txt2 = import_fs12.default.readFileSync(usagePath, "utf8");
           const now = Date.now();
           const liveBins = Array.from({ length: 60 }, () => ({ cost: 0, calls: 0 }));
           const dayBins = Array.from({ length: 7 }, () => ({ cost: 0, calls: 0 }));
@@ -2370,13 +2372,13 @@ load();
   await new Promise(() => {
   });
 }
-var import_http, import_fs11, import_path12;
+var import_http, import_fs12, import_path13;
 var init_dashboard = __esm({
   "src/dashboard.ts"() {
     "use strict";
     import_http = __toESM(require("http"));
-    import_fs11 = __toESM(require("fs"));
-    import_path12 = __toESM(require("path"));
+    import_fs12 = __toESM(require("fs"));
+    import_path13 = __toESM(require("path"));
     init_collect();
     init_scan();
     init_io();
@@ -2390,55 +2392,55 @@ __export(find_output_exports, {
   findAioptOutputDir: () => findAioptOutputDir
 });
 function findAioptOutputDir(startCwd) {
-  let cur = import_path13.default.resolve(startCwd);
+  let cur = import_path14.default.resolve(startCwd);
   while (true) {
-    const outDir = import_path13.default.join(cur, "aiopt-output");
-    if (import_fs12.default.existsSync(outDir)) {
+    const outDir = import_path14.default.join(cur, "aiopt-output");
+    if (import_fs13.default.existsSync(outDir)) {
       try {
-        if (import_fs12.default.statSync(outDir).isDirectory()) return { cwd: cur, outDir };
+        if (import_fs13.default.statSync(outDir).isDirectory()) return { cwd: cur, outDir };
       } catch {
       }
     }
-    const parent = import_path13.default.dirname(cur);
+    const parent = import_path14.default.dirname(cur);
     if (parent === cur) break;
     cur = parent;
   }
   try {
-    const base = import_path13.default.resolve(startCwd);
-    const children = import_fs12.default.readdirSync(base, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => import_path13.default.join(base, d.name));
+    const base = import_path14.default.resolve(startCwd);
+    const children = import_fs13.default.readdirSync(base, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => import_path14.default.join(base, d.name));
     for (const child of children) {
-      const outDir = import_path13.default.join(child, "aiopt-output");
-      if (import_fs12.default.existsSync(outDir)) {
+      const outDir = import_path14.default.join(child, "aiopt-output");
+      if (import_fs13.default.existsSync(outDir)) {
         try {
-          if (import_fs12.default.statSync(outDir).isDirectory()) return { cwd: child, outDir };
+          if (import_fs13.default.statSync(outDir).isDirectory()) return { cwd: child, outDir };
         } catch {
         }
       }
     }
   } catch {
   }
-  return { cwd: import_path13.default.resolve(startCwd), outDir: import_path13.default.join(import_path13.default.resolve(startCwd), "aiopt-output") };
+  return { cwd: import_path14.default.resolve(startCwd), outDir: import_path14.default.join(import_path14.default.resolve(startCwd), "aiopt-output") };
 }
-var import_fs12, import_path13;
+var import_fs13, import_path14;
 var init_find_output = __esm({
   "src/find-output.ts"() {
     "use strict";
-    import_fs12 = __toESM(require("fs"));
-    import_path13 = __toESM(require("path"));
+    import_fs13 = __toESM(require("fs"));
+    import_path14 = __toESM(require("path"));
   }
 });
 
 // src/rates-util.ts
 function loadRateTableFromDistPath() {
-  const p = import_path14.default.join(__dirname, "..", "rates", "rate_table.json");
-  return JSON.parse(import_fs13.default.readFileSync(p, "utf8"));
+  const p = import_path15.default.join(__dirname, "..", "rates", "rate_table.json");
+  return JSON.parse(import_fs14.default.readFileSync(p, "utf8"));
 }
-var import_fs13, import_path14;
+var import_fs14, import_path15;
 var init_rates_util = __esm({
   "src/rates-util.ts"() {
     "use strict";
-    import_fs13 = __toESM(require("fs"));
-    import_path14 = __toESM(require("path"));
+    import_fs14 = __toESM(require("fs"));
+    import_path15 = __toESM(require("path"));
   }
 });
 
@@ -2449,8 +2451,8 @@ __export(quickstart_exports, {
   seedDemoUsage: () => seedDemoUsage
 });
 function seedDemoUsage(outDir) {
-  import_fs14.default.mkdirSync(outDir, { recursive: true });
-  const p = import_path15.default.join(outDir, "usage.jsonl");
+  import_fs15.default.mkdirSync(outDir, { recursive: true });
+  const p = import_path16.default.join(outDir, "usage.jsonl");
   const now = Date.now();
   const lines = [];
   for (let i = 0; i < 60; i++) {
@@ -2467,18 +2469,18 @@ function seedDemoUsage(outDir) {
       meta: { feature_tag: i % 2 ? "summarize" : "coding" }
     });
   }
-  import_fs14.default.writeFileSync(p, lines.map((x) => JSON.stringify(x)).join("\n") + "\n");
+  import_fs15.default.writeFileSync(p, lines.map((x) => JSON.stringify(x)).join("\n") + "\n");
   return p;
 }
 function runQuickstart(cwd, opts) {
-  const outDir = import_path15.default.join(cwd, "aiopt-output");
+  const outDir = import_path16.default.join(cwd, "aiopt-output");
   const usagePath = seedDemoUsage(outDir);
   const rt = loadRateTableFromDistPath();
   const { readJsonl: readJsonl2 } = (init_io(), __toCommonJS(io_exports));
   const events = readJsonl2(usagePath);
   const { analysis, savings, policy, meta } = analyze(rt, events);
-  import_fs14.default.writeFileSync(import_path15.default.join(outDir, "analysis.json"), JSON.stringify(analysis, null, 2));
-  import_fs14.default.writeFileSync(import_path15.default.join(outDir, "report.json"), JSON.stringify({
+  import_fs15.default.writeFileSync(import_path16.default.join(outDir, "analysis.json"), JSON.stringify(analysis, null, 2));
+  import_fs15.default.writeFileSync(import_path16.default.join(outDir, "report.json"), JSON.stringify({
     version: 3,
     generated_at: (/* @__PURE__ */ new Date()).toISOString(),
     confidence: analysis.unknown_models?.length ? "MEDIUM" : "HIGH",
@@ -2498,8 +2500,8 @@ function runQuickstart(cwd, opts) {
     unknown_models: analysis.unknown_models || [],
     notes: []
   }, null, 2));
-  import_fs14.default.writeFileSync(import_path15.default.join(outDir, "cost-policy.json"), JSON.stringify(policy, null, 2));
-  import_fs14.default.writeFileSync(import_path15.default.join(outDir, "report.md"), "# AIOpt quickstart demo\n\nThis is a demo report generated by `aiopt quickstart --demo`.\n");
+  import_fs15.default.writeFileSync(import_path16.default.join(outDir, "cost-policy.json"), JSON.stringify(policy, null, 2));
+  import_fs15.default.writeFileSync(import_path16.default.join(outDir, "report.md"), "# AIOpt quickstart demo\n\nThis is a demo report generated by `aiopt quickstart --demo`.\n");
   const r = runGuard(rt, {
     baselineEvents: events,
     candidate: {
@@ -2510,12 +2512,12 @@ function runQuickstart(cwd, opts) {
   });
   return { usagePath, outDir, guard: r, port: opts.port };
 }
-var import_fs14, import_path15;
+var import_fs15, import_path16;
 var init_quickstart = __esm({
   "src/quickstart.ts"() {
     "use strict";
-    import_fs14 = __toESM(require("fs"));
-    import_path15 = __toESM(require("path"));
+    import_fs15 = __toESM(require("fs"));
+    import_path16 = __toESM(require("path"));
     init_scan();
     init_rates_util();
     init_guard();
@@ -2523,36 +2525,64 @@ var init_quickstart = __esm({
 });
 
 // src/cli.ts
-var import_fs15 = __toESM(require("fs"));
-var import_path16 = __toESM(require("path"));
+var import_fs16 = __toESM(require("fs"));
+var import_path17 = __toESM(require("path"));
 var import_commander = require("commander");
 init_io();
 init_scan();
+
+// src/usage-path.ts
+var import_fs5 = __toESM(require("fs"));
+var import_path6 = __toESM(require("path"));
+var import_os = __toESM(require("os"));
+function homeAioptUsagePath() {
+  return import_path6.default.join(import_os.default.homedir(), ".aiopt", "aiopt-output", "usage.jsonl");
+}
+function resolveUsagePath(preferred) {
+  const tried = [];
+  const push = (p) => {
+    if (!p) return;
+    if (tried.includes(p)) return;
+    tried.push(p);
+  };
+  push(preferred);
+  push(homeAioptUsagePath());
+  push("./aiopt-output/usage.jsonl");
+  for (const p of tried) {
+    try {
+      if (import_fs5.default.existsSync(p)) return { path: p, tried };
+    } catch {
+    }
+  }
+  return { path: preferred, tried };
+}
+
+// src/cli.ts
 var program = new import_commander.Command();
 var DEFAULT_INPUT = "./aiopt-output/usage.jsonl";
 var DEFAULT_OUTPUT_DIR = "./aiopt-output";
 function loadRateTable() {
-  const p = import_path16.default.join(__dirname, "..", "rates", "rate_table.json");
-  return JSON.parse(import_fs15.default.readFileSync(p, "utf8"));
+  const p = import_path17.default.join(__dirname, "..", "rates", "rate_table.json");
+  return JSON.parse(import_fs16.default.readFileSync(p, "utf8"));
 }
 program.name("aiopt").description("AI \uBE44\uC6A9 \uC790\uB3D9 \uC808\uAC10 \uC778\uD504\uB77C \u2014 \uC11C\uBC84 \uC5C6\uB294 \uB85C\uCEEC CLI MVP").version(require_package().version);
 program.command("init").description("aiopt-input/ \uBC0F \uC0D8\uD50C usage.jsonl, aiopt-output/ \uC0DD\uC131").action(() => {
   ensureDir("./aiopt-input");
   ensureDir("./aiopt-output");
-  const sampleSrc = import_path16.default.join(__dirname, "..", "samples", "sample_usage.jsonl");
-  const dst = import_path16.default.join("./aiopt-input", "usage.jsonl");
-  if (!import_fs15.default.existsSync(dst)) {
-    import_fs15.default.copyFileSync(sampleSrc, dst);
+  const sampleSrc = import_path17.default.join(__dirname, "..", "samples", "sample_usage.jsonl");
+  const dst = import_path17.default.join("./aiopt-input", "usage.jsonl");
+  if (!import_fs16.default.existsSync(dst)) {
+    import_fs16.default.copyFileSync(sampleSrc, dst);
     console.log("Created ./aiopt-input/usage.jsonl (sample)");
   } else {
     console.log("Exists ./aiopt-input/usage.jsonl (skip)");
   }
   console.log("Ready: ./aiopt-output/");
 });
-program.command("scan").description("\uC785\uB825 \uB85C\uADF8(JSONL/CSV)\uB97C \uBD84\uC11D\uD558\uACE0 report.md/report.json + patches\uAE4C\uC9C0 \uC0DD\uC131").option("--input <path>", "input file path (default: ./aiopt-output/usage.jsonl)", DEFAULT_INPUT).option("--out <dir>", "output dir (default: ./aiopt-output)", DEFAULT_OUTPUT_DIR).action(async (opts) => {
+program.command("scan").description("\uC785\uB825 \uB85C\uADF8(JSONL/CSV)\uB97C \uBD84\uC11D\uD558\uACE0 report.md/report.json + patches\uAE4C\uC9C0 \uC0DD\uC131").option("--input <path>", "input file path (default: ./aiopt-output/usage.jsonl)", DEFAULT_INPUT).option("--out <dir>", "output dir (default: ./aiopt-output)", DEFAULT_OUTPUT_DIR).option("--json", "print machine-readable JSON to stdout").action(async (opts) => {
   const inputPath = String(opts.input);
   const outDir = String(opts.out);
-  if (!import_fs15.default.existsSync(inputPath)) {
+  if (!import_fs16.default.existsSync(inputPath)) {
     console.error(`Input not found: ${inputPath}`);
     process.exit(1);
   }
@@ -2563,12 +2593,32 @@ program.command("scan").description("\uC785\uB825 \uB85C\uADF8(JSONL/CSV)\uB97C
   writeOutputs(outDir, analysis, savings, policy, { ...meta, cwd: process.cwd(), cliVersion: program.version() });
   const { buildTopFixes: buildTopFixes2 } = await Promise.resolve().then(() => (init_solutions(), solutions_exports));
   const fixes = buildTopFixes2(analysis, savings).slice(0, 3);
+  if (opts.json) {
+    const payload = {
+      ok: true,
+      outDir,
+      input: inputPath,
+      report: {
+        report_md: import_path17.default.join(outDir, "report.md"),
+        report_json: import_path17.default.join(outDir, "report.json"),
+        cost_policy_json: import_path17.default.join(outDir, "cost-policy.json"),
+        sarif: import_path17.default.join(outDir, "aiopt.sarif")
+      },
+      summary: {
+        total_cost_usd: analysis.total_cost,
+        estimated_savings_usd: savings.estimated_savings_total,
+        confidence: meta?.mode || null
+      }
+    };
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
   console.log("Top Fix 3:");
   fixes.forEach((f, i) => {
     const tag = f.status === "no-issue" ? "(no issue detected)" : `($${Math.round(f.impact_usd * 100) / 100})`;
     console.log(`${i + 1}) ${f.title} ${tag}`);
   });
-  console.log(`Report: ${import_path16.default.join(outDir, "report.md")}`);
+  console.log(`Report: ${import_path17.default.join(outDir, "report.md")}`);
 });
 program.command("policy").description("\uB9C8\uC9C0\uB9C9 scan \uACB0\uACFC \uAE30\uBC18\uC73C\uB85C cost-policy.json\uB9CC \uC7AC\uC0DD\uC131 (MVP: scan\uACFC \uB3D9\uC77C \uB85C\uC9C1)").option("--input <path>", "input file path (default: ./aiopt-input/usage.jsonl)", DEFAULT_INPUT).option("--out <dir>", "output dir (default: ./aiopt-output)", DEFAULT_OUTPUT_DIR).action((opts) => {
   const inputPath = String(opts.input);
@@ -2578,7 +2628,7 @@ program.command("policy").description("\uB9C8\uC9C0\uB9C9 scan \uACB0\uACFC \uAE
   const { policy } = analyze(rt, events);
   policy.generated_from.input = inputPath;
   ensureDir(outDir);
-  import_fs15.default.writeFileSync(import_path16.default.join(outDir, "cost-policy.json"), JSON.stringify(policy, null, 2));
+  import_fs16.default.writeFileSync(import_path17.default.join(outDir, "cost-policy.json"), JSON.stringify(policy, null, 2));
   console.log(`OK: ${outDir}/cost-policy.json`);
 });
 program.command("install").description("Install AIOpt guardrails: create aiopt/ + policies + usage.jsonl").option("--force", "overwrite existing files").option("--seed-sample", "seed 1 sample line into aiopt-output/usage.jsonl").action(async (opts) => {
@@ -2618,7 +2668,7 @@ licenseCmd.command("verify").option("--path <path>", "license.json path (default
   const { DEFAULT_PUBLIC_KEY_PEM: DEFAULT_PUBLIC_KEY_PEM2, defaultLicensePath: defaultLicensePath2, readLicenseFile: readLicenseFile2, verifyLicenseKey: verifyLicenseKey2 } = await Promise.resolve().then(() => (init_license(), license_exports));
   const p = opts.path ? String(opts.path) : defaultLicensePath2(process.cwd());
   const pub = process.env.AIOPT_LICENSE_PUBKEY || DEFAULT_PUBLIC_KEY_PEM2;
-  if (!import_fs15.default.existsSync(p)) {
+  if (!import_fs16.default.existsSync(p)) {
     console.error(`FAIL: license file not found: ${p}`);
     process.exit(3);
   }
@@ -2635,7 +2685,7 @@ licenseCmd.command("status").option("--path <path>", "license.json path (default
   const { DEFAULT_PUBLIC_KEY_PEM: DEFAULT_PUBLIC_KEY_PEM2, defaultLicensePath: defaultLicensePath2, readLicenseFile: readLicenseFile2, verifyLicenseKey: verifyLicenseKey2 } = await Promise.resolve().then(() => (init_license(), license_exports));
   const p = opts.path ? String(opts.path) : defaultLicensePath2(process.cwd());
   const pub = process.env.AIOPT_LICENSE_PUBKEY || DEFAULT_PUBLIC_KEY_PEM2;
-  if (!import_fs15.default.existsSync(p)) {
+  if (!import_fs16.default.existsSync(p)) {
     console.log("NO_LICENSE");
     process.exit(2);
   }
@@ -2648,28 +2698,79 @@ licenseCmd.command("status").option("--path <path>", "license.json path (default
   console.log(`INVALID: ${v.reason || "unknown"}`);
   process.exit(3);
 });
-program.command("gate").description("Merge gate (CI-friendly): fail (exit 1) when policy violations are detected; prints <=10 lines").option("--input <path>", "input usage jsonl/csv (default: ./aiopt-output/usage.jsonl)", DEFAULT_INPUT).option("--out <dir>", "output dir (default: ./aiopt-output)", DEFAULT_OUTPUT_DIR).action(async (opts) => {
-  const inputPath = String(opts.input);
+program.command("gate").description("Merge gate (CI-friendly): fail (exit 1) when policy violations are detected; prints <=10 lines").option("--input <path>", "input usage jsonl/csv (default: ./aiopt-output/usage.jsonl)", DEFAULT_INPUT).option("--out <dir>", "output dir (default: ./aiopt-output)", DEFAULT_OUTPUT_DIR).option("--json", "print machine-readable JSON to stdout").action(async (opts) => {
+  const preferredInput = String(opts.input);
   const outDir = String(opts.out);
-  if (!import_fs15.default.existsSync(inputPath)) {
-    console.error(`FAIL: input not found: ${inputPath}`);
+  const resolved = resolveUsagePath(preferredInput);
+  const inputPath = resolved.path;
+  const defaultOut = "./aiopt-output";
+  let finalOutDir = outDir;
+  if (outDir === defaultOut) {
+    try {
+      const os4 = require("os");
+      finalOutDir = import_path17.default.join(os4.homedir(), ".aiopt", "aiopt-output");
+    } catch {
+      finalOutDir = outDir;
+    }
+  }
+  if (!import_fs16.default.existsSync(inputPath)) {
+    if (opts.json) {
+      console.log(JSON.stringify({
+        ok: false,
+        exitCode: 1,
+        error: "input_not_found",
+        message: `FAIL: input not found: ${preferredInput}`,
+        tried: resolved.tried,
+        hint: "Run: aiopt dashboard (auto-collects OpenClaw usage) or pass --input <usage.jsonl>"
+      }, null, 2));
+    } else {
+      console.error(`FAIL: input not found: ${preferredInput}`);
+      console.error(`Tried: ${resolved.tried.join(", ")}`);
+      console.error("Hint: run `aiopt dashboard` first (auto-collects OpenClaw usage)");
+    }
     process.exit(1);
   }
   const rt = loadRateTable();
   const events = isCsvPath(inputPath) ? readCsv(inputPath) : readJsonl(inputPath);
   const { analysis, savings, policy, meta } = analyze(rt, events);
   policy.generated_from.input = inputPath;
-  writeOutputs(outDir, analysis, savings, policy, { ...meta, cwd: process.cwd(), cliVersion: program.version() });
+  writeOutputs(finalOutDir, analysis, savings, policy, { ...meta, cwd: process.cwd(), cliVersion: program.version() });
   const { runGate: runGate2, formatGateStdout: formatGateStdout2 } = await Promise.resolve().then(() => (init_gate(), gate_exports));
-  const r = runGate2(outDir, process.cwd());
-  const out = formatGateStdout2(r, outDir);
+  const r = runGate2(finalOutDir, process.cwd());
+  if (opts.json) {
+    const payload = {
+      ok: r.violations <= 0,
+      exitCode: r.violations <= 0 ? 0 : 1,
+      violations: r.violations,
+      top3: r.top3,
+      artifacts: {
+        report_md: import_path17.default.join(finalOutDir, "report.md"),
+        sarif: import_path17.default.join(finalOutDir, "aiopt.sarif"),
+        patches_dir: import_path17.default.join(finalOutDir, "patches")
+      }
+    };
+    console.log(JSON.stringify(payload, null, 2));
+    process.exit(payload.exitCode);
+  }
+  const out = formatGateStdout2(r, finalOutDir);
   console.log(out.text);
   process.exit(out.exitCode);
 });
-program.command("fix").description("Auto-fix suggestions: generate aiopt.patch (and optionally apply it via git apply)").option("--out <dir>", "output dir (default: ./aiopt-output)", DEFAULT_OUTPUT_DIR).option("--apply", "apply the generated patch via git apply").action(async (opts) => {
+program.command("fix").description("Auto-fix suggestions: generate aiopt.patch (and optionally apply it via git apply)").option("--out <dir>", "output dir (default: ./aiopt-output)", DEFAULT_OUTPUT_DIR).option("--apply", "apply the generated patch via git apply").option("--json", "print machine-readable JSON to stdout").action(async (opts) => {
   const outDir = String(opts.out);
   const { runFix: runFix2 } = await Promise.resolve().then(() => (init_fix(), fix_exports));
   const r = runFix2(process.cwd(), { outDir, apply: Boolean(opts.apply) });
+  if (opts.json) {
+    const payload = {
+      ok: r.ok,
+      applied: r.applied,
+      patchPath: r.patchPath,
+      changedFiles: r.changedFiles,
+      hint: r.hint || null
+    };
+    console.log(JSON.stringify(payload, null, 2));
+    process.exit(r.ok ? 0 : 1);
+  }
   console.log(`Patch: ${r.patchPath}`);
   if (r.changedFiles.length) {
     console.log(`Files: ${r.changedFiles.slice(0, 10).join(", ")}${r.changedFiles.length > 10 ? " ..." : ""}`);
@@ -2686,7 +2787,7 @@ program.command("fix").description("Auto-fix suggestions: generate aiopt.patch (
   }
   process.exit(0);
 });
-program.command("guard").description("Pre-deploy guardrail: compare baseline usage vs candidate change (or diff two log sets) and print warnings (exit codes 0/2/3)").option("--input <path>", "baseline usage jsonl/csv (legacy alias for --baseline; default: ./aiopt-output/usage.jsonl)", DEFAULT_INPUT).option("--baseline <path>", "baseline usage jsonl/csv (diff mode when used with --candidate)").option("--candidate <path>", "candidate usage jsonl/csv (diff mode: compare two real log sets)").option("--provider <provider>", "candidate provider override (transform mode only)").option("--model <model>", "candidate model override (transform mode only)").option("--context-mult <n>", "multiply input_tokens by n (transform mode only)", (v) => Number(v)).option("--output-mult <n>", "multiply output_tokens by n (transform mode only)", (v) => Number(v)).option("--retries-delta <n>", "add n to retries (transform mode only)", (v) => Number(v)).option("--call-mult <n>", "multiply call volume by n (traffic spike)", (v) => Number(v)).option("--budget-monthly <usd>", "fail if estimated candidate monthly cost exceeds this budget", (v) => Number(v)).action(async (opts) => {
+program.command("guard").description("Pre-deploy guardrail: compare baseline usage vs candidate change (or diff two log sets) and print warnings (exit codes 0/2/3)").option("--input <path>", "baseline usage jsonl/csv (legacy alias for --baseline; default: ./aiopt-output/usage.jsonl)", DEFAULT_INPUT).option("--baseline <path>", "baseline usage jsonl/csv (diff mode when used with --candidate)").option("--candidate <path>", "candidate usage jsonl/csv (diff mode: compare two real log sets)").option("--provider <provider>", "candidate provider override (transform mode only)").option("--model <model>", "candidate model override (transform mode only)").option("--context-mult <n>", "multiply input_tokens by n (transform mode only)", (v) => Number(v)).option("--output-mult <n>", "multiply output_tokens by n (transform mode only)", (v) => Number(v)).option("--retries-delta <n>", "add n to retries (transform mode only)", (v) => Number(v)).option("--call-mult <n>", "multiply call volume by n (traffic spike)", (v) => Number(v)).option("--budget-monthly <usd>", "fail if estimated candidate monthly cost exceeds this budget", (v) => Number(v)).option("--json", "print machine-readable JSON to stdout").action(async (opts) => {
   const rt = loadRateTable();
   const baselinePath = String(opts.baseline || opts.input);
   const candidatePath = opts.candidate ? String(opts.candidate) : null;
@@ -2695,11 +2796,11 @@ program.command("guard").description("Pre-deploy guardrail: compare baseline usa
     console.error("FAIL: diff mode requires both --baseline and --candidate");
     process.exit(3);
   }
-  if (!import_fs15.default.existsSync(baselinePath)) {
+  if (!import_fs16.default.existsSync(baselinePath)) {
     console.error(`FAIL: baseline not found: ${baselinePath}`);
     process.exit(3);
   }
-  if (candidatePath && !import_fs15.default.existsSync(candidatePath)) {
+  if (candidatePath && !import_fs16.default.existsSync(candidatePath)) {
     console.error(`FAIL: candidate not found: ${candidatePath}`);
     process.exit(3);
   }
@@ -2719,23 +2820,40 @@ program.command("guard").description("Pre-deploy guardrail: compare baseline usa
       budgetMonthlyUsd: opts.budgetMonthly
     }
   });
-  console.log(r.message);
+  if (opts.json) {
+    const payload = {
+      exitCode: r.exitCode,
+      message: r.message,
+      mode: candidateEvents ? "diff" : "transform",
+      baseline: baselinePath,
+      candidate: candidatePath,
+      artifacts: {
+        outDir: import_path17.default.resolve(DEFAULT_OUTPUT_DIR),
+        guard_last_txt: import_path17.default.join(import_path17.default.resolve(DEFAULT_OUTPUT_DIR), "guard-last.txt"),
+        guard_last_json: import_path17.default.join(import_path17.default.resolve(DEFAULT_OUTPUT_DIR), "guard-last.json"),
+        guard_history_jsonl: import_path17.default.join(import_path17.default.resolve(DEFAULT_OUTPUT_DIR), "guard-history.jsonl")
+      }
+    };
+    console.log(JSON.stringify(payload, null, 2));
+  } else {
+    console.log(r.message);
+  }
   try {
-    const outDir = import_path16.default.resolve(DEFAULT_OUTPUT_DIR);
-    import_fs15.default.mkdirSync(outDir, { recursive: true });
+    const outDir = import_path17.default.resolve(DEFAULT_OUTPUT_DIR);
+    import_fs16.default.mkdirSync(outDir, { recursive: true });
     const ts = (/* @__PURE__ */ new Date()).toISOString();
-    import_fs15.default.writeFileSync(import_path16.default.join(outDir, "guard-last.txt"), r.message);
-    import_fs15.default.writeFileSync(import_path16.default.join(outDir, "guard-last.json"), JSON.stringify({ ts, exitCode: r.exitCode }, null, 2));
+    import_fs16.default.writeFileSync(import_path17.default.join(outDir, "guard-last.txt"), r.message);
+    import_fs16.default.writeFileSync(import_path17.default.join(outDir, "guard-last.json"), JSON.stringify({ ts, exitCode: r.exitCode }, null, 2));
     const histLine = JSON.stringify({ ts, exitCode: r.exitCode, mode: candidateEvents ? "diff" : "transform", baseline: baselinePath, candidate: candidatePath }) + "\n";
-    import_fs15.default.appendFileSync(import_path16.default.join(outDir, "guard-history.jsonl"), histLine);
+    import_fs16.default.appendFileSync(import_path17.default.join(outDir, "guard-history.jsonl"), histLine);
   } catch {
   }
   process.exit(r.exitCode);
 });
 program.command("dashboard").description("Local dashboard (localhost only): view usage + scan + guard (auto-collects OpenClaw usage)").option("--port <n>", "port (default: 3010)", (v) => Number(v), 3010).option("--dir <path>", "base directory (default: ~/.aiopt). Use this to pin a consistent data source.").option("--auto", "auto-detect by searching parents (and one-level children) for aiopt-output (use only if you really want project-local)").action(async (opts) => {
   const { startDashboard: startDashboard2 } = await Promise.resolve().then(() => (init_dashboard(), dashboard_exports));
-  const os3 = await import("os");
-  const defaultBase = require("path").join(os3.homedir(), ".aiopt");
+  const os4 = await import("os");
+  const defaultBase = require("path").join(os4.homedir(), ".aiopt");
   const base = opts.dir ? String(opts.dir) : defaultBase;
   if (opts.auto && !opts.dir) {
     const { findAioptOutputDir: findAioptOutputDir2 } = await Promise.resolve().then(() => (init_find_output(), find_output_exports));
@@ -2757,14 +2875,14 @@ program.command("quickstart").description("1-minute demo: generate sample usage,
   console.log("--- guard ---");
   console.log(r.guard.message);
   try {
-    const fs16 = await import("fs");
-    const path17 = await import("path");
-    fs16.mkdirSync(r.outDir, { recursive: true });
+    const fs17 = await import("fs");
+    const path18 = await import("path");
+    fs17.mkdirSync(r.outDir, { recursive: true });
     const ts = (/* @__PURE__ */ new Date()).toISOString();
-    fs16.writeFileSync(path17.join(r.outDir, "guard-last.txt"), r.guard.message);
-    fs16.writeFileSync(path17.join(r.outDir, "guard-last.json"), JSON.stringify({ ts, exitCode: r.guard.exitCode }, null, 2));
+    fs17.writeFileSync(path18.join(r.outDir, "guard-last.txt"), r.guard.message);
+    fs17.writeFileSync(path18.join(r.outDir, "guard-last.json"), JSON.stringify({ ts, exitCode: r.guard.exitCode }, null, 2));
     const histLine = JSON.stringify({ ts, exitCode: r.guard.exitCode, mode: "quickstart", baseline: r.usagePath, candidate: null }) + "\n";
-    fs16.appendFileSync(path17.join(r.outDir, "guard-history.jsonl"), histLine);
+    fs17.appendFileSync(path18.join(r.outDir, "guard-history.jsonl"), histLine);
   } catch {
   }
   console.log("--- next ---");