infernoflow 0.40.1 → 0.40.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog — infernoflow
 
+## 0.40.3 — 2026-05-02
+
+### Added
+- **`infernoflow watch` heuristic prompts (Plan Part 4 Level 2)** — the watcher now surfaces "log this?" tips when it spots patterns that usually indicate gotchas, on top of the existing debounced auto-suggest:
+  - Same file edited 5/12/25 times in a session → "stuck on something?" with a gotcha-log hint
+  - Dependency manifest changed (package.json, Cargo.toml, go.mod, requirements.txt, Pipfile, Gemfile, composer.json, lockfiles, etc. — 18 files total) → suggests logging the decision
+  - Test file deleted (under `tests/`, `test/`, `__tests__/`, `spec/`, or matching `*.test.*` / `*.spec.*`) → suggests logging why
+- **`--no-tips` flag** — disables the heuristic prompts while keeping the auto-suggest behaviour. `--silent` continues to disable all output.
+
+### Changed
+- **`watch` default directories** include `tests`, `test`, `__tests__`, `spec` so test-file removal is detected without manual `infernoflow watch tests` invocations.
+- **Non-recursive project-root watcher** added under the hood so dependency-manifest changes are caught regardless of which subdirectory was passed to `watch`.
+- **Per-file 250ms debounce** on event handling — fs.watch fires multiple events per save on most platforms; the watcher now collapses them so edit-count thresholds and dependency-tip prompts don't double-fire.
+
 ## 0.40.1 — 2026-05-02
 
 ### Fixed

package/dist/lib/commands/watch.mjs

@@ -1,5 +1,7 @@
-import*as f from"node:fs";import*as e from"node:path";import{fileURLToPath as $}from"node:url";import{spawnSync as b}from"node:child_process";import{warn as m,bold as x,cyan as D,gray as d,green as I,yellow as P}from"../ui/output.mjs";const R=new Set([".ts",".tsx",".js",".jsx",".mjs",".cjs",".py",".go",".java",".cs",".rb",".swift"]),M=new Set(["node_modules",".git","dist","build","out",".next",".angular","vendor","coverage","__pycache__"]);function W(t){const i=["src","lib","app","pages","components","server","api"].filter(o=>f.existsSync(e.join(t,o)));return i.length?i.map(o=>e.join(t,o)):[t]}function k(t){return R.has(e.extname(t).toLowerCase())}function A(t,r){const i=e.join(r,"capability-map.json");if(!f.existsSync(i))return{relevant:!0,reason:"no cap-map \u2014 suggesting broadly"};let o;try{o=JSON.parse(f.readFileSync(i,"utf8"))}catch{return{relevant:!0,reason:"cap-map unreadable"}}const s=[];for(const g of t){const c=e.relative(process.cwd(),g).replace(/\\/g,"/");for(const[a,u]of Object.entries(o))c.startsWith(a.replace(/\\/g,"/"))&&s.push(...u)}return s.length>0?{relevant:!0,reason:`touches: ${[...new Set(s)].slice(0,3).join(", ")}`}:{relevant:!1,reason:"no mapped capabilities affected"}}function N(t,r,i,o,s){const c=`code changes in ${t.map(a=>e.basename(a,e.extname(a))).slice(0,3).join(", ")}`;if(s||process.stdout.write(`  ${P("\u27F3")}  suggesting from ${x(String(t.length))} changed file${t.length!==1?"s":""}\u2026 `),o){s||console.log(d("(dry run)"));return}try{b(process.execPath,[e.join(e.dirname(e.dirname(e.dirname($(import.meta.url)))),"bin","infernoflow.mjs"),"suggest",c,"--json"],{cwd:r,encoding:"utf8",timeout:3e4,stdio:"ignore"}),s||console.log(I("done"))}catch{s||console.log(d("skipped (no changes)"))}try{const u=b(process.execPath,[e.join(e.dirname(e.dirname(e.dirname($(import.meta.url)))),"bin","infernoflow.mjs"),"check","--json"],{cwd:r,encoding:"utf8",timeout:15e3}).stdout?.trim();if(u){const w=JSON.parse(u);if(w.status==="error"||w.status==="warning")f.writeFileSync(e.join(i,"WATCH.log"),u+`
-`),s||m("Contract issues detected \u2014 see inferno/WATCH.log");else{const p=e.join(i,"WATCH.log");f.existsSync(p)&&f.unlinkSync(p)}}}catch{}}async function U(t){const r=t.slice(1),i=r.includes("--dry-run"),o=r.includes("--silent"),s=r.indexOf("--interval"),g=((s!==-1?parseFloat(r[s+1]):3)||3)*1e3,c=process.cwd(),a=e.join(c,"inferno");f.existsSync(a)||(m("inferno/ not found. Run: infernoflow init"),process.exit(1));const u=r.filter(n=>!n.startsWith("-")&&n!==String(r[s+1])),p=(u.length?u.map(n=>e.resolve(c,n)):W(c)).filter(n=>f.existsSync(n));p.length||(m("No valid directories to watch."),process.exit(1)),o||(console.log(),console.log(`  ${x("\u{1F525} infernoflow watch")}  ${d("(Ctrl+C to stop)")}`),console.log(),p.forEach(n=>console.log(`  ${D("watching")} ${d(e.relative(c,n)||".")}`)),console.log(`  ${d(`debounce: ${g/1e3}s`)}`),console.log());let y=null;const S=new Set,C=n=>{k(n)&&(S.add(n),y&&clearTimeout(y),y=setTimeout(()=>{const l=Array.from(S);if(S.clear(),!o){const T=l.map(_=>e.relative(c,_)).slice(0,3).join(", ");process.stdout.write(`
-  ${d(new Date().toLocaleTimeString())}  ${x(T)}${l.length>3?` +${l.length-3} more`:""}  `)}const{relevant:v,reason:h}=A(l,a);if(!v){o||console.log(d(`skip (${h})`));return}N(l,c,a,i,o)},g))},j=[];for(const n of p)try{const l=f.watch(n,{recursive:!0},(v,h)=>{h&&C(e.join(n,h))});j.push(l)}catch(l){o||m(`Cannot watch ${n}: ${l.message}`)}j.length||(m("No directories could be watched."),process.exit(1)),process.on("SIGINT",()=>{j.forEach(n=>n.close()),o||(console.log(`
+import*as p from"node:fs";import*as t from"node:path";import{fileURLToPath as D}from"node:url";import{spawnSync as I}from"node:child_process";import{warn as x,bold as y,cyan as N,gray as d,green as L,yellow as O}from"../ui/output.mjs";const H=new Set([".ts",".tsx",".js",".jsx",".mjs",".cjs",".py",".go",".java",".cs",".rb",".swift"]),ie=new Set(["node_modules",".git","dist","build","out",".next",".angular","vendor","coverage","__pycache__"]);function M(e){const i=["src","lib","app","pages","components","server","api","tests","test","__tests__","spec"].filter(o=>p.existsSync(t.join(e,o)));return i.length?i.map(o=>t.join(e,o)):[e]}function U(e){return H.has(t.extname(e).toLowerCase())}const G=new Set(["package.json","package-lock.json","yarn.lock","pnpm-lock.yaml","bun.lockb","requirements.txt","Pipfile","Pipfile.lock","pyproject.toml","poetry.lock","Cargo.toml","Cargo.lock","go.mod","go.sum","Gemfile","Gemfile.lock","composer.json","composer.lock"]),J=/(?:^|[\\/])(?:test|tests|spec|__tests__)[\\/].+\.(?:mjs|cjs|js|jsx|ts|tsx|py|go|rb|java|cs)$|\.(?:test|spec)\.(?:mjs|cjs|js|jsx|ts|tsx|py|go|rb|java|cs)$/i;function X(e){return G.has(t.basename(e))}function Y(e){return J.test(e)}function k(e,n){return`
+  ${O("\u26A0")}  ${e}
+  ${d("\u2192")}  ${N(n)}`}const R=new Map,j=new Map,C=250,q=[5,12,25];function B(e){const n=Date.now(),i=j.get(e)||0;if(n-i<C)return null;j.set(e,n);const o=(R.get(e)||0)+1;return R.set(e,o),o}function K(e,n,i){if(!q.includes(n))return null;const o=t.relative(i,e);return k(`${y(o)} edited ${n}\xD7 this session \u2014 stuck on something?`,`infernoflow log "<what's tripping you up>" --type gotcha`)}function Z(e,n){const i=t.relative(n,e);return k(`dependency manifest changed: ${y(i)}`,'infernoflow log "<switched from X to Y because Z>" --type decision')}function z(e,n){const i=t.relative(n,e);return k(`test file removed: ${y(i)} \u2014 was it failing?`,'infernoflow log "<why the test was removed>" --type attempt --result failed')}function Q(e,n){const i=t.join(n,"capability-map.json");if(!p.existsSync(i))return{relevant:!0,reason:"no cap-map \u2014 suggesting broadly"};let o;try{o=JSON.parse(p.readFileSync(i,"utf8"))}catch{return{relevant:!0,reason:"cap-map unreadable"}}const u=[];for(const w of e){const g=t.relative(process.cwd(),w).replace(/\\/g,"/");for(const[f,a]of Object.entries(o))g.startsWith(f.replace(/\\/g,"/"))&&u.push(...a)}return u.length>0?{relevant:!0,reason:`touches: ${[...new Set(u)].slice(0,3).join(", ")}`}:{relevant:!1,reason:"no mapped capabilities affected"}}function V(e,n,i,o,u){const g=`code changes in ${e.map(f=>t.basename(f,t.extname(f))).slice(0,3).join(", ")}`;if(u||process.stdout.write(`  ${O("\u27F3")}  suggesting from ${y(String(e.length))} changed file${e.length!==1?"s":""}\u2026 `),o){u||console.log(d("(dry run)"));return}try{I(process.execPath,[t.join(t.dirname(t.dirname(t.dirname(D(import.meta.url)))),"bin","infernoflow.mjs"),"suggest",g,"--json"],{cwd:n,encoding:"utf8",timeout:3e4,stdio:"ignore"}),u||console.log(L("done"))}catch{u||console.log(d("skipped (no changes)"))}try{const a=I(process.execPath,[t.join(t.dirname(t.dirname(t.dirname(D(import.meta.url)))),"bin","infernoflow.mjs"),"check","--json"],{cwd:n,encoding:"utf8",timeout:15e3}).stdout?.trim();if(a){const h=JSON.parse(a);if(h.status==="error"||h.status==="warning")p.writeFileSync(t.join(i,"WATCH.log"),a+`
+`),u||x("Contract issues detected \u2014 see inferno/WATCH.log");else{const S=t.join(i,"WATCH.log");p.existsSync(S)&&p.unlinkSync(S)}}}catch{}}async function re(e){const n=e.slice(1),i=n.includes("--dry-run"),o=n.includes("--silent"),u=n.includes("--no-tips"),w=!o&&!u,g=n.indexOf("--interval"),f=((g!==-1?parseFloat(n[g+1]):3)||3)*1e3,a=process.cwd(),h=t.join(a,"inferno");p.existsSync(h)||(x("inferno/ not found. Run: infernoflow init"),process.exit(1));const S=n.filter(r=>!r.startsWith("-")&&r!==String(n[g+1])),$=(S.length?S.map(r=>t.resolve(a,r)):M(a)).filter(r=>p.existsSync(r));$.length||(x("No valid directories to watch."),process.exit(1)),o||(console.log(),console.log(`  ${y("\u{1F525} infernoflow watch")}  ${d("(Ctrl+C to stop)")}`),console.log(),$.forEach(r=>console.log(`  ${N("watching")} ${d(t.relative(a,r)||".")}`)),console.log(`  ${d(`debounce: ${f/1e3}s`)}`),console.log());let b=null;const T=new Set,F=new Set,m=[],E=(r,c)=>{if(w&&X(c)&&p.existsSync(c)){const s="dep:"+c,l=Date.now();l-(j.get(s)||0)>=C&&(j.set(s,l),m.push(Z(c,a)))}if(w&&Y(c))if(r==="rename"&&!p.existsSync(c)){const s="del:"+c,l=Date.now();l-(j.get(s)||0)>=C&&(j.set(s,l),m.push(z(c,a)))}else p.existsSync(c)&&F.add(c);if(!U(c)){if(m.length&&!o)for(const s of m.splice(0))console.log(s);return}if(T.add(c),w){const s=B(c);if(s!==null){const l=K(c,s,a);l&&m.push(l)}}b&&clearTimeout(b),b=setTimeout(()=>{const s=Array.from(T);if(T.clear(),!o){const _=s.map(A=>t.relative(a,A)).slice(0,3).join(", ");process.stdout.write(`
+  ${d(new Date().toLocaleTimeString())}  ${y(_)}${s.length>3?` +${s.length-3} more`:""}  `)}const{relevant:l,reason:W}=Q(s,h);if(l?V(s,a,h,i,o):o||console.log(d(`skip (${W})`)),m.length&&!o)for(const _ of m.splice(0))console.log(_)},f)},v=[];for(const r of $)try{const c=p.watch(r,{recursive:!0},(s,l)=>{l&&E(s,t.join(r,l))});v.push(c)}catch(c){o||x(`Cannot watch ${r}: ${c.message}`)}try{const r=p.watch(a,{recursive:!1},(c,s)=>{s&&E(c,t.join(a,s))});v.push(r)}catch{}v.length||(x("No directories could be watched."),process.exit(1)),process.on("SIGINT",()=>{v.forEach(r=>r.close()),o||(console.log(`
 
-  Stopped.`),console.log()),process.exit(0)}),await new Promise(()=>{})}export{U as watchCommand};
+  Stopped.`),console.log()),process.exit(0)}),await new Promise(()=>{})}export{re as watchCommand};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infernoflow",
-  "version": "0.40.1",
+  "version": "0.40.3",
   "description": "Persistent memory for AI coding sessions \u2014 captures what agents can't infer from code alone. Works with Copilot, Cursor, Claude, and Windsurf.",
   "type": "module",
   "bin": {