@bradygaster/squad-sdk 0.9.1 → 0.9.2-insider.2

package/dist/state/squad-state.d.ts

@@ -0,0 +1,42 @@
+/**
+ * State Module — SquadState Facade
+ *
+ * Top-level typed API for reading and writing `.squad/` state.
+ * Composes the collection facades (agents, decisions, routing, team)
+ * over a pluggable StorageProvider.
+ *
+ * @module state/squad-state
+ */
+import type { StorageProvider } from '../storage/storage-provider.js';
+import { AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection } from './collections.js';
+export declare class SquadState {
+    private readonly storage;
+    private readonly _rootDir;
+    readonly agents: AgentsCollection;
+    readonly config: ConfigCollection;
+    readonly decisions: DecisionsCollection;
+    readonly routing: RoutingCollection;
+    readonly team: TeamCollection;
+    readonly skills: SkillsCollection;
+    readonly templates: TemplatesCollection;
+    readonly log: LogCollection;
+    private constructor();
+    /** The project root directory this SquadState is bound to. */
+    get root(): string;
+    /** The underlying StorageProvider used by this instance. */
+    get provider(): StorageProvider;
+    /**
+     * Factory method — validates that `rootDir/.squad/` exists before
+     * returning a new SquadState instance.
+     */
+    static create(storage: StorageProvider, rootDir: string): Promise<SquadState>;
+    /**
+     * Synchronous factory — creates SquadState without validating `.squad/`
+     * existence.  For internal SDK use where the caller already knows the
+     * root is initialized (e.g., modules operating on an existing project).
+     */
+    static fromStorage(storage: StorageProvider, rootDir: string): SquadState;
+    /** Check if a `.squad/` directory exists at the root. */
+    isInitialized(): Promise<boolean>;
+}
+//# sourceMappingURL=squad-state.d.ts.map

package/dist/state/squad-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"squad-state.d.ts","sourceRoot":"","sources":["../../src/state/squad-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAG1B,qBAAa,UAAU;IAWnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAX3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAE5B,OAAO;IAcP,8DAA8D;IAC9D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4DAA4D;IAC5D,IAAI,QAAQ,IAAI,eAAe,CAE9B;IAED;;;OAGG;WACU,MAAM,CACjB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC;IAStB;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,UAAU;IAIb,yDAAyD;IACnD,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;CAGxC"}

package/dist/state/squad-state.js

@@ -0,0 +1,68 @@
+/**
+ * State Module — SquadState Facade
+ *
+ * Top-level typed API for reading and writing `.squad/` state.
+ * Composes the collection facades (agents, decisions, routing, team)
+ * over a pluggable StorageProvider.
+ *
+ * @module state/squad-state
+ */
+import { AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection, } from './collections.js';
+import { NotFoundError } from './domain-types.js';
+export class SquadState {
+    storage;
+    _rootDir;
+    agents;
+    config;
+    decisions;
+    routing;
+    team;
+    skills;
+    templates;
+    log;
+    constructor(storage, _rootDir) {
+        this.storage = storage;
+        this._rootDir = _rootDir;
+        this.agents = new AgentsCollection(storage, _rootDir);
+        this.config = new ConfigCollection(storage, _rootDir);
+        this.decisions = new DecisionsCollection(storage, _rootDir);
+        this.routing = new RoutingCollection(storage, _rootDir);
+        this.team = new TeamCollection(storage, _rootDir);
+        this.skills = new SkillsCollection(storage, _rootDir);
+        this.templates = new TemplatesCollection(storage, _rootDir);
+        this.log = new LogCollection(storage, _rootDir);
+    }
+    /** The project root directory this SquadState is bound to. */
+    get root() {
+        return this._rootDir;
+    }
+    /** The underlying StorageProvider used by this instance. */
+    get provider() {
+        return this.storage;
+    }
+    /**
+     * Factory method — validates that `rootDir/.squad/` exists before
+     * returning a new SquadState instance.
+     */
+    static async create(storage, rootDir) {
+        const squadDir = `${rootDir}/.squad`;
+        const exists = await storage.exists(squadDir);
+        if (!exists) {
+            throw new NotFoundError('squad', rootDir);
+        }
+        return new SquadState(storage, rootDir);
+    }
+    /**
+     * Synchronous factory — creates SquadState without validating `.squad/`
+     * existence.  For internal SDK use where the caller already knows the
+     * root is initialized (e.g., modules operating on an existing project).
+     */
+    static fromStorage(storage, rootDir) {
+        return new SquadState(storage, rootDir);
+    }
+    /** Check if a `.squad/` directory exists at the root. */
+    async isInitialized() {
+        return this.storage.exists(`${this._rootDir}/.squad`);
+    }
+}
+//# sourceMappingURL=squad-state.js.map

package/dist/state/squad-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"squad-state.js","sourceRoot":"","sources":["../../src/state/squad-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,OAAO,UAAU;IAWF;IACA;IAXV,MAAM,CAAmB;IACzB,MAAM,CAAmB;IACzB,SAAS,CAAsB;IAC/B,OAAO,CAAoB;IAC3B,IAAI,CAAiB;IACrB,MAAM,CAAmB;IACzB,SAAS,CAAsB;IAC/B,GAAG,CAAgB;IAE5B,YACmB,OAAwB,EACxB,QAAgB;QADhB,YAAO,GAAP,OAAO,CAAiB;QACxB,aAAQ,GAAR,QAAQ,CAAQ;QAEjC,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,8DAA8D;IAC9D,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,4DAA4D;IAC5D,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,OAAwB,EACxB,OAAe;QAEf,MAAM,QAAQ,GAAG,GAAG,OAAO,SAAS,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAChB,OAAwB,EACxB,OAAe;QAEf,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,SAAS,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/storage/fs-storage-provider.d.ts

@@ -0,0 +1,60 @@
+import type { StorageProvider, StorageStats } from './storage-provider.js';
+/**
+ * FSStorageProvider — Node.js `fs` implementation of StorageProvider.
+ *
+ * - ENOENT reads return `undefined` (no throw).
+ * - Writes create parent directories recursively.
+ * - Appends create the file (and parent dirs) if missing.
+ * - delete is a no-op when the file does not exist.
+ * - list returns an empty array for a missing directory.
+ * - Optional `rootDir` confines all operations to a specific directory tree.
+ */
+export declare class FSStorageProvider implements StorageProvider {
+    private static readonly CASE_INSENSITIVE;
+    private readonly rootDir?;
+    constructor(rootDir?: string);
+    private pathStartsWith;
+    private pathEquals;
+    /**
+     * Validates that filePath resolves within rootDir and does not escape
+     * via path traversal or symlinks.
+     *
+     * ⚠️ TOCTOU: This is a user-space check. Between validation and the
+     * subsequent fs operation, a path component could theoretically be
+     * swapped for a symlink. This is an inherent limitation of user-space
+     * path validation on POSIX systems. For defense-in-depth, callers
+     * operating in hostile environments should use OS-level confinement
+     * (chroot, namespaces, or sandboxing) in addition to this check.
+     */
+    private assertSafePath;
+    private assertSafePathSync;
+    read(filePath: string): Promise<string | undefined>;
+    write(filePath: string, data: string): Promise<void>;
+    append(filePath: string, data: string): Promise<void>;
+    exists(filePath: string): Promise<boolean>;
+    list(dirPath: string): Promise<string[]>;
+    delete(filePath: string): Promise<void>;
+    readSync(filePath: string): string | undefined;
+    writeSync(filePath: string, data: string): void;
+    existsSync(filePath: string): boolean;
+    listSync(dirPath: string): string[];
+    deleteDir(dirPath: string): Promise<void>;
+    isDirectory(targetPath: string): Promise<boolean>;
+    mkdir(dirPath: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    copy(srcPath: string, destPath: string): Promise<void>;
+    stat(targetPath: string): Promise<StorageStats | undefined>;
+    isDirectorySync(targetPath: string): boolean;
+    mkdirSync(dirPath: string, options?: {
+        recursive?: boolean;
+    }): void;
+    statSync(targetPath: string): StorageStats | undefined;
+    appendSync(filePath: string, data: string): void;
+    deleteSync(filePath: string): void;
+    renameSync(oldPath: string, newPath: string): void;
+    copySync(srcPath: string, destPath: string): void;
+    deleteDirSync(dirPath: string): void;
+}
+//# sourceMappingURL=fs-storage-provider.d.ts.map

package/dist/storage/fs-storage-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-storage-provider.d.ts","sourceRoot":"","sources":["../../src/storage/fs-storage-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG3E;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAiE;IACzG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;gBAEtB,OAAO,CAAC,EAAE,MAAM;IAI5B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,UAAU;IAOlB;;;;;;;;;;OAUG;YACW,cAAc;IAwC5B,OAAO,CAAC,kBAAkB;IAwCpB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAUnD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUxC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAU9C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAU/C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAU7B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAWjE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS5C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAUnE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWtD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAUhD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUlC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWlD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWjD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CASrC"}

package/dist/storage/fs-storage-provider.js

@@ -0,0 +1,377 @@
+import { readFile, writeFile, appendFile, access, readdir, unlink, mkdir as fsMkdir, realpath, rm, stat as fsStat, rename as fsRename, copyFile } from 'fs/promises';
+import { readFileSync, writeFileSync, appendFileSync, existsSync as fsExistsSync, mkdirSync as fsMkdirSync, realpathSync, readdirSync, statSync, unlinkSync, renameSync as fsRenameSync, copyFileSync, rmSync } from 'fs';
+import { dirname, resolve, sep } from 'path';
+import { StorageError } from './storage-error.js';
+/**
+ * FSStorageProvider — Node.js `fs` implementation of StorageProvider.
+ *
+ * - ENOENT reads return `undefined` (no throw).
+ * - Writes create parent directories recursively.
+ * - Appends create the file (and parent dirs) if missing.
+ * - delete is a no-op when the file does not exist.
+ * - list returns an empty array for a missing directory.
+ * - Optional `rootDir` confines all operations to a specific directory tree.
+ */
+export class FSStorageProvider {
+    static CASE_INSENSITIVE = process.platform === 'win32' || process.platform === 'darwin';
+    rootDir;
+    constructor(rootDir) {
+        this.rootDir = rootDir ? realpathSync(resolve(rootDir)) : undefined;
+    }
+    pathStartsWith(fullPath, prefix) {
+        if (FSStorageProvider.CASE_INSENSITIVE) {
+            return fullPath.toLowerCase().startsWith(prefix.toLowerCase());
+        }
+        return fullPath.startsWith(prefix);
+    }
+    pathEquals(a, b) {
+        if (FSStorageProvider.CASE_INSENSITIVE) {
+            return a.toLowerCase() === b.toLowerCase();
+        }
+        return a === b;
+    }
+    /**
+     * Validates that filePath resolves within rootDir and does not escape
+     * via path traversal or symlinks.
+     *
+     * ⚠️ TOCTOU: This is a user-space check. Between validation and the
+     * subsequent fs operation, a path component could theoretically be
+     * swapped for a symlink. This is an inherent limitation of user-space
+     * path validation on POSIX systems. For defense-in-depth, callers
+     * operating in hostile environments should use OS-level confinement
+     * (chroot, namespaces, or sandboxing) in addition to this check.
+     */
+    async assertSafePath(filePath) {
+        if (!this.rootDir)
+            return filePath;
+        const resolved = resolve(this.rootDir, filePath);
+        // Check if resolved path is within rootDir
+        if (!this.pathStartsWith(resolved, this.rootDir + sep) && !this.pathEquals(resolved, this.rootDir)) {
+            throw new Error(`Path traversal blocked: ${filePath}`);
+        }
+        // Check for symlink traversal
+        try {
+            const real = await realpath(resolved);
+            if (!this.pathStartsWith(real, this.rootDir + sep) && !this.pathEquals(real, this.rootDir)) {
+                throw new Error(`Symlink traversal blocked: ${filePath}`);
+            }
+            return real;
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                // Walk up to nearest existing ancestor and verify it resolves within rootDir
+                let checkPath = resolved;
+                while (!this.pathEquals(checkPath, this.rootDir)) {
+                    checkPath = dirname(checkPath);
+                    try {
+                        const realAncestor = await realpath(checkPath);
+                        if (!this.pathStartsWith(realAncestor, this.rootDir + sep) && !this.pathEquals(realAncestor, this.rootDir)) {
+                            throw new Error(`Symlink traversal blocked: ${filePath}`);
+                        }
+                        return resolved;
+                    }
+                    catch (ancestorErr) {
+                        if (ancestorErr.code === 'ENOENT')
+                            continue;
+                        throw ancestorErr;
+                    }
+                }
+                return resolved;
+            }
+            throw err;
+        }
+    }
+    assertSafePathSync(filePath) {
+        if (!this.rootDir)
+            return filePath;
+        const resolved = resolve(this.rootDir, filePath);
+        // Check if resolved path is within rootDir
+        if (!this.pathStartsWith(resolved, this.rootDir + sep) && !this.pathEquals(resolved, this.rootDir)) {
+            throw new Error(`Path traversal blocked: ${filePath}`);
+        }
+        // Check for symlink traversal
+        try {
+            const real = realpathSync(resolved);
+            if (!this.pathStartsWith(real, this.rootDir + sep) && !this.pathEquals(real, this.rootDir)) {
+                throw new Error(`Symlink traversal blocked: ${filePath}`);
+            }
+            return real;
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                // Walk up to nearest existing ancestor and verify it resolves within rootDir
+                let checkPath = resolved;
+                while (!this.pathEquals(checkPath, this.rootDir)) {
+                    checkPath = dirname(checkPath);
+                    try {
+                        const realAncestor = realpathSync(checkPath);
+                        if (!this.pathStartsWith(realAncestor, this.rootDir + sep) && !this.pathEquals(realAncestor, this.rootDir)) {
+                            throw new Error(`Symlink traversal blocked: ${filePath}`);
+                        }
+                        return resolved;
+                    }
+                    catch (ancestorErr) {
+                        if (ancestorErr.code === 'ENOENT')
+                            continue;
+                        throw ancestorErr;
+                    }
+                }
+                return resolved;
+            }
+            throw err;
+        }
+    }
+    async read(filePath) {
+        const safePath = await this.assertSafePath(filePath);
+        try {
+            return await readFile(safePath, 'utf-8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return undefined;
+            throw new StorageError('read', filePath, err);
+        }
+    }
+    async write(filePath, data) {
+        const safePath = await this.assertSafePath(filePath);
+        try {
+            await fsMkdir(dirname(safePath), { recursive: true });
+            await writeFile(safePath, data, 'utf-8');
+        }
+        catch (err) {
+            throw new StorageError('write', filePath, err);
+        }
+    }
+    async append(filePath, data) {
+        const safePath = await this.assertSafePath(filePath);
+        try {
+            await fsMkdir(dirname(safePath), { recursive: true });
+            await appendFile(safePath, data, 'utf-8');
+        }
+        catch (err) {
+            throw new StorageError('append', filePath, err);
+        }
+    }
+    async exists(filePath) {
+        const safePath = await this.assertSafePath(filePath);
+        try {
+            await access(safePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async list(dirPath) {
+        const safePath = await this.assertSafePath(dirPath);
+        try {
+            return await readdir(safePath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return [];
+            throw new StorageError('list', dirPath, err);
+        }
+    }
+    async delete(filePath) {
+        const safePath = await this.assertSafePath(filePath);
+        try {
+            await unlink(safePath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return;
+            throw new StorageError('delete', filePath, err);
+        }
+    }
+    readSync(filePath) {
+        const safePath = this.assertSafePathSync(filePath);
+        try {
+            return readFileSync(safePath, 'utf-8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return undefined;
+            throw new StorageError('read', filePath, err);
+        }
+    }
+    writeSync(filePath, data) {
+        const safePath = this.assertSafePathSync(filePath);
+        try {
+            fsMkdirSync(dirname(safePath), { recursive: true });
+            writeFileSync(safePath, data, 'utf-8');
+        }
+        catch (err) {
+            throw new StorageError('write', filePath, err);
+        }
+    }
+    existsSync(filePath) {
+        const safePath = this.assertSafePathSync(filePath);
+        return fsExistsSync(safePath);
+    }
+    listSync(dirPath) {
+        const safePath = this.assertSafePathSync(dirPath);
+        try {
+            return readdirSync(safePath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return [];
+            throw new StorageError('list', dirPath, err);
+        }
+    }
+    async deleteDir(dirPath) {
+        const safePath = await this.assertSafePath(dirPath);
+        try {
+            await rm(safePath, { recursive: true, force: true });
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return;
+            throw new StorageError('deleteDir', dirPath, err);
+        }
+    }
+    // ── Phase 3 Wave 1 additions ────────────────────────────────────────────
+    async isDirectory(targetPath) {
+        const safePath = await this.assertSafePath(targetPath);
+        try {
+            const s = await fsStat(safePath);
+            return s.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    async mkdir(dirPath, options) {
+        const safePath = await this.assertSafePath(dirPath);
+        try {
+            await fsMkdir(safePath, { recursive: options?.recursive ?? false });
+        }
+        catch (err) {
+            if (err.code === 'EEXIST')
+                return;
+            throw new StorageError('mkdir', dirPath, err);
+        }
+    }
+    async rename(oldPath, newPath) {
+        const safeOld = await this.assertSafePath(oldPath);
+        const safeNew = await this.assertSafePath(newPath);
+        try {
+            await fsMkdir(dirname(safeNew), { recursive: true });
+            await fsRename(safeOld, safeNew);
+        }
+        catch (err) {
+            throw new StorageError('rename', oldPath, err);
+        }
+    }
+    async copy(srcPath, destPath) {
+        const safeSrc = await this.assertSafePath(srcPath);
+        const safeDest = await this.assertSafePath(destPath);
+        try {
+            await fsMkdir(dirname(safeDest), { recursive: true });
+            await copyFile(safeSrc, safeDest);
+        }
+        catch (err) {
+            throw new StorageError('copy', srcPath, err);
+        }
+    }
+    async stat(targetPath) {
+        const safePath = await this.assertSafePath(targetPath);
+        try {
+            const s = await fsStat(safePath);
+            return { size: s.size, mtimeMs: s.mtimeMs, isDirectory: s.isDirectory() };
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return undefined;
+            throw new StorageError('stat', targetPath, err);
+        }
+    }
+    isDirectorySync(targetPath) {
+        const safePath = this.assertSafePathSync(targetPath);
+        try {
+            return statSync(safePath).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    mkdirSync(dirPath, options) {
+        const safePath = this.assertSafePathSync(dirPath);
+        try {
+            fsMkdirSync(safePath, { recursive: options?.recursive ?? false });
+        }
+        catch (err) {
+            if (err.code === 'EEXIST')
+                return;
+            throw new StorageError('mkdir', dirPath, err);
+        }
+    }
+    statSync(targetPath) {
+        const safePath = this.assertSafePathSync(targetPath);
+        try {
+            const s = statSync(safePath);
+            return { size: s.size, mtimeMs: s.mtimeMs, isDirectory: s.isDirectory() };
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return undefined;
+            throw new StorageError('stat', targetPath, err);
+        }
+    }
+    appendSync(filePath, data) {
+        const safePath = this.assertSafePathSync(filePath);
+        try {
+            fsMkdirSync(dirname(safePath), { recursive: true });
+            appendFileSync(safePath, data, 'utf-8');
+        }
+        catch (err) {
+            throw new StorageError('append', filePath, err);
+        }
+    }
+    deleteSync(filePath) {
+        const safePath = this.assertSafePathSync(filePath);
+        try {
+            unlinkSync(safePath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return;
+            throw new StorageError('delete', filePath, err);
+        }
+    }
+    renameSync(oldPath, newPath) {
+        const safeOld = this.assertSafePathSync(oldPath);
+        const safeNew = this.assertSafePathSync(newPath);
+        try {
+            fsMkdirSync(dirname(safeNew), { recursive: true });
+            fsRenameSync(safeOld, safeNew);
+        }
+        catch (err) {
+            throw new StorageError('rename', oldPath, err);
+        }
+    }
+    copySync(srcPath, destPath) {
+        const safeSrc = this.assertSafePathSync(srcPath);
+        const safeDest = this.assertSafePathSync(destPath);
+        try {
+            fsMkdirSync(dirname(safeDest), { recursive: true });
+            copyFileSync(safeSrc, safeDest);
+        }
+        catch (err) {
+            throw new StorageError('copy', srcPath, err);
+        }
+    }
+    deleteDirSync(dirPath) {
+        const safePath = this.assertSafePathSync(dirPath);
+        try {
+            rmSync(safePath, { recursive: true, force: true });
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return;
+            throw new StorageError('deleteDir', dirPath, err);
+        }
+    }
+}
+//# sourceMappingURL=fs-storage-provider.js.map

package/dist/storage/fs-storage-provider.js.map

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

package/dist/storage/in-memory-storage-provider.d.ts

@@ -0,0 +1,46 @@
+import type { StorageProvider, StorageStats } from './storage-provider.js';
+/**
+ * InMemoryStorageProvider — test-friendly StorageProvider backed by a Map.
+ *
+ * No filesystem access. All paths are normalized to forward-slash POSIX form.
+ * Useful for unit tests and DI scenarios where real I/O is undesirable.
+ */
+export declare class InMemoryStorageProvider implements StorageProvider {
+    private files;
+    /** Track write timestamps for stat(). Key = normalized path, value = epoch ms. */
+    private mtimes;
+    private norm;
+    read(filePath: string): Promise<string | undefined>;
+    write(filePath: string, data: string): Promise<void>;
+    append(filePath: string, data: string): Promise<void>;
+    exists(filePath: string): Promise<boolean>;
+    list(dirPath: string): Promise<string[]>;
+    delete(filePath: string): Promise<void>;
+    deleteDir(dirPath: string): Promise<void>;
+    isDirectory(targetPath: string): Promise<boolean>;
+    mkdir(dirPath: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    copy(srcPath: string, destPath: string): Promise<void>;
+    stat(targetPath: string): Promise<StorageStats | undefined>;
+    readSync(filePath: string): string | undefined;
+    writeSync(filePath: string, data: string): void;
+    existsSync(filePath: string): boolean;
+    listSync(dirPath: string): string[];
+    isDirectorySync(targetPath: string): boolean;
+    mkdirSync(_dirPath: string, _options?: {
+        recursive?: boolean;
+    }): void;
+    statSync(targetPath: string): StorageStats | undefined;
+    appendSync(filePath: string, data: string): void;
+    deleteSync(filePath: string): void;
+    renameSync(oldPath: string, newPath: string): void;
+    copySync(srcPath: string, destPath: string): void;
+    deleteDirSync(dirPath: string): void;
+    /** Return a shallow copy of the internal state for test assertions. */
+    snapshot(): Map<string, string>;
+    /** Reset all stored files. */
+    clear(): void;
+}
+//# sourceMappingURL=in-memory-storage-provider.d.ts.map

package/dist/storage/in-memory-storage-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-storage-provider.d.ts","sourceRoot":"","sources":["../../src/storage/in-memory-storage-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE3E;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,KAAK,CAA6B;IAC1C,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAA6B;IAE3C,OAAO,CAAC,IAAI;IAMN,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAInD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCvD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IA0BjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAcnC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAW5C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAKrE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAwBtD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMlC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAqClD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAajD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAYpC,uEAAuE;IACvE,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI/B,8BAA8B;IAC9B,KAAK,IAAI,IAAI;CAId"}