agent-workflow-kit-cli 1.3.3 → 1.3.5

package/README.md

@@ -162,21 +162,78 @@ packages = ["src"]
 
 ---
 
+### 🌐 Next.js Frontend Pack
+Tailored for Next.js App or Pages Router web application structures.
+- **Default Architecture:** Standard layouts, page component separations, and shared Tailwind/styling assets.
+- **Tooling Defaults:** Next CLI tools, ESLint, strict TypeScript rules.
+
+---
+
+### 🛡️ NestJS & Express Backend Packs
+Designed for structured modular Node.js backend systems.
+- **Default Architecture:** Dependency injection modular patterns (NestJS) or routing/middleware setups (Express).
+- **Tooling Defaults:** ESLint, Prettier, and Vitest/Jest for automated testing.
+
+---
+
+### 🤖 Python AI Pack
+Custom-tailored rules and structures for AI modeling, machine learning, and data science.
+- **Default Architecture:** Machine learning pipelines, model loaders, script helpers, and notebook guides.
+- **Tooling Defaults:** Ruff linting, mypy strict type checking, and standard AI environment libraries.
+
+---
+
+### ⚙️ .NET Core C# Pack
+Designed for enterprise-level applications written in C# on .NET Core.
+- **Default Architecture:** Clean-architecture layers (controllers, application services, domain interfaces, and infrastructure/data layers).
+- **Tooling Defaults:** C# styling guides, standard `dotnet test` suites.
+
+---
+
+### 🐹 Go Pack
+High-performance Go backend structures.
+- **Default Architecture:** Go standard layout structures, clear service boundary interfaces, and separation of concerns.
+- **Tooling Defaults:** `go fmt`, `go vet`, and standard go test execution.
+
+---
+
+### 🦀 Rust Pack
+Memory-safe, high-performance systems and backend libraries in Rust.
+- **Default Architecture:** Workspace modules, cargo configurations, and library/binary structures.
+- **Tooling Defaults:** `cargo clippy`, `cargo fmt`, and standard Rust test suites.
+
+---
+
+### 📦 DevOps Stack Pack
+Standardizes container, pipeline, and automation configurations.
+- **Default Architecture:** Multi-stage Dockerfiles, Docker Compose environment setups, and CI/CD pipelines (GitHub Actions, GitLab CI).
+
+---
+
+### 📊 Diagram Pack
+Organizes system designs and architectures using standard diagrams.
+- **Default Architecture:** Standard guidelines for UML, Mermaid blocks, and PlantUML designs.
+
+---
+
 ## 🚀 Quick Start
 
 Initialize the toolkit instantly inside your project repository using `npx` (no local installation required):
 
 ```bash
-# 1. Initialize rules and custom skills for the project
+# 1. Launch the local configuration wizard web dashboard (Optional)
+npx agent-workflow-kit-cli ui
+
+# 2. Or initialize rules and custom skills directly via CLI
 npx agent-workflow-kit-cli init
 
-# 2. View the generated AGENTS.md guidelines at your repository root
+# 3. View the generated AGENTS.md guidelines at your repository root
 cat AGENTS.md
 
-# 3. Export custom skills to register them with Antigravity
+# 4. Export custom skills to register them with Antigravity
 npx agent-workflow-kit-cli export antigravity
 
-# 4. Enable pre-commit auto-validation hook
+# 5. Enable pre-commit auto-validation hook
 npx agent-workflow-kit-cli doctor --install-hook
 ```
 
@@ -191,12 +248,12 @@ npx agent-workflow-kit-cli <command> [options]
 ```
 
 ### 1. `init`
-Analyzes the directory manifests (`package.json`, `pom.xml`, `pyproject.toml`) and bootstraps agent guidelines (`AGENTS.md`) and custom skills (`.agents/`).
+Analyzes the directory manifests (`package.json`, `pom.xml`, `pyproject.toml`, etc.) and bootstraps agent guidelines (`AGENTS.md`) and custom skills (`.agents/`).
 
 * **Usage:** `npx agent-workflow-kit-cli init [options]`
 * **Options:**
   * `--stack <stack>`: Specify the target project stack.
-    * Values: `auto`, `spring-boot`, `react-ts`, `fastapi`
+    * Values: `auto`, `spring-boot`, `react-ts`, `next-js`, `nestjs`, `express`, `fastapi`, `python-ai`, `dotnet`, `golang`, `rust`, `devops`, `diagram`
     * Default: `auto` (auto-detects project manifests)
   * `--agent <agent>`: Target profile settings.
     * Values: `both`, `codex`, `antigravity`
@@ -205,7 +262,30 @@ Analyzes the directory manifests (`package.json`, `pom.xml`, `pyproject.toml`) a
 
 ---
 
-### 2. `sync`
+### 2. `ui`
+Launches the local configuration wizard web dashboard in your browser.
+
+* **Usage:** `npx agent-workflow-kit-cli ui [options]`
+* **Options:**
+  * `-p, --port <port>`: Port to run the UI server on.
+    * Default: `4321`
+
+---
+
+### 3. `add <stack>`
+Manually installs a specific stack pack guidelines and templates to a folder.
+
+* **Usage:** `npx agent-workflow-kit-cli add <stack> [options]`
+* **Arguments:**
+  * `<stack>`: The stack pack name (e.g. `spring-boot`, `react-ts`, `rust`, etc.).
+* **Options:**
+  * `--path <path>`: Target folder path to install the guidelines (default: `.`).
+  * `--agent <agent>`: Specify target agent profile: `both | codex | antigravity` (default: `both`).
+  * `--dry-run`: Simulation mode. Logs actions without writing files to disk.
+
+---
+
+### 4. `sync`
 Re-evaluates the manifests and updates existing guidelines/skills inside the workspace without touching user modifications. It writes changes inside the `<!-- AWK-START: <id> -->` managed blocks.
 
 * **Usage:** `npx agent-workflow-kit-cli sync [options]`
@@ -214,7 +294,7 @@ Re-evaluates the manifests and updates existing guidelines/skills inside the wor
 
 ---
 
-### 3. `doctor`
+### 5. `doctor`
 Checks consistency of active agent configurations, environment setups, and executes the validation test commands configured for detected stacks.
 
 * **Usage:** `npx agent-workflow-kit-cli doctor [options]`
@@ -223,7 +303,7 @@ Checks consistency of active agent configurations, environment setups, and execu
 
 ---
 
-### 4. `export <target>`
+### 6. `export <target>`
 Exports and bundles custom workflows and skills in `.agents/skills/` into a single consolidated string optimized for the target AI agent console.
 
 * **Usage:** `npx agent-workflow-kit-cli export <target> [options]`
@@ -231,6 +311,75 @@ Exports and bundles custom workflows and skills in `.agents/skills/` into a sing
   * `<target>`: The name of the target agent (e.g., `antigravity`).
 * **Options:**
   * `--no-clipboard`: Prevents the CLI from copying the bundled instructions directly to the system clipboard (by default, it will attempt to copy to the clipboard first, fallback to printing on stdout).
+  * `-o, --output <file>`: Write the exported guidelines to a specific file.
+
+---
+
+### 7. `run <workflow>`
+Runs an AWOS graph workflow directly from the command line.
+
+* **Usage:** `npx agent-workflow-kit-cli run <workflow> [options]`
+* **Arguments:**
+  * `<workflow>`: Path to the workflow JSON configuration.
+* **Options:**
+  * `--inputs <inputs>`: Path to input parameters JSON file or inline JSON string.
+  * `--dry-run`: Run workflow nodes in dry-run simulation mode.
+
+---
+
+### 8. `resume <runId>`
+Resumes a suspended or paused AWOS workflow run.
+
+* **Usage:** `npx agent-workflow-kit-cli resume <runId>`
+* **Arguments:**
+  * `<runId>`: The ID of the suspended workflow run.
+
+---
+
+### 9. `profile`
+Validates directory architecture structure and rule boundaries using custom structural rules.
+
+* **Usage:** `npx agent-workflow-kit-cli profile [options]`
+* **Options:**
+  * `--profile <profile>`: Target profile name (e.g. `clean-architecture`).
+
+---
+
+### 10. `workflow` (Subcommands)
+Manage and execute registered AWOS workflow packs.
+
+* **Subcommands:**
+  * `list`: List all discovered/registered workflow packs.
+  * `show <id>`: Show details, steps, and metadata of a workflow pack.
+  * `validate <id>`: Validate a workflow pack's JSON schema and graph cycle constraints.
+  * `run <id> [options]`: Execute a registered workflow pack by ID (options: `--inputs`, `--dry-run`).
+
+---
+
+### 11. `role` (Subcommands)
+Manage agent role profiles.
+
+* **Subcommands:**
+  * `list`: List all discovered agent role profiles in the catalog.
+  * `show <id>`: Show agent role details, checkpoints, and inputs schema.
+  * `validate`: Validate all role catalog configuration files against schema parameters.
+
+---
+
+### 12. `adr` (Subcommands)
+Manage Architectural Decision Records (ADR).
+
+* **Subcommands:**
+  * `create [options]`: Create a new numbered ADR document. Options:
+    * `--title <title>`: ADR title.
+    * `--status <status>`: Status: `proposed | accepted | rejected | superseded` (default: `proposed`).
+    * `--context <context>`: Background context.
+    * `--decision <decision>`: Decision details.
+    * `--consequences <consequences>`: Repercussions/consequences.
+    * `--decision-maker <maker>`: Name/role of decision maker (default: `AWOS System`).
+  * `list`: List all saved ADR documents.
+  * `show <id>`: Display details of a numbered ADR document.
+  * `search <keyword>`: Search all ADR documents for keyword text matches.
 
 ---
 

package/dist/cli/commands/add.js

@@ -11,7 +11,7 @@ import { analyzeModule } from "../../core/analyzer.js";
 import { updateGitignore } from "./init.js";
 export async function runAdd(stack, options) {
     const targetStack = stack.toLowerCase();
-    const validStacks = ["spring-boot", "react-ts", "next-js", "nestjs", "express", "fastapi", "python-ai", "dotnet", "golang", "rust"];
+    const validStacks = ["spring-boot", "react-ts", "next-js", "nestjs", "express", "fastapi", "python-ai", "dotnet", "golang", "rust", "diagram", "devops"];
     if (!validStacks.includes(targetStack)) {
         console.error(chalk.red(`Error: Invalid stack '${stack}'. Supported stacks are: ${validStacks.join(", ")}`));
         process.exit(1);

package/dist/cli/commands/doctor.js

@@ -6,7 +6,7 @@ import chalk from "chalk";
 import { promises as fs } from "fs";
 import path from "path";
 import { execa } from "execa";
-import { detectProjectStack } from "../../core/detector.js";
+import { detectProjectModules } from "../../core/detector.js";
 export async function runDoctor(options) {
     const cwd = process.cwd();
     if (options.installHook) {
@@ -55,63 +55,161 @@ npx agent-workflow-kit-cli doctor || exit 1
         return;
     }
     console.log(chalk.blue("Running doctor checks on repository..."));
-    // 1. Detect Stack
-    const stacks = await detectProjectStack(cwd);
-    console.log(chalk.gray(`Detected stacks: ${stacks.join(", ") || "None"}`));
-    if (stacks.length === 0) {
-        console.log(chalk.yellow("No standard stack pack detected. Nothing to validate."));
+    // 1. Detect Modules
+    const modules = await detectProjectModules(cwd);
+    if (modules.length === 0) {
+        console.log(chalk.yellow("No standard project modules detected. Nothing to validate."));
         return;
     }
+    console.log(chalk.gray(`Detected modules: ${modules.map(m => `${m.name} [${m.stacks.join(", ")}]`).join(", ")}`));
     // 2. Validate
     let passed = true;
-    for (const stack of stacks) {
-        console.log(chalk.blue(`\nValidating stack: ${stack}...`));
-        try {
-            if (stack === "spring-boot") {
-                console.log(chalk.gray("Running: ./mvnw clean compile"));
-                await execa("./mvnw", ["clean", "compile"], { cwd, stdio: "inherit" });
-            }
-            else if (stack === "fastapi") {
-                console.log(chalk.gray("Running: ruff check ."));
-                await execa("ruff", ["check", "."], { cwd, stdio: "inherit" });
-            }
-            else if (stack === "python-ai") {
-                let cmd = "ruff";
-                let args = ["check", "."];
-                try {
-                    const hasPoetry = await fs.stat(path.join(cwd, "poetry.lock")).then(s => s.isFile()).catch(() => false);
-                    if (hasPoetry) {
-                        cmd = "poetry";
-                        args = ["run", "python", "-m", "ruff", "check", "."];
+    for (const mod of modules) {
+        console.log(chalk.blue(`\nValidating module: ${mod.name === "." ? "root" : mod.name}...`));
+        for (const stack of mod.stacks) {
+            console.log(chalk.cyan(`  Validating stack: ${stack}...`));
+            try {
+                if (stack === "spring-boot") {
+                    // Check for maven wrapper or gradle wrapper
+                    const hasGradle = (await fs.stat(path.join(mod.dir, "build.gradle")).then((s) => s.isFile()).catch(() => false)) ||
+                        (await fs.stat(path.join(mod.dir, "build.gradle.kts")).then((s) => s.isFile()).catch(() => false));
+                    if (hasGradle) {
+                        let gradlewPath = "./gradlew";
+                        try {
+                            await fs.access(path.join(mod.dir, "gradlew"));
+                        }
+                        catch {
+                            try {
+                                await fs.access(path.join(cwd, "gradlew"));
+                                gradlewPath = path.relative(mod.dir, path.join(cwd, "gradlew")).replace(/\\/g, "/");
+                                if (!gradlewPath.startsWith("."))
+                                    gradlewPath = "./" + gradlewPath;
+                            }
+                            catch {
+                                gradlewPath = "gradle";
+                            }
+                        }
+                        console.log(chalk.gray(`Running: ${gradlewPath} check in ${mod.dir}`));
+                        await execa(gradlewPath, ["check"], { cwd: mod.dir, stdio: "inherit" });
                     }
                     else {
-                        const hasPipenv = await fs.stat(path.join(cwd, "Pipfile")).then(s => s.isFile()).catch(() => false);
-                        if (hasPipenv) {
-                            cmd = "pipenv";
-                            args = ["run", "python", "-m", "ruff", "check", "."];
+                        let mvnwPath = "./mvnw";
+                        try {
+                            await fs.access(path.join(mod.dir, "mvnw"));
                         }
+                        catch {
+                            try {
+                                await fs.access(path.join(cwd, "mvnw"));
+                                mvnwPath = path.relative(mod.dir, path.join(cwd, "mvnw")).replace(/\\/g, "/");
+                                if (!mvnwPath.startsWith("."))
+                                    mvnwPath = "./" + mvnwPath;
+                            }
+                            catch {
+                                mvnwPath = "mvn";
+                            }
+                        }
+                        console.log(chalk.gray(`Running: ${mvnwPath} clean compile in ${mod.dir}`));
+                        await execa(mvnwPath, ["clean", "compile"], { cwd: mod.dir, stdio: "inherit" });
                     }
                 }
-                catch { }
-                console.log(chalk.gray(`Running: ${cmd} ${args.join(" ")}`));
-                await execa(cmd, args, { cwd, stdio: "inherit" });
-            }
-            else if (stack === "react-ts" ||
-                stack === "next-js" ||
-                stack === "nestjs" ||
-                stack === "express") {
-                console.log(chalk.gray("Running: npx tsc --noEmit"));
-                await execa("npx", ["tsc", "--noEmit"], { cwd, stdio: "inherit" });
+                else if (stack === "fastapi") {
+                    console.log(chalk.gray(`Running: ruff check . in ${mod.dir}`));
+                    await execa("ruff", ["check", "."], { cwd: mod.dir, stdio: "inherit" });
+                }
+                else if (stack === "python-ai") {
+                    let cmd = "ruff";
+                    let args = ["check", "."];
+                    try {
+                        const hasPoetry = await fs.stat(path.join(mod.dir, "poetry.lock")).then(s => s.isFile()).catch(() => false);
+                        if (hasPoetry) {
+                            cmd = "poetry";
+                            args = ["run", "ruff", "check", "."];
+                        }
+                        else {
+                            const hasPipenv = await fs.stat(path.join(mod.dir, "Pipfile")).then(s => s.isFile()).catch(() => false);
+                            if (hasPipenv) {
+                                cmd = "pipenv";
+                                args = ["run", "ruff", "check", "."];
+                            }
+                        }
+                    }
+                    catch { }
+                    console.log(chalk.gray(`Running: ${cmd} ${args.join(" ")} in ${mod.dir}`));
+                    await execa(cmd, args, { cwd: mod.dir, stdio: "inherit" });
+                }
+                else if (stack === "react-ts" ||
+                    stack === "next-js" ||
+                    stack === "nestjs" ||
+                    stack === "express") {
+                    let pm = "npm";
+                    try {
+                        const hasYarnLock = await fs.stat(path.join(mod.dir, "yarn.lock")).then((s) => s.isFile()).catch(() => false);
+                        const hasPnpmLock = await fs.stat(path.join(mod.dir, "pnpm-lock.yaml")).then((s) => s.isFile()).catch(() => false);
+                        const hasBunLockb = await fs.stat(path.join(mod.dir, "bun.lockb")).then((s) => s.isFile()).catch(() => false);
+                        const hasBunLock = await fs.stat(path.join(mod.dir, "bun.lock")).then((s) => s.isFile()).catch(() => false);
+                        if (hasYarnLock)
+                            pm = "yarn";
+                        else if (hasPnpmLock)
+                            pm = "pnpm";
+                        else if (hasBunLockb || hasBunLock)
+                            pm = "bun";
+                    }
+                    catch { }
+                    try {
+                        const pkgContent = await fs.readFile(path.join(mod.dir, "package.json"), "utf8");
+                        const pkg = JSON.parse(pkgContent);
+                        const scripts = pkg.scripts || {};
+                        if (scripts.lint) {
+                            console.log(chalk.gray(`Running: ${pm} run lint in ${mod.dir}`));
+                            await execa(pm, ["run", "lint"], { cwd: mod.dir, stdio: "inherit" });
+                        }
+                        console.log(chalk.gray(`Running: npx tsc --noEmit in ${mod.dir}`));
+                        await execa("npx", ["tsc", "--noEmit"], { cwd: mod.dir, stdio: "inherit" });
+                        if (scripts.test) {
+                            const hasVitest = pkg.dependencies?.vitest || pkg.devDependencies?.vitest;
+                            const hasJest = pkg.dependencies?.jest || pkg.devDependencies?.jest;
+                            let args = ["run", "test"];
+                            if (hasVitest || hasJest) {
+                                if (pm === "npm") {
+                                    args = ["run", "test", "--", "--run"];
+                                }
+                                else {
+                                    args = ["run", "test", "--run"];
+                                }
+                            }
+                            console.log(chalk.gray(`Running: ${pm} ${args.join(" ")} in ${mod.dir}`));
+                            await execa(pm, args, { cwd: mod.dir, stdio: "inherit", env: { ...process.env, CI: "true" } });
+                        }
+                    }
+                    catch {
+                        console.log(chalk.gray(`Running: npx tsc --noEmit in ${mod.dir}`));
+                        await execa("npx", ["tsc", "--noEmit"], { cwd: mod.dir, stdio: "inherit" });
+                    }
+                }
+                else if (stack === "dotnet") {
+                    console.log(chalk.gray(`Running: dotnet build in ${mod.dir}`));
+                    await execa("dotnet", ["build"], { cwd: mod.dir, stdio: "inherit" });
+                    console.log(chalk.gray(`Running: dotnet test in ${mod.dir}`));
+                    await execa("dotnet", ["test"], { cwd: mod.dir, stdio: "inherit" });
+                }
+                else if (stack === "golang") {
+                    console.log(chalk.gray(`Running: go build ./... in ${mod.dir}`));
+                    await execa("go", ["build", "./..."], { cwd: mod.dir, stdio: "inherit" });
+                    console.log(chalk.gray(`Running: go test ./... in ${mod.dir}`));
+                    await execa("go", ["test", "./..."], { cwd: mod.dir, stdio: "inherit" });
+                }
+                else if (stack === "rust") {
+                    console.log(chalk.gray(`Running: cargo check in ${mod.dir}`));
+                    await execa("cargo", ["check"], { cwd: mod.dir, stdio: "inherit" });
+                    console.log(chalk.gray(`Running: cargo test in ${mod.dir}`));
+                    await execa("cargo", ["test"], { cwd: mod.dir, stdio: "inherit" });
+                }
+                console.log(chalk.green(`  ✔️ ${stack} validation passed!`));
             }
-            else if (stack === "dotnet") {
-                console.log(chalk.gray("Running: dotnet build"));
-                await execa("dotnet", ["build"], { cwd, stdio: "inherit" });
+            catch (err) {
+                console.error(chalk.red(`  ❌ ${stack} validation failed: ${err instanceof Error ? err.message : String(err)}`));
+                passed = false;
             }
-            console.log(chalk.green(`✔️ ${stack} validation passed!`));
-        }
-        catch (err) {
-            console.error(chalk.red(`❌ ${stack} validation failed: ${err instanceof Error ? err.message : String(err)}`));
-            passed = false;
         }
     }
     if (passed) {

package/dist/cli/commands/ui.js

@@ -0,0 +1,192 @@
+/**
+ * @license
+ * SPDX-License-Identifier: MIT
+ */
+import http from "http";
+import fs from "fs/promises";
+import path from "path";
+import { fileURLToPath } from "url";
+import chalk from "chalk";
+import { exec } from "child_process";
+import { detectProjectModules } from "../../core/detector.js";
+import { runInit } from "./init.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Map file extensions to MIME types
+const MIME_TYPES = {
+    ".html": "text/html",
+    ".css": "text/css",
+    ".js": "text/javascript",
+    ".json": "application/json",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".ico": "image/x-icon",
+};
+// Find static assets directory in dev and production build structures
+async function findUiDistDir() {
+    const possiblePaths = [
+        // Production path (dist/ui-dist) relative to dist/cli/commands/ui.js
+        path.join(__dirname, "..", "..", "..", "ui-dist"),
+        // Development path relative to src/cli/commands/ui.ts
+        path.join(__dirname, "..", "..", "..", "..", "agent-workflow-kit", "dist"),
+    ];
+    for (const p of possiblePaths) {
+        try {
+            const stats = await fs.stat(p);
+            if (stats.isDirectory()) {
+                return p;
+            }
+        }
+        catch {
+            // Continue searching
+        }
+    }
+    throw new Error("Could not find frontend UI assets directory (ui-dist). Make sure the Vite app is built.");
+}
+// Open URL in native browser
+function openBrowser(url) {
+    const startCmd = process.platform === "win32" ? "start" : process.platform === "darwin" ? "open" : "xdg-open";
+    if (process.platform === "win32") {
+        // Windows start requires extra care with double quotes
+        exec(`start "" "${url}"`);
+    }
+    else {
+        exec(`${startCmd} "${url}"`);
+    }
+}
+export async function runUiServer(options) {
+    const port = parseInt(options.port, 10) || 4321;
+    const cwd = process.cwd();
+    let uiDistDir = "";
+    try {
+        uiDistDir = await findUiDistDir();
+    }
+    catch (err) {
+        console.error(chalk.red(`\n❌ Error: ${err.message}`));
+        console.log(chalk.yellow("👉 Please run 'npm run build' in the 'agent-workflow-kit' directory first.\n"));
+        process.exit(1);
+    }
+    const server = http.createServer(async (req, res) => {
+        // Enable CORS for development mode proxying
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+        if (req.method === "OPTIONS") {
+            res.writeHead(200);
+            res.end();
+            return;
+        }
+        const url = new URL(req.url || "/", `http://localhost:${port}`);
+        const pathname = url.pathname;
+        // API - GET /api/status
+        if (pathname === "/api/status" && req.method === "GET") {
+            try {
+                const detected = await detectProjectModules(cwd);
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({
+                    isLocalCli: true,
+                    cwd,
+                    detectedModules: detected,
+                }));
+            }
+            catch (err) {
+                res.writeHead(500, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: err.message }));
+            }
+            return;
+        }
+        // API - POST /api/generate
+        if (pathname === "/api/generate" && req.method === "POST") {
+            let body = "";
+            req.on("data", (chunk) => {
+                body += chunk;
+            });
+            req.on("end", async () => {
+                try {
+                    const config = JSON.parse(body);
+                    const stack = config.stack || "auto";
+                    const agent = config.agent || "both";
+                    const dryRun = !!config.dryRun;
+                    const logs = [];
+                    const originalLog = console.log;
+                    const originalWarn = console.warn;
+                    const originalError = console.error;
+                    // Capture console outputs to send back to the web console UI
+                    console.log = (...args) => {
+                        logs.push(args.join(" "));
+                        originalLog(...args);
+                    };
+                    console.warn = (...args) => {
+                        logs.push("[WARN] " + args.join(" "));
+                        originalWarn(...args);
+                    };
+                    console.error = (...args) => {
+                        logs.push("[ERROR] " + args.join(" "));
+                        originalError(...args);
+                    };
+                    try {
+                        await runInit({ stack, agent, dryRun });
+                        res.writeHead(200, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({ success: true, logs }));
+                    }
+                    catch (err) {
+                        res.writeHead(500, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({ success: false, error: err.message, logs }));
+                    }
+                    finally {
+                        // Restore console methods
+                        console.log = originalLog;
+                        console.warn = originalWarn;
+                        console.error = originalError;
+                    }
+                }
+                catch (err) {
+                    res.writeHead(400, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ error: "Invalid JSON payload" }));
+                }
+            });
+            return;
+        }
+        // Serve Static Files
+        let filePath = path.join(uiDistDir, pathname === "/" ? "index.html" : pathname);
+        // Guard against directory traversal attacks
+        if (!filePath.startsWith(uiDistDir)) {
+            res.writeHead(403);
+            res.end("Forbidden");
+            return;
+        }
+        try {
+            let stats = await fs.stat(filePath);
+            if (stats.isDirectory()) {
+                filePath = path.join(filePath, "index.html");
+            }
+            const content = await fs.readFile(filePath);
+            const ext = path.extname(filePath).toLowerCase();
+            const contentType = MIME_TYPES[ext] || "application/octet-stream";
+            res.writeHead(200, { "Content-Type": contentType });
+            res.end(content);
+        }
+        catch {
+            // For SPA fallback support: Serve index.html if file not found
+            try {
+                const indexContent = await fs.readFile(path.join(uiDistDir, "index.html"));
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(indexContent);
+            }
+            catch {
+                res.writeHead(404);
+                res.end("Not Found");
+            }
+        }
+    });
+    server.listen(port, () => {
+        const localUrl = `http://localhost:${port}`;
+        console.log(chalk.bold.green(`\n🖥️  Agent Workflow Kit local dashboard running at: ${localUrl}`));
+        console.log(chalk.dim(`Press Ctrl+C to stop the server.\n`));
+        // Automatically open in user browser
+        openBrowser(localUrl);
+    });
+}