@polka-codes/cli 0.0.4 → 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export declare const configSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        description: string;
+    }, {
+        command: string;
+        description: string;
+    }>]>>>;
+    rules: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodArray<z.ZodString, "many">>, z.ZodString]>>;
+}, "strict", z.ZodTypeAny, {
+    provider?: string | undefined;
+    apiKey?: string | undefined;
+    model?: string | undefined;
+    commands?: Record<string, string | {
+        command: string;
+        description: string;
+    }> | undefined;
+    rules?: string | string[] | undefined;
+}, {
+    provider?: string | undefined;
+    apiKey?: string | undefined;
+    model?: string | undefined;
+    commands?: Record<string, string | {
+        command: string;
+        description: string;
+    }> | undefined;
+    rules?: string | string[] | undefined;
+}>;
+export type Config = z.infer<typeof configSchema>;
+export declare function loadConfig(path?: string, cwd?: string): Config | undefined;

package/dist/config.js

@@ -0,0 +1,44 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse } from 'yaml';
+import { ZodError, z } from 'zod';
+import { createServiceLogger } from '@polka-codes/core';
+const logger = createServiceLogger('cli/config');
+export const configSchema = z
+    .object({
+    provider: z.string().optional(),
+    apiKey: z.string().optional(),
+    model: z.string().optional(),
+    commands: z.record(z.string(), z.string().or(z.object({ command: z.string(), description: z.string() }))).optional(),
+    rules: z.array(z.string()).optional().or(z.string()).optional(),
+})
+    .strict();
+export function loadConfig(path, cwd = process.cwd()) {
+    if (path) {
+        try {
+            return readConfig(path);
+        }
+        catch (error) {
+            logger.error(`Error loading config file: ${path}\n${error}`);
+            process.exit(1);
+        }
+    }
+    const configPaths = [join(cwd, '.polkacodes.yml'), join(cwd, '.polkacodes.yaml')];
+    for (const path of configPaths) {
+        try {
+            return readConfig(path);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                logger.error(`Error in config file: ${path}\n${error}`);
+                process.exit(1);
+            }
+        }
+    }
+}
+const readConfig = (path) => {
+    const file = readFileSync(path, 'utf8');
+    const config = parse(file);
+    return configSchema.parse(config);
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAEvD,MAAM,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAA;AAEhD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpH,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAChE,CAAC;KACD,MAAM,EAAE,CAAA;AAIX,MAAM,UAAU,UAAU,CAAC,IAAa,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACnE,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,IAAI,KAAK,KAAK,EAAE,CAAC,CAAA;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAEjF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,yBAAyB,IAAI,KAAK,KAAK,EAAE,CAAC,CAAA;gBACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC,CAAA"}

package/dist/config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/config.test.js

@@ -0,0 +1,87 @@
+import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, test } from 'bun:test';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { loadConfig } from './config';
+describe('config', () => {
+    let testDir;
+    let testSubDir;
+    beforeAll(() => {
+        testDir = mkdtempSync(join(tmpdir(), 'polkacodes-test-'));
+    });
+    beforeEach(() => {
+        testSubDir = mkdtempSync(join(testDir, 'test-'));
+    });
+    afterEach(() => {
+        rmSync(testSubDir, { recursive: true, force: true });
+    });
+    afterAll(() => {
+        rmSync(testDir, { recursive: true, force: true });
+    });
+    test('loads config from specified path', () => {
+        const configPath = join(testSubDir, 'test-config.yml');
+        writeFileSync(configPath, `
+provider: anthropic
+apiKey: test-key
+model: claude-3-opus
+    `);
+        const config = loadConfig(configPath, testSubDir);
+        expect(config).toEqual({
+            provider: 'anthropic',
+            apiKey: 'test-key',
+            model: 'claude-3-opus',
+        });
+    });
+    test('loads config from default paths', () => {
+        const configPath = join(testSubDir, '.polkacodes.yml');
+        writeFileSync(configPath, `
+provider: deepseek
+apiKey: test-key-2
+model: deepseek-chat
+    `);
+        const config = loadConfig(undefined, testSubDir);
+        expect(config).toEqual({
+            provider: 'deepseek',
+            apiKey: 'test-key-2',
+            model: 'deepseek-chat',
+        });
+        // Clean up
+        writeFileSync(configPath, '');
+    });
+    test('validates config schema', () => {
+        const configPath = join(testSubDir, 'invalid-config.yml');
+        writeFileSync(configPath, `
+invalidKey: value
+    `);
+        expect(() => loadConfig(configPath, testSubDir)).toThrow();
+    });
+    test('handles commands configuration', () => {
+        const configPath = join(testSubDir, 'commands-config.yml');
+        writeFileSync(configPath, `
+commands:
+  test: echo "test"
+  complex:
+    command: echo "complex"
+    description: A complex command
+    `);
+        const config = loadConfig(configPath, testSubDir);
+        expect(config?.commands).toEqual({
+            test: 'echo "test"',
+            complex: {
+                command: 'echo "complex"',
+                description: 'A complex command',
+            },
+        });
+    });
+    test('handles rules configuration', () => {
+        const configPath = join(testSubDir, 'rules-config.yml');
+        writeFileSync(configPath, `
+rules:
+  - rule1
+  - rule2
+    `);
+        const config = loadConfig(configPath, testSubDir);
+        expect(config?.rules).toEqual(['rule1', 'rule2']);
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/config.test.js.map

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

package/dist/handlers.d.ts

@@ -0,0 +1,14 @@
+import { type ChildProcessWithoutNullStreams } from 'node:child_process';
+import { type ToolHandler } from '@polka-codes/core';
+export type ToolHandlerOptions = {
+    executeCommand?: {
+        shouldExecute?: (command: string) => Promise<boolean>;
+        shouldApprove?: (command: string) => Promise<boolean>;
+        commandStarted?: (command: string, child: ChildProcessWithoutNullStreams) => void;
+    };
+    files?: {
+        isPathAllowed?: (path: string) => Promise<boolean>;
+        cwd?: string;
+    };
+};
+export declare const getToolHandler: (options: ToolHandlerOptions) => ToolHandler;

package/dist/handlers.js

@@ -0,0 +1,239 @@
+import { spawn } from 'node:child_process';
+import { readFile, writeFile } from 'node:fs/promises';
+import { ToolResponseType, allTools, createServiceLogger } from '@polka-codes/core';
+import { listFiles } from './utils/listFiles';
+import { replaceInFile } from './utils/replaceInFile';
+const logger = createServiceLogger('cli/handlers');
+const handleError = async (name, fn) => {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        logger.warn(error, `Error executing tool: ${name}`);
+        return {
+            type: ToolResponseType.Error,
+            message: `Error executing tool: ${name}
+Error: ${error}`,
+            canRetry: false,
+        };
+    }
+};
+const getString = (args, name, defaultValue) => {
+    const ret = args[name] ?? defaultValue;
+    if (!ret) {
+        throw new Error(`Missing required argument: ${name}`);
+    }
+    return ret;
+};
+const getBoolean = (args, name, defaultValue) => {
+    const ret = args[name];
+    if (!ret) {
+        if (defaultValue === undefined) {
+            throw new Error(`Missing required argument: ${name}`);
+        }
+        return defaultValue;
+    }
+    switch (ret.toLowerCase()) {
+        case 'true':
+            return true;
+        case 'false':
+            return false;
+        default:
+            throw new Error(`Invalid argument value: ${name}`);
+    }
+};
+const getInt = (args, name, defaultValue) => {
+    const ret = args[name];
+    if (!ret) {
+        if (defaultValue === undefined) {
+            throw new Error(`Missing required argument: ${name}`);
+        }
+        return defaultValue;
+    }
+    const parsed = Number.parseInt(ret);
+    if (Number.isNaN(parsed)) {
+        throw new Error(`Invalid argument value: ${name}`);
+    }
+    return parsed;
+};
+const handlers = {
+    executeCommand: async (options, args) => {
+        const command = getString(args, 'command');
+        const shouldExecute = (await options.executeCommand?.shouldExecute?.(command)) ?? true;
+        if (!shouldExecute) {
+            return {
+                type: ToolResponseType.Invalid,
+                message: `<command>${command}</command><command_rejected>Rejected by policy</command_rejected>`,
+            };
+        }
+        const requiresApproval = getBoolean(args, 'requires_approval', false);
+        if (requiresApproval) {
+            const shouldApprove = await options.executeCommand?.shouldApprove?.(command);
+            if (!shouldApprove) {
+                return {
+                    type: ToolResponseType.Invalid,
+                    message: `<command>${command}</command><command_rejected>Rejected by policy</command_rejected>`,
+                };
+            }
+        }
+        // TODO: add timeout
+        return new Promise((resolve, reject) => {
+            // spawn a shell to execute the command
+            logger.trace(`Executing command: ${command}`);
+            const child = spawn(command, [], {
+                shell: true,
+                stdio: 'pipe',
+            });
+            options.executeCommand?.commandStarted?.(command, child);
+            let stdoutText = '';
+            let stderrText = '';
+            child.stdout.on('data', (data) => {
+                stdoutText += data.toString();
+            });
+            child.stderr.on('data', (data) => {
+                stderrText += data.toString();
+            });
+            child.on('close', (code) => {
+                const message = `<command>${command}</command>
+<command_exit_code>${code}</command_exit_code>
+<command_stdout>
+${stdoutText}
+</command_stdout>
+<command_stderr>
+${stderrText}
+</command_stderr>
+`;
+                if (code === 0) {
+                    resolve({
+                        type: ToolResponseType.Reply,
+                        message,
+                    });
+                }
+                else {
+                    resolve({
+                        type: ToolResponseType.Error,
+                        message,
+                    });
+                }
+            });
+            child.on('error', (err) => {
+                reject(err);
+            });
+        });
+    },
+    readFile: async (options, args) => {
+        const path = getString(args, 'path');
+        const isPathAllowed = (await options.files?.isPathAllowed?.(path)) ?? true;
+        if (!isPathAllowed) {
+            return {
+                type: ToolResponseType.Invalid,
+                message: `<path>${path}</path><path_rejected>Rejected by policy</path_rejected>`,
+            };
+        }
+        const fileContent = await readFile(path, 'utf8');
+        return {
+            type: ToolResponseType.Reply,
+            message: `<read_file_path>${path}</read_file_path>
+<read_file_file_content>${fileContent}</read_file_file_content>`,
+        };
+    },
+    writeToFile: async (options, args) => {
+        const path = getString(args, 'path');
+        const content = getString(args, 'content');
+        const isPathAllowed = (await options.files?.isPathAllowed?.(path)) ?? true;
+        if (!isPathAllowed) {
+            return {
+                type: ToolResponseType.Invalid,
+                message: `<path>${path}</path><path_rejected>Rejected by policy</path_rejected>`,
+            };
+        }
+        await writeFile(path, content, 'utf8');
+        return {
+            type: ToolResponseType.Reply,
+            message: `<write_file_path>${path}</write_file_path><status>Success</status>`,
+        };
+    },
+    replaceInFile: async (options, args) => {
+        const path = getString(args, 'path');
+        const diff = getString(args, 'diff');
+        const isPathAllowed = (await options.files?.isPathAllowed?.(path)) ?? true;
+        if (!isPathAllowed) {
+            return {
+                type: ToolResponseType.Invalid,
+                message: `<path>${path}</path><path_rejected>Rejected by policy</path_rejected>`,
+            };
+        }
+        const fileContent = await readFile(path, 'utf8');
+        const result = await replaceInFile(fileContent, diff);
+        await writeFile(path, result, 'utf8');
+        return {
+            type: ToolResponseType.Reply,
+            message: `<replace_in_file_path>${path}</replace_in_file_path>`,
+        };
+    },
+    searchFiles: async (options, args) => {
+        // TODO
+        return {
+            type: ToolResponseType.Exit,
+            message: 'Files searched successfully',
+        };
+    },
+    listFiles: async (options, args) => {
+        const path = getString(args, 'path');
+        const depth = getInt(args, 'depth', 5);
+        const isPathAllowed = (await options.files?.isPathAllowed?.(path)) ?? true;
+        if (!isPathAllowed) {
+            return {
+                type: ToolResponseType.Invalid,
+                message: `<path>${path}</path><path_rejected>Rejected by policy</path_rejected>`,
+            };
+        }
+        const recursive = depth > 0;
+        const [files, limitReached] = await listFiles(path, recursive, depth, options.files?.cwd ?? process.cwd());
+        return {
+            type: ToolResponseType.Reply,
+            message: `<list_files_path>${path}</list_files_path>
+<list_files_depth>${depth}</list_files_depth>
+<list_files_files>
+${files.join('\n')}
+</list_files_files>
+<list_files_truncated>${limitReached}</list_files_truncated>`,
+        };
+    },
+    listCodeDefinitionNames: async (options, args) => {
+        // TODO
+        return {
+            type: ToolResponseType.Exit,
+            message: 'Code definition names listed successfully',
+        };
+    },
+    askFollowupQuestion: async (options, args) => {
+        // TODO
+        return {
+            type: ToolResponseType.Exit,
+            message: 'Followup question asked successfully',
+        };
+    },
+    attemptCompletion: async (options, args) => {
+        return {
+            type: ToolResponseType.Exit,
+            message: '<completed>true</completed>',
+        };
+    },
+};
+const processedHandlers = Object.fromEntries(Object.entries(handlers).map(([toolName, handler]) => {
+    return [
+        allTools[toolName].name,
+        async (options, args) => handleError(toolName, async () => handler(options, args)),
+    ];
+}));
+export const getToolHandler = (options) => {
+    return async (toolName, args) => {
+        const handler = processedHandlers[toolName];
+        if (!handler) {
+            throw new Error(`Unknown tool: ${toolName}`);
+        }
+        return handler(options, args);
+    };
+};
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

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

package/dist/index.d.ts

@@ -1,2 +1 @@
-#!/usr/bin/env node
 export {};

package/dist/index.js

@@ -1,17 +1,30 @@
-#!/usr/bin/env node
-import { PolkaCore, VERSION } from '@polka-codes/core';
 import { Command } from 'commander';
+import { createServiceLogger } from '@polka-codes/core';
+import { version } from '../package.json';
+import { loadConfig } from './config';
+import { runTask } from './runTask';
+const logger = createServiceLogger('cli');
 const program = new Command();
-program.name('polka').description('Polka Codes CLI').version(VERSION);
+program.name('polka').description('Polka Codes CLI').version(version);
+// Main command for executing tasks
 program
-    .command('init')
-    .description('Initialize a new Polka project')
-    .action(() => {
-    const core = new PolkaCore({
-        name: 'polka-project',
-        version: '0.0.1',
+    .argument('[task]', 'The task to execute')
+    .option('-c --config <path>', 'Path to config file')
+    .option('--api-provider <provider>', 'API provider')
+    .option('--model-id <model>', 'Model ID')
+    .option('--api-key <key>', 'API key')
+    .action(async (taskArg, options) => {
+    const config = loadConfig(options.config ?? options.c) ?? {};
+    const provider = options.apiProvider || process.env.POLKA_API_PROVIDER || config.provider || 'anthropic';
+    const model = options.modelId || process.env.POLKA_MODEL_ID || config.model;
+    const apiKey = options.apiKey || process.env.POLKA_API_KEY || config.apiKey;
+    await runTask({
+        task: taskArg,
+        provider,
+        model,
+        apiKey,
+        config,
     });
-    console.log('Initialized project with config:', core.getConfig());
 });
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAErE,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,GAAG,EAAE;IACX,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC;QACzB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;AACnE,CAAC,CAAC,CAAA;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;AAEzC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAErE,mCAAmC;AACnC,OAAO;KACJ,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;KACzC,MAAM,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;KACnD,MAAM,CAAC,2BAA2B,EAAE,cAAc,CAAC;KACnD,MAAM,CAAC,oBAAoB,EAAE,UAAU,CAAC;KACxC,MAAM,CAAC,iBAAiB,EAAE,SAAS,CAAC;KACpC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;IACjC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAE5D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,CAAC,QAAQ,IAAI,WAAW,CAAA;IAExG,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,CAAC,KAAK,CAAA;IAE3E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,CAAA;IAE3E,MAAM,OAAO,CAAC;QACZ,IAAI,EAAE,OAAO;QACb,QAAQ;QACR,KAAK;QACL,MAAM;QACN,MAAM;KACP,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/listFiles.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Lists files under `dirPath` in BFS order, respecting:
+ *   - A default set of ignores
+ *   - A root .gitignore under `cwd`
+ *   - Any .gitignore files in child directories (merged as we go)
+ *
+ * Returns `[files, limitReached]`:
+ *   - `files` is the array of file paths (relative to `cwd`)
+ *   - `limitReached` is `true` if `maxCount` was hit, otherwise `false`
+ */
+export declare function listFiles(dirPath: string, recursive: boolean, maxCount: number, cwd: string): Promise<[string[], boolean]>;

package/dist/listFiles.js

@@ -0,0 +1,100 @@
+import { promises as fs } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+import ignore from 'ignore';
+/** Default patterns commonly ignored in projects of various languages. */
+const DEFAULT_IGNORES = [
+    '__pycache__',
+    '.DS_Store',
+    '.env',
+    '.git',
+    '.idea',
+    '.svn',
+    '.temp',
+    '.vscode',
+    'coverage',
+    'dist',
+    'node_modules',
+    'out',
+    'Thumbs.db',
+];
+/**
+ * Reads a `.gitignore` file in `dirPath` (if it exists) and appends its lines
+ * to the `basePatterns`. Returns a new array without mutating the original.
+ */
+async function extendPatterns(basePatterns, dirPath) {
+    try {
+        const gitignorePath = join(dirPath, '.gitignore');
+        const content = await fs.readFile(gitignorePath, 'utf8');
+        const lines = content.split(/\r?\n/).filter(Boolean);
+        return [...basePatterns, ...lines];
+    }
+    catch {
+        // No .gitignore or unreadable
+        return basePatterns;
+    }
+}
+/** Creates an `ignore` instance from the given patterns. */
+function createIgnore(patterns) {
+    return ignore().add(patterns);
+}
+/**
+ * Lists files under `dirPath` in BFS order, respecting:
+ *   - A default set of ignores
+ *   - A root .gitignore under `cwd`
+ *   - Any .gitignore files in child directories (merged as we go)
+ *
+ * Returns `[files, limitReached]`:
+ *   - `files` is the array of file paths (relative to `cwd`)
+ *   - `limitReached` is `true` if `maxCount` was hit, otherwise `false`
+ */
+export async function listFiles(dirPath, recursive, maxCount, cwd) {
+    // Merge default ignores with root .gitignore (if found)
+    let rootPatterns = [...DEFAULT_IGNORES];
+    try {
+        const rootGitignore = await fs.readFile(join(cwd, '.gitignore'), 'utf8');
+        const lines = rootGitignore.split(/\r?\n/).filter(Boolean);
+        rootPatterns = [...rootPatterns, ...lines];
+    }
+    catch {
+        // No .gitignore at root or unreadable; ignore silently
+    }
+    // Final results (relative to `cwd`) and indicator if we reached the limit
+    const results = [];
+    // BFS queue
+    // Each entry holds the directory path and the patterns inherited from its parent
+    const queue = [{ path: resolve(dirPath), patterns: rootPatterns }];
+    // Perform BFS until queue is empty or maxCount is reached
+    while (queue.length > 0) {
+        // biome-ignore lint/style/noNonNullAssertion: checked above
+        const { path: currentPath, patterns: parentPatterns } = queue.shift();
+        // Merge parent's patterns with local .gitignore
+        const mergedPatterns = await extendPatterns(parentPatterns, currentPath);
+        const folderIg = createIgnore(mergedPatterns);
+        const entries = await fs.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(currentPath, entry.name);
+            // Convert full path to something relative to `cwd`
+            const relPath = relative(cwd, fullPath).replace(/\\/g, '/');
+            if (folderIg.ignores(relPath)) {
+                continue; // Skip ignored entries
+            }
+            if (entry.isDirectory()) {
+                if (recursive) {
+                    queue.push({ path: fullPath, patterns: mergedPatterns });
+                }
+            }
+            else {
+                results.push(relPath);
+                if (results.length >= maxCount) {
+                    results.sort();
+                    // Stop searching as soon as we reach maxCount
+                    return [results, true];
+                }
+            }
+        }
+    }
+    results.sort();
+    // If we exhaust the BFS queue, we did not reach maxCount
+    return [results, false];
+}
+//# sourceMappingURL=listFiles.js.map

package/dist/listFiles.js.map

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

package/dist/listFiles.test.d.ts

@@ -0,0 +1 @@
+export {};