ccsniff 1.1.11 → 1.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccsniff",
-  "version": "1.1.11",
+  "version": "1.1.13",
   "description": "Watch Claude Code JSONL output files and emit structured events as a Node.js EventEmitter",
   "type": "module",
   "main": "./src/index.js",

package/src/cli.js

@@ -30,7 +30,7 @@ const FLAGS = {
   string: ['since', 'until', 'before', 'after', 'grep', 'igrep', 'cwd', 'project', 'role', 'type', 'tool', 'session', 'sid', 'sess', 'parent', 'rollup', 'format', 'sort', 'unsloth', 'unsloth-format', 'exclude-sess', 'exclude-sid', 'exclude-cwd', 'exclude-project'],
   multi: ['grep', 'igrep', 'role', 'type', 'tool', 'session', 'sid', 'project', 'cwd', 'exclude-sess', 'exclude-sid', 'exclude-cwd', 'exclude-project'],
   number: ['limit', 'head', 'tail-n', 'ctx', 'truncate', 'days'],
-  bool: ['json', 'ndjson', 'tail', 'f', 'full', 'reverse', 'invert', 'no-subagents', 'only-subagents', 'no-meta', 'only-meta', 'list-sessions', 'list-projects', 'list-tools', 'bash-discipline', 'git-discipline', 'learning-xref', 'include-subagents', 'stats', 'count', 'help', 'h'],
+  bool: ['json', 'ndjson', 'tail', 'f', 'full', 'reverse', 'invert', 'no-subagents', 'only-subagents', 'no-meta', 'only-meta', 'list-sessions', 'list-projects', 'list-tools', 'bash-discipline', 'git-discipline', 'search-discipline', 'glyph-discipline', 'learning-xref', 'include-subagents', 'stats', 'count', 'help', 'h'],
 };
 
 function parseArgs(argv) {
@@ -66,6 +66,8 @@ USAGE
   ccsniff --bash-discipline [--stats]   Bash calls that should have used Read/Glob/Grep
   ccsniff --learning-xref [--sess <id>] [--days N]   join transcript turns to rs-learn recall/memorize
   ccsniff --git-discipline [--stats]    git push from a dirty/unwitnessed tree
+  ccsniff --search-discipline [--stats] native search (Grep/Glob/Explore/find) instead of codesearch/recall
+  ccsniff --glyph-discipline [--stats]  decorative glyphs (arrows/box/star/dot/check/emoji) written into files
                                         (excludes subagents by default — --include-subagents to opt in;
                                          excludes 'echo > .gm/exec-spool/in/...' as canonical spool-write)
   ccsniff --stats [filters]
@@ -369,6 +371,101 @@ if (opts['git-discipline']) {
   process.exit(0);
 }
 
+// ---------- search-discipline (flag native search that should have been codesearch/recall)
+// A native-search bypass (Grep/Glob, the Explore/Task search subagent, or bash grep/rg/find/ag)
+// emits NO plugkit deviation because it never touches the spool — it is invisible to gmsniff and
+// the watcher ledger. ccsniff reads the tool-call stream directly, so it is the only surface that
+// can catch the SKILL.md class-rule violation: code/file/symbol search routes through codesearch,
+// prior-knowledge through recall, never a host-native search tool.
+if (opts['search-discipline']) {
+  const includeSubagents = opts['include-subagents'];
+  const BASH_SEARCH = /(^|[|&;]|\s)(rg|grep|find|ag|ack|fd|fgrep|egrep)\s/;
+  const violations = [];
+  for (const ev of all) {
+    if (!filter(ev)) continue;
+    if (ev.block?.type !== 'tool_use') continue;
+    if (!includeSubagents && ev.conversation?.isSubagent) continue;
+    const name = ev.block?.name || '';
+    const project = path.basename(ev.conversation?.cwd || '');
+    const ts = ev.timestamp, sid = ev.conversation?.id || '';
+    let kind = null, detail = '';
+    if (name === 'Grep' || name === 'Glob') {
+      kind = `native-search-${name.toLowerCase()}`;
+      detail = (ev.block?.input?.pattern || ev.block?.input?.query || '').slice(0, 120);
+    } else if (name === 'Task' || name === 'Agent') {
+      const sub = (ev.block?.input?.subagent_type || ev.block?.input?.description || '').toLowerCase();
+      if (/explore|search|general-purpose/.test(sub)) {
+        kind = 'native-search-subagent';
+        detail = sub.slice(0, 120);
+      }
+    } else if (name === 'Bash') {
+      const cmd = ev.block?.input?.command || '';
+      if (BASH_SEARCH.test(cmd)) {
+        kind = 'native-search-bash';
+        // show the line that actually invokes the search tool, not line 1 (often a cd)
+        const hit = cmd.split('\n').find(l => BASH_SEARCH.test(l)) || cmd;
+        detail = hit.trim().slice(0, 120);
+      }
+    }
+    if (kind) violations.push({ ts, sid, project, kind, detail });
+  }
+  if (opts.stats || opts.count) {
+    if (opts.count) { process.stdout.write(`${violations.length}\n`); process.exit(0); }
+    process.stdout.write(`# ${violations.length} search-discipline violations (native search instead of codesearch/recall)\n`);
+    const byKind = new Map(), byProj = new Map();
+    for (const v of violations) { byKind.set(v.kind, (byKind.get(v.kind) || 0) + 1); byProj.set(v.project, (byProj.get(v.project) || 0) + 1); }
+    process.stdout.write(`# by kind\n`);
+    for (const [k, c] of [...byKind.entries()].sort((a, b) => b[1] - a[1])) process.stdout.write(`  ${String(c).padStart(6)}  ${k}\n`);
+    process.stdout.write(`# by project\n`);
+    for (const [p, c] of [...byProj.entries()].sort((a, b) => b[1] - a[1])) process.stdout.write(`  ${String(c).padStart(6)}  ${p}\n`);
+    process.exit(0);
+  }
+  for (const v of violations) {
+    process.stdout.write(`${new Date(v.ts).toISOString().slice(0, 19)}  ${v.sid.slice(0, 8)}  ${v.kind.padEnd(24)} [${v.project}]  ${v.detail}\n`);
+  }
+  process.stderr.write(`# ${violations.length} violations — use codesearch (code/file/symbol) or recall (prior knowledge) instead\n`);
+  process.exit(0);
+}
+
+// ---------- glyph-discipline (flag decorative graphical symbols written into files)
+// The gm SKILL.md rule forbids decorative glyphs (arrows, box/geometric glyphs, stars, dots,
+// bullets, checkmarks, crosses, emojis) in output and source; they must convert to ASCII on sight.
+// A glyph written into a file via Write/Edit is invisible to the spool ledger, so ccsniff reading
+// the tool-call stream is the surface that catches it. Functional operators are ASCII and never match.
+if (opts['glyph-discipline']) {
+  const includeSubagents = opts['include-subagents'];
+  const GLYPH = /[←-⇿⌀-⏿■-◿☀-➿⬀-⯿]|[\u{1F000}-\u{1FAFF}]/u;
+  const GLYPH_G = /[←-⇿⌀-⏿■-◿☀-➿⬀-⯿]|[\u{1F000}-\u{1FAFF}]/gu;
+  const violations = [];
+  for (const ev of all) {
+    if (!filter(ev)) continue;
+    if (ev.block?.type !== 'tool_use') continue;
+    if (!includeSubagents && ev.conversation?.isSubagent) continue;
+    const name = ev.block?.name || '';
+    if (name !== 'Write' && name !== 'Edit' && name !== 'NotebookEdit') continue;
+    const inp = ev.block?.input || {};
+    const filePath = inp.file_path || inp.notebook_path || '';
+    const content = [inp.content, inp.new_string, inp.new_source].filter(s => typeof s === 'string').join('\n');
+    if (!content || !GLYPH.test(content)) continue;
+    const glyphs = [...new Set((content.match(GLYPH_G) || []))].slice(0, 10).join(' ');
+    violations.push({ ts: ev.timestamp, sid: ev.conversation?.id || '', project: path.basename(ev.conversation?.cwd || ''), kind: 'glyph-written', file: path.basename(filePath), glyphs });
+  }
+  if (opts.stats || opts.count) {
+    if (opts.count) { process.stdout.write(`${violations.length}\n`); process.exit(0); }
+    process.stdout.write(`# ${violations.length} glyph-discipline violations (decorative glyphs written to files)\n`);
+    const byProj = new Map();
+    for (const v of violations) byProj.set(v.project, (byProj.get(v.project) || 0) + 1);
+    process.stdout.write(`# by project\n`);
+    for (const [p, c] of [...byProj.entries()].sort((a, b) => b[1] - a[1])) process.stdout.write(`  ${String(c).padStart(6)}  ${p}\n`);
+    process.exit(0);
+  }
+  for (const v of violations) {
+    process.stdout.write(`${new Date(v.ts).toISOString().slice(0, 19)}  ${v.sid.slice(0, 8)}  ${v.kind.padEnd(14)} [${v.project}]  ${v.file}  ${v.glyphs}\n`);
+  }
+  process.stderr.write(`# ${violations.length} violations — convert decorative glyphs to ASCII (-> for arrow, - or * for bullet, [x]/[ ] for check/cross)\n`);
+  process.exit(0);
+}
+
 // ---------- learning-xref (join transcript turns to gm-log rs_learn signals)
 if (opts['learning-xref']) {
   const days = opts.days || 1;