chainlesschain 0.44.0 → 0.45.1

package/README.md

@@ -226,7 +226,7 @@ chainlesschain skill sources            # Show skill layer paths and counts
 
 #### CLI Command Skill Packs
 
-Automatically wraps 62 CLI commands into 9 Agent-callable domain skill packs:
+Automatically wraps 63 CLI commands into 9 Agent-callable domain skill packs:
 
 ```bash
 chainlesschain skill sync-cli              # Generate/update all 9 CLI skill packs
@@ -247,17 +247,17 @@ chainlesschain skill run cli-enterprise-pack "org list"
 chainlesschain skill run cli-integration-pack "mcp servers"
 ```
 
-| Pack | Mode | Commands |
-|------|------|----------|
-| `cli-knowledge-pack` | direct | note, search, memory, session, import, export |
-| `cli-identity-pack` | direct | did, auth, audit |
-| `cli-infra-pack` | direct | setup, start, stop, status, services, config, doctor, db |
-| `cli-ai-query-pack` | llm-query | ask, llm, instinct, tokens |
-| `cli-agent-mode-pack` | agent | agent, chat, cowork |
-| `cli-web3-pack` | direct | wallet, p2p, sync, did |
-| `cli-security-pack` | direct | encrypt, decrypt, audit, pqc |
-| `cli-enterprise-pack` | direct | org, plugin, lowcode, compliance |
-| `cli-integration-pack` | hybrid | mcp, browse, cli-anything, serve |
+| Pack                   | Mode      | Commands                                                 |
+| ---------------------- | --------- | -------------------------------------------------------- |
+| `cli-knowledge-pack`   | direct    | note, search, memory, session, import, export            |
+| `cli-identity-pack`    | direct    | did, auth, audit                                         |
+| `cli-infra-pack`       | direct    | setup, start, stop, status, services, config, doctor, db |
+| `cli-ai-query-pack`    | llm-query | ask, llm, instinct, tokens                               |
+| `cli-agent-mode-pack`  | agent     | agent, chat, cowork                                      |
+| `cli-web3-pack`        | direct    | wallet, p2p, sync, did                                   |
+| `cli-security-pack`    | direct    | encrypt, decrypt, audit, pqc                             |
+| `cli-enterprise-pack`  | direct    | org, plugin, lowcode, compliance                         |
+| `cli-integration-pack` | hybrid    | mcp, browse, cli-anything, serve, ui                     |
 
 ---
 
@@ -569,11 +569,11 @@ chainlesschain skill run comfyui-video '{"prompt":"a cat walking","workflow":"wo
 chainlesschain skill run audio-gen "你好，欢迎使用 ChainlessChain"
 ```
 
-| Skill | Description |
-|-------|-------------|
+| Skill           | Description                                                           |
+| --------------- | --------------------------------------------------------------------- |
 | `comfyui-image` | ComfyUI REST API image generation (txt2img/img2img, custom workflows) |
-| `comfyui-video` | ComfyUI + AnimateDiff video generation (requires workflow JSON) |
-| `audio-gen` | AI TTS: auto-selects edge-tts → piper-tts → ElevenLabs → OpenAI |
+| `comfyui-video` | ComfyUI + AnimateDiff video generation (requires workflow JSON)       |
+| `audio-gen`     | AI TTS: auto-selects edge-tts → piper-tts → ElevenLabs → OpenAI       |
 
 Also creates a `workflows/` directory with README for saving ComfyUI workflow JSON files.
 
@@ -590,11 +590,11 @@ chainlesschain skill run doc-edit '{"input_file":"report.md","instruction":"优
 chainlesschain skill run doc-edit '{"input_file":"data.xlsx","instruction":"首字母大写"}'
 ```
 
-| Skill | Description |
-|-------|-------------|
-| `doc-generate` | AI-generated structured documents: md/html/docx/pdf, 4 styles (report/proposal/manual/readme) |
-| `libre-convert` | LibreOffice headless conversion: docx/pdf/html/odt/pptx/xlsx/png |
-| `doc-edit` | AI edit existing docs: md/txt/html (direct LLM), docx (pandoc/soffice), xlsx (openpyxl, formulas preserved), pptx (python-pptx, charts preserved) |
+| Skill           | Description                                                                                                                                       |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `doc-generate`  | AI-generated structured documents: md/html/docx/pdf, 4 styles (report/proposal/manual/readme)                                                     |
+| `libre-convert` | LibreOffice headless conversion: docx/pdf/html/odt/pptx/xlsx/png                                                                                  |
+| `doc-edit`      | AI edit existing docs: md/txt/html (direct LLM), docx (pandoc/soffice), xlsx (openpyxl, formulas preserved), pptx (python-pptx, charts preserved) |
 
 Requirements: `winget install pandoc` (for docx), `winget install LibreOffice.LibreOffice` (for PDF/format conversion).
 
@@ -1007,6 +1007,36 @@ chainlesschain serve --project /path/to/project         # Default project root f
 
 ---
 
+## Web Management Interface (v0.45.0)
+
+### `chainlesschain ui`
+
+Open a browser-based Web management interface — no extra software required.
+
+```bash
+chainlesschain ui                       # Auto-detect mode, open browser
+chainlesschain ui --port 18810          # Custom HTTP port
+chainlesschain ui --ws-port 18800       # Custom WebSocket port
+chainlesschain ui --no-open             # Start server without opening browser
+chainlesschain ui --token <secret>      # Enable WebSocket auth token
+chainlesschain ui --host 0.0.0.0        # Bind to all interfaces (remote access)
+```
+
+**Two modes** (auto-detected based on current directory):
+
+| Mode             | Trigger                                      | Description                                                    |
+| ---------------- | -------------------------------------------- | -------------------------------------------------------------- |
+| **Project mode** | Run from a directory with `.chainlesschain/` | AI automatically loads project context (rules, skills, config) |
+| **Global mode**  | Run from any non-project directory           | General-purpose AI management panel                            |
+
+**Features**: streaming Markdown output, session management (new/switch/history), Agent/Chat mode toggle, slot-filling interactive dialogs, auto-reconnect (3s), Token auth.
+
+**Ports**: HTTP 18810 (Web UI page), WebSocket 18800 (reuses `chainlesschain serve` infrastructure).
+
+**Security**: JSON config embedded with XSS-safe Unicode escaping (`\u003c`/`\u003e`); Token auth via `--token`.
+
+---
+
 ## Global Options
 
 ```bash
@@ -1088,22 +1118,22 @@ npm run test:e2e        # End-to-end tests
 
 ### Test Coverage
 
-| Category                       | Files   | Tests    | Status          |
-| ------------------------------ | ------- | -------- | --------------- |
-| Unit — lib modules             | 70      | 1700+    | All passing     |
-| Unit — commands                | 17      | 400+     | All passing     |
-| Unit — runtime                 | 1       | 6        | All passing     |
-| Unit — WS sessions             | 9       | 156      | All passing     |
-| Unit — Skill Packs             | 2       | 57+      | All passing     |
-| Unit — AI Templates            | 2       | 130+     | All passing     |
-| Integration                    | 13      | 230+     | All passing     |
-| Integration — WS session       | 1       | 12       | All passing     |
-| Integration — AI Handlers      | 2       | 100+     | All passing     |
-| E2E                            | 15      | 260+     | All passing     |
-| E2E — Skill Packs              | 1       | 23+      | All passing     |
-| E2E — AI Templates             | 4       | 65+      | All passing     |
-| Core packages (external)       | —       | 118      | All passing     |
-| **CLI Total**                  | **132** | **3056** | **All passing** |
+| Category                  | Files   | Tests    | Status          |
+| ------------------------- | ------- | -------- | --------------- |
+| Unit — lib modules        | 70      | 1700+    | All passing     |
+| Unit — commands           | 17      | 400+     | All passing     |
+| Unit — runtime            | 1       | 6        | All passing     |
+| Unit — WS sessions        | 9       | 156      | All passing     |
+| Unit — Skill Packs        | 2       | 57+      | All passing     |
+| Unit — AI Templates       | 2       | 130+     | All passing     |
+| Integration               | 13      | 230+     | All passing     |
+| Integration — WS session  | 1       | 12       | All passing     |
+| Integration — AI Handlers | 2       | 100+     | All passing     |
+| E2E                       | 15      | 260+     | All passing     |
+| E2E — Skill Packs         | 1       | 23+      | All passing     |
+| E2E — AI Templates        | 4       | 65+      | All passing     |
+| Core packages (external)  | —       | 118      | All passing     |
+| **CLI Total**             | **132** | **3056** | **All passing** |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chainlesschain",
-  "version": "0.44.0",
+  "version": "0.45.1",
   "description": "CLI for ChainlessChain - install, configure, and manage your personal AI management system",
   "type": "module",
   "bin": {

package/src/commands/ui.js

@@ -0,0 +1,169 @@
+/**
+ * ui command — start a local web management UI
+ * chainlesschain ui [--port] [--ws-port] [--host] [--no-open] [--token]
+ *
+ * Project mode  (run from a dir with .chainlesschain/): project-scoped chat UI
+ * Global mode   (run from any other dir):               global management panel
+ */
+
+import { execSync } from "child_process";
+import path from "path";
+import chalk from "chalk";
+import { logger } from "../lib/logger.js";
+import { ChainlessChainWSServer } from "../lib/ws-server.js";
+import { WSSessionManager } from "../lib/ws-session-manager.js";
+import { createWebUIServer } from "../lib/web-ui-server.js";
+import { bootstrap } from "../runtime/bootstrap.js";
+import { findProjectRoot, loadProjectConfig } from "../lib/project-detector.js";
+
+/**
+ * Open a URL in the system default browser (cross-platform).
+ */
+function openBrowser(url) {
+  try {
+    const platform = process.platform;
+    if (platform === "win32") {
+      execSync(`start "" "${url}"`, { stdio: "ignore" });
+    } else if (platform === "darwin") {
+      execSync(`open "${url}"`, { stdio: "ignore" });
+    } else {
+      execSync(`xdg-open "${url}"`, { stdio: "ignore" });
+    }
+  } catch (_err) {
+    // Non-critical — user can open manually
+  }
+}
+
+export function registerUiCommand(program) {
+  program
+    .command("ui")
+    .description("Start a local web management UI (project or global mode)")
+    .option("-p, --port <port>", "HTTP server port", "18810")
+    .option("--ws-port <port>", "WebSocket server port", "18800")
+    .option("-H, --host <host>", "Bind host", "127.0.0.1")
+    .option("--no-open", "Do not open browser automatically")
+    .option(
+      "--token <token>",
+      "Authentication token for WebSocket (recommended for security)",
+    )
+    .action(async (opts) => {
+      const httpPort = parseInt(opts.port, 10);
+      const wsPort = parseInt(opts.wsPort, 10);
+      const host = opts.host;
+
+      if (isNaN(httpPort) || httpPort < 1 || httpPort > 65535) {
+        logger.error("Invalid --port. Must be between 1 and 65535.");
+        process.exit(1);
+      }
+      if (isNaN(wsPort) || wsPort < 1 || wsPort > 65535) {
+        logger.error("Invalid --ws-port. Must be between 1 and 65535.");
+        process.exit(1);
+      }
+
+      // ── Detect project context ────────────────────────────────────────────
+      const projectRoot = findProjectRoot(process.cwd());
+      const projectConfig = projectRoot ? loadProjectConfig(projectRoot) : null;
+      const projectName =
+        projectConfig?.name ||
+        (projectRoot ? path.basename(projectRoot) : null);
+      const mode = projectRoot ? "project" : "global";
+
+      // ── Bootstrap headless runtime ────────────────────────────────────────
+      let db = null;
+      try {
+        const ctx = await bootstrap({ skipDb: false });
+        db = ctx.db?.getDb?.() || null;
+      } catch (_err) {
+        logger.log(
+          chalk.yellow(
+            "  Warning: Database not available, sessions will be in-memory only",
+          ),
+        );
+      }
+
+      // ── Start WebSocket server ────────────────────────────────────────────
+      const sessionManager = new WSSessionManager({
+        db,
+        defaultProjectRoot: projectRoot || process.cwd(),
+      });
+
+      const wsServer = new ChainlessChainWSServer({
+        port: wsPort,
+        host,
+        token: opts.token || null,
+        maxConnections: 20,
+        timeout: 60000,
+        sessionManager,
+      });
+
+      try {
+        await wsServer.start();
+      } catch (err) {
+        logger.error(`Failed to start WebSocket server: ${err.message}`);
+        process.exit(1);
+      }
+
+      // ── Start HTTP server ─────────────────────────────────────────────────
+      const httpServer = createWebUIServer({
+        wsPort,
+        wsToken: opts.token || null,
+        wsHost: host === "0.0.0.0" ? "127.0.0.1" : host,
+        projectRoot,
+        projectName,
+        mode,
+      });
+
+      try {
+        await new Promise((resolve, reject) => {
+          httpServer.listen(httpPort, host, () => resolve());
+          httpServer.on("error", reject);
+        });
+      } catch (err) {
+        logger.error(`Failed to start HTTP server: ${err.message}`);
+        process.exit(1);
+      }
+
+      // ── Print startup info ────────────────────────────────────────────────
+      const uiUrl = `http://${host === "0.0.0.0" ? "127.0.0.1" : host}:${httpPort}`;
+
+      logger.log("");
+      logger.log(chalk.bold("  ChainlessChain Web UI"));
+      logger.log("");
+      if (mode === "project") {
+        logger.log(
+          `  Mode:     ${chalk.cyan("project")}  ${chalk.dim(projectRoot)}`,
+        );
+        if (projectName) {
+          logger.log(`  Project:  ${chalk.green(projectName)}`);
+        }
+      } else {
+        logger.log(`  Mode:     ${chalk.cyan("global")}`);
+      }
+      logger.log(`  UI:       ${chalk.cyan(uiUrl)}`);
+      logger.log(`  WS:       ${chalk.dim(`ws://${host}:${wsPort}`)}`);
+      logger.log(
+        `  Auth:     ${opts.token ? chalk.green("enabled") : chalk.yellow("disabled")}`,
+      );
+      logger.log("");
+      logger.log(chalk.dim("  Press Ctrl+C to stop"));
+      logger.log("");
+
+      // ── Open browser ──────────────────────────────────────────────────────
+      if (opts.open !== false) {
+        openBrowser(uiUrl);
+      }
+
+      // ── Graceful shutdown ─────────────────────────────────────────────────
+      const shutdown = async () => {
+        logger.log("\n" + chalk.yellow("Shutting down UI server..."));
+        await Promise.all([
+          new Promise((resolve) => httpServer.close(resolve)),
+          wsServer.stop(),
+        ]);
+        process.exit(0);
+      };
+
+      process.on("SIGINT", shutdown);
+      process.on("SIGTERM", shutdown);
+    });
+}

package/src/index.js

@@ -86,6 +86,9 @@ import { registerCliAnythingCommand } from "./commands/cli-anything.js";
 // WebSocket Server Interface
 import { registerServeCommand } from "./commands/serve.js";
 
+// Web UI
+import { registerUiCommand } from "./commands/ui.js";
+
 export function createProgram() {
   const program = new Command();
 
@@ -201,5 +204,8 @@ export function createProgram() {
   // WebSocket Server Interface
   registerServeCommand(program);
 
+  // Web UI
+  registerUiCommand(program);
+
   return program;
 }