@pi-orca/core 0.0.2-dev.20260413162335

package/dist/utils/duration.js

@@ -0,0 +1,47 @@
+/**
+ * Duration parsing utilities.
+ * Spec: §3.7 — Duration Parsing
+ */
+/**
+ * Parse a duration string to milliseconds.
+ * Supports: 30s, 5m, 2h, 7d, 14d
+ *
+ * @param input - Duration string
+ * @returns Milliseconds
+ * @throws Error if format is invalid
+ */
+export function parseDuration(input) {
+    const match = input.match(/^(\d+)([smhd])$/);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${input}. Expected format: <number><unit> (e.g., 30s, 5m, 2h, 7d)`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    const multipliers = {
+        s: 1000,
+        m: 60 * 1000,
+        h: 60 * 60 * 1000,
+        d: 24 * 60 * 60 * 1000,
+    };
+    return value * multipliers[unit];
+}
+/**
+ * Format milliseconds to a human-readable duration string.
+ *
+ * @param ms - Milliseconds
+ * @returns Human-readable duration (e.g., "5m", "2h", "7d")
+ */
+export function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d`;
+    if (hours > 0)
+        return `${hours}h`;
+    if (minutes > 0)
+        return `${minutes}m`;
+    return `${seconds}s`;
+}
+//# sourceMappingURL=duration.js.map

package/dist/utils/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/utils/duration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,2DAA2D,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtB,MAAM,WAAW,GAA2B;QAC1C,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,EAAE,GAAG,IAAI;QACZ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;KACvB,CAAC;IAEF,OAAO,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,GAAG,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,GAAG,CAAC;IAClC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACtC,OAAO,GAAG,OAAO,GAAG,CAAC;AACvB,CAAC"}

package/dist/utils/filesystem.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Filesystem utilities.
+ * Spec: §3.2 — Filesystem Helpers
+ */
+/**
+ * Atomic file write using write-to-tmp-then-rename pattern.
+ * Spec: §10 mentions write-to-tmp-then-rename
+ *
+ * @param filePath - Target file path
+ * @param content - Content to write
+ */
+export declare function atomicWrite(filePath: string, content: string): Promise<void>;
+/**
+ * Ensure directory exists (recursive mkdir).
+ *
+ * @param dirPath - Directory path
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Ensure directory exists (synchronous).
+ *
+ * @param dirPath - Directory path
+ */
+export declare function ensureDirSync(dirPath: string): void;
+/**
+ * Bootstrap a file with default content if it doesn't exist.
+ * Spec: §2.1 "Bootstrap on first access"
+ *
+ * @param filePath - File path
+ * @param defaultContent - Default content (string or object for YAML)
+ * @param options - Bootstrap options
+ * @returns Created flag and content
+ */
+export declare function bootstrapFile<T>(filePath: string, defaultContent: T | string, options?: {
+    notify?: boolean;
+}): Promise<{
+    created: boolean;
+    content: T;
+}>;
+/**
+ * Safe file read that returns null if file doesn't exist.
+ *
+ * @param filePath - File path
+ * @returns File content or null
+ */
+export declare function readFileIfExists(filePath: string): Promise<string | null>;
+/**
+ * Safe file delete (no error if doesn't exist).
+ *
+ * @param filePath - File path
+ */
+export declare function deleteFileIfExists(filePath: string): Promise<void>;
+//# sourceMappingURL=filesystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/utils/filesystem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlF;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,CAAC,GAAG,MAAM,EAC1B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,CA8B3C;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAK/E;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxE"}

package/dist/utils/filesystem.js

@@ -0,0 +1,99 @@
+/**
+ * Filesystem utilities.
+ * Spec: §3.2 — Filesystem Helpers
+ */
+import { mkdir, writeFile, rename, readFile, unlink } from "fs/promises";
+import { dirname } from "path";
+import { existsSync } from "fs";
+/**
+ * Atomic file write using write-to-tmp-then-rename pattern.
+ * Spec: §10 mentions write-to-tmp-then-rename
+ *
+ * @param filePath - Target file path
+ * @param content - Content to write
+ */
+export async function atomicWrite(filePath, content) {
+    const tmpPath = `${filePath}.tmp`;
+    const dir = dirname(filePath);
+    // Ensure parent directory exists
+    await ensureDir(dir);
+    // Write to temp file
+    await writeFile(tmpPath, content, "utf-8");
+    // Atomic rename
+    await rename(tmpPath, filePath);
+}
+/**
+ * Ensure directory exists (recursive mkdir).
+ *
+ * @param dirPath - Directory path
+ */
+export async function ensureDir(dirPath) {
+    await mkdir(dirPath, { recursive: true });
+}
+/**
+ * Ensure directory exists (synchronous).
+ *
+ * @param dirPath - Directory path
+ */
+export function ensureDirSync(dirPath) {
+    if (!existsSync(dirPath)) {
+        // Note: Using fs.mkdirSync would be better, but keeping async pattern
+        throw new Error(`ensureDirSync not implemented - use ensureDir instead`);
+    }
+}
+/**
+ * Bootstrap a file with default content if it doesn't exist.
+ * Spec: §2.1 "Bootstrap on first access"
+ *
+ * @param filePath - File path
+ * @param defaultContent - Default content (string or object for YAML)
+ * @param options - Bootstrap options
+ * @returns Created flag and content
+ */
+export async function bootstrapFile(filePath, defaultContent, options) {
+    // If file exists, read and return it
+    if (existsSync(filePath)) {
+        const existing = await readFile(filePath, "utf-8");
+        // If defaultContent is an object, parse as YAML
+        if (typeof defaultContent !== "string") {
+            const YAML = await import("yaml");
+            const parsed = YAML.parse(existing);
+            return { created: false, content: parsed };
+        }
+        return { created: false, content: existing };
+    }
+    // Create with defaults
+    const dir = dirname(filePath);
+    await ensureDir(dir);
+    const contentStr = typeof defaultContent === "string"
+        ? defaultContent
+        : await import("yaml").then(YAML => YAML.stringify(defaultContent));
+    await atomicWrite(filePath, contentStr);
+    if (options?.notify) {
+        console.log(`Created default config at ${filePath}`);
+    }
+    return { created: true, content: defaultContent };
+}
+/**
+ * Safe file read that returns null if file doesn't exist.
+ *
+ * @param filePath - File path
+ * @returns File content or null
+ */
+export async function readFileIfExists(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    return readFile(filePath, "utf-8");
+}
+/**
+ * Safe file delete (no error if doesn't exist).
+ *
+ * @param filePath - File path
+ */
+export async function deleteFileIfExists(filePath) {
+    if (existsSync(filePath)) {
+        await unlink(filePath);
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/utils/filesystem.js.map

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

package/dist/utils/heartbeat.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Heartbeat utilities.
+ * Spec: §5.6 — Heartbeat and Cost Tracking
+ */
+export interface HeartbeatOptions {
+    filePath: string;
+    intervalMs: number;
+    updateFn: (data: any) => any;
+}
+export interface Heartbeat {
+    start(): void;
+    stop(): void;
+    update(patch: Partial<any>): void;
+}
+/**
+ * Create a heartbeat timer that periodically writes status to a file.
+ * Spec: §5.6 — Heartbeat and Cost Tracking
+ *
+ * @param options - Heartbeat configuration
+ * @returns Heartbeat controller
+ */
+export declare function createHeartbeat(options: HeartbeatOptions): Heartbeat;
+//# sourceMappingURL=heartbeat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/utils/heartbeat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA0CpE"}

package/dist/utils/heartbeat.js

@@ -0,0 +1,53 @@
+/**
+ * Heartbeat utilities.
+ * Spec: §5.6 — Heartbeat and Cost Tracking
+ */
+import { atomicWrite } from "./filesystem.js";
+import YAML from "yaml";
+/**
+ * Create a heartbeat timer that periodically writes status to a file.
+ * Spec: §5.6 — Heartbeat and Cost Tracking
+ *
+ * @param options - Heartbeat configuration
+ * @returns Heartbeat controller
+ */
+export function createHeartbeat(options) {
+    const { filePath, intervalMs, updateFn } = options;
+    let timer = null;
+    let data = {};
+    const writeStatus = async () => {
+        try {
+            const updated = updateFn(data);
+            updated.lastHeartbeat = new Date().toISOString();
+            const content = YAML.stringify(updated);
+            await atomicWrite(filePath, content);
+        }
+        catch (error) {
+            console.error("Heartbeat write failed:", error);
+        }
+    };
+    return {
+        start() {
+            if (timer)
+                return;
+            // Initial write
+            writeStatus();
+            // Set up interval
+            timer = setInterval(() => {
+                writeStatus();
+            }, intervalMs);
+        },
+        stop() {
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+            // Final flush
+            writeStatus();
+        },
+        update(patch) {
+            data = { ...data, ...patch };
+        },
+    };
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/utils/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/utils/heartbeat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,IAAI,MAAM,MAAM,CAAC;AAcxB;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACnD,IAAI,KAAK,GAA0B,IAAI,CAAC;IACxC,IAAI,IAAI,GAAQ,EAAE,CAAC;IAEnB,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;YACH,IAAI,KAAK;gBAAE,OAAO;YAElB,gBAAgB;YAChB,WAAW,EAAE,CAAC;YAEd,kBAAkB;YAClB,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACvB,WAAW,EAAE,CAAC;YAChB,CAAC,EAAE,UAAU,CAAC,CAAC;QACjB,CAAC;QAED,IAAI;YACF,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,cAAc;YACd,WAAW,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,CAAC,KAAmB;YACxB,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pi Orca Core Utilities
+ */
+export * from "./duration.js";
+export * from "./path.js";
+export * from "./yaml.js";
+export * from "./filesystem.js";
+export * from "./lock.js";
+export * from "./process.js";
+export * from "./dag.js";
+export * from "./heartbeat.js";
+export * from "./config-loader.js";
+export * from "./autocomplete.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,14 @@
+/**
+ * Pi Orca Core Utilities
+ */
+export * from "./duration.js";
+export * from "./path.js";
+export * from "./yaml.js";
+export * from "./filesystem.js";
+export * from "./lock.js";
+export * from "./process.js";
+export * from "./dag.js";
+export * from "./heartbeat.js";
+export * from "./config-loader.js";
+export * from "./autocomplete.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/utils/lock.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Lock file utilities.
+ * Spec: §3.4 — Lock File Schema
+ */
+import { LockInfo } from "../types/lock.js";
+/**
+ * Acquire a lock file.
+ * Fails if lock exists and PID is alive.
+ * Succeeds if lock doesn't exist or PID is dead (stale lock).
+ * Spec: §3.4 — Lock File Management
+ *
+ * @param lockPath - Path to lock file
+ * @param sessionInfo - Session information for the lock
+ * @returns true if lock acquired, false if already held by another session
+ */
+export declare function acquireLock(lockPath: string, sessionInfo: LockInfo): Promise<boolean>;
+/**
+ * Release a lock file.
+ * Only releases if current session holds the lock.
+ * Spec: §3.4 — Lock File Management
+ *
+ * @param lockPath - Path to lock file
+ * @param sessionId - Session ID attempting to release
+ * @returns true if lock released, false if not held by this session
+ */
+export declare function releaseLock(lockPath: string, sessionId: string): Promise<boolean>;
+/**
+ * Read a lock file.
+ * Spec: §3.4 — Lock File Management
+ *
+ * @param lockPath - Path to lock file
+ * @returns Lock info or null if doesn't exist
+ */
+export declare function readLock(lockPath: string): Promise<LockInfo | null>;
+/**
+ * Check if a lock file is stale (PID is dead).
+ * Spec: §3.4 — Lock File Management
+ *
+ * @param lockPath - Path to lock file
+ * @returns true if lock is stale
+ */
+export declare function isLockStale(lockPath: string): Promise<boolean>;
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/utils/lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB3F;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYvF;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAWzE;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpE"}

package/dist/utils/lock.js

@@ -0,0 +1,89 @@
+/**
+ * Lock file utilities.
+ * Spec: §3.4 — Lock File Schema
+ */
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import YAML from "yaml";
+import { atomicWrite, deleteFileIfExists } from "./filesystem.js";
+import { isPidAlive } from "./process.js";
+/**
+ * Acquire a lock file.
+ * Fails if lock exists and PID is alive.
+ * Succeeds if lock doesn't exist or PID is dead (stale lock).
+ * Spec: §3.4 — Lock File Management
+ *
+ * @param lockPath - Path to lock file
+ * @param sessionInfo - Session information for the lock
+ * @returns true if lock acquired, false if already held by another session
+ */
+export async function acquireLock(lockPath, sessionInfo) {
+    // Check if lock exists
+    if (existsSync(lockPath)) {
+        // Check if lock is stale
+        const isStale = await isLockStale(lockPath);
+        if (!isStale) {
+            return false; // Lock held by live process
+        }
+        // Remove stale lock
+        await deleteFileIfExists(lockPath);
+    }
+    // Create lock
+    const lockContent = YAML.stringify(sessionInfo);
+    await atomicWrite(lockPath, lockContent);
+    return true;
+}
+/**
+ * Release a lock file.
+ * Only releases if current session holds the lock.
+ * Spec: §3.4 — Lock File Management
+ *
+ * @param lockPath - Path to lock file
+ * @param sessionId - Session ID attempting to release
+ * @returns true if lock released, false if not held by this session
+ */
+export async function releaseLock(lockPath, sessionId) {
+    if (!existsSync(lockPath)) {
+        return false;
+    }
+    const lockInfo = await readLock(lockPath);
+    if (!lockInfo || lockInfo.sessionId !== sessionId) {
+        return false; // Not our lock
+    }
+    await deleteFileIfExists(lockPath);
+    return true;
+}
+/**
+ * Read a lock file.
+ * Spec: §3.4 — Lock File Management
+ *
+ * @param lockPath - Path to lock file
+ * @returns Lock info or null if doesn't exist
+ */
+export async function readLock(lockPath) {
+    if (!existsSync(lockPath)) {
+        return null;
+    }
+    try {
+        const content = await readFile(lockPath, "utf-8");
+        return YAML.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a lock file is stale (PID is dead).
+ * Spec: §3.4 — Lock File Management
+ *
+ * @param lockPath - Path to lock file
+ * @returns true if lock is stale
+ */
+export async function isLockStale(lockPath) {
+    const lockInfo = await readLock(lockPath);
+    if (!lockInfo) {
+        return true; // No lock = stale
+    }
+    return !isPidAlive(lockInfo.pid);
+}
+//# sourceMappingURL=lock.js.map

package/dist/utils/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/utils/lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,WAAqB;IACvE,uBAAuB;IACvB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,yBAAyB;QACzB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC,CAAC,4BAA4B;QAC5C,CAAC;QACD,oBAAoB;QACpB,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,cAAc;IACd,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,SAAiB;IACnE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC,CAAC,eAAe;IAC/B,CAAC;IAED,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,CAAC,kBAAkB;IACjC,CAAC;IAED,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/utils/path.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Path resolution utilities.
+ * Spec: §3.2 — Filesystem Helpers
+ */
+/**
+ * Get current project slug.
+ * For now, returns the current directory basename.
+ * TODO: Integrate with Pi's project slug detection.
+ *
+ * @returns Project slug
+ */
+export declare function getProjectSlug(): string;
+/**
+ * Get Orca runtime directory for a project.
+ * ~/.pi/agent/sessions/<project-slug>/orca/
+ *
+ * Override the base directory with PI_ORCA_BASE_DIR env var (used by tests).
+ *
+ * @param projectSlug - Project slug (defaults to current)
+ * @returns Absolute path to runtime directory
+ */
+export declare function getOrcaRuntimeDir(projectSlug?: string): string;
+/**
+ * Get Orca tasks directory.
+ * ~/.pi/agent/sessions/<project-slug>/orca/tasks/
+ *
+ * @param projectSlug - Project slug (defaults to current)
+ * @returns Absolute path to tasks directory
+ */
+export declare function getOrcaTasksDir(projectSlug?: string): string;
+/**
+ * Get Orca messages store directory.
+ * ~/.pi/agent/sessions/<project-slug>/orca/messages/store/
+ *
+ * @param projectSlug - Project slug (defaults to current)
+ * @returns Absolute path to messages store
+ */
+export declare function getOrcaMessagesStoreDir(projectSlug?: string): string;
+/**
+ * Get Orca messages inbox directory for a session.
+ * ~/.pi/agent/sessions/<project-slug>/orca/messages/inbox/<session-id>/
+ *
+ * @param sessionId - Session ID
+ * @param projectSlug - Project slug (defaults to current)
+ * @returns Absolute path to inbox directory
+ */
+export declare function getOrcaMessagesInboxDir(sessionId: string, projectSlug?: string): string;
+/**
+ * Get sibling .orca directory for a session JSONL file.
+ * Replaces .jsonl extension with .orca
+ *
+ * @param sessionPath - Path to session JSONL file (relative or absolute)
+ * @returns Absolute path to sibling .orca directory
+ */
+export declare function getOrcaSiblingDir(sessionPath: string): string;
+/**
+ * Get user-level Orca directory.
+ * ~/.pi/agent/orca/
+ *
+ * Override the base directory with PI_ORCA_USER_DIR env var (used by tests).
+ *
+ * @returns Absolute path to user Orca directory
+ */
+export declare function getUserOrcaDir(): string;
+/**
+ * Get project-level Orca directory.
+ * <project>/.pi/orca/
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns Absolute path to project Orca directory
+ */
+export declare function getProjectOrcaDir(projectRoot?: string): string;
+/**
+ * Resolve session path to absolute.
+ * If path is relative, resolves against ~/.pi/agent/sessions/
+ *
+ * @param sessionPath - Session path (relative or absolute)
+ * @returns Absolute path
+ */
+export declare function resolveSessionPath(sessionPath: string): string;
+/**
+ * Make session path relative to ~/.pi/agent/sessions/
+ *
+ * @param absolutePath - Absolute session path
+ * @returns Relative path
+ */
+export declare function makeSessionPathRelative(absolutePath: string): string;
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAU7D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMpE"}