@nac3/forge-cli 0.2.0-alpha.4 → 0.2.0-alpha.59z.118

package/dist/chat/tools/audit_consumers.js

@@ -0,0 +1,231 @@
+/**
+ * forge_audit_consumers -- internal Forge tool to prevent
+ * producer/consumer desynchronization (SQ Sec X "Producer/Consumer
+ * Symmetry").
+ *
+ * Forge calls this BEFORE committing any change that touches a
+ * shared data structure (vault slot, JSON key, env var, tool name,
+ * endpoint contract, type / interface name, file format). The tool
+ * does a deterministic grep across src/ + tests/ + docs/ and
+ * returns every location that reads or writes the concept, so
+ * Forge can verify all readers are in sync with the new writer
+ * shape (and, if not, fix them in the same commit).
+ *
+ * This tool is the operational arm of SQ Sec X. Forge is expected
+ * to use it autonomously -- the user is never prompted to interpret
+ * the output; Forge interprets it and acts.
+ *
+ * The grep is pure file-system + glob; no LLM, no external services.
+ * Runs in < 1 second on the Forge tree itself (~10k files).
+ *
+ * Background: on 2026-05-29 the BYOK keys_setup refactor (290db8a)
+ * introduced provider_keys.json as the canonical key writer, but
+ * three downstream readers (chat resolveApiKey, Google STT provider,
+ * Google TTS provider) were not updated in the same commit. Each
+ * was patched independently (alpha.6 -> alpha.7 -> alpha.8). Had
+ * Forge run forge_audit_consumers('anthropic_api_key') and
+ * ('google_stt_key' / 'google_tts_key') before alpha.4 publish,
+ * the desync would have been caught up-front.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+export const AUDIT_CONSUMERS_SPEC = {
+    name: 'forge_audit_consumers',
+    description: 'Enumerate every file in the project that reads OR writes the '
+        + 'given concept (env var name, JSON key, type identifier, tool '
+        + 'name, vault slot, etc). Use this BEFORE any commit that '
+        + 'changes a shared data structure to verify all consumers are '
+        + 'in sync with the new producer shape. Returns hits classified '
+        + 'as write / read / test / doc with file path and line number. '
+        + 'Pure grep, no LLM. Required by SQ Sec X "Producer/Consumer '
+        + 'Symmetry".',
+    input_schema: {
+        type: 'object',
+        properties: {
+            concept: {
+                type: 'string',
+                description: 'The identifier to grep for. Examples: '
+                    + '"anthropic_api_key" / "google_tts_key" / '
+                    + '"forge_git_commit" / "provider_keys.json" / '
+                    + 'an exported type name.',
+            },
+            include_tests: {
+                type: 'boolean',
+                description: 'Include tests/ in the search. Default true.',
+            },
+            include_docs: {
+                type: 'boolean',
+                description: 'Include docs/ in the search. Default true.',
+            },
+            max_hits: {
+                type: 'number',
+                description: 'Cap on hits returned. Default 200. If exceeded, Forge '
+                    + 'should narrow the concept (it may be too generic).',
+            },
+        },
+        required: ['concept'],
+    },
+    requires_approval: false,
+};
+const SCAN_ROOTS = ['src', 'tests', 'docs', 'packages', 'apps'];
+const SKIP_DIRS = new Set([
+    'node_modules', 'dist', 'build', '.git', '.next', '.expo', '.wrangler',
+    'coverage', '.cache', '.vitest', 'android', 'ios', '_deploy_stage',
+]);
+const TEXT_EXTS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.json', '.yml', '.yaml', '.md', '.html', '.css',
+    '.php', '.py', '.sql', '.sh', '.toml', '.env',
+]);
+const WRITE_PATTERNS = [
+    /\bwrite\b/i,
+    /\b(set|put|store|persist|save|insert|create)\b/i,
+    /=\s*$/, // assignment at end of line
+    /:\s*['"`]/, // JSON-like field setting
+];
+const READ_PATTERNS = [
+    /\b(read|get|fetch|load|parse|consume|use)\b/i,
+    /\bif\b.*\b(has|includes|in)\b/i,
+];
+function classifyHit(filePath, snippet) {
+    const lower = filePath.toLowerCase();
+    if (lower.includes('test') || lower.includes('spec'))
+        return 'test';
+    if (lower.startsWith('docs/') || lower.startsWith('docs\\')
+        || lower.endsWith('.md') || lower.endsWith('.html'))
+        return 'doc';
+    for (const re of WRITE_PATTERNS) {
+        if (re.test(snippet))
+            return 'write';
+    }
+    for (const re of READ_PATTERNS) {
+        if (re.test(snippet))
+            return 'read';
+    }
+    return 'unknown';
+}
+async function walkAndSearch(root, rel, needle, out, limit) {
+    if (out.length >= limit)
+        return;
+    let entries;
+    try {
+        entries = await fs.readdir(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (out.length >= limit)
+            return;
+        if (SKIP_DIRS.has(entry.name))
+            continue;
+        const childPath = path.join(root, entry.name);
+        const childRel = rel ? `${rel}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            await walkAndSearch(childPath, childRel, needle, out, limit);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const ext = path.extname(entry.name).toLowerCase();
+        if (!TEXT_EXTS.has(ext))
+            continue;
+        let contents;
+        try {
+            contents = await fs.readFile(childPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        if (!needle.test(contents))
+            continue;
+        needle.lastIndex = 0;
+        const lines = contents.split(/\r?\n/);
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line === undefined)
+                continue;
+            if (!needle.test(line)) {
+                needle.lastIndex = 0;
+                continue;
+            }
+            needle.lastIndex = 0;
+            const snippet = line.length > 200 ? line.slice(0, 200) : line;
+            out.push({
+                file: childRel,
+                line: i + 1,
+                snippet,
+                kind: classifyHit(childRel, snippet),
+            });
+            if (out.length >= limit)
+                return;
+        }
+    }
+}
+/** Build a regex that matches the concept as a whole word.
+ *  Escapes regex metacharacters in the input so the user can
+ *  pass "provider_keys.json" or "forge.X" without issue. */
+function buildNeedle(concept) {
+    const escaped = concept.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    /* Word-boundary-like (\b does not work for things containing
+     *  underscores in modern JS, so use a manual class). */
+    return new RegExp(`(?:^|[^a-zA-Z0-9_])${escaped}(?:$|[^a-zA-Z0-9_])`, 'gm');
+}
+export async function runAuditConsumers(args, ctx) {
+    const concept = String(args.concept || '').trim();
+    if (concept === '') {
+        return {
+            tool: AUDIT_CONSUMERS_SPEC.name,
+            is_error: true,
+            result: { error: 'concept (non-empty string) required' },
+            display: 'bad input',
+        };
+    }
+    const includeTests = args.include_tests !== false;
+    const includeDocs = args.include_docs !== false;
+    const limit = typeof args.max_hits === 'number' && args.max_hits > 0
+        ? Math.floor(args.max_hits) : 200;
+    const needle = buildNeedle(concept);
+    const hits = [];
+    for (const root of SCAN_ROOTS) {
+        if (root === 'tests' && !includeTests)
+            continue;
+        if (root === 'docs' && !includeDocs)
+            continue;
+        const abs = path.join(ctx.projectRoot, root);
+        try {
+            await fs.access(abs);
+        }
+        catch {
+            continue;
+        }
+        await walkAndSearch(abs, root, needle, hits, limit + 1);
+    }
+    const truncated = hits.length > limit;
+    if (truncated)
+        hits.length = limit;
+    const summary = { write: 0, read: 0, test: 0, doc: 0, unknown: 0 };
+    for (const h of hits)
+        summary[h.kind] += 1;
+    const result = {
+        concept,
+        hits,
+        truncated,
+        summary,
+    };
+    const displayParts = [
+        `${hits.length} hit(s) on "${concept}"`,
+        `write=${summary.write} read=${summary.read} test=${summary.test} doc=${summary.doc}`,
+    ];
+    if (truncated)
+        displayParts.push('(truncated)');
+    return {
+        tool: AUDIT_CONSUMERS_SPEC.name,
+        is_error: false,
+        result: result,
+        display: displayParts.join(' / '),
+    };
+}
+//# sourceMappingURL=audit_consumers.js.map

package/dist/chat/tools/audit_consumers.js.map

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

package/dist/chat/tools/fs_editor.d.ts

@@ -0,0 +1,11 @@
+import type { ToolContext, ToolResult } from '../tools.js';
+export declare function runOpenFileForEditor(args: {
+    path?: string;
+    language?: string;
+}, ctx: ToolContext): Promise<ToolResult>;
+export declare function runWriteProjectFile(args: {
+    path?: string;
+    content?: string;
+    create_dirs?: boolean;
+}, ctx: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=fs_editor.d.ts.map

package/dist/chat/tools/fs_editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs_editor.d.ts","sourceRoot":"","sources":["../../../src/chat/tools/fs_editor.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO3D,wBAAsB,oBAAoB,CACxC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAiCrB;AAyBD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,EAChE,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CA0ErB"}

package/dist/chat/tools/fs_editor.js

@@ -0,0 +1,162 @@
+/**
+ * fs_editor.ts -- two legacy handlers that back NAC3 verbs the
+ * panel needs but did NOT exist as Anthropic tools before
+ * alpha.41:
+ *
+ *   - forge_open_file_for_editor (yujin.pizarron.open-file)
+ *       reads a project file from disk + returns a payload
+ *       shaped so the panel can materialise an editor tab.
+ *       Backed by runReadFile (text + binary detection).
+ *
+ *   - forge_write_project_file (yujin.fs.write-project-file)
+ *       writes text content to a project-relative path. Refuses
+ *       absolute paths, ../, and binary content. Atomic write
+ *       through a temp file + rename, parent dirs auto-created
+ *       when create_dirs=true (default).
+ *
+ * These are NEVER registered as Anthropic tools in alpha.41+ --
+ * the only way to reach them is through nac3_invoke -> verb
+ * lookup -> deprecated_alias -> here. That keeps producer/
+ * consumer symmetry: the manifest is the only entry point the
+ * LLM sees.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { runReadFile } from '../tools.js';
+/* ============================================================
+ * forge_open_file_for_editor
+ * ============================================================ */
+export async function runOpenFileForEditor(args, ctx) {
+    const rel = String(args.path ?? '').trim();
+    if (!rel) {
+        return {
+            tool: 'forge_open_file_for_editor',
+            is_error: true,
+            result: { error: 'path is required' },
+            display: 'no path',
+        };
+    }
+    const r = await runReadFile({ path: rel }, ctx);
+    if (r.is_error)
+        return { ...r, tool: 'forge_open_file_for_editor' };
+    const data = r.result;
+    const content = typeof data.content === 'string' ? data.content : '';
+    const item_id = 'pz_' + Date.now().toString(36) + '_' + Math.random().toString(36).slice(2, 6);
+    const lang = (args.language && String(args.language).trim()) || inferLanguage(rel);
+    const title = path.basename(rel).slice(0, 80);
+    return {
+        tool: 'forge_open_file_for_editor',
+        is_error: false,
+        result: {
+            item_id,
+            title,
+            kind: 'code',
+            content,
+            language: lang,
+            file_path: rel,
+            bytes: data.bytes ?? content.length,
+            truncated: Boolean(data.truncated),
+        },
+        display: 'editor <- ' + rel + ' (' + content.length + ' chars)',
+    };
+}
+/** Best-effort language inference from extension. The panel's
+ *  syntax highlighting consumes this; it is a hint, not a
+ *  contract. */
+function inferLanguage(p) {
+    const ext = path.extname(p).toLowerCase();
+    const map = {
+        '.ts': 'typescript', '.tsx': 'typescript', '.js': 'javascript', '.jsx': 'javascript',
+        '.mjs': 'javascript', '.cjs': 'javascript',
+        '.json': 'json', '.html': 'html', '.htm': 'html', '.css': 'css', '.scss': 'scss',
+        '.md': 'markdown', '.mdx': 'markdown',
+        '.py': 'python', '.rb': 'ruby', '.go': 'go', '.rs': 'rust', '.java': 'java',
+        '.kt': 'kotlin', '.swift': 'swift', '.c': 'c', '.cc': 'cpp', '.cpp': 'cpp', '.h': 'c',
+        '.cs': 'csharp', '.php': 'php', '.sh': 'bash', '.bash': 'bash', '.zsh': 'bash',
+        '.ps1': 'powershell', '.yml': 'yaml', '.yaml': 'yaml', '.toml': 'toml',
+        '.xml': 'xml', '.sql': 'sql', '.txt': 'text',
+    };
+    return map[ext] ?? 'text';
+}
+/* ============================================================
+ * forge_write_project_file
+ * ============================================================ */
+export async function runWriteProjectFile(args, ctx) {
+    const rel = String(args.path ?? '').trim();
+    if (!rel) {
+        return {
+            tool: 'forge_write_project_file',
+            is_error: true,
+            result: { error: 'path is required' },
+            display: 'no path',
+        };
+    }
+    if (path.isAbsolute(rel) || rel.split(/[\\/]/).includes('..')) {
+        return {
+            tool: 'forge_write_project_file',
+            is_error: true,
+            result: { error: 'path must be relative and contained within the project root' },
+            display: 'invalid path',
+        };
+    }
+    const content = typeof args.content === 'string' ? args.content : '';
+    /* Refuse binary content based on the same NUL-byte heuristic
+     *  used by runReadFile. The writer is for text only. */
+    if (content.indexOf('\u0000') !== -1) {
+        return {
+            tool: 'forge_write_project_file',
+            is_error: true,
+            result: { error: 'binary content (NUL byte) rejected; writer is text-only' },
+            display: 'binary',
+        };
+    }
+    if (content.length > 1_048_576) {
+        return {
+            tool: 'forge_write_project_file',
+            is_error: true,
+            result: { error: 'content too large (max 1 MB)' },
+            display: 'too large',
+        };
+    }
+    const projAbs = path.resolve(ctx.projectRoot);
+    const full = path.resolve(projAbs, rel);
+    if (!full.startsWith(projAbs + path.sep) && full !== projAbs) {
+        return {
+            tool: 'forge_write_project_file',
+            is_error: true,
+            result: { error: 'path escapes project root after normalisation' },
+            display: 'escape',
+        };
+    }
+    const createDirs = args.create_dirs !== false;
+    try {
+        if (createDirs) {
+            await fs.mkdir(path.dirname(full), { recursive: true });
+        }
+        /* Atomic-ish write: write to tmp + rename. fs.rename is
+         *  atomic on same filesystem. */
+        const tmp = full + '.yftmp.' + process.pid + '.' + Date.now().toString(36);
+        await fs.writeFile(tmp, content, { encoding: 'utf-8', mode: 0o644 });
+        await fs.rename(tmp, full);
+    }
+    catch (err) {
+        return {
+            tool: 'forge_write_project_file',
+            is_error: true,
+            result: { error: err instanceof Error ? err.message : String(err) },
+            display: 'write failed',
+        };
+    }
+    return {
+        tool: 'forge_write_project_file',
+        is_error: false,
+        result: {
+            path: rel,
+            bytes_written: Buffer.byteLength(content, 'utf-8'),
+        },
+        display: 'wrote ' + content.length + ' chars to ' + rel,
+    };
+}
+//# sourceMappingURL=fs_editor.js.map

package/dist/chat/tools/fs_editor.js.map

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

package/dist/chat/tools/git.d.ts

@@ -55,5 +55,29 @@ export declare function runGitLog(args: {
     repo_dir?: string;
     max?: number;
 }, ctx: ToolContext, deps?: GitDeps): Promise<ToolResult>;
+export interface GitDiffArgs {
+    repo_dir?: string;
+    /** Default 'HEAD'. Pass another ref or commit hash. Two refs
+     *  separated by '..' or '...' work too. */
+    ref?: string;
+    /** Limit to a specific path. */
+    path?: string;
+    /** Default false. When true, include just file names + +/-
+     *  stats (no per-line diff). */
+    name_only?: boolean;
+    /** Default 100. Hard-cap on lines returned in diff. */
+    max_lines?: number;
+}
+export declare function runGitDiff(args: GitDiffArgs, ctx: ToolContext, deps?: GitDeps): Promise<ToolResult>;
+export interface GitShowArgs {
+    repo_dir?: string;
+    /** Required. Commit hash, ref name, or HEAD~N. */
+    ref: string;
+    /** Default false. When true, only return commit metadata
+     *  (no diff body). */
+    metadata_only?: boolean;
+    max_lines?: number;
+}
+export declare function runGitShow(args: GitShowArgs, ctx: ToolContext, deps?: GitDeps): Promise<ToolResult>;
 export { VAULT_SLOT };
 //# sourceMappingURL=git.d.ts.map

package/dist/chat/tools/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/chat/tools/git.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI7C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErE,QAAA,MAAM,UAAU,iBAAiB,CAAC;AAIlC,MAAM,MAAM,QAAQ,GAAG,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAAE,KAC9D,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/D,MAAM,WAAW,OAAO;IACtB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AA2CD,eAAO,MAAM,eAAe,EAAE,QAa7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,QAc3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,QAa3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,QAY1B,CAAC;AAMF,wBAAsB,YAAY,CAChC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3D,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CAwCrB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9E,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CAuDrB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7D,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CA0CrB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACzC,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CA6BrB;AASD,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/chat/tools/git.ts"],"names":[],"mappings":"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"}

package/dist/chat/tools/git.js

@@ -65,7 +65,7 @@ async function resolveRepoDir(repoDir, ctx) {
  * Specs
  * ============================================================ */
 export const GIT_COMMIT_SPEC = {
-    name: 'forge.git_commit',
+    name: 'forge_git_commit',
     description: 'Commit staged changes (or all tracked changes with `all`=true) in the given git checkout. Returns the commit hash on success.',
     input_schema: {
         type: 'object',
@@ -79,7 +79,7 @@ export const GIT_COMMIT_SPEC = {
     requires_approval: true,
 };
 export const GIT_PUSH_SPEC = {
-    name: 'forge.git_push',
+    name: 'forge_git_push',
     description: 'Push the current branch to the configured remote. Set `force`=true ONLY for force-push (irreversible -- gated by the V1.10 liveness check).',
     input_schema: {
         type: 'object',
@@ -94,7 +94,7 @@ export const GIT_PUSH_SPEC = {
     requires_approval: true,
 };
 export const GIT_PULL_SPEC = {
-    name: 'forge.git_pull',
+    name: 'forge_git_pull',
     description: 'Pull from the configured remote. Fast-forward only by default.',
     input_schema: {
         type: 'object',
@@ -108,7 +108,7 @@ export const GIT_PULL_SPEC = {
     requires_approval: true,
 };
 export const GIT_LOG_SPEC = {
-    name: 'forge.git_log',
+    name: 'forge_git_log',
     description: 'List the last N commits of the given checkout. Default 10, max 50.',
     input_schema: {
         type: 'object',
@@ -309,5 +309,83 @@ function clampMax(n) {
         return MAX_LOG_ENTRIES;
     return Math.floor(n);
 }
+const DIFF_DEFAULT_LINES = 100;
+const DIFF_MAX_LINES = 2000;
+export async function runGitDiff(args, ctx, deps = {}) {
+    let dir;
+    try {
+        dir = await resolveRepoDir(args.repo_dir, ctx);
+    }
+    catch (err) {
+        return { tool: 'yujin.git.diff', result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'bad repo_dir' };
+    }
+    const exec = deps.execImpl ?? defaultExec();
+    const ref = typeof args.ref === 'string' && args.ref.trim() ? args.ref.trim() : 'HEAD';
+    const max = (() => {
+        const n = typeof args.max_lines === 'number' && Number.isFinite(args.max_lines) ? args.max_lines : DIFF_DEFAULT_LINES;
+        return Math.max(10, Math.min(DIFF_MAX_LINES, Math.floor(n)));
+    })();
+    const cmdArgs = ['diff', '--no-color', ref];
+    if (args.name_only)
+        cmdArgs.push('--name-status');
+    if (typeof args.path === 'string' && args.path.trim()) {
+        cmdArgs.push('--', args.path.trim());
+    }
+    const r = await exec('git', cmdArgs, { cwd: dir });
+    if (r.code !== 0) {
+        return { tool: 'yujin.git.diff', result: { error: 'git diff failed: ' + r.stderr.trim().slice(0, 300) }, is_error: true, display: 'diff failed' };
+    }
+    const lines = r.stdout.split('\n');
+    const truncated = lines.length > max;
+    const out = truncated ? lines.slice(0, max).join('\n') + '\n...truncated (' + (lines.length - max) + ' more lines)' : r.stdout;
+    return {
+        tool: 'yujin.git.diff',
+        result: { repo_dir: dir, ref, name_only: !!args.name_only, diff: out, line_count: lines.length, truncated },
+        display: 'diff ' + ref + ' (' + lines.length + ' lines' + (truncated ? ', truncated' : '') + ')',
+    };
+}
+export async function runGitShow(args, ctx, deps = {}) {
+    if (!args.ref || typeof args.ref !== 'string') {
+        return { tool: 'yujin.git.show', result: { error: 'ref is required' }, is_error: true, display: 'missing ref' };
+    }
+    let dir;
+    try {
+        dir = await resolveRepoDir(args.repo_dir, ctx);
+    }
+    catch (err) {
+        return { tool: 'yujin.git.show', result: { error: err instanceof Error ? err.message : String(err) }, is_error: true, display: 'bad repo_dir' };
+    }
+    const exec = deps.execImpl ?? defaultExec();
+    const max = (() => {
+        const n = typeof args.max_lines === 'number' && Number.isFinite(args.max_lines) ? args.max_lines : DIFF_DEFAULT_LINES;
+        return Math.max(10, Math.min(DIFF_MAX_LINES, Math.floor(n)));
+    })();
+    const ref = args.ref.trim();
+    /* First fetch metadata via a clean format. */
+    const fmt = '%H%n%h%n%an%n%aI%n%s%n%b';
+    const meta = await exec('git', ['show', '--no-patch', '--no-color', '--pretty=format:' + fmt, ref], { cwd: dir });
+    if (meta.code !== 0) {
+        return { tool: 'yujin.git.show', result: { error: 'git show failed: ' + meta.stderr.trim().slice(0, 300) }, is_error: true, display: 'show failed' };
+    }
+    const metaLines = meta.stdout.split('\n');
+    const hash = metaLines[0] || '';
+    const short_hash = metaLines[1] || '';
+    const author = metaLines[2] || '';
+    const date = metaLines[3] || '';
+    const subject = metaLines[4] || '';
+    const body = metaLines.slice(5).join('\n').trim();
+    const result = { repo_dir: dir, ref, hash, short_hash, author, date, subject, body };
+    if (!args.metadata_only) {
+        const diff = await exec('git', ['show', '--no-color', '--format=', ref], { cwd: dir });
+        if (diff.code === 0) {
+            const lines = diff.stdout.split('\n');
+            const truncated = lines.length > max;
+            result.diff = truncated ? lines.slice(0, max).join('\n') + '\n...truncated (' + (lines.length - max) + ' more lines)' : diff.stdout;
+            result.line_count = lines.length;
+            result.truncated = truncated;
+        }
+    }
+    return { tool: 'yujin.git.show', result, display: 'show ' + short_hash + ' ' + subject.slice(0, 60) };
+}
 export { VAULT_SLOT };
 //# sourceMappingURL=git.js.map