@kairos-sdk/core 0.4.0 → 0.4.5

package/dist/cli.cjs

@@ -524,6 +524,9 @@ var N8nValidator = class {
     this.checkRule21(workflow, issues);
     this.checkRule22(workflow, issues);
     this.checkRule23(workflow, issues);
+    this.checkRule24(workflow, issues);
+    this.checkRule25(workflow, issues);
+    this.checkRule26(workflow, issues);
     if (Array.isArray(workflow.nodes)) {
       const nodeById = new Map(workflow.nodes.map((n) => [n.id, n.type]));
       for (const issue of issues) {
@@ -656,10 +659,14 @@ var N8nValidator = class {
   checkRule11(w, issues) {
     if (!Array.isArray(w.nodes) || typeof w.connections !== "object" || w.connections === null) return;
     const reachable = /* @__PURE__ */ new Set();
-    for (const [, outputs] of Object.entries(w.connections)) {
+    const aiSubNodeSources = /* @__PURE__ */ new Set();
+    for (const [sourceName, outputs] of Object.entries(w.connections)) {
       if (typeof outputs !== "object" || outputs === null) continue;
-      for (const portGroup of Object.values(outputs)) {
+      let hasAiPort = false;
+      for (const [portName, portGroup] of Object.entries(outputs)) {
         if (!Array.isArray(portGroup)) continue;
+        const isAiPort = portName.startsWith("ai_");
+        if (isAiPort) hasAiPort = true;
         for (const targets of portGroup) {
           if (!Array.isArray(targets)) continue;
           for (const target of targets) {
@@ -668,10 +675,13 @@ var N8nValidator = class {
           }
         }
       }
+      if (hasAiPort) aiSubNodeSources.add(sourceName);
     }
     for (const node of w.nodes) {
       if (node.type.includes("stickyNote")) continue;
-      if (!this.isTriggerNode(node) && !reachable.has(node.name)) {
+      if (this.isTriggerNode(node)) continue;
+      if (aiSubNodeSources.has(node.name)) continue;
+      if (!reachable.has(node.name)) {
         this.warn(issues, 11, `Node "${node.name}" has no incoming connections and may never execute`, node.id);
       }
     }
@@ -867,6 +877,76 @@ var N8nValidator = class {
       }
     }
   }
+  // Rule 24 (WARN): deprecated accessor syntax in expressions
+  checkRule24(w, issues) {
+    if (!Array.isArray(w.nodes)) return;
+    const deprecated = /\$node\s*\[/;
+    for (const node of w.nodes) {
+      for (const expr of this.extractExpressions(node.parameters)) {
+        if (deprecated.test(expr)) {
+          this.warn(
+            issues,
+            24,
+            `Node "${node.name}" uses deprecated accessor $node["..."] \u2014 use $('NodeName').item.json.field instead`,
+            node.id
+          );
+          break;
+        }
+      }
+    }
+  }
+  // Rule 25 (WARN): wrong item index assumptions in expressions
+  checkRule25(w, issues) {
+    if (!Array.isArray(w.nodes)) return;
+    const itemIndex = /\$json\s*\.\s*items\s*\[/;
+    for (const node of w.nodes) {
+      for (const expr of this.extractExpressions(node.parameters)) {
+        if (itemIndex.test(expr)) {
+          this.warn(
+            issues,
+            25,
+            `Node "${node.name}" accesses $json.items[n] \u2014 n8n flattens items automatically, use $json.field directly`,
+            node.id
+          );
+          break;
+        }
+      }
+    }
+  }
+  // Rule 26 (WARN): missing .first() or .all() on node references
+  checkRule26(w, issues) {
+    if (!Array.isArray(w.nodes)) return;
+    const bareRef = /\$\(\s*'[^']+'\s*\)\s*\.json/;
+    for (const node of w.nodes) {
+      for (const expr of this.extractExpressions(node.parameters)) {
+        if (bareRef.test(expr)) {
+          this.warn(
+            issues,
+            26,
+            `Node "${node.name}" references $('NodeName').json without .first() or .all() \u2014 use $('NodeName').first().json.field`,
+            node.id
+          );
+          break;
+        }
+      }
+    }
+  }
+  extractExpressions(params) {
+    const expressions = [];
+    const walk = (val) => {
+      if (typeof val === "string") {
+        if (val.includes("={{") || val.includes("$node") || val.includes("$('")) {
+          expressions.push(val);
+        }
+      } else if (Array.isArray(val)) {
+        for (const item of val) walk(item);
+      } else if (val !== null && typeof val === "object") {
+        for (const v of Object.values(val)) walk(v);
+      }
+    };
+    walk(params);
+    return expressions;
+  }
   // Rule 21 (WARN): webhook with responseMode="responseNode" must have respondToWebhook node
   checkRule21(w, issues) {
     if (!Array.isArray(w.nodes)) return;
@@ -954,9 +1034,11 @@ id, active, createdAt, updatedAt, versionId, meta, isArchived, activeVersionId,
 - Never reuse IDs, never use sequential fake IDs like "node-1"
 
 ### Credentials:
-- Only reference credentials with exact type names (see catalog below)
-- If credential ID is unknown, OMIT the credentials block entirely \u2014 never invent credential IDs
-- Never put API keys or tokens in parameters when a credential type exists
+- Each credential is keyed by its type string, with an object value containing id and name:
+  "credentials": { "slackOAuth2Api": { "id": "placeholder-id", "name": "My Slack Credential" } }
+- Use "placeholder-id" as the id \u2014 users replace this with their real credential ID from n8n after deployment
+- The credentialsNeeded field in your response declares what credentials the user must configure
+- Never put API keys or tokens directly in node parameters when a credential type exists
 
 ### Node names:
 - All node names must be unique within the workflow
@@ -1003,6 +1085,23 @@ Node parameters like conditions, assignments, and rule intervals MUST include al
 
 ---
 
+## EXPRESSION SYNTAX \u2014 how to reference upstream node data
+
+### Accessing a field from an upstream node:
+- CORRECT:   $('NodeName').item.json.field
+- WRONG:     $node["NodeName"].json.field   \u2190 deprecated accessor, fails at runtime (Rule 24)
+
+### Accessing array items from $json:
+- CORRECT:   $json.field                    \u2190 n8n auto-flattens items; each item is already a flat object
+- WRONG:     $json.items[0].field           \u2190 do not index into items[] (Rule 25)
+
+### Calling node data \u2014 always qualify with .first() or .all():
+- CORRECT:   $('NodeName').first().json.field   \u2190 single item
+- CORRECT:   $('NodeName').all()                \u2190 array of all items
+- WRONG:     $('NodeName').json                 \u2190 throws at runtime without .first() or .all() (Rule 26)
+
+---
+
 ## NODE CATALOG \u2014 exact type strings and safe typeVersions
 
 ### Triggers (always at least one required):
@@ -1102,6 +1201,9 @@ Cron: { "rule": { "interval": [{ "field": "cronExpression", "expression": "0 9 *
 5. At least one trigger node present
 6. Every AI Agent has an ai_languageModel sub-node
 7. settings block is complete with executionOrder: "v1"
+8. No deprecated $node["NodeName"].json \u2014 use $('NodeName').item.json.field
+9. No $json.items[0] array indexing \u2014 access fields directly as $json.field
+10. No bare $('NodeName').json \u2014 always use .first().json.field or .all()
 
 ---
 
@@ -1118,7 +1220,7 @@ function scoreToMode(score) {
 }
 
 // src/validation/rule-metadata.ts
-var VALIDATOR_RULE_IDS = Array.from({ length: 23 }, (_, i) => i + 1);
+var VALIDATOR_RULE_IDS = Array.from({ length: 26 }, (_, i) => i + 1);
 var RULE_PIPELINE_STAGES = {
   1: "node_generation",
   2: "node_generation",
@@ -1142,7 +1244,28 @@ var RULE_PIPELINE_STAGES = {
   20: "connection_wiring",
   21: "workflow_structure",
   22: "workflow_structure",
-  23: "node_generation"
+  23: "node_generation",
+  24: "expression_syntax",
+  25: "expression_syntax",
+  26: "expression_syntax"
+};
+var RULE_EXAMPLES = {
+  17: {
+    bad: '"credentials": { "slackOAuth2Api": "my-token" }',
+    good: '"credentials": { "slackOAuth2Api": { "id": "placeholder-id", "name": "My Slack OAuth" } }'
+  },
+  24: {
+    bad: '$node["Fetch Data"].json.email',
+    good: "$('Fetch Data').item.json.email"
+  },
+  25: {
+    bad: "$json.items[0].email",
+    good: "$json.email"
+  },
+  26: {
+    bad: "$('Fetch Data').json.email",
+    good: "$('Fetch Data').first().json.email"
+  }
 };
 var RULE_MITIGATIONS = {
   1: "Provide a non-empty workflow name string",
@@ -1161,21 +1284,44 @@ var RULE_MITIGATIONS = {
   14: "Include at least one trigger node (e.g. scheduleTrigger, webhookTrigger, manualTrigger, or service-specific)",
   15: 'Node type strings must be fully qualified: "n8n-nodes-base.httpRequest" not just "httpRequest"',
   16: "All node names must be unique within the workflow",
-  17: 'Credentials must be an object with non-empty string id and name fields: { id: "placeholder-id", name: "My Credential" }',
+  17: 'Each credential entry must be keyed by credential type with an object value: { "slackOAuth2Api": { "id": "placeholder-id", "name": "My Credential" } } \u2014 the key is the credential type, the value has id and name strings',
   18: "AI sub-nodes (languageModel, memory, tool) must be the CONNECTION SOURCE pointing TO the agent \u2014 not the reverse",
   19: "Use known safe typeVersion values for each node type",
   20: "Remove connection cycles \u2014 ensure no node can reach itself through the connection graph",
   21: 'When using webhook with responseMode "responseNode", include a respondToWebhook node in the flow',
   22: "Ensure all required parameters are set for each node type (e.g. webhook needs httpMethod and path)",
-  23: "Use node types that exist in the n8n registry \u2014 check with kairos_sync"
+  23: "Use node types that exist in the n8n registry \u2014 check with kairos_sync",
+  24: 'Use modern accessor syntax: $("NodeName").item.json.field instead of deprecated $node["NodeName"].json.field',
+  25: "Access item fields directly with $json.field \u2014 n8n flattens items automatically, do not use $json.items[0]",
+  26: 'Use $("NodeName").first().json.field or $("NodeName").all() \u2014 bare $("NodeName").json without .first() or .all() throws at runtime'
 };
 
 // src/generation/prompt-builder.ts
 var CRITICAL_SCORE_THRESHOLD = 0.15;
+function resolveProfile() {
+  const env = process.env["KAIROS_PROMPT_PROFILE"];
+  if (env === "minimal" || env === "standard" || env === "rich") return env;
+  return "standard";
+}
+var PROACTIVE_EXPRESSION_GUIDANCE = `## Expression Syntax Quick Reference
+
+Always use these patterns in expressions:
+- Access node data:  $('NodeName').item.json.field  (not $node["NodeName"].json)
+- Access JSON field: $json.field  (not $json.items[0].field)
+- Single item:       $('NodeName').first().json.field
+- All items:         $('NodeName').all()`;
 var PromptBuilder = class {
   patternsPath;
-  constructor(patternsPath) {
+  profile;
+  _lastActivePatterns = null;
+  constructor(patternsPath, profile) {
     this.patternsPath = patternsPath ?? (0, import_node_path.join)((0, import_node_os.homedir)(), ".kairos", "patterns.json");
+    this.profile = profile ?? resolveProfile();
+  }
+  resolveMaxPatterns() {
+    if (this.profile === "minimal") return 3;
+    if (this.profile === "rich") return 15;
+    return 10;
   }
   build(request, matches, globalFailureRates = [], dynamicCatalog) {
     const mode = this.resolveMode(matches);
@@ -1213,53 +1359,62 @@ Fix ALL of the above issues in your new response. Do not repeat any of these mis
         cache_control: { type: "ephemeral" }
       }
     ];
-    if (mode === "reference" && matches.length > 0) {
-      const refText = matches.slice(0, 3).map((m) => {
-        const nodes = m.workflow.workflow.nodes.map((n) => `  - ${n.name} (${n.type} v${n.typeVersion})`).join("\n");
-        return `Reference workflow: "${m.workflow.description}" (similarity: ${m.score.toFixed(2)})
+    if (this.profile !== "minimal") {
+      if (mode === "reference" && matches.length > 0) {
+        const refText = matches.slice(0, 3).map((m) => {
+          const nodes = m.workflow.workflow.nodes.map((n) => `  - ${n.name} (${n.type} v${n.typeVersion})`).join("\n");
+          return `Reference workflow: "${m.workflow.description}" (similarity: ${m.score.toFixed(2)})
 Nodes:
 ${nodes}`;
-      }).join("\n\n");
-      blocks.push({
-        type: "text",
-        text: `## Similar Workflows From Library (for reference only \u2014 adapt, do not copy verbatim)
-
-${refText}`
-      });
-    }
-    if (mode === "direct" && matches[0]) {
-      const match = matches[0];
-      const json = JSON.stringify(match.workflow.workflow, null, 2);
-      if (json.length > 3e4) {
-        const nodes = match.workflow.workflow.nodes.map((n) => `  - ${n.name} (${n.type} v${n.typeVersion})`).join("\n");
+        }).join("\n\n");
         blocks.push({
           type: "text",
-          text: `## Closely Matched Workflow (score: ${match.score.toFixed(2)}) \u2014 too large for full JSON, using reference:
+          text: `## Similar Workflows From Library (for reference only \u2014 adapt, do not copy verbatim)
+
+${refText}`
+        });
+      }
+      if (mode === "direct" && matches[0]) {
+        const match = matches[0];
+        const json = JSON.stringify(match.workflow.workflow, null, 2);
+        if (json.length > 3e4) {
+          const nodes = match.workflow.workflow.nodes.map((n) => `  - ${n.name} (${n.type} v${n.typeVersion})`).join("\n");
+          blocks.push({
+            type: "text",
+            text: `## Closely Matched Workflow (score: ${match.score.toFixed(2)}) \u2014 too large for full JSON, using reference:
 Nodes:
 ${nodes}`
-        });
-      } else {
-        blocks.push({
-          type: "text",
-          text: `## Closely Matched Workflow (score: ${match.score.toFixed(2)}) \u2014 adapt this structure:
+          });
+        } else {
+          blocks.push({
+            type: "text",
+            text: `## Closely Matched Workflow (score: ${match.score.toFixed(2)}) \u2014 adapt this structure:
 
 ${json}`
-        });
+          });
+        }
       }
-    }
-    if (mode === "scratch" && matches.length > 0 && matches[0].score >= 0.4) {
-      const hint = matches[0];
-      const nodeTypes = hint.workflow.workflow.nodes.map((n) => n.type.split(".").pop()).join(", ");
-      blocks.push({
-        type: "text",
-        text: `## Weak Structural Hint
+      if (mode === "scratch" && matches.length > 0 && matches[0].score >= 0.4) {
+        const hint = matches[0];
+        const nodeTypes = hint.workflow.workflow.nodes.map((n) => n.type.split(".").pop()).join(", ");
+        blocks.push({
+          type: "text",
+          text: `## Weak Structural Hint
 A loosely similar workflow (score: ${hint.score.toFixed(2)}) used these node types: ${nodeTypes}`
-      });
+        });
+      }
     }
     const warnings = this.buildFailureWarnings(matches, globalFailureRates);
     if (warnings) {
       blocks.push({ type: "text", text: warnings });
     }
+    if (this.profile === "rich") {
+      const expressionRules = /* @__PURE__ */ new Set([24, 25, 26]);
+      const expressionAlreadyCovered = (this._lastActivePatterns ?? []).some((p) => expressionRules.has(p.rule));
+      if (!expressionAlreadyCovered) {
+        blocks.push({ type: "text", text: PROACTIVE_EXPRESSION_GUIDANCE });
+      }
+    }
     return blocks;
   }
   loadPatterns() {
@@ -1273,18 +1428,19 @@ A loosely similar workflow (score: ${hint.score.toFixed(2)}) used these node typ
     }
   }
   getWarnedRules() {
-    return this.getActivePatterns().map((p) => p.rule);
+    const patterns = this._lastActivePatterns ?? this.getActivePatterns(this.resolveMaxPatterns());
+    return patterns.map((p) => p.rule);
   }
-  getActivePatterns() {
-    const MAX_WARNED = 10;
+  getActivePatterns(maxCount = 10) {
     const all = this.loadPatterns().filter((p) => p.state !== "resolved" && p.confidence > 0);
     const regressed = all.filter((p) => p.regressed).sort((a, b) => b.compositeScore - a.compositeScore);
     const confirmed = all.filter((p) => !p.regressed && p.state === "confirmed").sort((a, b) => b.compositeScore - a.compositeScore);
     const drafts = all.filter((p) => !p.regressed && p.state !== "confirmed").sort((a, b) => b.compositeScore - a.compositeScore);
-    return [...regressed, ...confirmed, ...drafts].slice(0, MAX_WARNED);
+    return [...regressed, ...confirmed, ...drafts].slice(0, maxCount);
   }
   buildFailureWarnings(matches, globalFailureRates) {
-    const richPatterns = this.getActivePatterns();
+    const richPatterns = this.getActivePatterns(this.resolveMaxPatterns());
+    this._lastActivePatterns = richPatterns;
     if (richPatterns.length > 0) {
       return this.buildStageGroupedWarnings(richPatterns, matches);
     }
@@ -1295,7 +1451,8 @@ A loosely similar workflow (score: ${hint.score.toFixed(2)}) used these node typ
       credential_injection: "CREDENTIAL FORMATTING",
       connection_wiring: "CONNECTION WIRING",
       node_generation: "NODE GENERATION",
-      workflow_structure: "WORKFLOW STRUCTURE"
+      workflow_structure: "WORKFLOW STRUCTURE",
+      expression_syntax: "EXPRESSION SYNTAX"
     };
     const byStage = /* @__PURE__ */ new Map();
     for (const p of patterns) {
@@ -1323,7 +1480,11 @@ A loosely similar workflow (score: ${hint.score.toFixed(2)}) used these node typ
           const remedy = p.mitigation ?? RULE_MITIGATIONS[p.rule];
           const remedyStr = remedy ? `
   Fix: ${remedy}` : "";
-          lines.push(`- ${urgency}${statePrefix}Rule ${p.rule}${trendSuffix}: ${p.exampleMessages[0] ?? "No example"}${remedyStr}`);
+          const ex = RULE_EXAMPLES[p.rule];
+          const exampleStr = ex ? `
+  Bad:  ${ex.bad}
+  Good: ${ex.good}` : "";
+          lines.push(`- ${urgency}${statePrefix}Rule ${p.rule}${trendSuffix}: ${p.exampleMessages[0] ?? "No example"}${remedyStr}${exampleStr}`);
         } else {
           const ruleNums = group.map((p) => p.rule).join(", ");
           const totalFailures = group.reduce((s, p) => s + p.failureCount, 0);
@@ -1430,12 +1591,12 @@ var GENERATE_WORKFLOW_TOOL = {
   }
 };
 var WorkflowDesigner = class {
-  constructor(anthropic, model, logger) {
+  constructor(anthropic, model, logger, patternsPath) {
     this.anthropic = anthropic;
     this.model = model;
     this.logger = logger;
     this.validator = new N8nValidator();
-    this.promptBuilder = new PromptBuilder();
+    this.promptBuilder = new PromptBuilder(patternsPath);
   }
   anthropic;
   model;
@@ -1519,6 +1680,11 @@ var WorkflowDesigner = class {
     }
   }
   extractToolUse(message) {
+    if (message.stop_reason === "max_tokens") {
+      throw new GenerationError(
+        "Claude response was truncated (max_tokens reached) \u2014 the workflow may be too large. Try a simpler description or break it into smaller workflows."
+      );
+    }
     const toolUseBlock = message.content.find(
       (block) => block.type === "tool_use"
     );
@@ -1561,11 +1727,12 @@ var TelemetryCollector = class {
     this.dir = dir ?? (0, import_node_path2.join)((0, import_node_os2.homedir)(), ".kairos", "telemetry");
     this.sessionId = generateUUID();
   }
-  async emit(eventType, data) {
+  async emit(eventType, data, runId) {
     const event = {
       schemaVersion: TELEMETRY_SCHEMA_VERSION,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       sessionId: this.sessionId,
+      ...runId ? { runId } : {},
       eventType,
       data
     };
@@ -1691,6 +1858,7 @@ var PATTERN_SCHEMA_VERSION = 2;
 var PatternAnalyzer = class _PatternAnalyzer {
   telemetryDir;
   outputDir;
+  _cachedEvents = null;
   constructor(telemetryDir) {
     const defaultDir = (0, import_node_path5.join)((0, import_node_os4.homedir)(), ".kairos", "telemetry");
     this.telemetryDir = telemetryDir ?? defaultDir;
@@ -1719,19 +1887,23 @@ var PatternAnalyzer = class _PatternAnalyzer {
       }));
     }
     if (fromVersion < 2) {
-      migrated = migrated.map((p) => ({
-        ...p,
-        scoringFactors: {
-          ...p.scoringFactors,
-          stickinessBoost: p.scoringFactors.stickinessBoost ?? p.scoringFactors["validationBoost"] ?? 0
-        }
-      }));
+      migrated = migrated.map((p) => {
+        const sf = p.scoringFactors ?? { rawConfidence: 0, impact: 0, recency: 0, stickinessBoost: 0 };
+        return {
+          ...p,
+          scoringFactors: {
+            ...sf,
+            stickinessBoost: sf.stickinessBoost ?? sf["validationBoost"] ?? 0
+          }
+        };
+      });
     }
     return migrated;
   }
   async analyze(days = 30) {
     const previousPatterns = await this.loadPreviousPatterns();
     const events = await this.readAllEvents(days);
+    this._cachedEvents = events;
     const starts = events.filter((e) => e.eventType === "build_start");
     const attempts = events.filter((e) => e.eventType === "generation_attempt");
     const passed = attempts.filter(
@@ -1744,13 +1916,18 @@ var PatternAnalyzer = class _PatternAnalyzer {
     const credentialFailures = /* @__PURE__ */ new Map();
     for (const a of failed) {
       const weight = this.recencyWeight(a.fileDate);
+      const buildId = a.runId ?? a.sessionId;
       const data = a.data;
       for (const issue of data.issues ?? []) {
-        const entry = ruleFailures.get(issue.rule) ?? { count: 0, sessions: /* @__PURE__ */ new Set(), recencyWeights: [], allMessages: [] };
+        if (issue.severity === "warn") continue;
+        const entry = ruleFailures.get(issue.rule) ?? { count: 0, sessions: /* @__PURE__ */ new Set(), recencyWeights: [], allMessages: [], workflowTypes: /* @__PURE__ */ new Map() };
         entry.count++;
-        entry.sessions.add(a.sessionId);
+        entry.sessions.add(buildId);
         entry.recencyWeights.push(weight);
         entry.allMessages.push(issue.message);
+        if (data.workflowType) {
+          entry.workflowTypes.set(data.workflowType, (entry.workflowTypes.get(data.workflowType) ?? 0) + 1);
+        }
         ruleFailures.set(issue.rule, entry);
         if (issue.rule === 17) {
           const credPatterns = [
@@ -1803,9 +1980,10 @@ var PatternAnalyzer = class _PatternAnalyzer {
     }
     const sessions = /* @__PURE__ */ new Map();
     for (const a of attempts) {
-      const list = sessions.get(a.sessionId) ?? [];
+      const buildId = a.runId ?? a.sessionId;
+      const list = sessions.get(buildId) ?? [];
       list.push(a);
-      sessions.set(a.sessionId, list);
+      sessions.set(buildId, list);
     }
     let firstTryPass = 0;
     let correctionNeeded = 0;
@@ -1852,7 +2030,7 @@ var PatternAnalyzer = class _PatternAnalyzer {
       const avgRecency = entry.recencyWeights.length > 0 ? entry.recencyWeights.reduce((s, w) => s + w, 0) / entry.recencyWeights.length : 1;
       const stickiness = stickinessCount.get(rule) ?? 0;
       const { compositeScore, factors } = this.computeCompositeScore(rawConfidence, entry.count, state, avgRecency, stickiness);
-      return {
+      const pattern = {
         rule,
         failureCount: entry.count,
         confidence: Math.round(rawConfidence * 1e3) / 1e3,
@@ -1864,6 +2042,10 @@ var PatternAnalyzer = class _PatternAnalyzer {
         exampleMessages: this.deduplicateMessages(entry.allMessages),
         mitigation: RULE_MITIGATIONS[rule] ?? null
       };
+      if (entry.workflowTypes.size > 0) {
+        pattern.workflowTypeBreakdown = Object.fromEntries(entry.workflowTypes);
+      }
+      return pattern;
     }).sort((a, b) => b.compositeScore - a.compositeScore);
     const activeRules = new Set(activePatterns.map((p) => p.rule));
     for (const p of activePatterns) {
@@ -1920,7 +2102,7 @@ var PatternAnalyzer = class _PatternAnalyzer {
       const warned = bcData.warnedRules ?? [];
       if (warned.length === 0) continue;
       const sessionFailedRules = /* @__PURE__ */ new Set();
-      const sessionAttempts = sessions.get(bc.sessionId) ?? [];
+      const sessionAttempts = sessions.get(bc.runId ?? bc.sessionId) ?? [];
       for (const a of sessionAttempts) {
         const ad = a.data;
         if (ad.validationPassed === false) {
@@ -2003,8 +2185,55 @@ var PatternAnalyzer = class _PatternAnalyzer {
     };
     const historyPath = (0, import_node_path5.join)(this.outputDir, "pattern-history.jsonl");
     await (0, import_promises3.appendFile)(historyPath, JSON.stringify(historySummary) + "\n", "utf-8");
+    const sessions = await this.buildSessionSummaries(days);
+    const sessionHistoryPath = (0, import_node_path5.join)(this.outputDir, "session-history.json");
+    const sessionHistoryTmp = `${sessionHistoryPath}.tmp`;
+    await (0, import_promises3.writeFile)(sessionHistoryTmp, JSON.stringify(sessions, null, 2), "utf-8");
+    await (0, import_promises3.rename)(sessionHistoryTmp, sessionHistoryPath);
     return analysis;
   }
+  async getSessions(limit = 20) {
+    try {
+      const raw = await (0, import_promises3.readFile)((0, import_node_path5.join)(this.outputDir, "session-history.json"), "utf-8");
+      const all = JSON.parse(raw);
+      return all.slice(-limit);
+    } catch {
+      return [];
+    }
+  }
+  async buildSessionSummaries(days = 30) {
+    const events = this._cachedEvents ?? await this.readAllEvents(days);
+    const buildCompletes = events.filter((e) => e.eventType === "build_complete");
+    const attemptsByBuild = /* @__PURE__ */ new Map();
+    for (const e of events.filter((e2) => e2.eventType === "generation_attempt")) {
+      const buildId = e.runId ?? e.sessionId;
+      const list = attemptsByBuild.get(buildId) ?? [];
+      list.push(e);
+      attemptsByBuild.set(buildId, list);
+    }
+    const summaries = buildCompletes.map((bc) => {
+      const data = bc.data;
+      const sessionAttempts = attemptsByBuild.get(bc.runId ?? bc.sessionId) ?? [];
+      const failedRules = Array.from(new Set(
+        sessionAttempts.flatMap((a) => {
+          const ad = a.data;
+          if (ad.validationPassed !== false) return [];
+          return (ad.issues ?? []).map((i) => i.rule);
+        })
+      ));
+      return {
+        sessionId: bc.sessionId,
+        date: bc.fileDate,
+        description: data.description ?? "",
+        workflowType: data.workflowType ?? null,
+        attempts: data.totalAttempts ?? 1,
+        success: data.success ?? false,
+        failedRules,
+        workflowName: data.workflowName ?? null
+      };
+    });
+    return summaries.sort((a, b) => a.date.localeCompare(b.date));
+  }
   async getHistory(limit = 20) {
     try {
       const raw = await (0, import_promises3.readFile)((0, import_node_path5.join)(this.outputDir, "pattern-history.jsonl"), "utf-8");
@@ -2026,7 +2255,7 @@ var PatternAnalyzer = class _PatternAnalyzer {
         alerts.push({
           type: "stale_pattern",
           rule: p.rule,
-          message: `Pattern references Rule ${p.rule} which does not exist in the current validator (rules 1-23)`
+          message: `Pattern references Rule ${p.rule} which does not exist in the current validator (rules 1-26)`
         });
       }
     }
@@ -2113,7 +2342,59 @@ var nullLogger = {
   }
 };
 
+// src/utils/workflow-type.ts
+var TYPE_KEYWORDS = [
+  ["gmail", "email"],
+  ["imap", "email"],
+  ["smtp", "email"],
+  [" email", "email"],
+  ["slack", "slack"],
+  ["telegram", "messaging"],
+  ["discord", "messaging"],
+  [" sms", "messaging"],
+  ["twilio", "messaging"],
+  ["webhook", "webhook"],
+  ["google sheets", "data"],
+  ["spreadsheet", "data"],
+  ["airtable", "data"],
+  ["notion", "data"],
+  ["github", "devops"],
+  ["gitlab", "devops"],
+  ["schedule", "schedule"],
+  [" cron", "schedule"],
+  ["daily", "schedule"],
+  ["weekly", "schedule"],
+  ["hourly", "schedule"],
+  ["every day", "schedule"],
+  ["every hour", "schedule"],
+  ["every morning", "schedule"],
+  ["postgres", "database"],
+  ["mysql", "database"],
+  ["supabase", "database"],
+  ["redis", "database"],
+  [" database", "database"],
+  [" llm", "ai"],
+  [" gpt", "ai"],
+  ["claude", "ai"],
+  [" agent", "ai"],
+  ["langchain", "ai"],
+  [" ai ", "ai"],
+  [" ai", "ai"],
+  ["http request", "api"],
+  ["rest api", "api"],
+  [" api", "api"]
+];
+function inferWorkflowType(description) {
+  const lower = " " + description.toLowerCase();
+  for (const [keyword, type] of TYPE_KEYWORDS) {
+    if (lower.includes(keyword)) return type;
+  }
+  return null;
+}
+
 // src/client.ts
+var import_node_os5 = require("os");
+var import_node_path6 = require("path");
 var DEFAULT_MODEL = "claude-sonnet-4-6";
 var Kairos = class {
   provider;
@@ -2142,7 +2423,8 @@ var Kairos = class {
       this.provider = null;
     }
     const anthropic = new import_sdk.default({ apiKey: options.anthropicApiKey });
-    this.designer = new WorkflowDesigner(anthropic, this.model, logger);
+    const patternsPath = typeof options.telemetry === "string" ? (0, import_node_path6.join)(options.telemetry, "..", "patterns.json") : (0, import_node_path6.join)((0, import_node_os5.homedir)(), ".kairos", "patterns.json");
+    this.designer = new WorkflowDesigner(anthropic, this.model, logger, patternsPath);
     this.validator = new N8nValidator();
     this.library = options.library ?? new NullLibrary();
     this.logger = logger;
@@ -2175,11 +2457,13 @@ var Kairos = class {
     this.validateDescription(description);
     this.logger.info("Kairos.build", { description, dryRun: options?.dryRun });
     const buildStart = Date.now();
+    const runId = generateUUID();
+    const workflowType = inferWorkflowType(description);
     await this.telemetry?.emit("build_start", {
       description,
       model: this.model,
       dryRun: options?.dryRun ?? false
-    });
+    }, runId);
     await this.library.initialize();
     const matches = await this.library.search(description);
     if (matches.length > 0) {
@@ -2214,8 +2498,9 @@ var Kairos = class {
             tokensOutput: meta.tokensOutput,
             validationPassed: meta.validationPassed,
             issueCount: meta.issues.length,
-            issues: meta.issues.map((i) => ({ rule: i.rule, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null }))
-          });
+            issues: meta.issues.map((i) => ({ rule: i.rule, severity: i.severity, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null })),
+            workflowType
+          }, runId);
         }
         await this.telemetry?.emit("build_complete", {
           description,
@@ -2228,13 +2513,14 @@ var Kairos = class {
           workflowId: null,
           dryRun: options?.dryRun ?? false,
           credentialsNeeded: 0,
-          warnedRules: err.warnedRules ?? []
-        });
+          warnedRules: err.warnedRules ?? [],
+          workflowType
+        }, runId);
         this.updatePatterns();
       }
       throw err;
     }
-    await this.emitAttemptTelemetry(description, designResult);
+    await this.emitAttemptTelemetry(description, designResult, workflowType, runId);
     const workflow = options?.name ? { ...designResult.workflow, name: options.name } : designResult.workflow;
     this.saveToLibrary(workflow, description, designResult, matches);
     if (options?.dryRun) {
@@ -2251,8 +2537,9 @@ var Kairos = class {
         workflowId: null,
         dryRun: true,
         credentialsNeeded: designResult.credentialsNeeded.length,
-        warnedRules: designResult.warnedRules
-      });
+        warnedRules: designResult.warnedRules,
+        workflowType
+      }, runId);
       this.updatePatterns();
       return {
         workflowId: null,
@@ -2283,8 +2570,9 @@ var Kairos = class {
       workflowId: deployed.workflowId,
       dryRun: false,
       credentialsNeeded: designResult.credentialsNeeded.length,
-      warnedRules: designResult.warnedRules
-    });
+      warnedRules: designResult.warnedRules,
+      workflowType
+    }, runId);
     this.updatePatterns();
     return {
       workflowId: deployed.workflowId,
@@ -2300,11 +2588,13 @@ var Kairos = class {
     this.validateDescription(description);
     this.logger.info("Kairos.update", { id, description });
     const buildStart = Date.now();
+    const runId = generateUUID();
+    const workflowType = inferWorkflowType(description);
     await this.telemetry?.emit("build_start", {
       description,
       model: this.model,
       dryRun: false
-    });
+    }, runId);
     await this.library.initialize();
     const matches = await this.library.search(description);
     const globalFailureRates = await this.telemetryReader?.getFailureRates() ?? [];
@@ -2323,8 +2613,9 @@ var Kairos = class {
             tokensOutput: meta.tokensOutput,
             validationPassed: meta.validationPassed,
             issueCount: meta.issues.length,
-            issues: meta.issues.map((i) => ({ rule: i.rule, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null }))
-          });
+            issues: meta.issues.map((i) => ({ rule: i.rule, severity: i.severity, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null })),
+            workflowType
+          }, runId);
         }
         await this.telemetry?.emit("build_complete", {
           description,
@@ -2337,13 +2628,14 @@ var Kairos = class {
           workflowId: null,
           dryRun: false,
           credentialsNeeded: 0,
-          warnedRules: err.warnedRules ?? []
-        });
+          warnedRules: err.warnedRules ?? [],
+          workflowType
+        }, runId);
         this.updatePatterns();
       }
       throw err;
     }
-    await this.emitAttemptTelemetry(description, designResult);
+    await this.emitAttemptTelemetry(description, designResult, workflowType, runId);
     const provider = this.requireProvider();
     const deployed = await provider.update(id, designResult.workflow);
     this.saveToLibrary(designResult.workflow, description, designResult, matches);
@@ -2361,8 +2653,9 @@ var Kairos = class {
       workflowId: deployed.workflowId,
       dryRun: false,
       credentialsNeeded: designResult.credentialsNeeded.length,
-      warnedRules: designResult.warnedRules
-    });
+      warnedRules: designResult.warnedRules,
+      workflowType
+    }, runId);
     this.updatePatterns();
     return {
       workflowId: deployed.workflowId,
@@ -2385,7 +2678,7 @@ var Kairos = class {
       return null;
     });
   }
-  async emitAttemptTelemetry(description, designResult) {
+  async emitAttemptTelemetry(description, designResult, workflowType, runId) {
     for (const meta of designResult.attemptMetadata) {
       await this.telemetry?.emit("generation_attempt", {
         description,
@@ -2396,8 +2689,9 @@ var Kairos = class {
         tokensOutput: meta.tokensOutput,
         validationPassed: meta.validationPassed,
         issueCount: meta.issues.length,
-        issues: meta.issues.map((i) => ({ rule: i.rule, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null }))
-      });
+        issues: meta.issues.map((i) => ({ rule: i.rule, severity: i.severity, message: i.message, nodeId: i.nodeId ?? null, nodeType: i.nodeType ?? null })),
+        workflowType
+      }, runId);
     }
   }
   recordDeploy() {
@@ -2496,8 +2790,8 @@ var Kairos = class {
 
 // src/library/file-library.ts
 var import_promises4 = require("fs/promises");
-var import_node_path6 = require("path");
-var import_node_os5 = require("os");
+var import_node_path7 = require("path");
+var import_node_os6 = require("os");
 
 // src/library/scorer.ts
 var WEIGHTS = {
@@ -2727,13 +3021,27 @@ function buildSearchCorpus(w) {
   return `${w.description} ${w.workflow.name} ${w.tags.join(" ")} ${nodeTokens.join(" ")}`;
 }
 var MAX_LIBRARY_SIZE = 500;
+function isValidMeta(item) {
+  return typeof item === "object" && item !== null && typeof item.id === "string" && typeof item.description === "string" && typeof item.workflowName === "string" && Array.isArray(item.cachedNodeTypes);
+}
+function isValidOldEntry(item) {
+  return typeof item === "object" && item !== null && typeof item.id === "string" && typeof item.description === "string" && typeof item.workflow === "object" && item.workflow !== null && Array.isArray(
+    item.workflow.nodes
+  );
+}
 var FileLibrary = class {
   dir;
-  workflows = [];
+  meta = [];
   initPromise = null;
   writeQueue = Promise.resolve();
   constructor(dir) {
-    this.dir = dir ?? (0, import_node_path6.join)((0, import_node_os5.homedir)(), ".kairos", "library");
+    this.dir = dir ?? (0, import_node_path7.join)((0, import_node_os6.homedir)(), ".kairos", "library");
+  }
+  get workflowsDir() {
+    return (0, import_node_path7.join)(this.dir, "workflows");
+  }
+  workflowFilePath(id) {
+    return (0, import_node_path7.join)(this.workflowsDir, `${id}.json`);
   }
   async initialize() {
     if (!this.initPromise) {
@@ -2743,61 +3051,148 @@ var FileLibrary = class {
   }
   async doInitialize() {
     await (0, import_promises4.mkdir)(this.dir, { recursive: true });
-    const indexPath = (0, import_node_path6.join)(this.dir, "index.json");
+    const indexPath = (0, import_node_path7.join)(this.dir, "index.json");
+    let workflowsDirExists = false;
     try {
-      const raw = await (0, import_promises4.readFile)(indexPath, "utf-8");
-      const parsed = JSON.parse(raw);
-      if (!Array.isArray(parsed)) {
-        this.workflows = [];
-      } else {
-        this.workflows = parsed.filter(
-          (item) => typeof item === "object" && item !== null && typeof item.id === "string" && typeof item.description === "string" && typeof item.workflow === "object" && item.workflow !== null && Array.isArray(item.workflow.nodes)
-        );
+      await (0, import_promises4.stat)(this.workflowsDir);
+      workflowsDirExists = true;
+    } catch {
+    }
+    if (workflowsDirExists) {
+      try {
+        const raw = await (0, import_promises4.readFile)(indexPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+          this.meta = parsed.filter(isValidMeta);
+        }
+      } catch {
+        this.meta = [];
+      }
+    } else {
+      try {
+        const raw = await (0, import_promises4.readFile)(indexPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed) && parsed.length > 0 && isValidOldEntry(parsed[0])) {
+          await this.migrateFromMonolithic(parsed.filter(isValidOldEntry));
+          return;
+        }
+      } catch {
       }
+      this.meta = [];
+      await (0, import_promises4.mkdir)(this.workflowsDir, { recursive: true });
+    }
+  }
+  /**
+   * One-time transparent migration from v0.4.x monolithic index.json.
+   * Splits each stored workflow into a per-file workflow JSON and a lightweight
+   * meta entry. Rewrites index.json in the new format.
+   */
+  async migrateFromMonolithic(oldEntries) {
+    await (0, import_promises4.mkdir)(this.workflowsDir, { recursive: true });
+    const newMeta = [];
+    for (const entry of oldEntries) {
+      const wfPath = this.workflowFilePath(entry.id);
+      const tmpPath = `${wfPath}.tmp`;
+      await (0, import_promises4.writeFile)(tmpPath, JSON.stringify(entry.workflow), "utf-8");
+      await (0, import_promises4.rename)(tmpPath, wfPath);
+      const { workflow, ...metaFields } = entry;
+      newMeta.push({
+        ...metaFields,
+        workflowName: workflow.name,
+        cachedNodeTypes: workflow.nodes.map((n) => n.type)
+      });
+    }
+    this.meta = newMeta;
+    await this.persistNow();
+  }
+  async loadWorkflowFile(id) {
+    try {
+      const raw = await (0, import_promises4.readFile)(this.workflowFilePath(id), "utf-8");
+      return JSON.parse(raw);
     } catch {
-      this.workflows = [];
+      return null;
     }
   }
+  async writeWorkflowFile(id, workflow) {
+    const wfPath = this.workflowFilePath(id);
+    const tmpPath = `${wfPath}.tmp`;
+    await (0, import_promises4.writeFile)(tmpPath, JSON.stringify(workflow), "utf-8");
+    await (0, import_promises4.rename)(tmpPath, wfPath);
+  }
+  /**
+   * Build a lightweight StoredWorkflow shell from a meta entry for use in
+   * scoring / clustering. Only node.type is populated in each node — no other
+   * node fields are used by hybridScore or clusterWorkflows.
+   */
+  makeSearchShell(m) {
+    return {
+      ...m,
+      workflow: {
+        name: m.workflowName,
+        nodes: m.cachedNodeTypes.map((type) => ({
+          id: "",
+          name: "",
+          type,
+          typeVersion: 1,
+          position: [0, 0],
+          parameters: {}
+        })),
+        connections: {}
+      }
+    };
+  }
   async search(description, options) {
-    const searchable = this.workflows.filter((w) => w.trustLevel !== "blocked");
-    if (searchable.length === 0) return [];
+    const filteredMeta = this.meta.filter((m) => m.trustLevel !== "blocked");
+    if (filteredMeta.length === 0) return [];
     const limit = options?.limit ?? 3;
     const queryTokens = tokenize(description);
     if (queryTokens.length === 0) return [];
-    const docTokenArrays = searchable.map((w) => tokenize(buildSearchCorpus(w)));
+    const shells = filteredMeta.map((m) => this.makeSearchShell(m));
+    const docTokenArrays = shells.map((w) => tokenize(buildSearchCorpus(w)));
     const docTokenSets = docTokenArrays.map((tokens) => new Set(tokens));
-    const docCount = searchable.length;
+    const docCount = shells.length;
     const idf = /* @__PURE__ */ new Map();
     const allTokens = new Set(queryTokens);
     for (const token of allTokens) {
       const docsWithToken = docTokenSets.filter((d) => d.has(token)).length;
       idf.set(token, Math.log((docCount + 1) / (docsWithToken + 1)) + 1);
     }
-    const scored = hybridScore(queryTokens, description, searchable, docTokenArrays, idf).filter((m) => m.score > 0).sort((a, b) => b.score - a.score);
-    const clusters = clusterWorkflows(searchable);
+    const scored = hybridScore(queryTokens, description, shells, docTokenArrays, idf).filter((m) => m.score > 0).sort((a, b) => b.score - a.score);
+    const clusters = clusterWorkflows(shells);
     const reranked = rerank(scored, clusters).slice(0, limit);
-    const results = reranked.map((m) => {
-      return { workflow: m.workflow, score: m.score, mode: scoreToMode(m.score) };
-    });
-    if (results.length > 0) {
-      for (const r of results) {
-        r.workflow.timesRetrieved = (r.workflow.timesRetrieved ?? 0) + 1;
-      }
-      this.persist();
-    }
-    return results;
+    if (reranked.length === 0) return [];
+    for (const r of reranked) {
+      const m = this.meta.find((m2) => m2.id === r.workflow.id);
+      if (m) m.timesRetrieved = (m.timesRetrieved ?? 0) + 1;
+    }
+    this.persist();
+    const results = await Promise.all(
+      reranked.map(async (r) => {
+        const m = this.meta.find((meta) => meta.id === r.workflow.id);
+        const workflow = await this.loadWorkflowFile(r.workflow.id);
+        if (!workflow) return null;
+        return {
+          workflow: { ...m, workflow },
+          score: r.score,
+          mode: scoreToMode(r.score)
+        };
+      })
+    );
+    return results.filter((r) => r !== null);
   }
   async save(workflow, metadata) {
     const id = generateUUID();
+    await this.writeWorkflowFile(id, workflow);
     const failurePatterns = this.deduplicateFailurePatterns(metadata.failurePatterns);
-    const stored = {
+    const meta = {
       id,
-      workflow,
       description: metadata.description,
       tags: metadata.tags ?? [],
       platform: metadata.platform ?? "n8n",
       deployCount: 0,
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      workflowName: workflow.name,
+      cachedNodeTypes: workflow.nodes.map((n) => n.type),
       ...failurePatterns?.length ? { failurePatterns } : {},
       ...metadata.sourceWorkflowIds?.length ? { sourceWorkflowIds: metadata.sourceWorkflowIds } : {},
       ...metadata.generationMode ? { generationMode: metadata.generationMode } : {},
@@ -2809,31 +3204,35 @@ var FileLibrary = class {
       ...metadata.sourceUrl ? { sourceUrl: metadata.sourceUrl } : {},
       ...metadata.trustLevel ? { trustLevel: metadata.trustLevel } : {}
     };
-    this.workflows.push(stored);
-    if (this.workflows.length > MAX_LIBRARY_SIZE) {
-      this.workflows.sort((a, b) => (b.deployCount ?? 1) - (a.deployCount ?? 1));
-      this.workflows = this.workflows.slice(0, MAX_LIBRARY_SIZE);
+    this.meta.push(meta);
+    if (this.meta.length > MAX_LIBRARY_SIZE) {
+      this.meta.sort((a, b) => {
+        if (a.id === id) return -1;
+        if (b.id === id) return 1;
+        return (b.deployCount ?? 0) - (a.deployCount ?? 0);
+      });
+      this.meta = this.meta.slice(0, MAX_LIBRARY_SIZE);
     }
     await this.persist();
     return id;
   }
   async recordDeployment(id) {
-    const w = this.workflows.find((w2) => w2.id === id);
-    if (w) {
-      w.deployCount++;
-      w.lastDeployedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const m = this.meta.find((m2) => m2.id === id);
+    if (m) {
+      m.deployCount++;
+      m.lastDeployedAt = (/* @__PURE__ */ new Date()).toISOString();
       await this.persist();
     }
   }
   async recordOutcome(id, outcome) {
-    const w = this.workflows.find((w2) => w2.id === id);
-    if (!w) return;
+    const m = this.meta.find((m2) => m2.id === id);
+    if (!m) return;
     if (outcome.mode === "direct") {
-      w.timesUsedAsDirect = (w.timesUsedAsDirect ?? 0) + 1;
+      m.timesUsedAsDirect = (m.timesUsedAsDirect ?? 0) + 1;
     } else {
-      w.timesUsedAsReference = (w.timesUsedAsReference ?? 0) + 1;
+      m.timesUsedAsReference = (m.timesUsedAsReference ?? 0) + 1;
     }
-    const stats = w.outcomeStats ?? { totalUses: 0, totalAttempts: 0, firstTryPasses: 0, failedRules: {} };
+    const stats = m.outcomeStats ?? { totalUses: 0, totalAttempts: 0, firstTryPasses: 0, failedRules: {} };
     stats.totalUses++;
     stats.totalAttempts += outcome.attempts;
     if (outcome.firstTryPass) stats.firstTryPasses++;
@@ -2841,24 +3240,35 @@ var FileLibrary = class {
       const key = String(rule);
       stats.failedRules[key] = (stats.failedRules[key] ?? 0) + 1;
     }
-    w.outcomeStats = stats;
+    m.outcomeStats = stats;
     await this.persist();
   }
   async drain() {
     await this.writeQueue;
   }
   async get(id) {
-    return this.workflows.find((w) => w.id === id) ?? null;
+    const m = this.meta.find((m2) => m2.id === id);
+    if (!m) return null;
+    const workflow = await this.loadWorkflowFile(id);
+    if (!workflow) return null;
+    return { ...m, workflow };
   }
   async list(filters) {
-    let result = this.workflows;
+    let filtered = this.meta;
     if (filters?.platform) {
-      result = result.filter((w) => w.platform === filters.platform);
+      filtered = filtered.filter((m) => m.platform === filters.platform);
     }
     if (filters?.tags && filters.tags.length > 0) {
-      result = result.filter((w) => filters.tags.some((t) => w.tags.includes(t)));
+      filtered = filtered.filter((m) => filters.tags.some((t) => m.tags.includes(t)));
     }
-    return result;
+    const results = await Promise.all(
+      filtered.map(async (m) => {
+        const workflow = await this.loadWorkflowFile(m.id);
+        if (!workflow) return null;
+        return { ...m, workflow };
+      })
+    );
+    return results.filter((r) => r !== null);
   }
   deduplicateFailurePatterns(patterns) {
     if (!patterns?.length) return void 0;
@@ -2873,11 +3283,36 @@ var FileLibrary = class {
     }
     return [...map.values()];
   }
+  /**
+   * Direct write used only during migration (before writeQueue is needed).
+   */
+  async persistNow() {
+    const indexPath = (0, import_node_path7.join)(this.dir, "index.json");
+    const tmpPath = `${indexPath}.tmp`;
+    await (0, import_promises4.writeFile)(tmpPath, JSON.stringify(this.meta, null, 2), "utf-8");
+    await (0, import_promises4.rename)(tmpPath, indexPath);
+  }
   persist() {
     this.writeQueue = this.writeQueue.then(async () => {
-      const indexPath = (0, import_node_path6.join)(this.dir, "index.json");
+      const indexPath = (0, import_node_path7.join)(this.dir, "index.json");
+      let onDisk = [];
+      try {
+        const raw = await (0, import_promises4.readFile)(indexPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+          onDisk = parsed.filter(isValidMeta);
+        }
+      } catch {
+      }
+      const ourIds = new Set(this.meta.map((m) => m.id));
+      const external = onDisk.filter((m) => !ourIds.has(m.id));
+      let merged = [...this.meta, ...external];
+      if (merged.length > MAX_LIBRARY_SIZE) {
+        merged.sort((a, b) => (b.deployCount ?? 0) - (a.deployCount ?? 0));
+        merged = merged.slice(0, MAX_LIBRARY_SIZE);
+      }
       const tmpPath = `${indexPath}.tmp`;
-      await (0, import_promises4.writeFile)(tmpPath, JSON.stringify(this.workflows, null, 2), "utf-8");
+      await (0, import_promises4.writeFile)(tmpPath, JSON.stringify(merged, null, 2), "utf-8");
       await (0, import_promises4.rename)(tmpPath, indexPath);
     });
     return this.writeQueue;
@@ -3067,6 +3502,7 @@ Usage:
   kairos init                         First-time setup wizard
   kairos build <description> [options]
   kairos patterns [options]
+  kairos sessions [options]
   kairos list
   kairos get <id>
   kairos activate <id>
@@ -3083,15 +3519,23 @@ Patterns options:
   --days <days>   Analysis window (default: 30)
   --json          Output raw JSON instead of summary
 
+Sessions options:
+  --limit <n>     Number of recent sessions to show (default: 20)
+  --json          Output raw JSON instead of summary
+
 Sync options:
   --max <count>   Maximum templates to fetch (default: 500)
 
 Environment variables:
-  ANTHROPIC_API_KEY  Anthropic API key (required)
-  N8N_BASE_URL       n8n instance URL (required for deploy, optional for --dry-run)
-  N8N_API_KEY        n8n API key (required for deploy, optional for --dry-run)
-  KAIROS_MODEL       Claude model override (default: claude-sonnet-4-6)
-  KAIROS_TELEMETRY   Set to "true" or a directory path to enable telemetry logging
+  ANTHROPIC_API_KEY       Anthropic API key (required)
+  N8N_BASE_URL            n8n instance URL (required for deploy, optional for --dry-run)
+  N8N_API_KEY             n8n API key (required for deploy, optional for --dry-run)
+  KAIROS_MODEL            Claude model override (default: claude-sonnet-4-6)
+  KAIROS_TELEMETRY        Set to "true" or a directory path to enable telemetry logging
+  KAIROS_PROMPT_PROFILE   minimal | standard | rich (default: standard)
+                          minimal: base prompt only, no library context, top 3 patterns
+                          standard: full library context, top 10 patterns (default)
+                          rich: full library context, top 15 patterns, proactive expression guidance
 `;
 function getEnvOrExit(name) {
   const val = process.env[name];
@@ -3253,7 +3697,8 @@ async function handleDelete(positional, flags) {
   console.log(`Deleted workflow ${id}`);
 }
 async function handleSyncTemplates(flags) {
-  const max = typeof flags["max"] === "string" ? parseInt(flags["max"], 10) : 500;
+  const maxRaw = typeof flags["max"] === "string" ? parseInt(flags["max"], 10) : NaN;
+  const max = Number.isNaN(maxRaw) ? 500 : maxRaw;
   const library = new FileLibrary();
   const logger = {
     debug: () => {
@@ -3281,7 +3726,8 @@ async function handleSyncTemplates(flags) {
   console.error(`  Paid:       ${result.skippedPaid} (skipped)`);
 }
 async function handlePatterns(flags) {
-  const days = typeof flags["days"] === "string" ? parseInt(flags["days"], 10) : 30;
+  const daysRaw = typeof flags["days"] === "string" ? parseInt(flags["days"], 10) : NaN;
+  const days = Number.isNaN(daysRaw) ? 30 : daysRaw;
   const analyzer = PatternAnalyzer.fromEnv();
   const analysis = await analyzer.analyzeAndSave(days);
   if (flags["json"] === true) {
@@ -3315,6 +3761,10 @@ Active Failure Patterns:`);
       console.log(`    Factors: confidence=${f.rawConfidence} \xD7 impact=${f.impact} \xD7 recency=${f.recency} + boost=${f.stickinessBoost}`);
       if (p.mitigation) console.log(`    Fix: ${p.mitigation}`);
       if (p.exampleMessages.length > 0) console.log(`    e.g. ${p.exampleMessages[0]}`);
+      if (p.workflowTypeBreakdown) {
+        const topType = Object.entries(p.workflowTypeBreakdown).sort((a, b) => b[1] - a[1])[0];
+        if (topType) console.log(`    Top workflow type: ${topType[0]} (${topType[1]} failures)`);
+      }
     }
   } else {
     console.log(`
@@ -3355,10 +3805,35 @@ Drift Detection: ${drift.healthy ? "HEALTHY" : "ALERTS FOUND"}`);
   console.log(`
 Patterns saved to ~/.kairos/patterns.json`);
 }
+async function handleSessions(flags) {
+  const limitRaw = typeof flags["limit"] === "string" ? parseInt(flags["limit"], 10) : NaN;
+  const limit = Number.isNaN(limitRaw) ? 20 : limitRaw;
+  const analyzer = PatternAnalyzer.fromEnv();
+  const sessions = await analyzer.getSessions(limit);
+  if (flags["json"] === true) {
+    console.log(JSON.stringify(sessions, null, 2));
+    return;
+  }
+  if (sessions.length === 0) {
+    console.log("No session history found. Run kairos patterns first to generate session data.");
+    return;
+  }
+  console.log(`
+Recent Sessions (last ${sessions.length})`);
+  console.log("\u2500".repeat(60));
+  for (const s of [...sessions].reverse()) {
+    const status = s.success ? "\u2713" : "\u2717";
+    const typeTag = s.workflowType ? ` [${s.workflowType}]` : "";
+    const attemptsStr = s.attempts > 1 ? ` (${s.attempts} attempts)` : "";
+    const nameStr = s.workflowName ? `  ${s.workflowName}` : `  ${s.description.slice(0, 50)}`;
+    const rulesStr = s.failedRules.length > 0 ? `  \u2014 rules ${s.failedRules.join(", ")} failed` : "";
+    console.log(`${s.date}  ${status}${nameStr}${attemptsStr}${typeTag}${rulesStr}`);
+  }
+}
 async function handleInit() {
   const { writeFile: writeFile3, readFile: readFile2, mkdir: mkdir4 } = await import("fs/promises");
-  const { join: join7 } = await import("path");
-  const { homedir: homedir6 } = await import("os");
+  const { join: join8 } = await import("path");
+  const { homedir: homedir7 } = await import("os");
   const readline = await import("readline");
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
   const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
@@ -3366,7 +3841,7 @@ async function handleInit() {
   console.error("  Kairos SDK \u2014 Setup Wizard");
   console.error("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
   console.error("");
-  const envPath = join7(process.cwd(), ".env");
+  const envPath = join8(process.cwd(), ".env");
   let existingEnv = "";
   try {
     existingEnv = await readFile2(envPath, "utf-8");
@@ -3430,8 +3905,8 @@ async function handleInit() {
     });
     console.error(`  Synced ${result.saved} templates (${result.blocked} blocked, ${result.skippedDuplicate} duplicates)`);
   }
-  const kairosDir = join7(homedir6(), ".kairos");
-  await mkdir4(join7(kairosDir, "telemetry"), { recursive: true });
+  const kairosDir = join8(homedir7(), ".kairos");
+  await mkdir4(join8(kairosDir, "telemetry"), { recursive: true });
   console.error("");
   console.error("  Setup complete! Try:");
   console.error("");
@@ -3454,6 +3929,9 @@ async function main() {
     case "patterns":
       await handlePatterns(flags);
       break;
+    case "sessions":
+      await handleSessions(flags);
+      break;
     case "list":
       await handleList();
       break;