infernoflow 0.33.1 → 0.34.1

package/dist/lib/commands/switch.mjs

@@ -1,9 +1,310 @@
-import*as f from"node:fs";import*as m from"node:path";import{execSync as O}from"node:child_process";import{bold as k,cyan as d,gray as R,green as x,yellow as E,red as T}from"../ui/output.mjs";const y="inferno",L=m.join(y,"HANDOFF.md"),_=m.join(y,"sessions.jsonl"),N=m.join(y,"context-state.json"),D=m.join(y,"contract.json"),A=m.join(y,"theme.json");function r(t){try{return JSON.parse(f.readFileSync(t,"utf8"))}catch{return null}}function V(t){try{return f.readFileSync(t,"utf8")}catch{return null}}function g(t){return t?new Date(t).toLocaleString("en-GB",{day:"2-digit",month:"short",hour:"2-digit",minute:"2-digit"}):"unknown"}function C(t=8){return f.existsSync(_)?f.readFileSync(_,"utf8").split(`
-`).filter(Boolean).map(e=>{try{return JSON.parse(e)}catch{return null}}).filter(Boolean).slice(-t):[]}function G(t){try{const e=process.platform;if(e==="win32")O("clip",{input:t});else if(e==="darwin")O("pbcopy",{input:t});else try{O("xclip -selection clipboard",{input:t})}catch{O("xsel --clipboard --input",{input:t})}return!0}catch{return!1}}function J(t){const e=r(N)||{},w=r(D)||{},i=r(A),c=C(8),b=new Date().toLocaleString("en-GB",{day:"2-digit",month:"short",year:"numeric",hour:"2-digit",minute:"2-digit"}),l=w.policyId||m.basename(process.cwd()),$=w.policyVersion||"?",F=(w.capabilities||[]).slice(0,20),p=c.filter(n=>n.type==="gotcha"),u=c.filter(n=>n.type==="decision"),j=c.filter(n=>n.type==="attempt"),s=c.filter(n=>n.type==="preference"),a=c.filter(n=>n.type==="theme"),S=c.slice(-5),o=[`# \u{1F525} infernoflow Handoff \u2014 ${l}`,`> Generated: ${b}${t?` | Handing off to: **${t}**`:""}`,"","---","","## Pick up here",""];if(e.working||e.intent?(e.working&&o.push(`**Working on:** ${e.working}  _(${g(e.workingUpdated)})_`),e.intent&&o.push(`**Intent:** ${e.intent}  _(${g(e.intentUpdated)})_`),o.push("")):o.push('_No working state set. Run: `infernoflow context --working "..."` to set it._',""),p.length){o.push("## \u26A0 Gotchas \u2014 read these first","");for(const n of p)o.push(`- ${n.summary}  _(${g(n.ts)})_`);o.push("")}if(u.length){o.push("## Decisions made","");for(const n of u){const h=n.result?` \u2192 **${n.result}**`:"";o.push(`- ${n.summary}${h}  _(${g(n.ts)})_`)}o.push("")}const H=j.filter(n=>n.result==="failed"||n.result==="partial");if(H.length){o.push("## \u2717 Already tried \u2014 don't repeat","");for(const n of H)o.push(`- ${n.summary}  _(${g(n.ts)})_`);o.push("")}if(s.length){o.push("## Developer preferences","");for(const n of s)o.push(`- ${n.summary}`);o.push("")}if(i){if(o.push("## Design system",""),i.fonts?.primary&&o.push(`- **Font:** ${i.fonts.primary}${i.fonts.mono?` \xB7 mono: ${i.fonts.mono}`:""}`),i.colors?.mode&&o.push(`- **Mode:** ${i.colors.mode}`),i.colors?.palette){const n=Object.entries(i.colors.palette).map(([h,I])=>`${h}=${I}`).join("  ");o.push(`- **Palette:** ${n}`)}if(i.cssVars&&Object.keys(i.cssVars).length){const n=Object.entries(i.cssVars).slice(0,6).map(([h,I])=>`${h}: ${I}`).join("  |  ");o.push(`- **CSS vars:** ${n}`)}i.framework&&o.push(`- **Framework:** ${i.framework}`),o.push("","> \u26A0 Always match these exactly. Do not introduce new colors or fonts.","")}if(F.length&&(o.push("## Capability contract",""),o.push(`Project: **${l}** v${$}`),o.push(`Capabilities: ${F.join(", ")}`),o.push("")),S.length){o.push("## Recent session log","");for(const n of S){const h=n.result?` [${n.result}]`:"";o.push(`- **${n.type}**${h}: ${n.summary}  _(${g(n.ts)})_`)}o.push("")}return o.push("---"),o.push("_Paste this at the start of your next AI session. Generated by infernoflow._"),o.join(`
-`)}async function B(t){const e=s=>t.includes(s),w=s=>{const a=t.indexOf(s);return a!==-1&&t[a+1]?t[a+1]:null},i=e("--show")||e("-s"),c=e("--copy")||e("-c"),b=e("--json"),l=w("--to")||t.find(s=>!s.startsWith("-")&&!["switch"].includes(s))||null;if(console.log(`
-  `+k("\u{1F525} infernoflow \u2014 switch")),console.log("  "+"\u2500".repeat(50)+`
-`),f.existsSync(y)||(console.error(T(`  \u2718 inferno/ not found \u2014 run: infernoflow init
-`)),process.exit(1)),i){const s=V(L);if(!s){console.log(E(`  \u26A0 No HANDOFF.md yet \u2014 run: infernoflow switch
-`));return}console.log(s);return}const $=J(l);if(b){const s=r(N)||{},a=r(D)||{},S=r(A),o=C(8);console.log(JSON.stringify({state:s,contract:{policyId:a.policyId,policyVersion:a.policyVersion,capabilities:a.capabilities},theme:S,sessions:o,generatedAt:new Date().toISOString()},null,2));return}if(f.writeFileSync(L,$,"utf8"),console.log(x(`  \u2714 Written \u2192 inferno/HANDOFF.md
-`)),f.existsSync(_)){const s={ts:new Date().toISOString(),agent:"infernoflow",type:"handoff",summary:l?`Handed off to ${l}`:"Handoff generated"};f.appendFileSync(_,JSON.stringify(s)+`
-`,"utf8")}const F=C(100).length,p=r(N)||{},u=r(A),j=r(D)||{};if(console.log("  "+k("Handoff summary")),console.log("  "+"\u2500".repeat(50)),p.working&&console.log("  Working on    "+d(p.working)),p.intent&&console.log("  Intent        "+d(p.intent)),console.log("  Sessions      "+F+" entries in memory"),console.log("  Capabilities  "+(j.capabilities||[]).length+" registered"),u?.fonts?.primary&&console.log("  Font          "+u.fonts.primary),u?.colors?.mode&&console.log("  Color mode    "+u.colors.mode),l&&console.log("  Handing off \u2192 "+d(l)),console.log(),c){const s=G($);console.log(s?x("  \u2714 Copied to clipboard \u2014 paste at the start of your next AI session"):E("  \u26A0 Clipboard failed \u2014 open inferno/HANDOFF.md manually"))}else console.log("  "+k("Ready to use:")),console.log("  "+d("1.")+" Open    "+d("inferno/HANDOFF.md")),console.log("  "+d("2.")+" Copy all"),console.log("  "+d("3.")+" Paste at the start of your next AI session"),console.log("  "+R("  tip: use --copy to skip steps 1-2 automatically"));console.log()}export{B as switchCommand};
+/**
+ * infernoflow switch
+ *
+ * Generates a handoff summary when switching between AI agents
+ * (Copilot → Cursor → Claude → Windsurf → etc.).
+ *
+ * Captures the full session state — what was tried, what worked, what's
+ * in progress, the design system, and the capability context — into a
+ * single pasteable block so the next agent picks up exactly where you left off.
+ *
+ * Session boundary detection (same logic as `infernoflow recap`):
+ *   - All entries since the last `handoff` entry, or the last 24h — whichever is more recent
+ *   - Use --since to override (e.g. --since 48h, --since 2026-04-20)
+ *   - Use --all to include every entry ever logged
+ *
+ * Also writes inferno/HANDOFF.md (auto-loaded by some IDEs).
+ *
+ * Usage:
+ *   infernoflow switch                  Generate handoff + write HANDOFF.md
+ *   infernoflow switch --to cursor      Label the handoff for a specific agent
+ *   infernoflow switch --copy           Copy to clipboard
+ *   infernoflow switch --show           Print current HANDOFF.md
+ *   infernoflow switch --json           Output as JSON
+ *   infernoflow switch --since 48h      Include entries from the last 48 hours
+ *   infernoflow switch --all            Include all entries ever logged
+ */
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+import { bold, cyan, gray, green, yellow, red } from "../ui/output.mjs";
+
+const INFERNO_DIR    = "inferno";
+const HANDOFF_FILE   = path.join(INFERNO_DIR, "HANDOFF.md");
+const SESSIONS_FILE  = path.join(INFERNO_DIR, "sessions.jsonl");
+const STATE_FILE     = path.join(INFERNO_DIR, "context-state.json");
+const CONTRACT_FILE  = path.join(INFERNO_DIR, "contract.json");
+const THEME_FILE     = path.join(INFERNO_DIR, "theme.json");
+
+function readJSON(f) { try { return JSON.parse(fs.readFileSync(f, "utf8")); } catch { return null; } }
+function readFile(f) { try { return fs.readFileSync(f, "utf8"); } catch { return null; } }
+
+function fmtDate(iso) {
+  if (!iso) return "unknown";
+  return new Date(iso).toLocaleString("en-GB", { day: "2-digit", month: "short", hour: "2-digit", minute: "2-digit" });
+}
+
+function getAllEntries() {
+  if (!fs.existsSync(SESSIONS_FILE)) return [];
+  return fs.readFileSync(SESSIONS_FILE, "utf8")
+    .split("\n").filter(Boolean)
+    .map(l => { try { return JSON.parse(l); } catch { return null; } })
+    .filter(Boolean);
+}
+
+/**
+ * Find the start of the "current session":
+ *   - The timestamp of the last `handoff` entry, OR 24h ago — whichever is more recent
+ *   - --since overrides both; --all returns epoch (everything)
+ */
+function findSessionStart(allEntries, sinceArg, allFlag) {
+  if (allFlag) return new Date(0);
+
+  if (sinceArg) {
+    const hoursMatch = sinceArg.match(/^(\d+)h$/i);
+    const daysMatch  = sinceArg.match(/^(\d+)d$/i);
+    if (hoursMatch) return new Date(Date.now() - parseInt(hoursMatch[1]) * 3600000);
+    if (daysMatch)  return new Date(Date.now() - parseInt(daysMatch[1]) * 86400000);
+    const parsed = new Date(sinceArg);
+    if (!isNaN(parsed)) return parsed;
+  }
+
+  // Find last handoff entry
+  for (let i = allEntries.length - 1; i >= 0; i--) {
+    if (allEntries[i].type === "handoff") {
+      const ts = new Date(allEntries[i].ts || 0);
+      const dayAgo = new Date(Date.now() - 86400000);
+      return ts > dayAgo ? ts : dayAgo;
+    }
+  }
+
+  return new Date(Date.now() - 86400000);
+}
+
+function copyToClipboard(text) {
+  try {
+    const p = process.platform;
+    if (p === "win32") execSync("clip", { input: text });
+    else if (p === "darwin") execSync("pbcopy", { input: text });
+    else { try { execSync("xclip -selection clipboard", { input: text }); } catch { execSync("xsel --clipboard --input", { input: text }); } }
+    return true;
+  } catch { return false; }
+}
+
+function buildHandoff(toAgent, sinceArg, allFlag) {
+  const state      = readJSON(STATE_FILE)    || {};
+  const contract   = readJSON(CONTRACT_FILE) || {};
+  const theme      = readJSON(THEME_FILE);
+  const allEntries = getAllEntries();
+  const sessionStart = findSessionStart(allEntries, sinceArg, allFlag);
+  // Session entries: everything since boundary; also keep last 5 for "recent log"
+  const sessions   = allEntries.filter(e => new Date(e.ts || 0) > sessionStart);
+  const recentFallback = allEntries.slice(-5); // fallback if session is empty
+  const now        = new Date().toLocaleString("en-GB", { day: "2-digit", month: "short", year: "numeric", hour: "2-digit", minute: "2-digit" });
+
+  const projectId = contract.policyId || path.basename(process.cwd());
+  const version   = contract.policyVersion || "?";
+  const caps      = (contract.capabilities || []).slice(0, 20);
+
+  // ── Session memory grouped by type ────────────────────────────────────────
+  const pool      = sessions.length > 0 ? sessions : recentFallback;
+  const gotchas   = pool.filter(e => e.type === "gotcha");
+  const decisions = pool.filter(e => e.type === "decision");
+  const attempts  = pool.filter(e => e.type === "attempt").filter(e => e.result === "failed" || e.result === "partial");
+  const prefs     = pool.filter(e => e.type === "preference");
+  const recent    = pool.slice(-8); // last 8 regardless of type
+
+  const sinceStr = sessionStart.getTime() === 0
+    ? "all time"
+    : sessionStart.toLocaleString("en-GB", { day: "2-digit", month: "short", hour: "2-digit", minute: "2-digit" });
+
+  const lines = [
+    `# 🔥 infernoflow Handoff — ${projectId}`,
+    `> Generated: ${now}${toAgent ? ` | Handing off to: **${toAgent}**` : ""}`,
+    `> Session memory: **${sessions.length} entries** since ${sinceStr}`,
+    "",
+    "---",
+    "",
+    "## Pick up here",
+    "",
+  ];
+
+  // Current working state
+  if (state.working || state.intent) {
+    if (state.working) lines.push(`**Working on:** ${state.working}  _(${fmtDate(state.workingUpdated)})_`);
+    if (state.intent)  lines.push(`**Intent:** ${state.intent}  _(${fmtDate(state.intentUpdated)})_`);
+    lines.push("");
+  } else {
+    lines.push("_No working state set. Run: `infernoflow context --working \"...\"` to set it._", "");
+  }
+
+  // ── Gotchas first — most critical for a new agent ─────────────────────────
+  if (gotchas.length) {
+    lines.push("## ⚠ Gotchas — read these first", "");
+    for (const e of gotchas) {
+      lines.push(`- ${e.summary}  _(${fmtDate(e.ts)})_`);
+    }
+    lines.push("");
+  }
+
+  // ── Decisions ──────────────────────────────────────────────────────────────
+  if (decisions.length) {
+    lines.push("## Decisions made", "");
+    for (const e of decisions) {
+      const result = e.result ? ` → **${e.result}**` : "";
+      lines.push(`- ${e.summary}${result}  _(${fmtDate(e.ts)})_`);
+    }
+    lines.push("");
+  }
+
+  // ── Failed attempts — don't repeat them ───────────────────────────────────
+  if (attempts.length) {
+    lines.push("## ✗ Already tried — don't repeat", "");
+    for (const e of attempts) {
+      lines.push(`- ${e.summary}  _(${fmtDate(e.ts)})_`);
+    }
+    lines.push("");
+  }
+
+  // ── Preferences ───────────────────────────────────────────────────────────
+  if (prefs.length) {
+    lines.push("## Developer preferences", "");
+    for (const e of prefs) {
+      lines.push(`- ${e.summary}`);
+    }
+    lines.push("");
+  }
+
+  // ── Design system ─────────────────────────────────────────────────────────
+  if (theme) {
+    lines.push("## Design system", "");
+    if (theme.fonts?.primary) lines.push(`- **Font:** ${theme.fonts.primary}${theme.fonts.mono ? ` · mono: ${theme.fonts.mono}` : ""}`);
+    if (theme.colors?.mode)   lines.push(`- **Mode:** ${theme.colors.mode}`);
+    if (theme.colors?.palette) {
+      const pal = Object.entries(theme.colors.palette).map(([k,v]) => `${k}=${v}`).join("  ");
+      lines.push(`- **Palette:** ${pal}`);
+    }
+    if (theme.cssVars && Object.keys(theme.cssVars).length) {
+      const top = Object.entries(theme.cssVars).slice(0, 6).map(([k,v]) => `${k}: ${v}`).join("  |  ");
+      lines.push(`- **CSS vars:** ${top}`);
+    }
+    if (theme.framework) lines.push(`- **Framework:** ${theme.framework}`);
+    lines.push("", "> ⚠ Always match these exactly. Do not introduce new colors or fonts.", "");
+  }
+
+  // ── Capabilities ──────────────────────────────────────────────────────────
+  if (caps.length) {
+    lines.push("## Capability contract", "");
+    lines.push(`Project: **${projectId}** v${version}`);
+    lines.push(`Capabilities: ${caps.join(", ")}`);
+    lines.push("");
+  }
+
+  // ── Recent session log ────────────────────────────────────────────────────
+  if (recent.length) {
+    lines.push("## Recent session log", "");
+    for (const e of recent) {
+      const result = e.result ? ` [${e.result}]` : "";
+      lines.push(`- **${e.type}**${result}: ${e.summary}  _(${fmtDate(e.ts)})_`);
+    }
+    lines.push("");
+  }
+
+  lines.push("---");
+  lines.push("_Paste this at the start of your next AI session. Generated by infernoflow._");
+
+  return lines.join("\n");
+}
+
+export async function switchCommand(args) {
+  const has      = (f) => args.includes(f);
+  const flag     = (f) => { const i = args.indexOf(f); return i !== -1 && args[i+1] ? args[i+1] : null; };
+  const showOnly = has("--show") || has("-s");
+  const copyFlag = has("--copy") || has("-c");
+  const jsonFlag = has("--json");
+  const allFlag  = has("--all");
+  const sinceArg = flag("--since");
+  const toAgent  = flag("--to") || args.find(a => !a.startsWith("-") && !["switch"].includes(a)) || null;
+
+  console.log("\n  " + bold("🔥 infernoflow — switch"));
+  console.log("  " + "─".repeat(50) + "\n");
+
+  if (!fs.existsSync(INFERNO_DIR)) {
+    console.error(red("  ✘ inferno/ not found — run: infernoflow init\n"));
+    process.exit(1);
+  }
+
+  // ── Show existing handoff ─────────────────────────────────────────────────
+  if (showOnly) {
+    const existing = readFile(HANDOFF_FILE);
+    if (!existing) {
+      console.log(yellow("  ⚠ No HANDOFF.md yet — run: infernoflow switch\n"));
+      return;
+    }
+    console.log(existing);
+    return;
+  }
+
+  const handoff = buildHandoff(toAgent, sinceArg, allFlag);
+
+  if (jsonFlag) {
+    const state      = readJSON(STATE_FILE)    || {};
+    const contract   = readJSON(CONTRACT_FILE) || {};
+    const theme      = readJSON(THEME_FILE);
+    const allEntries = getAllEntries();
+    const sessionStart = findSessionStart(allEntries, sinceArg, allFlag);
+    const sessions   = allEntries.filter(e => new Date(e.ts || 0) > sessionStart);
+    console.log(JSON.stringify({ state, contract: { policyId: contract.policyId, policyVersion: contract.policyVersion, capabilities: contract.capabilities }, theme, sessions, sessionStart: sessionStart.toISOString(), generatedAt: new Date().toISOString() }, null, 2));
+    return;
+  }
+
+  // Write HANDOFF.md
+  fs.writeFileSync(HANDOFF_FILE, handoff, "utf8");
+  console.log(green("  ✔ Written → inferno/HANDOFF.md\n"));
+
+  // Also log the handoff itself to sessions.jsonl
+  if (fs.existsSync(SESSIONS_FILE)) {
+    const entry = {
+      ts:      new Date().toISOString(),
+      agent:   "infernoflow",
+      type:    "handoff",
+      summary: toAgent ? `Handed off to ${toAgent}` : "Handoff generated",
+    };
+    fs.appendFileSync(SESSIONS_FILE, JSON.stringify(entry) + "\n", "utf8");
+  }
+
+  // Print preview
+  const allEntriesForCount = getAllEntries();
+  const sessionStartForCount = findSessionStart(allEntriesForCount, sinceArg, allFlag);
+  const sessionEntries = allEntriesForCount.filter(e => new Date(e.ts || 0) > sessionStartForCount);
+  const state    = readJSON(STATE_FILE) || {};
+  const theme    = readJSON(THEME_FILE);
+  const contract = readJSON(CONTRACT_FILE) || {};
+
+  console.log("  " + bold("Handoff summary"));
+  console.log("  " + "─".repeat(50));
+  if (state.working) console.log("  Working on    " + cyan(state.working));
+  if (state.intent)  console.log("  Intent        " + cyan(state.intent));
+  console.log("  Session       " + sessionEntries.length + " entries (total: " + allEntriesForCount.length + ")");
+  console.log("  Capabilities  " + (contract.capabilities || []).length + " registered");
+  if (theme?.fonts?.primary) console.log("  Font          " + theme.fonts.primary);
+  if (theme?.colors?.mode)   console.log("  Color mode    " + theme.colors.mode);
+  if (toAgent) console.log("  Handing off → " + cyan(toAgent));
+  console.log();
+
+  if (copyFlag) {
+    const ok = copyToClipboard(handoff);
+    console.log(ok
+      ? green("  ✔ Copied to clipboard — paste at the start of your next AI session")
+      : yellow("  ⚠ Clipboard failed — open inferno/HANDOFF.md manually")
+    );
+  } else {
+    console.log("  " + bold("Ready to use:"));
+    console.log("  " + cyan("1.") + " Open    " + cyan("inferno/HANDOFF.md"));
+    console.log("  " + cyan("2.") + " Copy all");
+    console.log("  " + cyan("3.") + " Paste at the start of your next AI session");
+    console.log("  " + gray("  tip: use --copy to skip steps 1-2 automatically"));
+  }
+  console.log();
+}

package/dist/lib/commands/syncAuto.mjs

@@ -1 +1,96 @@
-import{execFileSync as w}from"node:child_process";import*as y from"node:path";import{fileURLToPath as P}from"node:url";import{header as h,section as d,ok as e,warn as f,yellow as g,gray as p}from"../ui/output.mjs";const S=P(import.meta.url),C=y.dirname(S),N=y.resolve(C,"..","..","bin","infernoflow.mjs");function D(o){const n=w(process.execPath,[N,...o],{encoding:"utf8",stdio:["ignore","pipe","pipe"]});return JSON.parse(n)}function _(o){try{return{ok:!0,data:D(o)}}catch(n){const s=n?.stdout?.toString?.()||"";try{return{ok:!1,data:JSON.parse(s)}}catch{return{ok:!1,data:{ok:!1,errors:["command_failed"]}}}}}async function E(o=[]){const n=o.includes("--auto"),s=o.includes("--json"),u=o.includes("--dry-run");n||(s&&(console.log(JSON.stringify({ok:!1,error:"missing_required_flag",hint:"Use: infernoflow sync --auto"},null,2)),process.exit(1)),h("sync"),f("missing --auto flag"),console.log(`  ${g("\u2192")} infernoflow sync --auto`),console.log(),process.exit(1));const c=_(["pr-impact","--json"]),i=!c.data?.ok,a=c.data?.confidence||"low",r=a==="high"?"auto":a==="medium"?"ask":"block",k=i?["Generate inferno update proposal (suggest)","Review changes","Validate with check --json"]:["No inferno drift detected","Validate with check --json"],t=_(["check","--json"]),l={ok:c.ok&&t.ok&&!!t.data?.ok,mode:"auto-skeleton",dryRun:u,needsSync:i,didApply:!1,confidence:a,policyDecision:r,actions:k,prImpact:c.data,postCheck:t.data,reasonCodes:[...i?["DRIFT_DETECTED"]:["NO_DRIFT"],`POLICY_${r.toUpperCase()}`,...r==="auto"?["AUTO_APPLY_DISABLED_IN_SKELETON"]:[]]};s&&(console.log(JSON.stringify(l,null,2)),process.exit(l.ok?0:1)),h("sync --auto"),d("State"),i?f("Inferno drift detected"):e("No inferno drift detected"),e(`Confidence: ${p(a)}`),e(`Policy decision: ${p(r)}`),e(`Apply mode: ${p("skeleton (no file writes)")}`),u&&e("Dry run enabled"),d("Plan"),k.forEach(m=>console.log(`  ${g("\u2192")} ${m}`)),d("Validation"),t.ok&&t.data?.ok?e("Post-check passed"):f("Post-check failed; see infernoflow check --json"),console.log(),process.exit(l.ok?0:1)}export{E as syncCommand};
+import { execFileSync } from "node:child_process";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { header, section, ok, warn, yellow, gray } from "../ui/output.mjs";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const binPath = path.resolve(__dirname, "..", "..", "bin", "infernoflow.mjs");
+
+function runCliJson(args) {
+  const out = execFileSync(process.execPath, [binPath, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+  return JSON.parse(out);
+}
+
+function tryRunCliJson(args) {
+  try {
+    return { ok: true, data: runCliJson(args) };
+  } catch (err) {
+    const stdout = err?.stdout?.toString?.() || "";
+    try {
+      return { ok: false, data: JSON.parse(stdout) };
+    } catch {
+      return { ok: false, data: { ok: false, errors: ["command_failed"] } };
+    }
+  }
+}
+
+export async function syncCommand(args = []) {
+  const auto = args.includes("--auto");
+  const asJson = args.includes("--json");
+  const dryRun = args.includes("--dry-run");
+
+  if (!auto) {
+    const payload = { ok: false, error: "missing_required_flag", hint: "Use: infernoflow sync --auto" };
+    if (asJson) {
+      console.log(JSON.stringify(payload, null, 2));
+      process.exit(1);
+    }
+    header("sync");
+    warn("missing --auto flag");
+    console.log(`  ${yellow("→")} infernoflow sync --auto`);
+    console.log();
+    process.exit(1);
+  }
+
+  const impact = tryRunCliJson(["pr-impact", "--json"]);
+  const needsSync = !impact.data?.ok;
+  const confidence = impact.data?.confidence || "low";
+  const policyDecision = confidence === "high" ? "auto" : confidence === "medium" ? "ask" : "block";
+  const actions = needsSync
+    ? ["Generate inferno update proposal (suggest)", "Review changes", "Validate with check --json"]
+    : ["No inferno drift detected", "Validate with check --json"];
+
+  const check = tryRunCliJson(["check", "--json"]);
+  const payload = {
+    ok: impact.ok && check.ok && !!check.data?.ok,
+    mode: "auto-skeleton",
+    dryRun,
+    needsSync,
+    didApply: false,
+    confidence,
+    policyDecision,
+    actions,
+    prImpact: impact.data,
+    postCheck: check.data,
+    reasonCodes: [
+      ...(needsSync ? ["DRIFT_DETECTED"] : ["NO_DRIFT"]),
+      `POLICY_${policyDecision.toUpperCase()}`,
+      ...(policyDecision === "auto" ? ["AUTO_APPLY_DISABLED_IN_SKELETON"] : []),
+    ],
+  };
+
+  if (asJson) {
+    console.log(JSON.stringify(payload, null, 2));
+    process.exit(payload.ok ? 0 : 1);
+  }
+
+  header("sync --auto");
+  section("State");
+  if (needsSync) warn("Inferno drift detected");
+  else ok("No inferno drift detected");
+  ok(`Confidence: ${gray(confidence)}`);
+  ok(`Policy decision: ${gray(policyDecision)}`);
+  ok(`Apply mode: ${gray("skeleton (no file writes)")}`);
+  if (dryRun) ok("Dry run enabled");
+
+  section("Plan");
+  actions.forEach((a) => console.log(`  ${yellow("→")} ${a}`));
+
+  section("Validation");
+  if (check.ok && check.data?.ok) ok("Post-check passed");
+  else warn("Post-check failed; see infernoflow check --json");
+  console.log();
+  process.exit(payload.ok ? 0 : 1);
+}
+