chainlesschain 0.37.9 → 0.37.11

package/src/commands/browse.js

@@ -0,0 +1,184 @@
+/**
+ * Browser automation commands
+ * chainlesschain browse <url> | browse scrape <url> | browse screenshot <url>
+ */
+
+import chalk from "chalk";
+import ora from "ora";
+import { logger } from "../lib/logger.js";
+import {
+  fetchPage,
+  extractText,
+  extractTitle,
+  extractMeta,
+  querySelectorAll,
+  extractLinks,
+  takeScreenshot,
+} from "../lib/browser-automation.js";
+
+export function registerBrowseCommand(program) {
+  const browse = program
+    .command("browse")
+    .description("Headless browser automation and web scraping");
+
+  // browse fetch — fetch and display page content
+  browse
+    .command("fetch")
+    .description("Fetch a URL and display text content")
+    .argument("<url>", "URL to fetch")
+    .option("--html", "Show raw HTML instead of text")
+    .option("--links", "Extract links only")
+    .option("--json", "Output as JSON")
+    .action(async (url, options) => {
+      try {
+        const spinner = ora(`Fetching ${url}...`).start();
+        const result = await fetchPage(url);
+        spinner.stop();
+
+        const title = extractTitle(result.html);
+        const text = extractText(result.html);
+        const description = extractMeta(result.html);
+
+        if (options.json) {
+          const output = {
+            url: result.url,
+            status: result.status,
+            title,
+            description,
+            size: result.size,
+          };
+          if (options.html) output.html = result.html;
+          else if (options.links)
+            output.links = extractLinks(result.html, result.url);
+          else output.text = text;
+          console.log(JSON.stringify(output, null, 2));
+          return;
+        }
+
+        if (options.links) {
+          const links = extractLinks(result.html, result.url);
+          logger.log(
+            chalk.bold(`Links from ${title || url} (${links.length}):\n`),
+          );
+          for (const link of links.slice(0, 50)) {
+            logger.log(
+              `  ${chalk.cyan(link.text.substring(0, 60).padEnd(62))} ${chalk.gray(link.href)}`,
+            );
+          }
+          if (links.length > 50)
+            logger.log(chalk.gray(`  ... and ${links.length - 50} more`));
+          return;
+        }
+
+        if (options.html) {
+          console.log(result.html);
+          return;
+        }
+
+        logger.log(chalk.bold(title || url));
+        if (description) logger.log(chalk.gray(description));
+        logger.log(
+          chalk.gray(`${result.size} bytes | ${result.contentType}\n`),
+        );
+        logger.log(text.substring(0, 5000));
+        if (text.length > 5000) {
+          logger.log(
+            chalk.gray(`\n... truncated (${text.length} chars total)`),
+          );
+        }
+      } catch (err) {
+        logger.error(`Fetch failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // browse scrape — scrape elements matching a CSS selector
+  browse
+    .command("scrape")
+    .description("Scrape elements from a URL using CSS selector")
+    .argument("<url>", "URL to scrape")
+    .requiredOption("-s, --selector <css>", "CSS selector (tag, .class, #id)")
+    .option("-n, --limit <n>", "Max results", "20")
+    .option("--json", "Output as JSON")
+    .action(async (url, options) => {
+      try {
+        const spinner = ora(`Scraping ${url}...`).start();
+        const result = await fetchPage(url);
+        const elements = querySelectorAll(result.html, options.selector);
+        spinner.stop();
+
+        const limit = parseInt(options.limit) || 20;
+        const limited = elements.slice(0, limit);
+
+        if (options.json) {
+          console.log(
+            JSON.stringify(
+              {
+                url: result.url,
+                selector: options.selector,
+                count: elements.length,
+                results: limited.map((e) => ({ text: e.text })),
+              },
+              null,
+              2,
+            ),
+          );
+          return;
+        }
+
+        if (elements.length === 0) {
+          logger.info(`No elements matching "${options.selector}"`);
+        } else {
+          logger.log(
+            chalk.bold(
+              `Scraped ${elements.length} elements matching "${options.selector}":\n`,
+            ),
+          );
+          for (let i = 0; i < limited.length; i++) {
+            const text = limited[i].text.substring(0, 200).replace(/\n/g, " ");
+            logger.log(`  ${chalk.gray(`[${i + 1}]`)} ${text}`);
+          }
+          if (elements.length > limit) {
+            logger.log(chalk.gray(`  ... ${elements.length - limit} more`));
+          }
+        }
+      } catch (err) {
+        logger.error(`Scrape failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // browse screenshot — take a screenshot (requires playwright)
+  browse
+    .command("screenshot")
+    .description("Take a screenshot of a URL (requires playwright)")
+    .argument("<url>", "URL to screenshot")
+    .option("-o, --output <path>", "Output file path", "screenshot.png")
+    .option("--width <n>", "Viewport width", "1280")
+    .option("--height <n>", "Viewport height", "720")
+    .option("--full-page", "Capture full page")
+    .option("--json", "Output as JSON")
+    .action(async (url, options) => {
+      try {
+        const spinner = ora(`Taking screenshot of ${url}...`).start();
+        const result = await takeScreenshot(url, options.output, {
+          width: parseInt(options.width),
+          height: parseInt(options.height),
+          fullPage: !!options.fullPage,
+        });
+        spinner.stop();
+
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else if (result.success) {
+          logger.success(`Screenshot saved: ${chalk.cyan(result.path)}`);
+        } else {
+          logger.error(result.error);
+          logger.info("Install playwright: npm install -g playwright");
+        }
+      } catch (err) {
+        logger.error(`Screenshot failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+}

package/src/commands/cowork.js

@@ -0,0 +1,317 @@
+/**
+ * Multi-agent collaboration commands
+ * chainlesschain cowork debate|compare|analyze|status
+ */
+
+import chalk from "chalk";
+import ora from "ora";
+import fs from "fs";
+import path from "path";
+import { logger } from "../lib/logger.js";
+
+export function registerCoworkCommand(program) {
+  const cowork = program
+    .command("cowork")
+    .description(
+      "Multi-agent collaboration (debate review, A/B comparison, analysis)",
+    );
+
+  // cowork debate — multi-perspective code review
+  cowork
+    .command("debate")
+    .description("Multi-agent debate review of a file or topic")
+    .argument("<file-or-topic>", "File path to review, or a topic/question")
+    .option(
+      "--perspectives <list>",
+      "Comma-separated perspectives (performance,security,maintainability,correctness,architecture)",
+      "performance,security,maintainability",
+    )
+    .option("--provider <name>", "LLM provider to use")
+    .option("--model <name>", "LLM model to use")
+    .option("--json", "Output as JSON")
+    .action(async (target, options) => {
+      const { startDebate, DEFAULT_PERSPECTIVES } =
+        await import("../lib/cowork/debate-review-cli.js");
+
+      const perspectives = options.perspectives
+        .split(",")
+        .map((p) => p.trim())
+        .filter(Boolean);
+
+      // Read file content if target is a file path
+      let code = target;
+      let targetLabel = target;
+      const resolved = path.resolve(target);
+      if (fs.existsSync(resolved)) {
+        try {
+          code = fs.readFileSync(resolved, "utf-8");
+          targetLabel = resolved;
+          if (code.length > 15000) {
+            code = code.substring(0, 15000) + "\n... (truncated)";
+          }
+        } catch (err) {
+          logger.error(`Cannot read file: ${err.message}`);
+          process.exit(1);
+        }
+      }
+
+      const spinner = ora(
+        `Running debate review with ${perspectives.length} perspectives...`,
+      ).start();
+
+      try {
+        const llmOptions = {};
+        if (options.provider) llmOptions.provider = options.provider;
+        if (options.model) llmOptions.model = options.model;
+
+        const result = await startDebate({
+          target: targetLabel,
+          code,
+          perspectives,
+          llmOptions,
+        });
+        spinner.stop();
+
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+          return;
+        }
+
+        // Display results
+        logger.log(chalk.bold(`\nDebate Review: ${targetLabel}\n`));
+
+        for (const review of result.reviews) {
+          const verdictColor =
+            review.verdict === "APPROVE"
+              ? chalk.green
+              : review.verdict === "REJECT"
+                ? chalk.red
+                : chalk.yellow;
+          logger.log(
+            chalk.bold(`  ${review.role}: `) + verdictColor(review.verdict),
+          );
+          // Show first few lines of the review
+          const lines = review.review.split("\n").slice(0, 8);
+          for (const line of lines) {
+            logger.log(chalk.gray(`    ${line}`));
+          }
+          if (review.review.split("\n").length > 8) {
+            logger.log(chalk.gray("    ..."));
+          }
+          logger.log("");
+        }
+
+        logger.log(chalk.bold("Final Verdict"));
+        const verdictColor =
+          result.verdict === "APPROVE"
+            ? chalk.green
+            : result.verdict === "REJECT"
+              ? chalk.red
+              : chalk.yellow;
+        logger.log(`  Verdict:    ${verdictColor(result.verdict)}`);
+        logger.log(`  Consensus:  ${result.consensusScore}%`);
+        logger.log("");
+
+        // Show moderator summary
+        const summaryLines = result.summary.split("\n").slice(0, 15);
+        for (const line of summaryLines) {
+          logger.log(chalk.gray(`  ${line}`));
+        }
+        logger.log("");
+      } catch (err) {
+        spinner.fail(`Debate review failed: ${err.message}`);
+        if (program.opts().verbose) console.error(err.stack);
+        process.exit(1);
+      }
+    });
+
+  // cowork compare — A/B solution comparison
+  cowork
+    .command("compare")
+    .description("Generate and compare multiple solution variants")
+    .argument("<prompt>", "Task or problem description")
+    .option("--variants <n>", "Number of variants to generate (max 4)", "3")
+    .option(
+      "--criteria <list>",
+      "Comma-separated evaluation criteria",
+      "quality,performance,readability",
+    )
+    .option("--provider <name>", "LLM provider to use")
+    .option("--model <name>", "LLM model to use")
+    .option("--json", "Output as JSON")
+    .action(async (prompt, options) => {
+      const { compare } = await import("../lib/cowork/ab-comparator-cli.js");
+
+      const variants = parseInt(options.variants, 10) || 3;
+      const criteria = options.criteria
+        .split(",")
+        .map((c) => c.trim())
+        .filter(Boolean);
+
+      const spinner = ora(
+        `Generating ${variants} solution variants...`,
+      ).start();
+
+      try {
+        const llmOptions = {};
+        if (options.provider) llmOptions.provider = options.provider;
+        if (options.model) llmOptions.model = options.model;
+
+        const result = await compare({
+          prompt,
+          variants,
+          criteria,
+          llmOptions,
+        });
+        spinner.stop();
+
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+          return;
+        }
+
+        logger.log(chalk.bold(`\nA/B Comparison: ${prompt}\n`));
+        logger.log(chalk.gray(`Criteria: ${criteria.join(", ")}\n`));
+
+        for (const v of result.variants) {
+          logger.log(
+            chalk.bold(`  Variant: ${chalk.cyan(v.name)}`) +
+              chalk.gray(` (total: ${v.totalScore})`),
+          );
+
+          // Show scores
+          if (v.scores && Object.keys(v.scores).length > 0) {
+            const scoreStr = Object.entries(v.scores)
+              .map(([k, val]) => `${k}=${val}`)
+              .join(", ");
+            logger.log(chalk.gray(`    Scores: ${scoreStr}`));
+          }
+
+          // Show first lines of solution
+          const lines = v.solution.split("\n").slice(0, 6);
+          for (const line of lines) {
+            logger.log(chalk.gray(`    ${line}`));
+          }
+          if (v.solution.split("\n").length > 6) {
+            logger.log(chalk.gray("    ..."));
+          }
+          logger.log("");
+        }
+
+        logger.log(chalk.bold("Result"));
+        logger.log(`  Winner:  ${chalk.green(result.winner)}`);
+        logger.log(`  Reason:  ${chalk.gray(result.reason)}`);
+        if (result.ranking.length > 0) {
+          logger.log(
+            `  Ranking: ${result.ranking.map((r, i) => (i === 0 ? chalk.green(r) : chalk.gray(r))).join(" > ")}`,
+          );
+        }
+        logger.log("");
+      } catch (err) {
+        spinner.fail(`Comparison failed: ${err.message}`);
+        if (program.opts().verbose) console.error(err.stack);
+        process.exit(1);
+      }
+    });
+
+  // cowork analyze — code analysis (Phase 4B placeholder, delegates to knowledge modules)
+  cowork
+    .command("analyze")
+    .description("Analyze code structure, style, or knowledge graph")
+    .argument("<path>", "File or directory to analyze")
+    .option(
+      "--type <type>",
+      "Analysis type (style, knowledge-graph, decisions)",
+      "style",
+    )
+    .option("--provider <name>", "LLM provider to use")
+    .option("--model <name>", "LLM model to use")
+    .option("--json", "Output as JSON")
+    .action(async (targetPath, options) => {
+      const resolved = path.resolve(targetPath);
+      if (!fs.existsSync(resolved)) {
+        logger.error(`Path not found: ${resolved}`);
+        process.exit(1);
+      }
+
+      const spinner = ora(`Analyzing (${options.type})...`).start();
+
+      try {
+        let result;
+
+        if (options.type === "style") {
+          const { analyzeProjectStyle } =
+            await import("../lib/cowork/project-style-analyzer-cli.js");
+          const llmOptions = {};
+          if (options.provider) llmOptions.provider = options.provider;
+          if (options.model) llmOptions.model = options.model;
+          result = await analyzeProjectStyle({
+            targetPath: resolved,
+            llmOptions,
+          });
+        } else if (options.type === "knowledge-graph") {
+          const { buildKnowledgeGraph } =
+            await import("../lib/cowork/code-knowledge-graph-cli.js");
+          result = await buildKnowledgeGraph({ targetPath: resolved });
+        } else if (options.type === "decisions") {
+          const { extractDecisions } =
+            await import("../lib/cowork/decision-kb-cli.js");
+          const llmOptions = {};
+          if (options.provider) llmOptions.provider = options.provider;
+          if (options.model) llmOptions.model = options.model;
+          result = await extractDecisions({
+            targetPath: resolved,
+            llmOptions,
+          });
+        } else {
+          spinner.fail(`Unknown analysis type: ${options.type}`);
+          process.exit(1);
+        }
+
+        spinner.stop();
+
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          logger.log(
+            chalk.bold(`\nAnalysis (${options.type}): ${targetPath}\n`),
+          );
+          if (result.summary) {
+            logger.log(result.summary);
+          } else {
+            console.log(JSON.stringify(result, null, 2));
+          }
+          logger.log("");
+        }
+      } catch (err) {
+        spinner.fail(`Analysis failed: ${err.message}`);
+        if (program.opts().verbose) console.error(err.stack);
+        process.exit(1);
+      }
+    });
+
+  // cowork status — show collaboration state
+  cowork
+    .command("status")
+    .description("Show cowork collaboration status")
+    .action(async () => {
+      logger.log(chalk.bold("\nCowork Status\n"));
+      logger.log(`  Available commands:`);
+      logger.log(
+        `    ${chalk.cyan("cowork debate <file>")}     Multi-perspective code review`,
+      );
+      logger.log(
+        `    ${chalk.cyan("cowork compare <prompt>")}  A/B solution comparison`,
+      );
+      logger.log(
+        `    ${chalk.cyan("cowork analyze <path>")}    Code analysis (style/knowledge-graph/decisions)`,
+      );
+      logger.log("");
+      logger.log(
+        chalk.gray(
+          "  All commands use the configured LLM provider. Override with --provider/--model.",
+        ),
+      );
+      logger.log("");
+    });
+}