@hoangsonw/forge 0.1.0

package/dist/tools/ask-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAG5C,UAAU,IAAI;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CA2EtD,CAAC"}

package/dist/tools/ask-user.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askUserTool = void 0;
+const prompts_1 = __importDefault(require("prompts"));
+const errors_1 = require("../types/errors");
+exports.askUserTool = {
+    schema: {
+        name: 'ask_user',
+        description: 'Ask the user a clarifying question. Use sparingly.',
+        sideEffect: 'pure',
+        risk: 'low',
+        permissionDefault: 'allow',
+        sensitivity: 'low',
+        timeoutMs: 600_000,
+        inputSchema: {
+            type: 'object',
+            required: ['question'],
+            properties: {
+                question: { type: 'string' },
+                choices: { type: 'array', items: { type: 'string' } },
+                defaultValue: { type: 'string' },
+                nonInteractiveDefault: { type: 'string' },
+            },
+        },
+    },
+    async execute(args) {
+        const start = Date.now();
+        if (!process.stdin.isTTY) {
+            if (args.nonInteractiveDefault !== undefined) {
+                return {
+                    success: true,
+                    output: { answer: args.nonInteractiveDefault },
+                    durationMs: Date.now() - start,
+                };
+            }
+            return {
+                success: false,
+                error: {
+                    class: 'user_input',
+                    message: 'ask_user invoked in non-interactive mode with no default.',
+                    retryable: false,
+                },
+                durationMs: Date.now() - start,
+            };
+        }
+        try {
+            let answer = '';
+            if (args.choices && args.choices.length) {
+                const resp = await (0, prompts_1.default)({
+                    type: 'select',
+                    name: 'value',
+                    message: args.question,
+                    choices: args.choices.map((c) => ({ title: c, value: c })),
+                });
+                answer = resp?.value ?? args.defaultValue ?? '';
+            }
+            else {
+                const resp = await (0, prompts_1.default)({
+                    type: 'text',
+                    name: 'value',
+                    message: args.question,
+                    initial: args.defaultValue,
+                });
+                answer = resp?.value ?? args.defaultValue ?? '';
+            }
+            return {
+                success: true,
+                output: { answer },
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: false },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=ask-user.js.map

package/dist/tools/ask-user.js.map

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

package/dist/tools/delete-file.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from '../types';
+interface Args {
+    path: string;
+    recursive?: boolean;
+}
+export declare const deleteFileTool: Tool<Args, {
+    path: string;
+}>;
+export {};
+//# sourceMappingURL=delete-file.d.ts.map

package/dist/tools/delete-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-file.d.ts","sourceRoot":"","sources":["../../src/tools/delete-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAI5C,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAmDvD,CAAC"}

package/dist/tools/delete-file.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteFileTool = void 0;
+const fs = __importStar(require("fs"));
+const errors_1 = require("../types/errors");
+const fs_1 = require("../sandbox/fs");
+exports.deleteFileTool = {
+    schema: {
+        name: 'delete_file',
+        description: 'Delete a file or (with recursive=true) directory inside the sandbox.',
+        sideEffect: 'write',
+        risk: 'high',
+        permissionDefault: 'ask',
+        sensitivity: 'high',
+        timeoutMs: 10_000,
+        inputSchema: {
+            type: 'object',
+            required: ['path'],
+            properties: {
+                path: { type: 'string' },
+                recursive: { type: 'boolean' },
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const start = Date.now();
+        try {
+            const real = (0, fs_1.resolveSafe)(args.path, { projectRoot: ctx.projectRoot }, 'write');
+            if (!fs.existsSync(real)) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'not_found',
+                    message: `path not found: ${args.path}`,
+                    retryable: false,
+                });
+            }
+            const stat = fs.statSync(real);
+            if (stat.isDirectory() && !args.recursive) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'user_input',
+                    message: `path is a directory; pass recursive=true to delete.`,
+                    retryable: false,
+                });
+            }
+            if (stat.isDirectory())
+                fs.rmSync(real, { recursive: true, force: false });
+            else
+                fs.unlinkSync(real);
+            return { success: true, output: { path: args.path }, durationMs: Date.now() - start };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: false },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=delete-file.js.map

package/dist/tools/delete-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-file.js","sourceRoot":"","sources":["../../src/tools/delete-file.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AAEzB,4CAAoD;AACpD,sCAA4C;AAO/B,QAAA,cAAc,GAAiC;IAC1D,MAAM,EAAE;QACN,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sEAAsE;QACnF,UAAU,EAAE,OAAO;QACnB,IAAI,EAAE,MAAM;QACZ,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAC/B;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,gBAAW,EAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;YAC/E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,0BAAiB,CAAC;oBAC1B,KAAK,EAAE,WAAW;oBAClB,OAAO,EAAE,mBAAmB,IAAI,CAAC,IAAI,EAAE;oBACvC,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1C,MAAM,IAAI,0BAAiB,CAAC;oBAC1B,KAAK,EAAE,YAAY;oBACnB,OAAO,EAAE,qDAAqD;oBAC9D,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,EAAE;gBAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;;gBACtE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EACH,GAAG,YAAY,0BAAiB;oBAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE;oBACd,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE;gBACrE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/edit-file.d.ts

@@ -0,0 +1,20 @@
+import { Tool } from '../types';
+interface Args {
+    path: string;
+    oldText: string;
+    newText: string;
+    replaceAll?: boolean;
+    anchor?: 'exact' | 'trimmed';
+}
+interface Output {
+    replacements: number;
+    bytesWritten: number;
+}
+/**
+ * Surgical text replace. Prefer this over rewrites when you only need to
+ * change a specific block — it fails loudly if the target text isn't unique
+ * (unless `replaceAll` is set).
+ */
+export declare const editFileTool: Tool<Args, Output>;
+export {};
+//# sourceMappingURL=edit-file.d.ts.map

package/dist/tools/edit-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file.d.ts","sourceRoot":"","sources":["../../src/tools/edit-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAI5C,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,UAAU,MAAM;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAuE3C,CAAC"}

package/dist/tools/edit-file.js

@@ -0,0 +1,128 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.editFileTool = void 0;
+const fs = __importStar(require("fs"));
+const errors_1 = require("../types/errors");
+const fs_1 = require("../sandbox/fs");
+/**
+ * Surgical text replace. Prefer this over rewrites when you only need to
+ * change a specific block — it fails loudly if the target text isn't unique
+ * (unless `replaceAll` is set).
+ */
+exports.editFileTool = {
+    schema: {
+        name: 'edit_file',
+        description: 'Replace exact text inside a file. Errors if the target text is ambiguous (use replaceAll explicitly).',
+        sideEffect: 'write',
+        risk: 'medium',
+        permissionDefault: 'ask',
+        sensitivity: 'medium',
+        timeoutMs: 15_000,
+        inputSchema: {
+            type: 'object',
+            required: ['path', 'oldText', 'newText'],
+            properties: {
+                path: { type: 'string' },
+                oldText: { type: 'string' },
+                newText: { type: 'string' },
+                replaceAll: { type: 'boolean' },
+                anchor: { type: 'string' },
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const start = Date.now();
+        try {
+            const real = (0, fs_1.resolveSafe)(args.path, { projectRoot: ctx.projectRoot }, 'write');
+            const original = fs.existsSync(real) ? fs.readFileSync(real, 'utf8') : '';
+            const needle = args.oldText;
+            if (!needle) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'user_input',
+                    message: 'edit_file requires non-empty oldText',
+                    retryable: false,
+                });
+            }
+            const occurrences = countOccurrences(original, needle);
+            if (occurrences === 0) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'not_found',
+                    message: `oldText not present in ${args.path}`,
+                    retryable: false,
+                    recoveryHint: 'Use read_file first to verify the exact snippet.',
+                });
+            }
+            if (occurrences > 1 && !args.replaceAll) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'conflict',
+                    message: `oldText matches ${occurrences} occurrences; pass replaceAll=true or narrow the anchor.`,
+                    retryable: false,
+                });
+            }
+            const updated = args.replaceAll
+                ? original.split(needle).join(args.newText)
+                : original.replace(needle, args.newText);
+            fs.writeFileSync(real, updated, 'utf8');
+            return {
+                success: true,
+                output: { replacements: occurrences, bytesWritten: Buffer.byteLength(updated) },
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: false },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+const countOccurrences = (haystack, needle) => {
+    let count = 0;
+    let from = 0;
+    for (;;) {
+        const i = haystack.indexOf(needle, from);
+        if (i < 0)
+            break;
+        count++;
+        from = i + needle.length;
+    }
+    return count;
+};
+//# sourceMappingURL=edit-file.js.map

package/dist/tools/edit-file.js.map

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

package/dist/tools/format.d.ts

@@ -0,0 +1,5 @@
+export declare const formatTouchedFiles: (projectRoot: string, files: string[]) => Promise<{
+    formatted: number;
+    skipped: number;
+}>;
+//# sourceMappingURL=format.d.ts.map

package/dist/tools/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/tools/format.ts"],"names":[],"mappings":"AAkEA,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,EACnB,OAAO,MAAM,EAAE,KACd,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA+BhD,CAAC"}

package/dist/tools/format.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTouchedFiles = void 0;
+/**
+ * Post-edit code formatter. Runs the project's preferred formatter against
+ * the touched files after successful plan steps. Non-blocking: formatter
+ * failure is logged but doesn't fail the task.
+ */
+const path = __importStar(require("path"));
+const shell_1 = require("../sandbox/shell");
+const logger_1 = require("../logging/logger");
+const RULES = [
+    {
+        extensions: [
+            '.ts',
+            '.tsx',
+            '.js',
+            '.jsx',
+            '.mjs',
+            '.cjs',
+            '.json',
+            '.md',
+            '.yaml',
+            '.yml',
+            '.css',
+        ],
+        probe: 'node_modules/.bin/prettier',
+        format: (files) => `./node_modules/.bin/prettier --write ${files.map(q).join(' ')}`,
+    },
+    {
+        extensions: ['.py'],
+        probe: 'command -v black',
+        format: (files) => `black -q ${files.map(q).join(' ')}`,
+    },
+    {
+        extensions: ['.py'],
+        probe: 'command -v ruff',
+        format: (files) => `ruff format ${files.map(q).join(' ')}`,
+    },
+    {
+        extensions: ['.go'],
+        probe: 'command -v gofmt',
+        format: (files) => `gofmt -w ${files.map(q).join(' ')}`,
+    },
+    {
+        extensions: ['.rs'],
+        probe: 'command -v rustfmt',
+        format: (files) => `rustfmt ${files.map(q).join(' ')}`,
+    },
+];
+const q = (s) => `'${s.replace(/'/g, `'\\''`)}'`;
+const hasProbe = async (cwd, probe) => {
+    try {
+        const r = await (0, shell_1.runCommand)(probe, { cwd, timeoutMs: 3000 });
+        return r.exitCode === 0;
+    }
+    catch {
+        return false;
+    }
+};
+const formatTouchedFiles = async (projectRoot, files) => {
+    if (!files.length)
+        return { formatted: 0, skipped: 0 };
+    let formatted = 0;
+    let skipped = 0;
+    const groups = new Map();
+    for (const f of files) {
+        const ext = path.extname(f).toLowerCase();
+        const rule = RULES.find((r) => r.extensions.includes(ext));
+        if (!rule) {
+            skipped++;
+            continue;
+        }
+        groups.set(rule, [...(groups.get(rule) ?? []), f]);
+    }
+    for (const [rule, batch] of groups) {
+        if (!(await hasProbe(projectRoot, rule.probe))) {
+            skipped += batch.length;
+            continue;
+        }
+        try {
+            const res = await (0, shell_1.runCommand)(rule.format(batch), {
+                cwd: projectRoot,
+                timeoutMs: 60_000,
+            });
+            if (res.exitCode === 0)
+                formatted += batch.length;
+            else
+                logger_1.log.debug('formatter non-zero exit', { stderr: res.stderr.slice(0, 200) });
+        }
+        catch (err) {
+            logger_1.log.debug('formatter skipped', { err: String(err) });
+        }
+    }
+    return { formatted, skipped };
+};
+exports.formatTouchedFiles = formatTouchedFiles;
+//# sourceMappingURL=format.js.map

package/dist/tools/format.js.map

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

package/dist/tools/git.d.ts

@@ -0,0 +1,24 @@
+import { Tool } from '../types';
+interface StatusArgs {
+    porcelain?: boolean;
+}
+interface DiffArgs {
+    staged?: boolean;
+    path?: string;
+}
+interface BranchArgs {
+    name: string;
+    create?: boolean;
+}
+export declare const gitStatusTool: Tool<StatusArgs, {
+    output: string;
+}>;
+export declare const gitDiffTool: Tool<DiffArgs, {
+    diff: string;
+}>;
+export declare const gitBranchTool: Tool<BranchArgs, {
+    branch: string;
+    created: boolean;
+}>;
+export {};
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/tools/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAI5C,UAAU,UAAU;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,QAAQ;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAgC9D,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAmCxD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA6ChF,CAAC"}