npm - chainlesschain - Versions diffs - 0.47.8 → 0.47.9 - Mend

chainlesschain 0.47.8 → 0.47.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/package.json +10 -8
package/src/commands/activitypub.js +533 -0
package/src/commands/compliance.js +597 -6
package/src/commands/matrix.js +283 -0
package/src/commands/mcp.js +344 -0
package/src/commands/nostr.js +196 -7
package/src/commands/social.js +265 -0
package/src/index.js +2 -0
package/src/lib/activitypub-bridge.js +623 -0
package/src/lib/compliance-framework-reporter.js +600 -0
package/src/lib/matrix-bridge.js +252 -0
package/src/lib/mcp-registry.js +347 -0
package/src/lib/mcp-scaffold.js +385 -0
package/src/lib/nostr-bridge.js +214 -38
package/src/lib/social-graph.js +408 -0
package/src/lib/stix-parser.js +167 -0
package/src/lib/threat-intel.js +268 -0
package/src/lib/topic-classifier.js +400 -0
package/src/lib/ueba.js +403 -0

package/src/commands/matrix.js CHANGED Viewed

@@ -14,6 +14,14 @@ import {
   getMessages,
   joinRoom,
   getLoginState,
+  sendThreadReply,
+  getThreadMessages,
+  getThreadRoots,
+  createSpace,
+  addSpaceChild,
+  removeSpaceChild,
+  listSpaceChildren,
+  listSpaces,
 } from "../lib/matrix-bridge.js";
 export function registerMatrixCommand(program) {
@@ -165,4 +173,279 @@ export function registerMatrixCommand(program) {
         process.exit(1);
       }
     });
+  // ── Threads (MSC3440 / spec §11.38) ──────────────────────────────
+  const thread = matrix
+    .command("thread")
+    .description("Matrix threaded replies (m.thread relation)");
+  thread
+    .command("send <room-id> <root-event-id> <body>")
+    .description("Send a threaded reply referencing a root event")
+    .option("-t, --type <msgtype>", "Message type", "m.text")
+    .option(
+      "--reply-to <event-id>",
+      "Event the reply directly targets (defaults to root)",
+    )
+    .option(
+      "--no-fallback",
+      "Disable is_falling_back (non-thread clients won't see it as a reply)",
+    )
+    .option("--json", "Output as JSON")
+    .action(async (roomId, rootEventId, body, 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();
+        ensureMatrixTables(db);
+        const result = sendThreadReply(db, {
+          roomId,
+          rootEventId,
+          body,
+          msgtype: options.type,
+          inReplyTo: options.replyTo,
+          isFallingBack: options.fallback !== false,
+        });
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          logger.success(`Thread reply sent to ${chalk.cyan(roomId)}`);
+          logger.log(`  ${chalk.bold("Root:")}  ${rootEventId}`);
+          logger.log(`  ${chalk.bold("Event:")} ${result.event.eventId}`);
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  thread
+    .command("list <room-id> <root-event-id>")
+    .description("List all replies in a thread")
+    .option("--json", "Output as JSON")
+    .action(async (roomId, rootEventId, 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();
+        ensureMatrixTables(db);
+        const messages = getThreadMessages(roomId, rootEventId);
+        if (options.json) {
+          console.log(JSON.stringify(messages, null, 2));
+        } else if (messages.length === 0) {
+          logger.info("No replies in this thread.");
+        } else {
+          for (const m of messages) {
+            logger.log(`  ${chalk.gray(m.sender)} ${m.content.body}`);
+          }
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  thread
+    .command("roots <room-id>")
+    .description("List distinct thread roots within a room")
+    .option("--json", "Output as JSON")
+    .action(async (roomId, 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();
+        ensureMatrixTables(db);
+        const roots = getThreadRoots(roomId);
+        if (options.json) {
+          console.log(JSON.stringify(roots, null, 2));
+        } else if (roots.length === 0) {
+          logger.info("No threads found.");
+        } else {
+          for (const r of roots) {
+            logger.log(
+              `  ${chalk.cyan(r.rootEventId.slice(0, 16))}... replies=${r.replyCount} last=${r.lastReplyAt}`,
+            );
+          }
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  // ── Spaces (spec §11.34) ─────────────────────────────────────────
+  const space = matrix
+    .command("space")
+    .description("Matrix Spaces — hierarchical room grouping (m.space)");
+  space
+    .command("create <name>")
+    .description("Create a new Matrix Space")
+    .option("-t, --topic <text>", "Space topic / description")
+    .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();
+        ensureMatrixTables(db);
+        const result = createSpace(db, { name, topic: options.topic });
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          logger.success(`Space created: ${chalk.cyan(result.space.name)}`);
+          logger.log(`  ${chalk.bold("Room ID:")} ${result.space.roomId}`);
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  space
+    .command("add-child <space-id> <child-room-id>")
+    .description("Add a child room to a Space")
+    .option("--via <server...>", "Homeserver(s) via which child is reachable")
+    .option("--json", "Output as JSON")
+    .action(async (spaceId, childRoomId, 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();
+        ensureMatrixTables(db);
+        const result = addSpaceChild(db, {
+          spaceId,
+          childRoomId,
+          via: options.via,
+        });
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          logger.success(
+            `Added ${chalk.cyan(childRoomId)} to space ${chalk.cyan(spaceId)}`,
+          );
+          logger.log(`  ${chalk.bold("Via:")} ${result.via.join(", ")}`);
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  space
+    .command("remove-child <space-id> <child-room-id>")
+    .description("Remove a child room from a Space")
+    .action(async (spaceId, childRoomId) => {
+      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();
+        ensureMatrixTables(db);
+        const result = removeSpaceChild(db, { spaceId, childRoomId });
+        if (result.removed) {
+          logger.success(
+            `Removed ${chalk.cyan(childRoomId)} from ${chalk.cyan(spaceId)}`,
+          );
+        } else {
+          logger.info(`${childRoomId} was not a child of ${spaceId}`);
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  space
+    .command("children <space-id>")
+    .description("List all child rooms of a Space")
+    .option("--json", "Output as JSON")
+    .action(async (spaceId, 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();
+        ensureMatrixTables(db);
+        const children = listSpaceChildren(spaceId);
+        if (options.json) {
+          console.log(JSON.stringify(children, null, 2));
+        } else if (children.length === 0) {
+          logger.info("Space has no children.");
+        } else {
+          for (const c of children) {
+            logger.log(`  ${chalk.cyan(c.childRoomId)} via=${c.via.join(",")}`);
+          }
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  space
+    .command("list")
+    .description("List all Spaces")
+    .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();
+        ensureMatrixTables(db);
+        const spaces = listSpaces();
+        if (options.json) {
+          console.log(JSON.stringify(spaces, null, 2));
+        } else if (spaces.length === 0) {
+          logger.info("No spaces found.");
+        } else {
+          for (const s of spaces) {
+            logger.log(`  ${chalk.cyan(s.roomId)} ${s.name}`);
+          }
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
 }

package/src/commands/mcp.js CHANGED Viewed

@@ -3,6 +3,8 @@
  * chainlesschain mcp servers|connect|disconnect|tools|call
  */
+import fs from "fs";
+import path from "path";
 import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../lib/logger.js";
@@ -12,6 +14,17 @@ import {
   validateMcpServer,
   annotateMcpCompatibility,
 } from "@chainlesschain/session-core";
+import {
+  generateMcpServerScaffold,
+  SUPPORTED_TRANSPORTS,
+} from "../lib/mcp-scaffold.js";
+import {
+  CATALOG as REGISTRY_CATALOG,
+  CATEGORIES as REGISTRY_CATEGORIES,
+  listServers as registryListServers,
+  searchServers as registrySearchServers,
+  getServer as registryGetServer,
+} from "../lib/mcp-registry.js";
 // Singleton MCP client for session reuse
 let mcpClient = null;
@@ -381,4 +394,335 @@ export function registerMcpCommand(program) {
         process.exit(1);
       }
     });
+  // mcp scaffold — generate a boilerplate MCP server project
+  mcp
+    .command("scaffold <name>")
+    .description("Scaffold a new MCP server project (stdio or http+sse)")
+    .option("-d, --description <text>", "Short description of the server")
+    .option(
+      "-t, --transport <kind>",
+      `Transport: ${SUPPORTED_TRANSPORTS.join("|")}`,
+      "stdio",
+    )
+    .option("-o, --output <dir>", "Target directory (defaults to ./<name>)")
+    .option("-a, --author <name>", "package.json author field")
+    .option("-p, --port <n>", "HTTP port (http transport only)", (v) =>
+      parseInt(v, 10),
+    )
+    .option("--force", "Overwrite existing files")
+    .option("--dry-run", "Print files that would be written, don't touch disk")
+    .option("--json", "Output as JSON")
+    .action(async (name, options) => {
+      try {
+        const { files, summary } = generateMcpServerScaffold({
+          name,
+          description: options.description,
+          transport: options.transport,
+          author: options.author,
+          port: options.port,
+        });
+        const targetDir = path.resolve(options.output || `./${summary.name}`);
+        if (options.dryRun) {
+          if (options.json) {
+            console.log(JSON.stringify({ targetDir, summary, files }, null, 2));
+          } else {
+            logger.log(
+              `${chalk.bold("Would write")} ${files.length} files to ${chalk.cyan(targetDir)}:`,
+            );
+            for (const f of files) {
+              logger.log(
+                `  ${chalk.cyan(f.path)} ` +
+                  chalk.dim(`(${f.content.length} bytes)`),
+              );
+            }
+          }
+          return;
+        }
+        // Collision check — refuse to clobber unless --force.
+        if (!options.force && fs.existsSync(targetDir)) {
+          const clashing = files.filter((f) =>
+            fs.existsSync(path.join(targetDir, f.path)),
+          );
+          if (clashing.length > 0) {
+            logger.error(
+              `Refusing to overwrite existing files in ${targetDir}: ` +
+                clashing.map((f) => f.path).join(", ") +
+                `. Re-run with --force to overwrite.`,
+            );
+            process.exit(1);
+          }
+        }
+        fs.mkdirSync(targetDir, { recursive: true });
+        for (const f of files) {
+          const full = path.join(targetDir, f.path);
+          fs.mkdirSync(path.dirname(full), { recursive: true });
+          fs.writeFileSync(full, f.content, "utf-8");
+        }
+        if (options.json) {
+          console.log(
+            JSON.stringify(
+              {
+                targetDir,
+                summary,
+                files: files.map((f) => f.path),
+              },
+              null,
+              2,
+            ),
+          );
+        } else {
+          logger.success(
+            `Scaffolded ${chalk.cyan(summary.name)} ` +
+              chalk.dim(
+                `(${summary.transport}${summary.port ? `, port ${summary.port}` : ""})`,
+              ),
+          );
+          logger.log(`  ${chalk.bold("Path:")}     ${targetDir}`);
+          for (const f of files) {
+            logger.log(`    ${chalk.dim("+")} ${f.path}`);
+          }
+          logger.log("");
+          logger.log(chalk.bold("Next steps:"));
+          logger.log(
+            `  ${chalk.dim("$")} cd ${path.relative(process.cwd(), targetDir) || "."}`,
+          );
+          logger.log(`  ${chalk.dim("$")} npm install`);
+          if (summary.transport === "stdio") {
+            logger.log(
+              `  ${chalk.dim("$")} cc mcp add ${summary.name} -c node -a "./index.js"`,
+            );
+          } else {
+            logger.log(`  ${chalk.dim("$")} npm start`);
+            logger.log(
+              `  ${chalk.dim("$")} cc mcp add ${summary.name} -u http://localhost:${summary.port}/mcp`,
+            );
+          }
+        }
+      } catch (err) {
+        logger.error(`Scaffold failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  // mcp registry — browse + search + one-shot install from the bundled catalog
+  const registry = mcp
+    .command("registry")
+    .description("Browse the curated catalog of community MCP servers");
+  registry
+    .command("list")
+    .description("List catalog entries (filter by category/tag/author)")
+    .option("-c, --category <name>", "Filter by category")
+    .option("-t, --tags <list>", "Filter by comma-separated tags (any match)")
+    .option("--author <name>", "Filter by author (substring, case-insensitive)")
+    .option("--sort <field>", "Sort by 'name' | 'rating' | 'category'", "name")
+    .option("--order <dir>", "'asc' | 'desc'", "asc")
+    .option("--limit <n>", "Max results", (v) => parseInt(v, 10))
+    .option("--offset <n>", "Pagination offset", (v) => parseInt(v, 10))
+    .option("--json", "Output as JSON")
+    .action((options) => {
+      try {
+        const tags = options.tags
+          ? options.tags
+              .split(",")
+              .map((t) => t.trim())
+              .filter(Boolean)
+          : undefined;
+        const { servers, total } = registryListServers({
+          category: options.category,
+          tags,
+          author: options.author,
+          sortBy: options.sort,
+          sortOrder: options.order,
+          limit: options.limit,
+          offset: options.offset,
+        });
+        if (options.json) {
+          console.log(JSON.stringify({ servers, total }, null, 2));
+          return;
+        }
+        if (servers.length === 0) {
+          logger.info("No catalog entries match your filters.");
+          return;
+        }
+        logger.log(
+          chalk.bold(`MCP Registry — ${servers.length}/${total} servers\n`),
+        );
+        for (const s of servers) {
+          logger.log(
+            `  ${chalk.cyan(s.name)} ${chalk.gray(`(${s.id})`)} ` +
+              chalk.dim(`★${s.rating ?? "-"} ${s.category}`),
+          );
+          logger.log(`    ${chalk.gray(s.description)}`);
+          if (s.tags?.length) {
+            logger.log(
+              `    ${chalk.gray("tags:")} ${s.tags.slice(0, 5).join(", ")}`,
+            );
+          }
+        }
+      } catch (err) {
+        logger.error(`Registry list failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  registry
+    .command("search <keyword>")
+    .description("Keyword search across name/description/tags")
+    .option("--json", "Output as JSON")
+    .action((keyword, options) => {
+      try {
+        const hits = registrySearchServers(keyword);
+        if (options.json) {
+          console.log(JSON.stringify({ hits, total: hits.length }, null, 2));
+          return;
+        }
+        if (hits.length === 0) {
+          logger.info(`No matches for "${keyword}".`);
+          return;
+        }
+        logger.log(chalk.bold(`${hits.length} matches for "${keyword}":\n`));
+        for (const s of hits) {
+          logger.log(
+            `  ${chalk.cyan(s.name)} ${chalk.gray(`(${s.id})`)} ` +
+              chalk.dim(s.category),
+          );
+          logger.log(`    ${chalk.gray(s.description)}`);
+        }
+      } catch (err) {
+        logger.error(`Registry search failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  registry
+    .command("show <idOrName>")
+    .description("Show full catalog entry (id or short name)")
+    .option("--json", "Output as JSON")
+    .action((idOrName, options) => {
+      try {
+        const entry = registryGetServer(idOrName);
+        if (!entry) {
+          logger.error(`Not found: "${idOrName}".`);
+          process.exit(1);
+        }
+        if (options.json) {
+          console.log(JSON.stringify(entry, null, 2));
+          return;
+        }
+        logger.log(
+          `${chalk.bold(entry.displayName)} ${chalk.gray(`(${entry.id})`)}`,
+        );
+        logger.log(`  ${chalk.gray("Author:")}   ${entry.author}`);
+        logger.log(`  ${chalk.gray("Category:")} ${entry.category}`);
+        logger.log(`  ${chalk.gray("Version:")}  ${entry.version}`);
+        logger.log(`  ${chalk.gray("Rating:")}   ★${entry.rating ?? "-"}`);
+        logger.log(`  ${chalk.gray("Package:")}  ${entry.npmPackage}`);
+        logger.log(
+          `  ${chalk.gray("Command:")}  ${entry.command} ${entry.args.join(" ")}`,
+        );
+        logger.log(`  ${chalk.gray("Transport:")}${entry.transport}`);
+        if (entry.homepage) {
+          logger.log(`  ${chalk.gray("Homepage:")} ${entry.homepage}`);
+        }
+        logger.log(`\n  ${entry.description}`);
+        if (entry.tools?.length) {
+          logger.log(`\n  ${chalk.bold("Tools:")} ${entry.tools.join(", ")}`);
+        }
+        logger.log(
+          `\n  ${chalk.dim("Install:")} cc mcp registry install ${entry.name}`,
+        );
+      } catch (err) {
+        logger.error(`Registry show failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  registry
+    .command("install <idOrName>")
+    .description("Install a catalog entry by registering it as an MCP server")
+    .option("--as <name>", "Override the stored server name")
+    .option("--auto-connect", "Mark the server to auto-connect on startup")
+    .option("--json", "Output as JSON")
+    .action(async (idOrName, options) => {
+      try {
+        const entry = registryGetServer(idOrName);
+        if (!entry) {
+          logger.error(
+            `Not found: "${idOrName}". Try 'cc mcp registry list' or 'search'.`,
+          );
+          process.exit(1);
+        }
+        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 config = new MCPServerConfig(db);
+        const storedName = (options.as || entry.name).trim();
+        config.add(storedName, {
+          command: entry.command,
+          args: entry.args,
+          autoConnect: !!options.autoConnect,
+        });
+        if (options.json) {
+          console.log(
+            JSON.stringify(
+              {
+                name: storedName,
+                id: entry.id,
+                command: entry.command,
+                args: entry.args,
+                autoConnect: !!options.autoConnect,
+              },
+              null,
+              2,
+            ),
+          );
+        } else {
+          logger.success(
+            `Installed ${chalk.cyan(storedName)} ` + chalk.dim(`(${entry.id})`),
+          );
+          logger.log(
+            `  ${chalk.gray("Command:")} ${entry.command} ${entry.args.join(" ")}`,
+          );
+          logger.log(`  ${chalk.gray("Next:")} cc mcp connect ${storedName}`);
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`Registry install failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  registry
+    .command("categories")
+    .description("List available registry categories")
+    .option("--json", "Output as JSON")
+    .action((options) => {
+      if (options.json) {
+        console.log(JSON.stringify(REGISTRY_CATEGORIES, null, 2));
+        return;
+      }
+      logger.log(chalk.bold("Categories:"));
+      for (const c of REGISTRY_CATEGORIES) {
+        const count = REGISTRY_CATALOG.filter((s) => s.category === c).length;
+        logger.log(`  ${chalk.cyan(c)} ${chalk.dim(`(${count})`)}`);
+      }
+    });
 }