merlion 0.1.0

package/bin/merlion.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js'

package/dist/artifacts/agents.d.ts

@@ -0,0 +1,11 @@
+export interface AgentsGuidance {
+    text: string;
+    files: string[];
+    tokensEstimate: number;
+    truncated: boolean;
+}
+export interface LoadAgentsGuidanceOptions {
+    maxTokens?: number;
+}
+export declare function loadAgentsGuidance(cwd: string, options?: LoadAgentsGuidanceOptions): Promise<AgentsGuidance>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/artifacts/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/artifacts/agents.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAwDD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,cAAc,CAAC,CAyBzB"}

package/dist/artifacts/agents.js

@@ -0,0 +1,81 @@
+import { access, readFile } from 'node:fs/promises';
+import { join, relative, resolve, sep } from 'node:path';
+import { constants } from 'node:fs';
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+async function fileExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findProjectRoot(startCwd) {
+    let cursor = resolve(startCwd);
+    for (;;) {
+        const gitPath = join(cursor, '.git');
+        if (await fileExists(gitPath))
+            return cursor;
+        const parent = resolve(cursor, '..');
+        if (parent === cursor)
+            return resolve(startCwd);
+        cursor = parent;
+    }
+}
+function ancestorsFromRoot(projectRoot, cwd) {
+    const root = resolve(projectRoot);
+    const target = resolve(cwd);
+    if (!target.startsWith(root)) {
+        return [root];
+    }
+    const rel = relative(root, target);
+    if (rel === '')
+        return [root];
+    const segments = rel.split(sep).filter(Boolean);
+    const paths = [root];
+    let cursor = root;
+    for (const segment of segments) {
+        cursor = join(cursor, segment);
+        paths.push(cursor);
+    }
+    return paths;
+}
+function truncateByTokenBudget(text, maxTokens) {
+    if (maxTokens <= 0)
+        return { text: '', truncated: text.length > 0 };
+    const maxChars = maxTokens * 4;
+    if (text.length <= maxChars)
+        return { text, truncated: false };
+    return {
+        text: `${text.slice(0, Math.max(0, maxChars - 48))}\n\n[...AGENTS guidance truncated by budget...]`,
+        truncated: true,
+    };
+}
+export async function loadAgentsGuidance(cwd, options) {
+    const maxTokens = options?.maxTokens ?? 500;
+    const projectRoot = await findProjectRoot(cwd);
+    const searchDirs = ancestorsFromRoot(projectRoot, cwd);
+    const files = [];
+    const blocks = [];
+    for (const dir of searchDirs) {
+        const path = join(dir, 'AGENTS.md');
+        if (!(await fileExists(path)))
+            continue;
+        const content = await readFile(path, 'utf8');
+        files.push(path);
+        const rel = relative(projectRoot, path) || 'AGENTS.md';
+        blocks.push(`## ${rel}\n${content.trim()}`);
+    }
+    const merged = blocks.join('\n\n');
+    const clipped = truncateByTokenBudget(merged, maxTokens);
+    return {
+        text: clipped.text,
+        files,
+        tokensEstimate: estimateTokens(clipped.text),
+        truncated: clipped.truncated
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/artifacts/agents.js.map

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

package/dist/artifacts/codebase_index.d.ts

@@ -0,0 +1,16 @@
+export interface CodebaseIndexArtifact {
+    path: string;
+    content: string;
+}
+export interface ReadCodebaseIndexOptions {
+    maxTokens?: number;
+}
+export declare function ensureCodebaseIndex(cwd: string): Promise<CodebaseIndexArtifact>;
+export declare function readCodebaseIndex(cwd: string, options?: ReadCodebaseIndexOptions): Promise<{
+    path: string;
+    text: string;
+    tokensEstimate: number;
+    truncated: boolean;
+}>;
+export declare function updateCodebaseIndexWithChangedFiles(cwd: string, changedPaths: string[]): Promise<CodebaseIndexArtifact>;
+//# sourceMappingURL=codebase_index.d.ts.map

package/dist/artifacts/codebase_index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase_index.d.ts","sourceRoot":"","sources":["../../src/artifacts/codebase_index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAuHD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAWrF;AAYD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CASrF;AA8BD,wBAAsB,mCAAmC,CACvD,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,qBAAqB,CAAC,CAkBhC"}

package/dist/artifacts/codebase_index.js

@@ -0,0 +1,193 @@
+import { access, mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+const MAX_FILE_MAP_LINES = 80;
+const MAX_CHANGED_FILES = 50;
+const IGNORE_DIRS = new Set(['.git', 'node_modules', '.merlion', 'dist', 'build', '.next']);
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+async function fileExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findProjectRoot(startCwd) {
+    let cursor = resolve(startCwd);
+    for (;;) {
+        if (await fileExists(join(cursor, '.git')))
+            return cursor;
+        const parent = resolve(cursor, '..');
+        if (parent === cursor)
+            return resolve(startCwd);
+        cursor = parent;
+    }
+}
+async function listTopLevel(root) {
+    const entries = await readdir(root, { withFileTypes: true });
+    const rows = entries
+        .filter((entry) => !IGNORE_DIRS.has(entry.name))
+        .map((entry) => `${entry.isDirectory() ? '[dir]' : '[file]'} ${entry.name}`)
+        .sort();
+    return rows;
+}
+async function readScripts(root) {
+    const pkgPath = join(root, 'package.json');
+    if (!(await fileExists(pkgPath)))
+        return [];
+    try {
+        const text = await readFile(pkgPath, 'utf8');
+        const parsed = JSON.parse(text);
+        const scripts = parsed.scripts ?? {};
+        return Object.keys(scripts)
+            .sort()
+            .map((name) => `${name}: ${scripts[name]}`);
+    }
+    catch {
+        return [];
+    }
+}
+async function walkFiles(root, includeDirs) {
+    const result = [];
+    async function walk(dir) {
+        if (result.length >= MAX_FILE_MAP_LINES)
+            return;
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (result.length >= MAX_FILE_MAP_LINES)
+                return;
+            if (entry.name.startsWith('.'))
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (IGNORE_DIRS.has(entry.name))
+                    continue;
+                await walk(full);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            result.push(relative(root, full));
+        }
+    }
+    for (const dir of includeDirs) {
+        const full = join(root, dir);
+        if (!(await fileExists(full)))
+            continue;
+        const st = await stat(full);
+        if (!st.isDirectory())
+            continue;
+        await walk(full);
+    }
+    return result.sort();
+}
+function renderIndex(params) {
+    const lines = [];
+    lines.push('# Codebase Index');
+    lines.push('');
+    lines.push(`Generated at: ${new Date().toISOString()}`);
+    lines.push('');
+    lines.push('## Top-level');
+    lines.push(...(params.topLevel.length > 0 ? params.topLevel.map((x) => `- ${x}`) : ['- (empty)']));
+    lines.push('');
+    lines.push('## Dev Scripts');
+    lines.push(...(params.scripts.length > 0 ? params.scripts.map((x) => `- ${x}`) : ['- (none)']));
+    lines.push('');
+    lines.push('## File Map (sample)');
+    lines.push(...(params.fileMap.length > 0 ? params.fileMap.map((x) => `- ${x}`) : ['- (none)']));
+    lines.push('');
+    if (params.changedFiles && params.changedFiles.length > 0) {
+        lines.push('## Recent Changed Files');
+        lines.push(...params.changedFiles.map((x) => `- changed: ${x}`));
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+async function resolveIndexPath(cwd) {
+    const root = await findProjectRoot(cwd);
+    return { root, path: join(root, 'docs', 'codebase_index.md') };
+}
+export async function ensureCodebaseIndex(cwd) {
+    const { root, path } = await resolveIndexPath(cwd);
+    if (!(await fileExists(path))) {
+        await mkdir(join(path, '..'), { recursive: true });
+        const topLevel = await listTopLevel(root);
+        const scripts = await readScripts(root);
+        const fileMap = await walkFiles(root, ['src', 'tests', 'docs']);
+        await writeFile(path, renderIndex({ topLevel, scripts, fileMap }), 'utf8');
+    }
+    const content = await readFile(path, 'utf8');
+    return { path, content };
+}
+function truncate(text, maxTokens) {
+    if (maxTokens <= 0)
+        return { text: '', truncated: text.length > 0 };
+    const maxChars = maxTokens * 4;
+    if (text.length <= maxChars)
+        return { text, truncated: false };
+    return {
+        text: `${text.slice(0, Math.max(0, maxChars - 44))}\n\n[...codebase_index truncated...]`,
+        truncated: true,
+    };
+}
+export async function readCodebaseIndex(cwd, options) {
+    const artifact = await ensureCodebaseIndex(cwd);
+    const clipped = truncate(artifact.content, options?.maxTokens ?? 400);
+    return {
+        path: artifact.path,
+        text: clipped.text,
+        tokensEstimate: estimateTokens(clipped.text),
+        truncated: clipped.truncated,
+    };
+}
+function parseChangedFiles(content) {
+    const marker = '## Recent Changed Files';
+    const start = content.indexOf(marker);
+    if (start === -1)
+        return [];
+    const afterStart = content.slice(start + marker.length);
+    const nextHeadingPos = afterStart.indexOf('\n## ');
+    const block = (nextHeadingPos === -1 ? afterStart : afterStart.slice(0, nextHeadingPos)).trim();
+    return block
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith('- changed: '))
+        .map((line) => line.slice('- changed: '.length).trim())
+        .filter(Boolean);
+}
+function replaceOrAppendChangedSection(content, changedFiles) {
+    const marker = '## Recent Changed Files';
+    const section = [marker, ...changedFiles.map((x) => `- changed: ${x}`), ''].join('\n');
+    const start = content.indexOf(marker);
+    if (start === -1) {
+        return `${content.trimEnd()}\n\n${section}`;
+    }
+    const afterStart = content.slice(start + marker.length);
+    const nextHeadingPos = afterStart.indexOf('\n## ');
+    const end = nextHeadingPos === -1 ? content.length : start + marker.length + nextHeadingPos + 1;
+    return `${content.slice(0, start)}${section}${content.slice(end)}`;
+}
+export async function updateCodebaseIndexWithChangedFiles(cwd, changedPaths) {
+    const artifact = await ensureCodebaseIndex(cwd);
+    const { root, path } = await resolveIndexPath(cwd);
+    const existing = parseChangedFiles(artifact.content);
+    const normalized = changedPaths
+        .map((p) => relative(root, resolve(cwd, p)))
+        .map((p) => p.replace(/\\/g, '/'))
+        .filter((p) => !p.startsWith('..') && p !== '');
+    const merged = [];
+    for (const item of [...normalized, ...existing]) {
+        if (!merged.includes(item))
+            merged.push(item);
+        if (merged.length >= MAX_CHANGED_FILES)
+            break;
+    }
+    const updated = replaceOrAppendChangedSection(artifact.content, merged);
+    await writeFile(path, updated, 'utf8');
+    return { path, content: updated };
+}
+//# sourceMappingURL=codebase_index.js.map

package/dist/artifacts/codebase_index.js.map

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

package/dist/artifacts/progress.d.ts

@@ -0,0 +1,23 @@
+export interface ProgressArtifact {
+    path: string;
+    content: string;
+}
+export interface ProgressUpdatePatch {
+    objective?: string;
+    done?: string[];
+    next?: string[];
+    blockers?: string[];
+    decisions?: string[];
+}
+export interface ReadProgressOptions {
+    maxTokens?: number;
+}
+export declare function ensureProgressArtifact(cwd: string, initialObjective?: string): Promise<ProgressArtifact>;
+export declare function readProgressArtifact(cwd: string, options?: ReadProgressOptions): Promise<{
+    path: string;
+    text: string;
+    tokensEstimate: number;
+    truncated: boolean;
+}>;
+export declare function updateProgressArtifact(cwd: string, patch: ProgressUpdatePatch): Promise<ProgressArtifact>;
+//# sourceMappingURL=progress.d.ts.map

package/dist/artifacts/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/artifacts/progress.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAsGD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CASrF;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA8B3B"}

package/dist/artifacts/progress.js

@@ -0,0 +1,152 @@
+import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { join, resolve } from 'node:path';
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+async function fileExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findProjectRoot(startCwd) {
+    let cursor = resolve(startCwd);
+    for (;;) {
+        if (await fileExists(join(cursor, '.git')))
+            return cursor;
+        const parent = resolve(cursor, '..');
+        if (parent === cursor)
+            return resolve(startCwd);
+        cursor = parent;
+    }
+}
+function sectionLines(items) {
+    const cleaned = (items ?? []).map((item) => item.trim()).filter((item) => item !== '');
+    if (cleaned.length === 0)
+        return ['- (none)'];
+    return cleaned.map((item) => `- ${item}`);
+}
+function renderTemplate(objective) {
+    return [
+        '# Merlion Progress',
+        '',
+        '## Objective',
+        objective && objective.trim() !== '' ? objective.trim() : '(not set)',
+        '',
+        '## Done',
+        ...sectionLines(),
+        '',
+        '## Next',
+        ...sectionLines(),
+        '',
+        '## Blockers',
+        ...sectionLines(),
+        '',
+        '## Decisions',
+        ...sectionLines(),
+        '',
+    ].join('\n');
+}
+function extractSection(content, heading) {
+    const marker = `## ${heading}`;
+    const start = content.indexOf(marker);
+    if (start === -1)
+        return [];
+    const afterStart = content.slice(start + marker.length);
+    const nextHeadingPos = afterStart.indexOf('\n## ');
+    const block = nextHeadingPos === -1 ? afterStart : afterStart.slice(0, nextHeadingPos);
+    return block
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith('- '))
+        .map((line) => line.slice(2).trim())
+        .filter((line) => line !== '' && line !== '(none)');
+}
+function extractObjective(content) {
+    const marker = '## Objective';
+    const start = content.indexOf(marker);
+    if (start === -1)
+        return '(not set)';
+    const afterStart = content.slice(start + marker.length);
+    const nextHeadingPos = afterStart.indexOf('\n## ');
+    const block = (nextHeadingPos === -1 ? afterStart : afterStart.slice(0, nextHeadingPos)).trim();
+    return block === '' ? '(not set)' : block;
+}
+function mergeSection(existing, incoming) {
+    if (!incoming || incoming.length === 0)
+        return existing;
+    const merged = [...existing];
+    for (const item of incoming.map((s) => s.trim()).filter(Boolean)) {
+        if (!merged.includes(item))
+            merged.push(item);
+    }
+    return merged;
+}
+function truncate(text, maxTokens) {
+    if (maxTokens <= 0)
+        return { text: '', truncated: text.length > 0 };
+    const maxChars = maxTokens * 4;
+    if (text.length <= maxChars)
+        return { text, truncated: false };
+    return {
+        text: `${text.slice(0, Math.max(0, maxChars - 44))}\n\n[...progress truncated...]`,
+        truncated: true,
+    };
+}
+async function resolveProgressPath(cwd) {
+    const root = await findProjectRoot(cwd);
+    return join(root, '.merlion', 'progress.md');
+}
+export async function ensureProgressArtifact(cwd, initialObjective) {
+    const path = await resolveProgressPath(cwd);
+    await mkdir(join(path, '..'), { recursive: true });
+    if (!(await fileExists(path))) {
+        await writeFile(path, renderTemplate(initialObjective), 'utf8');
+    }
+    const content = await readFile(path, 'utf8');
+    return { path, content };
+}
+export async function readProgressArtifact(cwd, options) {
+    const { path, content } = await ensureProgressArtifact(cwd);
+    const clipped = truncate(content, options?.maxTokens ?? 300);
+    return {
+        path,
+        text: clipped.text,
+        tokensEstimate: estimateTokens(clipped.text),
+        truncated: clipped.truncated,
+    };
+}
+export async function updateProgressArtifact(cwd, patch) {
+    const { path, content } = await ensureProgressArtifact(cwd);
+    const objective = patch.objective?.trim() || extractObjective(content);
+    const done = mergeSection(extractSection(content, 'Done'), patch.done);
+    const next = mergeSection(extractSection(content, 'Next'), patch.next);
+    const blockers = mergeSection(extractSection(content, 'Blockers'), patch.blockers);
+    const decisions = mergeSection(extractSection(content, 'Decisions'), patch.decisions);
+    const updated = [
+        '# Merlion Progress',
+        '',
+        '## Objective',
+        objective || '(not set)',
+        '',
+        '## Done',
+        ...sectionLines(done),
+        '',
+        '## Next',
+        ...sectionLines(next),
+        '',
+        '## Blockers',
+        ...sectionLines(blockers),
+        '',
+        '## Decisions',
+        ...sectionLines(decisions),
+        '',
+    ].join('\n');
+    await writeFile(path, updated, 'utf8');
+    return { path, content: updated };
+}
+//# sourceMappingURL=progress.js.map

package/dist/artifacts/progress.js.map

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

package/dist/cli/diff.d.ts

@@ -0,0 +1,11 @@
+import type { EditDiffUiPayload } from '../tools/types.js';
+export interface RenderedDiffLine {
+    tone: 'meta' | 'context' | 'add' | 'remove';
+    text: string;
+}
+export declare function renderEditDiffLines(payload: EditDiffUiPayload, options?: {
+    maxLines?: number;
+    maxCharsPerLine?: number;
+}): RenderedDiffLine[];
+export declare function summarizeEditDiff(payload: EditDiffUiPayload): RenderedDiffLine[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/cli/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAG1D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC3C,IAAI,EAAE,MAAM,CAAA;CACb;AASD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,gBAAgB,EAAE,CAmCpB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,EAAE,CAYhF"}

package/dist/cli/diff.js

@@ -0,0 +1,58 @@
+import { sanitizeRenderableText } from "./sanitize.js";
+function clip(text, maxChars) {
+    if (maxChars < 1)
+        return '';
+    if (text.length <= maxChars)
+        return text;
+    if (maxChars === 1)
+        return '…';
+    return `${text.slice(0, maxChars - 1)}…`;
+}
+export function renderEditDiffLines(payload, options) {
+    const maxLines = Math.max(8, options?.maxLines ?? 120);
+    const maxCharsPerLine = Math.max(20, options?.maxCharsPerLine ?? 240);
+    const lines = [
+        {
+            tone: 'meta',
+            text: `diff ${sanitizeRenderableText(payload.path)} (+${payload.addedLines} -${payload.removedLines})`
+        }
+    ];
+    for (const hunk of payload.hunks) {
+        lines.push({
+            tone: 'meta',
+            text: `@@ -${hunk.oldStart},${hunk.oldLines} +${hunk.newStart},${hunk.newLines} @@`
+        });
+        for (const line of hunk.lines) {
+            const prefix = line.type === 'add' ? '+' : line.type === 'remove' ? '-' : ' ';
+            lines.push({
+                tone: line.type,
+                text: `${prefix}${sanitizeRenderableText(line.text)}`
+            });
+        }
+    }
+    const clipped = lines.map((line) => ({
+        tone: line.tone,
+        text: clip(line.text, maxCharsPerLine)
+    }));
+    if (clipped.length <= maxLines)
+        return clipped;
+    const keep = Math.max(2, maxLines - 1);
+    return [
+        ...clipped.slice(0, keep),
+        { tone: 'meta', text: `... diff truncated (${clipped.length - keep} line(s) hidden)` }
+    ];
+}
+export function summarizeEditDiff(payload) {
+    const totalChanged = payload.addedLines + payload.removedLines;
+    return [
+        {
+            tone: 'meta',
+            text: `diff ${sanitizeRenderableText(payload.path)} (+${payload.addedLines} -${payload.removedLines})`
+        },
+        {
+            tone: 'meta',
+            text: `${payload.hunks.length} hunk(s), ${totalChanged} changed line(s)`
+        }
+    ];
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/diff.js.map

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