@polpo-ai/file-stores 0.11.0

package/dist/json-config-store.d.ts

@@ -0,0 +1,25 @@
+import type { PolpoConfig, ProjectConfig } from "@polpo-ai/core/types";
+import type { ConfigStore } from "@polpo-ai/core/config-store";
+/**
+ * JSON-file backed ConfigStore.
+ * Reads/writes `.polpo/polpo.json`.
+ */
+export declare class PolpoConfigStore implements ConfigStore {
+    private readonly filePath;
+    constructor(polpoDir: string);
+    exists(): Promise<boolean>;
+    get(): Promise<PolpoConfig | undefined>;
+    save(config: PolpoConfig): Promise<void>;
+}
+/**
+ * Legacy JSON-file backed ConfigStore.
+ * Reads/writes `config.json` directly in the given directory.
+ */
+export declare class JsonConfigStore {
+    private readonly filePath;
+    constructor(dir: string);
+    exists(): boolean;
+    get(): ProjectConfig | undefined;
+    save(config: ProjectConfig): void;
+}
+//# sourceMappingURL=json-config-store.d.ts.map

package/dist/json-config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-config-store.d.ts","sourceRoot":"","sources":["../src/json-config-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,EAAE,MAAM;IAItB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,GAAG,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAOvC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/C;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,GAAG,EAAE,MAAM;IAIvB,MAAM,IAAI,OAAO;IAIjB,GAAG,IAAI,aAAa,GAAG,SAAS;IAUhC,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;CAKlC"}

package/dist/json-config-store.js

@@ -0,0 +1,66 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+/**
+ * JSON-file backed ConfigStore.
+ * Reads/writes `.polpo/polpo.json`.
+ */
+export class PolpoConfigStore {
+    filePath;
+    constructor(polpoDir) {
+        this.filePath = join(polpoDir, "polpo.json");
+    }
+    async exists() {
+        return existsSync(this.filePath);
+    }
+    async get() {
+        if (!existsSync(this.filePath))
+            return undefined;
+        try {
+            return JSON.parse(readFileSync(this.filePath, "utf-8"));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async save(config) {
+        const dir = dirname(this.filePath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(this.filePath, JSON.stringify(config, null, 2), "utf-8");
+    }
+}
+/**
+ * Legacy JSON-file backed ConfigStore.
+ * Reads/writes `config.json` directly in the given directory.
+ */
+export class JsonConfigStore {
+    filePath;
+    constructor(dir) {
+        this.filePath = join(dir, "config.json");
+    }
+    exists() {
+        return existsSync(this.filePath);
+    }
+    get() {
+        if (!existsSync(this.filePath))
+            return undefined;
+        try {
+            const parsed = JSON.parse(readFileSync(this.filePath, "utf-8"));
+            if (!parsed || typeof parsed !== "object")
+                return undefined;
+            if (typeof parsed.project !== "string")
+                return undefined;
+            return parsed;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    save(config) {
+        const dir = dirname(this.filePath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(this.filePath, JSON.stringify(config, null, 2), "utf-8");
+    }
+}
+//# sourceMappingURL=json-config-store.js.map

package/dist/json-config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-config-store.js","sourceRoot":"","sources":["../src/json-config-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAI1C;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,QAAQ,CAAS;IAElC,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QACjD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAgB,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,SAAS,CAAC;QAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAmB;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,CAAS;IAElC,YAAY,GAAW;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM;QACJ,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,GAAG;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YAChE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC5D,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YACzD,OAAO,MAAuB,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,SAAS,CAAC;QAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,MAAqB;QACxB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/json-task-store.d.ts

@@ -0,0 +1,22 @@
+import type { Task, TaskStatus, PolpoState } from "@polpo-ai/core/types";
+import type { TaskStore } from "@polpo-ai/core/task-store";
+export declare class JsonTaskStore implements TaskStore {
+    private statePath;
+    private state;
+    constructor(polpoDir: string);
+    private load;
+    private persist;
+    getState(): Promise<PolpoState>;
+    setState(partial: Partial<PolpoState>): Promise<void>;
+    addTask(task: Omit<Task, "id" | "status" | "retries" | "createdAt" | "updatedAt"> & {
+        status?: TaskStatus;
+    }): Promise<Task>;
+    getTask(taskId: string): Promise<Task | undefined>;
+    getAllTasks(): Promise<Task[]>;
+    unsafeSetStatus(taskId: string, newStatus: TaskStatus, reason: string): Promise<Task>;
+    updateTask(taskId: string, updates: Partial<Omit<Task, "id" | "status">>): Promise<Task>;
+    removeTask(taskId: string): Promise<boolean>;
+    removeTasks(filter: (task: Task) => boolean): Promise<number>;
+    transition(taskId: string, newStatus: TaskStatus): Promise<Task>;
+}
+//# sourceMappingURL=json-task-store.d.ts.map

package/dist/json-task-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-task-store.d.ts","sourceRoot":"","sources":["../src/json-task-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3D,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAa;gBAEd,QAAQ,EAAE,MAAM;IAK5B,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,OAAO;IAWT,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAI/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,OAAO,CACX,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,UAAU,CAAA;KAAE,GAClG,OAAO,CAAC,IAAI,CAAC;IAeV,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAIlD,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAI9B,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5C,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBvE"}

package/dist/json-task-store.js

@@ -0,0 +1,112 @@
+import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { nanoid } from "nanoid";
+import { assertValidTransition } from "@polpo-ai/core/state-machine";
+export class JsonTaskStore {
+    statePath;
+    state;
+    constructor(polpoDir) {
+        this.statePath = join(polpoDir, "state.json");
+        this.state = this.load();
+    }
+    load() {
+        if (existsSync(this.statePath)) {
+            const raw = readFileSync(this.statePath, "utf-8");
+            return JSON.parse(raw);
+        }
+        return {
+            project: "",
+            teams: [{ name: "", agents: [] }],
+            tasks: [],
+            processes: [],
+        };
+    }
+    persist() {
+        const dir = join(this.statePath, "..");
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Atomic write: write to temp file, then rename
+        const tmp = this.statePath + ".tmp";
+        writeFileSync(tmp, JSON.stringify(this.state, null, 2), "utf-8");
+        renameSync(tmp, this.statePath);
+    }
+    async getState() {
+        return this.state;
+    }
+    async setState(partial) {
+        Object.assign(this.state, partial);
+        this.persist();
+    }
+    async addTask(task) {
+        const now = new Date().toISOString();
+        const newTask = {
+            ...task,
+            id: nanoid(),
+            status: task.status ?? "pending",
+            retries: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.state.tasks.push(newTask);
+        this.persist();
+        return newTask;
+    }
+    async getTask(taskId) {
+        return this.state.tasks.find((t) => t.id === taskId);
+    }
+    async getAllTasks() {
+        return this.state.tasks;
+    }
+    async unsafeSetStatus(taskId, newStatus, reason) {
+        const task = this.state.tasks.find((t) => t.id === taskId);
+        if (!task)
+            throw new Error(`Task not found: ${taskId}`);
+        const from = task.status;
+        task.status = newStatus;
+        task.updatedAt = new Date().toISOString();
+        this.persist();
+        console.warn(`[unsafeSetStatus] ${taskId}: ${from} → ${newStatus} — ${reason}`);
+        return task;
+    }
+    async updateTask(taskId, updates) {
+        const task = this.state.tasks.find((t) => t.id === taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        Object.assign(task, updates, { updatedAt: new Date().toISOString() });
+        this.persist();
+        return task;
+    }
+    async removeTask(taskId) {
+        const idx = this.state.tasks.findIndex((t) => t.id === taskId);
+        if (idx < 0)
+            return false;
+        this.state.tasks.splice(idx, 1);
+        this.persist();
+        return true;
+    }
+    async removeTasks(filter) {
+        const before = this.state.tasks.length;
+        this.state.tasks = this.state.tasks.filter((t) => !filter(t));
+        const removed = before - this.state.tasks.length;
+        if (removed > 0)
+            this.persist();
+        return removed;
+    }
+    async transition(taskId, newStatus) {
+        const task = this.state.tasks.find((t) => t.id === taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        assertValidTransition(task.status, newStatus);
+        if (newStatus === "pending" && task.status === "failed") {
+            task.retries += 1;
+        }
+        task.status = newStatus;
+        task.updatedAt = new Date().toISOString();
+        this.persist();
+        return task;
+    }
+}
+//# sourceMappingURL=json-task-store.js.map

package/dist/json-task-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-task-store.js","sourceRoot":"","sources":["../src/json-task-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,OAAO,aAAa;IAChB,SAAS,CAAS;IAClB,KAAK,CAAa;IAE1B,YAAY,QAAgB;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAEO,IAAI;QACV,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QACvC,CAAC;QACD,OAAO;YACL,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YACjC,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAEO,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,gDAAgD;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;QACpC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACjE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAA4B;QACzC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAmG;QAEnG,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAS;YACpB,GAAG,IAAI;YACP,EAAE,EAAE,MAAM,EAAE;YACZ,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;YAChC,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAc,EAAE,SAAqB,EAAE,MAAc;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,qBAAqB,MAAM,KAAK,IAAI,MAAM,SAAS,MAAM,MAAM,EAAE,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,OAA6C;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAC/D,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAA+B;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACjD,IAAI,OAAO,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,SAAqB;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAE9C,IAAI,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/paths.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Canonical .polpo directory layout helpers — owned by the file-stores
+ * package because the directory layout IS the file persistence contract.
+ */
+/** Name of the per-project config directory. */
+export declare const POLPO_DIR_NAME = ".polpo";
+/** Resolve the per-project `.polpo` directory from a working directory. */
+export declare function getPolpoDir(workDir: string): string;
+/** Resolve the global `~/.polpo` directory in the user's home. */
+export declare function getGlobalPolpoDir(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,gDAAgD;AAChD,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/paths.js

@@ -0,0 +1,17 @@
+/**
+ * Canonical .polpo directory layout helpers — owned by the file-stores
+ * package because the directory layout IS the file persistence contract.
+ */
+import { resolve, join } from "node:path";
+import { homedir } from "node:os";
+/** Name of the per-project config directory. */
+export const POLPO_DIR_NAME = ".polpo";
+/** Resolve the per-project `.polpo` directory from a working directory. */
+export function getPolpoDir(workDir) {
+    return resolve(workDir, POLPO_DIR_NAME);
+}
+/** Resolve the global `~/.polpo` directory in the user's home. */
+export function getGlobalPolpoDir() {
+    return join(homedir(), POLPO_DIR_NAME);
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,gDAAgD;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AAC1C,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AACzC,CAAC"}

package/dist/playbook-files.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Playbook file persistence — discovery and CRUD over the .polpo/playbooks
+ * directory layout (with legacy templates/ compatibility). Pure logic
+ * (validation, instantiation) lives in @polpo-ai/core (playbook-logic).
+ */
+import type { PlaybookDefinition, PlaybookInfo } from "@polpo-ai/core/playbook-store";
+/**
+ * Discover all available playbooks from known locations.
+ * Returns deduplicated list (first occurrence wins by name).
+ *
+ * Also scans legacy templates/ directories for backward compatibility.
+ */
+export declare function discoverPlaybooks(cwd: string, polpoDir?: string): PlaybookInfo[];
+/**
+ * Load a full playbook definition by name.
+ * Returns null if not found.
+ */
+export declare function loadPlaybook(cwd: string, polpoDir: string | undefined, name: string): PlaybookDefinition | null;
+/**
+ * Save a playbook to disk.
+ *
+ * Creates/overwrites `<polpoDir>/playbooks/<name>/playbook.json`.
+ * Validates the definition structure before writing.
+ *
+ * @returns The absolute path to the saved playbook directory.
+ * @throws If validation fails or the write fails.
+ */
+export declare function savePlaybook(polpoDir: string, definition: PlaybookDefinition): string;
+/**
+ * Delete a playbook from disk.
+ *
+ * Removes the `<polpoDir>/playbooks/<name>/` directory entirely.
+ * Also checks `~/.polpo/playbooks/<name>/` if not found in polpoDir.
+ *
+ * @returns true if deleted, false if not found.
+ */
+export declare function deletePlaybook(cwd: string, polpoDir: string | undefined, name: string): boolean;
+//# sourceMappingURL=playbook-files.d.ts.map

package/dist/playbook-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-files.d.ts","sourceRoot":"","sources":["../src/playbook-files.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA+DtF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAkChF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAiB/G;AAGD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAarF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ/F"}

package/dist/playbook-files.js

@@ -0,0 +1,159 @@
+/**
+ * Playbook file persistence — discovery and CRUD over the .polpo/playbooks
+ * directory layout (with legacy templates/ compatibility). Pure logic
+ * (validation, instantiation) lives in @polpo-ai/core (playbook-logic).
+ */
+import { readdirSync, readFileSync, existsSync, realpathSync, statSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { validatePlaybookDefinition } from "@polpo-ai/core";
+import { getPolpoDir, getGlobalPolpoDir } from "./paths.js";
+// ── Discovery ──────────────────────────────────────────────────────────
+function scanPlaybookDir(dir) {
+    if (!existsSync(dir))
+        return [];
+    const results = [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        const entryPath = join(dir, entry);
+        // Follow symlinks
+        let realPath;
+        try {
+            realPath = realpathSync(entryPath);
+        }
+        catch {
+            continue; // broken symlink
+        }
+        // Must be a directory
+        try {
+            if (!statSync(realPath).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        // Must contain playbook.json or template.json (backward compat)
+        let playbookFile = join(realPath, "playbook.json");
+        if (!existsSync(playbookFile)) {
+            playbookFile = join(realPath, "template.json");
+            if (!existsSync(playbookFile))
+                continue;
+        }
+        try {
+            const raw = readFileSync(playbookFile, "utf-8");
+            const def = JSON.parse(raw);
+            if (!def.name || !def.description || !def.mission)
+                continue;
+            results.push({
+                name: def.name,
+                description: def.description,
+                parameters: def.parameters ?? [],
+                path: realPath,
+            });
+        }
+        catch {
+            // Invalid JSON — skip silently
+        }
+    }
+    return results;
+}
+/**
+ * Discover all available playbooks from known locations.
+ * Returns deduplicated list (first occurrence wins by name).
+ *
+ * Also scans legacy templates/ directories for backward compatibility.
+ */
+export function discoverPlaybooks(cwd, polpoDir) {
+    const seen = new Set();
+    const results = [];
+    const dirs = [];
+    // 1. Project-level: <polpoDir>/playbooks/ (+ legacy templates/)
+    if (polpoDir) {
+        dirs.push(join(polpoDir, "playbooks"));
+        dirs.push(join(polpoDir, "templates"));
+    }
+    // 2. Fallback if polpoDir is not the default .polpo
+    const defaultPolpoDir = getPolpoDir(cwd);
+    if (!polpoDir || resolve(polpoDir) !== resolve(defaultPolpoDir)) {
+        dirs.push(join(defaultPolpoDir, "playbooks"));
+        dirs.push(join(defaultPolpoDir, "templates"));
+    }
+    // 3. User-level: ~/.polpo/playbooks/ (+ legacy templates/)
+    const globalDir = getGlobalPolpoDir();
+    dirs.push(join(globalDir, "playbooks"));
+    dirs.push(join(globalDir, "templates"));
+    for (const dir of dirs) {
+        for (const pb of scanPlaybookDir(dir)) {
+            if (!seen.has(pb.name)) {
+                seen.add(pb.name);
+                results.push(pb);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Load a full playbook definition by name.
+ * Returns null if not found.
+ */
+export function loadPlaybook(cwd, polpoDir, name) {
+    const playbooks = discoverPlaybooks(cwd, polpoDir);
+    const info = playbooks.find(p => p.name === name);
+    if (!info)
+        return null;
+    // Try playbook.json first, then template.json (backward compat)
+    let playbookFile = join(info.path, "playbook.json");
+    if (!existsSync(playbookFile)) {
+        playbookFile = join(info.path, "template.json");
+    }
+    try {
+        const raw = readFileSync(playbookFile, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save a playbook to disk.
+ *
+ * Creates/overwrites `<polpoDir>/playbooks/<name>/playbook.json`.
+ * Validates the definition structure before writing.
+ *
+ * @returns The absolute path to the saved playbook directory.
+ * @throws If validation fails or the write fails.
+ */
+export function savePlaybook(polpoDir, definition) {
+    const errors = validatePlaybookDefinition(definition);
+    if (errors.length > 0) {
+        throw new Error(`Invalid playbook definition:\n  - ${errors.join("\n  - ")}`);
+    }
+    const playbookDir = join(polpoDir, "playbooks", definition.name);
+    mkdirSync(playbookDir, { recursive: true });
+    const playbookFile = join(playbookDir, "playbook.json");
+    writeFileSync(playbookFile, JSON.stringify(definition, null, 2), "utf-8");
+    return playbookDir;
+}
+/**
+ * Delete a playbook from disk.
+ *
+ * Removes the `<polpoDir>/playbooks/<name>/` directory entirely.
+ * Also checks `~/.polpo/playbooks/<name>/` if not found in polpoDir.
+ *
+ * @returns true if deleted, false if not found.
+ */
+export function deletePlaybook(cwd, polpoDir, name) {
+    // Find where the playbook lives
+    const playbooks = discoverPlaybooks(cwd, polpoDir);
+    const info = playbooks.find(p => p.name === name);
+    if (!info)
+        return false;
+    rmSync(info.path, { recursive: true, force: true });
+    return true;
+}
+//# sourceMappingURL=playbook-files.js.map

package/dist/playbook-files.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@polpo-ai/file-stores",
+  "version": "0.11.0",
+  "description": "File-based store implementations for Polpo — the default zero-dependency persistence backend (JSON/Markdown files)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "nanoid": "^5.0.9",
+    "@polpo-ai/core": "0.11.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lumea-labs/polpo.git",
+    "directory": "packages/file-stores"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  }
+}