agent-workflow-kit-cli 1.3.4 → 1.3.6

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/create.js

@@ -0,0 +1,162 @@
+/**
+ * @license
+ * SPDX-License-Identifier: MIT
+ */
+import chalk from "chalk";
+import { promises as fs } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { runInit } from "./init.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const TEMPLATES_DIR = path.resolve(__dirname, "../../../templates");
+export async function runCreate(template, projectNameInput, options) {
+    console.log(chalk.bold.cyan("\n🚀 Agent Workflow Kit - Creating New Project..."));
+    console.log(chalk.dim("------------------------------------------"));
+    const validTemplates = ["spring-boot", "react-ts"];
+    if (!validTemplates.includes(template)) {
+        console.error(chalk.red(`Error: Invalid template '${template}'. Supported templates are: ${validTemplates.join(", ")}`));
+        process.exit(1);
+    }
+    const projectName = projectNameInput || `my-${template}-project`;
+    const targetDir = path.resolve(process.cwd(), projectName);
+    console.log(`${chalk.bold("Template:")}     ${chalk.green(template)}`);
+    console.log(`${chalk.bold("Project Name:")} ${chalk.green(projectName)}`);
+    console.log(`${chalk.bold("Target Dir:")}   ${chalk.green(targetDir)}`);
+    console.log(`${chalk.bold("Dry Run:")}      ${options.dryRun ? chalk.yellow("Enabled 🧪") : chalk.gray("Disabled")}`);
+    console.log(chalk.dim("------------------------------------------\n"));
+    // Verify target directory doesn't exist or is empty
+    try {
+        const stat = await fs.stat(targetDir);
+        if (stat.isDirectory()) {
+            const files = await fs.readdir(targetDir);
+            if (files.length > 0) {
+                console.error(chalk.red(`Error: Directory '${targetDir}' already exists and is not empty.`));
+                process.exit(1);
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist, which is fine
+    }
+    const templateProjectDir = path.join(TEMPLATES_DIR, template, "project");
+    // Verify template project skeleton exists
+    try {
+        await fs.access(templateProjectDir);
+    }
+    catch {
+        console.error(chalk.red(`Error: Project template for '${template}' was not found.`));
+        process.exit(1);
+    }
+    const safePackageName = projectName
+        .toLowerCase()
+        .replace(/[^a-z0-9]/g, "");
+    if (options.dryRun) {
+        console.log(chalk.yellow(`[Dry Run] Would create project directory: ${targetDir}`));
+        await listTemplateFilesDry(templateProjectDir, templateProjectDir, targetDir, safePackageName);
+        console.log(chalk.bold.green("\n🎉 Dry Run completed successfully!"));
+        return;
+    }
+    // Create project directory
+    await fs.mkdir(targetDir, { recursive: true });
+    // Copy and interpolate template files
+    await copyAndInterpolate(templateProjectDir, templateProjectDir, targetDir, projectName, safePackageName);
+    console.log(chalk.green(`✔️ Project skeleton for ${template} created successfully.`));
+    // Initialize agent guidelines in the new project directory
+    console.log(chalk.cyan("\nInitializing AI agent guidelines inside project..."));
+    const originalCwd = process.cwd();
+    try {
+        process.chdir(targetDir);
+        await runInit({
+            stack: template,
+            agent: "both",
+            dryRun: false,
+        });
+    }
+    catch (err) {
+        console.error(chalk.red(`Warning: Failed to initialize agent guidelines: ${err instanceof Error ? err.message : String(err)}`));
+    }
+    finally {
+        process.chdir(originalCwd);
+    }
+    printCreateSuccess(projectName, template);
+}
+async function listTemplateFilesDry(baseSrc, currentSrc, destDir, safePackageName) {
+    const entries = await fs.readdir(currentSrc, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(currentSrc, entry.name);
+        // Resolve entry destination name (mapping packageName to safePackageName)
+        let destName = entry.name;
+        if (entry.name === "packageName") {
+            destName = safePackageName;
+        }
+        const relativePart = path.relative(baseSrc, srcPath);
+        let resolvedRelativePart = relativePart
+            .replace(/\\/g, "/")
+            .replace(/\bpackageName\b/g, safePackageName);
+        if (resolvedRelativePart.endsWith(".hbs")) {
+            resolvedRelativePart = resolvedRelativePart.slice(0, -4);
+        }
+        const targetPath = path.join(destDir, resolvedRelativePart);
+        if (entry.isDirectory()) {
+            console.log(chalk.gray(`[Dry Run] Would create directory: ${targetPath}`));
+            await listTemplateFilesDry(baseSrc, srcPath, destDir, safePackageName);
+        }
+        else {
+            console.log(chalk.gray(`[Dry Run] Would write file:      ${targetPath}`));
+        }
+    }
+}
+async function copyAndInterpolate(baseSrc, currentSrc, destDir, projectName, safePackageName) {
+    const entries = await fs.readdir(currentSrc, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(currentSrc, entry.name);
+        // Resolve destination path (replaces 'packageName' directory or file parts)
+        let destName = entry.name;
+        if (entry.name === "packageName") {
+            destName = safePackageName;
+        }
+        const relativePart = path.relative(baseSrc, srcPath);
+        let resolvedRelativePart = relativePart
+            .replace(/\\/g, "/")
+            .replace(/\bpackageName\b/g, safePackageName);
+        if (resolvedRelativePart.endsWith(".hbs")) {
+            resolvedRelativePart = resolvedRelativePart.slice(0, -4);
+        }
+        const targetPath = path.join(destDir, resolvedRelativePart);
+        if (entry.isDirectory()) {
+            await fs.mkdir(targetPath, { recursive: true });
+            await copyAndInterpolate(baseSrc, srcPath, destDir, projectName, safePackageName);
+        }
+        else {
+            await fs.mkdir(path.dirname(targetPath), { recursive: true });
+            // Interpolate text files
+            const content = await fs.readFile(srcPath, "utf8");
+            const interpolated = content
+                .replace(/\{\{projectName\}\}/g, projectName)
+                .replace(/\{\{safePackageName\}\}/g, safePackageName);
+            await fs.writeFile(targetPath, interpolated, "utf8");
+        }
+    }
+}
+function printCreateSuccess(projectName, template) {
+    console.log(chalk.bold.green(`\n🎉 Project '${projectName}' bootstrapped successfully!`));
+    console.log(chalk.bold.cyan("\n👉 Next Steps to run/develop:"));
+    console.log(chalk.dim("------------------------------------------"));
+    console.log(chalk.white(`1. Change directory:`));
+    console.log(chalk.cyan(`   cd ${projectName}`));
+    if (template === "spring-boot") {
+        console.log(chalk.white(`2. Build project using Maven:`));
+        console.log(chalk.cyan(`   mvn clean install`));
+        console.log(chalk.white(`3. Run the Spring Boot application:`));
+        console.log(chalk.cyan(`   mvn spring-boot:run`));
+    }
+    else if (template === "react-ts") {
+        console.log(chalk.white(`2. Install dependencies:`));
+        console.log(chalk.cyan(`   npm install`));
+        console.log(chalk.white(`3. Start the Vite dev server:`));
+        console.log(chalk.cyan(`   npm run dev`));
+    }
+    console.log(chalk.white(`4. Start coding! AI guidelines and rules are already configured.`));
+    console.log(chalk.dim("------------------------------------------\n"));
+}

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);
+    });
+}

package/dist/cli/index.js

@@ -5,6 +5,8 @@
 import { Command } from "commander";
 import chalk from "chalk";
 import { runInit } from "./commands/init.js";
+import { runCreate } from "./commands/create.js";
+import { runUiServer } from "./commands/ui.js";
 import { runAdd } from "./commands/add.js";
 import { runSync } from "./commands/sync.js";
 import { runDoctor } from "./commands/doctor.js";
@@ -19,7 +21,20 @@ export function runCli() {
     program
         .name("agent-workflow-kit")
         .description("Generate AI coding workflows/rules/templates for Codex and Antigravity")
-        .version("1.3.2");
+        .version("1.3.6");
+    program
+        .command("create <template> [projectName]")
+        .description("Bootstrap a new project structure with AI workflow rules pre-configured")
+        .option("--dry-run", "Output actions to console without creating folders", false)
+        .action(async (template, projectName, options) => {
+        try {
+            await runCreate(template, projectName, options);
+        }
+        catch (err) {
+            console.error(chalk.red(`Error running create: ${err instanceof Error ? err.message : String(err)}`));
+            process.exit(1);
+        }
+    });
     program
         .command("init")
         .description("Initialize agent guidelines and skills for the repository")
@@ -35,6 +50,19 @@ export function runCli() {
             process.exit(1);
         }
     });
+    program
+        .command("ui")
+        .description("Launch the local configuration wizard web dashboard")
+        .option("-p, --port <port>", "Port to run the UI server on", "4321")
+        .action(async (options) => {
+        try {
+            await runUiServer(options);
+        }
+        catch (err) {
+            console.error(chalk.red(`Error running ui: ${err instanceof Error ? err.message : String(err)}`));
+            process.exit(1);
+        }
+    });
     program
         .command("add <stack>")
         .description("Manually add/install a stack pack to a specific folder")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-workflow-kit-cli",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "AI-Ready Repository Workflow Generator & Guideline Optimizer for Codex and Antigravity",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,14 +11,16 @@
   "files": [
     "dist",
     "templates",
+    "ui-dist",
     "LICENSE",
     "README.md"
   ],
   "scripts": {
     "build": "tsc",
+    "build:ui": "node scripts/copy-ui.js",
     "start": "node dist/index.js",
     "test": "vitest run",
-    "prepublishOnly": "npm run build && npm test"
+    "prepublishOnly": "npm run build && npm run build:ui && npm test"
   },
   "author": "Truong & Cat",
   "license": "MIT",

package/templates/react-ts/project/.gitignore.hbs

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?