localant 1.0.0

package/packages/gateway/dist/managers/coding-agent-manager.d.ts

@@ -0,0 +1,71 @@
+import type { Config } from "@localant/shared";
+import type { GitManager } from "./git-manager.js";
+import type { ProjectRegistry } from "./project-registry.js";
+/**
+ * Drives local AI coding agents (Claude Code, Codex, custom). Plans are
+ * non-mutating; execution requires approval upstream, creates a work branch,
+ * and is followed by validation + diff review.
+ */
+export declare class CodingAgentManager {
+    private readonly config;
+    private readonly projects;
+    private readonly git;
+    private readonly tasks;
+    constructor(config: () => Config, projects: ProjectRegistry, git: GitManager);
+    private agentConfig;
+    private project;
+    list(): Promise<{
+        agent: string;
+        enabled: boolean;
+        available: boolean;
+        command: string;
+    }[]>;
+    status(agent: string): Promise<{
+        agent: string;
+        enabled: boolean;
+        available: boolean;
+        command: string;
+    }>;
+    /** Produce a plan only — no file modification. */
+    plan(agent: string, projectId: string, task: string): Promise<{
+        taskId: string;
+        output: string;
+    }>;
+    /** Start an execution task. Creates a work branch first. */
+    startTask(agent: string, projectId: string, task: string, opts?: {
+        createBranch?: boolean;
+        branchName?: string;
+    }): Promise<{
+        taskId: string;
+        branch?: string;
+        warning?: string;
+    }>;
+    getTask(id: string): {
+        id: string;
+        agent: string;
+        projectId: string;
+        mode: "plan" | "execute";
+        task: string;
+        status: "running" | "completed" | "failed" | "stopped";
+        branch: string | undefined;
+        createdAt: string;
+        finishedAt: string | undefined;
+        exitCode: number | null | undefined;
+    };
+    getLogs(id: string): string;
+    stopTask(id: string): {
+        id: string;
+        stopped: boolean;
+    };
+    continueTask(id: string, task: string): Promise<{
+        taskId: string;
+        branch?: string;
+    }>;
+    getDiff(id: string): Promise<string>;
+    runValidation(projectId: string): Promise<{
+        command: string;
+        code: number | null;
+        output: string;
+    }>;
+}
+//# sourceMappingURL=coding-agent-manager.d.ts.map

package/packages/gateway/dist/managers/coding-agent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-agent-manager.d.ts","sourceRoot":"","sources":["../../src/managers/coding-agent-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAEjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAiB7D;;;;GAIG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;gBAGrC,MAAM,EAAE,MAAM,MAAM,EACpB,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,UAAU;IAGlC,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,OAAO;IAMT,IAAI,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAQ3F,MAAM,CAAC,KAAK,EAAE,MAAM;;;;;;IAK1B,kDAAkD;IAC5C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA8BvG,4DAA4D;IACtD,SAAS,CACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GACzD,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmDjE,OAAO,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;IAiBlB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAM3B,QAAQ,CAAC,EAAE,EAAE,MAAM;;;;IAQb,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAMpF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOpC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAQ1G"}

package/packages/gateway/dist/managers/coding-agent-manager.js

@@ -0,0 +1,179 @@
+import { spawn } from "node:child_process";
+import { nanoid } from "nanoid";
+import { commandExists, execFileSafe } from "../util/exec.js";
+/**
+ * Drives local AI coding agents (Claude Code, Codex, custom). Plans are
+ * non-mutating; execution requires approval upstream, creates a work branch,
+ * and is followed by validation + diff review.
+ */
+export class CodingAgentManager {
+    config;
+    projects;
+    git;
+    tasks = new Map();
+    constructor(config, projects, git) {
+        this.config = config;
+        this.projects = projects;
+        this.git = git;
+    }
+    agentConfig(agent) {
+        const cfg = this.config().codingAgents[agent];
+        if (!cfg)
+            throw new Error(`Unknown coding agent: ${agent}`);
+        return cfg;
+    }
+    project(projectId) {
+        const p = this.projects.get(projectId);
+        if (!p)
+            throw new Error(`Unknown project: ${projectId}. Register it first.`);
+        return p;
+    }
+    async list() {
+        const out = [];
+        for (const [agent, cfg] of Object.entries(this.config().codingAgents)) {
+            out.push({ agent, enabled: cfg.enabled, available: await commandExists(cfg.command), command: cfg.command });
+        }
+        return out;
+    }
+    async status(agent) {
+        const cfg = this.agentConfig(agent);
+        return { agent, enabled: cfg.enabled, available: await commandExists(cfg.command), command: cfg.command };
+    }
+    /** Produce a plan only — no file modification. */
+    async plan(agent, projectId, task) {
+        const cfg = this.agentConfig(agent);
+        if (!cfg.enabled)
+            throw new Error(`Agent '${agent}' is disabled in config.`);
+        if (!(await commandExists(cfg.command))) {
+            throw new Error(`Agent binary '${cfg.command}' not found on PATH.`);
+        }
+        const project = this.project(projectId);
+        const prompt = `You are in PLAN MODE. Do NOT modify files. Produce a concise implementation plan for:\n\n${task}`;
+        const args = [...cfg.args, ...cfg.planArgs, prompt];
+        const res = await execFileSafe(cfg.command, args, {
+            cwd: project.path,
+            timeoutMs: cfg.timeoutMs,
+            maxOutputBytes: 200_000,
+        });
+        const id = nanoid(8);
+        this.tasks.set(id, {
+            id,
+            agent,
+            projectId,
+            mode: "plan",
+            task,
+            status: res.code === 0 ? "completed" : "failed",
+            logs: res.stdout + (res.stderr ? `\n[stderr]\n${res.stderr}` : ""),
+            createdAt: new Date().toISOString(),
+            finishedAt: new Date().toISOString(),
+            exitCode: res.code,
+        });
+        return { taskId: id, output: res.stdout || res.stderr };
+    }
+    /** Start an execution task. Creates a work branch first. */
+    async startTask(agent, projectId, task, opts = {}) {
+        const cfg = this.agentConfig(agent);
+        if (!cfg.enabled)
+            throw new Error(`Agent '${agent}' is disabled in config.`);
+        if (!(await commandExists(cfg.command)))
+            throw new Error(`Agent binary '${cfg.command}' not found on PATH.`);
+        const project = this.project(projectId);
+        let warning;
+        if (await this.git.isDirty(project.path)) {
+            warning = "Working tree was dirty before the task started. Existing changes may be mixed in.";
+        }
+        let branch;
+        if (opts.createBranch !== false) {
+            branch = opts.branchName ?? `cla/${agent}-${Date.now()}`;
+            await this.git.createBranch(project.path, branch);
+        }
+        const id = nanoid(8);
+        const prompt = `Implement the following task. Run tests/validation when done.\n\n${task}`;
+        const args = [...cfg.args, ...cfg.executeArgs, prompt];
+        const child = spawn(cfg.command, args, { cwd: project.path, shell: false });
+        const rec = {
+            id,
+            agent,
+            projectId,
+            mode: "execute",
+            task,
+            status: "running",
+            branch,
+            child,
+            logs: "",
+            createdAt: new Date().toISOString(),
+        };
+        const cap = 500_000;
+        child.stdout?.on("data", (d) => {
+            if (rec.logs.length < cap)
+                rec.logs += d.toString("utf8");
+        });
+        child.stderr?.on("data", (d) => {
+            if (rec.logs.length < cap)
+                rec.logs += d.toString("utf8");
+        });
+        child.on("close", (code) => {
+            rec.exitCode = code;
+            rec.status = code === 0 ? "completed" : "failed";
+            rec.finishedAt = new Date().toISOString();
+        });
+        const timer = setTimeout(() => child.kill("SIGKILL"), cfg.timeoutMs);
+        child.on("close", () => clearTimeout(timer));
+        this.tasks.set(id, rec);
+        return { taskId: id, branch, warning };
+    }
+    getTask(id) {
+        const t = this.tasks.get(id);
+        if (!t)
+            throw new Error(`Task not found: ${id}`);
+        return {
+            id: t.id,
+            agent: t.agent,
+            projectId: t.projectId,
+            mode: t.mode,
+            task: t.task,
+            status: t.status,
+            branch: t.branch,
+            createdAt: t.createdAt,
+            finishedAt: t.finishedAt,
+            exitCode: t.exitCode,
+        };
+    }
+    getLogs(id) {
+        const t = this.tasks.get(id);
+        if (!t)
+            throw new Error(`Task not found: ${id}`);
+        return t.logs;
+    }
+    stopTask(id) {
+        const t = this.tasks.get(id);
+        if (!t)
+            throw new Error(`Task not found: ${id}`);
+        t.child?.kill("SIGTERM");
+        t.status = "stopped";
+        return { id, stopped: true };
+    }
+    async continueTask(id, task) {
+        const t = this.tasks.get(id);
+        if (!t)
+            throw new Error(`Task not found: ${id}`);
+        return this.startTask(t.agent, t.projectId, task, { createBranch: false });
+    }
+    async getDiff(id) {
+        const t = this.tasks.get(id);
+        if (!t)
+            throw new Error(`Task not found: ${id}`);
+        const project = this.project(t.projectId);
+        return this.git.diff(project.path);
+    }
+    async runValidation(projectId) {
+        const project = this.project(projectId);
+        const command = project.validateCommand ?? project.testCommand;
+        if (!command)
+            throw new Error("No validate/test command configured for this project.");
+        const [file, ...args] = command.split(" ");
+        const res = await execFileSafe(file, args, { cwd: project.path, timeoutMs: 300_000, maxOutputBytes: 200_000 });
+        return { command, code: res.code, output: (res.stdout + res.stderr).slice(0, 50_000) };
+    }
+}
+//# sourceMappingURL=coding-agent-manager.js.map

package/packages/gateway/dist/managers/coding-agent-manager.js.map

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

package/packages/gateway/dist/managers/fs-manager.d.ts

@@ -0,0 +1,63 @@
+import type { AppPaths, Config } from "@localant/shared";
+import { PathGuard } from "../security/path-guard.js";
+export interface FileInfo {
+    path: string;
+    size: number;
+    isDirectory: boolean;
+    isSymbolicLink: boolean;
+    modified: string;
+}
+/** Filesystem operations gated by PathGuard, with backups before writes. */
+export declare class FsManager {
+    private readonly guard;
+    private readonly paths;
+    private readonly config;
+    constructor(guard: PathGuard, paths: AppPaths, config: () => Config);
+    private maxSize;
+    listFiles(dir: string): FileInfo[];
+    getInfo(target: string): FileInfo;
+    private assertNotBinaryAndSized;
+    readFile(target: string): string;
+    readRange(target: string, startLine: number, endLine: number): string;
+    searchFiles(dir: string, pattern: string, limit?: number): string[];
+    searchContent(dir: string, query: string, limit?: number): {
+        file: string;
+        line: number;
+        text: string;
+    }[];
+    /** Write a *draft* file (risk 1) — refuses to overwrite existing files. */
+    writeDraft(target: string, content: string): {
+        path: string;
+    };
+    createFile(target: string, content: string, overwrite: boolean): {
+        path: string;
+        backupId?: string;
+    };
+    /** Replace whole-file content with a backup kept (risk 2). */
+    applyPatchWithBackup(target: string, newContent: string): {
+        path: string;
+        backupId: string;
+    };
+    moveFile(from: string, to: string): {
+        from: string;
+        to: string;
+    };
+    deleteFile(target: string): {
+        path: string;
+        backupId: string;
+    };
+    backup(target: string): {
+        id: string;
+        original: string;
+        backupPath: string;
+    };
+    listBackups(): {
+        id: string;
+        original: string;
+        createdAt: string;
+    }[];
+    restoreBackup(id: string): {
+        restored: string;
+    };
+}
+//# sourceMappingURL=fs-manager.d.ts.map

package/packages/gateway/dist/managers/fs-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-manager.d.ts","sourceRoot":"","sources":["../../src/managers/fs-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4EAA4E;AAC5E,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,MAAM;IAGvC,OAAO,CAAC,OAAO;IAIf,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE;IAgBlC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAYjC,OAAO,CAAC,uBAAuB;IAgB/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAMhC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAMrE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,MAAM,EAAE;IAwBhE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAqCtG,2EAA2E;IAC3E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAW7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAYpG,8DAA8D;IAC9D,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAQ5F,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAQhE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAQ9D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAW5E,WAAW,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE;IASpE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;CAWhD"}

package/packages/gateway/dist/managers/fs-manager.js

@@ -0,0 +1,229 @@
+import fs from "node:fs";
+import path from "node:path";
+import { nanoid } from "nanoid";
+/** Filesystem operations gated by PathGuard, with backups before writes. */
+export class FsManager {
+    guard;
+    paths;
+    config;
+    constructor(guard, paths, config) {
+        this.guard = guard;
+        this.paths = paths;
+        this.config = config;
+    }
+    maxSize() {
+        return this.config().security.maxFileSizeBytes;
+    }
+    listFiles(dir) {
+        const resolved = this.guard.assertAccess(dir, "read");
+        const entries = fs.readdirSync(resolved, { withFileTypes: true });
+        return entries.map((e) => {
+            const full = path.join(resolved, e.name);
+            const stat = fs.lstatSync(full);
+            return {
+                path: full,
+                size: stat.size,
+                isDirectory: e.isDirectory(),
+                isSymbolicLink: e.isSymbolicLink(),
+                modified: stat.mtime.toISOString(),
+            };
+        });
+    }
+    getInfo(target) {
+        const resolved = this.guard.assertAccess(target, "read");
+        const stat = fs.lstatSync(resolved);
+        return {
+            path: resolved,
+            size: stat.size,
+            isDirectory: stat.isDirectory(),
+            isSymbolicLink: stat.isSymbolicLink(),
+            modified: stat.mtime.toISOString(),
+        };
+    }
+    assertNotBinaryAndSized(resolved) {
+        const stat = fs.statSync(resolved);
+        if (stat.size > this.maxSize()) {
+            throw new Error(`File too large (${stat.size} bytes > ${this.maxSize()} limit).`);
+        }
+        const fd = fs.openSync(resolved, "r");
+        try {
+            const len = Math.min(8000, stat.size);
+            const buf = Buffer.alloc(len);
+            fs.readSync(fd, buf, 0, len, 0);
+            if (buf.includes(0))
+                throw new Error("Refusing to read binary file (contains NUL bytes).");
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    readFile(target) {
+        const resolved = this.guard.assertAccess(target, "read");
+        this.assertNotBinaryAndSized(resolved);
+        return fs.readFileSync(resolved, "utf8");
+    }
+    readRange(target, startLine, endLine) {
+        const content = this.readFile(target);
+        const lines = content.split("\n");
+        return lines.slice(Math.max(0, startLine - 1), endLine).join("\n");
+    }
+    searchFiles(dir, pattern, limit = 200) {
+        const resolved = this.guard.assertAccess(dir, "read");
+        const rx = globToRegExp(pattern);
+        const out = [];
+        const walk = (d) => {
+            if (out.length >= limit)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(d, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                if (out.length >= limit)
+                    return;
+                if (e.name === "node_modules" || e.name === ".git")
+                    continue;
+                const full = path.join(d, e.name);
+                if (e.isDirectory())
+                    walk(full);
+                else if (rx.test(e.name))
+                    out.push(full);
+            }
+        };
+        walk(resolved);
+        return out;
+    }
+    searchContent(dir, query, limit = 200) {
+        const resolved = this.guard.assertAccess(dir, "read");
+        const results = [];
+        const walk = (d) => {
+            if (results.length >= limit)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(d, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                if (results.length >= limit)
+                    return;
+                if (e.name === "node_modules" || e.name === ".git")
+                    continue;
+                const full = path.join(d, e.name);
+                if (e.isDirectory()) {
+                    walk(full);
+                }
+                else {
+                    try {
+                        const stat = fs.statSync(full);
+                        if (stat.size > this.maxSize())
+                            continue;
+                        const lines = fs.readFileSync(full, "utf8").split("\n");
+                        lines.forEach((text, i) => {
+                            if (results.length < limit && text.includes(query)) {
+                                results.push({ file: full, line: i + 1, text: text.slice(0, 240) });
+                            }
+                        });
+                    }
+                    catch {
+                        /* skip unreadable/binary */
+                    }
+                }
+            }
+        };
+        walk(resolved);
+        return results;
+    }
+    /** Write a *draft* file (risk 1) — refuses to overwrite existing files. */
+    writeDraft(target, content) {
+        const resolved = this.guard.assertAccess(target, "write");
+        if (fs.existsSync(resolved)) {
+            throw new Error(`Draft refused: '${target}' already exists. Use fs_apply_patch_with_backup to modify.`);
+        }
+        if (Buffer.byteLength(content) > this.maxSize())
+            throw new Error("Content exceeds max file size.");
+        fs.mkdirSync(path.dirname(resolved), { recursive: true });
+        fs.writeFileSync(resolved, content);
+        return { path: resolved };
+    }
+    createFile(target, content, overwrite) {
+        const resolved = this.guard.assertAccess(target, "write");
+        let backupId;
+        if (fs.existsSync(resolved)) {
+            if (!overwrite)
+                throw new Error(`File exists: '${target}'. Pass overwrite=true to replace (a backup is kept).`);
+            backupId = this.backup(resolved).id;
+        }
+        fs.mkdirSync(path.dirname(resolved), { recursive: true });
+        fs.writeFileSync(resolved, content);
+        return { path: resolved, ...(backupId ? { backupId } : {}) };
+    }
+    /** Replace whole-file content with a backup kept (risk 2). */
+    applyPatchWithBackup(target, newContent) {
+        const resolved = this.guard.assertAccess(target, "write");
+        if (!fs.existsSync(resolved))
+            throw new Error(`File not found: '${target}'.`);
+        const backup = this.backup(resolved);
+        fs.writeFileSync(resolved, newContent);
+        return { path: resolved, backupId: backup.id };
+    }
+    moveFile(from, to) {
+        const src = this.guard.assertAccess(from, "write");
+        const dst = this.guard.assertAccess(to, "write");
+        fs.mkdirSync(path.dirname(dst), { recursive: true });
+        fs.renameSync(src, dst);
+        return { from: src, to: dst };
+    }
+    deleteFile(target) {
+        const resolved = this.guard.assertAccess(target, "write");
+        if (!fs.existsSync(resolved))
+            throw new Error(`File not found: '${target}'.`);
+        const backup = this.backup(resolved);
+        fs.rmSync(resolved, { recursive: false });
+        return { path: resolved, backupId: backup.id };
+    }
+    backup(target) {
+        const resolved = this.guard.assertAccess(target, "read");
+        const id = `${Date.now()}-${nanoid(6)}`;
+        const backupPath = path.join(this.paths.backupsDir, `${id}__${path.basename(resolved)}`);
+        fs.mkdirSync(this.paths.backupsDir, { recursive: true });
+        fs.copyFileSync(resolved, backupPath);
+        const metaPath = `${backupPath}.meta.json`;
+        fs.writeFileSync(metaPath, JSON.stringify({ id, original: resolved, createdAt: new Date().toISOString() }));
+        return { id, original: resolved, backupPath };
+    }
+    listBackups() {
+        if (!fs.existsSync(this.paths.backupsDir))
+            return [];
+        return fs
+            .readdirSync(this.paths.backupsDir)
+            .filter((f) => f.endsWith(".meta.json"))
+            .map((f) => JSON.parse(fs.readFileSync(path.join(this.paths.backupsDir, f), "utf8")))
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    restoreBackup(id) {
+        const metaFile = fs
+            .readdirSync(this.paths.backupsDir)
+            .find((f) => f.endsWith(".meta.json") && f.startsWith(id + "__") === false && JSON.parse(fs.readFileSync(path.join(this.paths.backupsDir, f), "utf8")).id === id);
+        if (!metaFile)
+            throw new Error(`Backup not found: ${id}`);
+        const meta = JSON.parse(fs.readFileSync(path.join(this.paths.backupsDir, metaFile), "utf8"));
+        const backupPath = path.join(this.paths.backupsDir, metaFile.replace(/\.meta\.json$/, ""));
+        const dst = this.guard.assertAccess(meta.original, "write");
+        fs.copyFileSync(backupPath, dst);
+        return { restored: dst };
+    }
+}
+function globToRegExp(glob) {
+    const escaped = glob
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*/g, ".*")
+        .replace(/\?/g, ".");
+    return new RegExp(`^${escaped}$`, "i");
+}
+//# sourceMappingURL=fs-manager.js.map

package/packages/gateway/dist/managers/fs-manager.js.map

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

package/packages/gateway/dist/managers/git-manager.d.ts

@@ -0,0 +1,21 @@
+import { PathGuard } from "../security/path-guard.js";
+/** Git operations executed via execFile (no shell) inside allowed dirs. */
+export declare class GitManager {
+    private readonly guard;
+    constructor(guard: PathGuard);
+    private git;
+    status(repo: string): Promise<string>;
+    diff(repo: string): Promise<string>;
+    diffFile(repo: string, file: string): Promise<string>;
+    listChangedFiles(repo: string): Promise<string>;
+    branch(repo: string): Promise<string>;
+    log(repo: string, n?: number): Promise<string>;
+    createPatch(repo: string): Promise<string>;
+    createBranch(repo: string, name: string): Promise<string>;
+    checkoutBranch(repo: string, name: string): Promise<string>;
+    commit(repo: string, message: string, addAll: boolean): Promise<string>;
+    restoreFile(repo: string, file: string): Promise<string>;
+    isDirty(repo: string): Promise<boolean>;
+    currentBranch(repo: string): Promise<string>;
+}
+//# sourceMappingURL=git-manager.d.ts.map

package/packages/gateway/dist/managers/git-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-manager.d.ts","sourceRoot":"","sources":["../../src/managers/git-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGtD,2EAA2E;AAC3E,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;YAE/B,GAAG;IASjB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGrD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAG/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGrC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAG1C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGnD"}