infernoflow 0.10.16 → 0.10.18

package/README.md

@@ -1,408 +1,97 @@
 # 🔥 infernoflow
-
 > The forge for liquid code — keep capabilities, contracts, and docs in sync with your codebase.
 
 ## What it does
-
-infernoflow ensures that when your code changes, your **capability contracts** and **documentation** stay in sync. It prevents "semantic drift" — where code evolves but no one knows what the system can actually do.
-
-```
-inferno/
-├── contract.json       ← what your system promises to do
-├── capabilities.json   ← registry of each capability
-├── scenarios/          ← test scenarios covering each capability
-└── CHANGELOG.md        ← history of capability changes
-```
+infernoflow ensures that when your code changes, your **capability contracts** and **documentation** stay in sync. It prevents semantic drift — where code evolves but no one knows what the system can actually do.
 
 ## Install
-
 ```bash
 npm install -g infernoflow
-# or use without installing:
+# or:
 npx infernoflow init
 ```
 
 ## Quick Start
-
 ```bash
-# 1. Scaffold in your project root:
 npx infernoflow init
-
-# Optional: same as init, plus Cursor hooks that append each Agent reply
-# to inferno/CONTEXT.draft.md (gitignored). Promote with npm run inferno:promote-draft.
-npx infernoflow init --yes --cursor-hooks
-
-# Optional: VS Code + GitHub Copilot agent hooks (Preview) — same draft file + promote flow
-npx infernoflow init --yes --vscode-copilot-hooks
-
-# Or add hooks to an existing infernoflow project:
-npx infernoflow install-cursor-hooks
-npx infernoflow install-vscode-copilot-hooks
-
-# 2. See your contract health:
+npx infernoflow install-cursor-hooks  # installs MCP server + .cursor/mcp.json
+# Restart Cursor → Settings → MCP → infernoflow: 4 tools enabled
 infernoflow status
-
-# 3. When you add a feature, let AI update the docs:
-infernoflow suggest "added email notifications and user profiles"
-
-# 4. Validate everything:
+infernoflow suggest "added email notifications"
 infernoflow check
-
-# 5. In CI / pre-push hook:
-infernoflow doc-gate
-```
-
-## Adopt Existing Project
-
-Use this when your project already has code and you want InfernoFlow to bootstrap from current behavior.
-
-```bash
-# from existing project root
-infernoflow init --adopt
-```
-
-Non-interactive adoption:
-
-```bash
-infernoflow init --adopt --yes
-```
-
-Override detected stack during adoption:
-
-```bash
-infernoflow init --adopt --lang ts --framework angular --project-type frontend
-```
-
-C# / ASP.NET example:
-
-```bash
-infernoflow init --adopt --lang cs --framework aspnet --project-type backend --report-human-only
-```
-
-JSON report for CI/logging:
-
-```bash
-infernoflow init --adopt --yes --report-json
 ```
 
-JSON-only output (clean machine output, no text logs):
+## Cursor MCP Integration (recommended)
 
-```bash
-infernoflow init --adopt --yes --report-json-only
-```
-
-Human-only output (visual report only, no JSON block):
+After running `install-cursor-hooks`, infernoflow registers as an MCP server inside Cursor. No copy/paste — Cursor calls infernoflow tools directly in chat.
 
+### Setup
 ```bash
-infernoflow init --adopt --yes --report-human-only
+infernoflow install-cursor-hooks
+# Restart Cursor
+# Settings → MCP → infernoflow: 4 tools enabled
 ```
 
-What adoption creates:
-- `inferno/contract.json` (inferred capability baseline)
-- `inferno/capabilities.json` (inferred registry)
-- `inferno/scenarios/adoption_baseline.json` (coverage baseline)
-- `inferno/adoption_profile.json` (detected components, display fields, external libraries, UI layout, styling hints)
-- `inferno/adoption_profile.json` (detected components, display fields, external libraries, UI layout, styling hints, API call map)
-- `inferno/context-state.json` (saved development profile: language/framework/project type)
-- `inferno/CHANGELOG.md` (adoption entry)
-
-Safety:
-- Existing `inferno/` is not overwritten unless `--force` is provided.
-- Adoption prints an inferred capability report with source-file hints and confidence.
-
-## Recommended Workflow
-
-```bash
-# start a feature
-infernoflow context --intent "add search to tasks" --working "frontend search UX"
-
-# generate implementation prompt(s) for coding agent
-infernoflow implement "add server-side task search endpoint" --mode both
-
-# build code changes
-
-# sync inferno contract with AI assistance
-infernoflow suggest "added task search by title and due date"
-
-# verify no drift
-infernoflow status
-infernoflow check
-```
-
-## Team SOP (Developer Workflow)
-
-Use this checklist for every feature branch:
+### MCP tools
 
-1) **Set intent**
-```bash
-infernoflow context --intent "what feature is being built" --working "current slice"
-```
-
-2) **Build code**
-- Implement UI/API/tests as usual.
+| Tool | What it does |
+|---|---|
+| `infernoflow_run` | Generates a task prompt from your contract |
+| `infernoflow_apply` | Applies the JSON response — updates contract + CHANGELOG |
+| `infernoflow_check` | Validates contract sync |
+| `infernoflow_status` | Shows contract health |
 
-3) **Sync contract with `suggest`**
-```bash
-infernoflow suggest "plain-language description of what changed"
+### Workflow in Cursor chat
 ```
-- Paste generated prompt into your AI.
-- Paste AI JSON back into terminal.
-- Approve with `y` only after preview looks correct.
-
-4) **Validate before commit**
-```bash
-infernoflow status
-infernoflow check
+You: Use infernoflow_run with task "add search functionality"
+Cursor: [calls infernoflow_run → returns prompt]
+Cursor: [generates JSON]
+Cursor: [calls infernoflow_apply]
+→ contract.json, capabilities.json, CHANGELOG.md updated + validated
 ```
 
-5) **CI-safe checks**
+### Terminal fallback (without MCP)
 ```bash
-infernoflow status --json
-infernoflow check --json
-infernoflow doc-gate --json
+infernoflow run "add search functionality"
+# writes inferno/agent-prompt.md and waits
+# paste prompt into Cursor/Claude → save JSON to inferno/agent-response.json
+# infernoflow picks it up and applies automatically
 ```
 
-6) **Definition of done**
-- Capability changes are reflected in `inferno/contract.json`.
-- New/changed capabilities exist in `inferno/capabilities.json`.
-- Scenario coverage updated under `inferno/scenarios/`.
-- `inferno/CHANGELOG.md` updated under `## Unreleased`.
-- `infernoflow check` passes.
-
 ## Commands
 
 | Command | Description |
 |---|---|
-| `infernoflow init` | Interactive scaffold — creates `inferno/` in your project |
-| `infernoflow status` | At-a-glance health of your contract |
-| `infernoflow suggest` | Generate an AI prompt, apply capability updates |
-| `infernoflow implement` | Generate implementation prompts for coding agents |
-| `infernoflow run` | One-command local-model flow with validation and rollback |
-| `infernoflow pr-impact` | Analyze changed files and infer capability/doc drift |
-| `infernoflow sync --auto` | Deterministic sync flow for agents (skeleton) |
-| `infernoflow check` | Full validation: contract, capabilities, scenarios, changelog |
-| `infernoflow doc-gate` | Fails if code changed but docs weren't updated |
-| `infernoflow context` | Build/persist AI session context for this project |
-| `infernoflow install-cursor-hooks` | Install `.cursor/hooks` + `scripts/inferno-promote-draft.mjs` (Agent → draft → promote) |
-| `infernoflow install-vscode-copilot-hooks` | Install `.github/hooks` for VS Code + Copilot (Preview) + same promote script |
-
-### Cursor hooks (draft → promote)
-
-[Cursor hooks](https://cursor.com/docs/agent/hooks) can run a small Node script after each assistant message. infernoflow can install:
-
-- **`.cursor/hooks.json`** — `afterAgentResponse` and `stop` events
-- **`.cursor/hooks/inferno-session-draft.mjs`** — appends assistant `text` to **`inferno/CONTEXT.draft.md`** (never overwrites `CONTEXT.md` automatically)
-- **`scripts/inferno-promote-draft.mjs`** + **`npm run inferno:promote-draft`** — preview, `--append-notes` (merge under `## Decisions & notes` in `inferno/CONTEXT.md`), or `--clear`
-- **`.gitignore`** entry for `inferno/CONTEXT.draft.md` when possible
-
-Install with **`infernoflow install-cursor-hooks`** or **`infernoflow init --cursor-hooks`**. Restart Cursor after install. Review the draft before promoting; treat chat as **input**, not product truth.
-
-### VS Code + GitHub Copilot hooks (draft → promote, Preview)
-
-VS Code can run [Agent hooks](https://code.visualstudio.com/docs/copilot/customization/hooks) from **`.github/hooks/*.json`**. infernoflow installs:
-
-- **`.github/hooks/infernoflow-drafts.json`** — wires **`UserPromptSubmit`** (your prompt) and **`Stop`** (end of agent turn)
-- **`scripts/inferno-vscode-copilot-hook.mjs`** — appends the user prompt on submit; on **Stop**, reads **`transcript_path`** from stdin (when present), parses **JSONL** or session **JSON**, and appends the **last assistant text** it can infer (format varies by VS Code / Copilot version — if parsing fails, a short marker is still appended)
-- The same **`inferno:promote-draft`** script and **`.gitignore`** entry for **`inferno/CONTEXT.draft.md`** as the Cursor flow
-
-Install with **`infernoflow install-vscode-copilot-hooks`** or **`infernoflow init --vscode-copilot-hooks`**. Restart VS Code, confirm your org allows hooks, and use the **GitHub Copilot Chat Hooks** output channel for diagnostics.
-
-**Limitations:** Hooks are **Preview**; `transcript_path` / JSONL shape may differ by build; some hook events omit `transcript_path` ([vscode#300583](https://github.com/microsoft/vscode/issues/300583)). You still have the full **`infernoflow`** CLI in the terminal when hooks are not enough.
-
-### Options
-
-```bash
-infernoflow init --force       # overwrite existing files
-infernoflow init --cursor-hooks # with init: install Cursor draft hooks (see above)
-infernoflow init --vscode-copilot-hooks # with init: install VS Code + Copilot draft hooks (Preview)
-infernoflow init --yes         # skip prompts, use defaults
-infernoflow init --adopt       # infer baseline from existing project
-infernoflow init --adopt --lang ts --framework react --project-type frontend
-infernoflow init --adopt --report-human-only
-infernoflow suggest "..."      # describe what changed
-infernoflow implement "..." --mode both
-infernoflow implement "..." --mode cursor
-infernoflow implement "..." --mode generic
-infernoflow implement "..." --mode both --copy
-infernoflow run "add favorite badge to tasks"
-infernoflow run "sync check" --dry-run
-infernoflow run "sync check" --json
-infernoflow pr-impact
-infernoflow pr-impact --json
-infernoflow sync --auto
-infernoflow sync --auto --json
-npm run inferno:hooks      # install local git hooks (after init)
-infernoflow install-cursor-hooks --force  # overwrite hook files if present
-infernoflow install-vscode-copilot-hooks --force
-infernoflow check --json       # machine-readable output for CI
-infernoflow check --skip-doc-gate
-infernoflow status --json      # machine-readable status summary
-infernoflow doc-gate --json    # machine-readable doc-gate result
-```
-
-## `infernoflow suggest` — AI-powered updates
-
-When you add a feature, just describe it in plain language. infernoflow generates a prompt you can paste into **any AI** (Claude, ChatGPT, Copilot, Cursor, etc.), then applies the suggested changes automatically.
-
-```bash
-infernoflow suggest "added payment processing and invoice generation"
-```
-
-**What happens:**
-1. infernoflow reads your current contract state
-2. Generates a structured prompt with full context
-3. You paste it into your AI of choice
-4. Paste the JSON response back
-5. infernoflow previews the changes and asks for confirmation
-6. On approval — updates `contract.json`, `capabilities.json`, `scenarios/`, and `CHANGELOG.md`
-
-**Example output:**
-```
-Proposed Changes
-
-  Summary: Added payment processing and invoice generation functionality.
-
-  + New capabilities:
-      ProcessPayment — Process Payment
-      GenerateInvoice — Generate Invoice
-
-  ~ Scenario updates:
-      [update] happy_path.json
-
-  📝 Changelog: - Add payment processing and invoice generation capabilities.
-
-  Apply these changes? (y/n)
-```
-
-Works with any AI — Claude, ChatGPT, GitHub Copilot, Cursor, or your own setup.
-
-## `infernoflow run` — zero copy/paste flow
-
-Run one command and infernoflow will:
-1. Detect drift (`pr-impact`)
-2. Resolve provider (`auto` defaults to IDE agent)
-3. Generate suggestion
-4. Apply inferno updates
-5. Validate with `check`
-6. Roll back automatically if validation fails
-
-```bash
-infernoflow run "add favorite badge to tasks and filter by favorite"
-```
-
-Machine mode:
-
-```bash
-infernoflow run "sync check" --json
-```
-
-Provider options:
-
-```bash
-infernoflow run "task" --provider auto                # default (IDE agent first)
-infernoflow run "task" --provider agent --ide cursor  # require IDE agent
-infernoflow run "task" --provider local               # explicit local model
-infernoflow run "task" --provider prompt              # deterministic prompt fallback
-```
-
-IDE routing behavior:
-- `auto` + agent available -> uses IDE agent
-- `auto` + no agent -> falls back to prompt mode (`FALLBACK_PROMPT_MODE`)
-- `agent` + no agent -> exits with `EXPLICIT_AGENT_REQUIRED`
-
-Local model configuration (optional):
-
-```bash
-# local provider example: ollama
-set INFERNO_LOCAL_PROVIDER=ollama
-set INFERNO_LOCAL_ENDPOINT=http://127.0.0.1:11434/api/generate
-set INFERNO_LOCAL_MODEL=llama3.1:8b
-```
-
-Optional OpenAI-compatible local server:
-
-```bash
-set INFERNO_LOCAL_PROVIDER=openai
-set INFERNO_LOCAL_ENDPOINT=http://127.0.0.1:1234/v1/chat/completions
-set INFERNO_LOCAL_MODEL=local-model
-set INFERNO_LOCAL_API_KEY=local
-```
-
-## `infernoflow implement` — code-agent execution prompts
-
-Generate coding prompts from your project context and inferno contract:
-
-```bash
-infernoflow implement "add pagination to tasks" --mode both
-```
-
-Modes:
-- `--mode cursor`: Cursor-specific coding prompt
-- `--mode generic`: generic prompt for any coding agent
-- `--mode both`: print both sections (default)
-- `--copy`: copy selected prompt output to clipboard
-
-Recommended chain:
-1) `infernoflow context --intent "..."`
-2) `infernoflow implement "..."`
-3) run the coding agent and apply code changes
-4) `infernoflow suggest "..."`
-5) `infernoflow check`
-
-## Troubleshooting
-
-- `Unknown command: suggest`:
-  - Run `infernoflow --help` and confirm `suggest` appears.
-  - If using `npx`, force a specific version: `npx infernoflow@latest --help`.
-- `infernoflow: command not found`:
-  - Use `npx infernoflow ...` or install globally: `npm install -g infernoflow`.
-- `npm publish` fails with existing version:
-  - Bump version first (`npm version patch|minor|major`) then publish.
-- `status` or `check` fails due to missing inferno files:
-  - Run `infernoflow init` at project root.
-- Windows/Git Bash path confusion:
-  - Prefer `node bin/infernoflow.mjs --help` from package root for local debugging.
-
-## Why infernoflow?
-
-**The problem:** AI-assisted development moves fast. Code changes daily. But what does the system *actually do*? What changed? What's covered?
-
-**The metaphor:** A forge (כיבשן). Metal becomes liquid — flexible, shapeable. The forge is the controlled environment where that change happens safely, with molds (contracts) and tempering (validation).
-
-**The principle:** Liquid where you want flexibility. Solid where you need safety.
+| `infernoflow init` | Scaffold inferno/ in your project |
+| `infernoflow install-cursor-hooks` | MCP server + hooks + .cursor/mcp.json |
+| `infernoflow install-vscode-copilot-hooks` | VS Code + Copilot hooks (Preview) |
+| `infernoflow status` | Contract health at a glance |
+| `infernoflow check` | Full validation |
+| `infernoflow suggest` | AI-powered contract update |
+| `infernoflow run` | One-command flow with rollback |
+| `infernoflow implement` | Generate coding agent prompts |
+| `infernoflow context` | Build AI session context |
+| `infernoflow doc-gate` | Fail if docs not updated |
+| `infernoflow pr-impact` | Analyze PR capability drift |
 
 ## CI Integration
-
 ```yaml
-# .github/workflows/ci.yml
-- name: infernoflow run (headless)
-  run: npx infernoflow run "sync check" --provider prompt --json
-  env:
-    BASE_SHA: ${{ github.event.pull_request.base.sha }}
-    HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+- name: infernoflow check
+  run: npx infernoflow check --json
+- name: infernoflow doc-gate
+  run: npx infernoflow doc-gate --json
 ```
 
-When you run `infernoflow init`, it now scaffolds:
-- `scripts/inferno-install-hooks.mjs`
-- `.github/workflows/infernoflow-check.yml`
-
-Install local hooks once per clone:
-
-```bash
-npm run inferno:hooks
-```
+## Troubleshooting
 
-## Release Checklist
+- **MCP not showing in Cursor** — restart Cursor completely after install-cursor-hooks
+- `ide_agent_bridge_not_configured` — use MCP tools in Cursor chat instead
+- **infernoflow not found** — use `npx infernoflow` or install globally
+- **PowerShell scripts disabled** — run `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass`
 
-```bash
-npm test
-npm pack --dry-run
-node bin/infernoflow.mjs --help
-node bin/infernoflow.mjs check --help
-```
+## Why infernoflow?
 
-Then bump version and publish.
+AI-assisted development moves fast. Code changes daily. But what does the system *actually do*? infernoflow keeps the answer current — automatically.
 
 ## License
-
-MIT
+MIT

package/dist/bin/infernoflow.mjs

@@ -1,16 +1,20 @@
 #!/usr/bin/env node
-import{readFileSync as d}from"node:fs";import{dirname as m,join as f}from"node:path";import{fileURLToPath as u}from"node:url";import{bold as e,gray as t,red as r}from"../lib/ui/output.mjs";const h=m(u(import.meta.url)),y=JSON.parse(d(f(h,"..","package.json"),"utf8")),i=y.version||"0.0.0",s={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"},c={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)};function g(){const o=Object.keys(s),l=Math.max(...o.map(a=>a.length),8)+1;return Object.entries(s).map(([a,p])=>`    ${a.padEnd(l," ")}${p}`).join(`
+import{readFileSync as d}from"node:fs";import{dirname as m,join as f}from"node:path";import{fileURLToPath as u}from"node:url";import{bold as t,gray as e,red as a}from"../lib/ui/output.mjs";const h=m(u(import.meta.url)),y=JSON.parse(d(f(h,"..","package.json"),"utf8")),i=y.version||"0.0.0",c={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={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 g(){const o=Object.keys(c),s=Math.max(...o.map(r=>r.length),8)+1;return Object.entries(c).map(([r,p])=>`    ${r.padEnd(s," ")}${p}`).join(`
 `)}const w=`
-  ${e("\u{1F525} infernoflow")} ${t("v"+i)}
-  ${t("The forge for liquid code \u2014 keep every AI session in sync")}
+  ${t("\u{1F525} infernoflow")} ${e("v"+i)}
+  ${e("The forge for liquid code \u2014 keep every AI session in sync")}
 
-  ${e("Usage:")}
+  ${t("Usage:")}
     infernoflow <command> [options]
 
-  ${e("Commands:")}
+  ${t("Commands:")}
 ${g()}
 
-  ${e("init options:")}
+  ${t("setup options:")}
+    --yes, -y           Skip prompts (non-interactive)
+    --force, -f         Overwrite existing hook files
+
+  ${t("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)
     --adopt             Infer capabilities from an existing codebase
@@ -23,46 +27,52 @@ ${g()}
     --yes, -y           Skip prompts and accept inferred/default values
     --force, -f         Overwrite existing inferno/ files
 
-  ${e("install-cursor-hooks options:")}
+  ${t("install-cursor-hooks options:")}
     --force, -f         Overwrite .cursor/hooks.json and hook scripts if they exist
 
-  ${e("install-vscode-copilot-hooks options:")}
+  ${t("install-vscode-copilot-hooks options:")}
     --force, -f         Overwrite .github/hooks/infernoflow-drafts.json and scripts if they exist
 
-  ${e("context options:")}
+  ${t("context options:")}
     --intent  "..."     What you plan to build next
     --working "..."     What you are building right now
     --decision "..."    Record a decision or note
     --show              Print context without writing file
     --copy, -c          Copy context to clipboard instantly
     --reset             Clear all stored state
+    --watch             Poll git diff every 30s and auto-update CONTEXT.md (living context)
+    --interval <secs>   Watch poll interval in seconds (default: 30)
+
+  ${t("generate-skills options:")}
+    --cursor            Also install rules to .cursor/rules/infernoflow.md
+    --force, -f         Overwrite existing generated skill files
 
-  ${e("implement options:")}
+  ${t("implement options:")}
     --mode <type>       cursor | generic | both (default: both)
     --copy, -c          Copy generated prompt(s) to clipboard
 
-  ${e("run options:")}
+  ${t("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")}
+  ${t("Typical workflow:")}
+    ${e('1. infernoflow context --intent "what I want to build"')}
+    ${e("2. [paste inferno/CONTEXT.md into Claude / Cursor / Copilot]")}
+    ${e("3. [build the feature]")}
+    ${e('4. infernoflow suggest "what I built"')}
+    ${e("5. infernoflow check")}
 
-  ${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')}
-`,[,,n,...k]=process.argv;(!n||n==="--help"||n==="-h")&&(console.log(w),process.exit(0)),(n==="--version"||n==="-v")&&(console.log(i),process.exit(0));const C=Object.keys(c);C.includes(n)||(console.error(r(`
-Unknown command: ${n}`)),console.error(t(`Run: infernoflow --help
-`)),process.exit(1));const b=[n,...k];c[n](b).catch(o=>{console.error(r(`
+  ${t("Machine output:")}
+    ${e("status --json")}
+    ${e("check --json")}
+    ${e("doc-gate --json")}
+    ${e("pr-impact --json")}
+    ${e("sync --auto --json")}
+    ${e('run "task" --json')}
+`;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"),r=process.argv[2];r&&!r.startsWith("-")&&s(o,r)}}catch{}const[,,n,...v]=process.argv;(!n||n==="--help"||n==="-h")&&(console.log(w),process.exit(0)),(n==="--version"||n==="-v")&&(console.log(i),process.exit(0));const b=Object.keys(l);b.includes(n)||(console.error(a(`
+Unknown command: ${n}`)),console.error(e(`Run: infernoflow --help
+`)),process.exit(1));const $=[n,...v];l[n]($).catch(o=>{console.error(a(`
 Error: `)+o.message),process.exit(1)});

package/dist/lib/adopters/angular.mjs

@@ -0,0 +1 @@
+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};

package/dist/lib/adopters/css.mjs

@@ -0,0 +1 @@
+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};

package/dist/lib/adopters/react.mjs

@@ -0,0 +1 @@
+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};