@misterhuydo/cairn-mcp 1.14.0 → 1.15.0

package/README.md

@@ -166,8 +166,15 @@ cairn_roadmap { action: "focus", id: 3 }          → make phase 3 the current f
 cairn_roadmap { action: "set_status", id: 3, status: "done" }  → ship it
 cairn_roadmap { action: "add", parent: 3, text: "..." }        → ad-hoc sub-task under a phase
 cairn_roadmap { action: "deps_add", from: 2, to: 4 }           → phase 2 blocks phase 4
+cairn_roadmap { action: "publish" }              → (re)write the human-readable ROADMAP.md at the repo root
 ```
 
+Every `cairn_roadmap` call also projects the live plan into a legible **`ROADMAP.md`
+at the repo root** — a human-readable view with checkboxes, per-item status, and a
+`← current` marker on the cursor phase. It is deterministic (no timestamps, stable
+ordering, so an unchanged plan re-writes byte-identically and leaves clean git diffs),
+never written as an empty placeholder, and never clobbers a hand-authored `ROADMAP.md`.
+
 Editing `roadmap.md` *is* editing the plan — read actions re-seed from it, and the
 end-of-turn hook folds in any hand-edits. Marking a phase **done** prunes it from
 `roadmap.md` and appends it to the append-only `.cairn/roadmap_completed.md`, so the

package/bin/cairn-mcp.js

@@ -1,10 +1,14 @@
 #!/usr/bin/env node
 import { spawn } from 'child_process';
+import { existsSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const indexPath  = join(__dirname, '..', 'index.js');
+// Prefer readable source when present (local dev = always live); the published
+// package ships only dist/, so there we fall back to the bundled build.
+const srcPath  = join(__dirname, '..', 'index.js');
+const indexPath = existsSync(srcPath) ? srcPath : join(__dirname, '..', 'dist', 'index.js');
 
 const child = spawn(
   process.execPath,

package/bin/cairn.js

@@ -1,10 +1,14 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 import { spawn } from 'child_process';
+import { existsSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const cliPath = join(__dirname, 'cairn-cli.js');
+// Prefer readable source when present (local dev = always live); the published
+// package ships only dist/, so there we fall back to the bundled build.
+const srcCli = join(__dirname, 'cairn-cli.js');
+const cliPath = existsSync(srcCli) ? srcCli : join(__dirname, '..', 'dist', 'cairn-cli.js');
 
 const child = spawn(
   process.execPath,

package/dist/cairn-cli.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import h from"fs";import B from"os";import y from"path";import{execSync as ue}from"child_process";import Ft from"fast-glob";var ye={".java":"java",".ts":"typescript",".tsx":"typescript",".js":"javascript",".jsx":"javascript",".mjs":"javascript",".vue":"vue",".py":"python",".sql":"sql",".yml":"config",".yaml":"config",".properties":"config",".env":"config",".xml":"xml",".html":"html",".md":"markdown"};function V(e,t,s={}){let{noComments:n=!0,noEmptyLines:o=!0,aggressive:a=!1}=s,i=e;return n&&(i=Ue(i,t)),o&&(i=He(i)),i=Je(i),a&&(i=Be(i)),i.trim()}function Ue(e,t){switch(t){case"java":case"typescript":case"javascript":case"vue":return e.replace(/\/\*[\s\S]*?\*\//g,"").replace(/(["'`])(?:(?!\1)[^\\]|\\.)*\1|\/(?![/*])(?:[^/\\\n]|\\.)*\/[gimsuy]*|\/\/[^\n]*/g,(s,n)=>n||!s.startsWith("//")?s:"");case"python":return e.replace(/#.*$/gm,"").replace(/'''[\s\S]*?'''/g,"").replace(/"""[\s\S]*?"""/g,"");case"sql":return e.replace(/--.*$/gm,"").replace(/\/\*[\s\S]*?\*\//g,"");case"xml":case"html":return e.replace(/<!--[\s\S]*?-->/g,"");case"config":return e.replace(/#.*$/gm,"");default:return e}}function He(e){return e.split(`
+`).filter(t=>t.trim().length>0).join(`
+`)}function Je(e){return e.split(`
+`).map(t=>t.trimEnd()).join(`
+`)}function Be(e){return e.replace(/\s+/g," ").replace(/\s*([=+\-*/%<>!&|^~?:;,{}()[\]])\s*/g,"$1").replace(/;\s*}/g,"}").replace(/\(\s+/g,"(").replace(/\s+\)/g,")").trim()}function ge(e,t={}){let{noStyle:s=!1,noComments:n=!0,noEmptyLines:o=!0,aggressive:a=!1}=t,i=[],l=e.match(/<template>([\s\S]*?)<\/template>/i);if(l){let c=l[1];n&&(c=c.replace(/<!--[\s\S]*?-->/g,"")),o&&(c=c.split(`
+`).filter(m=>m.trim()).join(`
+`)),c=c.replace(/\s+/g," ").trim(),c&&i.push(`<template>${c}</template>`)}let f=e.match(/<script([^>]*)>([\s\S]*?)<\/script>/i);if(f){let c=f[1],m=V(f[2],"javascript",{noComments:n,noEmptyLines:o,aggressive:a}),u=/setup/i.test(c)?"<script setup>":"<script>";m&&i.push(`${u}${m}</script>`)}if(!s){let c=e.match(/<style([^>]*)>([\s\S]*?)<\/style>/i);if(c){let m=c[2].replace(/\/\*[\s\S]*?\*\//g,"").replace(/\s+/g," ").trim();m&&i.push(`<style${c[1]}>${m}</style>`)}}return i.join(`
+
+`)}import L from"fs";import W from"path";import z from"fs";import Ye from"os";import Y from"path";var Ge=null;function K(){return Ge||process.cwd()}function I(){let e=Y.join(K(),".cairn");z.mkdirSync(Y.join(e,"bundles"),{recursive:!0});let t=Y.join(e,".cairn-project");return z.existsSync(t)||z.writeFileSync(t,"","utf8"),e}function ne(e){return e.replace(/[:/\\]/g,"-").replace(/^-+/,"")}function _e(){let e=Y.join(Ye.homedir(),".claude","projects",ne(K()));return z.existsSync(e)?Y.join(e,"memory"):null}var qe=1e3,Ve=100*1024;function ze(e,t,s,n){if(e&&typeof e=="object"&&e.ref)return e;let o=typeof e=="string"?e:String(e),a=/^\[\d{4}-\d{2}-\d{2}\]/.test(o)?o:`[${s}] ${o}`;if(a.length<=qe)return a;let i=W.join(t,"notes");L.mkdirSync(i,{recursive:!0});let f=`note-${new Date().toISOString().replace(/[:.]/g,"-")}-${n}.md`,c=W.join(i,f);return L.writeFileSync(c,a,"utf8"),{description:a.split(`
+`)[0].slice(0,120),ref:W.join(".cairn","notes",f)}}function se(e,{message:t,active_files:s=[],notes:n=[]}){if(typeof n=="string")try{n=JSON.parse(n)}catch{n=n?[n]:[]}Array.isArray(n)||(n=[]);let o=I(),a=W.join(o,"session.json"),i=new Date().toISOString().slice(0,10),l={};try{let m=e.prepare("SELECT path FROM main.files").all();for(let{path:u}of m)try{l[u]=L.statSync(u).mtimeMs}catch{}}catch{}for(let m of s)try{l[m]=L.statSync(m).mtimeMs}catch{}let f=n.map((m,u)=>ze(m,o,i,u));if(L.existsSync(a))try{if(L.statSync(a).size>Ve){let u=1;for(;L.existsSync(W.join(o,`session.${u}.json`));)u++;L.renameSync(a,W.join(o,`session.${u}.json`))}}catch{}let c={message:t,checkpoint_at:new Date().toISOString(),active_files:s,notes:f,mtime_snapshot:l};return L.writeFileSync(a,JSON.stringify(c,null,2),"utf8"),{content:[{type:"text",text:JSON.stringify({saved:!0,checkpoint_at:c.checkpoint_at,active_files_tracked:s.length,notes_saved:f.length},null,2)}]}}import F from"fs";import O from"path";import Ke from"crypto";var Se=80;function oe(e){let t=O.dirname(O.resolve(e)),s=O.parse(t).root;for(;;){let n=O.join(t,".cairn");try{if(F.statSync(n).isDirectory()&&F.existsSync(O.join(n,".cairn-project"))&&n.split(O.sep).filter(a=>a===".cairn").length===1)return n}catch{}if(t===s)return null;t=O.dirname(t)}}function xe(e,t){let s=Ke.createHash("sha256").update(O.resolve(t)).digest("hex").slice(0,6);return O.join(e,"views",`${s}_${O.basename(t)}`)}function C(e){try{return JSON.parse(F.readFileSync(O.join(e,"minify-map.json"),"utf8"))}catch{return{}}}function T(e,t){F.mkdirSync(e,{recursive:!0}),F.writeFileSync(O.join(e,"minify-map.json"),JSON.stringify(t,null,2),"utf8")}function X(e,t){let s=0;for(let[n,o]of Object.entries(t)){let a=!1;if(!F.existsSync(n))a=!0;else if(!F.existsSync(o.tempPath))a=!0;else try{F.statSync(n).mtimeMs>o.minifiedAt&&(a=!0)}catch{a=!0}if(a){if(o.tempPath)try{F.unlinkSync(o.tempPath)}catch{}delete t[n],s++}}return s}function we(e,t){switch(t){case"javascript":case"typescript":return re(e);case"java":return re(e,{annotations:!0});case"python":return et(e);case"vue":return tt(e);case"sql":return nt(e);default:return e.split(`
+`).slice(0,30).join(`
+`)+`
+...`}}function re(e,{annotations:t=!1}={}){let s=e.split(`
+`),n=[],o=0;for(let a=0;a<s.length;a++){let i=s[a].trim();if(!i)continue;let{opens:l,closes:f}=Ze(i),c=l-f;if(o===0){let m=Xe(i);m!==null?n.push(`${a+1}: ${m}`):i==="}"&&n.push("}")}else if(o===1){let m=Qe(i,t);m!==null&&n.push(`  ${a+1}: ${m}`)}o=Math.max(0,o+c)}return n.join(`
+`)}function Xe(e){return/^import\s/.test(e)||/^@\w+/.test(e)||/^package\s/.test(e)?e:/^export\s/.test(e)?/^export\s+(default\s+)?(async\s+)?function[\s*]|^export\s+(default\s+)?(abstract\s+)?class\s/.test(e)?M(e):e:/^(async\s+)?function[\s*]/.test(e)||/^(abstract\s+)?class\s/.test(e)||/^(public\s+|private\s+|protected\s+)?(interface|enum|type|record)\s/.test(e)||/^(const|let|var)\s+\w+/.test(e)||/^(public|private|protected|abstract|final)\s+(class|interface|enum)\s/.test(e)?M(e):e==="}"?"}":null}function Qe(e,t){return t&&/^@\w+/.test(e)?e:e==="}"?"}":/^(public|private|protected|static|final|abstract|async|override|readonly|synchronized|native)\s/.test(e)||/^constructor\s*\(/.test(e)||/^(get|set)\s+\w+\s*\(/.test(e)||/^\w[\w$]*\s*[<(]/.test(e)&&!e.startsWith("return")&&!e.startsWith("throw")&&!e.startsWith("if")&&!e.startsWith("for")&&!e.startsWith("while")&&!e.startsWith("switch")&&!e.startsWith("const")&&!e.startsWith("let")&&!e.startsWith("var")?M(e):null}function M(e){let t=0,s=!1,n="";for(let o=0;o<e.length;o++){let a=e[o];if(s)a===n&&e[o-1]!=="\\"&&(s=!1);else if(a==='"'||a==="'"||a==="`")s=!0,n=a;else if(a==="{"){if(t===0)return e.slice(0,o).trimEnd();t++}else a==="}"&&t--}return e}function Ze(e){let t=0,s=0,n=!1,o="";for(let a=0;a<e.length;a++){let i=e[a];n?i===o&&e[a-1]!=="\\"&&(n=!1):i==='"'||i==="'"||i==="`"?(n=!0,o=i):i==="{"?t++:i==="}"&&s++}return{opens:t,closes:s}}function et(e){let t=[],s=e.split(`
+`);for(let n=0;n<s.length;n++){let o=s[n];if(!o.trim())continue;let a=o.trimStart();a.startsWith("import ")||a.startsWith("from ")?t.push(o):(a.startsWith("class ")||a.startsWith("def ")||a.startsWith("async def "))&&t.push(`${n+1}: ${o.trim().replace(/:(\s*)$/,":")}`)}return t.join(`
+`)}function tt(e){let t=[];for(let n of e.matchAll(/<(template|script|style)(\s[^>]*)?\s*>/g))t.push(n[0]);let s=e.match(/<script(?:\s[^>]*)?\s*>([\s\S]*?)<\/script>/);if(s){let n=re(s[1]);n.trim()&&(t.push("// script:"),t.push(n))}return t.join(`
+`)}function nt(e){let t=[],s=e.split(`
+`);for(let n=0;n<s.length;n++){let o=s[n].trim();/^(CREATE|ALTER|DROP|INSERT|UPDATE|DELETE|SELECT|WITH|GRANT|REVOKE|BEGIN|COMMIT)\b/i.test(o)&&t.push(`${n+1}: ${o.slice(0,120)}${o.length>120?"...":""}`)}return t.join(`
+`)}import k from"fs";import U from"path";function G(e){if(!e||typeof e!="string")return[];let t=e.split(/\r?\n/),s=!1,n=null,o=[],a=new Set;for(let i of t){if(/^##\s+Phases\s*$/i.test(i)){s=!0;continue}if(/^##\s+/.test(i)&&!/^###/.test(i)){n&&(o.push(n),n=null),s=!1;continue}if(!s)continue;let l=/^###\s+Phase\s+(\d+)\s*:\s*(.+?)\s*$/.exec(i);if(l){n&&o.push(n);let f=parseInt(l[1],10),c=l[2];if(a.has(f)){process.stderr.write(`[cairn] memo phase parser: duplicate Phase ${f} ignored
+`),n=null;continue}a.add(f),n={phase_number:f,text:c,bodyLines:[]};continue}n&&n.bodyLines.push(i)}return n&&o.push(n),o.map(i=>({phase_number:i.phase_number,text:i.text,body:i.bodyLines.join(`
+`).trim()||null}))}function Ee(e,t,s){let n=e.prepare("SELECT id, phase_number, status FROM main.roadmap_phases WHERE decision_name = ? ORDER BY phase_number").all(t),o=new Map(n.map(r=>[r.phase_number,r])),a=new Set,i=e.prepare("UPDATE main.roadmap_phases SET text = ?, body = ?, status = CASE WHEN status = ? THEN ? ELSE status END WHERE id = ?"),l=e.prepare("INSERT INTO main.roadmap_phases (decision_name, phase_number, parent_phase_id, text, body, status, position) VALUES (?, ?, NULL, ?, ?, ?, ?)"),f=e.prepare("UPDATE main.roadmap_phases SET status = 'stale' WHERE id = ?"),c=[],m=[],u=[];for(let r=0;r<s.length;r++){let p=s[r];a.add(p.phase_number);let d=o.get(p.phase_number);if(d)i.run(p.text,p.body,"stale","open",d.id),c.push({id:d.id,phase_number:p.phase_number,text:p.text,reactivated:d.status==="stale"});else{let g=l.run(t,p.phase_number,p.text,p.body,"open",r);m.push({id:Number(g.lastInsertRowid),phase_number:p.phase_number,text:p.text})}}for(let[r,p]of o)!a.has(r)&&p.status!=="stale"&&p.status!=="done"&&(f.run(p.id),u.push({id:p.id,phase_number:r}));return{updated:c.length,inserted:m.length,staled:u.length,updated_phases:c,inserted_phases:m,staled_phases:u}}var P="roadmap",st=`# Roadmap
+
+The forward-looking plan: only upcoming and in-progress phases live here. When a
+phase is marked done (cairn_roadmap set_status <id> done) it is removed from this
+file and recorded in roadmap_completed.md. Edit the \`## Phases\` list to change
+the plan \u2014 Cairn syncs it into the live tracker on the next cairn_roadmap read.
+
+## Phases
+
+### Phase 1: First phase title
+What this phase delivers.
+`;function D(){return U.join(I(),"roadmap.md")}function ot(){return U.join(I(),"roadmap_completed.md")}function Q(){let e=D();return k.existsSync(e)?k.readFileSync(e,"utf8"):""}function ae(){let e=D();return k.existsSync(e)?!1:(k.writeFileSync(e,st,"utf8"),!0)}function rt(e){let t=[];for(let s of e){let n=(s.text||"").trim();n&&(!Number.isInteger(s.phase_number)||s.phase_number<1||t.push({phase_number:s.phase_number,text:n,body:s.body??null}))}return t}var ie="decision_production_roadmap.md";function it(e){let t=e.match(/^---\n[\s\S]*?\n---\n?/);return t?e.slice(t[0].length):e}function at(e,t){let s=U.join(e,"MEMORY.md");if(!k.existsSync(s))return;let n=k.readFileSync(s,"utf8").split(/\r?\n/).filter(o=>!o.includes(`](${t})`));k.writeFileSync(s,n.join(`
+`),"utf8")}function ct(){let e=D();if(k.existsSync(e))return null;let t=[],s=_e();s&&t.push(s),t.push(U.join(I(),"memory"));let n=null,o=null;for(let i of t){let l=U.join(i,ie);n==null&&k.existsSync(l)&&(n=it(k.readFileSync(l,"utf8")).trim(),o=l)}if(n==null)return null;let a=/^#\s/m.test(n)?"":`# Roadmap
+
+`;k.writeFileSync(e,a+n+`
+`,"utf8");for(let i of t){let l=U.join(i,ie);try{k.existsSync(l)&&k.unlinkSync(l)}catch{}try{at(i,ie)}catch{}}return{migrated:!0,from:o,to:e}}function H(e){ct();let t=D();if(!k.existsSync(t))return null;let s=k.readFileSync(t,"utf8");if(!/^##\s+Phases\s*$/im.test(s))return null;let n=rt(G(s));return Ee(e,P,n)}function ce(){let e=ot();return k.existsSync(e)?k.readFileSync(e,"utf8").split(/\r?\n/).filter(t=>/^-\s+\d{4}-\d{2}-\d{2}\s+—\s+Phase\s/.test(t)).length:0}import J from"fs";import pe from"path";import{execSync as pt}from"child_process";var be=120;function de(e){if(!e)return"";let t=String(e).replace(/`([^`]*)`/g,"$1").replace(/\*\*([^*]+)\*\*/g,"$1").replace(/\*([^*]+)\*/g,"$1").replace(/\[([^\]]+)\]\([^)]*\)/g,"$1").replace(/^[-*+\s]+/,"").replace(/^#{1,6}\s*/,"").replace(/[*~]/g,"").replace(/\s+/g," ").trim().replace(/[:：.\s]+$/,"");return t.length>be&&(t=t.slice(0,be-1).trimEnd()+"\u2026"),t}function N(e){return String(e||"").toLowerCase().replace(/[^a-z0-9]+/g," ").trim()}function lt(e){if(!e||typeof e!="string")return[];let t=e.split(/\r?\n/),s=c=>c.map(m=>({text:de(m.titleRaw),body:m.bodyLines.join(`
+`).trim()||null})).filter(m=>m.text),n=[],o=null;for(let c of t){let m=/^(#{1,6})\s+(.+?)\s*$/.exec(c);if(m&&m[1].length>=2&&m[1].length<=4){o&&n.push(o),o={titleRaw:m[2],bodyLines:[]};continue}o&&o.bodyLines.push(c)}o&&n.push(o);let a=[];o=null;for(let c of t){let m=/^(\d+)[.)]\s+(.+?)\s*$/.exec(c);if(m){o&&a.push(o),o={titleRaw:m[2],bodyLines:[]};continue}o&&o.bodyLines.push(c)}o&&a.push(o);let i=[s(n),s(a)].filter(c=>c.length>=2);if(i.length)return i.sort((c,m)=>m.length-c.length),i[0];let l=t.find(c=>c.trim());return[{text:de(l||"Plan")||"Plan",body:e.trim()||null}]}function dt(e){let t=[];return e.forEach((s,n)=>{t.push(`### Phase ${n+1}: ${s.text}`),s.body&&s.body.trim()&&t.push(s.body.trim()),t.push("")}),t.join(`
+`).replace(/\n{3,}/g,`
+
+`).trimEnd()+`
+`}function ke(e){let t=Q(),s=t.split(/\r?\n/),n=s.findIndex(c=>/^##\s+Phases\s*$/i.test(c)),o=dt(e);if(n===-1){let c=t.replace(/\s*$/,"");J.writeFileSync(D(),`${c}
+
+## Phases
+
+${o}`,"utf8");return}let a=s.length;for(let c=n+1;c<s.length;c++)if(/^##\s+/.test(s[c])&&!/^###/.test(s[c])){a=c;break}let i=s.slice(0,n+1).join(`
+`),l=s.slice(a).join(`
+`).replace(/^\n+/,""),f=`
+
+${o}${l.trim()?`
+`+l:""}`;J.writeFileSync(D(),i+f,"utf8")}function $e(e){let t=lt(e);if(t.length===0)return{added:[],skipped:[],total:0};let n=ae()?[]:G(Q()).map(f=>({text:f.text,body:f.body})),o=new Set(n.map(f=>N(f.text))),a=[...n],i=[],l=[];for(let f of t){let c=N(f.text);if(o.has(c)){l.push(f.text);continue}o.add(c),a.push(f),i.push(f.text)}return i.length>0&&ke(a),{added:i,skipped:l,total:a.length}}function ut(e){return e==="completed"?"done":e==="in_progress"?"in_progress":"open"}function mt(e){try{return e.prepare("SELECT phase_id FROM main.roadmap_cursor WHERE singleton = 1").get()?.phase_id??null}catch{return null}}function Re(e,t){if(!Array.isArray(t)||t.length===0)return{changed:!1};let s=t.map(r=>({text:de(r.content||r.activeForm||""),status:ut(r.status)})).filter(r=>r.text);if(s.length===0)return{changed:!1};let n=e.prepare("SELECT id, status FROM main.roadmap_phases WHERE decision_name = ? AND parent_phase_id IS NULL").all(P).filter(r=>r.status!=="stale");if(n.length===0){let p=ae()?[]:G(Q()).map(x=>({text:x.text,body:x.body})),d=new Set(p.map(x=>N(x.text))),g=[...p],S=0;for(let x of s){let $=N(x.text);d.has($)||(d.add($),g.push({text:x.text,body:null}),S++)}if(S===0)return{changed:!1};ke(g);let _=H(e);return{changed:!0,seeded:S,diff:_}}let o=mt(e);o==null&&(o=n.find(r=>r.status==="in_progress")?.id??n.find(r=>r.status==="open")?.id??n[0].id);let a=e.prepare("SELECT id, text, status FROM main.roadmap_phases WHERE parent_phase_id = ?").all(o),i=new Map(a.map(r=>[N(r.text),r])),l=e.prepare("INSERT INTO main.roadmap_phases (decision_name, phase_number, parent_phase_id, text, status, position) VALUES (NULL, NULL, ?, ?, ?, ?)"),f=e.prepare("UPDATE main.roadmap_phases SET status = ? WHERE id = ?"),c=e.prepare("SELECT COALESCE(MAX(position), -1) + 1 AS n FROM main.roadmap_phases WHERE parent_phase_id = ?").get(o).n,m=0,u=0;for(let r of s){let p=i.get(N(r.text));if(p){if(p.status==="done"&&r.status!=="done")continue;p.status!==r.status&&(f.run(r.status,p.id),u++)}else l.run(o,r.text,r.status,c++),m++}return{changed:m>0||u>0,parentId:o,inserted:m,updated:u}}var ft=new Set(["the","and","for","with","from","into","that","this","then","your","add","fix","update","make","phase","support","implement","feature","refactor","wire","wires","should","will","also","use","using","via"]);function ht(e){return[...new Set(N(e).split(" ").filter(t=>t.length>=4&&!ft.has(t)))]}function yt(e,t){if(!e||!t?.length)return null;let s=String(e),n=/\bphase\s*#?\s*(\d+)\b/i.exec(s);if(n){let i=parseInt(n[1],10),l=t.find(f=>f.phase_number===i);if(l)return{...l,confidence:"high"}}let o=new Set(N(s).split(" ").filter(Boolean)),a=null;for(let i of t){let l=ht(i.text);if(l.length<2)continue;let f=l.filter(m=>o.has(m)),c=f.length/l.length;f.length>=2&&c>=.6&&(!a||c>a.ratio)&&(a={...i,confidence:"medium",ratio:c})}return a?(delete a.ratio,a):null}function le(e,t){return pt(`git ${t}`,{cwd:e,encoding:"utf8",timeout:5e3}).trim()}function ve(e,t){let s=pe.join(t,".cairn"),n=pe.join(s,".last-commit"),o=pe.join(s,"roadmap-pending.json"),a;try{a=le(t,"rev-parse HEAD")}catch{return{candidates:[],newCommits:0}}let i=null;try{i=J.readFileSync(n,"utf8").trim()||null}catch{}let l=[];if(i&&i!==a)try{l=le(t,`rev-list --no-merges --reverse ${i}..HEAD`).split(`
+`).filter(Boolean)}catch{l=[]}try{J.writeFileSync(n,a,"utf8")}catch{}let f=[];try{let c=JSON.parse(J.readFileSync(o,"utf8"));Array.isArray(c)&&(f=c)}catch{}if(l.length){let c=e.prepare("SELECT id, phase_number, text FROM main.roadmap_phases WHERE decision_name = ? AND parent_phase_id IS NULL AND status IN ('open','in_progress') AND phase_number IS NOT NULL").all(P);for(let m of l){let u="";try{u=le(t,`show -s --format=%s%n%b ${m}`)}catch{}let r=yt(u,c);r&&!f.some(p=>p.phase_id===r.id)&&f.push({phase_id:r.id,phase_number:r.phase_number,text:r.text,commit:m.slice(0,7),confidence:r.confidence})}}if(f.length){let c=new Set(e.prepare("SELECT id FROM main.roadmap_phases WHERE status IN ('open','in_progress')").all().map(m=>m.id));f=f.filter(m=>c.has(m.phase_id))}try{J.writeFileSync(o,JSON.stringify(f),"utf8")}catch{}return{candidates:f,newCommits:l.length}}import Z from"fs";import gt from"path";var Pe="<!-- cairn:roadmap -->",_t={open:"open",in_progress:"in progress",done:"done",blocked:"blocked",stale:"stale"};function St(e){return e==="done"?"x":e==="in_progress"?"~":e==="blocked"?"!":" "}function xt(){return gt.join(K(),"ROADMAP.md")}function wt(e){try{return e.prepare("SELECT phase_id FROM main.roadmap_cursor WHERE singleton = 1").get()?.phase_id??null}catch{return null}}function Et(e){let t=new Map,s;try{s=e.prepare("SELECT blocker_id, blocked_id FROM main.roadmap_phase_deps").all()}catch{return t}for(let n of s)t.has(n.blocked_id)||t.set(n.blocked_id,new Set),t.get(n.blocked_id).add(n.blocker_id);return t}function bt(e,t){let s=e.decision_name??"",n=t.decision_name??"";return s!==n?s<n?-1:1:e.phase_number!=null&&t.phase_number!=null?e.phase_number-t.phase_number:e.position-t.position||e.id-t.id}function kt(e){let t;try{t=e.prepare("SELECT id, decision_name, phase_number, parent_phase_id, text, body, status, position FROM main.roadmap_phases ORDER BY decision_name, phase_number, position, id").all()}catch{return null}if(t.filter(d=>d.status!=="stale").length===0)return null;let s=wt(e),n=Et(e),o=new Map(t.map(d=>[d.id,d.status])),a=new Map(t.map(d=>[d.id,d.phase_number!=null?`Phase ${d.phase_number}`:d.text])),i=d=>{let g=n.get(d);return g?[...g].filter(S=>o.get(S)!=="done").map(S=>a.get(S)||`#${S}`):[]},l=new Map;for(let d of t){let g=d.parent_phase_id??"root";l.has(g)||l.set(g,[]),l.get(g).push(d)}for(let d of l.values())d.sort(bt);let f=new Map;for(let d of l.get("root")||[])d.decision_name!=null&&(f.has(d.decision_name)||f.set(d.decision_name,[]),f.get(d.decision_name).push(d));let c=[...f.keys()].sort((d,g)=>d===P?-1:g===P?1:d<g?-1:d>g?1:0),m=[Pe,"<!--","  Generated by cairn \u2014 do NOT edit by hand.","  The plan lives in .cairn/roadmap.md; status and cursor come from cairn_roadmap.","  This file is regenerated whenever the roadmap changes; manual edits are overwritten.","-->","","# Roadmap","","Legend: `[x]` done \xB7 `[~]` in progress \xB7 `[ ]` open \xB7 `[!]` blocked."],u=(d,g)=>{let S="  ".repeat(g),_=d.phase_number!=null?`Phase ${d.phase_number}: ${d.text}`:d.text,x=_t[d.status]||d.status,$=i(d.id);if($.length&&(x+=` \xB7 waiting on ${$.join(", ")}`),s===d.id&&(x+=" \xB7 \u2190 current"),m.push(`${S}- [${St(d.status)}] **${_}** \u2014 ${x}`),d.body){let R=d.body.split(`
+`).map(A=>A.trim()).find(Boolean);R&&m.push(`${S}  ${R}`)}for(let R of l.get(d.id)||[])R.status!=="stale"&&u(R,g+1)},r=!1;for(let d of c){let g=f.get(d).filter(_=>_.status!=="stale"),S=d===P?g.filter(_=>_.status!=="done"):g;if(S.length!==0){if(r=!0,m.push(""),d===P)m.push("## Active plan");else{let _=g.filter(x=>x.status==="done").length;m.push(`## ${d} \u2014 ${_}/${g.length} done`)}m.push("");for(let _ of S)u(_,0)}}if(!r)return null;let p=ce();return p>0&&m.push("","---","",`**Shipped:** ${p} phase${p===1?"":"s"} \u2014 see \`.cairn/roadmap_completed.md\`.`),m.join(`
+`)+`
+`}function je(e){let t=xt(),s=kt(e),n=null;if(Z.existsSync(t))try{n=Z.readFileSync(t,"utf8")}catch{n=null}if(n!=null&&!n.startsWith(Pe))return{written:!1,reason:"ROADMAP.md exists and is not cairn-generated \u2014 refusing to overwrite",path:t};if(s==null){if(n!=null)try{return Z.unlinkSync(t),{written:!1,removed:!0,path:t}}catch(o){return{written:!1,reason:`remove failed: ${o.message}`,path:t}}return{written:!1,reason:"empty roadmap \u2014 no file written",path:t}}return n===s?{written:!1,unchanged:!0,path:t,bytes:Buffer.byteLength(s)}:(Z.writeFileSync(t,s,"utf8"),{written:!0,path:t,bytes:Buffer.byteLength(s)})}function Oe(e){try{return je(e)}catch(t){return process.stderr.write(`[cairn] ROADMAP.md publish skipped: ${t.message}
+`),null}}var $t=new Set(["open","in_progress"]);function Rt(e,t){e.prepare("INSERT INTO main.roadmap_cursor (singleton, phase_id) VALUES (1, ?) ON CONFLICT(singleton) DO UPDATE SET phase_id = excluded.phase_id").run(t)}function vt(e,t){let s=e.prepare("SELECT parent_phase_id, status FROM main.roadmap_phases WHERE id = ?"),n=e.prepare("UPDATE main.roadmap_phases SET status = 'in_progress' WHERE id = ? AND status = 'open'"),o=s.get(t);for(;o&&o.parent_phase_id!=null;)n.run(o.parent_phase_id),o=s.get(o.parent_phase_id)}function Te(e,t){Rt(e,t),e.prepare("UPDATE main.roadmap_phases SET status = 'in_progress' WHERE id = ? AND status = 'open'").run(t),vt(e,t)}function Pt(e){let t=new Map,s;try{s=e.prepare("SELECT blocker_id, blocked_id FROM main.roadmap_phase_deps").all()}catch{return t}for(let n of s)t.has(n.blocked_id)||t.set(n.blocked_id,new Set),t.get(n.blocked_id).add(n.blocker_id);return t}function jt(e,t,s){let n=t.get(e);if(!n||n.size===0)return[];let o=[];for(let a of n)s.get(a)!=="done"&&o.push(a);return o}function Me(e,t){let s=e.prepare("SELECT id, decision_name, phase_number, parent_phase_id, status, position, text FROM main.roadmap_phases ORDER BY decision_name, phase_number, position, id").all();if(s.length===0)return{id:null,reason:"No phases \u2014 add a ## Phases section to .cairn/roadmap.md."};let n=new Map(s.map(u=>[u.id,u.status])),o=Pt(e),a=new Map;for(let u of s){let r=u.parent_phase_id??`root:${u.decision_name}`;a.has(r)||a.set(r,[]),a.get(r).push(u)}for(let u of a.values())u.sort((r,p)=>r.phase_number!=null&&p.phase_number!=null?r.phase_number-p.phase_number:r.position-p.position||r.id-p.id);let i=[],l=new Set;for(let u of s){if(u.parent_phase_id!=null||l.has(u.decision_name))continue;l.add(u.decision_name);let r=[],p=a.get(`root:${u.decision_name}`)||[];for(let d=p.length-1;d>=0;d--)r.push(p[d]);for(;r.length;){let d=r.pop();i.push(d);let g=a.get(d.id)||[];for(let S=g.length-1;S>=0;S--)r.push(g[S])}}let f=u=>$t.has(u.status),c=[],m=0;if(t!=null){let u=i.findIndex(r=>r.id===t);m=u===-1?0:u+1}for(let u=m;u<i.length;u++){let r=i[u];if(!f(r))continue;let p=jt(r.id,o,n);if(p.length>0){c.push({id:r.id,blockers:p});continue}let d=t!=null?s.find(_=>_.id===t):null,g=d&&d.decision_name!==r.decision_name,S;return t==null?S=`First actionable phase: ${r.decision_name??"(sub-task)"} / Phase ${r.phase_number??"\xB7"}.`:g?S=`Previous decision "${d.decision_name}" is complete \u2014 advanced to "${r.decision_name}".`:S=`Next open phase in "${r.decision_name??"(sub-task)"}" after id ${t}.`,c.length>0&&(S+=` Skipped ${c.length} dep-blocked phase(s): ${c.map(_=>`id ${_.id} (blocked by ${_.blockers.join(",")})`).join("; ")}.`),{id:r.id,reason:S,skipped_blocked:c}}return c.length>0?{id:null,reason:`All remaining open phases are blocked by unfinished dependencies: ${c.map(u=>`id ${u.id} (blocked by ${u.blockers.join(",")})`).join("; ")}.`,skipped_blocked:c}:{id:null,reason:"No actionable phases remaining."}}var Ot=new Set(["java","typescript","javascript","vue","python","sql"]);function Ne(e){let t=y.join(B.homedir(),".claude","projects",ne(e));return h.existsSync(t)?y.join(t,"memory"):null}function Ce(e){try{return h.readdirSync(e).filter(t=>t.endsWith(".md"))}catch{return[]}}function Tt(e){let t=Ne(e);if(!t||!h.existsSync(t))return 0;let s=y.join(e,".cairn","memory");h.mkdirSync(s,{recursive:!0});let n=0;for(let o of Ce(t)){let a=y.join(t,o),i;try{i=h.statSync(a)}catch{continue}if(!i.isFile())continue;let l=y.join(s,o),f=!h.existsSync(l);if(!f)try{f=i.mtimeMs>h.statSync(l).mtimeMs}catch{f=!0}if(f){h.copyFileSync(a,l);try{h.utimesSync(l,i.atime,i.mtime)}catch{}n++}}return n}function Mt(e){let t=Ne(e);if(!t||(h.mkdirSync(t,{recursive:!0}),Ce(t).some(o=>o!=="MEMORY.md")))return 0;let s=y.join(e,".cairn","memory");if(!h.existsSync(s))return 0;let n=0;for(let o of h.readdirSync(s)){let a=y.join(s,o),i;try{i=h.statSync(a)}catch{continue}if(i.isFile()){h.copyFileSync(a,y.join(t,o));try{h.utimesSync(y.join(t,o),i.atime,i.mtime)}catch{}n++}}return n}async function Le(e){let t={active:!1},s=y.join(e,"index.db");if(!h.existsSync(s))return t;let n;try{({DatabaseSync:n}=await import("node:sqlite"))}catch{return t}let o;try{o=new n(s,{readonly:!0})}catch{return t}let a=l=>l.toLowerCase().replace(/[^a-z0-9]+/g,"_").replace(/^_|_$/g,"");function i(l,f){if(!h.existsSync(l))return null;let c=h.readFileSync(l,"utf8"),m=!1,u=!1,r=[];for(let p of c.split(/\r?\n/)){if(/^##\s+Phases\s*$/i.test(p)){m=!0;continue}if(m&&/^##\s+/.test(p)&&!/^###/.test(p))break;if(!m)continue;let d=/^###\s+Phase\s+(\d+)\s*:\s*(.+?)\s*$/.exec(p);if(d){if(u)break;parseInt(d[1],10)===f&&(r.push(`### Phase ${d[1]}: ${d[2]}`),u=!0);continue}u&&r.push(p)}return r.join(`
+`).trim()||null}try{let f=o.prepare("SELECT phase_id FROM roadmap_cursor WHERE singleton = 1").get()?.phase_id??null;if(f==null)return o.close(),t;let c=o.prepare("SELECT id, decision_name, phase_number, parent_phase_id, text, status, position FROM roadmap_phases ORDER BY decision_name, phase_number, position, id").all(),m={open:"[ ]",in_progress:"[~]",done:"[x]",blocked:"[!]",stale:"[s]"},u=new Map;for(let b of c){let w=b.parent_phase_id??"root";u.has(w)||u.set(w,[]),u.get(w).push(b)}for(let b of u.values())b.sort((w,E)=>w.decision_name&&E.decision_name&&w.decision_name!==E.decision_name?w.decision_name.localeCompare(E.decision_name):w.phase_number!=null&&E.phase_number!=null?w.phase_number-E.phase_number:w.position-E.position||w.id-E.id);let r=u.get("root")||[],p=new Map;for(let b of r)b.decision_name!=null&&(p.has(b.decision_name)||p.set(b.decision_name,[]),p.get(b.decision_name).push(b));let d=[],g=(b,w)=>{for(let E of u.get(b)||[]){if(E.status==="stale")continue;let ee=f===E.id?" \u2192":"",te=E.phase_number!=null?`Phase ${E.phase_number}: ${E.text}`:E.text;d.push(`${"  ".repeat(w)}${m[E.status]||"[?]"}${ee} ${te}`),g(E.id,w+1)}};for(let[b,w]of p){let E=w.filter(v=>v.status!=="stale");if(E.length===0)continue;let ee=E.every(v=>v.status==="done"),te=E.some(v=>v.status==="in_progress"),De=ee?"done":te?"in_progress":"open",Ae=E.filter(v=>v.status==="done").length,Ie=b===P?"Roadmap":`Decision: ${b}`;d.push(`${m[De]} ${Ie} (${Ae}/${E.length} done)`);for(let v of w){if(v.status==="stale"||b===P&&v.status==="done")continue;let We=f===v.id?" \u2192":"";d.push(`  ${m[v.status]||"[?]"}${We} Phase ${v.phase_number}: ${v.text}`),g(v.id,2)}}let S=b=>c.find(w=>w.id===b),_=S(f),x=_?.decision_name??null,$=_?.phase_number??null,R=_;for(;R&&R.parent_phase_id!=null&&(R=S(R.parent_phase_id),!!R);)x=R.decision_name??x,$=R.phase_number??$;o.close();let A=_?_.phase_number!=null?`${_.decision_name} / Phase ${_.phase_number}: ${_.text}`:`${x} / Phase ${$} \u2192 ${_.text}`:"(unknown)",q=y.join(e,".last-roadmap-cursor"),me=null;try{me=parseInt(h.readFileSync(q,"utf8").trim(),10)}catch{}let fe=me!==f;try{h.writeFileSync(q,String(f),"utf8")}catch{}let he=null;if(fe&&x!=null&&$!=null){let b=x===P?y.join(e,"roadmap.md"):y.join(e,"memory",`decision_${a(x)}.md`),w=i(b,$);w&&(he=w.split(`
+`))}return{active:!0,currentLabel:A,treeLines:d,advanced:fe,memoLines:he}}catch{try{o?.close()}catch{}return t}}process.on("uncaughtException",e=>{process.stderr.write(`cairn: ${e.message}
+`),process.exit(0)});var j=process.argv[2];if(j==="--version"||j==="-v"){let e=JSON.parse(h.readFileSync(new URL("../package.json",import.meta.url),"utf8"));console.log(e.version),process.exit(0)}else if(j==="minify"){let e="";process.stdin.setEncoding("utf8"),process.stdin.on("data",t=>{e+=t}),process.stdin.on("end",()=>{let t,s;try{s=JSON.parse(e)?.tool_input||{},t=s.file_path}catch{process.exit(0)}t||process.exit(0),(s.offset!=null||s.limit!=null)&&process.exit(0),t=y.resolve(t);let n=oe(t);n||process.exit(0);let o=y.join(n,"views"),a=y.relative(o,t);!a.startsWith("..")&&!y.isAbsolute(a)&&process.exit(0);let i=C(n),f=X(n,i)>0,c=i[t];c?.state==="edit-ready"&&(f&&T(n,i),process.exit(0)),c?.state==="compressed"&&(c.state="edit-ready",T(n,i),process.exit(0));let m=y.extname(t).toLowerCase(),u=ye[m];(!u||!Ot.has(u))&&(f&&T(n,i),process.exit(0));let r;try{r=h.readFileSync(t,"utf8")}catch{f&&T(n,i),process.exit(0)}let p=r.split(`
+`).length,d=u==="vue"?ge(r):V(r,u),g=d.split(`
+`).length,S=p>0?Math.round((1-g/p)*100):0,_=xe(n,t);h.mkdirSync(y.dirname(_),{recursive:!0}),h.writeFileSync(_,d,"utf8");let x=c?.readCount??0;i[t]={tempPath:_,state:"compressed",minifiedAt:h.statSync(t).mtimeMs,readCount:x+1},T(n,i);let $=g>Se,R=x>0;if(R||$){let A=we(d,u),q=R?`[cairn: ${p} \u2192 ${g} lines | seen \xD7${x+1} this session]`:`[cairn: ${p} \u2192 outline (${g} minified lines)]`;process.stderr.write(`${q}
+${A}
+Full minified view: Read("${_}")
+`)}else process.stderr.write(`[cairn: ${p} \u2192 ${g} lines (-${S}%)]
+${d}
+Cached view: Read("${_}")
+`);process.exit(2)})}else if(j==="edit-guard"){let e="";process.stdin.setEncoding("utf8"),process.stdin.on("data",t=>{e+=t}),process.stdin.on("end",()=>{let t="(unknown)",s="Edit";try{let u=JSON.parse(e);t=u?.tool_input?.file_path||"(unknown)",s=u?.tool_name||"Edit"}catch{}let n=y.resolve(t),o=oe(n);o||process.exit(0);let a=y.join(o,"views"),i=y.relative(a,n);if(!i.startsWith("..")&&!y.isAbsolute(i)){let u=C(o),r=Object.entries(u).find(([,d])=>d.tempPath===n),p=r?`Edit the source file instead: Edit("${r[0]}")`:"Edit the original source file, not the .cairn/views/ cache.";process.stderr.write(`[cairn] Cannot edit a cached view file \u2014 it is read-only and will be overwritten on next read.
+${p}
+`),process.exit(2)}let l=C(o),f=X(o,l),c=l[n];c||(f>0&&T(o,l),process.exit(0)),s==="Write"&&(delete l[n],T(o,l),process.exit(0)),c.state==="edit-ready"&&(delete l[n],T(o,l),process.exit(0)),c.state="edit-ready",T(o,l);let m=null;try{let u=h.readFileSync(n,"utf8");u.split(`
+`).length<=300&&(m=u)}catch{}m!==null?process.stderr.write(`[cairn] File was compressed in context. Full source content:
+
+${m}
+
+Re-apply your Edit using the exact content above (state is now edit-ready).
+`):process.stderr.write(`[cairn] File compressed. Steps: (1) Read("${c.tempPath}") \u2014 loads full content into context. (2) Edit("${t}") \u2014 edit the original source, not the view.
+`),process.exit(2)})}else if(j==="roadmap-capture"){let e="";process.stdin.setEncoding("utf8"),process.stdin.on("data",t=>{e+=t}),process.stdin.on("end",async()=>{let t;try{t=JSON.parse(e)}catch{process.exit(0)}let s=t?.tool_name||"",n=t?.tool_input||{},o=process.cwd(),a=y.join(o,".cairn");h.existsSync(a)||process.exit(0);let i=y.join(a,"index.db");h.existsSync(i)||process.exit(0);let l;try{({DatabaseSync:l}=await import("node:sqlite"))}catch{process.exit(0)}let f=/exit.?plan.?mode/i.test(s),c=/todo.?write/i.test(s);!f&&!c&&process.exit(0);let m=null,u;try{if(f){let r=n.plan;(typeof r!="string"||!r.trim())&&process.exit(0);let p=$e(r);if(u=new l(i),H(u),(u.prepare("SELECT phase_id FROM main.roadmap_cursor WHERE singleton = 1").get()?.phase_id??null)==null){let g=Me(u,null);g.id!=null&&Te(u,g.id)}p.added.length>0&&(m=`[cairn] roadmap: captured ${p.added.length} phase(s) from plan${p.skipped.length?` (${p.skipped.length} already present)`:""}.`)}else if(c){u=new l(i);let r=Re(u,n.todos);r.seeded?m=`[cairn] roadmap: seeded ${r.seeded} phase(s) from todos.`:r.inserted>0&&(m=`[cairn] roadmap: linked ${r.inserted} new sub-task(s) to the current phase.`)}}catch(r){process.stderr.write(`[cairn] roadmap-capture skipped: ${r.message}
+`);try{u?.close()}catch{}process.exit(0)}u&&Oe(u);try{u?.close()}catch{}m&&process.stdout.write(JSON.stringify({systemMessage:m})),process.exit(0)})}else if(j==="validate-map"){let e=y.join(process.cwd(),".cairn");h.existsSync(e)||process.exit(0);let t=C(e),s=X(e,t);for(let n of Object.values(t))n.readCount=0;T(e,t),s>0&&process.stdout.write(`[cairn] Cleaned minify map: ${s} stale entr${s===1?"y":"ies"} removed
+`),process.exit(0)}else if(j==="checkpoint"&&process.argv[3]==="--auto"){let e=`Auto-checkpoint at ${new Date().toISOString()}`,t=[],s=[];try{let n=y.join(process.cwd(),".cairn"),o=y.join(n,"session.json");h.existsSync(o)&&(t=JSON.parse(h.readFileSync(o,"utf8")).notes||[]);let a=C(n);s=Object.entries(a).filter(([,i])=>(i.readCount??0)>0).map(([i])=>i)}catch{}se(null,{message:e,active_files:s,notes:t}),process.exit(0)}else if(j==="session-tick"){let e=process.cwd(),t=y.join(e,".cairn");h.existsSync(t)||process.exit(0);let s=[];try{let i=`Auto-checkpoint at ${new Date().toISOString()}`,l=[],f=y.join(t,"session.json");if(h.existsSync(f))try{l=JSON.parse(h.readFileSync(f,"utf8")).notes||[]}catch{}let c=C(t),m=Object.entries(c).filter(([,u])=>(u.readCount??0)>0).map(([u])=>u);se(null,{message:i,active_files:m,notes:l}),s.push("\u2713 checkpoint saved")}catch{}try{let i=Tt(e);i>0&&s.push(`memory backed up (${i})`)}catch{}let n=[];try{let i=y.join(t,"index.db");if(h.existsSync(i)){let{DatabaseSync:l}=await import("node:sqlite"),f=new l(i);try{H(f);try{n=ve(f,e).candidates}catch{}}finally{f.close()}}}catch{}let o="";try{let i=await Le(t);if(i.active){s.push(`roadmap ${i.advanced?"updated":"on track"}: ${i.currentLabel}`);let l=["[cairn] Production roadmap (\u2192 = cursor / current phase):",...i.treeLines.map(f=>"  "+f)];i.memoLines&&l.push("","\u2500\u2500 Current phase detail (from roadmap.md) \u2500\u2500",...i.memoLines,"\u2500\u2500 (re-read after each phase to confirm direction) \u2500\u2500"),l.push("","Keep this current via cairn_roadmap on MATERIAL change (phase done / blocked / new) \u2014 not every turn."),o=l.join(`
+`)}}catch{}if(n.length>0){s.push(`${n.length} phase(s) may be done \u2014 confirm with user`);let i=["","[cairn] Possible COMPLETED phase(s) detected from recent commits \u2014","CONFIRM WITH THE USER before marking done; do NOT mark done unilaterally:"];for(let l of n)i.push(`  \u2022 Phase ${l.phase_number}: ${l.text} (commit ${l.commit}, ${l.confidence}) \u2192 if confirmed: cairn_roadmap set_status ${l.phase_id} done`);o=o?o+`
+`+i.join(`
+`):i.join(`
+`).trimStart()}s.length===0&&process.exit(0);let a={systemMessage:`[cairn] ${s.join(" \xB7 ")}`};o&&(a.additionalContext=o),process.stdout.write(JSON.stringify(a)),process.exit(0)}else if(j==="memory-restore"){let e=process.cwd();h.existsSync(y.join(e,".cairn"))||process.exit(0);try{let t=Mt(e);t>0&&process.stdout.write(`[cairn] Restored ${t} memory file(s) from .cairn/memory backup (Claude store was empty)
+`)}catch{}process.exit(0)}else if(j==="resume-hint"){let e=y.join(process.cwd(),".cairn"),t=y.join(e,"session.json"),s=y.join(e,"index.db"),n=y.join(e,".hint-lock"),o=1800*1e3;if(!(process.cwd()===B.homedir())&&h.existsSync(e)&&(h.existsSync(s)||h.existsSync(t))){let r=y.join(e,".cairn-project");if(!h.existsSync(r))try{h.writeFileSync(r,"","utf8"),process.stdout.write(`[cairn] Repaired: wrote .cairn-project sentinel for hook compatibility.
+`)}catch{}}{let r=[y.join(process.cwd(),".claude","settings.json"),y.join(B.homedir(),".claude","settings.json")];for(let p of r)try{if(!h.existsSync(p))continue;let d=h.readFileSync(p,"utf8"),g=JSON.parse(d),S=g?.hooks?.PreToolUse;if(!Array.isArray(S))continue;let _=!1;for(let x of S)if(!(x.matcher!=="Edit"||!Array.isArray(x.hooks)))for(let $ of x.hooks)$.command==="cairn set-mode edit"&&($.command="cairn edit-guard",_=!0);_&&(h.writeFileSync(p,JSON.stringify(g,null,2),"utf8"),process.stdout.write(`[cairn] Repaired: migrated cairn set-mode \u2192 cairn edit-guard in ${p}
+`))}catch{}}let i="";try{i=(JSON.parse(h.readFileSync("/dev/stdin","utf8"))?.prompt||"").toLowerCase()}catch{}let f=/\b(resume|continue|pick up|where (were|did) (we|i)|last session|carry on|what('s| is) next|what (were|was) (we|i)|start|begin)\b/.test(i);h.existsSync(t)||(h.existsSync(s)||(h.existsSync(n)&&Date.now()-h.statSync(n).mtimeMs<o&&process.exit(0),h.mkdirSync(e,{recursive:!0}),h.writeFileSync(n,new Date().toISOString(),"utf8"),process.stdout.write(`[cairn] No index found. Run cairn_maintain to index this project.
+`)),process.exit(0)),h.existsSync(n)&&Date.now()-h.statSync(n).mtimeMs<o&&process.exit(0);let c=JSON.parse(h.readFileSync(t,"utf8")),m=new Date(c.checkpoint_at).toLocaleString(),u=[`[cairn] Prior session: "${c.message}" (${m}).`,"[cairn] SESSION: ALWAYS call cairn_resume FIRST when asked to resume, continue, or recall prior work \u2014 do NOT substitute git log or file reads. cairn_resume includes commits_since_checkpoint so you can cross-reference checkpoint notes against what was shipped. At end of session call cairn_checkpoint with message + active_files + notes.","[cairn] TOOLS: NEVER use Bash to run cat, grep, head, tail, find, or ls for file inspection \u2014 always use the Read, Grep, or Glob tools instead. Prefer cairn_search / cairn_bundle / cairn_describe over manual file browsing. Use cairn_outline for structural overview, cairn_todos for backlog, cairn_security before PRs.","[cairn] MEMORY: IMPORTANT \u2014 call cairn_memo IMMEDIATELY and SILENTLY (do NOT ask the user, do NOT list what you are about to save, do NOT confirm afterward) when you observe \u2014 preference: user corrects/confirms your behaviour; experience: non-trivial problem solved; decision: architectural choice made; knowledge: non-obvious codebase fact discovered. cairn_employ_memory is explicit only \u2014 never call it unless asked."];if(f){let r=["[cairn] RESUME \u2014 checkpoint loaded inline:"];r.push(`  message:      ${c.message}`),r.push(`  checkpoint:   ${m}`),c.active_files?.length>0&&r.push(`  active_files: ${c.active_files.join(", ")}`),c.notes?.length>0&&r.push(`  notes:        ${c.notes.join(" | ")}`);try{let p=new Date(c.checkpoint_at).toISOString(),d=ue(`git log --oneline --after="${p}"`,{cwd:process.cwd(),encoding:"utf8",timeout:5e3}).trim();r.push(`  commits_since: ${d?d.split(`
+`).join("; "):"(none)"}`)}catch{}try{let p=ue("git diff --name-only HEAD",{cwd:process.cwd(),encoding:"utf8",timeout:5e3}).trim();p&&r.push(`  uncommitted:   ${p.split(`
+`).join(", ")}`)}catch{}try{let p=ue("git status --short",{cwd:process.cwd(),encoding:"utf8",timeout:5e3}).trim();p&&r.push(`  git_status:
+${p.split(`
+`).map(d=>"    "+d).join(`
+`)}`)}catch{}r.push("  \u2192 Call cairn_resume for full index status and open todos."),u.push(r.join(`
+`))}process.stdout.write(u.join(`
+`)+`
+`),h.writeFileSync(n,new Date().toISOString(),"utf8"),process.exit(0)}else if(j==="roadmap-hint"){let e=y.join(process.cwd(),".cairn"),t=await Le(e);t.active||process.exit(0);let s=["[cairn] ROADMAP \u2014 cursor is active.",...t.treeLines.map(n=>"[cairn]   "+n),`[cairn] Current: ${t.currentLabel}`];if(t.memoLines){s.push("[cairn] \u2500\u2500\u2500\u2500\u2500 Decision memo (current phase) \u2500\u2500\u2500\u2500\u2500");for(let n of t.memoLines)s.push("[cairn] "+n);s.push("[cairn] \u2500\u2500\u2500\u2500\u2500 (re-read after each phase to confirm direction) \u2500\u2500\u2500\u2500\u2500")}s.push("[cairn] Use cairn_roadmap set_status <id> done (auto-advances), focus <id>, or next to move cursor."),process.stdout.write(s.join(`
+`)+`
+`),process.exit(0)}else if(j==="install"){let e=process.platform,t=y.join(B.homedir(),".claude.json"),s={};if(h.existsSync(t))try{s=JSON.parse(h.readFileSync(t,"utf8"))}catch{}s.mcpServers=s.mcpServers||{};let n=!!s.mcpServers.cairn;s.mcpServers.cairn={command:"cairn-mcp"},h.writeFileSync(t,JSON.stringify(s,null,2),"utf8");let o=y.join(B.homedir(),".claude");Fe(o,!0),console.log("Cairn installed successfully!"),console.log(""),console.log(`  Platform : ${e}`),console.log(`  MCP      : cairn-mcp registered in ${t}${n?" (updated)":""}`),console.log(`  Hooks    : installed in ${y.join(o,"settings.json")}`),console.log(""),console.log("Active hooks:"),console.log("  PreToolUse[Read]     -> cairn minify                   (compress source files for reading)"),console.log("  PreToolUse[Edit]     -> cairn edit-guard               (block Edit until re-read with full content)"),console.log("  PreToolUse[Write]    -> cairn edit-guard               (clear minify state before full file overwrite)"),console.log("  PostToolUse[ExitPlanMode] -> cairn roadmap-capture      (approved plan -> roadmap phases)"),console.log("  PostToolUse[TodoWrite]    -> cairn roadmap-capture      (todos -> roadmap sub-tasks)"),console.log("  Stop                 -> cairn session-tick             (checkpoint + memory backup + roadmap, surfaced)"),console.log("  UserPromptSubmit     -> cairn resume-hint               (remind Claude of prior session)"),console.log("  UserPromptSubmit     -> cairn memory-restore            (restore .cairn/memory -> Claude store if empty)"),console.log(""),console.log("Restart Claude Code to activate the MCP server, then open any project and start working."),console.log("Upgrade any time with: npm install -g @misterhuydo/cairn-mcp"),process.exit(0)}else if(j==="install-hooks"){let e=process.argv.includes("--global"),t=e?y.join(B.homedir(),".claude"):y.join(process.cwd(),".claude");Fe(t,e),console.log(`Cairn hooks installed in ${e?"global (~/.claude/settings.json)":"project (.claude/settings.json)"}`),console.log(""),console.log("Active hooks:"),console.log("  PreToolUse[Read]     -> cairn minify                   (compress source files for reading)"),console.log("  PreToolUse[Edit]     -> cairn edit-guard               (block Edit until re-read with full content)"),console.log("  PreToolUse[Write]    -> cairn edit-guard               (clear minify state before full file overwrite)"),console.log("  PostToolUse[ExitPlanMode] -> cairn roadmap-capture      (approved plan -> roadmap phases)"),console.log("  PostToolUse[TodoWrite]    -> cairn roadmap-capture      (todos -> roadmap sub-tasks)"),console.log("  Stop                 -> cairn session-tick             (checkpoint + memory backup + roadmap, surfaced)"),console.log("  UserPromptSubmit     -> cairn resume-hint               (remind Claude of prior session)"),console.log("  UserPromptSubmit     -> cairn memory-restore            (restore .cairn/memory -> Claude store if empty)"),process.exit(0)}else console.error("Usage: cairn <--version | install | install-hooks [--global] | minify | edit-guard | validate-map | checkpoint --auto | session-tick | resume-hint | roadmap-hint | roadmap-capture | memory-restore>"),process.exit(1);function Fe(e,t){let s=y.join(e,"settings.json"),n={};if(h.existsSync(s))try{n=JSON.parse(h.readFileSync(s,"utf8"))}catch{}n.hooks=n.hooks||{};let o=n.hooks.PreToolUse||[];o.some(r=>r.matcher==="Read"&&r.hooks?.some(p=>p.command==="cairn minify"))||o.push({matcher:"Read",hooks:[{type:"command",command:"cairn minify"}]});let a=o.filter(r=>!(r.matcher==="Edit"&&r.hooks?.some(p=>p.command==="cairn set-mode edit")));a.some(r=>r.matcher==="Edit"&&r.hooks?.some(p=>p.command==="cairn edit-guard"))||a.push({matcher:"Edit",hooks:[{type:"command",command:"cairn edit-guard"}]}),a.some(r=>r.matcher==="Write"&&r.hooks?.some(p=>p.command==="cairn edit-guard"))||a.push({matcher:"Write",hooks:[{type:"command",command:"cairn edit-guard"}]}),n.hooks.PreToolUse=a;let i=(r,p)=>(r||[]).map(d=>({...d,hooks:(d.hooks||[]).filter(g=>!p(g.command))})).filter(d=>(d.hooks||[]).length>0),l=r=>typeof r=="string"&&/sync-memory-(forward|restore)\.(mjs|py)/.test(r),f=i(n.hooks.Stop,r=>r==="cairn checkpoint --auto"||r==="cairn roadmap-hint");f.some(r=>r.hooks?.some(p=>p.command==="cairn session-tick"))||f.push({hooks:[{type:"command",command:"cairn session-tick"}]}),n.hooks.Stop=f;let c=i(n.hooks.UserPromptSubmit,l);c.some(r=>r.hooks?.some(p=>p.command==="cairn resume-hint"))||c.push({hooks:[{type:"command",command:"cairn resume-hint"}]}),c.some(r=>r.hooks?.some(p=>p.command==="cairn memory-restore"))||c.push({hooks:[{type:"command",command:"cairn memory-restore"}]}),n.hooks.UserPromptSubmit=c;let m=i(n.hooks.PostToolUse,l),u=r=>{m.some(p=>p.matcher===r&&p.hooks?.some(d=>d.command==="cairn roadmap-capture"))||m.push({matcher:r,hooks:[{type:"command",command:"cairn roadmap-capture"}]})};if(u("ExitPlanMode"),u("TodoWrite"),n.hooks.PostToolUse=m,t){let r=y.join(e,"scripts");for(let p of["sync-memory-forward.mjs","sync-memory-restore.mjs","sync-memory-forward.py","sync-memory-restore.py"]){let d=y.join(r,p);if(h.existsSync(d))try{h.unlinkSync(d)}catch{}}}if(!t){let r=y.join(process.cwd(),".cairn");h.mkdirSync(r,{recursive:!0});let p=y.join(r,".cairn-project");h.existsSync(p)||h.writeFileSync(p,"","utf8")}h.mkdirSync(e,{recursive:!0}),h.writeFileSync(s,JSON.stringify(n,null,2),"utf8")}