@lhi/n8m 0.1.2 → 0.2.0

package/README.md

@@ -1,12 +1,15 @@
 # n8m: The Agentic CLI for n8n
 
-> Generate, modify, test, and deploy n8n workflows from the command line using AI.
+> Generate, modify, test, and deploy n8n workflows from the command line using
+> AI.
 
 [![TypeScript](https://badgen.net/badge/Built%20with/TypeScript/blue)](https://typescriptlang.org/)
 [![oclif](https://badgen.net/badge/CLI/oclif/purple)](https://oclif.io/)
 [![n8n](https://badgen.net/badge/n8n/Compatible/orange)](https://n8n.io)
 
-**Stop clicking. Start shipping.** `n8m` is an open-source CLI that wraps your n8n instance with an agentic AI layer. Describe what you want in plain English — the agent designs, builds, validates, and deploys it.
+**Stop clicking. Start shipping.** `n8m` is an open-source CLI that wraps your
+n8n instance with an agentic AI layer. Describe what you want in plain English —
+the agent designs, builds, validates, and deploys it.
 
 No account. No server. Bring your own AI key and your n8n instance.
 
@@ -26,7 +29,8 @@ npm install -g n8m
 
 ### 1. Configure your AI provider
 
-`n8m` stores credentials in `~/.n8m/config.json` so they persist across sessions — including `npx` invocations.
+`n8m` stores credentials in `~/.n8m/config.json` so they persist across sessions
+— including `npx` invocations.
 
 ```bash
 # OpenAI
@@ -42,13 +46,14 @@ npx n8m config --ai-provider gemini --ai-key AIza...
 npx n8m config --ai-base-url http://localhost:11434/v1 --ai-key ollama --ai-model llama3
 ```
 
-You can also use environment variables or a `.env` file — env vars take priority over stored config:
+You can also use environment variables or a `.env` file — env vars take priority
+over stored config:
 
-| Variable | Description |
-|---|---|
-| `AI_PROVIDER` | Preset: `openai`, `anthropic`, or `gemini` |
-| `AI_API_KEY` | API key for your provider |
-| `AI_MODEL` | Override the model (optional) |
+| Variable      | Description                                              |
+| ------------- | -------------------------------------------------------- |
+| `AI_PROVIDER` | Preset: `openai`, `anthropic`, or `gemini`               |
+| `AI_API_KEY`  | API key for your provider                                |
+| `AI_MODEL`    | Override the model (optional)                            |
 | `AI_BASE_URL` | Custom base URL for any OpenAI-compatible API (optional) |
 
 Default models per provider: `gpt-4o` · `claude-sonnet-4-6` · `gemini-2.5-flash`
@@ -59,7 +64,8 @@ Default models per provider: `gpt-4o` · `claude-sonnet-4-6` · `gemini-2.5-flas
 npx n8m config --n8n-url https://your-n8n.example.com --n8n-key <your-n8n-api-key>
 ```
 
-Credentials are saved locally to `~/.n8m/config.json`. You can also use environment variables `N8N_API_URL` and `N8N_API_KEY` instead.
+Credentials are saved locally to `~/.n8m/config.json`. You can also use
+environment variables `N8N_API_URL` and `N8N_API_KEY` instead.
 
 ---
 
@@ -67,7 +73,8 @@ Credentials are saved locally to `~/.n8m/config.json`. You can also use environm
 
 ### `n8m create` — Generate a workflow
 
-Describe what you want and the agentic pipeline designs, builds, and validates it.
+Describe what you want and the agentic pipeline designs, builds, and validates
+it.
 
 ```bash
 n8m create "Send a Slack message whenever a new row is added to a Google Sheet"
@@ -80,11 +87,17 @@ n8m create --multiline
 ```
 
 The agent runs through three stages:
+
 1. **Architect** — designs the blueprint and identifies required nodes
 2. **Engineer** — generates the workflow JSON
 3. **QA** — validates the result; loops back to Engineer if issues are found
 
-The finished workflow is saved as a local JSON file (default: `./workflows/`).
+The finished workflow is saved as an organized project folder (default:
+`./workflows/<project-slug>/`). Each project folder contains:
+
+- `workflow.json`: The generated n8n workflow.
+- `README.md`: Automatic documentation including a Mermaid.js diagram and an
+  AI-generated summary.
 
 ---
 
@@ -103,13 +116,34 @@ n8m modify
 n8m modify --multiline
 ```
 
-After modification you'll be prompted to save locally, deploy to your instance, or run a test.
+After modification you'll be prompted to save locally (organized into its
+project folder), deploy to your instance, or run a test.
+
+---
+
+### `n8m doc` — Generate documentation
+
+Generate visual and text documentation for existing local or remote workflows.
+
+```bash
+# Document a local workflow file
+n8m doc ./workflows/my-workflow.json
+
+# Browse and select from local files + remote instance
+n8m doc
+```
+
+- Generates a `README.md` in the workflow's project directory.
+- Includes a **Mermaid.js** flowchart of the workflow logic.
+- Includes an **AI-generated summary** of the nodes and execution flow.
+- Automatically organizes loose `.json` files into project folders.
 
 ---
 
 ### `n8m test` — Validate and auto-repair a workflow
 
-Deploys a workflow ephemerally to your instance, validates it, and purges it when done. If validation fails, the repair loop kicks in automatically.
+Deploys a workflow ephemerally to your instance, validates it, and purges it
+when done. If validation fails, the repair loop kicks in automatically.
 
 ```bash
 # Test a local file
@@ -122,6 +156,7 @@ n8m test
 - Resolves and deploys sub-workflow dependencies automatically
 - Patches node IDs after ephemeral deployment
 - After a passing test, prompts to deploy or save the validated/repaired version
+- **Auto-documents**: Generates or updates the project `README.md` upon saving.
 - All temporary assets are deleted on exit
 
 ---
@@ -141,19 +176,22 @@ n8m deploy ./workflows/my-flow.json --activate
 
 ### `n8m resume` — Resume a paused session
 
-The agent can pause mid-run for human review (HITL). Resume it with its thread ID.
+The agent can pause mid-run for human review (HITL). Resume it with its thread
+ID.
 
 ```bash
 n8m resume <thread-id>
 ```
 
-Sessions are persisted to a local SQLite database, so they survive crashes and restarts.
+Sessions are persisted to a local SQLite database, so they survive crashes and
+restarts.
 
 ---
 
 ### `n8m prune` — Clean up your instance
 
-Removes duplicate workflows and leftover test artifacts (`[n8m:test:*]` prefixed names).
+Removes duplicate workflows and leftover test artifacts (`[n8m:test:*]` prefixed
+names).
 
 ```bash
 # Preview what would be deleted
@@ -167,7 +205,8 @@ n8m prune --force
 
 ### `n8m config` — Manage configuration
 
-All credentials are saved to `~/.n8m/config.json` and persist across sessions (including `npx` invocations).
+All credentials are saved to `~/.n8m/config.json` and persist across sessions
+(including `npx` invocations).
 
 ```bash
 # Set AI provider
@@ -209,13 +248,23 @@ Developer → n8m create "..."
         └──────┬──────┘       └─────────────┘
                │ passed
                ▼
-        ./workflows/output.json
+                ▼
+        ./workflows/<slug>/
+           ├── workflow.json
+           └── README.md (with Mermaid diagram)
 ```
 
 - **Local first**: credentials and workflow files live on your machine
+- **Organized Projects**: Workflows are grouped into folders with auto-generated
+  documentation
 - **SQLite persistence**: session state survives interruptions
 - **HITL pauses**: the agent stops for your review before committing
-- **Bring your own AI**: works with OpenAI, Claude, Gemini, Ollama, or any OpenAI-compatible API
+- **Bring your own AI**: works with OpenAI, Claude, Gemini, Ollama, or any
+  OpenAI-compatible API
+
+> **For developers**: See the [Developer Guide](docs/DEVELOPER_GUIDE.md) for a
+> deep-dive into the agentic graph internals, RAG implementation, how to add new
+> agent nodes, and how to extend the CLI.
 
 ---
 
@@ -235,6 +284,14 @@ npm run dev
 
 ---
 
+## Sponsors
+
+### Partially Sponsored By
+
+[The Daily Caller](https://dailycaller.com)
+
+---
+
 ## Roadmap
 
 - [x] Agentic graph (Architect → Engineer → QA)
@@ -242,6 +299,12 @@ npm run dev
 - [x] HITL interrupts and resume
 - [x] Sub-workflow dependency resolution in tests
 - [x] Open source — no account required
-- [x] Multi-provider AI support (OpenAI, Claude, Gemini, Ollama, any OpenAI-compatible API)
+- [x] Multi-provider AI support (OpenAI, Claude, Gemini, Ollama, any
+      OpenAI-compatible API)
+- [x] Automatic documentation generation (Mermaid + AI Summary)
+- [x] Project-based folder organization
+- [x] AI-driven test scenario generation (`--ai-scenarios`)
+- [x] Static node type reference & fallback mechanism
+- [x] Multi-workflow project generation support
 - [ ] Native n8n canvas integration
 - [ ] Multi-agent collaboration on a single goal

package/bin/dev.js

@@ -1,5 +1,13 @@
 #!/usr/bin/env node --loader ts-node/esm --no-warnings=ExperimentalWarning
 
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { config } from 'dotenv';
+
+// Load .env from the package root regardless of the user's cwd
+const __dirname = dirname(fileURLToPath(import.meta.url));
+config({ path: join(__dirname, '..', '.env') });
+
 import {execute} from '@oclif/core'
 
 await execute({development: true, dir: import.meta.url})

package/bin/run.js

@@ -1,5 +1,11 @@
 #!/usr/bin/env node
-import 'dotenv/config';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { config } from 'dotenv';
+
+// Load .env from the package root regardless of the user's cwd
+const __dirname = dirname(fileURLToPath(import.meta.url));
+config({ path: join(__dirname, '..', '.env') });
 
 import {execute} from '@oclif/core'
 

package/dist/agentic/graph.d.ts

@@ -13,6 +13,8 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
     candidates: any[];
     customTools: Record<string, string>;
     collaborationLog: string[];
+    userFeedback: string;
+    testScenarios: any[];
 }, {
     userGoal?: string | undefined;
     spec?: any;
@@ -27,6 +29,8 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
     candidates?: any[] | undefined;
     customTools?: Record<string, string> | undefined;
     collaborationLog?: string[] | undefined;
+    userFeedback?: string | undefined;
+    testScenarios?: any[] | undefined;
 }, "__start__" | "architect" | "engineer" | "reviewer" | "supervisor" | "qa", {
     userGoal: {
         (): import("@langchain/langgraph").LastValue<string>;
@@ -77,6 +81,16 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
     candidates: import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
     customTools: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
     collaborationLog: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    userFeedback: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    testScenarios: {
+        (): import("@langchain/langgraph").LastValue<any[]>;
+        (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
 }, {
     userGoal: {
         (): import("@langchain/langgraph").LastValue<string>;
@@ -127,11 +141,33 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
     candidates: import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
     customTools: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
     collaborationLog: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    userFeedback: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    testScenarios: {
+        (): import("@langchain/langgraph").LastValue<any[]>;
+        (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
 }, import("@langchain/langgraph").StateDefinition, {
     architect: {
-        spec: any;
-        strategies: any[];
-        needsClarification: any;
+        spec: import("../services/ai.service.js").WorkflowSpec;
+        strategies: {
+            strategyName: string;
+            aiModel: string;
+            suggestedName: string;
+            description: string;
+            nodes: {
+                type: string;
+                purpose: string;
+                config?: any;
+            }[];
+            questions?: string[];
+            aiProvider?: string;
+        }[];
+        needsClarification: boolean | undefined;
         collaborationLog: string[];
     };
     engineer: {
@@ -141,8 +177,8 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
         workflowJson?: undefined;
         candidates?: undefined;
     } | {
-        workflowJson: any;
         candidates: any[];
+        workflowJson?: undefined;
     };
     reviewer: import("@langchain/langgraph").UpdateType<{
         userGoal: {
@@ -194,6 +230,16 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
         candidates: import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
         customTools: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
         collaborationLog: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        userFeedback: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        testScenarios: {
+            (): import("@langchain/langgraph").LastValue<any[]>;
+            (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
     }>;
     supervisor: {
         workflowJson?: undefined;
@@ -252,6 +298,16 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
         candidates: import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
         customTools: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
         collaborationLog: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        userFeedback: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        testScenarios: {
+            (): import("@langchain/langgraph").LastValue<any[]>;
+            (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
     }>;
 }, unknown, unknown>;
 /**
@@ -310,6 +366,16 @@ export declare const runAgenticWorkflow: (goal: string, initialState?: Partial<t
     candidates: import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
     customTools: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
     collaborationLog: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    userFeedback: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    testScenarios: {
+        (): import("@langchain/langgraph").LastValue<any[]>;
+        (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
 }>>;
 /**
  * Run the Agentic Workflow with Streaming
@@ -318,9 +384,21 @@ export declare const runAgenticWorkflow: (goal: string, initialState?: Partial<t
  */
 export declare const runAgenticWorkflowStream: (goal: string, threadId?: string) => Promise<import("@langchain/core/utils/stream").IterableReadableStream<{
     architect?: {
-        spec: any;
-        strategies: any[];
-        needsClarification: any;
+        spec: import("../services/ai.service.js").WorkflowSpec;
+        strategies: {
+            strategyName: string;
+            aiModel: string;
+            suggestedName: string;
+            description: string;
+            nodes: {
+                type: string;
+                purpose: string;
+                config?: any;
+            }[];
+            questions?: string[];
+            aiProvider?: string;
+        }[];
+        needsClarification: boolean | undefined;
         collaborationLog: string[];
     } | undefined;
     engineer?: {
@@ -330,8 +408,8 @@ export declare const runAgenticWorkflowStream: (goal: string, threadId?: string)
         workflowJson?: undefined;
         candidates?: undefined;
     } | {
-        workflowJson: any;
         candidates: any[];
+        workflowJson?: undefined;
     } | undefined;
     reviewer?: import("@langchain/langgraph").UpdateType<{
         userGoal: {
@@ -383,6 +461,16 @@ export declare const runAgenticWorkflowStream: (goal: string, threadId?: string)
         candidates: import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
         customTools: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
         collaborationLog: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        userFeedback: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        testScenarios: {
+            (): import("@langchain/langgraph").LastValue<any[]>;
+            (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
     }> | undefined;
     supervisor?: {
         workflowJson?: undefined;
@@ -441,6 +529,16 @@ export declare const runAgenticWorkflowStream: (goal: string, threadId?: string)
         candidates: import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
         customTools: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
         collaborationLog: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        userFeedback: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        testScenarios: {
+            (): import("@langchain/langgraph").LastValue<any[]>;
+            (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
     }> | undefined;
 }>>;
 /**
@@ -496,4 +594,14 @@ export declare const resumeAgenticWorkflow: (threadId: string, input?: any) => P
     candidates: import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
     customTools: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
     collaborationLog: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    userFeedback: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    testScenarios: {
+        (): import("@langchain/langgraph").LastValue<any[]>;
+        (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
 }>>;

package/dist/agentic/graph.js

@@ -53,7 +53,7 @@ const workflow = new StateGraph(TeamState)
 // Compile the graph with persistence and interrupts
 export const graph = workflow.compile({
     checkpointer: checkpointer,
-    interruptBefore: ["qa"],
+    interruptBefore: ["engineer", "qa"],
 });
 /**
  * Run the Agentic Workflow

package/dist/agentic/nodes/architect.d.ts

@@ -1,7 +1,19 @@
 import { TeamState } from "../state.js";
 export declare const architectNode: (state: typeof TeamState.State) => Promise<{
-    spec: any;
-    strategies: any[];
-    needsClarification: any;
+    spec: import("../../services/ai.service.js").WorkflowSpec;
+    strategies: {
+        strategyName: string;
+        aiModel: string;
+        suggestedName: string;
+        description: string;
+        nodes: {
+            type: string;
+            purpose: string;
+            config?: any;
+        }[];
+        questions?: string[];
+        aiProvider?: string;
+    }[];
+    needsClarification: boolean | undefined;
     collaborationLog: string[];
 }>;

package/dist/agentic/nodes/architect.js

@@ -33,9 +33,18 @@ export const architectNode = async (state) => {
         // Multi-agent collaboration: generate an alternative strategy in parallel with the primary.
         // Both are handed off to separate Engineer agents that run concurrently.
         const alternativeSpec = await aiService.generateAlternativeSpec(state.userGoal, spec);
+        const alternativeModel = aiService.getAlternativeModel();
         const strategies = [
-            { ...spec, strategyName: "Primary Strategy" },
-            { ...alternativeSpec, strategyName: "Alternative Strategy" },
+            {
+                ...spec,
+                strategyName: "Primary Strategy",
+                aiModel: aiService.getDefaultModel()
+            },
+            {
+                ...alternativeSpec,
+                strategyName: "Alternative Strategy",
+                aiModel: alternativeModel
+            },
         ];
         const logEntry = `Architect: Generated 2 strategies — "${strategies[0].suggestedName}" (primary) and "${strategies[1].suggestedName}" (alternative)`;
         console.log(`[Architect] ${logEntry}`);

package/dist/agentic/nodes/engineer.d.ts

@@ -6,6 +6,6 @@ export declare const engineerNode: (state: typeof TeamState.State) => Promise<{
     workflowJson?: undefined;
     candidates?: undefined;
 } | {
-    workflowJson: any;
     candidates: any[];
+    workflowJson?: undefined;
 }>;