chainlesschain 0.43.4 → 0.45.0

package/README.md

@@ -206,11 +206,12 @@ Agent slash commands: `/plan` (plan mode), `/plan interactive <request>` (LLM-dr
 
 ### `chainlesschain skill <action>`
 
-Manage and run 138 built-in AI skills.
+Manage and run 138 built-in AI skills across a 4-layer system: bundled < marketplace < managed (global) < workspace (project).
 
 ```bash
 chainlesschain skill list               # List all skills grouped by category
 chainlesschain skill list --category automation
+chainlesschain skill list --category cli-direct   # CLI command skill packs
 chainlesschain skill list --tag code --runnable
 chainlesschain skill list --json        # JSON output
 chainlesschain skill categories         # Show category breakdown
@@ -218,7 +219,45 @@ chainlesschain skill info code-review   # Detailed skill info + docs
 chainlesschain skill info code-review --json
 chainlesschain skill search "browser"   # Search by keyword
 chainlesschain skill run code-review "Review this function..."
-```
+chainlesschain skill add my-skill       # Create custom project skill
+chainlesschain skill remove my-skill    # Remove custom skill
+chainlesschain skill sources            # Show skill layer paths and counts
+```
+
+#### CLI Command 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
+chainlesschain skill sync-cli --force      # Force regenerate all packs
+chainlesschain skill sync-cli --dry-run    # Preview changes without writing
+chainlesschain skill sync-cli --remove     # Remove all CLI packs
+chainlesschain skill sync-cli --json       # JSON output
+
+# Run CLI commands via skill packs (Agent can call these directly)
+chainlesschain skill run cli-knowledge-pack "note list"
+chainlesschain skill run cli-identity-pack "did create"
+chainlesschain skill run cli-infra-pack "services up"
+chainlesschain skill run cli-ai-query-pack "ask what is RAG"
+chainlesschain skill run cli-agent-mode-pack "agent"
+chainlesschain skill run cli-web3-pack "wallet assets"
+chainlesschain skill run cli-security-pack "encrypt file secret.txt"
+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, ui                     |
 
 ---
 
@@ -504,12 +543,73 @@ chainlesschain plugin summary                      # Installation summary
 
 ### `chainlesschain init`
 
-Initialize a new ChainlessChain project.
+Initialize a new ChainlessChain project with a `.chainlesschain/` directory, workspace skills, and an optional AI persona.
+
+```bash
+chainlesschain init                                         # Interactive template selection
+chainlesschain init --bare                                  # Minimal project structure
+chainlesschain init --template code-project --yes           # Software project (code-review, refactor, unit-test)
+chainlesschain init --template data-science --yes           # Data science / ML project
+chainlesschain init --template devops --yes                 # DevOps / infrastructure project
+chainlesschain init --template medical-triage --yes         # Medical triage assistant (with Persona)
+chainlesschain init --template agriculture-expert --yes     # Agriculture expert (with Persona)
+chainlesschain init --template general-assistant --yes      # General-purpose assistant (with Persona)
+chainlesschain init --template ai-media-creator --yes       # AI media creator (ComfyUI/AnimateDiff/TTS)
+chainlesschain init --template ai-doc-creator --yes         # AI doc creator (LibreOffice/pandoc/doc-edit)
+chainlesschain init --template empty --yes                  # Bare project
+```
+
+#### AI Media Creator Template (`ai-media-creator`)
+
+Generates 3 workspace skills for AI image/video/audio creation:
+
+```bash
+chainlesschain skill run comfyui-image "a sunset over mountains, oil painting style"
+chainlesschain skill run comfyui-video '{"prompt":"a cat walking","workflow":"workflows/animatediff.json"}'
+chainlesschain skill run audio-gen "你好，欢迎使用 ChainlessChain"
+```
+
+| 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       |
+
+Also creates a `workflows/` directory with README for saving ComfyUI workflow JSON files.
+
+#### AI Doc Creator Template (`ai-doc-creator`)
+
+Generates 3 workspace skills for AI document creation and editing:
+
+```bash
+chainlesschain skill run doc-generate "2026年技术趋势分析报告"
+chainlesschain skill run doc-generate '{"topic":"项目方案","format":"docx","style":"proposal"}'
+chainlesschain skill run libre-convert "report.docx"
+chainlesschain skill run libre-convert '{"input_file":"slides.pptx","format":"pdf"}'
+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) |
+
+Requirements: `winget install pandoc` (for docx), `winget install LibreOffice.LibreOffice` (for PDF/format conversion).
+
+Also creates a `templates/` directory with README for document templates.
+
+### `chainlesschain persona <action>`
+
+Manage the AI persona for the current project (set by `init` templates or manually).
 
 ```bash
-chainlesschain init                                    # Interactive project init
-chainlesschain init --bare                             # Minimal project structure
-chainlesschain init --template code-project --yes      # Use template, skip prompts
+chainlesschain persona show                              # Show current project persona
+chainlesschain persona set --name "Bot" --role "Helper" # Set persona name and role
+chainlesschain persona set -b "Always respond in English" # Add behavior constraint
+chainlesschain persona set --tools-disabled run_shell   # Disable specific tools
+chainlesschain persona reset                             # Remove persona, restore default
 ```
 
 ### `chainlesschain cowork <action>`
@@ -907,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
@@ -980,7 +1110,7 @@ Configuration is stored at `~/.chainlesschain/config.json`. The CLI creates and
 ```bash
 cd packages/cli
 npm install
-npm test                # Run all tests (2748 tests across 124 files)
+npm test                # Run all tests (3050+ tests across 130+ files)
 npm run test:unit       # Unit tests only
 npm run test:integration # Integration tests
 npm run test:e2e        # End-to-end tests
@@ -988,17 +1118,22 @@ npm run test:e2e        # End-to-end tests
 
 ### Test Coverage
 
-| Category                 | Files   | Tests    | Status          |
-| ------------------------ | ------- | -------- | --------------- |
-| Unit — lib modules       | 63      | 1380+    | All passing     |
-| Unit — commands          | 15      | 350+     | All passing     |
-| Unit — runtime           | 1       | 6        | All passing     |
-| Integration              | 6       | 40+      | All passing     |
-| E2E                      | 15      | 160+     | All passing     |
-| Core packages (external) | —       | 118      | All passing     |
-| Unit — WS sessions       | 9       | 156      | All passing     |
-| Integration — WS session | 1       | 12       | All passing     |
-| **CLI Total**            | **124** | **2748** | **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.43.4",
+  "version": "0.45.0",
   "description": "CLI for ChainlessChain - install, configure, and manage your personal AI management system",
   "type": "module",
   "bin": {

package/src/commands/init.js

@@ -206,7 +206,7 @@ async function pollUntilDone(promptId) {
   return { success: false, error: "Timeout waiting for image generation" };
 }
 
-module.exports = async function comfyuiImageHandler(params) {
+async function comfyuiImageHandler(params) {
   const { prompt, negative_prompt, width, height, steps, workflow } = params;
 
   if (!prompt) {
@@ -278,7 +278,16 @@ module.exports = async function comfyuiImageHandler(params) {
     message: \`Generated \${result.images.length} image(s). Open URLs to download:\`,
     urls: result.images.map((i) => i.url),
   };
+}
+
+comfyuiImageHandler.execute = async (task, _ctx, _skill) => {
+  const input = typeof task === "string" ? task : (task.input || task.params?.input || "");
+  let p = {};
+  try { p = input.trim().startsWith("{") ? JSON.parse(input) : { prompt: input }; }
+  catch { p = { prompt: input }; }
+  return comfyuiImageHandler(p);
 };
+module.exports = comfyuiImageHandler;
 `,
   },
   "comfyui-video": {
@@ -429,7 +438,7 @@ async function pollUntilDone(promptId) {
   return { success: false, error: "Timeout waiting for video generation" };
 }
 
-module.exports = async function comfyuiVideoHandler(params) {
+async function comfyuiVideoHandler(params) {
   const { prompt, frames, fps, workflow } = params;
 
   if (!prompt) {
@@ -510,7 +519,16 @@ module.exports = async function comfyuiVideoHandler(params) {
     message: \`Generated \${result.outputs.length} output(s). URLs:\`,
     urls: result.outputs.map((o) => o.url),
   };
+}
+
+comfyuiVideoHandler.execute = async (task, _ctx, _skill) => {
+  const input = typeof task === "string" ? task : (task.input || task.params?.input || "");
+  let p = {};
+  try { p = input.trim().startsWith("{") ? JSON.parse(input) : { prompt: input }; }
+  catch { p = { prompt: input }; }
+  return comfyuiVideoHandler(p);
 };
+module.exports = comfyuiVideoHandler;
 `,
   },
   "audio-gen": {
@@ -680,7 +698,7 @@ function callOpenAITTS(text, voice, outputPath, apiKey) {
   });
 }
 
-module.exports = async function audioGenHandler(params) {
+async function audioGenHandler(params) {
   const { text, voice, type, output } = params;
 
   if (!text) {
@@ -780,6 +798,15 @@ async function checkPythonModule(moduleName) {
     return false;
   }
 }
+
+audioGenHandler.execute = async (task, _ctx, _skill) => {
+  const input = typeof task === "string" ? task : (task.input || task.params?.input || "");
+  let p = {};
+  try { p = input.trim().startsWith("{") ? JSON.parse(input) : { text: input }; }
+  catch { p = { text: input }; }
+  return audioGenHandler(p);
+};
+module.exports = audioGenHandler;
 `,
   },
 };
@@ -1097,7 +1124,7 @@ function generateContent(topic, style, outline) {
 
 // ─── Main handler ─────────────────────────────────────────────────
 
-module.exports = async function docGenerateHandler(params) {
+async function docGenerateHandler(params) {
   const { topic, format, outline, style, output } = params;
 
   if (!topic) {
@@ -1206,7 +1233,16 @@ module.exports = async function docGenerateHandler(params) {
   }
 
   return { error: \`Unsupported format: \${fmt}\`, hint: "Supported formats: md, html, docx, pdf" };
+}
+
+docGenerateHandler.execute = async (task, _ctx, _skill) => {
+  const input = typeof task === "string" ? task : (task.input || task.params?.input || "");
+  let p = {};
+  try { p = input.trim().startsWith("{") ? JSON.parse(input) : { topic: input }; }
+  catch { p = { topic: input }; }
+  return docGenerateHandler(p);
 };
+module.exports = docGenerateHandler;
 `,
   },
 
@@ -1337,7 +1373,7 @@ function findSoffice() {
   return null;
 }
 
-module.exports = async function libreConvertHandler(params) {
+async function libreConvertHandler(params) {
   const { input_file, format, outdir } = params;
 
   if (!input_file) {
@@ -1442,7 +1478,16 @@ module.exports = async function libreConvertHandler(params) {
     format: targetFormat,
     message: \`Converted to \${targetFormat}: \${outputFile}\`,
   };
+}
+
+libreConvertHandler.execute = async (task, _ctx, _skill) => {
+  const input = typeof task === "string" ? task : (task.input || task.params?.input || "");
+  let p = {};
+  try { p = input.trim().startsWith("{") ? JSON.parse(input) : { input_file: input }; }
+  catch { p = { input_file: input }; }
+  return libreConvertHandler(p);
 };
+module.exports = libreConvertHandler;
 `,
   },
 });
@@ -1948,7 +1993,7 @@ prs.save(r"""\${outputFile}""")
 }
 
 // ── Main export ───────────────────────────────────────────────────────────────
-module.exports = async function docEdit(params) {
+async function docEdit(params) {
   const { input_file, instruction, action = "edit", section, output_dir } = params || {};
 
   if (!input_file) {
@@ -1986,7 +2031,16 @@ module.exports = async function docEdit(params) {
     error: \`不支持的格式: \${ext}\`,
     hint: "支持的格式: md, txt, html, docx, xlsx, pptx",
   };
+}
+
+docEdit.execute = async (task, _ctx, _skill) => {
+  const input = typeof task === "string" ? task : (task.input || task.params?.input || "");
+  let p = {};
+  try { p = input.trim().startsWith("{") ? JSON.parse(input) : { input_file: input }; }
+  catch { p = { input_file: input }; }
+  return docEdit(p);
 };
+module.exports = docEdit;
 `,
   },
 });

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