infernoflow 0.33.0 → 0.34.0

package/dist/lib/commands/export.mjs

@@ -1,10 +1,239 @@
-import*as d from"node:fs";import*as a from"node:path";import{done as w,warn as u,bold as l,cyan as k,gray as h}from"../ui/output.mjs";function v(t){for(const o of["contract.json","capabilities.json"]){const n=a.join(t,o);if(d.existsSync(n))try{return JSON.parse(d.readFileSync(n,"utf8"))}catch{}}return null}function O(t){return(t?.capabilities||[]).map(n=>typeof n=="string"?{id:n,description:"",tags:[],status:"active"}:{id:n.id||n.name||"unknown",description:n.description||"",tags:n.tags||[],status:n.status||"active",since:n.since||"",owner:n.owner||""})}function x(t){const o=a.join(a.dirname(t),"package.json");try{const n=JSON.parse(d.readFileSync(o,"utf8"));return{name:n.name||"my-service",version:n.version||"0.0.0",description:n.description||""}}catch{return{name:a.basename(a.dirname(t)),version:"0.0.0",description:""}}}function C(t,o){const n={};for(const e of t){const i=`/${e.id.replace(/_/g,"-")}`;n[i]={get:{operationId:e.id,summary:e.description||e.id,tags:e.tags.length?e.tags:[o.name],parameters:[],responses:{200:{description:"Success",content:{"application/json":{schema:{type:"object"}}}},401:{description:"Unauthorized"},500:{description:"Internal Server Error"}}}}}return JSON.stringify({openapi:"3.1.0",info:{title:o.name,version:o.version,description:o.description||`Capability contract for ${o.name}`},paths:n,components:{schemas:{},securitySchemes:{}}},null,2)}function N(t,o){const n=[...new Set(t.flatMap(i=>i.tags))].slice(0,10);return["apiVersion: backstage.io/v1alpha1","kind: Component","metadata:",`  name: ${o.name}`,`  description: "${(o.description||o.name).replace(/"/g,'\\"')}"`,"  annotations:",`    infernoflow/capability-count: "${t.length}"`,`    infernoflow/generated-at: "${new Date().toISOString()}"`,n.length?`  tags:
-${n.map(i=>`    - ${i}`).join(`
-`)}`:"","spec:","  type: service","  lifecycle: production","  owner: team-default","  providesApis: []","---","# Capabilities",...t.map(i=>[`# ${i.id}`,`#   ${i.description||"(no description)"}`,`#   tags: ${i.tags.join(", ")||"none"}`,`#   status: ${i.status}`].join(`
-`))].filter(Boolean).join(`
-`)+`
-`}function J(t){const o=["id","description","tags","status","since","owner"],n=t.map(e=>[e.id,(e.description||"").replace(/"/g,'""'),e.tags.join("|"),e.status,e.since,e.owner].map(i=>`"${i}"`).join(","));return[o.join(","),...n].join(`
-`)+`
-`}function I(t,o){return[`# ${o.name} \u2014 Capability Contract`,"",`> Generated by infernoflow on ${new Date().toISOString().slice(0,10)}`,`> ${t.length} capabilities tracked`,"","| Capability | Description | Tags | Status |","|---|---|---|---|",...t.map(e=>`| \`${e.id}\` | ${e.description||""} | ${e.tags.join(", ")||"\u2014"} | ${e.status} |`),""].join(`
-`)}function A(t,o){return JSON.stringify({name:o.name,version:o.version,exportedAt:new Date().toISOString(),capabilities:t},null,2)+`
-`}const S={openapi:"openapi.json",backstage:"catalog-info.yaml",csv:"capabilities.csv",markdown:"capabilities.md",json:"capabilities-export.json"};async function D(t){const o=t.slice(1),n=o.includes("--json"),e=process.cwd(),i=a.join(e,"inferno");if(!d.existsSync(i)){const s="inferno/ not found. Run: infernoflow init";n?console.log(JSON.stringify({ok:!1,error:s})):u(s),process.exit(1)}const m=o.indexOf("--format"),p=m!==-1?o[m+1]:null,b=o.indexOf("--out"),$=b!==-1?o[b+1]:null,y=Object.keys(S);if(!p||!y.includes(p)){const s=`Usage: infernoflow export --format <${y.join("|")}> [--out <path>]`;n?console.log(JSON.stringify({ok:!1,error:s})):(u(s),console.log(),console.log(`  ${h("Available formats:")}`),console.log(`  ${l("openapi")}   \u2014 OpenAPI 3.1 JSON with a stub path per capability`),console.log(`  ${l("backstage")} \u2014 Backstage catalog-info.yaml component definition`),console.log(`  ${l("csv")}       \u2014 Spreadsheet-ready CSV`),console.log(`  ${l("markdown")} \u2014 Confluence/Notion table`),console.log(`  ${l("json")}      \u2014 Clean normalised JSON`),console.log());return}const j=v(i);if(!j){const s="No contract.json or capabilities.json found.";n?console.log(JSON.stringify({ok:!1,error:s})):u(s),process.exit(1)}const r=O(j),f=x(i),g=$||a.join(e,S[p]);let c;switch(p){case"openapi":c=C(r,f);break;case"backstage":c=N(r,f);break;case"csv":c=J(r);break;case"markdown":c=I(r,f);break;case"json":c=A(r,f);break}d.writeFileSync(g,c),n?console.log(JSON.stringify({ok:!0,format:p,file:g,capabilities:r.length})):(w(`Exported ${l(String(r.length))} capabilities \u2192 ${k(a.relative(e,g))}`),console.log())}export{D as exportCommand};
+/**
+ * infernoflow export
+ *
+ * Export the capability contract to external formats so it can travel
+ * outside the repo — into API docs, service catalogs, spreadsheets, wikis.
+ *
+ * Formats:
+ *   openapi      OpenAPI 3.1 JSON (stubs for each capability)
+ *   backstage    Backstage catalog-info.yaml
+ *   csv          Spreadsheet-ready CSV
+ *   markdown     Confluence/Notion-ready Markdown table
+ *   json         Clean JSON (normalised, no internal infernoflow fields)
+ *
+ * Usage:
+ *   infernoflow export --format openapi
+ *   infernoflow export --format backstage --out catalog-info.yaml
+ *   infernoflow export --format csv --out capabilities.csv
+ *   infernoflow export --format markdown
+ *   infernoflow export --format json --out contract-export.json
+ */
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+import { done, warn, info, bold, cyan, gray } from "../ui/output.mjs";
+
+// ── Contract reader ───────────────────────────────────────────────────────────
+
+function readContract(infernoDir) {
+  for (const f of ["contract.json", "capabilities.json"]) {
+    const p = path.join(infernoDir, f);
+    if (!fs.existsSync(p)) continue;
+    try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch {}
+  }
+  return null;
+}
+
+function normaliseCaps(contract) {
+  const raw = contract?.capabilities || [];
+  return raw.map(c => {
+    if (typeof c === "string") return { id: c, description: "", tags: [], status: "active" };
+    return {
+      id:          c.id || c.name || "unknown",
+      description: c.description || "",
+      tags:        c.tags || [],
+      status:      c.status || "active",
+      since:       c.since || "",
+      owner:       c.owner || "",
+    };
+  });
+}
+
+function readMeta(infernoDir) {
+  const pkgPath = path.join(path.dirname(infernoDir), "package.json");
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return { name: pkg.name || "my-service", version: pkg.version || "0.0.0", description: pkg.description || "" };
+  } catch {
+    return { name: path.basename(path.dirname(infernoDir)), version: "0.0.0", description: "" };
+  }
+}
+
+// ── Formatters ────────────────────────────────────────────────────────────────
+
+function toOpenApi(caps, meta) {
+  const paths = {};
+  for (const cap of caps) {
+    const route = `/${cap.id.replace(/_/g, "-")}`;
+    paths[route] = {
+      get: {
+        operationId: cap.id,
+        summary:     cap.description || cap.id,
+        tags:        cap.tags.length ? cap.tags : [meta.name],
+        parameters:  [],
+        responses: {
+          "200": { description: "Success", content: { "application/json": { schema: { type: "object" } } } },
+          "401": { description: "Unauthorized" },
+          "500": { description: "Internal Server Error" },
+        },
+      },
+    };
+  }
+
+  return JSON.stringify({
+    openapi: "3.1.0",
+    info: {
+      title:       meta.name,
+      version:     meta.version,
+      description: meta.description || `Capability contract for ${meta.name}`,
+    },
+    paths,
+    components: { schemas: {}, securitySchemes: {} },
+  }, null, 2);
+}
+
+function toBackstage(caps, meta) {
+  const tags = [...new Set(caps.flatMap(c => c.tags))].slice(0, 10);
+  const lines = [
+    `apiVersion: backstage.io/v1alpha1`,
+    `kind: Component`,
+    `metadata:`,
+    `  name: ${meta.name}`,
+    `  description: "${(meta.description || meta.name).replace(/"/g, '\\"')}"`,
+    `  annotations:`,
+    `    infernoflow/capability-count: "${caps.length}"`,
+    `    infernoflow/generated-at: "${new Date().toISOString()}"`,
+    tags.length ? `  tags:\n${tags.map(t => `    - ${t}`).join("\n")}` : "",
+    `spec:`,
+    `  type: service`,
+    `  lifecycle: production`,
+    `  owner: team-default`,
+    `  providesApis: []`,
+    `---`,
+    `# Capabilities`,
+    ...caps.map(c => [
+      `# ${c.id}`,
+      `#   ${c.description || "(no description)"}`,
+      `#   tags: ${c.tags.join(", ") || "none"}`,
+      `#   status: ${c.status}`,
+    ].join("\n")),
+  ].filter(Boolean);
+  return lines.join("\n") + "\n";
+}
+
+function toCsv(caps) {
+  const header = ["id", "description", "tags", "status", "since", "owner"];
+  const rows   = caps.map(c => [
+    c.id,
+    (c.description || "").replace(/"/g, '""'),
+    c.tags.join("|"),
+    c.status,
+    c.since,
+    c.owner,
+  ].map(v => `"${v}"`).join(","));
+  return [header.join(","), ...rows].join("\n") + "\n";
+}
+
+function toMarkdown(caps, meta) {
+  const lines = [
+    `# ${meta.name} — Capability Contract`,
+    ``,
+    `> Generated by infernoflow on ${new Date().toISOString().slice(0, 10)}`,
+    `> ${caps.length} capabilities tracked`,
+    ``,
+    `| Capability | Description | Tags | Status |`,
+    `|---|---|---|---|`,
+    ...caps.map(c =>
+      `| \`${c.id}\` | ${c.description || ""} | ${c.tags.join(", ") || "—"} | ${c.status} |`
+    ),
+    ``,
+  ];
+  return lines.join("\n");
+}
+
+function toCleanJson(caps, meta) {
+  return JSON.stringify({
+    name:        meta.name,
+    version:     meta.version,
+    exportedAt:  new Date().toISOString(),
+    capabilities: caps,
+  }, null, 2) + "\n";
+}
+
+// ── Entry ─────────────────────────────────────────────────────────────────────
+
+const FORMAT_EXT = {
+  openapi:   "openapi.json",
+  backstage: "catalog-info.yaml",
+  csv:       "capabilities.csv",
+  markdown:  "capabilities.md",
+  json:      "capabilities-export.json",
+};
+
+export async function exportCommand(rawArgs) {
+  const args      = rawArgs.slice(1);
+  const jsonMode  = args.includes("--json");
+  const cwd       = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+
+  if (!fs.existsSync(infernoDir)) {
+    const msg = "inferno/ not found. Run: infernoflow init";
+    if (jsonMode) console.log(JSON.stringify({ ok: false, error: msg }));
+    else warn(msg);
+    process.exit(1);
+  }
+
+  const fmtIdx   = args.indexOf("--format");
+  const format   = fmtIdx !== -1 ? args[fmtIdx + 1] : null;
+  const outIdx   = args.indexOf("--out");
+  const outArg   = outIdx !== -1 ? args[outIdx + 1] : null;
+
+  const validFormats = Object.keys(FORMAT_EXT);
+
+  if (!format || !validFormats.includes(format)) {
+    const msg = `Usage: infernoflow export --format <${validFormats.join("|")}> [--out <path>]`;
+    if (jsonMode) console.log(JSON.stringify({ ok: false, error: msg }));
+    else {
+      warn(msg);
+      console.log();
+      console.log(`  ${gray("Available formats:")}`);
+      console.log(`  ${bold("openapi")}   — OpenAPI 3.1 JSON with a stub path per capability`);
+      console.log(`  ${bold("backstage")} — Backstage catalog-info.yaml component definition`);
+      console.log(`  ${bold("csv")}       — Spreadsheet-ready CSV`);
+      console.log(`  ${bold("markdown")} — Confluence/Notion table`);
+      console.log(`  ${bold("json")}      — Clean normalised JSON`);
+      console.log();
+    }
+    return;
+  }
+
+  const contract = readContract(infernoDir);
+  if (!contract) {
+    const msg = "No contract.json or capabilities.json found.";
+    if (jsonMode) console.log(JSON.stringify({ ok: false, error: msg }));
+    else warn(msg);
+    process.exit(1);
+  }
+
+  const caps = normaliseCaps(contract);
+  const meta = readMeta(infernoDir);
+  const outPath = outArg || path.join(cwd, FORMAT_EXT[format]);
+
+  let output;
+  switch (format) {
+    case "openapi":   output = toOpenApi(caps, meta);   break;
+    case "backstage": output = toBackstage(caps, meta); break;
+    case "csv":       output = toCsv(caps);             break;
+    case "markdown":  output = toMarkdown(caps, meta);  break;
+    case "json":      output = toCleanJson(caps, meta); break;
+  }
+
+  fs.writeFileSync(outPath, output);
+
+  if (jsonMode) {
+    console.log(JSON.stringify({ ok: true, format, file: outPath, capabilities: caps.length }));
+  } else {
+    done(`Exported ${bold(String(caps.length))} capabilities → ${cyan(path.relative(cwd, outPath))}`);
+    console.log();
+  }
+}

package/dist/lib/commands/generateSkills.mjs

@@ -1,40 +1,90 @@
-import*as l from"node:fs";import*as s from"node:path";import{readProfile as k}from"../learning/profile.mjs";import{header as y,ok as w,warn as b,done as $,nextSteps as C,cyan as m,yellow as j}from"../ui/output.mjs";const p=s.join("inferno","generated-skills");function f(e,n,i){return l.existsSync(e)&&!i?(b(`Already exists (use --force to overwrite): ${s.relative(process.cwd(),e)}`),!1):(l.mkdirSync(s.dirname(e),{recursive:!0}),l.writeFileSync(e,n,"utf8"),w(`Generated: ${s.relative(process.cwd(),e)}`),!0)}function S(e,n){const i=e.namingStyle!=="unknown"?e.namingStyle:"PascalCase",r=e.preferredVerbs.length>0?e.preferredVerbs.slice(0,5).join(", "):"Add, Update, Remove",t=e.stack?.framework||"unknown",o=e.featureClusters.slice(0,3),a=e.sessionCount>=20?"experienced":e.sessionCount>=5?"intermediate":"new",c=o.map(u=>`- When touching [${u.slice(0,3).join(", ")}], check whether related capabilities also need updating`).join(`
-`);return`# infernoflow \u2014 Cursor Rules (auto-generated)
-# Project: ${n?.policyId||"unknown"} | Stack: ${t}
+/**
+ * infernoflow generate-skills
+ *
+ * Reads inferno/developer-profile.json and generates personalised skill files:
+ *   - inferno/generated-skills/cursor-rules.md      → copy to .cursor/rules/infernoflow.md
+ *   - inferno/generated-skills/quick-restore.md     → session startup skill
+ *   - inferno/generated-skills/naming-guide.md      → detected naming conventions
+ *   - inferno/generated-skills/feature-scaffold.md  → personal feature checklist
+ *
+ * Run: infernoflow generate-skills [--cursor] [--force]
+ *   --cursor   Also copy generated rules to .cursor/rules/infernoflow.md
+ *   --force    Overwrite existing generated files
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { readProfile } from "../learning/profile.mjs";
+import { header, ok, warn, done, nextSteps, cyan, yellow, bold, gray } from "../ui/output.mjs";
+
+const SKILLS_DIR = path.join("inferno", "generated-skills");
+
+function write(filePath, content, force) {
+  if (fs.existsSync(filePath) && !force) {
+    warn(`Already exists (use --force to overwrite): ${path.relative(process.cwd(), filePath)}`);
+    return false;
+  }
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content, "utf8");
+  ok(`Generated: ${path.relative(process.cwd(), filePath)}`);
+  return true;
+}
+
+function buildCursorRules(profile, contract) {
+  const naming = profile.namingStyle !== "unknown" ? profile.namingStyle : "PascalCase";
+  const verbs = profile.preferredVerbs.length > 0 ? profile.preferredVerbs.slice(0, 5).join(", ") : "Add, Update, Remove";
+  const framework = profile.stack?.framework || "unknown";
+  const clusters = profile.featureClusters.slice(0, 3);
+  const sessionStyle = profile.sessionCount >= 20 ? "experienced" : profile.sessionCount >= 5 ? "intermediate" : "new";
+
+  const clusterRules = clusters.map(cluster =>
+    `- When touching [${cluster.slice(0, 3).join(", ")}], check whether related capabilities also need updating`
+  ).join("\n");
+
+  return `# infernoflow — Cursor Rules (auto-generated)
+# Project: ${contract?.policyId || "unknown"} | Stack: ${framework}
 # Regenerate with: infernoflow generate-skills --cursor
 
 ## Contract awareness
 - This project uses infernoflow to track capability contracts
 - After implementing any feature, always call \`infernoflow_run\` then \`infernoflow_apply\`
 - Run \`infernoflow_check\` before every commit
-- Current capabilities: [${(n?.capabilities||[]).join(", ")}]
+- Current capabilities: [${(contract?.capabilities || []).join(", ")}]
 
 ## Naming conventions (detected from this developer's history)
-- Capability IDs use **${i}** (e.g. ${r.split(", ").slice(0,2).map(u=>u+"Item").join(", ")})
-- Preferred action verbs: ${r}
+- Capability IDs use **${naming}** (e.g. ${verbs.split(", ").slice(0, 2).map(v => v + "Item").join(", ")})
+- Preferred action verbs: ${verbs}
 - Match this style when suggesting new capability names
 
 ## Feature clusters (capabilities this developer adds together)
-${c||"- No clusters detected yet \u2014 build more features to train this"}
+${clusterRules || "- No clusters detected yet — build more features to train this"}
 
-## Session style (${a})
-${a==="experienced"?`- Skip basic explanations \u2014 this developer knows the codebase well
-- Be direct and minimal in responses`:`- Include brief context for non-obvious decisions
-- Explain infernoflow commands when used`}
+## Session style (${sessionStyle})
+${sessionStyle === "experienced"
+  ? "- Skip basic explanations — this developer knows the codebase well\n- Be direct and minimal in responses"
+  : "- Include brief context for non-obvious decisions\n- Explain infernoflow commands when used"}
 
 ## Workflow reminders
 - Start sessions with: \`infernoflow context --show\`
 - Use \`infernoflow_git_drift\` to check what's changed before starting work
 - Use \`infernoflow_implement\` to get a structured coding prompt before writing code
-- Changelog entries should be ${e.changelogVerbosity==="detailed"?"detailed (include context and impact)":"brief (one line, action-focused)"}
-`}function R(e,n){const r=e.stack?.framework||"unknown",t=(n?.capabilities||[]).slice(0,6);return`# Quick Restore \u2014 ${n?.policyId||"this project"}
+- Changelog entries should be ${profile.changelogVerbosity === "detailed" ? "detailed (include context and impact)" : "brief (one line, action-focused)"}
+`;
+}
+
+function buildQuickRestore(profile, contract) {
+  const working = ""; // will be filled at runtime from context-state.json
+  const framework = profile.stack?.framework || "unknown";
+  const capabilities = (contract?.capabilities || []).slice(0, 6);
+
+  return `# Quick Restore — ${contract?.policyId || "this project"}
 # Paste this at the start of any new AI session to restore context instantly.
 # Regenerate with: infernoflow generate-skills
 
 ## Project snapshot
-- **Project:** ${n?.policyId||"unknown"}
-- **Stack:** ${r} / ${e.stack?.language||"unknown"} (${e.stack?.projectType||"unknown"})
-- **Capabilities:** ${t.join(", ")}${(n?.capabilities||[]).length>6?` +${(n?.capabilities||[]).length-6} more`:""}
+- **Project:** ${contract?.policyId || "unknown"}
+- **Stack:** ${framework} / ${profile.stack?.language || "unknown"} (${profile.stack?.projectType || "unknown"})
+- **Capabilities:** ${capabilities.join(", ")}${(contract?.capabilities || []).length > 6 ? ` +${(contract?.capabilities || []).length - 6} more` : ""}
 
 ## How to start a session
 1. Run: \`infernoflow context --show\`
@@ -43,42 +93,64 @@ ${a==="experienced"?`- Skip basic explanations \u2014 this developer knows the c
 4. Pick up where you left off
 
 ## infernoflow tools available (in Cursor / VS Code Agent mode)
-- \`infernoflow_run\` \u2014 generate a contract update prompt
-- \`infernoflow_apply\` \u2014 apply a JSON response
-- \`infernoflow_implement\` \u2014 get a structured coding prompt
-- \`infernoflow_git_drift\` \u2014 see what capabilities may have drifted
-- \`infernoflow_check\` \u2014 validate contract is in sync
-- \`infernoflow_status\` \u2014 quick health check
+- \`infernoflow_run\` — generate a contract update prompt
+- \`infernoflow_apply\` — apply a JSON response
+- \`infernoflow_implement\` — get a structured coding prompt
+- \`infernoflow_git_drift\` — see what capabilities may have drifted
+- \`infernoflow_check\` — validate contract is in sync
+- \`infernoflow_status\` — quick health check
 
 ## Definition of done (every feature branch)
 - [ ] Code works as intended
-- [ ] \`infernoflow_run\` \u2192 \`infernoflow_apply\` completed
+- [ ] \`infernoflow_run\` → \`infernoflow_apply\` completed
 - [ ] \`infernoflow_check\` passes
 - [ ] Commit message references the capability changed
-`}function _(e){const n=e.namingStyle!=="unknown"?e.namingStyle:"PascalCase",i=e.preferredVerbs.length>0?e.preferredVerbs:["Create","Read","Update","Delete","Search"],r=i.slice(0,5).map(t=>n==="PascalCase"?`  - ${t}Item, ${t}Task, ${t}User`:n==="camelCase"?`  - ${t.toLowerCase()}Item, ${t.toLowerCase()}Task`:`  - ${t.toLowerCase()}-item, ${t.toLowerCase()}-task`).join(`
-`);return`# Naming Guide \u2014 auto-generated from your capability history
+`;
+}
+
+function buildNamingGuide(profile) {
+  const naming = profile.namingStyle !== "unknown" ? profile.namingStyle : "PascalCase";
+  const verbs = profile.preferredVerbs.length > 0 ? profile.preferredVerbs : ["Create", "Read", "Update", "Delete", "Search"];
+
+  const examples = verbs.slice(0, 5).map(v => {
+    if (naming === "PascalCase") return `  - ${v}Item, ${v}Task, ${v}User`;
+    if (naming === "camelCase")  return `  - ${v.toLowerCase()}Item, ${v.toLowerCase()}Task`;
+    return `  - ${v.toLowerCase()}-item, ${v.toLowerCase()}-task`;
+  }).join("\n");
 
-## Detected style: ${n}
+  return `# Naming Guide — auto-generated from your capability history
+
+## Detected style: ${naming}
 
 ### Your preferred action verbs
-${i.map(t=>`- **${t}**`).join(`
-`)}
+${verbs.map(v => `- **${v}**`).join("\n")}
 
 ### Examples matching your style
-${r}
+${examples}
 
 ### Rules
 - All capability IDs in \`inferno/contract.json\` must follow this style
-- New capabilities suggested by AI should match \u2014 reject any that don't
+- New capabilities suggested by AI should match — reject any that don't
 - If you rename a capability, update contract.json + capabilities.json + any scenarios
 
 ### When naming a new capability, ask:
 1. Does it describe a single, discrete behavior? (If not, split it)
 2. Does it start with one of your preferred verbs?
-3. Is it in ${n}?
-4. Is it unique \u2014 not already in contract.json?
-`}function I(e,n){const r=e.featureClusters.slice(0,2)[0]||[],t=e.stack?.framework||"unknown",o=r.slice(0,4).map(a=>`- [ ] Does **${a}** need updating? (check inferno/capabilities.json)`).join(`
-`);return`# Feature Scaffold \u2014 ${t} project
+3. Is it in ${naming}?
+4. Is it unique — not already in contract.json?
+`;
+}
+
+function buildFeatureScaffold(profile, contract) {
+  const clusters = profile.featureClusters.slice(0, 2);
+  const topCluster = clusters[0] || [];
+  const framework = profile.stack?.framework || "unknown";
+
+  const clusterChecks = topCluster.slice(0, 4).map(id =>
+    `- [ ] Does **${id}** need updating? (check inferno/capabilities.json)`
+  ).join("\n");
+
+  return `# Feature Scaffold — ${framework} project
 # Use this checklist whenever starting a new feature.
 # Regenerate with: infernoflow generate-skills
 
@@ -94,13 +166,13 @@ ${r}
 - [ ] Verify it works end-to-end
 
 ## Capability cluster check
-${o||"- [ ] Review existing capabilities \u2014 do any need updating?"}
+${clusterChecks || "- [ ] Review existing capabilities — do any need updating?"}
 
 ## Contract update (required before merge)
 - [ ] Run \`infernoflow_run\` with a description of what changed
 - [ ] Review the suggested JSON
 - [ ] Run \`infernoflow_apply\` with the JSON
-- [ ] Run \`infernoflow_check\` \u2014 must pass
+- [ ] Run \`infernoflow_check\` — must pass
 
 ## Commit message
 - Reference the capability: "feat: add SearchItems endpoint (#42)"
@@ -110,5 +182,58 @@ ${o||"- [ ] Review existing capabilities \u2014 do any need updating?"}
 - [ ] Feature works
 - [ ] \`infernoflow_check\` passes
 - [ ] PR description mentions which capabilities changed
-`}async function A(e){const n=process.cwd(),i=e.includes("--force")||e.includes("-f"),r=e.includes("--cursor");y("generate-skills");const t=s.join(n,"inferno");l.existsSync(t)||(console.error(`  \u2718 inferno/ not found \u2014 run: infernoflow init
-`),process.exit(1));const o=k(t);let a=null;try{a=JSON.parse(l.readFileSync(s.join(t,"contract.json"),"utf8"))}catch{}const c=s.join(n,p);if(f(s.join(c,"cursor-rules.md"),S(o,a),i),f(s.join(c,"quick-restore.md"),R(o,a),i),f(s.join(c,"naming-guide.md"),_(o),i),f(s.join(c,"feature-scaffold.md"),I(o,a),i),r){const d=s.join(n,".cursor","rules");l.mkdirSync(d,{recursive:!0});const h=s.join(c,"cursor-rules.md"),g=s.join(d,"infernoflow.md");l.copyFileSync(h,g),w("Installed to: .cursor/rules/infernoflow.md")}const u=[o.namingStyle!=="unknown"?`naming: ${o.namingStyle}`:null,o.stack?.framework!=="unknown"?`stack: ${o.stack.framework}`:null,o.sessionCount>0?`sessions: ${o.sessionCount}`:null].filter(Boolean).join(" \xB7 ");$(`Skills generated${u?` (${u})`:""}`),C([`Review files in ${j(p+"/")}`,`Copy to Cursor: ${m("infernoflow generate-skills --cursor")}`,`Re-run any time to refresh after more sessions: ${m("infernoflow generate-skills --force")}`,o.sessionCount<5?`Run more commands to improve personalisation (${o.sessionCount} sessions so far)`:`Profile has ${o.sessionCount} sessions \u2014 personalisation is well-trained`])}export{A as generateSkillsCommand};
+`;
+}
+
+export async function generateSkillsCommand(args) {
+  const cwd = process.cwd();
+  const force = args.includes("--force") || args.includes("-f");
+  const installCursor = args.includes("--cursor");
+
+  header("generate-skills");
+
+  const infernoDir = path.join(cwd, "inferno");
+  if (!fs.existsSync(infernoDir)) {
+    console.error("  ✘ inferno/ not found — run: infernoflow init\n");
+    process.exit(1);
+  }
+
+  const profile = readProfile(infernoDir);
+  let contract = null;
+  try { contract = JSON.parse(fs.readFileSync(path.join(infernoDir, "contract.json"), "utf8")); } catch {}
+
+  const skillsDir = path.join(cwd, SKILLS_DIR);
+
+  // Generate all four skill files
+  write(path.join(skillsDir, "cursor-rules.md"),    buildCursorRules(profile, contract), force);
+  write(path.join(skillsDir, "quick-restore.md"),   buildQuickRestore(profile, contract), force);
+  write(path.join(skillsDir, "naming-guide.md"),    buildNamingGuide(profile), force);
+  write(path.join(skillsDir, "feature-scaffold.md"), buildFeatureScaffold(profile, contract), force);
+
+  // Optionally install cursor rules
+  if (installCursor) {
+    const rulesDir = path.join(cwd, ".cursor", "rules");
+    fs.mkdirSync(rulesDir, { recursive: true });
+    const src = path.join(skillsDir, "cursor-rules.md");
+    const dst = path.join(rulesDir, "infernoflow.md");
+    fs.copyFileSync(src, dst);
+    ok(`Installed to: .cursor/rules/infernoflow.md`);
+  }
+
+  const profileSummary = [
+    profile.namingStyle !== "unknown" ? `naming: ${profile.namingStyle}` : null,
+    profile.stack?.framework !== "unknown" ? `stack: ${profile.stack.framework}` : null,
+    profile.sessionCount > 0 ? `sessions: ${profile.sessionCount}` : null,
+  ].filter(Boolean).join(" · ");
+
+  done(`Skills generated${profileSummary ? ` (${profileSummary})` : ""}`);
+
+  nextSteps([
+    `Review files in ${yellow(SKILLS_DIR + "/")}`,
+    `Copy to Cursor: ${cyan("infernoflow generate-skills --cursor")}`,
+    `Re-run any time to refresh after more sessions: ${cyan("infernoflow generate-skills --force")}`,
+    profile.sessionCount < 5
+      ? `Run more commands to improve personalisation (${profile.sessionCount} sessions so far)`
+      : `Profile has ${profile.sessionCount} sessions — personalisation is well-trained`,
+  ]);
+}