@pi-orca/core 0.0.2-dev.20260413162335

package/dist/utils/path.js

@@ -0,0 +1,128 @@
+/**
+ * Path resolution utilities.
+ * Spec: §3.2 — Filesystem Helpers
+ */
+import { homedir } from "os";
+import { join, dirname, basename } from "path";
+/**
+ * Get current project slug.
+ * For now, returns the current directory basename.
+ * TODO: Integrate with Pi's project slug detection.
+ *
+ * @returns Project slug
+ */
+export function getProjectSlug() {
+    return basename(process.cwd());
+}
+/**
+ * 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 function getOrcaRuntimeDir(projectSlug) {
+    const slug = projectSlug || getProjectSlug();
+    const baseDir = process.env["PI_ORCA_BASE_DIR"] ||
+        join(homedir(), ".pi", "agent", "sessions");
+    return join(baseDir, slug, "orca");
+}
+/**
+ * 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 function getOrcaTasksDir(projectSlug) {
+    return join(getOrcaRuntimeDir(projectSlug), "tasks");
+}
+/**
+ * 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 function getOrcaMessagesStoreDir(projectSlug) {
+    return join(getOrcaRuntimeDir(projectSlug), "messages", "store");
+}
+/**
+ * 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 function getOrcaMessagesInboxDir(sessionId, projectSlug) {
+    return join(getOrcaRuntimeDir(projectSlug), "messages", "inbox", sessionId);
+}
+/**
+ * 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 function getOrcaSiblingDir(sessionPath) {
+    // If relative, make it absolute from sessions dir
+    let absolutePath = sessionPath;
+    if (!sessionPath.startsWith("/")) {
+        absolutePath = join(homedir(), ".pi", "agent", "sessions", sessionPath);
+    }
+    const dir = dirname(absolutePath);
+    const base = basename(absolutePath, ".jsonl");
+    return join(dir, `${base}.orca`);
+}
+/**
+ * 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 function getUserOrcaDir() {
+    return process.env["PI_ORCA_USER_DIR"] || join(homedir(), ".pi", "agent", "orca");
+}
+/**
+ * Get project-level Orca directory.
+ * <project>/.pi/orca/
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns Absolute path to project Orca directory
+ */
+export function getProjectOrcaDir(projectRoot) {
+    const root = projectRoot || process.cwd();
+    return join(root, ".pi", "orca");
+}
+/**
+ * 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 function resolveSessionPath(sessionPath) {
+    if (sessionPath.startsWith("/")) {
+        return sessionPath;
+    }
+    return join(homedir(), ".pi", "agent", "sessions", sessionPath);
+}
+/**
+ * Make session path relative to ~/.pi/agent/sessions/
+ *
+ * @param absolutePath - Absolute session path
+ * @returns Relative path
+ */
+export function makeSessionPathRelative(absolutePath) {
+    const sessionsDir = join(homedir(), ".pi", "agent", "sessions");
+    if (absolutePath.startsWith(sessionsDir)) {
+        return absolutePath.slice(sessionsDir.length + 1); // +1 for trailing /
+    }
+    return absolutePath;
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAG/C;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAoB;IACpD,MAAM,IAAI,GAAG,WAAW,IAAI,cAAc,EAAE,CAAC;IAC7C,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/B,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,WAAoB;IAClD,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAoB;IAC1D,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAiB,EAAE,WAAoB;IAC7E,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,kDAAkD;IAClD,IAAI,YAAY,GAAG,WAAW,CAAC;IAC/B,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAoB;IACpD,MAAM,IAAI,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAChE,IAAI,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,OAAO,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB;IACzE,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/utils/process.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Process and PID utilities.
+ * Spec: §3.8 — Stuck Task Detection
+ */
+/**
+ * Check if a PID is alive.
+ * Uses kill(pid, 0) to check without sending a signal.
+ * Spec: §3.8 — Stuck Task Detection
+ *
+ * @param pid - Process ID to check
+ * @returns true if process is alive
+ */
+export declare function isPidAlive(pid: number): boolean;
+/**
+ * Get current process ID.
+ *
+ * @returns Current PID
+ */
+export declare function getCurrentPid(): number;
+//# sourceMappingURL=process.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAiB/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/utils/process.js

@@ -0,0 +1,40 @@
+/**
+ * Process and PID utilities.
+ * Spec: §3.8 — Stuck Task Detection
+ */
+/**
+ * Check if a PID is alive.
+ * Uses kill(pid, 0) to check without sending a signal.
+ * Spec: §3.8 — Stuck Task Detection
+ *
+ * @param pid - Process ID to check
+ * @returns true if process is alive
+ */
+export function isPidAlive(pid) {
+    try {
+        // Signal 0 checks if process exists without actually sending a signal
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ESRCH") {
+            // No such process
+            return false;
+        }
+        if (error.code === "EPERM") {
+            // Process exists but no permission to signal it
+            return true;
+        }
+        // Other errors - assume not alive
+        return false;
+    }
+}
+/**
+ * Get current process ID.
+ *
+ * @returns Current PID
+ */
+export function getCurrentPid() {
+    return process.pid;
+}
+//# sourceMappingURL=process.js.map

package/dist/utils/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,sEAAsE;QACtE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,kBAAkB;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,gDAAgD;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,kCAAkC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,GAAG,CAAC;AACrB,CAAC"}

package/dist/utils/yaml.d.ts

@@ -0,0 +1,30 @@
+/**
+ * YAML frontmatter parsing utilities.
+ * Spec: §2.7 — YAML frontmatter parsing
+ */
+/**
+ * Result of parsing frontmatter.
+ */
+export interface FrontmatterResult<T> {
+    frontmatter: T;
+    body: string;
+}
+/**
+ * Parse markdown with YAML frontmatter.
+ * Spec: §2.7 — YAML frontmatter parsing
+ *
+ * @param content - Full file content
+ * @returns Parsed frontmatter and body
+ * @throws Error if frontmatter is malformed
+ */
+export declare function parseFrontmatter<T>(content: string): FrontmatterResult<T>;
+/**
+ * Serialize frontmatter and body to markdown.
+ * Spec: §2.7 — YAML frontmatter parsing
+ *
+ * @param frontmatter - Object to serialize as frontmatter
+ * @param body - Body content
+ * @returns Markdown with YAML frontmatter
+ */
+export declare function serializeFrontmatter<T>(frontmatter: T, body: string): string;
+//# sourceMappingURL=yaml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/utils/yaml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAmCzE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5E"}

package/dist/utils/yaml.js

@@ -0,0 +1,58 @@
+/**
+ * YAML frontmatter parsing utilities.
+ * Spec: §2.7 — YAML frontmatter parsing
+ */
+import YAML from "yaml";
+/**
+ * Parse markdown with YAML frontmatter.
+ * Spec: §2.7 — YAML frontmatter parsing
+ *
+ * @param content - Full file content
+ * @returns Parsed frontmatter and body
+ * @throws Error if frontmatter is malformed
+ */
+export function parseFrontmatter(content) {
+    const trimmed = content.trim();
+    // Check for frontmatter delimiters
+    if (!trimmed.startsWith("---")) {
+        return {
+            frontmatter: {},
+            body: content,
+        };
+    }
+    // Find end of frontmatter
+    const lines = trimmed.split("\n");
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === "---") {
+            endIndex = i;
+            break;
+        }
+    }
+    if (endIndex === -1) {
+        throw new Error("Malformed frontmatter: missing closing ---");
+    }
+    // Extract frontmatter and body
+    const frontmatterText = lines.slice(1, endIndex).join("\n");
+    const body = lines.slice(endIndex + 1).join("\n").trim();
+    try {
+        const frontmatter = YAML.parse(frontmatterText);
+        return { frontmatter, body };
+    }
+    catch (error) {
+        throw new Error(`Failed to parse YAML frontmatter: ${error}`);
+    }
+}
+/**
+ * Serialize frontmatter and body to markdown.
+ * Spec: §2.7 — YAML frontmatter parsing
+ *
+ * @param frontmatter - Object to serialize as frontmatter
+ * @param body - Body content
+ * @returns Markdown with YAML frontmatter
+ */
+export function serializeFrontmatter(frontmatter, body) {
+    const yamlText = YAML.stringify(frontmatter);
+    return `---\n${yamlText}---\n\n${body}`;
+}
+//# sourceMappingURL=yaml.js.map

package/dist/utils/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/utils/yaml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAI,OAAe;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE/B,mCAAmC;IACnC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,WAAW,EAAE,EAAO;YACpB,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YAC9B,QAAQ,GAAG,CAAC,CAAC;YACb,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,+BAA+B;IAC/B,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAM,CAAC;QACrD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAI,WAAc,EAAE,IAAY;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC7C,OAAO,QAAQ,QAAQ,UAAU,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@pi-orca/core",
+  "version": "0.0.2-dev.20260413162335",
+  "description": "Shared types and utilities for Pi Orca extension suite",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "defaults"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "pi-orca",
+    "pi-agent",
+    "utilities",
+    "types"
+  ],
+  "author": "Bindu / Ba",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bwavell/pi-orca.git",
+    "directory": "packages/pi-orca-core"
+  },
+  "dependencies": {
+    "yaml": "^2.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0"
+  }
+}