infernoflow 0.33.0 → 0.34.0

package/dist/lib/learning/skillSynthesizer.mjs

@@ -1,30 +1,104 @@
-import*as r from"node:fs";import*as u from"node:path";function c(s,e){const n=u.join(s,"agents");r.mkdirSync(n,{recursive:!0});const t={id:e.id,name:e.name,description:e.description,steps:e.steps.map(i=>({command:i,args:[]})),createdAt:new Date().toISOString(),source:"auto-synthesized",frequency:e.frequency,confidence:e.confidence},o=u.join(n,`${e.name}.json`);return r.writeFileSync(o,JSON.stringify(t,null,2)+`
-`,"utf8"),o}function a(s,e){const n=u.join(s,"skills");r.mkdirSync(n,{recursive:!0});const t=(e.examples||[]).map(f=>`  - "${f}"`).join(`
-`),o=(e.steps||[]).map((f,p)=>`${p+1}. Run \`infernoflow ${f}\``).join(`
-`),i=`# Skill: ${e.name}
-
-> Auto-synthesized from ${e.frequency} observed sessions (confidence: ${Math.round(e.confidence*100)}%)
+/**
+ * lib/learning/skillSynthesizer.mjs
+ *
+ * Converts approved candidates into actual files on disk:
+ *
+ *  AGENTS  → inferno/agents/<name>.json
+ *            (runnable via `infernoflow agent run <name>`)
+ *
+ *  SKILLS  → inferno/skills/<name>.md
+ *            + appends to .cursor/rules/infernoflow-auto.mdc
+ *            + appends to CLAUDE.md (if it exists)
+ */
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+
+// ── Agent file writer ─────────────────────────────────────────────────────────
+
+/**
+ * Write an agent definition to inferno/agents/<name>.json.
+ * Returns the file path written.
+ */
+export function writeAgentFile(infernoDir, candidate) {
+  const agentsDir = path.join(infernoDir, "agents");
+  fs.mkdirSync(agentsDir, { recursive: true });
+
+  const agentDef = {
+    id: candidate.id,
+    name: candidate.name,
+    description: candidate.description,
+    steps: candidate.steps.map(cmd => ({ command: cmd, args: [] })),
+    createdAt: new Date().toISOString(),
+    source: "auto-synthesized",
+    frequency: candidate.frequency,
+    confidence: candidate.confidence,
+  };
+
+  const filePath = path.join(agentsDir, `${candidate.name}.json`);
+  fs.writeFileSync(filePath, JSON.stringify(agentDef, null, 2) + "\n", "utf8");
+  return filePath;
+}
+
+// ── Skill file writers ────────────────────────────────────────────────────────
+
+/**
+ * Write a skill markdown file to inferno/skills/<name>.md.
+ */
+export function writeSkillFile(infernoDir, candidate) {
+  const skillsDir = path.join(infernoDir, "skills");
+  fs.mkdirSync(skillsDir, { recursive: true });
+
+  const examples = (candidate.examples || [])
+    .map(e => `  - "${e}"`)
+    .join("\n");
+
+  const steps = (candidate.steps || [])
+    .map((s, i) => `${i + 1}. Run \`infernoflow ${s}\``)
+    .join("\n");
+
+  const content = `# Skill: ${candidate.name}
+
+> Auto-synthesized from ${candidate.frequency} observed sessions (confidence: ${Math.round(candidate.confidence * 100)}%)
 
 ## Trigger pattern
 
-\`${e.trigger}\`
+\`${candidate.trigger}\`
 
 ## Example tasks this applies to
 
-${t||"  (none recorded)"}
+${examples || "  (none recorded)"}
 
 ## Recommended workflow
 
 When working on a task matching the pattern above:
 
-${o}
+${steps}
 
 ## Notes
 
 - This skill was automatically generated by \`infernoflow synthesize\`
-- Review and edit as needed \u2014 it is yours to own
+- Review and edit as needed — it is yours to own
 - Re-run \`infernoflow synthesize\` to update as your patterns evolve
-`,l=u.join(n,`${e.name}.md`);return r.writeFileSync(l,i,"utf8"),l}function m(s,e){const n=u.join(s,".cursor","rules");r.mkdirSync(n,{recursive:!0});const t=u.join(n,"infernoflow-auto.mdc"),o=r.existsSync(t)?"":`---
+`;
+
+  const filePath = path.join(skillsDir, `${candidate.name}.md`);
+  fs.writeFileSync(filePath, content, "utf8");
+  return filePath;
+}
+
+/**
+ * Append a skill rule to .cursor/rules/infernoflow-auto.mdc.
+ * Creates the file if it doesn't exist.
+ */
+export function appendToCursorRules(cwd, candidate) {
+  const rulesDir = path.join(cwd, ".cursor", "rules");
+  fs.mkdirSync(rulesDir, { recursive: true });
+
+  const filePath = path.join(rulesDir, "infernoflow-auto.mdc");
+
+  const header = fs.existsSync(filePath) ? "" :
+    `---
 description: Auto-generated infernoflow workflow rules
 globs: ["**/*"]
 alwaysApply: true
@@ -33,20 +107,67 @@ alwaysApply: true
 # infernoflow Auto-Generated Workflow Rules
 
 These rules are synthesized from your observed development patterns.
-Do not edit manually \u2014 re-run \`infernoflow synthesize\` to regenerate.
-
-`,i=`
-## ${e.name}
+Do not edit manually — re-run \`infernoflow synthesize\` to regenerate.
 
-Pattern: \`${e.trigger}\`
+`;
 
-When working on tasks matching this pattern:
-${(e.steps||[]).map((l,f)=>`${f+1}. Run \`infernoflow ${l}\``).join(`
-`)}
+  const rule = `
+## ${candidate.name}
 
-`;return r.appendFileSync(t,o+i,"utf8"),t}function y(s,e){const n=u.join(s,"CLAUDE.md");if(!r.existsSync(n))return null;const t=r.readFileSync(n,"utf8"),o="## infernoflow Auto-Skills",i=`
-- **${e.name}**: For tasks like \`${e.trigger}\`, run: ${(e.steps||[]).map(l=>`\`infernoflow ${l}\``).join(" \u2192 ")}`;if(!t.includes(o))r.appendFileSync(n,`
+Pattern: \`${candidate.trigger}\`
 
-${o}
-${i}
-`,"utf8");else{const l=t.replace(o,o+i);r.writeFileSync(n,l,"utf8")}return n}function h(s,e,n){const t=[];if(n.type==="agent")t.push(c(e,n));else{t.push(a(e,n));try{t.push(m(s,n))}catch{}try{const o=y(s,n);o&&t.push(o)}catch{}}return{filePaths:t}}export{y as appendToClaudeMd,m as appendToCursorRules,h as synthesizeCandidate,c as writeAgentFile,a as writeSkillFile};
+When working on tasks matching this pattern:
+${(candidate.steps || []).map((s, i) => `${i + 1}. Run \`infernoflow ${s}\``).join("\n")}
+
+`;
+
+  fs.appendFileSync(filePath, header + rule, "utf8");
+  return filePath;
+}
+
+/**
+ * Append a skill tip to CLAUDE.md if it exists.
+ */
+export function appendToClaudeMd(cwd, candidate) {
+  const claudeMdPath = path.join(cwd, "CLAUDE.md");
+  if (!fs.existsSync(claudeMdPath)) return null;
+
+  const existing = fs.readFileSync(claudeMdPath, "utf8");
+  const marker = "## infernoflow Auto-Skills";
+
+  const tip = `\n- **${candidate.name}**: For tasks like \`${candidate.trigger}\`, run: ${(candidate.steps || []).map(s => `\`infernoflow ${s}\``).join(" → ")}`;
+
+  if (!existing.includes(marker)) {
+    fs.appendFileSync(claudeMdPath, `\n\n${marker}\n${tip}\n`, "utf8");
+  } else {
+    // Append after the marker section
+    const updated = existing.replace(marker, marker + tip);
+    fs.writeFileSync(claudeMdPath, updated, "utf8");
+  }
+
+  return claudeMdPath;
+}
+
+// ── Main synthesize function ──────────────────────────────────────────────────
+
+/**
+ * Write all files for an approved candidate.
+ * Returns { filePaths: string[] } — list of files written.
+ */
+export function synthesizeCandidate(cwd, infernoDir, candidate) {
+  const filePaths = [];
+
+  if (candidate.type === "agent") {
+    filePaths.push(writeAgentFile(infernoDir, candidate));
+  } else {
+    // skill
+    filePaths.push(writeSkillFile(infernoDir, candidate));
+    try { filePaths.push(appendToCursorRules(cwd, candidate)); } catch {}
+    try {
+      const p = appendToClaudeMd(cwd, candidate);
+      if (p) filePaths.push(p);
+    } catch {}
+  }
+
+  return { filePaths };
+}

package/dist/lib/templates/index.mjs

@@ -1 +1,131 @@
-const i={"rest-api":{description:"Express / Fastify / Hono REST API",capabilities:[{id:"list-items",description:"GET /items \u2014 paginated list with filtering and sorting"},{id:"get-item",description:"GET /items/:id \u2014 fetch a single resource by ID"},{id:"create-item",description:"POST /items \u2014 create a new resource, validate input"},{id:"update-item",description:"PUT /items/:id \u2014 full update of an existing resource"},{id:"delete-item",description:"DELETE /items/:id \u2014 soft or hard delete"},{id:"authenticate",description:"POST /auth/login \u2014 exchange credentials for a JWT token"},{id:"refresh-token",description:"POST /auth/refresh \u2014 extend session with a new token"},{id:"health-check",description:"GET /health \u2014 liveness probe for load balancers"},{id:"paginate",description:"Cursor or offset pagination applied across list endpoints"},{id:"validate-input",description:"Schema validation on all incoming request bodies"}],contextHint:"Building a REST API. Focus on route handlers, middleware, and input validation.",scripts:{dev:"node src/index.js",start:"node dist/index.js"}},nextjs:{description:"Next.js full-stack app (App Router or Pages Router)",capabilities:[{id:"render-home-page",description:"/ \u2014 server-rendered landing page with SEO metadata"},{id:"render-dashboard",description:"/dashboard \u2014 authenticated user dashboard"},{id:"api-authenticate",description:"POST /api/auth/login \u2014 issue session cookie or JWT"},{id:"api-list-resources",description:"GET /api/resources \u2014 paginated list, auth-protected"},{id:"api-create-resource",description:"POST /api/resources \u2014 create and persist a resource"},{id:"server-side-props",description:"Fetch user-specific data server-side before render"},{id:"static-generation",description:"Pre-render marketing pages at build time"},{id:"image-optimization",description:"next/image usage for responsive, lazy-loaded images"},{id:"middleware-auth",description:"Edge middleware to protect dashboard routes"},{id:"error-boundary",description:"Global error.tsx / _error.tsx user-facing error page"}],contextHint:"Building a Next.js app. Use Server Components by default; Client Components only when needed.",scripts:{dev:"next dev",build:"next build",start:"next start"}},cli:{description:"Node.js / Python CLI tool",capabilities:[{id:"parse-args",description:"Parse CLI arguments and flags, show help on --help"},{id:"validate-config",description:"Load and validate config file or env vars on startup"},{id:"main-command",description:"Primary command \u2014 the core action the CLI performs"},{id:"output-formatter",description:"Format output as text, JSON, or table based on --format flag"},{id:"error-handler",description:"Friendly error messages with exit codes, no raw stack traces"},{id:"progress-display",description:"Spinner or progress bar for long-running operations"},{id:"update-check",description:"Check npm/PyPI for a newer version on startup"},{id:"plugin-loader",description:"Discover and load user-installed plugins at runtime"}],contextHint:"Building a CLI tool. Prioritise UX: helpful errors, --json flag, zero-config defaults.",scripts:{start:"node bin/cli.js",link:"npm link"}},graphql:{description:"GraphQL API (Apollo, Pothos, or similar)",capabilities:[{id:"query-viewer",description:"query { viewer } \u2014 return the authenticated user"},{id:"query-list",description:"query { items(first: N, after: cursor) } \u2014 paginated list"},{id:"query-node",description:"query { node(id) } \u2014 global object lookup by ID"},{id:"mutation-create",description:"mutation { createItem(input) } \u2014 create and return new object"},{id:"mutation-update",description:"mutation { updateItem(id, input) } \u2014 update fields"},{id:"mutation-delete",description:"mutation { deleteItem(id) } \u2014 remove and return deleted"},{id:"subscription-event",description:"subscription { itemUpdated } \u2014 real-time push via WebSocket"},{id:"data-loader",description:"Batch and cache DB calls with DataLoader to avoid N+1"},{id:"auth-directive",description:"@auth directive \u2014 enforce authentication on resolvers"},{id:"error-formatting",description:"Consistent GraphQL error shape with extensions and codes"}],contextHint:"Building a GraphQL API. Use DataLoader for all relations, @auth directive on protected resolvers.",scripts:{dev:"ts-node src/server.ts",codegen:"graphql-codegen"}},monorepo:{description:"Monorepo workspace (nx / turborepo / pnpm workspaces)",capabilities:[{id:"build-all",description:"Build all packages in dependency order"},{id:"test-all",description:"Run tests across all packages in parallel"},{id:"lint-all",description:"Lint all packages with shared ESLint / Prettier config"},{id:"publish-packages",description:"Bump versions and publish changed packages to npm"},{id:"shared-ui-library",description:"packages/ui \u2014 shared React component library"},{id:"shared-utils",description:"packages/utils \u2014 shared utility functions and types"},{id:"web-app",description:"apps/web \u2014 primary Next.js or React web application"},{id:"api-service",description:"apps/api \u2014 backend service consumed by apps"},{id:"cache-builds",description:"Remote build cache via Turborepo or Nx Cloud"},{id:"affected-only",description:"Run tasks only for packages affected by a git change"}],contextHint:"Working in a monorepo. Changes in packages/* may affect apps/*. Check affected packages before building.",scripts:{build:"turbo build",dev:"turbo dev",test:"turbo test"}}};function r(){return Object.entries(i).map(([e,t])=>({name:e,description:t.description}))}function a(e){return i[e]||null}export{i as TEMPLATES,a as getTemplate,r as listTemplates};
+/**
+ * infernoflow project templates
+ *
+ * Named starters for `infernoflow init --template <name>`.
+ * Each template provides:
+ *   - capabilities  : pre-populated capability list
+ *   - scenarios     : one starter scenario per capability
+ *   - contextHint   : first-session CONTEXT.md guidance
+ *   - scripts       : suggested package.json scripts to add
+ */
+
+export const TEMPLATES = {
+
+  // ── REST API ────────────────────────────────────────────────────────────────
+  "rest-api": {
+    description: "Express / Fastify / Hono REST API",
+    capabilities: [
+      { id: "list-items",      description: "GET /items — paginated list with filtering and sorting" },
+      { id: "get-item",        description: "GET /items/:id — fetch a single resource by ID" },
+      { id: "create-item",     description: "POST /items — create a new resource, validate input" },
+      { id: "update-item",     description: "PUT /items/:id — full update of an existing resource" },
+      { id: "delete-item",     description: "DELETE /items/:id — soft or hard delete" },
+      { id: "authenticate",    description: "POST /auth/login — exchange credentials for a JWT token" },
+      { id: "refresh-token",   description: "POST /auth/refresh — extend session with a new token" },
+      { id: "health-check",    description: "GET /health — liveness probe for load balancers" },
+      { id: "paginate",        description: "Cursor or offset pagination applied across list endpoints" },
+      { id: "validate-input",  description: "Schema validation on all incoming request bodies" },
+    ],
+    contextHint: "Building a REST API. Focus on route handlers, middleware, and input validation.",
+    scripts: {
+      "dev":   "node src/index.js",
+      "start": "node dist/index.js",
+    },
+  },
+
+  // ── Next.js ─────────────────────────────────────────────────────────────────
+  "nextjs": {
+    description: "Next.js full-stack app (App Router or Pages Router)",
+    capabilities: [
+      { id: "render-home-page",    description: "/ — server-rendered landing page with SEO metadata" },
+      { id: "render-dashboard",    description: "/dashboard — authenticated user dashboard" },
+      { id: "api-authenticate",    description: "POST /api/auth/login — issue session cookie or JWT" },
+      { id: "api-list-resources",  description: "GET /api/resources — paginated list, auth-protected" },
+      { id: "api-create-resource", description: "POST /api/resources — create and persist a resource" },
+      { id: "server-side-props",   description: "Fetch user-specific data server-side before render" },
+      { id: "static-generation",   description: "Pre-render marketing pages at build time" },
+      { id: "image-optimization",  description: "next/image usage for responsive, lazy-loaded images" },
+      { id: "middleware-auth",     description: "Edge middleware to protect dashboard routes" },
+      { id: "error-boundary",      description: "Global error.tsx / _error.tsx user-facing error page" },
+    ],
+    contextHint: "Building a Next.js app. Use Server Components by default; Client Components only when needed.",
+    scripts: {
+      "dev":   "next dev",
+      "build": "next build",
+      "start": "next start",
+    },
+  },
+
+  // ── CLI tool ────────────────────────────────────────────────────────────────
+  "cli": {
+    description: "Node.js / Python CLI tool",
+    capabilities: [
+      { id: "parse-args",       description: "Parse CLI arguments and flags, show help on --help" },
+      { id: "validate-config",  description: "Load and validate config file or env vars on startup" },
+      { id: "main-command",     description: "Primary command — the core action the CLI performs" },
+      { id: "output-formatter", description: "Format output as text, JSON, or table based on --format flag" },
+      { id: "error-handler",    description: "Friendly error messages with exit codes, no raw stack traces" },
+      { id: "progress-display", description: "Spinner or progress bar for long-running operations" },
+      { id: "update-check",     description: "Check npm/PyPI for a newer version on startup" },
+      { id: "plugin-loader",    description: "Discover and load user-installed plugins at runtime" },
+    ],
+    contextHint: "Building a CLI tool. Prioritise UX: helpful errors, --json flag, zero-config defaults.",
+    scripts: {
+      "start": "node bin/cli.js",
+      "link":  "npm link",
+    },
+  },
+
+  // ── GraphQL ─────────────────────────────────────────────────────────────────
+  "graphql": {
+    description: "GraphQL API (Apollo, Pothos, or similar)",
+    capabilities: [
+      { id: "query-viewer",       description: "query { viewer } — return the authenticated user" },
+      { id: "query-list",         description: "query { items(first: N, after: cursor) } — paginated list" },
+      { id: "query-node",         description: "query { node(id) } — global object lookup by ID" },
+      { id: "mutation-create",    description: "mutation { createItem(input) } — create and return new object" },
+      { id: "mutation-update",    description: "mutation { updateItem(id, input) } — update fields" },
+      { id: "mutation-delete",    description: "mutation { deleteItem(id) } — remove and return deleted" },
+      { id: "subscription-event", description: "subscription { itemUpdated } — real-time push via WebSocket" },
+      { id: "data-loader",        description: "Batch and cache DB calls with DataLoader to avoid N+1" },
+      { id: "auth-directive",     description: "@auth directive — enforce authentication on resolvers" },
+      { id: "error-formatting",   description: "Consistent GraphQL error shape with extensions and codes" },
+    ],
+    contextHint: "Building a GraphQL API. Use DataLoader for all relations, @auth directive on protected resolvers.",
+    scripts: {
+      "dev":       "ts-node src/server.ts",
+      "codegen":   "graphql-codegen",
+    },
+  },
+
+  // ── Monorepo ────────────────────────────────────────────────────────────────
+  "monorepo": {
+    description: "Monorepo workspace (nx / turborepo / pnpm workspaces)",
+    capabilities: [
+      { id: "build-all",         description: "Build all packages in dependency order" },
+      { id: "test-all",          description: "Run tests across all packages in parallel" },
+      { id: "lint-all",          description: "Lint all packages with shared ESLint / Prettier config" },
+      { id: "publish-packages",  description: "Bump versions and publish changed packages to npm" },
+      { id: "shared-ui-library", description: "packages/ui — shared React component library" },
+      { id: "shared-utils",      description: "packages/utils — shared utility functions and types" },
+      { id: "web-app",           description: "apps/web — primary Next.js or React web application" },
+      { id: "api-service",       description: "apps/api — backend service consumed by apps" },
+      { id: "cache-builds",      description: "Remote build cache via Turborepo or Nx Cloud" },
+      { id: "affected-only",     description: "Run tasks only for packages affected by a git change" },
+    ],
+    contextHint: "Working in a monorepo. Changes in packages/* may affect apps/*. Check affected packages before building.",
+    scripts: {
+      "build": "turbo build",
+      "dev":   "turbo dev",
+      "test":  "turbo test",
+    },
+  },
+};
+
+export function listTemplates() {
+  return Object.entries(TEMPLATES).map(([name, t]) => ({ name, description: t.description }));
+}
+
+export function getTemplate(name) {
+  return TEMPLATES[name] || null;
+}