@wingsbutterfly/dsh-rtk 0.1.0

package/lib/compact/index.js

@@ -0,0 +1,236 @@
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import { aggregateLinterOutput } from './linter.js';
+import { filterBuildOutput } from './build.js';
+import { aggregateTestOutput } from './test-output.js';
+import { compactGitOutput } from './git.js';
+import { groupSearchResults } from './search.js';
+import { detectLanguage, filterSourceCode, smartTruncate } from './source.js';
+import { NO_OUTPUT_PLACEHOLDER, parseBashResult, renderBashResult } from './dsh-result.js';
+import { countLines, stripAnsi, truncate } from './text.js';
+/** Techniques whose effect cannot be undone by re-reading a smaller range. */
+const LOSSY_TECHNIQUES = ['build', 'test', 'git', 'linter', 'search', 'truncate', 'smart-truncate', 'source:'];
+/** Reads at or below this many lines are always left exact. */
+const READ_EXACT_LINE_THRESHOLD = 80;
+/** Banner prefixed to a `read` result that lost information. */
+export const READ_COMPACTION_BANNER_PREFIX = '[rtk compacted output:';
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : {};
+}
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function isTextBlock(block) {
+    const record = asRecord(block);
+    return record.type === 'text' && typeof record.text === 'string';
+}
+function hasLossyTechnique(techniques) {
+    return techniques.some((technique) => LOSSY_TECHNIQUES.some((prefix) => (prefix.endsWith(':') ? technique.startsWith(prefix) : technique === prefix)));
+}
+/** Apply one nullable technique, recording it only when it changed the text. */
+function applyNullable(state, result, technique) {
+    if (result === null || result === state.text)
+        return;
+    state.text = result;
+    state.techniques.push(technique);
+}
+function applyAnsi(state, compaction) {
+    if (!compaction.stripAnsi)
+        return;
+    const stripped = stripAnsi(state.text);
+    if (stripped !== state.text) {
+        state.text = stripped;
+        state.techniques.push('ansi');
+    }
+}
+/**
+ * Compact a bash result without disturbing its status markers.
+ *
+ * stdout is summarized by whichever technique recognizes the command; stderr is
+ * only stripped of escape codes, because an error message's exact wording is
+ * what the reader acts on. The trailing markers are re-attached verbatim, and
+ * a final budget check truncates the bodies while never cutting a marker.
+ */
+function compactBashText(text, command, compaction) {
+    const parts = parseBashResult(text);
+    if (parts.empty)
+        return { text, techniques: [] };
+    const state = { text: parts.stdout, techniques: [] };
+    applyAnsi(state, compaction);
+    if (compaction.filterBuildOutput)
+        applyNullable(state, filterBuildOutput(state.text, command), 'build');
+    if (compaction.aggregateTestOutput)
+        applyNullable(state, aggregateTestOutput(state.text, command), 'test');
+    if (compaction.compactGitOutput)
+        applyNullable(state, compactGitOutput(state.text, command), 'git');
+    if (compaction.aggregateLinterOutput)
+        applyNullable(state, aggregateLinterOutput(state.text, command), 'linter');
+    let stdout = state.text;
+    let stderr = parts.stderr;
+    if (stderr !== undefined && compaction.stripAnsi)
+        stderr = stripAnsi(stderr);
+    const render = () => renderBashResult({
+        empty: false,
+        stdout,
+        ...(stderr === undefined ? {} : { stderr }),
+        markers: parts.markers,
+    });
+    let rendered = render();
+    if (compaction.truncate.enabled && rendered.length > compaction.truncate.maxChars) {
+        const markerOverhead = renderBashResult({ empty: false, stdout: '', markers: parts.markers }).length;
+        const budget = Math.max(1, compaction.truncate.maxChars - markerOverhead - 8);
+        // stderr keeps the smaller share: it is usually short, and when it is not,
+        // its head is still the diagnostic while its tail is usually a stack dump.
+        const stderrBudget = stderr === undefined ? 0 : Math.min(stderr.length, Math.floor(budget * 0.4));
+        const stdoutBudget = Math.max(1, budget - stderrBudget);
+        if (stdout.length > stdoutBudget)
+            stdout = truncate(stdout, stdoutBudget);
+        if (stderr !== undefined && stderr.length > stderrBudget)
+            stderr = truncate(stderr, stderrBudget);
+        rendered = render();
+        state.techniques.push('truncate');
+    }
+    // Compaction must never make a result bigger than the text it replaced.
+    if (rendered.length >= text.length)
+        return { text, techniques: [] };
+    return { text: rendered, techniques: state.techniques };
+}
+/**
+ * Whether a `read` result must stay byte-exact.
+ *
+ * Three cases: the caller asked for a narrow range (the tool already bounded
+ * it, and the caller will edit against what it sees), the file is short enough
+ * that filtering saves nothing worth the risk, or the path lives under a skill
+ * directory — skills are instructions the agent follows verbatim.
+ */
+function shouldPreserveExactRead(text, args, compaction) {
+    if (!compaction.readCompaction.enabled)
+        return true;
+    if (args.offset !== undefined || args.limit !== undefined)
+        return true;
+    if (countLines(text) <= READ_EXACT_LINE_THRESHOLD)
+        return true;
+    if (compaction.preserveExactSkillReads && typeof args.path === 'string') {
+        const target = resolve(args.path);
+        const roots = [resolve(homedir(), '.agents', 'skills'), resolve(homedir(), '.dsh', 'skills')];
+        let cursor = process.cwd();
+        for (;;) {
+            roots.push(resolve(cursor, '.agents', 'skills'));
+            const parent = resolve(cursor, '..');
+            if (parent === cursor)
+                break;
+            cursor = parent;
+        }
+        if (roots.some((root) => target === root || target.startsWith(`${root}/`)))
+            return true;
+    }
+    return false;
+}
+function compactReadText(text, args, compaction) {
+    if (shouldPreserveExactRead(text, args, compaction))
+        return { text, techniques: [] };
+    const state = { text, techniques: [] };
+    applyAnsi(state, compaction);
+    const filePath = typeof args.path === 'string' ? args.path : '';
+    const language = detectLanguage(filePath);
+    if (compaction.sourceCodeFilteringEnabled && compaction.sourceCodeFiltering !== 'none') {
+        applyNullable(state, filterSourceCode(state.text, language, compaction.sourceCodeFiltering), `source:${compaction.sourceCodeFiltering}`);
+    }
+    if (compaction.smartTruncate.enabled && countLines(state.text) > compaction.smartTruncate.maxLines) {
+        applyNullable(state, smartTruncate(state.text, compaction.smartTruncate.maxLines), 'smart-truncate');
+    }
+    if (compaction.truncate.enabled && state.text.length > compaction.truncate.maxChars) {
+        applyNullable(state, truncate(state.text, compaction.truncate.maxChars), 'truncate');
+    }
+    if (state.techniques.length === 0)
+        return { text, techniques: [] };
+    // The banner is part of the returned result, so the size guard must weigh it.
+    // Filtering one comment line out of a short file saves less than the banner
+    // costs, and without this the result would come back longer than the text it
+    // replaced — the exact invariant the guard exists to hold.
+    const banner = `${READ_COMPACTION_BANNER_PREFIX} ${state.techniques.join(', ')}]`;
+    const rendered = `${banner}\n${state.text}`;
+    if (rendered.length >= text.length)
+        return { text, techniques: [] };
+    return { text: rendered, techniques: state.techniques };
+}
+function compactGrepText(text, compaction) {
+    const state = { text, techniques: [] };
+    applyAnsi(state, compaction);
+    if (compaction.groupSearchOutput)
+        applyNullable(state, groupSearchResults(state.text), 'search');
+    if (compaction.truncate.enabled && state.text.length > compaction.truncate.maxChars) {
+        applyNullable(state, truncate(state.text, compaction.truncate.maxChars), 'truncate');
+    }
+    if (state.text.length >= text.length)
+        return { text, techniques: [] };
+    return state;
+}
+/**
+ * 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 function compactToolResult(input, config) {
+    const compaction = config.outputCompaction;
+    if (!config.enabled || !compaction.enabled)
+        return { changed: false, techniques: [] };
+    if (!config.compactedTools.includes(input.toolName))
+        return { changed: false, techniques: [] };
+    const sourceContent = asArray(input.content);
+    if (sourceContent.length === 0)
+        return { changed: false, techniques: [] };
+    const args = asRecord(input.args);
+    const command = typeof args.command === 'string' ? args.command : undefined;
+    const techniques = new Set();
+    const originalChunks = [];
+    const compactedChunks = [];
+    let changed = false;
+    const nextContent = sourceContent.map((block) => {
+        if (!isTextBlock(block))
+            return block;
+        let transformed = { text: block.text, techniques: [] };
+        if (input.toolName === 'bash')
+            transformed = compactBashText(block.text, command, compaction);
+        else if (input.toolName === 'read')
+            transformed = compactReadText(block.text, args, compaction);
+        else if (input.toolName === 'grep')
+            transformed = compactGrepText(block.text, compaction);
+        for (const technique of transformed.techniques)
+            techniques.add(technique);
+        originalChunks.push(block.text);
+        compactedChunks.push(transformed.text);
+        if (transformed.text === block.text)
+            return block;
+        changed = true;
+        return { ...block, text: transformed.text };
+    });
+    if (!changed)
+        return { changed: false, techniques: [] };
+    if (originalChunks.join('\n') === NO_OUTPUT_PLACEHOLDER)
+        return { changed: false, techniques: [] };
+    const originalText = originalChunks.join('\n');
+    const compactedText = compactedChunks.join('\n');
+    const applied = Array.from(techniques);
+    return {
+        changed: true,
+        content: nextContent,
+        techniques: applied,
+        metadata: {
+            applied: true,
+            techniques: applied,
+            truncated: hasLossyTechnique(applied),
+            originalCharCount: originalText.length,
+            compactedCharCount: compactedText.length,
+            originalLineCount: countLines(originalText),
+            compactedLineCount: countLines(compactedText),
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/lib/compact/index.js.map

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

package/lib/compact/linter.d.ts

@@ -0,0 +1,12 @@
+/** Whether the command is a linter this module understands. */
+export declare function isLinterCommand(command: string | undefined | null): boolean;
+/**
+ * Reduce linter output to counts plus the rules and files that dominate.
+ *
+ * The full issue list is usually thousands of near-identical lines; the
+ * distribution is what a reader acts on. Individual messages are dropped in
+ * favor of counts, which is lossy by design — the reader re-runs on the file
+ * they choose to fix.
+ */
+export declare function aggregateLinterOutput(output: string, command: string | undefined | null): string | null;
+//# sourceMappingURL=linter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../src/compact/linter.ts"],"names":[],"mappings":"AA2BA,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAE3E;AA6CD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA0CvG"}

package/lib/compact/linter.js

@@ -0,0 +1,118 @@
+import { matchesCommandPatterns, normalizeCommandForDetection } from './detect.js';
+import { compactPath } from './text.js';
+const LINTER_COMMAND_PATTERNS = [
+    /^(?:pnpm\s+)?(?:npx\s+)?eslint\b/,
+    /^(?:npx\s+)?prettier\b/,
+    /^ruff\b/,
+    /^pylint\b/,
+    /^mypy\b/,
+    /^flake8\b/,
+    /^black\b/,
+    /^cargo\s+clippy\b/,
+    /^golangci-lint\b/,
+];
+const MAX_RULES = 10;
+const MAX_FILES = 10;
+const MAX_RULES_PER_FILE = 3;
+/** Whether the command is a linter this module understands. */
+export function isLinterCommand(command) {
+    return matchesCommandPatterns(command, LINTER_COMMAND_PATTERNS);
+}
+function parseIssueLine(line) {
+    const fileLineMatch = line.match(/^(.+):(\d+):(\d+):\s*(.+)$/);
+    if (fileLineMatch) {
+        const lineNumber = Number.parseInt(fileLineMatch[2] ?? '0', 10);
+        const content = fileLineMatch[4] ?? line;
+        return {
+            severity: /warning/i.test(content) ? 'WARNING' : 'ERROR',
+            rule: content.match(/\[(.+?)\]$/)?.[1] ?? 'unknown',
+            file: fileLineMatch[1] ?? 'unknown',
+            ...(Number.isNaN(lineNumber) ? {} : { line: lineNumber }),
+            message: content,
+        };
+    }
+    const rustMatch = line.match(/^(error|warning):\s*(.+?)\s+at\s+(.+):(\d+):(\d+)$/);
+    if (rustMatch) {
+        const lineNumber = Number.parseInt(rustMatch[4] ?? '0', 10);
+        return {
+            severity: (rustMatch[1]?.toUpperCase() ?? 'ERROR'),
+            rule: 'unknown',
+            file: rustMatch[3] ?? 'unknown',
+            ...(Number.isNaN(lineNumber) ? {} : { line: lineNumber }),
+            message: rustMatch[2] ?? line,
+        };
+    }
+    return null;
+}
+function detectLinterType(command) {
+    const normalized = normalizeCommandForDetection(command);
+    if (!normalized)
+        return 'Linter';
+    if (/(?:^|\s)eslint\b/.test(normalized))
+        return 'ESLint';
+    if (/^ruff\b/.test(normalized))
+        return 'Ruff';
+    if (/^pylint\b/.test(normalized))
+        return 'Pylint';
+    if (/^mypy\b/.test(normalized))
+        return 'MyPy';
+    if (/^flake8\b/.test(normalized))
+        return 'Flake8';
+    if (/clippy\b/.test(normalized))
+        return 'Clippy';
+    if (/^golangci-lint\b/.test(normalized))
+        return 'GolangCI-Lint';
+    if (/prettier\b/.test(normalized))
+        return 'Prettier';
+    return 'Linter';
+}
+/**
+ * Reduce linter output to counts plus the rules and files that dominate.
+ *
+ * The full issue list is usually thousands of near-identical lines; the
+ * distribution is what a reader acts on. Individual messages are dropped in
+ * favor of counts, which is lossy by design — the reader re-runs on the file
+ * they choose to fix.
+ */
+export function aggregateLinterOutput(output, command) {
+    if (!isLinterCommand(command))
+        return null;
+    const linterType = detectLinterType(command);
+    const issues = [];
+    for (const line of output.split('\n')) {
+        const issue = parseIssueLine(line);
+        if (issue)
+            issues.push(issue);
+    }
+    if (issues.length === 0)
+        return `[OK] ${linterType}: No issues found`;
+    const errors = issues.filter((issue) => issue.severity === 'ERROR').length;
+    const warnings = issues.filter((issue) => issue.severity === 'WARNING').length;
+    const byRule = new Map();
+    const byFile = new Map();
+    for (const issue of issues) {
+        byRule.set(issue.rule, (byRule.get(issue.rule) ?? 0) + 1);
+        const existing = byFile.get(issue.file) ?? [];
+        existing.push(issue);
+        byFile.set(issue.file, existing);
+    }
+    let result = `${linterType}: ${errors} errors, ${warnings} warnings in ${byFile.size} files\n`;
+    result += '═══════════════════════════════════════\n';
+    result += 'Top rules:\n';
+    for (const [rule, count] of Array.from(byRule.entries()).sort((left, right) => right[1] - left[1]).slice(0, MAX_RULES)) {
+        result += `  ${rule} (${count}x)\n`;
+    }
+    result += '\nTop files:\n';
+    const sortedFiles = Array.from(byFile.entries()).sort((left, right) => right[1].length - left[1].length).slice(0, MAX_FILES);
+    for (const [file, fileIssues] of sortedFiles) {
+        result += `  ${compactPath(file, 40)} (${fileIssues.length} issues)\n`;
+        const fileRules = new Map();
+        for (const issue of fileIssues)
+            fileRules.set(issue.rule, (fileRules.get(issue.rule) ?? 0) + 1);
+        const topRules = Array.from(fileRules.entries()).sort((left, right) => right[1] - left[1]).slice(0, MAX_RULES_PER_FILE);
+        for (const [rule, count] of topRules)
+            result += `    ${rule} (${count})\n`;
+    }
+    return result;
+}
+//# sourceMappingURL=linter.js.map

package/lib/compact/linter.js.map

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

package/lib/compact/search.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Group `grep`-style matches by file.
+ *
+ * Returns `null` when the output is not recognizably a match list. The format
+ * check is what keeps this safe across search tools: ripgrep, GNU grep, and the
+ * harness's own `grep` all print `path:line:text`, but a command whose name
+ * merely resembles a search may print anything at all, and summarizing that
+ * would silently discard real output. Erring toward `null` leaves the text
+ * untouched, which is always correct.
+ *
+ * @param output - raw search output.
+ * @param maxResults - cap on rendered match lines across all files.
+ * @returns the grouped summary, or `null` when the shape does not match.
+ */
+export declare function groupSearchResults(output: string, maxResults?: number): string | null;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/compact/search.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,MAAM,GAAG,IAAI,CA+CjF"}

package/lib/compact/search.js

@@ -0,0 +1,67 @@
+import { compactPath } from './text.js';
+/** Minimum share of non-blank lines that must parse as `file:line:content`. */
+const MIN_MATCH_RATIO = 0.6;
+/**
+ * Group `grep`-style matches by file.
+ *
+ * Returns `null` when the output is not recognizably a match list. The format
+ * check is what keeps this safe across search tools: ripgrep, GNU grep, and the
+ * harness's own `grep` all print `path:line:text`, but a command whose name
+ * merely resembles a search may print anything at all, and summarizing that
+ * would silently discard real output. Erring toward `null` leaves the text
+ * untouched, which is always correct.
+ *
+ * @param output - raw search output.
+ * @param maxResults - cap on rendered match lines across all files.
+ * @returns the grouped summary, or `null` when the shape does not match.
+ */
+export function groupSearchResults(output, maxResults = 50) {
+    const lines = output.split('\n').filter((line) => line.trim().length > 0);
+    if (lines.length === 0)
+        return null;
+    const results = [];
+    let parseable = 0;
+    for (const line of lines) {
+        const match = line.match(/^(.+?):(\d+)?:(.*)$/);
+        if (!match)
+            continue;
+        parseable++;
+        results.push({
+            file: match[1] ?? 'unknown',
+            lineNumber: match[2] ?? '?',
+            content: match[3] ?? '',
+        });
+    }
+    if (results.length === 0)
+        return null;
+    if (parseable / lines.length < MIN_MATCH_RATIO)
+        return null;
+    const byFile = new Map();
+    for (const result of results) {
+        const existing = byFile.get(result.file) ?? [];
+        existing.push(result);
+        byFile.set(result.file, existing);
+    }
+    let outputText = `${results.length} matches in ${byFile.size} files:\n\n`;
+    const sortedFiles = Array.from(byFile.entries()).sort((left, right) => left[0].localeCompare(right[0]));
+    let shown = 0;
+    for (const [file, matches] of sortedFiles) {
+        if (shown >= maxResults)
+            break;
+        outputText += `> ${compactPath(file, 50)} (${matches.length} matches):\n`;
+        for (const match of matches.slice(0, 10)) {
+            let cleaned = match.content.trim();
+            if (cleaned.length > 70)
+                cleaned = `${cleaned.slice(0, 67)}...`;
+            outputText += `    ${match.lineNumber}: ${cleaned}\n`;
+            shown++;
+        }
+        if (matches.length > 10)
+            outputText += `  +${matches.length - 10} more\n`;
+        outputText += '\n';
+    }
+    if (results.length > shown)
+        outputText += `... +${results.length - shown} more\n`;
+    return outputText;
+}
+//# sourceMappingURL=search.js.map

package/lib/compact/search.js.map

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

package/lib/compact/source.d.ts

@@ -0,0 +1,22 @@
+import type { SourceCodeFilteringLevel } from '../config.js';
+/** A language whose comment syntax this module knows. */
+export type Language = 'javascript' | 'python' | 'rust' | 'go' | 'java' | 'c' | 'shell' | 'ruby' | 'unknown';
+/** Infer a source language from a file extension. */
+export declare function detectLanguage(filePath: string): Language;
+/**
+ * Keep the most informative `maxLines` lines of a source read.
+ *
+ * The first half of the budget is kept verbatim, after which only structural
+ * lines survive — signatures, imports, and lone braces — with a marker where
+ * body lines were dropped. This preserves the shape of the file (what is
+ * defined where) rather than an arbitrary prefix, which is what makes the
+ * result still usable for orientation.
+ *
+ * @param content - file text.
+ * @param maxLines - line budget.
+ * @returns the reduced text.
+ */
+export declare function smartTruncate(content: string, maxLines: number): string;
+/** Apply the configured source-filtering level. */
+export declare function filterSourceCode(content: string, language: Language, level: SourceCodeFilteringLevel): string;
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/compact/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAE5D,yDAAyD;AACzD,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAoD5G,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAIzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqCvE;AAuHD,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAW7G"}