@wingsbutterfly/dsh-rtk 0.1.0

package/lib/compact/detect.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Command classification helpers.
+ *
+ * Every technique asks the same question first — "is this the kind of command
+ * whose output I know how to summarize?" — so the normalization lives here
+ * rather than being repeated (and drifting) per technique.
+ */
+/**
+ * Reduce a command line to its first simple command, lower-cased.
+ *
+ * `FOO=1 git status | head` normalizes to `git status`: the assignment run is
+ * not the command, and the pipeline is not part of what the first command is.
+ * A pattern that matches the whole line would classify every prefixed or
+ * piped invocation as unknown and skip compaction entirely.
+ *
+ * @param command - raw command line, possibly multi-line.
+ * @returns the normalized first command, or `null` when there is none.
+ */
+export declare function normalizeCommandForDetection(command: string | undefined | null): string | null;
+/** Whether the command's first simple command matches any pattern. */
+export declare function matchesCommandPatterns(command: string | undefined | null, patterns: readonly RegExp[]): boolean;
+//# sourceMappingURL=detect.d.ts.map

package/lib/compact/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/compact/detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAc9F;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI/G"}

package/lib/compact/detect.js

@@ -0,0 +1,54 @@
+/**
+ * Command classification helpers.
+ *
+ * Every technique asks the same question first — "is this the kind of command
+ * whose output I know how to summarize?" — so the normalization lives here
+ * rather than being repeated (and drifting) per technique.
+ */
+const ENV_PREFIX_PATTERN = /^(?:[A-Za-z_][A-Za-z0-9_]*=(?:"[^"]*"|'[^']*'|[^\s]+)\s+)*/;
+const CHAIN_OPERATORS = ['&&', '||', ';', '|'];
+function sliceFirstSegment(command) {
+    let cutIndex = -1;
+    for (const operator of CHAIN_OPERATORS) {
+        const index = command.indexOf(operator);
+        if (index === -1)
+            continue;
+        if (cutIndex === -1 || index < cutIndex)
+            cutIndex = index;
+    }
+    return cutIndex === -1 ? command : command.slice(0, cutIndex);
+}
+/**
+ * Reduce a command line to its first simple command, lower-cased.
+ *
+ * `FOO=1 git status | head` normalizes to `git status`: the assignment run is
+ * not the command, and the pipeline is not part of what the first command is.
+ * A pattern that matches the whole line would classify every prefixed or
+ * piped invocation as unknown and skip compaction entirely.
+ *
+ * @param command - raw command line, possibly multi-line.
+ * @returns the normalized first command, or `null` when there is none.
+ */
+export function normalizeCommandForDetection(command) {
+    if (typeof command !== 'string')
+        return null;
+    const firstNonEmptyLine = command
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    if (!firstNonEmptyLine)
+        return null;
+    const withoutEnvPrefix = firstNonEmptyLine.replace(ENV_PREFIX_PATTERN, '').trim();
+    if (!withoutEnvPrefix)
+        return null;
+    const firstSegment = sliceFirstSegment(withoutEnvPrefix).trim().toLowerCase();
+    return firstSegment || null;
+}
+/** Whether the command's first simple command matches any pattern. */
+export function matchesCommandPatterns(command, patterns) {
+    const normalized = normalizeCommandForDetection(command);
+    if (!normalized)
+        return false;
+    return patterns.some((pattern) => pattern.test(normalized));
+}
+//# sourceMappingURL=detect.js.map

package/lib/compact/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/compact/detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,kBAAkB,GAAG,4DAA4D,CAAA;AACvF,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAU,CAAA;AAEvD,SAAS,iBAAiB,CAAC,OAAe;IACxC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAA;IACjB,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAQ;QAC1B,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,KAAK,GAAG,QAAQ;YAAE,QAAQ,GAAG,KAAK,CAAA;IAC3D,CAAC;IACD,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;AAC/D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAkC;IAC7E,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAE5C,MAAM,iBAAiB,GAAG,OAAO;SAC9B,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAClC,IAAI,CAAC,iBAAiB;QAAE,OAAO,IAAI,CAAA;IAEnC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACjF,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAA;IAElC,MAAM,YAAY,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC7E,OAAO,YAAY,IAAI,IAAI,CAAA;AAC7B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CAAC,OAAkC,EAAE,QAA2B;IACpG,MAAM,UAAU,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAA;IACxD,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA;IAC7B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;AAC7D,CAAC"}

package/lib/compact/dsh-result.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Split and reassemble the harness `bash` result envelope.
+ *
+ * The bash tool renders a result as the stdout tail, an optional `[stderr]`
+ * section, and a run of trailing status markers (`[exit code: N]`,
+ * `[timed out after …]`, `[sandbox: …]`, …). Those markers are load-bearing:
+ * the model is told to check `[exit code: N]` on every call, and the Web UI
+ * parses that same line to draw its exit-status pill.
+ *
+ * Compaction rewrites the output body, so anything that rebuilds the text
+ * wholesale — the git, build, and test summarizers all do — would drop the
+ * markers with it. This module is the boundary that keeps that from happening:
+ * markers are lifted out before compaction and put back after, in their
+ * original order.
+ */
+/** The bash tool's placeholder for a command that printed nothing at all. */
+export declare const NO_OUTPUT_PLACEHOLDER = "(no output)";
+/** A bash result decomposed into the parts compaction must treat differently. */
+export interface BashResultParts {
+    /** True when the tool rendered its "printed nothing" placeholder. */
+    empty: boolean;
+    /** stdout body, without the `[stderr]` section or trailing markers. */
+    stdout: string;
+    /** stderr body when the result carried a `[stderr]` section. */
+    stderr?: string;
+    /** Trailing status markers, in their original order. */
+    markers: string[];
+}
+/**
+ * Decompose a rendered bash result.
+ *
+ * Trailing markers are peeled from the end first, then the `[stderr]` section
+ * is split off. Only the first `[stderr]` header counts: if the command's own
+ * output contains that literal line, everything after it belongs to stderr,
+ * which is what the renderer produced.
+ *
+ * @param text - the rendered bash result.
+ * @returns the decomposed parts.
+ */
+export declare function parseBashResult(text: string): BashResultParts;
+/**
+ * Reassemble a bash result from its parts.
+ *
+ * The inverse of {@link parseBashResult}, so the model-visible contract — the
+ * marker lines the agent loop and the UI both depend on — survives a
+ * compaction pass untouched.
+ */
+export declare function renderBashResult(parts: BashResultParts): string;
+//# sourceMappingURL=dsh-result.d.ts.map

package/lib/compact/dsh-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-result.d.ts","sourceRoot":"","sources":["../../src/compact/dsh-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAMlD,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAA;IACd,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAsB7D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAU/D"}

package/lib/compact/dsh-result.js

@@ -0,0 +1,84 @@
+/**
+ * Split and reassemble the harness `bash` result envelope.
+ *
+ * The bash tool renders a result as the stdout tail, an optional `[stderr]`
+ * section, and a run of trailing status markers (`[exit code: N]`,
+ * `[timed out after …]`, `[sandbox: …]`, …). Those markers are load-bearing:
+ * the model is told to check `[exit code: N]` on every call, and the Web UI
+ * parses that same line to draw its exit-status pill.
+ *
+ * Compaction rewrites the output body, so anything that rebuilds the text
+ * wholesale — the git, build, and test summarizers all do — would drop the
+ * markers with it. This module is the boundary that keeps that from happening:
+ * markers are lifted out before compaction and put back after, in their
+ * original order.
+ */
+/** Markers the bash tool appends after the output body. */
+const TRAILING_MARKER_PATTERNS = [
+    /^\[exit code: -?\d+\]$/,
+    /^\[killed by signal: .+\]$/,
+    /^\[timed out after \d+ms\]$/,
+    /^\[output truncated; full output: .+\]$/,
+    /^\[some output was dropped from memory; full output: .+\]$/,
+    /^\[sandbox: .+\]$/,
+];
+const STDERR_HEADER = '[stderr]';
+/** The bash tool's placeholder for a command that printed nothing at all. */
+export const NO_OUTPUT_PLACEHOLDER = '(no output)';
+function isTrailingMarker(line) {
+    return TRAILING_MARKER_PATTERNS.some((pattern) => pattern.test(line));
+}
+/**
+ * Decompose a rendered bash result.
+ *
+ * Trailing markers are peeled from the end first, then the `[stderr]` section
+ * is split off. Only the first `[stderr]` header counts: if the command's own
+ * output contains that literal line, everything after it belongs to stderr,
+ * which is what the renderer produced.
+ *
+ * @param text - the rendered bash result.
+ * @returns the decomposed parts.
+ */
+export function parseBashResult(text) {
+    if (text === NO_OUTPUT_PLACEHOLDER) {
+        return { empty: true, stdout: '', markers: [] };
+    }
+    const lines = text.split('\n');
+    const markers = [];
+    while (lines.length > 0) {
+        const last = lines[lines.length - 1];
+        if (last === undefined || !isTrailingMarker(last))
+            break;
+        markers.unshift(last);
+        lines.pop();
+    }
+    const headerIndex = lines.indexOf(STDERR_HEADER);
+    if (headerIndex === -1) {
+        return { empty: false, stdout: lines.join('\n'), markers };
+    }
+    const stdout = lines.slice(0, headerIndex).join('\n');
+    const stderr = lines.slice(headerIndex + 1).join('\n');
+    return { empty: false, stdout, stderr, markers };
+}
+/**
+ * Reassemble a bash result from its parts.
+ *
+ * The inverse of {@link parseBashResult}, so the model-visible contract — the
+ * marker lines the agent loop and the UI both depend on — survives a
+ * compaction pass untouched.
+ */
+export function renderBashResult(parts) {
+    const sections = [];
+    if (parts.empty) {
+        sections.push(NO_OUTPUT_PLACEHOLDER);
+    }
+    else {
+        if (parts.stdout.length > 0)
+            sections.push(parts.stdout);
+        if (parts.stderr !== undefined)
+            sections.push(STDERR_HEADER, parts.stderr);
+    }
+    sections.push(...parts.markers);
+    return sections.join('\n');
+}
+//# sourceMappingURL=dsh-result.js.map

package/lib/compact/dsh-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-result.js","sourceRoot":"","sources":["../../src/compact/dsh-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,2DAA2D;AAC3D,MAAM,wBAAwB,GAAG;IAC/B,wBAAwB;IACxB,4BAA4B;IAC5B,6BAA6B;IAC7B,yCAAyC;IACzC,4DAA4D;IAC5D,mBAAmB;CACX,CAAA;AAEV,MAAM,aAAa,GAAG,UAAU,CAAA;AAChC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAA;AAElD,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACvE,CAAC;AAcD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IACjD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACpC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,MAAK;QACxD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACrB,KAAK,CAAC,GAAG,EAAE,CAAA;IACb,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IAChD,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IACtC,CAAC;SAAM,CAAC;QACN,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACxD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC5E,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;IAC/B,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC"}

package/lib/compact/git.d.ts

@@ -0,0 +1,21 @@
+/** Whether the command is one of the git commands this module understands. */
+export declare function isGitCommand(command: string | undefined | null): boolean;
+/**
+ * Condense a unified diff to file headers, hunk headers, and a bounded sample
+ * of changed lines, with an added/removed count per file.
+ */
+export declare function compactDiff(output: string, maxLines?: number): string;
+/** Condense `git status` porcelain output into per-bucket counts and samples. */
+export declare function compactStatus(output: string): string;
+/** Keep the first `limit` log lines, capping each line's width. */
+export declare function compactLog(output: string, limit?: number): string;
+/**
+ * Compact a git command's output, or `null` when nothing applies.
+ *
+ * Each branch first checks that the output actually looks like raw git output.
+ * A command like `git diff --stat` inside a wrapper, or a script whose name
+ * merely starts with `git`, would otherwise be rewritten into a summary of
+ * text this module never parsed correctly.
+ */
+export declare function compactGitOutput(output: string, command: string | undefined | null): string | null;
+//# sourceMappingURL=git.d.ts.map

package/lib/compact/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/compact/git.ts"],"names":[],"mappings":"AAkCA,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAExE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CA+DjE;AAYD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwDpD;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAQ7D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAYlG"}

package/lib/compact/git.js

@@ -0,0 +1,197 @@
+import { matchesCommandPatterns, normalizeCommandForDetection } from './detect.js';
+const GIT_COMMAND_PATTERNS = [/^git\s+(diff|status|log|show|stash)\b/];
+const RAW_GIT_DIFF_PATTERN = /^diff --git /m;
+const RAW_GIT_STATUS_PATTERN = /^(?:## |(?:M|A|D|R|C|U|\?| )\S)/m;
+/**
+ * One line of `git status --porcelain` output.
+ *
+ * Covers the v1 branch header (`## main...origin/main`), the v2 headers
+ * (`# branch.head main`), the `??` untracked form, and the two-column status
+ * form. The human report contains none of these shapes.
+ */
+const PORCELAIN_STATUS_LINE = /^(?:##?\s|\?\? .+|[ MADRCU?!]{2} .+)/;
+/** Share of non-blank lines that must parse as porcelain before summarizing. */
+const PORCELAIN_LINE_MIN_RATIO = 0.8;
+/**
+ * Whether a body is `git status --porcelain` rather than the human report.
+ *
+ * The two are indistinguishable line by line — ` M path` is valid porcelain
+ * and also occurs inside the human report — but only porcelain may be sliced
+ * with fixed column offsets. Running the summarizer over the human text
+ * silently invents and drops entries, so the body must be *consistently*
+ * porcelain before any of it is interpreted.
+ */
+function isPorcelainStatus(output) {
+    const lines = output.split('\n').filter((line) => line.trim().length > 0);
+    if (lines.length === 0)
+        return false;
+    const matches = lines.filter((line) => PORCELAIN_STATUS_LINE.test(line)).length;
+    return matches / lines.length >= PORCELAIN_LINE_MIN_RATIO;
+}
+/** Whether the command is one of the git commands this module understands. */
+export function isGitCommand(command) {
+    return matchesCommandPatterns(command, GIT_COMMAND_PATTERNS);
+}
+/**
+ * Condense a unified diff to file headers, hunk headers, and a bounded sample
+ * of changed lines, with an added/removed count per file.
+ */
+export function compactDiff(output, maxLines = 50) {
+    const lines = output.split('\n');
+    const result = [];
+    let currentFile = '';
+    let added = 0;
+    let removed = 0;
+    let inHunk = false;
+    let hunkLines = 0;
+    const maxHunkLines = 10;
+    for (const line of lines) {
+        if (result.length >= maxLines) {
+            result.push('\n... (more changes truncated)');
+            break;
+        }
+        if (line.startsWith('diff --git')) {
+            if (currentFile && (added > 0 || removed > 0))
+                result.push(`  +${added} -${removed}`);
+            const match = line.match(/diff --git a\/(.+) b\/(.+)/);
+            currentFile = match?.[2] ?? 'unknown';
+            result.push(`\n> ${currentFile}`);
+            added = 0;
+            removed = 0;
+            inHunk = false;
+            continue;
+        }
+        if (line.startsWith('@@')) {
+            inHunk = true;
+            hunkLines = 0;
+            result.push(`  ${line.match(/@@ .+ @@/)?.[0] ?? '@@'}`);
+            continue;
+        }
+        if (!inHunk)
+            continue;
+        if (line.startsWith('+') && !line.startsWith('+++')) {
+            added++;
+            if (hunkLines < maxHunkLines) {
+                result.push(`  ${line}`);
+                hunkLines++;
+            }
+        }
+        else if (line.startsWith('-') && !line.startsWith('---')) {
+            removed++;
+            if (hunkLines < maxHunkLines) {
+                result.push(`  ${line}`);
+                hunkLines++;
+            }
+        }
+        else if (hunkLines < maxHunkLines && !line.startsWith('\\')) {
+            if (hunkLines > 0) {
+                result.push(`  ${line}`);
+                hunkLines++;
+            }
+        }
+        if (hunkLines === maxHunkLines) {
+            result.push('  ... (truncated)');
+            hunkLines++;
+        }
+    }
+    if (currentFile && (added > 0 || removed > 0))
+        result.push(`  +${added} -${removed}`);
+    return result.join('\n');
+}
+/** Condense `git status` porcelain output into per-bucket counts and samples. */
+export function compactStatus(output) {
+    const lines = output.split('\n');
+    if (lines.length === 0 || (lines.length === 1 && lines[0]?.trim() === ''))
+        return 'Clean working tree';
+    const stats = {
+        staged: 0,
+        modified: 0,
+        untracked: 0,
+        conflicts: 0,
+        stagedFiles: [],
+        modifiedFiles: [],
+        untrackedFiles: [],
+    };
+    let branchName = '';
+    for (const line of lines) {
+        if (line.startsWith('##')) {
+            const match = line.match(/## (.+)/);
+            if (match?.[1])
+                branchName = match[1].split('...')[0] ?? match[1];
+            continue;
+        }
+        if (line.length < 3)
+            continue;
+        const status = line.slice(0, 2);
+        const filename = line.slice(3);
+        const indexStatus = status[0];
+        const worktreeStatus = status[1];
+        if (indexStatus !== undefined && ['M', 'A', 'D', 'R', 'C'].includes(indexStatus)) {
+            stats.staged++;
+            stats.stagedFiles.push(filename);
+        }
+        if (indexStatus === 'U')
+            stats.conflicts++;
+        if (worktreeStatus !== undefined && ['M', 'D'].includes(worktreeStatus)) {
+            stats.modified++;
+            stats.modifiedFiles.push(filename);
+        }
+        if (status === '??') {
+            stats.untracked++;
+            stats.untrackedFiles.push(filename);
+        }
+    }
+    let result = `Branch: ${branchName}\n`;
+    const append = (label, count, files, shown) => {
+        if (count === 0)
+            return;
+        result += `${label}: ${count} files\n`;
+        for (const file of files.slice(0, shown))
+            result += `  ${file}\n`;
+        if (count > shown)
+            result += `  ... +${count - shown} more\n`;
+    };
+    append('Staged', stats.staged, stats.stagedFiles, 5);
+    append('Modified', stats.modified, stats.modifiedFiles, 5);
+    append('Untracked', stats.untracked, stats.untrackedFiles, 3);
+    if (stats.conflicts > 0)
+        result += `Conflicts: ${stats.conflicts} files\n`;
+    return result.trim();
+}
+/** Keep the first `limit` log lines, capping each line's width. */
+export function compactLog(output, limit = 20) {
+    const lines = output.split('\n');
+    const result = [];
+    for (const line of lines.slice(0, limit)) {
+        result.push(line.length > 80 ? `${line.slice(0, 77)}...` : line);
+    }
+    if (lines.length > limit)
+        result.push(`... and ${lines.length - limit} more commits`);
+    return result.join('\n');
+}
+/**
+ * Compact a git command's output, or `null` when nothing applies.
+ *
+ * Each branch first checks that the output actually looks like raw git output.
+ * A command like `git diff --stat` inside a wrapper, or a script whose name
+ * merely starts with `git`, would otherwise be rewritten into a summary of
+ * text this module never parsed correctly.
+ */
+export function compactGitOutput(output, command) {
+    if (!isGitCommand(command))
+        return null;
+    const normalized = normalizeCommandForDetection(command);
+    if (!normalized)
+        return null;
+    if (normalized.startsWith('git diff'))
+        return RAW_GIT_DIFF_PATTERN.test(output) ? compactDiff(output) : null;
+    if (normalized.startsWith('git status')) {
+        if (!isPorcelainStatus(output))
+            return null;
+        return RAW_GIT_STATUS_PATTERN.test(output) ? compactStatus(output) : null;
+    }
+    if (normalized.startsWith('git log'))
+        return compactLog(output);
+    return null;
+}
+//# sourceMappingURL=git.js.map

package/lib/compact/git.js.map

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

package/lib/compact/index.d.ts

@@ -0,0 +1,39 @@
+import type { RtkConfig } from '../config.js';
+/** Banner prefixed to a `read` result that lost information. */
+export declare const READ_COMPACTION_BANNER_PREFIX = "[rtk compacted output:";
+/** The tool-result projection compaction reads and writes. */
+export interface CompactionInput {
+    toolName: string;
+    args: unknown;
+    content: unknown;
+}
+/** What one compaction pass did, for the session metrics. */
+export interface CompactionMetadata {
+    applied: boolean;
+    techniques: string[];
+    truncated: boolean;
+    originalCharCount: number;
+    compactedCharCount: number;
+    originalLineCount: number;
+    compactedLineCount: number;
+}
+/** The pipeline's verdict for one tool result. */
+export interface CompactionOutcome {
+    changed: boolean;
+    content?: unknown[];
+    techniques: string[];
+    metadata?: CompactionMetadata;
+}
+/**
+ * Run every enabled technique over one tool result.
+ *
+ * Returns `changed: false` whenever the result would not actually shrink, so a
+ * caller can treat "no outcome" and "no improvement" identically and the model
+ * never pays for a rewrite that saved nothing.
+ *
+ * @param input - the tool name, its parsed arguments, and the content blocks.
+ * @param config - the resolved plugin configuration.
+ * @returns the replacement content and the techniques that fired.
+ */
+export declare function compactToolResult(input: CompactionInput, config: RtkConfig): CompactionOutcome;
+//# sourceMappingURL=index.d.ts.map

package/lib/compact/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compact/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA0B,SAAS,EAAE,MAAM,cAAc,CAAA;AAgBrE,gEAAgE;AAChE,eAAO,MAAM,6BAA6B,2BAA2B,CAAA;AAErE,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B;AA6KD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAqD9F"}