infernoflow 0.10.23 → 0.10.26

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog — infernoflow
 
+## 0.10.25 — 2026-04-22
+
+### Added
+- Release 0.10.25
+
+
+## 0.10.24 — 2026-04-21
+
+### Added
+- Release 0.10.24
+
+
 ## 0.10.23 — 2026-04-21
 
 ### Added
@@ -42,9 +54,4 @@
 ### Added
 - `infernoflow init` — interactive scaffold with prompts
 - `infernoflow check` — full validation with clear error messages  
-- `infernoflow status` — at-a-glance dashboard
-- `infernoflow doc-gate` — CI hook for keeping docs in sync
-- Zero npm dependencies — works with Node.js 18+ out of the box
-- `--json` flag on check for CI pipelines
-- Auto-detect project name from package.json
-- Auto-add npm scripts to package.json on init
+- `infernoflow

package/dist/bin/infernoflow.mjs

@@ -1,21 +1,79 @@
 #!/usr/bin/env node
-import{readFileSync as m}from"node:fs";import{dirname as d,join as u}from"node:path";import{fileURLToPath as f}from"node:url";import{bold as e,gray as t,red as i}from"../lib/ui/output.mjs";const g=d(f(import.meta.url)),h=JSON.parse(m(u(g,"..","package.json"),"utf8")),r=h.version||"0.0.0",c={publish:"Bump version, update changelog, build, npm publish, git commit + push in one shot",diff:"Show what capabilities changed since the last git tag (or any ref)",changelog:"Draft a changelog entry from commits since the last tag",setup:"One command to get fully operational \u2014 detects IDE, inits, installs hooks + MCP",init:"Scaffold inferno/ in your project (or adopt existing project)","install-cursor-hooks":"Install Cursor hooks: draft agent replies to inferno/CONTEXT.draft.md","install-vscode-copilot-hooks":"Install VS Code + Copilot agent hooks (Preview): draft to inferno/CONTEXT.draft.md",check:"Validate contract, capabilities, scenarios, changelog",status:"Show contract health at a glance","pr-impact":"Summarize PR impact on capabilities and docs",sync:"Run deterministic inferno sync flow",run:"One-command detect/propose/apply/validate flow","doc-gate":"Fail if code changed but docs were not updated",suggest:"Generate AI prompt + apply capability updates",implement:"Generate code-agent implementation prompt(s)",context:"Generate AI-ready context for new sessions","generate-skills":"Generate personalised Cursor rules + skill files from your developer profile"},l={publish:async o=>(await import("../lib/commands/publish.mjs")).publishCommand(o),diff:async o=>(await import("../lib/commands/diff.mjs")).diffCommand(o),changelog:async o=>(await import("../lib/commands/changelog.mjs")).changelogCommand(o),setup:async o=>(await import("../lib/commands/setup.mjs")).setupCommand(o),init:async o=>(await import("../lib/commands/init.mjs")).initCommand(o),"install-cursor-hooks":async o=>(await import("../lib/commands/installCursorHooks.mjs")).installCursorHooksCommand(o),"install-vscode-copilot-hooks":async o=>(await import("../lib/commands/installVsCodeCopilotHooks.mjs")).installVsCodeCopilotHooksCommand(o),check:async o=>(await import("../lib/commands/check.mjs")).checkCommand(o),status:async o=>(await import("../lib/commands/status.mjs")).statusCommand(o),"pr-impact":async o=>(await import("../lib/commands/prImpact.mjs")).prImpactCommand(o),sync:async o=>(await import("../lib/commands/syncAuto.mjs")).syncCommand(o),run:async o=>(await import("../lib/commands/run.mjs")).runCommand(o),suggest:async o=>(await import("../lib/commands/suggest.mjs")).suggestCommand(o),implement:async o=>(await import("../lib/commands/implement.mjs")).implementCommand(o),context:async o=>(await import("../lib/commands/context.mjs")).contextCommand(o),"doc-gate":async o=>(await import("../lib/commands/docGate.mjs")).docGateCommand(o),"generate-skills":async o=>(await import("../lib/commands/generateSkills.mjs")).generateSkillsCommand(o)};function y(){const o=Object.keys(c),s=Math.max(...o.map(a=>a.length),8)+1;return Object.entries(c).map(([a,p])=>`    ${a.padEnd(s," ")}${p}`).join(`
-`)}const w=`
-  ${e("\u{1F525} infernoflow")} ${t("v"+r)}
-  ${t("The forge for liquid code \u2014 keep every AI session in sync")}
-
-  ${e("Usage:")}
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { bold, gray, cyan, red } from "../lib/ui/output.mjs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
+const VERSION = pkg.version || "0.0.0";
+const COMMAND_DESCRIPTIONS = {
+  publish: "Bump version, update changelog, build, npm publish, git commit + push in one shot",
+  diff: "Show what capabilities changed since the last git tag (or any ref)",
+  changelog: "Draft a changelog entry from commits since the last tag",
+  setup: "One command to get fully operational — detects IDE, inits, installs hooks + MCP",
+  init: "Scaffold inferno/ in your project (or adopt existing project)",
+  "install-cursor-hooks": "Install Cursor hooks: draft agent replies to inferno/CONTEXT.draft.md",
+  "install-vscode-copilot-hooks":
+    "Install VS Code + Copilot agent hooks (Preview): draft to inferno/CONTEXT.draft.md",
+  check: "Validate contract, capabilities, scenarios, changelog",
+  status: "Show contract health at a glance",
+  "pr-impact": "Summarize PR impact on capabilities and docs",
+  sync: "Run deterministic inferno sync flow",
+  run: "One-command detect/propose/apply/validate flow",
+  "doc-gate": "Fail if code changed but docs were not updated",
+  suggest: "Generate AI prompt + apply capability updates",
+  implement: "Generate code-agent implementation prompt(s)",
+  context: "Generate AI-ready context for new sessions",
+  "generate-skills": "Generate personalised Cursor rules + skill files from your developer profile",
+};
+
+const COMMAND_HANDLERS = {
+  publish: async (args) => (await import("../lib/commands/publish.mjs")).publishCommand(args),
+  diff: async (args) => (await import("../lib/commands/diff.mjs")).diffCommand(args),
+  changelog: async (args) => (await import("../lib/commands/changelog.mjs")).changelogCommand(args),
+  setup: async (args) => (await import("../lib/commands/setup.mjs")).setupCommand(args),
+  init: async (args) => (await import("../lib/commands/init.mjs")).initCommand(args),
+  "install-cursor-hooks": async (args) =>
+    (await import("../lib/commands/installCursorHooks.mjs")).installCursorHooksCommand(args),
+  "install-vscode-copilot-hooks": async (args) =>
+    (await import("../lib/commands/installVsCodeCopilotHooks.mjs")).installVsCodeCopilotHooksCommand(args),
+  check: async (args) => (await import("../lib/commands/check.mjs")).checkCommand(args),
+  status: async (args) => (await import("../lib/commands/status.mjs")).statusCommand(args),
+  "pr-impact": async (args) => (await import("../lib/commands/prImpact.mjs")).prImpactCommand(args),
+  sync: async (args) => (await import("../lib/commands/syncAuto.mjs")).syncCommand(args),
+  run: async (args) => (await import("../lib/commands/run.mjs")).runCommand(args),
+  suggest: async (args) => (await import("../lib/commands/suggest.mjs")).suggestCommand(args),
+  implement: async (args) => (await import("../lib/commands/implement.mjs")).implementCommand(args),
+  context: async (args) => (await import("../lib/commands/context.mjs")).contextCommand(args),
+  "doc-gate": async (args) => (await import("../lib/commands/docGate.mjs")).docGateCommand(args),
+  "generate-skills": async (args) => (await import("../lib/commands/generateSkills.mjs")).generateSkillsCommand(args),
+};
+
+function formatCommandsHelp() {
+  const names = Object.keys(COMMAND_DESCRIPTIONS);
+  const w = Math.max(...names.map((n) => n.length), 8) + 1;
+  return Object.entries(COMMAND_DESCRIPTIONS)
+    .map(([name, desc]) => `    ${name.padEnd(w, " ")}${desc}`)
+    .join("\n");
+}
+
+const HELP = `
+  ${bold("🔥 infernoflow")} ${gray("v" + VERSION)}
+  ${gray("The forge for liquid code — keep every AI session in sync")}
+
+  ${bold("Usage:")}
     infernoflow <command> [options]
 
-  ${e("Commands:")}
-${y()}
+  ${bold("Commands:")}
+${formatCommandsHelp()}
 
-  ${e("diff options:")}
+  ${bold("diff options:")}
     --ref <tag|commit>        Compare against a specific ref (default: last git tag)
     --summary                 One-liner count only
     --json                    Machine-readable output
 
-  ${e("changelog options:")}
+  ${bold("changelog options:")}
     update                    Draft ## Unreleased from commits (default sub-command)
     show                      Print the current ## Unreleased block
     list                      List commits since last tag
@@ -24,7 +82,7 @@ ${y()}
     --append                  Append to existing ## Unreleased instead of replacing
     --json                    Machine-readable output
 
-  ${e("publish options:")}
+  ${bold("publish options:")}
     --bump patch|minor|major  Version bump type (default: patch)
     --skip-build              Skip the build step
     --skip-tests              Skip smoke tests
@@ -33,13 +91,13 @@ ${y()}
     --dry-run                 Print all steps without executing
     --yes, -y                 Non-interactive (skip confirmation prompt)
 
-  ${e("setup options:")}
+  ${bold("setup options:")}
     --yes, -y           Skip prompts (non-interactive)
     --force, -f         Overwrite existing hook files
 
-  ${e("init options:")}
-    --cursor-hooks           Also install Cursor hooks (draft \u2192 inferno/CONTEXT.draft.md)
-    --vscode-copilot-hooks   Also install VS Code + Copilot hooks (.github/hooks \u2014 Preview)
+  ${bold("init options:")}
+    --cursor-hooks           Also install Cursor hooks (draft → inferno/CONTEXT.draft.md)
+    --vscode-copilot-hooks   Also install VS Code + Copilot hooks (.github/hooks — Preview)
     --adopt             Infer capabilities from an existing codebase
     --lang <name>       Override detected language (e.g. ts, js, py)
     --framework <name>  Override detected framework (e.g. react, angular, express)
@@ -50,13 +108,13 @@ ${y()}
     --yes, -y           Skip prompts and accept inferred/default values
     --force, -f         Overwrite existing inferno/ files
 
-  ${e("install-cursor-hooks options:")}
+  ${bold("install-cursor-hooks options:")}
     --force, -f         Overwrite .cursor/hooks.json and hook scripts if they exist
 
-  ${e("install-vscode-copilot-hooks options:")}
+  ${bold("install-vscode-copilot-hooks options:")}
     --force, -f         Overwrite .github/hooks/infernoflow-drafts.json and scripts if they exist
 
-  ${e("context options:")}
+  ${bold("context options:")}
     --intent  "..."     What you plan to build next
     --working "..."     What you are building right now
     --decision "..."    Record a decision or note
@@ -68,43 +126,79 @@ ${y()}
     --auto-commit       Watch mode: commit CONTEXT.md to git on every change
     --auto-push         Watch mode: commit + push CONTEXT.md on every change
 
-  ${e("generate-skills options:")}
+  ${bold("generate-skills options:")}
     --cursor            Also install rules to .cursor/rules/infernoflow.md
     --force, -f         Overwrite existing generated skill files
 
-  ${e("implement options:")}
+  ${bold("implement options:")}
     --mode <type>       cursor | generic | both (default: both)
     --copy, -c          Copy generated prompt(s) to clipboard
 
-  ${e("run options:")}
+  ${bold("run options:")}
     --dry-run           Execute full flow without writing files
     --json              Emit machine-readable events and result payload
     --no-rollback       Keep changes even if validation fails
     --provider <type>   auto | agent | local | prompt (default: auto)
     --ide <name>        auto | cursor | vscode | windsurf (default: auto)
 
-  ${e("Typical workflow:")}
-    ${t('1. infernoflow context --intent "what I want to build"')}
-    ${t("2. [paste inferno/CONTEXT.md into Claude / Cursor / Copilot]")}
-    ${t("3. [build the feature]")}
-    ${t('4. infernoflow suggest "what I built"')}
-    ${t("5. infernoflow check")}
+  ${bold("Typical workflow:")}
+    ${gray('1. infernoflow context --intent "what I want to build"')}
+    ${gray("2. [paste inferno/CONTEXT.md into Claude / Cursor / Copilot]")}
+    ${gray("3. [build the feature]")}
+    ${gray('4. infernoflow suggest "what I built"')}
+    ${gray("5. infernoflow check")}
 
-  ${e("suggest options:")}
+  ${bold("suggest options:")}
     --json                    Non-interactive: emit prompt as JSON, no readline prompts
     --response <json|@file>   Provide AI response directly (use with --json)
     --apply                   Apply the response changes when using --json --response
 
-  ${e("Machine output:")}
-    ${t("status --json")}
-    ${t("check --json")}
-    ${t("doc-gate --json")}
-    ${t("pr-impact --json")}
-    ${t("sync --auto --json")}
-    ${t('run "task" --json')}
-    ${t('suggest "what changed" --json')}
-    ${t(`suggest "what changed" --json --response '{"newCapabilities":[...]}' --apply`)}
-`;import*as k from"node:fs";import*as C from"node:path";try{const o=C.join(process.cwd(),"inferno");if(k.existsSync(o)){const{observeCommandStart:s}=await import("../lib/learning/observe.mjs"),a=process.argv[2];a&&!a.startsWith("-")&&s(o,a)}}catch{}const[,,n,...b]=process.argv;(!n||n==="--help"||n==="-h")&&(console.log(w),process.exit(0)),(n==="--version"||n==="-v")&&(console.log(r),process.exit(0));const v=Object.keys(l);v.includes(n)||(console.error(i(`
-Unknown command: ${n}`)),console.error(t(`Run: infernoflow --help
-`)),process.exit(1));const $=[n,...b];l[n]($).catch(o=>{console.error(i(`
-Error: `)+o.message),process.exit(1)});
+  ${bold("Machine output:")}
+    ${gray("status --json")}
+    ${gray("check --json")}
+    ${gray("doc-gate --json")}
+    ${gray("pr-impact --json")}
+    ${gray("sync --auto --json")}
+    ${gray('run "task" --json')}
+    ${gray('suggest "what changed" --json')}
+    ${gray('suggest "what changed" --json --response \'{"newCapabilities":[...]}\' --apply')}
+`;
+
+// ── Silent behavior observation ───────────────────────────────────────────
+import * as fs from "node:fs";
+import * as path from "node:path";
+try {
+  const infernoDir = path.join(process.cwd(), "inferno");
+  if (fs.existsSync(infernoDir)) {
+    const { observeCommandStart } = await import("../lib/learning/observe.mjs");
+    const cmdForObserve = process.argv[2];
+    if (cmdForObserve && !cmdForObserve.startsWith("-")) {
+      observeCommandStart(infernoDir, cmdForObserve);
+    }
+  }
+} catch {}
+
+const [, , cmd, ...rest] = process.argv;
+
+if (!cmd || cmd === "--help" || cmd === "-h") {
+  console.log(HELP);
+  process.exit(0);
+}
+if (cmd === "--version" || cmd === "-v") {
+  console.log(VERSION);
+  process.exit(0);
+}
+
+const commands = Object.keys(COMMAND_HANDLERS);
+
+if (!commands.includes(cmd)) {
+  console.error(red(`\nUnknown command: ${cmd}`));
+  console.error(gray("Run: infernoflow --help\n"));
+  process.exit(1);
+}
+
+const args = [cmd, ...rest];
+COMMAND_HANDLERS[cmd](args).catch((err) => {
+  console.error(red("\nError: ") + err.message);
+  process.exit(1);
+});

package/dist/lib/adopters/angular.mjs

@@ -1 +1,128 @@
-import*as z from"node:fs";import*as w from"node:path";function S(m){try{return z.readFileSync(m,"utf8")}catch{return""}}function v(m,y){const d=new Set,p=new Set,h=new Set,u=new Set,A=new Set,f=new Map,c=(t,n,o,a)=>{f.has(t)||f.set(t,{id:t,title:n,reason:o,sourceFiles:new Set}),f.get(t).sourceFiles.add(w.relative(m,a))};for(const t of y){const n=w.relative(m,t).replace(/\\/g,"/"),o=S(t);if(o){if(/\.(ts)$/.test(t)){const a=o.matchAll(/@Component\s*\([^)]*\)[\s\S]*?class\s+([A-Z][A-Za-z0-9_]*Component)/g);for(const e of a){const s=e[1].replace(/Component$/,"");d.add(s);const i=s.endsWith("Page")||s.endsWith("View")?`View${s.replace(/(Page|View)$/,"")}`:`View${s}`;c(i,`View ${s.replace(/([A-Z])/g," $1").trim()}`,`@Component class detected: ${e[1]}`,t)}const l=o.matchAll(/@Injectable[\s\S]*?class\s+([A-Z][A-Za-z0-9_]*Service)/g);for(const e of l)h.add(e[1]);if([...o.matchAll(/FormBuilder|FormGroup|FormControl/g)].length>0){const e=o.matchAll(/['"]([a-zA-Z][a-zA-Z0-9_]*)['"]:\s*(?:this\.\w+\.control|new FormControl|\[)/g);for(const s of e)A.add(s[1])}}if(n.includes("routing")||n.includes("routes")||n.endsWith("app.routes.ts")){const a=o.matchAll(/\bpath\s*:\s*['"`]([^'"`]+)['"`]/g);for(const r of a){const e=r[1].trim();if(e&&e!=="**"&&!e.startsWith(":")){p.add(e);const s=e.split("/").filter(Boolean);if(s.length>=1){const i=s[s.length-1],C="View"+i.charAt(0).toUpperCase()+i.slice(1).replace(/-([a-z])/g,(g,F)=>F.toUpperCase()),$="View "+i.replace(/-/g," ").replace(/\b\w/g,g=>g.toUpperCase());c(C,$,`Route detected: /${e}`,t)}}}const l=o.matchAll(/loadChildren\s*:\s*\(\s*\)\s*=>\s*import\s*\(['"`]([^'"`]+)['"`]\)/g);for(const r of l)u.add(r[1])}if(/\.html$/.test(t)){const a=o.matchAll(/routerLink\s*=\s*['"`]([^'"`]+)['"`]/g);for(const r of a)p.add(r[1].replace(/^\//,""));const l=o.matchAll(/\(click\)\s*=\s*["']([a-zA-Z_][a-zA-Z0-9_]*)\s*\(/g);for(const r of l){const e=r[1];/delete|remove/i.test(e)&&c("DeleteItem","Delete Item",`(click) handler: ${e}`,t),/create|add|new/i.test(e)&&c("CreateItem","Create Item",`(click) handler: ${e}`,t),/submit|save/i.test(e)&&c("UpdateItem","Update Item",`(click) handler: ${e}`,t)}}}}return{components:Array.from(d).sort(),routes:Array.from(p).sort(),services:Array.from(h).sort(),lazyModules:Array.from(u).sort(),formFields:Array.from(A).sort(),capabilities:Array.from(f.values()).map(t=>({...t,sourceFiles:Array.from(t.sourceFiles)}))}}export{v as scanAngular};
+/**
+ * lib/adopters/angular.mjs
+ * Angular-specific scanner for --adopt.
+ * Detects components, routes, services, and UI capabilities from Angular projects.
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+function safeRead(filePath) {
+  try { return fs.readFileSync(filePath, "utf8"); } catch { return ""; }
+}
+
+/**
+ * Scan an Angular project's source files and return detected signals.
+ *
+ * Returns:
+ * {
+ *   components: string[],         // component class names
+ *   routes: string[],             // route paths detected
+ *   services: string[],           // service class names
+ *   lazyModules: string[],        // lazy-loaded module paths
+ *   formFields: string[],         // reactive form control names
+ *   capabilities: { id, title, reason, sourceFiles }[]
+ * }
+ */
+export function scanAngular(cwd, files) {
+  const components = new Set();
+  const routes = new Set();
+  const services = new Set();
+  const lazyModules = new Set();
+  const formFields = new Set();
+  const capabilityMap = new Map(); // capId → { id, title, reason, sourceFiles: Set }
+
+  const addCap = (id, title, reason, filePath) => {
+    if (!capabilityMap.has(id)) {
+      capabilityMap.set(id, { id, title, reason, sourceFiles: new Set() });
+    }
+    capabilityMap.get(id).sourceFiles.add(path.relative(cwd, filePath));
+  };
+
+  for (const filePath of files) {
+    const rel = path.relative(cwd, filePath).replace(/\\/g, "/");
+    const text = safeRead(filePath);
+    if (!text) continue;
+
+    // ── Component detection ───────────────────────────────────────────────
+    if (/\.(ts)$/.test(filePath)) {
+      // @Component decorated classes
+      const compMatches = text.matchAll(/@Component\s*\([^)]*\)[\s\S]*?class\s+([A-Z][A-Za-z0-9_]*Component)/g);
+      for (const m of compMatches) {
+        const name = m[1].replace(/Component$/, "");
+        components.add(name);
+        // Derive a capability from the component name
+        const capId = name.endsWith("Page") || name.endsWith("View")
+          ? `View${name.replace(/(Page|View)$/, "")}`
+          : `View${name}`;
+        addCap(capId, `View ${name.replace(/([A-Z])/g, " $1").trim()}`, `@Component class detected: ${m[1]}`, filePath);
+      }
+
+      // Service classes → often wrap API capabilities
+      const svcMatches = text.matchAll(/@Injectable[\s\S]*?class\s+([A-Z][A-Za-z0-9_]*Service)/g);
+      for (const m of svcMatches) {
+        services.add(m[1]);
+      }
+
+      // Reactive form controls → hint at form-based capabilities
+      const formGroups = text.matchAll(/FormBuilder|FormGroup|FormControl/g);
+      if ([...formGroups].length > 0) {
+        const controlNames = text.matchAll(/['"]([a-zA-Z][a-zA-Z0-9_]*)['"]:\s*(?:this\.\w+\.control|new FormControl|\[)/g);
+        for (const m of controlNames) formFields.add(m[1]);
+      }
+    }
+
+    // ── Route detection ───────────────────────────────────────────────────
+    if (rel.includes("routing") || rel.includes("routes") || rel.endsWith("app.routes.ts")) {
+      // path: 'some/route'
+      const pathMatches = text.matchAll(/\bpath\s*:\s*['"`]([^'"`]+)['"`]/g);
+      for (const m of pathMatches) {
+        const routePath = m[1].trim();
+        if (routePath && routePath !== "**" && !routePath.startsWith(":")) {
+          routes.add(routePath);
+          // Each top-level route = likely a view capability
+          const parts = routePath.split("/").filter(Boolean);
+          if (parts.length >= 1) {
+            const name = parts[parts.length - 1];
+            const capId = "View" + name.charAt(0).toUpperCase() + name.slice(1).replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+            const title = "View " + name.replace(/-/g, " ").replace(/\b\w/g, c => c.toUpperCase());
+            addCap(capId, title, `Route detected: /${routePath}`, filePath);
+          }
+        }
+      }
+
+      // Lazy-loaded modules
+      const lazyMatches = text.matchAll(/loadChildren\s*:\s*\(\s*\)\s*=>\s*import\s*\(['"`]([^'"`]+)['"`]\)/g);
+      for (const m of lazyMatches) lazyModules.add(m[1]);
+    }
+
+    // ── Template-based capability detection (.html) ───────────────────────
+    if (/\.html$/.test(filePath)) {
+      // Router links hint at navigation capabilities
+      const routerLinks = text.matchAll(/routerLink\s*=\s*['"`]([^'"`]+)['"`]/g);
+      for (const m of routerLinks) routes.add(m[1].replace(/^\//, ""));
+
+      // (click) event bindings → actions
+      const clickHandlers = text.matchAll(/\(click\)\s*=\s*["']([a-zA-Z_][a-zA-Z0-9_]*)\s*\(/g);
+      for (const m of clickHandlers) {
+        const handler = m[1];
+        // Heuristic: delete/remove/create handlers → capabilities
+        if (/delete|remove/i.test(handler)) addCap("DeleteItem", "Delete Item", `(click) handler: ${handler}`, filePath);
+        if (/create|add|new/i.test(handler))  addCap("CreateItem", "Create Item", `(click) handler: ${handler}`, filePath);
+        if (/submit|save/i.test(handler))      addCap("UpdateItem", "Update Item", `(click) handler: ${handler}`, filePath);
+      }
+    }
+  }
+
+  return {
+    components: Array.from(components).sort(),
+    routes: Array.from(routes).sort(),
+    services: Array.from(services).sort(),
+    lazyModules: Array.from(lazyModules).sort(),
+    formFields: Array.from(formFields).sort(),
+    capabilities: Array.from(capabilityMap.values()).map(c => ({
+      ...c,
+      sourceFiles: Array.from(c.sourceFiles),
+    })),
+  };
+}

package/dist/lib/adopters/css.mjs

@@ -1 +1,111 @@
-import*as h from"node:fs";import"node:path";function g(c){try{return h.readFileSync(c,"utf8")}catch{return""}}function w(c,l){const t=new Set,a=new Set,s=new Set,d=new Set,f=new Set,m=l.filter(o=>/\.(css|scss|sass|less|styl)$/.test(o)||/\.(ts|tsx|js|jsx)$/.test(o)&&!o.includes("node_modules"));for(const o of m){const i=g(o);if(!i)continue;const u=i.matchAll(/--([a-zA-Z][a-zA-Z0-9_-]*)\s*:/g);for(const e of u){const r=`--${e[1]}`;t.add(r),/color|colour|bg|background|text|border|shadow|fill|stroke/i.test(e[1])?a.add(r):/space|spacing|gap|padding|margin|size|radius|width|height/i.test(e[1])?s.add(r):/theme|primary|secondary|accent|brand|dark|light/i.test(e[1])&&f.add(r)}if(/\.(css|scss|sass|less)$/.test(o)){const e=i.matchAll(/^\s*\.([a-zA-Z][a-zA-Z0-9_-]*)[\s{,]/gm);for(const r of e){const n=r[1];n.length<4||/^(flex|grid|block|hidden|text|font|bg|border|p-|m-|w-|h-)/.test(n)||/^(active|disabled|hover|focus|error|success|warning)$/.test(n)||d.add(n)}}if(/\.(ts|tsx|js|jsx)$/.test(o)){const e=i.matchAll(/(?:styled|css)`[^`]*--([a-zA-Z][a-zA-Z0-9_-]*)\s*:/g);for(const n of e)t.add(`--${n[1]}`);const r=i.matchAll(/\[--([a-zA-Z][a-zA-Z0-9_-]*)\]/g);for(const n of r)t.add(`--${n[1]}`)}}return{designTokens:Array.from(t).sort().slice(0,40),colorTokens:Array.from(a).sort().slice(0,20),spacingTokens:Array.from(s).sort().slice(0,15),componentClasses:Array.from(d).sort().slice(0,30),themeVars:Array.from(f).sort().slice(0,15)}}function y(c,l=[]){const t=s=>l.includes(s),a=s=>s.test(c);return t("tailwindcss")||a(/\b(?:flex|grid|px-\d|py-\d|text-\w+|bg-\w+|rounded)/)?"tailwind":t("bootstrap")||a(/\b(?:container|row|col-|btn btn-|navbar|card)/)?"bootstrap":l.some(s=>s.startsWith("@angular/material"))?"angular-material":t("antd")||a(/\bant-/)?"ant-design":t("@mui/material")||t("@material-ui/core")?"mui":t("styled-components")?"styled-components":t("@emotion/react")||t("@emotion/styled")?"emotion":t("@chakra-ui/react")?"chakra-ui":t("@radix-ui/react-primitive")?"radix-ui":"unknown"}export{y as detectCSSFramework,w as scanCSS};
+/**
+ * lib/adopters/css.mjs
+ * CSS / SCSS / design token scanner for --adopt.
+ * Extracts design tokens, component class names, and UI patterns.
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+function safeRead(filePath) {
+  try { return fs.readFileSync(filePath, "utf8"); } catch { return ""; }
+}
+
+/**
+ * Scan CSS/SCSS/style files for design tokens and UI signals.
+ *
+ * Returns:
+ * {
+ *   designTokens: string[],      // CSS custom properties (--var-name)
+ *   colorTokens: string[],       // tokens that look like colors
+ *   spacingTokens: string[],     // tokens that look like spacing
+ *   componentClasses: string[],  // BEM-style or component-level class names
+ *   themeVars: string[],         // theme-related variables
+ * }
+ */
+export function scanCSS(cwd, files) {
+  const allTokens = new Set();
+  const colorTokens = new Set();
+  const spacingTokens = new Set();
+  const componentClasses = new Set();
+  const themeVars = new Set();
+
+  const styleFiles = files.filter(f =>
+    /\.(css|scss|sass|less|styl)$/.test(f) ||
+    // Also scan JS/TS files for CSS-in-JS (styled-components, emotion)
+    (/\.(ts|tsx|js|jsx)$/.test(f) && !f.includes("node_modules"))
+  );
+
+  for (const filePath of styleFiles) {
+    const text = safeRead(filePath);
+    if (!text) continue;
+
+    // ── CSS custom properties (design tokens) ─────────────────────────────
+    const tokenMatches = text.matchAll(/--([a-zA-Z][a-zA-Z0-9_-]*)\s*:/g);
+    for (const m of tokenMatches) {
+      const token = `--${m[1]}`;
+      allTokens.add(token);
+
+      // Classify by name
+      if (/color|colour|bg|background|text|border|shadow|fill|stroke/i.test(m[1])) {
+        colorTokens.add(token);
+      } else if (/space|spacing|gap|padding|margin|size|radius|width|height/i.test(m[1])) {
+        spacingTokens.add(token);
+      } else if (/theme|primary|secondary|accent|brand|dark|light/i.test(m[1])) {
+        themeVars.add(token);
+      }
+    }
+
+    // ── CSS class names → component hints ────────────────────────────────
+    if (/\.(css|scss|sass|less)$/.test(filePath)) {
+      // BEM block names: .my-component { }
+      const classMatches = text.matchAll(/^\s*\.([a-zA-Z][a-zA-Z0-9_-]*)[\s{,]/gm);
+      for (const m of classMatches) {
+        const cls = m[1];
+        // Skip utility classes (short names, numbers, state classes)
+        if (cls.length < 4) continue;
+        if (/^(flex|grid|block|hidden|text|font|bg|border|p-|m-|w-|h-)/.test(cls)) continue;
+        if (/^(active|disabled|hover|focus|error|success|warning)$/.test(cls)) continue;
+        componentClasses.add(cls);
+      }
+    }
+
+    // ── CSS-in-JS: styled-components / emotion ────────────────────────────
+    if (/\.(ts|tsx|js|jsx)$/.test(filePath)) {
+      // styled.div`...` or styled(Component)`...`
+      const styledMatches = text.matchAll(/(?:styled|css)`[^`]*--([a-zA-Z][a-zA-Z0-9_-]*)\s*:/g);
+      for (const m of styledMatches) allTokens.add(`--${m[1]}`);
+
+      // Tailwind arbitrary values referencing CSS vars: bg-[--color-primary]
+      const tailwindVars = text.matchAll(/\[--([a-zA-Z][a-zA-Z0-9_-]*)\]/g);
+      for (const m of tailwindVars) allTokens.add(`--${m[1]}`);
+    }
+  }
+
+  return {
+    designTokens: Array.from(allTokens).sort().slice(0, 40),
+    colorTokens: Array.from(colorTokens).sort().slice(0, 20),
+    spacingTokens: Array.from(spacingTokens).sort().slice(0, 15),
+    componentClasses: Array.from(componentClasses).sort().slice(0, 30),
+    themeVars: Array.from(themeVars).sort().slice(0, 15),
+  };
+}
+
+/**
+ * Detect which CSS framework is in use from class names and package deps.
+ */
+export function detectCSSFramework(text, externalLibraries = []) {
+  const hasDep = (name) => externalLibraries.includes(name);
+  const hasClass = (pattern) => pattern.test(text);
+
+  if (hasDep("tailwindcss") || hasClass(/\b(?:flex|grid|px-\d|py-\d|text-\w+|bg-\w+|rounded)/)) return "tailwind";
+  if (hasDep("bootstrap") || hasClass(/\b(?:container|row|col-|btn btn-|navbar|card)/)) return "bootstrap";
+  if (externalLibraries.some(d => d.startsWith("@angular/material"))) return "angular-material";
+  if (hasDep("antd") || hasClass(/\bant-/)) return "ant-design";
+  if (hasDep("@mui/material") || hasDep("@material-ui/core")) return "mui";
+  if (hasDep("styled-components")) return "styled-components";
+  if (hasDep("@emotion/react") || hasDep("@emotion/styled")) return "emotion";
+  if (hasDep("@chakra-ui/react")) return "chakra-ui";
+  if (hasDep("@radix-ui/react-primitive")) return "radix-ui";
+  return "unknown";
+}

package/dist/lib/adopters/react.mjs

@@ -1 +1,104 @@
-import*as w from"node:fs";import*as C from"node:path";function k(c){try{return w.readFileSync(c,"utf8")}catch{return""}}function I(c,d){const n=new Set,l=new Set,i=new Set,r=new Map,a=(t,s,m,f)=>{r.has(t)||r.set(t,{id:t,title:s,reason:m,sourceFiles:new Set}),r.get(t).sourceFiles.add(C.relative(c,f))};for(const t of d){if(!/\.(tsx?|jsx?)$/.test(t))continue;const s=k(t);if(!s)continue;const m=s.matchAll(/export\s+(?:default\s+)?function\s+([A-Z][A-Za-z0-9_]*)\s*\(/g);for(const o of m)if(n.add(o[1]),/Page|View|Screen|Dashboard|Panel|Modal|Dialog/i.test(o[1])){const e="View"+o[1].replace(/(Page|View|Screen|Dashboard|Panel|Modal|Dialog)$/,"");a(e,`View ${o[1].replace(/([A-Z])/g," $1").trim()}`,`React component: ${o[1]}`,t)}const f=s.matchAll(/(?:export\s+)?const\s+([A-Z][A-Za-z0-9_]*)\s*=\s*(?:React\.memo\()?(?:\([^)]*\)|[a-zA-Z_]\w*)\s*=>/g);for(const o of f)n.add(o[1]);const p=s.matchAll(/export\s+(?:default\s+)?function\s+(use[A-Z][A-Za-z0-9_]*)\s*\(/g);for(const o of p)l.add(o[1]);const h=s.matchAll(/(?:export\s+)?const\s+(use[A-Z][A-Za-z0-9_]*)\s*=/g);for(const o of h)l.add(o[1]);const u=s.matchAll(/<Route[^>]+path\s*=\s*["'`]([^"'`]+)["'`]/g);for(const o of u){const e=o[1].replace(/^\//,"").replace(/:[\w]+/g,"{id}");e&&i.add(e)}const g=s.matchAll(/path\s*:\s*["'`]([^"'`]+)["'`]/g);for(const o of g){const e=o[1].replace(/^\//,"").replace(/:[\w]+/g,"{id}");e&&e!=="*"&&e.length<60&&i.add(e)}const A=s.matchAll(/onClick\s*=\s*\{(?:[^}]*\b(delete|remove|create|add|submit|save|search|filter|toggle|update|edit)\b[^}]*)\}/gi);for(const o of A){const e=o[1].toLowerCase();(e==="delete"||e==="remove")&&a("DeleteItem","Delete Item",`onClick handler contains "${e}"`,t),(e==="create"||e==="add")&&a("CreateItem","Create Item",`onClick handler contains "${e}"`,t),(e==="submit"||e==="save"||e==="update"||e==="edit")&&a("UpdateItem","Update Item",`onClick handler contains "${e}"`,t),e==="search"&&a("SearchItems","Search Items",'onClick handler contains "search"',t),e==="filter"&&a("FilterItems","Filter Items",'onClick handler contains "filter"',t),e==="toggle"&&a("ToggleComplete","Toggle Complete",'onClick handler contains "toggle"',t)}}return{components:Array.from(n).sort(),customHooks:Array.from(l).sort(),routes:Array.from(i).sort(),capabilities:Array.from(r.values()).map(t=>({...t,sourceFiles:Array.from(t.sourceFiles)}))}}export{I as scanReact};
+/**
+ * lib/adopters/react.mjs
+ * React-specific scanner for --adopt.
+ * Detects components, hooks, routes, and UI capabilities from React projects.
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+function safeRead(filePath) {
+  try { return fs.readFileSync(filePath, "utf8"); } catch { return ""; }
+}
+
+/**
+ * Scan a React project's source files for UI signals.
+ *
+ * Returns:
+ * {
+ *   components: string[],
+ *   customHooks: string[],
+ *   routes: string[],
+ *   capabilities: { id, title, reason, sourceFiles }[]
+ * }
+ */
+export function scanReact(cwd, files) {
+  const components = new Set();
+  const customHooks = new Set();
+  const routes = new Set();
+  const capabilityMap = new Map();
+
+  const addCap = (id, title, reason, filePath) => {
+    if (!capabilityMap.has(id)) {
+      capabilityMap.set(id, { id, title, reason, sourceFiles: new Set() });
+    }
+    capabilityMap.get(id).sourceFiles.add(path.relative(cwd, filePath));
+  };
+
+  for (const filePath of files) {
+    if (!/\.(tsx?|jsx?)$/.test(filePath)) continue;
+    const text = safeRead(filePath);
+    if (!text) continue;
+
+    // ── Component detection ───────────────────────────────────────────────
+    // export default function MyComponent / export function MyComponent
+    const exportFn = text.matchAll(/export\s+(?:default\s+)?function\s+([A-Z][A-Za-z0-9_]*)\s*\(/g);
+    for (const m of exportFn) {
+      components.add(m[1]);
+      // Page/View/Screen/Dashboard components → ViewXxx capability
+      if (/Page|View|Screen|Dashboard|Panel|Modal|Dialog/i.test(m[1])) {
+        const capId = "View" + m[1].replace(/(Page|View|Screen|Dashboard|Panel|Modal|Dialog)$/, "");
+        addCap(capId, `View ${m[1].replace(/([A-Z])/g, " $1").trim()}`, `React component: ${m[1]}`, filePath);
+      }
+    }
+
+    // Arrow function components: const MyComponent = () =>
+    const arrowComp = text.matchAll(/(?:export\s+)?const\s+([A-Z][A-Za-z0-9_]*)\s*=\s*(?:React\.memo\()?(?:\([^)]*\)|[a-zA-Z_]\w*)\s*=>/g);
+    for (const m of arrowComp) {
+      components.add(m[1]);
+    }
+
+    // ── Custom hooks ─────────────────────────────────────────────────────
+    const hookMatches = text.matchAll(/export\s+(?:default\s+)?function\s+(use[A-Z][A-Za-z0-9_]*)\s*\(/g);
+    for (const m of hookMatches) customHooks.add(m[1]);
+
+    const hookArrow = text.matchAll(/(?:export\s+)?const\s+(use[A-Z][A-Za-z0-9_]*)\s*=/g);
+    for (const m of hookArrow) customHooks.add(m[1]);
+
+    // ── Route detection (react-router) ────────────────────────────────────
+    // <Route path="/some/path"  or  path: "/some/path"
+    const routeJsx = text.matchAll(/<Route[^>]+path\s*=\s*["'`]([^"'`]+)["'`]/g);
+    for (const m of routeJsx) {
+      const p = m[1].replace(/^\//, "").replace(/:[\w]+/g, "{id}");
+      if (p) routes.add(p);
+    }
+
+    const routeObj = text.matchAll(/path\s*:\s*["'`]([^"'`]+)["'`]/g);
+    for (const m of routeObj) {
+      const p = m[1].replace(/^\//, "").replace(/:[\w]+/g, "{id}");
+      if (p && p !== "*" && p.length < 60) routes.add(p);
+    }
+
+    // ── Button / action detection ─────────────────────────────────────────
+    const onClicks = text.matchAll(/onClick\s*=\s*\{(?:[^}]*\b(delete|remove|create|add|submit|save|search|filter|toggle|update|edit)\b[^}]*)\}/gi);
+    for (const m of onClicks) {
+      const action = m[1].toLowerCase();
+      if (action === "delete" || action === "remove") addCap("DeleteItem", "Delete Item", `onClick handler contains "${action}"`, filePath);
+      if (action === "create" || action === "add")    addCap("CreateItem", "Create Item", `onClick handler contains "${action}"`, filePath);
+      if (action === "submit" || action === "save" || action === "update" || action === "edit") addCap("UpdateItem", "Update Item", `onClick handler contains "${action}"`, filePath);
+      if (action === "search") addCap("SearchItems", "Search Items", `onClick handler contains "search"`, filePath);
+      if (action === "filter") addCap("FilterItems", "Filter Items", `onClick handler contains "filter"`, filePath);
+      if (action === "toggle") addCap("ToggleComplete", "Toggle Complete", `onClick handler contains "toggle"`, filePath);
+    }
+  }
+
+  return {
+    components: Array.from(components).sort(),
+    customHooks: Array.from(customHooks).sort(),
+    routes: Array.from(routes).sort(),
+    capabilities: Array.from(capabilityMap.values()).map(c => ({
+      ...c,
+      sourceFiles: Array.from(c.sourceFiles),
+    })),
+  };
+}