@stupify/cli 0.0.11 → 0.0.13

package/dist/analysis.js

@@ -101,7 +101,7 @@ function stringSnapshot(value) {
 }
 function limitSnapshot(value) {
     const lines = value.split(/\r?\n/);
-    const limit = 24;
+    const limit = 12;
     if (lines.length <= limit)
         return value;
     return `${lines.slice(0, limit).join("\n")}

package/dist/command.js

@@ -3,7 +3,7 @@ const DEFAULT_SINCE = "2 weeks ago";
 const DEFAULT_MAX_CANDIDATES = 10;
 const DEFAULT_MAX_SEARCH_INPUT_TOKENS = 12_000;
 export function parseCommand(argv) {
-    if (argv.length === 1 && isHelp(argv[0]))
+    if (argv.length === 1 && argv[0] && isHelp(argv[0]))
         return { kind: "help" };
     if (argv[0] === "bench") {
         if (argv[1] !== "search" || !argv[2] || argv.length > 3) {

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.0.11";
+export declare const VERSION = "0.0.13";
 import type { ModelConfig, ModelId } from "./types.ts";
 export declare const DEFAULT_MODEL_ID: ModelId;
 export declare const MODEL_REGISTRY: Record<ModelId, ModelConfig>;

package/dist/constants.js

@@ -1,4 +1,4 @@
-export const VERSION = "0.0.11";
+export const VERSION = "0.0.13";
 export const DEFAULT_MODEL_ID = "gemma-4-e2b";
 export const MODEL_REGISTRY = {
     "gemma-4-e2b": {

package/dist/counter-scout.d.ts

@@ -9,6 +9,13 @@ type SignalBucket = Readonly<{
     total: number;
     examples: readonly Signal[];
 }>;
+export type CounterScoutPlan = Readonly<{
+    buckets: readonly SignalBucket[];
+    totalSignals: number;
+    maxTargets: number;
+    targets: readonly SemCandidate[];
+}>;
 export declare function counterScoutTargets(changeSet: SemChangeSet, checks: readonly StupifyCheck[], maxTargets: number): readonly SemCandidate[];
+export declare function counterScoutPlan(changeSet: SemChangeSet, checks: readonly StupifyCheck[], maxTargets: number): CounterScoutPlan;
 export declare function runSignalCounters(changeSet: SemChangeSet, checks: readonly StupifyCheck[]): readonly SignalBucket[];
 export {};

package/dist/counter-scout.js

@@ -1,5 +1,8 @@
 const MAX_COUNTER_EXAMPLES_PER_CHECK = 4;
 export function counterScoutTargets(changeSet, checks, maxTargets) {
+    return counterScoutPlan(changeSet, checks, maxTargets).targets;
+}
+export function counterScoutPlan(changeSet, checks, maxTargets) {
     const buckets = runSignalCounters(changeSet, checks);
     const targets = [];
     let cursor = 0;
@@ -20,7 +23,12 @@ export function counterScoutTargets(changeSet, checks, maxTargets) {
         }
         cursor += 1;
     }
-    return targets;
+    return {
+        buckets,
+        totalSignals: buckets.reduce((sum, bucket) => sum + bucket.total, 0),
+        maxTargets,
+        targets,
+    };
 }
 export function runSignalCounters(changeSet, checks) {
     return checks

package/dist/git.js

@@ -33,6 +33,8 @@ export async function sourceRangeForRecentCommits(count) {
         throw new Error("No non-merge commits found.");
     const oldest = commits[0];
     const newest = commits[commits.length - 1];
+    if (!oldest || !newest)
+        throw new Error("Could not resolve recent commit range.");
     const [base, target, shortBase, shortTarget] = await Promise.all([
         revParse(`${oldest}^1`),
         revParse(newest),
@@ -224,7 +226,7 @@ function statsFromDiff(diffText) {
     let deletions = 0;
     for (const line of diffText.split(/\r?\n/)) {
         const fileMatch = /^diff --git a\/.+ b\/(.+)$/.exec(line);
-        if (fileMatch)
+        if (fileMatch?.[1])
             files.add(fileMatch[1]);
         else if (line.startsWith("+") && !line.startsWith("+++"))
             additions += 1;

package/dist/model.js

@@ -190,7 +190,7 @@ async function managedServerPid(runtime) {
         return null;
     }
 }
-function pidPath(runtime) {
+function pidPath(_runtime) {
     return path.join(cacheDir(), "llama-server.pid");
 }
 function envInteger(name, fallback) {

package/dist/render.js

@@ -25,9 +25,9 @@ ${format.label("Patterns:")} ${run.patterns.join(", ")}
 ${format.success("No judgment-offload signals found.")}`;
     }
     return `${slopHeading()}
-${run.matches.map((match, index) => `${index + 1}. ${format.label(match.patternId)}
 ${committerLabel(run)} (${sourceLabel(command)})
 
+${run.matches.map((match, index) => `${index + 1}. ${format.label(match.patternId)}
 ${match.reason}
 
 \`\`\`
@@ -36,7 +36,7 @@ ${match.snapshot ?? match.proof}
 ${format.muted(match.proof)}
 
 ${match.checkWhy ?? "This pattern may indicate judgment-offload."}`).join("\n\n")}
-${format.muted("Search mode is warn-only.")}`;
+${format.muted(summaryLine(run))}`;
 }
 export function helpText() {
     return `Stupify ${VERSION}
@@ -98,23 +98,32 @@ function sourceHint(command) {
 }
 function sourceLabel(command) {
     if (command.kind === "staged")
-        return "staged changes";
+        return "staged";
     if (command.kind === "since")
-        return `since ${command.since}`;
+        return sinceLabel(command.since);
     if (command.kind === "commit")
         return `commit ${command.commit}`;
     if (command.kind === "commits")
         return `last ${command.count} commits`;
-    return "stdin diff";
+    return "stdin";
 }
 function committerLabel(run) {
-    const committers = (run.stats.committers ?? []).filter(Boolean).map(committerDisplayName);
+    const committers = humanCommitters(run.stats.committers ?? []).map(committerDisplayName);
     if (committers.length === 0)
         return "unknown committer";
     if (committers.length <= 3)
         return committers.join(", ");
     return `${committers.slice(0, 3).join(", ")} +${committers.length - 3} more`;
 }
+function humanCommitters(committers) {
+    const nonEmpty = committers.filter(Boolean);
+    const humans = nonEmpty.filter((committer) => !isBotCommitter(committer));
+    return humans.length > 0 ? humans : nonEmpty;
+}
+function isBotCommitter(value) {
+    return /(?:^|<)(?:github|dependabot|renovate)(?:\s|@|>)/i.test(value) ||
+        /(?:noreply@github\.com|bot@)/i.test(value);
+}
 function committerDisplayName(value) {
     return value.replace(/\s*<[^>]+>\s*$/, "").trim() || value;
 }
@@ -123,3 +132,20 @@ function slopHeading() {
     return `${format.warn(format.heading(heading))}
 ${format.warn("=".repeat(heading.length))}`;
 }
+function sinceLabel(since) {
+    const value = since.trim().toLowerCase();
+    if (value === "yesterday" || value === "1 day ago")
+        return "yesterday";
+    const match = /^(\d+)\s+(day|week|month|year)s?\s+ago$/.exec(value);
+    if (!match)
+        return `since ${since}`;
+    const count = Number(match[1]);
+    const unit = match[2];
+    if (count === 1)
+        return `last ${unit}`;
+    return `last ${count} ${unit}s`;
+}
+function summaryLine(run) {
+    const noun = run.matches.length === 1 ? "signal" : "signals";
+    return `${run.matches.length} ${noun}. Warn-only. Nothing blocked.`;
+}

package/dist/search-bench.js

@@ -39,7 +39,7 @@ export async function runSearchBench(configPath) {
         const runs = await runCommitReplay(replay, profiles, replayDir);
         replayRuns.push(...runs);
     }
-    const leaderboard = summarize(profiles.map(({ profile }) => profile), fixtures.map(({ fixture }) => fixture), allRuns);
+    const leaderboard = summarize(profiles.map(({ profile }) => profile), allRuns);
     const perCheck = summarizeByCheck(allRuns);
     const summary = {
         name: config.name,
@@ -246,6 +246,8 @@ function replayErrorRun(replayId, profileId, commit, error) {
 async function runCli(cwd, args) {
     const startedAt = Date.now();
     const cliPath = process.argv[1];
+    if (!cliPath)
+        throw new Error("Could not resolve current CLI entrypoint.");
     const { stdout } = await execFileAsync(process.execPath, [cliPath, ...args], {
         cwd,
         env: process.env,
@@ -341,7 +343,7 @@ function scoreSmokeRun(run) {
     score -= (run.inputTokens / 1000) * 0.001;
     return round(score);
 }
-function summarize(profiles, fixtures, runs) {
+function summarize(profiles, runs) {
     const rows = profiles.map((profile) => {
         const fixtureRuns = runs.filter((run) => run.profileId === profile.id && run.fixtureId);
         const smokeRuns = runs.filter((run) => run.profileId === profile.id && run.smokeId);

package/dist/stupify.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from "node:url";
 import { countPromptTokens, runSearch, searchRequest } from "./analysis.js";
 import { searchChecks } from "./checks.js";
 import { parseCommand } from "./command.js";
-import { counterScoutTargets } from "./counter-scout.js";
+import { counterScoutPlan } from "./counter-scout.js";
 import { runDoctor } from "./doctor.js";
 import { runHookCommand } from "./hooks.js";
 import { firstRunModelBootstrap, loadLocalModel } from "./model.js";
@@ -67,7 +67,10 @@ export async function runSearchCommand(command, startedAt, ui = createCliUi({ qu
         detail: (v) => `${v.summary.fileCount} files`,
     });
     try {
-        const candidates = counterScoutTargets(changeSet, checks, maxCandidates);
+        const scoutPlan = counterScoutPlan(changeSet, checks, maxCandidates);
+        if (!command.json)
+            ui.step(scoutPlanLine(scoutPlan, changeSet.summary.total));
+        const candidates = scoutPlan.targets;
         const contexts = entityContextsFromChanges(candidates, changeSet.changes);
         const targetsByPattern = countTargetsByPattern(contexts);
         const targetsPreview = previewTargets(contexts);
@@ -108,6 +111,8 @@ export async function runSearchCommand(command, startedAt, ui = createCliUi({ qu
         const searchContexts = profile?.context === "sem"
             ? contexts
             : contexts.filter((context) => context.filePath && packedFiles.has(context.filePath));
+        if (!command.json)
+            ui.step(targetPlanLine(searchContexts, contexts.length, countTargetsByPattern(searchContexts)));
         if (searchContexts.length === 0) {
             return {
                 schemaVersion: "search.v1",
@@ -181,11 +186,14 @@ export async function runSearchCommand(command, startedAt, ui = createCliUi({ qu
             };
         }
         if (batches.wasSplit && !command.json) {
-            ui.warn(`Search input is large; queued ${batches.batches.length} smaller search batches.`);
+            ui.warn(`Search input is large; queued ${batches.batches.length} smaller batches for ${searchContexts.length} targets (${maxSearchInputTokens} token cap).`);
             if (batches.skippedTargets > 0) {
                 ui.warn(`Skipped ${batches.skippedTargets} oversized targets that could not fit alone.`);
             }
         }
+        else if (!command.json) {
+            ui.step(`Search: ${searchContexts.length} targets in ${batches.batches.length} model batch (${maxSearchInputTokens} token cap)`);
+        }
         const modelPath = await firstRunModelBootstrap(command.model, ui);
         const model = await loadLocalModel(modelPath, command.model, "scout", ui);
         const matches = [];
@@ -345,6 +353,28 @@ function formatStep(name, ms, count, detail) {
         return `Model: ${count ?? 0} matches (${ms}ms)`;
     return `${name}: ${ms}ms`;
 }
+function scoutPlanLine(plan, entitiesScanned) {
+    if (plan.targets.length === 0) {
+        return `Scout: deterministic counters scanned ${entitiesScanned} entities; no target/check pairs selected`;
+    }
+    return [
+        `Scout: deterministic counters scanned ${entitiesScanned} entities`,
+        `${plan.totalSignals} counter signals`,
+        `selected ${plan.targets.length}/${plan.totalSignals} target/check pairs (cap ${plan.maxTargets}, not exhaustive)`,
+    ].join("; ");
+}
+function targetPlanLine(searchContexts, selectedTargets, targetsByPattern) {
+    const retained = searchContexts.length === selectedTargets
+        ? `${searchContexts.length} selected targets`
+        : `${searchContexts.length}/${selectedTargets} selected targets retained after context packing`;
+    return `Targets: model will inspect ${retained}; ${formatCounts(targetsByPattern)}`;
+}
+function formatCounts(counts) {
+    const entries = Object.entries(counts).filter(([, count]) => count > 0);
+    if (entries.length === 0)
+        return "no target/check pairs";
+    return entries.map(([id, count]) => `${id}=${count}`).join(", ");
+}
 function sourceLabel(command) {
     if (command.kind === "since")
         return `since ${command.since}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stupify/cli",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Local-only diagnostic CLI for checking whether AI is making you dumber.",
   "private": false,
   "type": "module",

package/src/analysis.ts

@@ -135,7 +135,7 @@ function stringSnapshot(value: unknown): string | undefined {
 
 function limitSnapshot(value: string): string {
   const lines = value.split(/\r?\n/);
-  const limit = 24;
+  const limit = 12;
   if (lines.length <= limit) return value;
   return `${lines.slice(0, limit).join("\n")}
 [stupify: snapshot shortened after ${limit} lines]`;

package/src/command.ts

@@ -1,5 +1,5 @@
 import { DEFAULT_MODEL_ID, MODEL_REGISTRY } from "./constants.ts";
-import type { Command, HookAction, ModelId, SearchSource } from "./types.ts";
+import type { Command, HookAction, ModelId } from "./types.ts";
 
 const DEFAULT_SINCE = "2 weeks ago";
 const DEFAULT_MAX_CANDIDATES = 10;
@@ -13,7 +13,7 @@ type InputMode =
   | Readonly<{ kind: "staged"; source: "staged" }>;
 
 export function parseCommand(argv: readonly string[]): Command {
-  if (argv.length === 1 && isHelp(argv[0])) return { kind: "help" };
+  if (argv.length === 1 && argv[0] && isHelp(argv[0])) return { kind: "help" };
   if (argv[0] === "bench") {
     if (argv[1] !== "search" || !argv[2] || argv.length > 3) {
       throw new Error("Usage: stupify bench search <config.json>");

package/src/constants.ts

@@ -1,4 +1,4 @@
-export const VERSION = "0.0.11";
+export const VERSION = "0.0.13";
 import type { ModelConfig, ModelId } from "./types.ts";
 
 export const DEFAULT_MODEL_ID: ModelId = "gemma-4-e2b";

package/src/counter-scout.ts

@@ -14,11 +14,26 @@ type SignalBucket = Readonly<{
 
 const MAX_COUNTER_EXAMPLES_PER_CHECK = 4;
 
+export type CounterScoutPlan = Readonly<{
+  buckets: readonly SignalBucket[];
+  totalSignals: number;
+  maxTargets: number;
+  targets: readonly SemCandidate[];
+}>;
+
 export function counterScoutTargets(
   changeSet: SemChangeSet,
   checks: readonly StupifyCheck[],
   maxTargets: number,
 ): readonly SemCandidate[] {
+  return counterScoutPlan(changeSet, checks, maxTargets).targets;
+}
+
+export function counterScoutPlan(
+  changeSet: SemChangeSet,
+  checks: readonly StupifyCheck[],
+  maxTargets: number,
+): CounterScoutPlan {
   const buckets = runSignalCounters(changeSet, checks);
   const targets: SemCandidate[] = [];
   let cursor = 0;
@@ -37,7 +52,12 @@ export function counterScoutTargets(
     }
     cursor += 1;
   }
-  return targets;
+  return {
+    buckets,
+    totalSignals: buckets.reduce((sum, bucket) => sum + bucket.total, 0),
+    maxTargets,
+    targets,
+  };
 }
 
 export function runSignalCounters(

package/src/git.ts

@@ -40,6 +40,7 @@ export async function sourceRangeForRecentCommits(count: number): Promise<Source
 
   const oldest = commits[0];
   const newest = commits[commits.length - 1];
+  if (!oldest || !newest) throw new Error("Could not resolve recent commit range.");
   const [base, target, shortBase, shortTarget] = await Promise.all([
     revParse(`${oldest}^1`),
     revParse(newest),
@@ -233,7 +234,7 @@ function statsFromDiff(diffText: string): NetDiffStats {
   let deletions = 0;
   for (const line of diffText.split(/\r?\n/)) {
     const fileMatch = /^diff --git a\/.+ b\/(.+)$/.exec(line);
-    if (fileMatch) files.add(fileMatch[1]);
+    if (fileMatch?.[1]) files.add(fileMatch[1]);
     else if (line.startsWith("+") && !line.startsWith("+++")) additions += 1;
     else if (line.startsWith("-") && !line.startsWith("---")) deletions += 1;
   }

package/src/model.ts

@@ -245,7 +245,7 @@ async function managedServerPid(runtime: ModelRuntime): Promise<number | null> {
   }
 }
 
-function pidPath(runtime: ModelRuntime): string {
+function pidPath(_runtime: ModelRuntime): string {
   return path.join(cacheDir(), "llama-server.pid");
 }
 

package/src/render.ts

@@ -30,9 +30,9 @@ ${format.success("No judgment-offload signals found.")}`;
   }
 
   return `${slopHeading()}
-${run.matches.map((match, index) => `${index + 1}. ${format.label(match.patternId)}
 ${committerLabel(run)} (${sourceLabel(command)})
 
+${run.matches.map((match, index) => `${index + 1}. ${format.label(match.patternId)}
 ${match.reason}
 
 \`\`\`
@@ -41,7 +41,7 @@ ${match.snapshot ?? match.proof}
 ${format.muted(match.proof)}
 
 ${match.checkWhy ?? "This pattern may indicate judgment-offload."}`).join("\n\n")}
-${format.muted("Search mode is warn-only.")}`;
+${format.muted(summaryLine(run))}`;
 }
 
 export function helpText(): string {
@@ -101,20 +101,31 @@ function sourceHint(command: SearchCommand): string {
 }
 
 function sourceLabel(command: SearchCommand): string {
-  if (command.kind === "staged") return "staged changes";
-  if (command.kind === "since") return `since ${command.since}`;
+  if (command.kind === "staged") return "staged";
+  if (command.kind === "since") return sinceLabel(command.since);
   if (command.kind === "commit") return `commit ${command.commit}`;
   if (command.kind === "commits") return `last ${command.count} commits`;
-  return "stdin diff";
+  return "stdin";
 }
 
 function committerLabel(run: SearchRunJson): string {
-  const committers = (run.stats.committers ?? []).filter(Boolean).map(committerDisplayName);
+  const committers = humanCommitters(run.stats.committers ?? []).map(committerDisplayName);
   if (committers.length === 0) return "unknown committer";
   if (committers.length <= 3) return committers.join(", ");
   return `${committers.slice(0, 3).join(", ")} +${committers.length - 3} more`;
 }
 
+function humanCommitters(committers: readonly string[]): readonly string[] {
+  const nonEmpty = committers.filter(Boolean);
+  const humans = nonEmpty.filter((committer) => !isBotCommitter(committer));
+  return humans.length > 0 ? humans : nonEmpty;
+}
+
+function isBotCommitter(value: string): boolean {
+  return /(?:^|<)(?:github|dependabot|renovate)(?:\s|@|>)/i.test(value) ||
+    /(?:noreply@github\.com|bot@)/i.test(value);
+}
+
 function committerDisplayName(value: string): string {
   return value.replace(/\s*<[^>]+>\s*$/, "").trim() || value;
 }
@@ -124,3 +135,20 @@ function slopHeading(): string {
   return `${format.warn(format.heading(heading))}
 ${format.warn("=".repeat(heading.length))}`;
 }
+
+function sinceLabel(since: string): string {
+  const value = since.trim().toLowerCase();
+  if (value === "yesterday" || value === "1 day ago") return "yesterday";
+  const match = /^(\d+)\s+(day|week|month|year)s?\s+ago$/.exec(value);
+  if (!match) return `since ${since}`;
+
+  const count = Number(match[1]);
+  const unit = match[2];
+  if (count === 1) return `last ${unit}`;
+  return `last ${count} ${unit}s`;
+}
+
+function summaryLine(run: SearchRunJson): string {
+  const noun = run.matches.length === 1 ? "signal" : "signals";
+  return `${run.matches.length} ${noun}. Warn-only. Nothing blocked.`;
+}

package/src/search-bench.ts

@@ -99,7 +99,7 @@ export async function runSearchBench(configPath: string): Promise<string> {
     replayRuns.push(...runs);
   }
 
-  const leaderboard = summarize(profiles.map(({ profile }) => profile), fixtures.map(({ fixture }) => fixture), allRuns);
+  const leaderboard = summarize(profiles.map(({ profile }) => profile), allRuns);
   const perCheck = summarizeByCheck(allRuns);
   const summary: BenchSummary = {
     name: config.name,
@@ -333,6 +333,7 @@ function replayErrorRun(
 async function runCli(cwd: string, args: readonly string[]): Promise<SearchRunJson> {
   const startedAt = Date.now();
   const cliPath = process.argv[1];
+  if (!cliPath) throw new Error("Could not resolve current CLI entrypoint.");
   const { stdout } = await execFileAsync(process.execPath, [cliPath, ...args], {
     cwd,
     env: process.env,
@@ -434,7 +435,6 @@ function scoreSmokeRun(run: SearchBenchRun): number {
 
 function summarize(
   profiles: readonly SearchProfile[],
-  fixtures: readonly SearchFixture[],
   runs: readonly SearchBenchRun[],
 ): readonly ProfileResult[] {
   const rows = profiles.map((profile) => {

package/src/stupify.ts

@@ -5,7 +5,7 @@ import { fileURLToPath } from "node:url";
 import { countPromptTokens, runSearch, searchRequest, type SearchRequest } from "./analysis.ts";
 import { searchChecks } from "./checks.ts";
 import { parseCommand } from "./command.ts";
-import { counterScoutTargets } from "./counter-scout.ts";
+import { counterScoutPlan } from "./counter-scout.ts";
 import { runDoctor } from "./doctor.ts";
 import { runHookCommand } from "./hooks.ts";
 import { firstRunModelBootstrap, loadLocalModel } from "./model.ts";
@@ -21,6 +21,7 @@ import {
 import { semChangeSetForCommand } from "./sem-provider.ts";
 import { createTracer } from "./trace.ts";
 import { createCliUi, type CliUi } from "./ui.ts";
+import type { CounterScoutPlan } from "./counter-scout.ts";
 import type { SearchCommand, SearchMatch, SearchProfile, SearchRunJson, SemContext, SemContextPack, StupifyCheck } from "./types.ts";
 
 export async function main(argv = process.argv.slice(2)): Promise<number> {
@@ -82,7 +83,9 @@ export async function runSearchCommand(command: SearchCommand, startedAt: number
   );
 
   try {
-    const candidates = counterScoutTargets(changeSet, checks, maxCandidates);
+    const scoutPlan = counterScoutPlan(changeSet, checks, maxCandidates);
+    if (!command.json) ui.step(scoutPlanLine(scoutPlan, changeSet.summary.total));
+    const candidates = scoutPlan.targets;
     const contexts = entityContextsFromChanges(candidates, changeSet.changes);
     const targetsByPattern = countTargetsByPattern(contexts);
     const targetsPreview = previewTargets(contexts);
@@ -128,6 +131,7 @@ export async function runSearchCommand(command: SearchCommand, startedAt: number
     const searchContexts = profile?.context === "sem"
       ? contexts
       : contexts.filter((context) => context.filePath && packedFiles.has(context.filePath));
+    if (!command.json) ui.step(targetPlanLine(searchContexts, contexts.length, countTargetsByPattern(searchContexts)));
     if (searchContexts.length === 0) {
       return {
         schemaVersion: "search.v1",
@@ -203,10 +207,12 @@ export async function runSearchCommand(command: SearchCommand, startedAt: number
     }
 
     if (batches.wasSplit && !command.json) {
-      ui.warn(`Search input is large; queued ${batches.batches.length} smaller search batches.`);
+      ui.warn(`Search input is large; queued ${batches.batches.length} smaller batches for ${searchContexts.length} targets (${maxSearchInputTokens} token cap).`);
       if (batches.skippedTargets > 0) {
         ui.warn(`Skipped ${batches.skippedTargets} oversized targets that could not fit alone.`);
       }
+    } else if (!command.json) {
+      ui.step(`Search: ${searchContexts.length} targets in ${batches.batches.length} model batch (${maxSearchInputTokens} token cap)`);
     }
 
     const modelPath = await firstRunModelBootstrap(command.model, ui);
@@ -442,6 +448,35 @@ function formatStep(name: string, ms: number, count?: number, detail?: string):
   return `${name}: ${ms}ms`;
 }
 
+function scoutPlanLine(plan: CounterScoutPlan, entitiesScanned: number): string {
+  if (plan.targets.length === 0) {
+    return `Scout: deterministic counters scanned ${entitiesScanned} entities; no target/check pairs selected`;
+  }
+
+  return [
+    `Scout: deterministic counters scanned ${entitiesScanned} entities`,
+    `${plan.totalSignals} counter signals`,
+    `selected ${plan.targets.length}/${plan.totalSignals} target/check pairs (cap ${plan.maxTargets}, not exhaustive)`,
+  ].join("; ");
+}
+
+function targetPlanLine(
+  searchContexts: readonly SemContext[],
+  selectedTargets: number,
+  targetsByPattern: Record<string, number>,
+): string {
+  const retained = searchContexts.length === selectedTargets
+    ? `${searchContexts.length} selected targets`
+    : `${searchContexts.length}/${selectedTargets} selected targets retained after context packing`;
+  return `Targets: model will inspect ${retained}; ${formatCounts(targetsByPattern)}`;
+}
+
+function formatCounts(counts: Record<string, number>): string {
+  const entries = Object.entries(counts).filter(([, count]) => count > 0);
+  if (entries.length === 0) return "no target/check pairs";
+  return entries.map(([id, count]) => `${id}=${count}`).join(", ");
+}
+
 function sourceLabel(command: SearchCommand): string {
   if (command.kind === "since") return `since ${command.since}`;
   if (command.kind === "commit") return `commit ${command.commit}`;