chainlesschain 0.37.10 → 0.37.12

package/README.md

@@ -482,6 +482,162 @@ chainlesschain plugin summary                      # Installation summary
 
 ---
 
+## Project Initialization & Collaboration
+
+### `chainlesschain init`
+
+Initialize a new ChainlessChain project.
+
+```bash
+chainlesschain init                                    # Interactive project init
+chainlesschain init --bare                             # Minimal project structure
+chainlesschain init --template code-project --yes      # Use template, skip prompts
+```
+
+### `chainlesschain cowork <action>`
+
+Multi-agent collaboration for code review and analysis.
+
+```bash
+chainlesschain cowork debate <file>                    # Multi-perspective code review
+chainlesschain cowork compare <prompt>                 # A/B solution comparison
+chainlesschain cowork analyze <path>                   # Code analysis (style/knowledge-graph/decisions)
+chainlesschain cowork status                           # Show cowork status
+```
+
+---
+
+## Phase 6: AI Core (Hooks, Workflow, Memory, A2A)
+
+### `chainlesschain hook <action>`
+
+Event hook management for extensibility.
+
+```bash
+chainlesschain hook list                               # List registered hooks
+chainlesschain hook add --event PreToolUse --type sync --command "echo check"
+chainlesschain hook remove <id>                        # Remove a hook
+chainlesschain hook run PreToolUse                     # Execute hooks for event
+chainlesschain hook stats                              # Hook execution statistics
+```
+
+### `chainlesschain workflow <action>`
+
+DAG-based workflow orchestration engine.
+
+```bash
+chainlesschain workflow create --name "pipeline" --stages '[...]'
+chainlesschain workflow list                           # List workflows
+chainlesschain workflow run <id>                       # Execute workflow
+chainlesschain workflow status <id>                    # Check workflow status
+chainlesschain workflow templates                      # List 5 built-in templates
+```
+
+### `chainlesschain hmemory <action>`
+
+Hierarchical memory system (working → short-term → long-term).
+
+```bash
+chainlesschain hmemory store "fact" --importance 0.8   # Store memory
+chainlesschain hmemory recall --layer long-term        # Recall memories
+chainlesschain hmemory consolidate                     # Promote memories across layers
+chainlesschain hmemory stats                           # Memory statistics
+```
+
+### `chainlesschain a2a <action>`
+
+Agent-to-Agent protocol for multi-agent collaboration.
+
+```bash
+chainlesschain a2a register --name "agent1" --capabilities '["code"]'
+chainlesschain a2a list                                # List registered agents
+chainlesschain a2a discover --capability code          # Find agents by capability
+chainlesschain a2a submit <agent> "task"               # Submit task to agent
+chainlesschain a2a status <task-id>                    # Check task status
+```
+
+---
+
+## Phase 7: Security & Evolution
+
+### `chainlesschain sandbox <action>`
+
+Secure sandbox execution environment.
+
+```bash
+chainlesschain sandbox create --name "test"            # Create sandbox
+chainlesschain sandbox list                            # List sandboxes
+chainlesschain sandbox exec <id> "command"             # Execute in sandbox
+chainlesschain sandbox audit <id>                      # View audit log
+chainlesschain sandbox destroy <id>                    # Destroy sandbox
+```
+
+### `chainlesschain evolution <action>`
+
+Self-evolving AI capability assessment and learning.
+
+```bash
+chainlesschain evolution assess code-generation        # Assess capability
+chainlesschain evolution diagnose                      # Self-diagnosis
+chainlesschain evolution learn --domain nlp            # Incremental learning
+chainlesschain evolution status                        # Evolution status
+```
+
+---
+
+## Phase 8: Blockchain & Enterprise Analytics
+
+### `chainlesschain economy <action>`
+
+Agent economy and micropayment system.
+
+```bash
+chainlesschain economy pay <from> <to> 100             # Agent micropayment
+chainlesschain economy balance <agent>                  # Check balance
+chainlesschain economy market list                      # Browse resource market
+chainlesschain economy nft mint <agent>                 # Mint contribution NFT
+```
+
+### `chainlesschain zkp <action>`
+
+Zero-Knowledge Proof engine.
+
+```bash
+chainlesschain zkp compile --name "age-proof"          # Compile ZKP circuit
+chainlesschain zkp prove <circuit> --witness '{}'      # Generate proof
+chainlesschain zkp verify <circuit> <proof>            # Verify proof
+chainlesschain zkp list                                # List circuits
+```
+
+### `chainlesschain bi <action>`
+
+Business Intelligence with natural language queries.
+
+```bash
+chainlesschain bi query "show monthly revenue"         # NL→SQL query
+chainlesschain bi dashboard create --name "KPI"        # Create dashboard
+chainlesschain bi dashboard list                       # List dashboards
+chainlesschain bi anomaly --metric sales               # Z-score anomaly detection
+```
+
+---
+
+## Phase 9: Low-Code Platform
+
+### `chainlesschain lowcode <action>`
+
+Visual low-code application builder.
+
+```bash
+chainlesschain lowcode create --name "app1"            # Create app
+chainlesschain lowcode list                            # List apps
+chainlesschain lowcode components                      # List 15+ components
+chainlesschain lowcode preview <id>                    # Preview app
+chainlesschain lowcode publish <id>                    # Publish app
+```
+
+---
+
 ## Global Options
 
 ```bash
@@ -554,7 +710,7 @@ Configuration is stored at `~/.chainlesschain/config.json`. The CLI creates and
 ```bash
 cd packages/cli
 npm install
-npm test                # Run all tests (903 tests across 47 files)
+npm test                # Run all tests (1429 tests across 67 files)
 npm run test:unit       # Unit tests only
 npm run test:integration # Integration tests
 npm run test:e2e        # End-to-end tests
@@ -562,15 +718,15 @@ npm run test:e2e        # End-to-end tests
 
 ### Test Coverage
 
-| Category                 | Files  | Tests   | Status          |
-| ------------------------ | ------ | ------- | --------------- |
-| Unit — lib modules       | 25     | 578     | All passing     |
-| Unit — commands          | 2      | 43      | All passing     |
-| Unit — runtime           | 1      | 6       | All passing     |
-| Integration              | 3      | 7       | All passing     |
-| E2E                      | 9      | 88      | All passing     |
-| Core packages (external) | —      | 118     | All passing     |
-| **CLI Total**            | **47** | **903** | **All passing** |
+| Category                 | Files  | Tests    | Status          |
+| ------------------------ | ------ | -------- | --------------- |
+| Unit — lib modules       | 44     | 892      | All passing     |
+| Unit — commands          | 10     | 213      | All passing     |
+| Unit — runtime           | 1      | 6        | All passing     |
+| Integration              | 3      | 7        | All passing     |
+| E2E                      | 10     | 109      | All passing     |
+| Core packages (external) | —      | 118      | All passing     |
+| **CLI Total**            | **67** | **1429** | **All passing** |
 
 ## License
 

package/package.json

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

package/src/commands/a2a.js

@@ -0,0 +1,374 @@
+/**
+ * A2A (Agent-to-Agent) Protocol commands
+ * chainlesschain a2a register|discover|submit|status|complete|fail|peers|cards|negotiate
+ */
+
+import chalk from "chalk";
+import ora from "ora";
+import { logger } from "../lib/logger.js";
+import { bootstrap, shutdown } from "../runtime/bootstrap.js";
+import {
+  registerCard,
+  updateCard,
+  discoverAgents,
+  sendTask,
+  completeTask,
+  failTask,
+  getTaskStatus,
+  negotiateCapability,
+  listPeers,
+} from "../lib/a2a-protocol.js";
+
+export function registerA2aCommand(program) {
+  const a2a = program
+    .command("a2a")
+    .description("A2A Protocol — agent-to-agent communication");
+
+  // a2a register <name>
+  a2a
+    .command("register")
+    .description("Register an agent card")
+    .argument("<name>", "Agent name")
+    .option("--description <desc>", "Agent description", "")
+    .option("--url <url>", "Agent endpoint URL", "")
+    .option("--capabilities <csv>", "Comma-separated capabilities", "")
+    .option("--skills <csv>", "Comma-separated skills", "")
+    .option("--json", "Output as JSON")
+    .action(async (name, options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const card = registerCard(db, {
+          name,
+          description: options.description,
+          url: options.url,
+          capabilities: options.capabilities
+            ? options.capabilities.split(",").map((s) => s.trim())
+            : [],
+          skills: options.skills
+            ? options.skills.split(",").map((s) => s.trim())
+            : [],
+        });
+
+        if (options.json) {
+          console.log(JSON.stringify(card, null, 2));
+        } else {
+          logger.success(
+            `Agent registered: ${chalk.cyan(card.name)} ${chalk.gray(card.id)}`,
+          );
+        }
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // a2a discover
+  a2a
+    .command("discover")
+    .description("Discover agents by capability or skill")
+    .option("--capability <name>", "Filter by capability")
+    .option("--skill <name>", "Filter by skill")
+    .option("--name <filter>", "Filter by name")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const agents = discoverAgents(db, {
+          capability: options.capability,
+          skill: options.skill,
+          name: options.name,
+        });
+
+        if (options.json) {
+          console.log(JSON.stringify(agents, null, 2));
+        } else if (agents.length === 0) {
+          logger.info("No agents found matching criteria");
+        } else {
+          logger.log(chalk.bold(`Discovered ${agents.length} agents:\n`));
+          for (const a of agents) {
+            logger.log(`  ${chalk.cyan(a.name)} ${chalk.gray(a.id)}`);
+            if (a.description) logger.log(`    ${chalk.white(a.description)}`);
+            if (a.capabilities.length)
+              logger.log(
+                `    Capabilities: ${chalk.yellow(a.capabilities.join(", "))}`,
+              );
+            if (a.skills.length)
+              logger.log(`    Skills: ${chalk.yellow(a.skills.join(", "))}`);
+          }
+        }
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // a2a submit <agent-id> <input>
+  a2a
+    .command("submit")
+    .description("Submit a task to an agent")
+    .argument("<agent-id>", "Target agent ID")
+    .argument("<input>", "Task input")
+    .option("--json", "Output as JSON")
+    .action(async (agentId, input, options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const result = sendTask(db, agentId, input);
+
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          logger.success(
+            `Task submitted: ${chalk.gray(result.taskId)} [${chalk.yellow(result.status)}]`,
+          );
+        }
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // a2a status <task-id>
+  a2a
+    .command("status")
+    .description("Get task status")
+    .argument("<task-id>", "Task ID")
+    .option("--json", "Output as JSON")
+    .action(async (taskId, options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const task = getTaskStatus(db, taskId);
+
+        if (options.json) {
+          console.log(JSON.stringify(task, null, 2));
+        } else {
+          logger.log(chalk.bold("Task Status:\n"));
+          logger.log(`  ID:     ${chalk.gray(task.id)}`);
+          logger.log(`  Agent:  ${chalk.cyan(task.agent_id)}`);
+          logger.log(`  Status: ${chalk.yellow(task.status)}`);
+          if (task.input)
+            logger.log(
+              `  Input:  ${chalk.white(task.input.substring(0, 100))}`,
+            );
+          if (task.output)
+            logger.log(
+              `  Output: ${chalk.green(task.output.substring(0, 100))}`,
+            );
+          if (task.error) logger.log(`  Error:  ${chalk.red(task.error)}`);
+          if (task.history.length) {
+            logger.log("  History:");
+            for (const h of task.history) {
+              logger.log(
+                `    ${chalk.gray(h.timestamp)} → ${chalk.yellow(h.status)}`,
+              );
+            }
+          }
+        }
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // a2a complete <task-id> <output>
+  a2a
+    .command("complete")
+    .description("Mark a task as completed")
+    .argument("<task-id>", "Task ID")
+    .argument("<output>", "Task output")
+    .action(async (taskId, output) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const result = completeTask(db, taskId, output);
+        logger.success(
+          `Task ${chalk.gray(taskId)} → ${chalk.green(result.status)}`,
+        );
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // a2a fail <task-id> <error>
+  a2a
+    .command("fail")
+    .description("Mark a task as failed")
+    .argument("<task-id>", "Task ID")
+    .argument("<error>", "Error message")
+    .action(async (taskId, error) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const result = failTask(db, taskId, error);
+        logger.success(
+          `Task ${chalk.gray(taskId)} → ${chalk.red(result.status)}`,
+        );
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // a2a peers
+  a2a
+    .command("peers")
+    .description("List all registered agents")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const peers = listPeers(db);
+
+        if (options.json) {
+          console.log(JSON.stringify(peers, null, 2));
+        } else if (peers.length === 0) {
+          logger.info("No agents registered. Use 'a2a register' to add one.");
+        } else {
+          logger.log(chalk.bold(`${peers.length} registered agents:\n`));
+          for (const p of peers) {
+            const statusColor =
+              p.status === "active" ? chalk.green : chalk.gray;
+            logger.log(
+              `  ${chalk.cyan(p.name)} ${chalk.gray(p.id)} ${statusColor(p.status)}`,
+            );
+          }
+        }
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // a2a cards
+  a2a
+    .command("cards")
+    .description("List all agent cards with details")
+    .option("--json", "Output as JSON")
+    .action(async (options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const peers = listPeers(db);
+
+        if (options.json) {
+          console.log(JSON.stringify(peers, null, 2));
+        } else if (peers.length === 0) {
+          logger.info("No agent cards registered.");
+        } else {
+          logger.log(chalk.bold(`${peers.length} agent cards:\n`));
+          for (const p of peers) {
+            logger.log(`  ${chalk.cyan(p.name)} ${chalk.gray(p.id)}`);
+            if (p.description) logger.log(`    Description: ${p.description}`);
+            if (p.url) logger.log(`    URL: ${chalk.blue(p.url)}`);
+            logger.log(`    Auth: ${p.auth_type}`);
+            if (p.capabilities.length)
+              logger.log(
+                `    Capabilities: ${chalk.yellow(p.capabilities.join(", "))}`,
+              );
+            if (p.skills.length)
+              logger.log(`    Skills: ${chalk.yellow(p.skills.join(", "))}`);
+            logger.log("");
+          }
+        }
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // a2a negotiate <agent-id> <capabilities>
+  a2a
+    .command("negotiate")
+    .description("Check if an agent supports required capabilities")
+    .argument("<agent-id>", "Agent ID")
+    .argument("<capabilities>", "Comma-separated required capabilities")
+    .option("--json", "Output as JSON")
+    .action(async (agentId, capabilities, options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const db = ctx.db.getDatabase();
+        const required = capabilities.split(",").map((s) => s.trim());
+        const result = negotiateCapability(db, agentId, required);
+
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          if (result.compatible) {
+            logger.success("Agent is fully compatible");
+          } else {
+            logger.warn("Agent is not fully compatible");
+          }
+          if (result.supported.length) {
+            logger.log(
+              `  Supported: ${chalk.green(result.supported.join(", "))}`,
+            );
+          }
+          if (result.missing.length) {
+            logger.log(`  Missing:   ${chalk.red(result.missing.join(", "))}`);
+          }
+        }
+
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+}