@hoangsonw/forge 0.1.0

package/dist/persistence/conversation-store.js

@@ -0,0 +1,370 @@
+"use strict";
+/**
+ * Concurrency-safe JSONL store for conversation files.
+ *
+ * Shared between the CLI REPL and the UI chat surfaces so multiple writers
+ * (multiple terminals, multiple browser tabs, a browser tab + a CLI REPL,
+ * tasks spawned by subagents, etc.) can safely append to the same file and
+ * observe each other's writes in near real-time.
+ *
+ * Safety model:
+ *   • Appends under PIPE_BUF (4 KiB on Linux/macOS) are guaranteed atomic by
+ *     POSIX O_APPEND: the kernel updates the offset and writes the bytes as
+ *     one operation, so interleaved writers never corrupt each other's lines.
+ *   • Larger lines acquire a cooperative lock (mkdir-based, works across
+ *     processes) before appending.
+ *   • Readers never acquire locks. They open, read-to-EOF, split on '\n',
+ *     and skip malformed lines. A writer half-way through writing produces
+ *     at worst a trailing line without '\n' that is skipped until the next
+ *     read.
+ *   • Stale locks (process crashed with lock held) are detected by mtime and
+ *     recovered automatically.
+ *
+ * The module has no knowledge of domain types — it deals in strings and
+ * `Record<string, unknown>` events. Domain typing lives in
+ * src/core/conversation.ts.
+ */
+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.fileSize = exports.watchConversation = exports.readSince = exports.readAllLines = exports.atomicAppendLineSync = exports.atomicAppendLine = exports.acquireLock = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ---------- Constants ----------
+/** POSIX atomic write size (PIPE_BUF). Lines up to this many bytes can be
+ * appended without a lock; larger lines take the lock path. */
+const ATOMIC_APPEND_LIMIT = 4096;
+/** Default lock acquisition timeout. After this, we assume the lock is stale. */
+const LOCK_TIMEOUT_MS = 5_000;
+/** Debounce window for the watcher so a burst of appends coalesces. */
+const WATCH_DEBOUNCE_MS = 40;
+/**
+ * Acquire a cooperative lock on `target` using an adjacent `<target>.lock`
+ * directory. Atomic `mkdir` is the only POSIX primitive we need. If the lock
+ * has been held longer than `timeoutMs`, treat it as stale and steal it.
+ */
+const acquireLock = async (target, timeoutMs = LOCK_TIMEOUT_MS) => {
+    const lockDir = `${target}.lock`;
+    const start = Date.now();
+    // random small sleep to reduce herd contention
+    const backoff = () => new Promise((r) => setTimeout(r, 8 + Math.random() * 32));
+    for (;;) {
+        try {
+            await fs.promises.mkdir(lockDir);
+            return {
+                release: async () => {
+                    try {
+                        await fs.promises.rmdir(lockDir);
+                    }
+                    catch {
+                        /* best effort */
+                    }
+                },
+            };
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'EEXIST')
+                throw err;
+            // Someone holds the lock. Check if it's stale.
+            try {
+                const stat = await fs.promises.stat(lockDir);
+                if (Date.now() - stat.mtimeMs > timeoutMs) {
+                    // Stale — try to remove. Racy with the original holder coming back,
+                    // but safer than blocking forever.
+                    await fs.promises.rmdir(lockDir).catch(() => undefined);
+                    continue;
+                }
+            }
+            catch {
+                // lock vanished between our mkdir attempt and stat; loop retries
+            }
+            if (Date.now() - start > timeoutMs) {
+                throw new Error(`conversation-store: timeout acquiring lock on ${target}`);
+            }
+            await backoff();
+        }
+    }
+};
+exports.acquireLock = acquireLock;
+// ---------- Low-level: append ----------
+/** Append a single line (newline added if absent). Safe under concurrent
+ * writers. Small lines use POSIX atomic append; large lines take a lock. */
+const atomicAppendLine = async (filePath, line) => {
+    const body = line.endsWith('\n') ? line : line + '\n';
+    const bytes = Buffer.byteLength(body, 'utf8');
+    await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+    if (bytes <= ATOMIC_APPEND_LIMIT) {
+        // O_APPEND + single write is atomic up to PIPE_BUF on all modern POSIX
+        // filesystems. Node's fs.appendFile uses O_APPEND under the hood.
+        await fs.promises.appendFile(filePath, body, 'utf8');
+        return;
+    }
+    // Large line → take the lock.
+    const lock = await (0, exports.acquireLock)(filePath);
+    try {
+        await fs.promises.appendFile(filePath, body, 'utf8');
+    }
+    finally {
+        await lock.release();
+    }
+};
+exports.atomicAppendLine = atomicAppendLine;
+/** Sync version for code paths that cannot await (e.g. task-runner callbacks
+ * on task completion). Same semantics; uses sync fs. */
+const atomicAppendLineSync = (filePath, line) => {
+    const body = line.endsWith('\n') ? line : line + '\n';
+    const bytes = Buffer.byteLength(body, 'utf8');
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    if (bytes <= ATOMIC_APPEND_LIMIT) {
+        fs.appendFileSync(filePath, body, { encoding: 'utf8' });
+        return;
+    }
+    // For the sync path we accept a short busy-spin rather than shelling out a
+    // Promise to stay call-site-cheap. Large events are rare on this path.
+    const lockDir = `${filePath}.lock`;
+    const start = Date.now();
+    for (;;) {
+        try {
+            fs.mkdirSync(lockDir);
+            break;
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST')
+                throw err;
+            try {
+                const stat = fs.statSync(lockDir);
+                if (Date.now() - stat.mtimeMs > LOCK_TIMEOUT_MS) {
+                    fs.rmdirSync(lockDir);
+                    continue;
+                }
+            }
+            catch {
+                /* vanished, retry */
+            }
+            if (Date.now() - start > LOCK_TIMEOUT_MS) {
+                throw new Error(`conversation-store: sync lock timeout on ${filePath}`);
+            }
+            // tiny spin — no setTimeout in sync context
+            const tgt = Date.now() + 10;
+            while (Date.now() < tgt) {
+                /* spin */
+            }
+        }
+    }
+    try {
+        fs.appendFileSync(filePath, body, { encoding: 'utf8' });
+    }
+    finally {
+        try {
+            fs.rmdirSync(lockDir);
+        }
+        catch {
+            /* best effort */
+        }
+    }
+};
+exports.atomicAppendLineSync = atomicAppendLineSync;
+// ---------- Reading ----------
+/** Read every complete JSON line from a file. Missing file → []. Corrupted
+ * lines are skipped with no error. Safe to run while another process is
+ * appending. */
+const readAllLines = (filePath) => {
+    if (!fs.existsSync(filePath))
+        return [];
+    let text;
+    try {
+        text = fs.readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    // Split on \n — an unterminated trailing line is dropped (likely a writer
+    // half-way through). On the next read we'll see the completed line.
+    for (const line of text.split('\n')) {
+        if (!line)
+            continue;
+        try {
+            out.push(JSON.parse(line));
+        }
+        catch {
+            /* skip malformed */
+        }
+    }
+    return out;
+};
+exports.readAllLines = readAllLines;
+/** Delta read: given a previous offset, return only NEW complete lines since
+ * that offset plus the updated offset. Used by watchers to avoid re-parsing
+ * the entire file on every change. */
+const readSince = (filePath, offset) => {
+    let stat;
+    try {
+        stat = fs.statSync(filePath);
+    }
+    catch {
+        return { items: [], offset: 0 };
+    }
+    if (stat.size <= offset)
+        return { items: [], offset: stat.size };
+    let text = '';
+    const fd = fs.openSync(filePath, 'r');
+    try {
+        const buf = Buffer.alloc(stat.size - offset);
+        fs.readSync(fd, buf, 0, buf.length, offset);
+        text = buf.toString('utf8');
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    // If the last chunk doesn't end in '\n', back off to the last newline so
+    // we don't parse a half-written line. The unread tail stays for next call.
+    const lastNl = text.lastIndexOf('\n');
+    let endBoundary = stat.size;
+    if (lastNl === -1) {
+        // No newline in the delta — nothing parsable yet.
+        return { items: [], offset };
+    }
+    if (lastNl !== text.length - 1) {
+        text = text.slice(0, lastNl + 1);
+        endBoundary = offset + Buffer.byteLength(text, 'utf8');
+    }
+    const items = [];
+    for (const line of text.split('\n')) {
+        if (!line)
+            continue;
+        try {
+            items.push(JSON.parse(line));
+        }
+        catch {
+            /* skip malformed */
+        }
+    }
+    return { items, offset: endBoundary };
+};
+exports.readSince = readSince;
+/**
+ * Watch `filePath` for appended lines. Callback fires with the new events
+ * decoded from JSON. Re-entrant: the callback may trigger further writes to
+ * the same file without causing reentrancy bugs (the watcher dedupes based
+ * on byte offset, not event count).
+ *
+ * Uses fs.watch with a fs.watchFile fallback — on some network filesystems
+ * (and inside Docker mounts on macOS) fs.watch does not fire reliably.
+ */
+const watchConversation = (filePath, onAppend) => {
+    let offset = 0;
+    try {
+        offset = fs.existsSync(filePath) ? fs.statSync(filePath).size : 0;
+    }
+    catch {
+        offset = 0;
+    }
+    let timer = null;
+    const trigger = () => {
+        if (timer)
+            return;
+        timer = setTimeout(() => {
+            timer = null;
+            try {
+                const { items, offset: next } = (0, exports.readSince)(filePath, offset);
+                offset = next;
+                if (items.length)
+                    onAppend(items);
+            }
+            catch {
+                /* swallow — better silence than crash for a watcher */
+            }
+        }, WATCH_DEBOUNCE_MS);
+    };
+    // Ensure the file exists so fs.watch doesn't throw ENOENT on some platforms.
+    try {
+        if (!fs.existsSync(filePath)) {
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, '', { flag: 'a' });
+        }
+    }
+    catch {
+        /* non-fatal */
+    }
+    let watcher = null;
+    try {
+        watcher = fs.watch(filePath, { persistent: false }, trigger);
+        watcher.on('error', () => {
+            // Fall back to polling below — error once means fs.watch is unreliable
+            // for this file (network fs, deleted, etc).
+            if (watcher) {
+                watcher.close();
+                watcher = null;
+            }
+            fs.watchFile(filePath, { persistent: false, interval: 200 }, trigger);
+        });
+    }
+    catch {
+        fs.watchFile(filePath, { persistent: false, interval: 200 }, trigger);
+    }
+    return {
+        close() {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            if (watcher) {
+                try {
+                    watcher.close();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            else {
+                fs.unwatchFile(filePath);
+            }
+        },
+    };
+};
+exports.watchConversation = watchConversation;
+// ---------- Utilities useful to callers ----------
+/** Return the current byte-length of the file, or 0 if missing. */
+const fileSize = (filePath) => {
+    try {
+        return fs.statSync(filePath).size;
+    }
+    catch {
+        return 0;
+    }
+};
+exports.fileSize = fileSize;
+//# sourceMappingURL=conversation-store.js.map

package/dist/persistence/conversation-store.js.map

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

package/dist/persistence/events.d.ts

@@ -0,0 +1,4 @@
+import { ForgeEvent } from '../types';
+export declare const emit: (projectRoot: string, event: ForgeEvent) => void;
+export declare const streamEvents: (projectRoot: string) => AsyncGenerator<ForgeEvent, void, void>;
+//# sourceMappingURL=events.d.ts.map

package/dist/persistence/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/persistence/events.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAOtC,eAAO,MAAM,IAAI,GAAI,aAAa,MAAM,EAAE,OAAO,UAAU,KAAG,IAE7D,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,KAAG,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CACvC,CAAC"}

package/dist/persistence/events.js

@@ -0,0 +1,50 @@
+"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.streamEvents = exports.emit = void 0;
+const path = __importStar(require("path"));
+const paths_1 = require("../config/paths");
+const jsonl_1 = require("./jsonl");
+const eventFile = (projectRoot) => {
+    const sub = (0, paths_1.ensureProjectDir)(projectRoot);
+    return path.join(sub.logs, 'events.jsonl');
+};
+const emit = (projectRoot, event) => {
+    (0, jsonl_1.appendJsonl)(eventFile(projectRoot), event);
+};
+exports.emit = emit;
+const streamEvents = (projectRoot) => (0, jsonl_1.streamJsonl)(eventFile(projectRoot));
+exports.streamEvents = streamEvents;
+//# sourceMappingURL=events.js.map

package/dist/persistence/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/persistence/events.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAC7B,2CAAmD;AACnD,mCAAmD;AAGnD,MAAM,SAAS,GAAG,CAAC,WAAmB,EAAU,EAAE;IAChD,MAAM,GAAG,GAAG,IAAA,wBAAgB,EAAC,WAAW,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEK,MAAM,IAAI,GAAG,CAAC,WAAmB,EAAE,KAAiB,EAAQ,EAAE;IACnE,IAAA,mBAAW,EAAC,SAAS,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC,CAAC;AAFW,QAAA,IAAI,QAEf;AAEK,MAAM,YAAY,GAAG,CAAC,WAAmB,EAA0C,EAAE,CAC1F,IAAA,mBAAW,EAAa,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;AADrC,QAAA,YAAY,gBACyB"}

package/dist/persistence/index-db.d.ts

@@ -0,0 +1,65 @@
+import { Database as DB } from 'better-sqlite3';
+export declare const getDb: () => DB;
+export declare const closeDb: () => void;
+export declare const upsertProject: (id: string, projectPath: string, name: string) => void;
+export declare const listProjects: () => Array<{
+    id: string;
+    path: string;
+    name: string;
+    created_at: string;
+    last_opened: string;
+}>;
+export interface TaskIndexRow {
+    id: string;
+    project_id: string;
+    title: string;
+    status: string;
+    mode: string;
+    intent: string | null;
+    complexity: string | null;
+    risk: string | null;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+    attempts: number;
+}
+export declare const indexTask: (row: TaskIndexRow) => void;
+export declare const searchTasks: (query: string, limit?: number) => TaskIndexRow[];
+export declare const listTasks: (projectId?: string, limit?: number) => TaskIndexRow[];
+export interface PermissionRow {
+    tool: string;
+    project_id: string | null;
+    scope: string;
+    granted_at: string;
+    expires_at: string | null;
+}
+export declare const savePermissionGrant: (row: PermissionRow) => void;
+export declare const loadPermissionGrants: (tool: string, projectId: string | null) => PermissionRow[];
+export interface LearningRow {
+    id?: number;
+    pattern: string;
+    context: string;
+    fix: string;
+    confidence: number;
+    success_count: number;
+    failure_count: number;
+    updated_at: string;
+}
+export declare const upsertLearning: (row: LearningRow) => void;
+export declare const loadLearning: (context: string, limit?: number) => LearningRow[];
+export interface McpRow {
+    id: string;
+    name: string;
+    transport: string;
+    endpoint: string | null;
+    command: string | null;
+    args: string | null;
+    auth: string;
+    status: string;
+    last_used_at: string | null;
+    tools: string | null;
+}
+export declare const upsertMcp: (row: McpRow) => void;
+export declare const listMcp: () => McpRow[];
+export declare const deleteMcp: (id: string) => void;
+//# sourceMappingURL=index-db.d.ts.map

package/dist/persistence/index-db.d.ts.map

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