@pocketcoder/host 0.0.2

package/dist/utils/__tests__/path-sandbox.test.js

@@ -0,0 +1,97 @@
+import { describe, expect, it, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm, mkdir, writeFile, symlink, realpath } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { ErrorCode } from "@pocketcoder/shared/constants";
+import { AppError } from "../../errors/index.js";
+import { validateProjectPath, validateParentPath } from "../path-sandbox.js";
+describe("path-sandbox", () => {
+    let projectRoot;
+    beforeEach(async () => {
+        // Use realpath to get the canonical path (handles macOS /var -> /private/var symlink)
+        const tempDir = await mkdtemp(join(tmpdir(), "pocketcoder-sandbox-test-"));
+        projectRoot = await realpath(tempDir);
+        // Create test directory structure
+        await mkdir(join(projectRoot, "src"), { recursive: true });
+        await mkdir(join(projectRoot, "src", "nested"), { recursive: true });
+        await writeFile(join(projectRoot, "src", "index.ts"), "export {};");
+        await writeFile(join(projectRoot, "src", "nested", "deep.ts"), "export {};");
+    });
+    afterEach(async () => {
+        await rm(projectRoot, { recursive: true, force: true });
+    });
+    describe("validateProjectPath", () => {
+        it("should allow valid relative paths", async () => {
+            const result = await validateProjectPath(projectRoot, "src/index.ts");
+            expect(result).toBe(join(projectRoot, "src", "index.ts"));
+        });
+        it("should allow nested relative paths", async () => {
+            const result = await validateProjectPath(projectRoot, "src/nested/deep.ts");
+            expect(result).toBe(join(projectRoot, "src", "nested", "deep.ts"));
+        });
+        it("should allow the project root itself", async () => {
+            const result = await validateProjectPath(projectRoot, ".");
+            expect(result).toBe(projectRoot);
+        });
+        it("should reject ../.. traversal attempts", async () => {
+            await expect(validateProjectPath(projectRoot, "../../etc/passwd")).rejects.toThrow(AppError);
+            try {
+                await validateProjectPath(projectRoot, "../../etc/passwd");
+            }
+            catch (err) {
+                expect(err).toBeInstanceOf(AppError);
+                expect(err.code).toBe(ErrorCode.OUTSIDE_PROJECT_ROOT);
+            }
+        });
+        it("should reject absolute paths outside project", async () => {
+            await expect(validateProjectPath(projectRoot, "/etc/passwd")).rejects.toThrow(AppError);
+            try {
+                await validateProjectPath(projectRoot, "/etc/passwd");
+            }
+            catch (err) {
+                expect(err).toBeInstanceOf(AppError);
+                expect(err.code).toBe(ErrorCode.OUTSIDE_PROJECT_ROOT);
+            }
+        });
+        it("should reject traversal hidden in middle of path", async () => {
+            await expect(validateProjectPath(projectRoot, "src/../../../etc/passwd")).rejects.toThrow(AppError);
+        });
+        it("should handle symlinks safely - reject symlinks pointing outside", async () => {
+            // Create a symlink that points outside the project
+            const symlinkPath = join(projectRoot, "escape-link");
+            await symlink("/tmp", symlinkPath);
+            await expect(validateProjectPath(projectRoot, "escape-link")).rejects.toThrow(AppError);
+        });
+        it("should allow symlinks pointing within project", async () => {
+            const symlinkPath = join(projectRoot, "link-to-src");
+            await symlink(join(projectRoot, "src"), symlinkPath);
+            const result = await validateProjectPath(projectRoot, "link-to-src");
+            expect(result).toBe(join(projectRoot, "src"));
+        });
+        it("should normalize paths correctly", async () => {
+            const result = await validateProjectPath(projectRoot, "src/../src/index.ts");
+            expect(result).toBe(join(projectRoot, "src", "index.ts"));
+        });
+        it("should handle non-existent files within project", async () => {
+            const result = await validateProjectPath(projectRoot, "does-not-exist.txt");
+            expect(result).toBe(join(projectRoot, "does-not-exist.txt"));
+        });
+    });
+    describe("validateParentPath", () => {
+        it("should allow valid paths for new files", async () => {
+            const result = await validateParentPath(projectRoot, "src/new-file.ts");
+            expect(result).toBe(join(projectRoot, "src", "new-file.ts"));
+        });
+        it("should reject traversal attempts for write paths", async () => {
+            await expect(validateParentPath(projectRoot, "../../escape.txt")).rejects.toThrow(AppError);
+        });
+        it("should reject absolute paths", async () => {
+            await expect(validateParentPath(projectRoot, "/etc/evil.txt")).rejects.toThrow(AppError);
+        });
+        it("should allow deeply nested new paths", async () => {
+            const result = await validateParentPath(projectRoot, "a/b/c/d/new.ts");
+            expect(result).toBe(join(projectRoot, "a", "b", "c", "d", "new.ts"));
+        });
+    });
+});
+//# sourceMappingURL=path-sandbox.test.js.map

package/dist/utils/__tests__/path-sandbox.test.js.map

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

package/dist/utils/__tests__/paths.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=paths.test.d.ts.map

package/dist/utils/__tests__/paths.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/paths.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/paths.test.js

@@ -0,0 +1,87 @@
+import { describe, expect, it, vi, afterEach } from "vitest";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+// We need to mock os.platform() to test cross-platform behavior
+vi.mock("node:os", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        platform: vi.fn(() => actual.platform()),
+    };
+});
+const mockedPlatform = vi.mocked(platform);
+// Dynamic import so mocks are active
+async function importPaths() {
+    vi.resetModules();
+    vi.doMock("node:os", async (importOriginal) => {
+        const actual = await importOriginal();
+        return {
+            ...actual,
+            platform: mockedPlatform,
+        };
+    });
+    return import("../paths.js");
+}
+describe("paths", () => {
+    const home = homedir();
+    const originalAppData = process.env.APPDATA;
+    const originalXdgConfig = process.env.XDG_CONFIG_HOME;
+    afterEach(() => {
+        process.env.APPDATA = originalAppData;
+        process.env.XDG_CONFIG_HOME = originalXdgConfig;
+    });
+    describe("getConfigDir", () => {
+        it("should return correct config dir for macOS", async () => {
+            mockedPlatform.mockReturnValue("darwin");
+            const { getConfigDir } = await importPaths();
+            expect(getConfigDir()).toBe(join(home, "Library", "Application Support", "pocketcoder"));
+        });
+        it("should return correct config dir for Linux", async () => {
+            mockedPlatform.mockReturnValue("linux");
+            delete process.env.XDG_CONFIG_HOME;
+            const { getConfigDir } = await importPaths();
+            expect(getConfigDir()).toBe(join(home, ".config", "pocketcoder"));
+        });
+        it("should return correct config dir for Windows", async () => {
+            mockedPlatform.mockReturnValue("win32");
+            process.env.APPDATA = join(home, "AppData", "Roaming");
+            const { getConfigDir } = await importPaths();
+            expect(getConfigDir()).toBe(join(home, "AppData", "Roaming", "pocketcoder"));
+        });
+        it("should respect XDG_CONFIG_HOME on Linux", async () => {
+            mockedPlatform.mockReturnValue("linux");
+            process.env.XDG_CONFIG_HOME = "/custom/config";
+            const { getConfigDir } = await importPaths();
+            expect(getConfigDir()).toBe(join("/custom/config", "pocketcoder"));
+        });
+    });
+    describe("getAuthPath", () => {
+        it("should return correct auth.json path", async () => {
+            mockedPlatform.mockReturnValue("linux");
+            delete process.env.XDG_CONFIG_HOME;
+            const { getAuthPath } = await importPaths();
+            expect(getAuthPath()).toBe(join(home, ".config", "pocketcoder", "auth.json"));
+        });
+    });
+    describe("getDbPath", () => {
+        it("should return correct daemon.db path", async () => {
+            mockedPlatform.mockReturnValue("linux");
+            delete process.env.XDG_CONFIG_HOME;
+            const { getDbPath } = await importPaths();
+            expect(getDbPath()).toBe(join(home, ".config", "pocketcoder", "daemon.db"));
+        });
+    });
+    describe("getLogDir", () => {
+        it("should return correct log directory path", async () => {
+            const { getLogDir } = await importPaths();
+            expect(getLogDir()).toBe(join(home, ".pocketcoder", "logs"));
+        });
+    });
+    describe("getPidPath", () => {
+        it("should return correct PID file path", async () => {
+            const { getPidPath } = await importPaths();
+            expect(getPidPath()).toBe(join(home, ".pocketcoder", "daemon.pid"));
+        });
+    });
+});
+//# sourceMappingURL=paths.test.js.map

package/dist/utils/__tests__/paths.test.js.map

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

package/dist/utils/__tests__/pid.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pid.test.d.ts.map

package/dist/utils/__tests__/pid.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/pid.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/pid.test.js

@@ -0,0 +1,79 @@
+import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+describe("PID file management", () => {
+    let tempDir;
+    let pidPath;
+    beforeEach(async () => {
+        tempDir = await mkdtemp(join(tmpdir(), "pocketcoder-pid-test-"));
+        pidPath = join(tempDir, "daemon.pid");
+    });
+    afterEach(async () => {
+        vi.restoreAllMocks();
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    async function importPidModule() {
+        vi.resetModules();
+        vi.doMock("../paths.js", () => ({
+            getPidPath: () => pidPath,
+        }));
+        return await import("../pid.js");
+    }
+    it("should write PID file with current process ID", async () => {
+        const { writePidFile } = await importPidModule();
+        await writePidFile();
+        const content = await readFile(pidPath, "utf-8");
+        expect(content.trim()).toBe(String(process.pid));
+    });
+    it("should read PID from file", async () => {
+        const { readPidFile } = await importPidModule();
+        await writeFile(pidPath, "12345");
+        const pid = await readPidFile();
+        expect(pid).toBe(12345);
+    });
+    it("should return null when PID file does not exist", async () => {
+        const { readPidFile } = await importPidModule();
+        const pid = await readPidFile();
+        expect(pid).toBeNull();
+    });
+    it("should remove PID file", async () => {
+        const { writePidFile, removePidFile, readPidFile } = await importPidModule();
+        await writePidFile();
+        await removePidFile();
+        const pid = await readPidFile();
+        expect(pid).toBeNull();
+    });
+    it("should not throw when removing non-existent PID file", async () => {
+        const { removePidFile } = await importPidModule();
+        await expect(removePidFile()).resolves.toBeUndefined();
+    });
+    it("should detect running process by PID", async () => {
+        const { isProcessRunning } = await importPidModule();
+        // Current process should be detected as running
+        expect(isProcessRunning(process.pid)).toBe(true);
+    });
+    it("should return false for non-running process", async () => {
+        const { isProcessRunning } = await importPidModule();
+        // Use a very high PID that is unlikely to be running
+        expect(isProcessRunning(999999)).toBe(false);
+    });
+    it("should detect existing daemon via PID file and running process", async () => {
+        const { writePidFile, checkExistingDaemon } = await importPidModule();
+        await writePidFile();
+        const running = await checkExistingDaemon();
+        expect(running).toBe(true);
+    });
+    it("should return false when PID file references dead process", async () => {
+        const { checkExistingDaemon } = await importPidModule();
+        await writeFile(pidPath, "999999");
+        const running = await checkExistingDaemon();
+        expect(running).toBe(false);
+    });
+    it("should return false when no PID file exists", async () => {
+        const { checkExistingDaemon } = await importPidModule();
+        const running = await checkExistingDaemon();
+        expect(running).toBe(false);
+    });
+});
+//# sourceMappingURL=pid.test.js.map

package/dist/utils/__tests__/pid.test.js.map

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

package/dist/utils/__tests__/validate-project-path.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-project-path.test.d.ts.map

package/dist/utils/__tests__/validate-project-path.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-project-path.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/validate-project-path.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/validate-project-path.test.js

@@ -0,0 +1,178 @@
+import { describe, expect, it, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm, writeFile, symlink, chmod, realpath, mkdir } from "node:fs/promises";
+import { tmpdir, homedir } from "node:os";
+import { join } from "node:path";
+import { ErrorCode } from "@pocketcoder/shared/constants";
+import { AppError } from "../../errors/index.js";
+import { validateProjectPath } from "../validate-project-path.js";
+describe("validate-project-path", () => {
+    let tempDir;
+    let projectDir;
+    beforeEach(async () => {
+        // Use realpath to get the canonical path (handles macOS /var -> /private/var symlink)
+        const rawTempDir = await mkdtemp(join(tmpdir(), "pocketcoder-validate-path-test-"));
+        tempDir = await realpath(rawTempDir);
+        projectDir = join(tempDir, "my-project");
+        await mkdir(projectDir, { recursive: true });
+    });
+    afterEach(async () => {
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    it("should accept a valid project directory path", async () => {
+        const result = await validateProjectPath(projectDir);
+        expect(result).toBe(projectDir);
+    });
+    it("should resolve relative paths to absolute", async () => {
+        const result = await validateProjectPath(projectDir);
+        expect(result).toBe(projectDir);
+        expect(result.startsWith("/")).toBe(true);
+    });
+    it("should reject non-existent paths", async () => {
+        const nonExistent = join(tempDir, "does-not-exist");
+        try {
+            await validateProjectPath(nonExistent);
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.PATH_NOT_FOUND);
+        }
+    });
+    it("should reject file paths (not directories)", async () => {
+        const filePath = join(tempDir, "some-file.txt");
+        await writeFile(filePath, "hello");
+        try {
+            await validateProjectPath(filePath);
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.INVALID_REQUEST);
+            expect(err.message).toContain("not a directory");
+        }
+    });
+    it("should reject empty path", async () => {
+        try {
+            await validateProjectPath("");
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.INVALID_REQUEST);
+            expect(err.message).toContain("cannot be empty");
+        }
+    });
+    it("should reject whitespace-only path", async () => {
+        try {
+            await validateProjectPath("   ");
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.INVALID_REQUEST);
+        }
+    });
+    it("should reject system paths (/etc)", async () => {
+        // Only test on non-Windows
+        if (process.platform === "win32")
+            return;
+        try {
+            await validateProjectPath("/etc");
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.INVALID_REQUEST);
+            expect(err.message).toContain("System paths");
+        }
+    });
+    it("should reject system paths (/usr)", async () => {
+        if (process.platform === "win32")
+            return;
+        try {
+            await validateProjectPath("/usr");
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.INVALID_REQUEST);
+            expect(err.message).toContain("System paths");
+        }
+    });
+    it("should reject subdirectories of system paths (/usr/local)", async () => {
+        if (process.platform === "win32")
+            return;
+        try {
+            await validateProjectPath("/usr/local");
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.INVALID_REQUEST);
+            expect(err.message).toContain("System paths");
+        }
+    });
+    it("should reject the filesystem root", async () => {
+        try {
+            await validateProjectPath("/");
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.INVALID_REQUEST);
+            expect(err.message).toContain("Root directory");
+        }
+    });
+    it("should reject the home directory itself", async () => {
+        try {
+            await validateProjectPath(homedir());
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.INVALID_REQUEST);
+            expect(err.message).toContain("Home directory");
+        }
+    });
+    it("should resolve symlinks and return the real path", async () => {
+        const linkPath = join(tempDir, "link-to-project");
+        await symlink(projectDir, linkPath);
+        const result = await validateProjectPath(linkPath);
+        expect(result).toBe(projectDir);
+    });
+    it("should reject symlinks pointing to non-existent targets", async () => {
+        const linkPath = join(tempDir, "dangling-link");
+        await symlink(join(tempDir, "nonexistent"), linkPath);
+        try {
+            await validateProjectPath(linkPath);
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.PATH_NOT_FOUND);
+        }
+    });
+    it("should reject directories without read permission", async () => {
+        if (process.platform === "win32")
+            return;
+        // Skip if running as root (root can read anything)
+        if (process.getuid?.() === 0)
+            return;
+        const restrictedDir = join(tempDir, "restricted");
+        await mkdir(restrictedDir);
+        await chmod(restrictedDir, 0o000);
+        try {
+            await validateProjectPath(restrictedDir);
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AppError);
+            expect(err.code).toBe(ErrorCode.PERMISSION_DENIED);
+        }
+        finally {
+            // Restore permissions for cleanup
+            await chmod(restrictedDir, 0o755);
+        }
+    });
+});
+//# sourceMappingURL=validate-project-path.test.js.map

package/dist/utils/__tests__/validate-project-path.test.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Ensures the config directory structure exists with proper permissions.
+ * Creates the config directory and logs subdirectory if they don't exist.
+ * On Unix systems, directories are created with 0700 permissions.
+ * This function is idempotent — safe to call multiple times.
+ */
+export declare function ensureConfigDirs(): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD"}

package/dist/utils/config.js

@@ -0,0 +1,16 @@
+import { mkdir } from "node:fs/promises";
+import { platform } from "node:os";
+import { getConfigDir, getLogDir } from "./paths.js";
+/**
+ * Ensures the config directory structure exists with proper permissions.
+ * Creates the config directory and logs subdirectory if they don't exist.
+ * On Unix systems, directories are created with 0700 permissions.
+ * This function is idempotent — safe to call multiple times.
+ */
+export async function ensureConfigDirs() {
+    const mode = platform() === "win32" ? undefined : 0o700;
+    const options = { recursive: true, mode };
+    await mkdir(getConfigDir(), options);
+    await mkdir(getLogDir(), options);
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,IAAI,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAE1C,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/utils/diff.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Simple unified diff generator for Edit tool's old_string / new_string.
+ *
+ * Produces a minimal diff showing removed (-) and added (+) lines.
+ */
+/**
+ * Generate a unified-style diff string from old and new content.
+ * Returns empty string if the strings are identical.
+ */
+export declare function generateDiff(oldString: string, newString: string): string;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgBzE"}

package/dist/utils/diff.js

@@ -0,0 +1,24 @@
+/**
+ * Simple unified diff generator for Edit tool's old_string / new_string.
+ *
+ * Produces a minimal diff showing removed (-) and added (+) lines.
+ */
+/**
+ * Generate a unified-style diff string from old and new content.
+ * Returns empty string if the strings are identical.
+ */
+export function generateDiff(oldString, newString) {
+    if (oldString === newString)
+        return "";
+    const oldLines = oldString.split("\n");
+    const newLines = newString.split("\n");
+    const parts = [];
+    for (const line of oldLines) {
+        parts.push(`-${line}`);
+    }
+    for (const line of newLines) {
+        parts.push(`+${line}`);
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=diff.js.map

package/dist/utils/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,SAAiB;IAC/D,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/filename-validation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Filename validation utilities.
+ * Rejects invalid characters and reserved names (Windows compatibility).
+ */
+/**
+ * Validates a filename (not a path — just the final component).
+ * Throws AppError with INVALID_FILENAME on failure.
+ */
+export declare function validateFilename(filename: string): void;
+//# sourceMappingURL=filename-validation.d.ts.map

package/dist/utils/filename-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename-validation.d.ts","sourceRoot":"","sources":["../../src/utils/filename-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAkBvD"}