@chimix/agentscan 0.2.0 → 0.3.0

package/README.md

@@ -88,7 +88,8 @@ Run it against any project. It reads that project, writes nothing, and never
 leaves your machine:
 
 ```bash
-npx @chimix/agentscan@latest check ~/path/to/your-project
+cd ~/your-project
+npx @chimix/agentscan@latest
 ```
 
 Works on Node 20.11+ or Bun — the published bin is a single bundled file with
@@ -175,21 +176,18 @@ Flags for `check`:
 ## Sample output
 
 ```text
-agentscan v0.1.0 — touchagency
+agentscan v0.3.0 — touchagency
 
-Stack: 46 deps · 54 skills · 1 mcp · 2 agents · packageManager=bun
+Scanned: 46 deps · 54 skills · 1 mcp · 2 agents · packageManager=bun
 
-WARN    hook:PreToolUse:.claude/hooks/guard-destructive-bash.js
-        rule:hook.missing-script
-        PreToolUse hook points at a script that does not exist: .claude/hooks/guard-destructive-bash.js
-        evidence: hook PreToolUse @ …/.claude/settings.json · script .claude/hooks/guard-destructive-bash.js
-
-WARN    hook:PreToolUse:.claude/hooks/protect-artists-json.js
-        rule:hook.missing-script
-        PreToolUse hook points at a script that does not exist: .claude/hooks/protect-artists-json.js
-        evidence: hook PreToolUse @ …/.claude/settings.json · script .claude/hooks/protect-artists-json.js
+WARN    rule:hook.missing-script  ×6
+        PreToolUse hook points at a script that does not exist
+          PostToolUse @ .claude/settings.json · .claude/hooks/notify-related-tests.js
+          PreToolUse @ .claude/settings.json · .claude/hooks/guard-destructive-bash.js
+          PreToolUse @ .claude/settings.json · .claude/hooks/protect-artists-json.js
+          PreToolUse @ .claude/settings.json · .claude/hooks/protect-env.js
 
-Summary: 6 warn · 4 info hidden (--verbose) · score 40/100
+Summary: 6 warn · 4 info hidden (--verbose) · score 40/100 broken
 ```
 
 The `Stack:` line is orientation only — which project, how big. The summary lists

package/dist/cli.js

@@ -12534,6 +12534,21 @@ function score(findings) {
   }
   return Math.max(0, 100 - deduction);
 }
+function scoreLabel(points) {
+  if (points === 100) {
+    return "clean";
+  }
+  if (points >= 90) {
+    return "good";
+  }
+  if (points >= 70) {
+    return "needs work";
+  }
+  if (points >= 50) {
+    return "poor";
+  }
+  return "broken";
+}
 
 // src/report/exit-code.ts
 function exitCode(findings, failOn, failUnder) {
@@ -12685,10 +12700,10 @@ function renderText(args) {
     lines.push(`       no package.json in ${safe(args.resolvedFrom)} — scanned ${safe(facts.root)}`);
   }
   lines.push("");
-  lines.push(`Stack: ${formatStack(facts)}`);
+  lines.push(`Scanned: ${formatStack(facts)}`);
   lines.push("");
-  for (const f of visible) {
-    lines.push(...formatFinding(f));
+  for (const group of groupByRule(visible)) {
+    lines.push(...formatGroup(group, facts.root));
     lines.push("");
   }
   lines.push(summary);
@@ -12712,17 +12727,38 @@ function formatStack(facts) {
     `packageManager=${facts.packageManager}`
   ].join(" · ");
 }
-function formatFinding(f) {
+function groupByRule(findings) {
+  const byRule = new Map;
+  for (const f of findings) {
+    const bucket = byRule.get(f.ruleId);
+    if (bucket === undefined) {
+      byRule.set(f.ruleId, [f]);
+    } else {
+      bucket.push(f);
+    }
+  }
+  return [...byRule.values()];
+}
+function shortPath(value, root) {
+  return value.split(`${root}/`).join("");
+}
+function formatGroup(group, root) {
+  const first = group[0];
+  const count = group.length;
   const out = [];
-  out.push(`${actionColumn(f.action)} ${safe(f.subject)}`);
-  out.push(`        rule:${safe(f.ruleId)}`);
-  out.push(`        ${safe(f.message)}`);
-  if (f.evidence.length > 0) {
-    const ev = f.evidence.map((e) => `${safe(e.kind)} ${safe(e.value)}`).join(" · ");
-    out.push(`        evidence: ${ev}`);
+  out.push(`${actionColumn(first.action)} rule:${safe(first.ruleId)}${count > 1 ? `  ×${count}` : ""}`);
+  out.push(`        ${safe(count === 1 ? first.message : ruleHeadline(first))}`);
+  for (const f of group) {
+    const where = f.evidence.filter((e) => e.kind !== "count" && e.kind !== "threshold").map((e) => shortPath(e.value, root));
+    const location = where.length > 0 ? where.join(" · ") : f.subject;
+    out.push(`          ${safe(shortPath(location, root))}`);
   }
   return out;
 }
+function ruleHeadline(f) {
+  const cut = f.message.indexOf(": ");
+  return cut === -1 ? f.message : f.message.slice(0, cut);
+}
 function formatSummary(findings, verbose) {
   const counts = {
     keep: 0,
@@ -12746,14 +12782,15 @@ function formatSummary(findings, verbose) {
     parts.push(`${infoHidden} info hidden (--verbose)`);
   }
   const points = score(findings);
+  const scored = `score ${points}/100 ${scoreLabel(points)}`;
   if (parts.length === 0) {
-    return `Summary: no findings · score ${points}/100`;
+    return `Summary: no findings · ${scored}`;
   }
-  return `Summary: ${parts.join(" · ")} · score ${points}/100`;
+  return `Summary: ${parts.join(" · ")} · ${scored}`;
 }
 
 // src/version.ts
-var VERSION = "0.2.0";
+var VERSION = "0.3.0";
 
 // src/commands/check.ts
 async function runCheck(options) {
@@ -12936,6 +12973,7 @@ function printHelp() {
   const text = `agentscan v${VERSION}
 
 Usage:
+  agentscan                            scan the current directory
   agentscan check [dir] [options]
   agentscan explain <findingId> [dir]
   agentscan rules [dir]
@@ -13004,15 +13042,11 @@ async function main(argv) {
 `);
     return 0;
   }
-  if (values.help || positionals.length === 0) {
-    printHelp();
-    return 0;
-  }
-  const command = positionals[0];
-  if (command === undefined) {
+  if (values.help) {
     printHelp();
     return 0;
   }
+  const command = positionals[0] ?? "check";
   try {
     switch (command) {
       case "check": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chimix/agentscan",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Find broken agent configuration in a project — hooks whose scripts are gone, MCP servers that cannot start, skills that disagree with their lockfile",
   "type": "module",
   "bin": {