@nexrall/code-core 1.4.76 → 1.4.77

package/dist/project/projectCommands.js

@@ -0,0 +1,246 @@
+"use strict";
+// Project commands: `/run`, `/test`, `/build`, `/lint` and `/git` (spec §85).
+//
+// Lives in core (moved from the CLI's projectCommands.ts, 2026-10-04) so the
+// VS Code panel detects the same commands and runs them in its own terminal;
+// the CLI module is a re-export shim.
+//
+// WHY: the everyday things you do next to an agent are "run the tests", "build it",
+// "show me the diff" — and the only way to do them was `!npm test`, typed out in
+// full, or asking the model (a whole turn, tokens, and an approval prompt for
+// something YOU decided). `/test` should mean "whatever testing means in this
+// project". That is a detection problem, and detection is what this file is: what
+// `test` IS depends on the folder, so we read the folder instead of guessing.
+//
+// Kept free of chat.ts/Ink so every rule here is unit-testable (test/projectCommands.test.ts).
+// The command that comes out is run through the SAME path as `!cmd` (permission
+// rules, read-only gate, output limits, background, transcript) — this module only
+// decides WHAT to run, never runs it.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packageManager = packageManager;
+exports.detectProjectCommands = detectProjectCommands;
+exports.resolveShortcut = resolveShortcut;
+exports.gitCommand = gitCommand;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/** Lifecycle hooks: npm runs these itself, so they are noise in a "what can I run" list. */
+const NPM_HOOKS = new Set([
+    'preinstall',
+    'install',
+    'postinstall',
+    'prepare',
+    'prepublish',
+    'prepublishOnly',
+    'prepack',
+    'postpack',
+    'preversion',
+    'postversion',
+    'dependencies',
+    'prepublishOnly',
+]);
+function readText(file) {
+    try {
+        return node_fs_1.default.readFileSync(file, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function isFile(file) {
+    try {
+        return node_fs_1.default.statSync(file).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** The package manager whose scripts this project's lockfile asks for. */
+function packageManager(workDir) {
+    const has = (f) => isFile(node_path_1.default.join(workDir, f));
+    if (has('pnpm-lock.yaml') || has('pnpm-workspace.yaml'))
+        return 'pnpm';
+    if (has('yarn.lock'))
+        return 'yarn';
+    if (has('bun.lockb') || has('bun.lock'))
+        return 'bun';
+    return 'npm';
+}
+/** Reads `scripts` out of a package.json-shaped file. Never throws on bad JSON. */
+function readScripts(file, rel) {
+    const raw = readText(file);
+    if (raw === null)
+        return [];
+    let json;
+    try {
+        json = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    const scripts = json?.scripts;
+    if (!scripts || typeof scripts !== 'object')
+        return [];
+    const pm = packageManager(node_path_1.default.dirname(file));
+    return Object.keys(scripts)
+        .filter((n) => !NPM_HOOKS.has(n))
+        .map((n) => ({ name: n, command: `${pm} run ${n}`, source: rel }));
+}
+/**
+ * Make targets: column-0 `name:` rules, minus assignments (`VAR := x`, `+=`).
+ *
+ * Pattern rules (`%.o: %.c`) need no test of their own: the name is
+ * `[A-Za-z0-9][\w.-]*` and must be followed directly by `:`, so a `%` — which is not in
+ * that class — can never reach the name. A guard for it was written, proved
+ * unreachable by a mutation run, and removed rather than left looking load-bearing.
+ * Targets containing `/` are deliberately not listed: `src/foo.o: src/foo.c` would
+ * flood /run with one entry per object file.
+ */
+function makeTargets(file, rel) {
+    const raw = readText(file);
+    if (raw === null)
+        return [];
+    const out = [];
+    for (const line of raw.split('\n')) {
+        const m = /^([A-Za-z0-9][\w.-]*)\s*:(?!=)/.exec(line);
+        if (!m)
+            continue;
+        out.push({ name: m[1], command: `make ${m[1]}`, source: rel });
+    }
+    return out;
+}
+/** justfile recipes: column-0 `name arg:` / `name:`, minus assignments (`x := y`). */
+function justRecipes(file, rel) {
+    const raw = readText(file);
+    if (raw === null)
+        return [];
+    const out = [];
+    for (const line of raw.split('\n')) {
+        const m = /^([A-Za-z_][\w-]*)(\s[^:]*)?\s*:(?!=)/.exec(line);
+        if (!m)
+            continue;
+        out.push({ name: m[1], command: `just ${m[1]}`, source: rel });
+    }
+    return out;
+}
+/** `deno task` entries. deno.jsonc is skipped: its comments need a real JSONC parser. */
+function denoTasks(file, rel) {
+    const raw = readText(file);
+    if (raw === null)
+        return [];
+    let json;
+    try {
+        json = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    const tasks = json?.tasks;
+    if (!tasks || typeof tasks !== 'object')
+        return [];
+    return Object.keys(tasks).map((n) => ({ name: n, command: `deno task ${n}`, source: rel }));
+}
+/**
+ * Every command this folder can run, in a stable order (package.json first — the most
+ * common source — then the rest alphabetically). Missing files are simply absent: a
+ * project with no package.json is not an error, it is a Cargo project.
+ */
+function detectProjectCommands(workDir) {
+    const out = [];
+    const at = (f) => node_path_1.default.join(workDir, f);
+    out.push(...readScripts(at('package.json'), 'package.json'));
+    const makefile = ['Makefile', 'makefile', 'GNUmakefile'].find((f) => isFile(at(f)));
+    if (makefile)
+        out.push(...makeTargets(at(makefile), makefile));
+    const justfile = ['justfile', 'Justfile'].find((f) => isFile(at(f)));
+    if (justfile)
+        out.push(...justRecipes(at(justfile), justfile));
+    if (isFile(at('deno.json')))
+        out.push(...denoTasks(at('deno.json'), 'deno.json'));
+    const composer = readText(at('composer.json'));
+    if (composer !== null) {
+        try {
+            const json = JSON.parse(composer);
+            for (const n of Object.keys(json?.scripts ?? {})) {
+                out.push({ name: n, command: `composer run ${n}`, source: 'composer.json' });
+            }
+        }
+        catch {
+            /* a broken composer.json is not this command's problem */
+        }
+    }
+    // Go and Rust have one obvious command per task; no file to read beyond the manifest.
+    if (isFile(at('go.mod'))) {
+        out.push({ name: 'build', command: 'go build ./...', source: 'go.mod' }, { name: 'test', command: 'go test ./...', source: 'go.mod' }, { name: 'vet', command: 'go vet ./...', source: 'go.mod' }, { name: 'fmt', command: 'gofmt -l .', source: 'go.mod' });
+    }
+    if (isFile(at('Cargo.toml'))) {
+        out.push({ name: 'build', command: 'cargo build', source: 'Cargo.toml' }, { name: 'test', command: 'cargo test', source: 'Cargo.toml' }, { name: 'check', command: 'cargo check', source: 'Cargo.toml' }, { name: 'clippy', command: 'cargo clippy', source: 'Cargo.toml' }, { name: 'fmt', command: 'cargo fmt --check', source: 'Cargo.toml' });
+    }
+    // Python: only when the folder actually says how it is tested/linted. `pytest -q` in a
+    // project with no pytest is a wasted round trip, so evidence is required.
+    const pyproject = readText(at('pyproject.toml')) ?? '';
+    const hasPytest = isFile(at('pytest.ini')) ||
+        isFile(at('tox.ini')) ||
+        pyproject.includes('[tool.pytest') ||
+        node_fs_1.default.existsSync(at('tests'));
+    if (hasPytest)
+        out.push({ name: 'test', command: 'pytest -q', source: pyproject ? 'pyproject.toml' : 'pytest' });
+    if (pyproject.includes('[tool.ruff') || isFile(at('ruff.toml'))) {
+        out.push({ name: 'lint', command: 'ruff check .', source: 'ruff.toml' });
+    }
+    if (pyproject.includes('[tool.mypy')) {
+        out.push({ name: 'typecheck', command: 'mypy .', source: 'pyproject.toml' });
+    }
+    // An identical row twice (a Makefile that defines the same target twice, two
+    // manifests offering the same command) is always noise; the first source wins.
+    const seen = new Set();
+    return out.filter((c) => (seen.has(c.command) ? false : (seen.add(c.command), true)));
+}
+/**
+ * How well a command name answers a shortcut, lower is better, -1 means "not this one".
+ * `test:unit` and `test-unit` both answer `/test`; `e2e:test` only just.
+ *
+ * Word-based, never substring: an endsWith rule was tried and dropped, because
+ * "latest".endsWith("test") is TRUE — so `/test` in a project whose only script was
+ * `latest` would have run it and called it the test suite. `eslint` losing to that
+ * rule is the price, and `/run eslint` still works: running the wrong thing quietly
+ * is far worse than not finding a name.
+ */
+function tier(name, want) {
+    const n = name.toLowerCase();
+    const w = want.toLowerCase();
+    if (n === w)
+        return 0;
+    const parts = n.split(/[:._-]+/);
+    if (parts[0] === w)
+        return 1;
+    if (parts.includes(w))
+        return 2;
+    return -1;
+}
+/**
+ * The commands a shortcut should run: everything in the best tier it finds, best
+ * first. More than one means the caller asks which (a repo with `test` and
+ * `test:integration` should not silently pick one — running the wrong suite and
+ * calling it "the tests" is worse than one extra keystroke).
+ */
+function resolveShortcut(cmds, want) {
+    const scored = cmds.map((c) => ({ c, t: tier(c.name, want) })).filter((x) => x.t >= 0);
+    if (!scored.length)
+        return [];
+    const best = Math.min(...scored.map((x) => x.t));
+    return scored.filter((x) => x.t === best).map((x) => x.c);
+}
+/**
+ * Runs `git` with the user's arguments: `/git` alone means `git status`, `/git log -5`
+ * means exactly that. Not a list of allowed subcommands — the read-only gate in front
+ * of this (core's isReadOnlyBash) is what decides whether it may run unprompted, so
+ * `/git commit` works in a normal session and is refused under `--readonly`.
+ */
+function gitCommand(arg) {
+    const a = arg.trim();
+    return a ? `git ${a}` : 'git status';
+}
+//# sourceMappingURL=projectCommands.js.map

package/dist/search/conversationTurns.d.ts

@@ -0,0 +1,53 @@
+import { type Message } from '../types';
+/** `!cmd` transcripts are synthesised user messages; this is their prefix (moved
+ *  here from commands/bangShell.ts so the synthetic-user list has one home). */
+export declare const BANG_TRANSCRIPT_PREFIX = "I ran this command myself in the terminal:";
+/** Lines of a turn's body shown by a jump before the rest is summarised. */
+export declare const MAX_TURN_LINES = 80;
+/** Tool-result lines kept inline; the rest is a count. */
+export declare const RESULT_PREVIEW_LINES = 3;
+/** Newest turns kept — a 400-turn session does not need all of it in memory. */
+export declare const MAX_TURNS = 200;
+/** Prompt length in a turn header / search label. */
+export declare const PROMPT_CLIP = 100;
+export interface Turn {
+    /** 1-based, in conversation order. */
+    index: number;
+    /** The user's prompt, flattened to one line. */
+    prompt: string;
+    /** Body lines, ready to print (no colour). */
+    lines: string[];
+    toolCalls: number;
+    /** Lines dropped by MAX_TURN_LINES (0 when everything fit). */
+    dropped: number;
+}
+export declare function flatten(s: string): string;
+export declare function clip(s: string, max: number): string;
+/** One display line per content block, or null for blocks that are not conversation. */
+export declare function blockLines(m: Message, b: Message['content'][number]): string[] | null;
+/** Did this user message start a turn, or is it agent bookkeeping? */
+export declare function startsTurn(m: Message): boolean;
+export declare function isSyntheticUserText(text: string): boolean;
+/**
+ * Group the conversation into turns. Content before the first real prompt (the
+ * opening context block) is not a turn and is skipped.
+ */
+export declare function turnsFrom(messages: Message[], opts?: {
+    maxLines?: number;
+    maxTurns?: number;
+}): Turn[];
+/**
+ * The most recent real prompt in the conversation — the label a `/cost` turn row carries.
+ *
+ * Scans BACKWARDS so a mid-turn follow-up (folded in by the loop while the agent works) is
+ * what the row reads: that is the last thing the user actually asked for. '' when nothing
+ * has been typed yet.
+ */
+export declare function lastPrompt(messages: Message[], max?: number): string;
+/**
+ * The last prompt the USER actually typed — skips the synthetic user messages (a `!cmd`
+ * transcript, a task notification, a peer message), which are turns but were not typed.
+ * The §81 handoff goal is built from this; `lastPrompt` deliberately does not skip them.
+ */
+export declare function lastTypedPrompt(messages: Message[], max?: number): string;
+//# sourceMappingURL=conversationTurns.d.ts.map

package/dist/search/conversationTurns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationTurns.d.ts","sourceRoot":"","sources":["../../src/search/conversationTurns.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAG/D;gFACgF;AAChF,eAAO,MAAM,sBAAsB,+CAA+C,CAAC;AAEnF,4EAA4E;AAC5E,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,gFAAgF;AAChF,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,qDAAqD;AACrD,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,MAAM,WAAW,IAAI;IACnB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAwBrF;AAUD,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAG9C;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,EAAE,CA4C1G;AAUD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,SAAc,GAAG,MAAM,CAQzE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,SAAc,GAAG,MAAM,CAQ9E"}

package/dist/search/conversationTurns.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMPT_CLIP = exports.MAX_TURNS = exports.RESULT_PREVIEW_LINES = exports.MAX_TURN_LINES = exports.BANG_TRANSCRIPT_PREFIX = void 0;
+exports.flatten = flatten;
+exports.clip = clip;
+exports.blockLines = blockLines;
+exports.startsTurn = startsTurn;
+exports.isSyntheticUserText = isSyntheticUserText;
+exports.turnsFrom = turnsFrom;
+exports.lastPrompt = lastPrompt;
+exports.lastTypedPrompt = lastTypedPrompt;
+// Conversation → turns, the pure half (moved from the CLI's ui/transcriptView.ts,
+// 2026-10-04) so /find searches the SAME turn shape in the VS Code panel; the
+// CLI module re-exports everything.
+const types_1 = require("../types");
+const toolLabel_1 = require("../util/toolLabel");
+/** `!cmd` transcripts are synthesised user messages; this is their prefix (moved
+ *  here from commands/bangShell.ts so the synthetic-user list has one home). */
+exports.BANG_TRANSCRIPT_PREFIX = 'I ran this command myself in the terminal:';
+/** Lines of a turn's body shown by a jump before the rest is summarised. */
+exports.MAX_TURN_LINES = 80;
+/** Tool-result lines kept inline; the rest is a count. */
+exports.RESULT_PREVIEW_LINES = 3;
+/** Newest turns kept — a 400-turn session does not need all of it in memory. */
+exports.MAX_TURNS = 200;
+/** Prompt length in a turn header / search label. */
+exports.PROMPT_CLIP = 100;
+function flatten(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+function clip(s, max) {
+    return s.length <= max ? s : s.slice(0, max - 1) + '\u2026';
+}
+/** One display line per content block, or null for blocks that are not conversation. */
+function blockLines(m, b) {
+    switch (b.type) {
+        case 'text': {
+            const text = b.text.trimEnd();
+            if (!text.trim())
+                return null;
+            if (m.role === 'user')
+                return text.split('\n').map((l) => '  ' + l);
+            return text.split('\n');
+        }
+        case 'tool_use':
+            return ['  \u26a1 ' + (0, toolLabel_1.toolLabel)(b.name, b.input)];
+        case 'tool_result': {
+            const body = b.content.replace(/\r/g, '').trimEnd().split('\n');
+            const kept = body.slice(0, exports.RESULT_PREVIEW_LINES).map((l) => '  \u2502 ' + clip(l, 200));
+            if (body.length > exports.RESULT_PREVIEW_LINES)
+                kept.push(`  \u2514 \u2026 +${body.length - exports.RESULT_PREVIEW_LINES} line(s)`);
+            return kept;
+        }
+        case 'image':
+            return ['  [image]'];
+        case 'document':
+            return ['  [document]'];
+        default:
+            return null;
+    }
+}
+/** User turns the CLI synthesised — outputs and notices folded in dressed as
+ *  user messages. None of these is "what the user asked for". */
+const SYNTHETIC_USER_PREFIXES = [
+    '<task-notification>', // core's formatBackgroundNotifications
+    exports.BANG_TRANSCRIPT_PREFIX, // a `!cmd` transcript
+    '[Message from peer session ', // core's renderPeerMessages
+];
+/** Did this user message start a turn, or is it agent bookkeeping? */
+function startsTurn(m) {
+    if (m.role !== 'user')
+        return false;
+    return m.content.some((b) => b.type === 'text' && !(0, types_1.isRuntimeContextBlock)(b));
+}
+function isSyntheticUserText(text) {
+    return SYNTHETIC_USER_PREFIXES.some((p) => text.startsWith(p));
+}
+/**
+ * Group the conversation into turns. Content before the first real prompt (the
+ * opening context block) is not a turn and is skipped.
+ */
+function turnsFrom(messages, opts = {}) {
+    const maxLines = opts.maxLines ?? exports.MAX_TURN_LINES;
+    const turns = [];
+    let current = null;
+    let hasPrompt = false;
+    // The block a turn's prompt came from: it is printed as `> prompt` by the header,
+    // so repeating it as the first body line would show every question twice.
+    let promptBlock = null;
+    for (const m of messages) {
+        if (startsTurn(m)) {
+            if (current)
+                turns.push(finish(current, maxLines));
+            const firstText = m.content.find((b) => b.type === 'text' && !(0, types_1.isRuntimeContextBlock)(b));
+            current = {
+                index: turns.length + 1,
+                prompt: clip(flatten(firstText?.text ?? ''), exports.PROMPT_CLIP),
+                lines: [],
+                toolCalls: 0,
+                dropped: 0,
+            };
+            promptBlock = firstText ?? null;
+            hasPrompt = true;
+        }
+        if (!hasPrompt || !current)
+            continue;
+        for (const b of m.content) {
+            if (b === promptBlock) {
+                promptBlock = null;
+                continue;
+            }
+            if (b.type === 'text' && (0, types_1.isRuntimeContextBlock)(b))
+                continue; // runtime context: not conversation
+            if (b.type === 'tool_use')
+                current.toolCalls++;
+            const lines = blockLines(m, b);
+            if (lines)
+                current.lines.push(...lines);
+        }
+    }
+    if (current)
+        turns.push(finish(current, maxLines));
+    const kept = turns.length > (opts.maxTurns ?? exports.MAX_TURNS) ? turns.slice(-(opts.maxTurns ?? exports.MAX_TURNS)) : turns;
+    kept.forEach((t, i) => {
+        t.index = i + 1;
+    });
+    return kept;
+}
+function finish(t, maxLines) {
+    if (t.lines.length > maxLines) {
+        t.dropped = t.lines.length - maxLines;
+        t.lines = [...t.lines.slice(0, maxLines), `  \u2514 \u2026 ${t.dropped} more line(s) in this turn`];
+    }
+    return t;
+}
+/**
+ * The most recent real prompt in the conversation — the label a `/cost` turn row carries.
+ *
+ * Scans BACKWARDS so a mid-turn follow-up (folded in by the loop while the agent works) is
+ * what the row reads: that is the last thing the user actually asked for. '' when nothing
+ * has been typed yet.
+ */
+function lastPrompt(messages, max = exports.PROMPT_CLIP) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m.role !== 'user')
+            continue;
+        const b = m.content.find((x) => x.type === 'text' && !(0, types_1.isRuntimeContextBlock)(x));
+        if (b && b.type === 'text')
+            return clip(flatten(b.text), max);
+    }
+    return '';
+}
+/**
+ * The last prompt the USER actually typed — skips the synthetic user messages (a `!cmd`
+ * transcript, a task notification, a peer message), which are turns but were not typed.
+ * The §81 handoff goal is built from this; `lastPrompt` deliberately does not skip them.
+ */
+function lastTypedPrompt(messages, max = exports.PROMPT_CLIP) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m.role !== 'user')
+            continue;
+        const b = m.content.find((x) => x.type === 'text' && !(0, types_1.isRuntimeContextBlock)(x));
+        if (b && b.type === 'text' && !isSyntheticUserText(b.text))
+            return clip(flatten(b.text), max);
+    }
+    return '';
+}
+//# sourceMappingURL=conversationTurns.js.map

package/dist/search/globalSearch.d.ts

@@ -0,0 +1,144 @@
+import type { Turn } from './conversationTurns';
+import type { Incident } from '../verify/failureTimeline';
+/**
+ * Structurally minimal shapes for the two CLI-UI stores (kept local so core
+ * needs no import from the CLI; richer objects pass structurally). The CLI's
+ * ToolOutputEntry / AgentNode satisfy these unchanged.
+ */
+export interface ToolOutputEntry {
+    /** Monotonic id, 1-based — what `/expand <n>` refers to. */
+    id: number;
+    name: string;
+    /** One-line description of the call (the command, the path …). */
+    label: string;
+    output: string;
+    isError: boolean;
+    durationMs: number;
+}
+export interface AgentNode {
+    name: string;
+    label: string;
+    files: string[];
+    error?: string;
+    report?: string;
+}
+export type Scope = 'files' | 'conversation' | 'tools' | 'git' | 'errors' | 'agents';
+/** Display order — §52 lists files first because that is where a code query usually lives. */
+export declare const SCOPES: readonly Scope[];
+export declare const SCOPE_LABEL: Record<Scope, string>;
+/** Hits printed per scope. The counts line stays complete — only the list is capped. */
+export declare const MAX_PER_SCOPE = 5;
+/** A matched line kept for context, so a hit is recognisable without opening anything. */
+export declare const DETAIL_CLIP = 96;
+export declare const LABEL_CLIP = 72;
+export interface Hit {
+    scope: Scope;
+    /** Stable identity inside the scope, for the "N of M" note and for ordering. */
+    key: string;
+    /** What the row shows first: a path, a command, an agent. */
+    label: string;
+    /** The matching line, when the label itself is not the match. */
+    detail?: string;
+    /** 0 = best. */
+    score: number;
+    /** 1-based position in the scope's own listing, so the row can be found again. */
+    index: number;
+}
+export interface Sources {
+    files?: string[];
+    turns?: Turn[];
+    tools?: ToolOutputEntry[];
+    git?: Array<{
+        path: string;
+        status?: string;
+    }>;
+    errors?: Incident[];
+    agents?: AgentNode[];
+}
+export interface Count {
+    scope: Scope;
+    count: number;
+}
+export interface Result {
+    query: string;
+    hits: Hit[];
+    counts: Count[];
+}
+/**
+ * Shorten an ASSEMBLED line to `cols`, keeping its leading indent.
+ *
+ * `clip` flattens whitespace, which is right for a path or a matched line but destroys a row
+ * whose alignment is the point: `clip('  Files  12')` returns `Files  12`, and every column in
+ * the counts block collapses. Measured on the first run of the tests in this module.
+ */
+export declare function fitLine(body: string, cols: number, indent?: string): string;
+/**
+ * Rank one text against the query. `Infinity` = no match.
+ *
+ * Substring only, case-insensitive — this is a search box for code, where a fuzzy match is
+ * noise. The ladder, weakest last:
+ *
+ *   0  the text IS the query                     `auth`      vs `auth`
+ *   1  the text begins with the query             `auth.ts`   vs `auth`
+ *   2  the query begins a word                    `src/auth.ts`, `jwt-refresh.ts`
+ *   3  the query starts mid-word                  `myjwthelper.ts`, `contest/a.ts`
+ *
+ * Rung 1 exists on its own because a tie between `auth.ts` and `x/auth-mid.ts` used to be
+ * settled by whatever order the scope listed them in, which put the worse match first.
+ */
+export declare function scoreText(query: string, text: string): number;
+/** Files: the path itself. */
+export declare function searchFiles(query: string, files: string[]): Hit[];
+/** Conversation: prompts and reply lines, via the transcript the turn navigation already builds. */
+export declare function searchConversation(query: string, turns: Turn[]): Hit[];
+/** Tools: the call label and the output the transcript folded away. */
+export declare function searchTools(query: string, entries: ToolOutputEntry[]): Hit[];
+/** Git: changed paths, with the status letter kept in front so `M`/`??` is visible. */
+export declare function searchGit(query: string, changes: Array<{
+    path: string;
+    status?: string;
+}>): Hit[];
+/** Errors: the failing command, the files it touched, and the re-tests. */
+export declare function searchErrors(query: string, incidents: Incident[]): Hit[];
+/** Agents: type, task label and the files each one touched. */
+export declare function searchAgents(query: string, nodes: AgentNode[]): Hit[];
+export declare function globalSearch(query: string, sources: Sources, perScope?: number): Result;
+export declare function filterScope(hits: Hit[], scope: Scope | null): Hit[];
+/**
+ * The §52 counts block:
+ *
+ *     > JWT
+ *
+ *     Files        12
+ *     Conversation  8
+ *     Git           3
+ *     Agents        2
+ *
+ * Labels pad to the widest, counts right-align to the widest — so the numbers line up even
+ * when "Conversation" sits next to "Files". Every line is clipped to `cols`; at narrow widths
+ * the label is what gets cut, never the count.
+ */
+export declare function formatCounts(result: Result, cols: number, opts?: {
+    table?: boolean;
+}): string[];
+/**
+ * One printed row per hit: `  3. Git  M src/app.js`, with the matched line under it when the
+ * label alone would not say why it matched.
+ *
+ * `tag` prepends the 3-letter scope — on when the rows are mixed, off inside a per-scope
+ * section where the heading already said it.
+ */
+export declare function formatHits(hits: Hit[], cols: number, indent?: string, tag?: boolean): string[];
+/** `Scopes: /find <q> --files --git` — only the flags that would actually narrow this result. */
+export declare function scopeHint(counts: Count[]): string;
+export interface SearchArgs {
+    query: string;
+    /** null = search everything. */
+    scopes: Scope[] | null;
+    /** Flags that are not scopes — reported instead of silently becoming part of the query. */
+    bad: string[];
+}
+/** `/find JWT --git --tools` → query "JWT", scopes [git, tools]. `--all` clears the narrowing. */
+export declare function parseSearchArgs(arg: string): SearchArgs;
+export declare function searchUsage(): string;
+//# sourceMappingURL=globalSearch.d.ts.map

package/dist/search/globalSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalSearch.d.ts","sourceRoot":"","sources":["../../src/search/globalSearch.ts"],"names":[],"mappings":"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"}