@kodrunhq/claudefy 1.4.3 → 1.5.0

package/dist/lockfile.js

@@ -0,0 +1,119 @@
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { existsSync } from "node:fs";
+export class Lockfile {
+    path;
+    retries;
+    retryDelayMs;
+    maxAgeMs;
+    operation;
+    constructor(path, options = {}) {
+        this.path = path;
+        this.retries = options.retries ?? 3;
+        this.retryDelayMs = options.retryDelayMs ?? 1000;
+        this.maxAgeMs = options.maxAgeMs ?? 120_000; // 2 minutes
+        this.operation = options.operation ?? "unknown";
+    }
+    async acquire() {
+        for (let attempt = 0; attempt <= this.retries; attempt++) {
+            if (attempt > 0) {
+                await this.delay(this.retryDelayMs);
+            }
+            if (await this.tryAcquire()) {
+                return true;
+            }
+        }
+        return false;
+    }
+    async release() {
+        try {
+            await rm(this.path, { force: true });
+        }
+        catch {
+            // Best effort — stale lock will expire via maxAgeMs
+        }
+    }
+    async tryAcquire() {
+        if (!existsSync(this.path)) {
+            return this.writeLock();
+        }
+        // Lock exists — check if stale
+        const existing = await this.readLock();
+        if (!existing) {
+            // Corrupted lockfile (unparseable JSON), overwrite
+            await this.release();
+            return this.writeLock();
+        }
+        // Check age
+        const age = Date.now() - new Date(existing.timestamp).getTime();
+        if (age > this.maxAgeMs) {
+            await this.release();
+            return this.writeLock();
+        }
+        // Check if PID is alive
+        if (!this.isProcessAlive(existing.pid)) {
+            await this.release();
+            return this.writeLock();
+        }
+        // Lock is held by a live, recent process
+        return false;
+    }
+    async writeLock() {
+        await mkdir(dirname(this.path), { recursive: true, mode: 0o700 });
+        const data = {
+            pid: process.pid,
+            timestamp: new Date().toISOString(),
+            operation: this.operation,
+        };
+        try {
+            await writeFile(this.path, JSON.stringify(data), { flag: "wx", mode: 0o600 });
+            return true;
+        }
+        catch (err) {
+            if (err.code === "EEXIST") {
+                return false;
+            }
+            throw err; // Disk full, permissions, etc. must surface
+        }
+    }
+    async readLock() {
+        try {
+            const content = await readFile(this.path, "utf-8");
+            return JSON.parse(content);
+        }
+        catch (err) {
+            if (err instanceof SyntaxError) {
+                return null; // Corrupted JSON
+            }
+            if (err.code === "ENOENT") {
+                return null; // Lockfile deleted between existsSync() and readFile()
+            }
+            // I/O errors (EACCES, EMFILE, etc.) — treat as "lock exists, can't read"
+            // so we don't steal it. Return a synthetic entry with current PID to prevent overwrite.
+            return { pid: process.pid, timestamp: new Date().toISOString(), operation: "unknown" };
+        }
+    }
+    isProcessAlive(pid) {
+        // pid=0 signals the process group; pid<0 signals a group or all processes.
+        // Neither represents a real process that owns a lock.
+        if (!Number.isInteger(pid) || pid <= 0 || pid > 4194304) {
+            return false;
+        }
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch (err) {
+            // EPERM means the process exists but belongs to another user
+            if (err.code === "EPERM") {
+                return true;
+            }
+            // ESRCH means process doesn't exist
+            return false;
+        }
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=lockfile.js.map

package/dist/lockfile.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,23 @@
+export interface LogEntry {
+    timestamp: string;
+    level: "info" | "warn" | "error";
+    operation: string;
+    message: string;
+}
+export interface LoggerOptions {
+    maxBytes?: number;
+    maxFiles?: number;
+}
+export interface ReadRecentFilter {
+    level?: "info" | "warn" | "error";
+    operation?: string;
+}
+export declare class Logger {
+    private readonly filePath;
+    private readonly maxBytes;
+    private readonly maxFiles;
+    constructor(filePath: string, options?: LoggerOptions);
+    log(level: LogEntry["level"], operation: string, message: string): Promise<void>;
+    readRecent(count: number, filter?: ReadRecentFilter): Promise<LogEntry[]>;
+    private rotateIfNeeded;
+}

package/dist/logger.js

@@ -0,0 +1,83 @@
+import { appendFile, mkdir, readFile, rename, rm, stat } from "node:fs/promises";
+import { dirname } from "node:path";
+import { existsSync } from "node:fs";
+export class Logger {
+    filePath;
+    maxBytes;
+    maxFiles;
+    constructor(filePath, options = {}) {
+        this.filePath = filePath;
+        this.maxBytes = options.maxBytes ?? 512 * 1024; // 512 KB default
+        this.maxFiles = options.maxFiles ?? 3;
+    }
+    async log(level, operation, message) {
+        try {
+            const entry = {
+                timestamp: new Date().toISOString(),
+                level,
+                operation,
+                message,
+            };
+            const line = JSON.stringify(entry) + "\n";
+            await mkdir(dirname(this.filePath), { recursive: true, mode: 0o700 });
+            await appendFile(this.filePath, line, { mode: 0o600 });
+            await this.rotateIfNeeded();
+        }
+        catch {
+            // Logging is best-effort; never crash the caller
+        }
+    }
+    async readRecent(count, filter) {
+        if (!existsSync(this.filePath))
+            return [];
+        let content;
+        try {
+            content = await readFile(this.filePath, "utf-8");
+        }
+        catch {
+            return [];
+        }
+        let entries = content
+            .trim()
+            .split("\n")
+            .filter(Boolean)
+            .map((line) => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((e) => e !== null);
+        if (filter?.level) {
+            entries = entries.filter((e) => e.level === filter.level);
+        }
+        if (filter?.operation) {
+            entries = entries.filter((e) => e.operation === filter.operation);
+        }
+        return entries.slice(-count);
+    }
+    async rotateIfNeeded() {
+        try {
+            const stats = await stat(this.filePath);
+            if (stats.size <= this.maxBytes)
+                return;
+        }
+        catch {
+            return;
+        }
+        // Shift existing rotated files: .2 -> .3, .1 -> .2, current -> .1
+        for (let i = this.maxFiles; i >= 1; i--) {
+            const src = i === 1 ? this.filePath : `${this.filePath}.${i - 1}`;
+            const dest = `${this.filePath}.${i}`;
+            if (existsSync(src)) {
+                if (i === this.maxFiles) {
+                    await rm(dest, { force: true });
+                }
+                await rename(src, dest);
+            }
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAmBrC,MAAM,OAAO,MAAM;IACA,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,QAAQ,CAAS;IAElC,YAAY,QAAgB,EAAE,UAAyB,EAAE;QACvD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,iBAAiB;QACjE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAwB,EAAE,SAAiB,EAAE,OAAe;QACpE,IAAI,CAAC;YACH,MAAM,KAAK,GAAa;gBACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK;gBACL,SAAS;gBACT,OAAO;aACR,CAAC;YACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YAE1C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACvD,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,MAAyB;QACvD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAE1C,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,OAAO,GAAe,OAAO;aAC9B,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAiB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAE5C,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;YACtB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,kEAAkE;QAClE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACrC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACxB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClC,CAAC;gBACD,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodrunhq/claudefy",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "Sync your Claude Code environment across machines",
   "type": "module",
   "main": "dist/index.js",