agentwaste-core 0.1.0 → 0.1.1

package/README.md

@@ -1,13 +1,8 @@
 # agentwaste-core
 
-Shared scanner/report engine used by the `agentmess` focused CLI tools.
+Shared scanner engine used by the two focused local CLIs:
 
-This package is meant as a dependency for:
-
-- `suckytraces`
-- `keybarf`
-- `tokengoblin`
 - `tooltantrum`
-- `agentmess`
+- `suckytraces`
 
 It has no public `npx` command of its own.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "agentwaste-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
-  "description": "Shared local coding-agent scanner powering agentmess and the tiny gremlin CLI squad.",
+  "description": "Shared local coding-agent scanner powering tooltantrum and suckytraces.",
   "keywords": [
     "ai",
     "agents",

package/src/cli.js

@@ -1,69 +1,11 @@
 import { resolve } from "node:path";
 
-import { buildReport, calculationGuide } from "./report.js";
-import { scanAgentWaste } from "./scanner.js";
-import { buildToolReport, explainTool, getToolConfig, listToolConfigs } from "./tools.js";
-
-const DEFAULT_PACKAGE = { name: "agentmess", version: "0.1.0" };
-
-export async function runAgentmessCli(argv, packageInfo = DEFAULT_PACKAGE) {
-  const parsed = parseArgs(argv, {
-    defaultCommand: "scan",
-    commands: new Set(["scan", "explain", "tools", "squad"]),
-    aliases: new Map([["list", "tools"]]),
-  });
-
-  if (parsed.help) {
-    console.log(agentmessHelp(packageInfo));
-    return;
-  }
-  if (parsed.version) {
-    console.log(packageInfo.version);
-    return;
-  }
-  if (parsed.options.command === "tools" || parsed.options.command === "squad") {
-    console.log(toolSquadText(packageInfo));
-    return;
-  }
-  if (parsed.options.command === "explain") {
-    console.log(calculationGuide({ version: packageInfo.version, json: parsed.options.json }));
-    return;
-  }
-
-  const startedAt = Date.now();
-  const spinner = startScanSpinner(parsed.options, "agentmess");
-  let stats;
-  try {
-    stats = await scanAgentWaste(parsed.options);
-  } finally {
-    spinner.stop();
-  }
-  const elapsedMs = Date.now() - startedAt;
-  const report = buildReport(stats, {
-    version: packageInfo.version,
-    elapsedMs,
-    color: parsed.options.color,
-  });
-
-  if (parsed.options.json) {
-    console.log(JSON.stringify(report.json, null, 2));
-    return;
-  }
-
-  console.log(report.text);
-}
+import { SCAN_DEFAULTS, scanAgentWaste } from "./scanner.js";
+import { buildToolReport, explainTool, getToolConfig } from "./tools.js";
 
 export async function runToolCli(argv, toolId, packageInfo = { name: toolId, version: "0.1.0" }) {
   const config = getToolConfig(toolId);
-  const parsed = parseArgs(argv, {
-    defaultCommand: "scan",
-    commands: new Set(["scan", "show", "sniff", "roast", "explain"]),
-    aliases: new Map([
-      ["show", "scan"],
-      ["sniff", "scan"],
-      ["roast", "scan"],
-    ]),
-  });
+  const parsed = parseArgs(argv);
 
   if (parsed.help) {
     console.log(toolHelp(config, packageInfo));
@@ -86,11 +28,11 @@ export async function runToolCli(argv, toolId, packageInfo = { name: toolId, ver
   } finally {
     spinner.stop();
   }
-  const elapsedMs = Date.now() - startedAt;
+
   const report = buildToolReport(stats, {
     toolId,
     version: packageInfo.version,
-    elapsedMs,
+    elapsedMs: Date.now() - startedAt,
     color: parsed.options.color,
   });
 
@@ -98,26 +40,37 @@ export async function runToolCli(argv, toolId, packageInfo = { name: toolId, ver
     console.log(JSON.stringify(report.json, null, 2));
     return;
   }
+  if (parsed.options.share) {
+    console.log(report.share);
+    return;
+  }
 
   console.log(report.text);
 }
 
-function parseArgs(argv, config) {
+function parseArgs(argv) {
   const args = argv.slice(2);
   const options = {
-    command: config.defaultCommand,
+    command: "scan",
     homeDir: undefined,
     projectDir: process.cwd(),
-    days: 365,
-    maxFiles: Number.MAX_SAFE_INTEGER,
+    days: SCAN_DEFAULTS.days,
+    maxFiles: SCAN_DEFAULTS.maxFiles,
+    concurrency: SCAN_DEFAULTS.concurrency,
     json: false,
+    share: false,
     color: process.stdout.isTTY,
   };
 
   if (args[0] && !args[0].startsWith("-")) {
-    const rawCommand = args.shift();
-    if (!config.commands.has(rawCommand)) throw new Error(`unknown command ${rawCommand}`);
-    options.command = config.aliases.get(rawCommand) ?? rawCommand;
+    const command = args.shift();
+    if (command === "explain") {
+      options.command = "explain";
+    } else if (["scan", "show", "sniff", "roast"].includes(command)) {
+      options.command = "scan";
+    } else {
+      throw new Error(`unknown command ${command}`);
+    }
   }
 
   let maxFilesExplicit = false;
@@ -130,13 +83,17 @@ function parseArgs(argv, config) {
       options.json = true;
       continue;
     }
+    if (arg === "--share") {
+      options.share = true;
+      continue;
+    }
     if (arg === "--no-color") {
       options.color = false;
       continue;
     }
     if (arg === "--all") {
       options.days = "all";
-      if (!maxFilesExplicit) options.maxFiles = Number.MAX_SAFE_INTEGER;
+      if (!maxFilesExplicit) options.maxFiles = SCAN_DEFAULTS.exhaustiveMaxFiles;
       continue;
     }
     if (arg === "--home") {
@@ -155,7 +112,7 @@ function parseArgs(argv, config) {
       i += 1;
       if (!args[i]) throw new Error("--days requires a number or all");
       options.days = parseDays(args[i], "--days");
-      if (options.days === "all" && !maxFilesExplicit) options.maxFiles = Number.MAX_SAFE_INTEGER;
+      if (options.days === "all" && !maxFilesExplicit) options.maxFiles = SCAN_DEFAULTS.exhaustiveMaxFiles;
       continue;
     }
     if (arg === "--max-files") {
@@ -165,6 +122,12 @@ function parseArgs(argv, config) {
       options.maxFiles = parsePositiveInt(args[i], "--max-files");
       continue;
     }
+    if (arg === "--concurrency") {
+      i += 1;
+      if (!args[i]) throw new Error("--concurrency requires a number");
+      options.concurrency = parsePositiveInt(args[i], "--concurrency");
+      continue;
+    }
     throw new Error(`unknown option ${arg}`);
   }
 
@@ -182,121 +145,47 @@ function parsePositiveInt(value, flag) {
   return parsed;
 }
 
-function agentmessHelp(packageInfo) {
-  return `agentmess v${packageInfo.version}
-
-Usage:
-  agentmess [scan] [options]
-  agentmess explain [options]
-  agentmess tools
-
-Commands:
-  scan                    Full local agent postmortem (default)
-  explain                 Explain every report formula without scanning logs
-  tools                   Show the focused npx CLIs
-
-Options:
-  --home <path>             Home directory to scan (default: current user's home)
-  --path <path>             Project directory to scan (default: cwd)
-  --days <number|all>       Lookback window in days (default: 365)
-  --all                     Scan all available sessions (same as --days all)
-  --max-files <number>      Maximum session files per source (default: unlimited)
-  --json                    Print machine-readable JSON
-  --no-color                Disable ANSI color
-  --version                 Print version
-  --help                    Show help
-
-Focused tools:
-${listToolConfigs().map((tool) => `  npx ${tool.binName.padEnd(16)} ${tool.emoji} ${tool.npc}`).join("\n")}
-
-The scanner runs locally. It counts redacted fingerprints and aggregate metrics;
-it does not upload transcripts or print raw secret values.`;
-}
-
 function toolHelp(config, packageInfo) {
   return `${config.packageName} v${packageInfo.version}
 
-${config.emoji} ${config.npc}: ${config.tagline}
+${config.tagline}
 
 Usage:
-  ${config.binName} [scan] [options]
+  ${config.binName} [options]
   ${config.binName} explain [options]
 
-Aliases:
-  ${config.binName} show
-  ${config.binName} sniff
-  ${config.binName} roast
-
 Options:
   --home <path>             Home directory to scan (default: current user's home)
   --path <path>             Project directory to scan (default: cwd)
-  --days <number|all>       Lookback window in days (default: 365)
-  --all                     Scan all available sessions (same as --days all)
-  --max-files <number>      Maximum session files per source (default: unlimited)
+  --days <number|all>       Lookback window in days (default: ${SCAN_DEFAULTS.days})
+  --all                     Scan all available sessions
+  --max-files <number>      Maximum session files per source (default: ${SCAN_DEFAULTS.maxFiles})
+  --concurrency <number>    Session files to scan in parallel (default: ${SCAN_DEFAULTS.concurrency})
   --json                    Print machine-readable JSON
+  --share                   Print a copy-pasteable summary card
   --no-color                Disable ANSI color
   --version                 Print version
   --help                    Show help
 
-Try:
-  npx ${config.binName}
-  npx ${config.binName} --days 7
-  npx ${config.binName} --json`;
-}
-
-function toolSquadText(packageInfo) {
-  return [
-    `agentmess focused tools v${packageInfo.version}`,
-    "",
-    ...listToolConfigs().map((tool) => `npx ${tool.binName.padEnd(16)} ${tool.emoji} ${tool.npc} — ${tool.tagline}`),
-    "",
-    "npx agentmess       consolidated report for the focused checks",
-  ].join("\n");
-}
-
-async function narrate(options, toolId) {
-  if (options.json || !process.stdout.isTTY) return;
-  for (const line of narrationMessages(toolId)) {
-    process.stdout.write(`${ansi(options.color, "38;2;148;163;184", `  ${line}`)}\n`);
-    await sleep(170);
-  }
-}
-
-function narrationMessages(toolId) {
-  switch (toolId) {
-    case "suckytraces":
-      return ["scanning session logs.", "computing trace coverage."];
-    case "keybarf":
-      return ["scanning logs and config for secret fingerprints.", "checking whether fingerprints appear in model-facing records."];
-    case "tokengoblin":
-      return ["reading token usage records.", "computing fresh input, cache hit rate, and excess context."];
-    case "tooltantrum":
-      return ["counting tool calls and failures.", "computing retry recovery and unresolved failures."];
-    default:
-      return ["scanned the agent logs.", "numbers first, feelings later."];
-  }
-}
-
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+The scanner runs locally and prints aggregate metrics only.`;
 }
 
 function startScanSpinner(options, toolId) {
   if (options.json || !process.stdout.isTTY) return { stop() {} };
 
   const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-  const messages = spinnerMessages(toolId);
+  const startedAt = Date.now();
   let index = 0;
 
   const render = () => {
     const frame = frames[index % frames.length];
-    const message = messages[Math.floor(index / 8) % messages.length];
-    process.stdout.write(`\r${ansi(options.color, "38;2;147;197;253", frame)} ${ansi(options.color, "38;2;148;163;184", message)} `);
+    const elapsed = formatSpinnerSeconds(Date.now() - startedAt);
+    process.stdout.write(`\r\x1b[2K${ansi(options.color, "38;2;147;197;253", frame)} ${toolId} scanning local sessions · ${elapsed}`);
     index += 1;
   };
 
   render();
-  const timer = setInterval(render, 80);
+  const timer = setInterval(render, 120);
 
   return {
     stop() {
@@ -306,26 +195,12 @@ function startScanSpinner(options, toolId) {
   };
 }
 
-function spinnerMessages(toolId) {
-  switch (toolId) {
-    case "suckytraces":
-      return ["scanning session logs...", "checking trace identifiers...", "computing trace coverage..."];
-    case "keybarf":
-      return ["scanning secret patterns...", "fingerprinting matches...", "checking model-facing records..."];
-    case "tokengoblin":
-      return ["reading token usage...", "computing fresh input...", "checking cache hit rate..."];
-    case "tooltantrum":
-      return ["counting tool calls...", "measuring failure rate...", "checking retry recovery..."];
-    default:
-      return ["scanning sessions...", "checking token usage...", "checking secrets...", "checking tool reliability...", "checking trace coverage..."];
-  }
+function formatSpinnerSeconds(ms) {
+  const seconds = Math.max(0.1, Number(ms || 0) / 1000);
+  return `${seconds.toFixed(seconds >= 10 ? 0 : 1)}s`;
 }
 
 function ansi(enabled, code, value) {
   if (!enabled) return value;
   return `\x1b[${code}m${value}\x1b[0m`;
 }
-
-function color(code, value) {
-  return `\x1b[${code}m${value}\x1b[0m`;
-}

package/src/index.js

@@ -1,4 +1,3 @@
-export { runAgentmessCli, runToolCli } from "./cli.js";
-export { buildReport, calculationGuide, toReportJson } from "./report.js";
+export { runToolCli } from "./cli.js";
 export { scanAgentWaste } from "./scanner.js";
 export { TOOL_IDS, buildToolReport, explainTool, getToolConfig, listToolConfigs } from "./tools.js";