@pi-orca/core 0.0.2-dev.20260414093420 → 0.0.2-dev.20260421080334

package/README.md

@@ -18,6 +18,7 @@ License: MIT
 - **DAG Utilities** — Cycle detection and transitive dependency walking for task graphs
 - **Heartbeat System** — Periodic status file writes with cost tracking
 - **Duration Parsing** — Human-readable duration strings (`30s`, `5m`, `2h`, `7d`)
+- **Settings I/O** — Atomic read/write of `~/.pi/agent/settings.json` shared across extensions
 
 ## Installation
 
@@ -172,6 +173,23 @@ const userDir = getUserOrcaDir(); // ~/.pi/agent/orca/
 const projectDir = getProjectOrcaDir(); // <project>/.pi/orca/
 ```
 
+### Settings I/O
+
+```typescript
+import { getPiSettingsPath, readPiSettings, writePiSettings } from "@pi-orca/core";
+
+// Read current settings (returns {} if missing/unparseable)
+const settings = await readPiSettings();
+
+// Patch and write back atomically
+settings.defaultProvider = "my-provider";
+settings.defaultModel = "my-model";
+await writePiSettings(settings);
+
+// Override path for tests via PI_SETTINGS_PATH env var
+const path = getPiSettingsPath(); // ~/.pi/agent/settings.json
+```
+
 ## API Documentation
 
 ### Types
@@ -196,6 +214,7 @@ const projectDir = getProjectOrcaDir(); // <project>/.pi/orca/
 - **Process**: `isPidAlive()`, `getCurrentPid()`
 - **DAG**: `detectCycle()`, `getTransitiveDependents()`, `getTransitiveDependencies()`
 - **Heartbeat**: `createHeartbeat()`
+- **Settings**: `getPiSettingsPath()`, `readPiSettings()`, `writePiSettings()`
 
 ## Development
 

package/dist/utils/index.d.ts

@@ -11,4 +11,5 @@ export * from "./dag.js";
 export * from "./heartbeat.js";
 export * from "./config-loader.js";
 export * from "./autocomplete.js";
+export * from "./settings.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAClC,cAAc,eAAe,CAAC"}

package/dist/utils/index.js

@@ -11,4 +11,5 @@ export * from "./dag.js";
 export * from "./heartbeat.js";
 export * from "./config-loader.js";
 export * from "./autocomplete.js";
+export * from "./settings.js";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +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"}
+{"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;AAClC,cAAc,eAAe,CAAC"}

package/dist/utils/settings.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pi agent settings.json read/write utilities.
+ * Shared by extensions that need to read or patch settings.
+ */
+/**
+ * Path to ~/.pi/agent/settings.json.
+ * Override with PI_SETTINGS_PATH env var (used by tests).
+ */
+export declare function getPiSettingsPath(): string;
+/**
+ * Read and parse ~/.pi/agent/settings.json.
+ * Returns empty object if the file doesn't exist or is unparseable.
+ */
+export declare function readPiSettings(): Promise<Record<string, any>>;
+/**
+ * Write settings.json atomically via tmp+rename.
+ * Caller is responsible for merging — this writes the full object.
+ */
+export declare function writePiSettings(settings: Record<string, any>): Promise<void>;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/utils/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAOnE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/utils/settings.js

@@ -0,0 +1,40 @@
+/**
+ * Pi agent settings.json read/write utilities.
+ * Shared by extensions that need to read or patch settings.
+ */
+import { readFile } from "fs/promises";
+import { join } from "path";
+import { getUserOrcaDir } from "./path.js";
+import { atomicWrite } from "./filesystem.js";
+/**
+ * Path to ~/.pi/agent/settings.json.
+ * Override with PI_SETTINGS_PATH env var (used by tests).
+ */
+export function getPiSettingsPath() {
+    if (process.env["PI_SETTINGS_PATH"]) {
+        return process.env["PI_SETTINGS_PATH"];
+    }
+    // getUserOrcaDir() → ~/.pi/agent/orca  →  parent is ~/.pi/agent
+    return join(getUserOrcaDir(), "..", "settings.json");
+}
+/**
+ * Read and parse ~/.pi/agent/settings.json.
+ * Returns empty object if the file doesn't exist or is unparseable.
+ */
+export async function readPiSettings() {
+    try {
+        const content = await readFile(getPiSettingsPath(), "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write settings.json atomically via tmp+rename.
+ * Caller is responsible for merging — this writes the full object.
+ */
+export async function writePiSettings(settings) {
+    await atomicWrite(getPiSettingsPath(), JSON.stringify(settings, null, 2) + "\n");
+}
+//# sourceMappingURL=settings.js.map

package/dist/utils/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/utils/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACzC,CAAC;IACD,gEAAgE;IAChE,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,iBAAiB,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAA6B;IAE7B,MAAM,WAAW,CAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACnF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-orca/core",
-  "version": "0.0.2-dev.20260414093420",
+  "version": "0.0.2-dev.20260421080334",
   "description": "Shared types and utilities for Pi Orca extension suite",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,7 +36,7 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/bwavell/pi-orca.git",
-    "directory": "packages/pi-orca-core"
+    "directory": "packages/core"
   },
   "dependencies": {
     "yaml": "^2.4.0"