@jmanuelcorral/openteam 0.1.27 → 0.1.28

package/dist/storage/fsStorageProvider.d.ts

@@ -0,0 +1,11 @@
+import type { StorageProvider } from "./provider";
+/**
+ * `StorageProvider` sobre `node:fs/promises`. Mapea rutas virtuales POSIX a
+ * disco bajo `root`. Es el adapter por defecto en producción.
+ *
+ * Semántica: `read`/`stat` devuelven `undefined` ante ENOENT; `write`/`append`
+ * crean directorios intermedios; `list` devuelve `[]` si el directorio no
+ * existe; `delete` es idempotente (usa `rm` con `force`).
+ */
+export declare function createFsStorageProvider(root: string): StorageProvider;
+//# sourceMappingURL=fsStorageProvider.d.ts.map

package/dist/storage/fsStorageProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsStorageProvider.d.ts","sourceRoot":"","sources":["../../src/storage/fsStorageProvider.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAW/D;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAgFrE"}

package/dist/storage/index.d.ts

@@ -0,0 +1,5 @@
+export { createFsStorageProvider } from "./fsStorageProvider";
+export { createMemoryStorageProvider } from "./memoryStorageProvider";
+export { joinVirtualPath, normalizeVirtualPath, parentVirtualPath, StoragePathError, splitVirtualPath, } from "./path";
+export type { StorageProvider, StorageStat } from "./provider";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/storage/memoryStorageProvider.d.ts

@@ -0,0 +1,11 @@
+import type { StorageProvider } from "./provider";
+/**
+ * `StorageProvider` en memoria basado en `Map`. Determinista y sin I/O real:
+ * pensado para tests y como implementación de referencia del contrato.
+ *
+ * Los directorios son implícitos (derivados de los ficheros existentes) pero
+ * también pueden crearse vacíos con `mkdir`. Un contador monótono provee
+ * `mtimeMs` reproducible por secuencia de operaciones.
+ */
+export declare function createMemoryStorageProvider(): StorageProvider;
+//# sourceMappingURL=memoryStorageProvider.d.ts.map

package/dist/storage/memoryStorageProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryStorageProvider.d.ts","sourceRoot":"","sources":["../../src/storage/memoryStorageProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,IAAI,eAAe,CAwH7D"}

package/dist/storage/path.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Normalización **pura** de rutas virtuales del `StorageProvider`.
+ *
+ * Las rutas son POSIX (`/`), relativas a la raíz lógica del provider. No hay
+ * I/O aquí: solo manipulación de strings determinista. La raíz se representa
+ * como cadena vacía `""`.
+ */
+/** Error lanzado cuando una ruta intenta escapar por encima de la raíz. */
+export declare class StoragePathError extends Error {
+    constructor(message: string);
+}
+/**
+ * Normaliza una ruta virtual a POSIX relativa sin `.`/`..` ni segmentos vacíos.
+ * Acepta separadores `\` o `/`. Un `..` que escape por encima de la raíz lanza
+ * `StoragePathError`. La raíz (`""`, `"/"`, `"."`) se normaliza a `""`.
+ */
+export declare function normalizeVirtualPath(input: string): string;
+/** Une segmentos y normaliza el resultado a una ruta virtual. */
+export declare function joinVirtualPath(...segments: string[]): string;
+/**
+ * Devuelve el directorio padre de una ruta virtual normalizada (`""` si es un
+ * hijo directo de la raíz o la propia raíz).
+ */
+export declare function parentVirtualPath(path: string): string;
+/** Descompone una ruta virtual normalizada en sus segmentos (`[]` para la raíz). */
+export declare function splitVirtualPath(path: string): string[];
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/storage/path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2EAA2E;AAC3E,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkB1D;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGvD"}

package/dist/storage/provider.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `StorageProvider` — boundary de persistencia de openteam.
+ *
+ * Modela un **sistema de ficheros virtual** (`path → content`) con rutas POSIX
+ * relativas a una raíz lógica (ver `path.ts`). Es la única superficie de I/O
+ * para artefactos del equipo (roster/decisions/backlog en Markdown y logs de
+ * sesión en JSONL). Los adapters concretos (`fsStorageProvider`,
+ * `memoryStorageProvider`, futuros remotos) implementan este contrato.
+ *
+ * Reglas del contrato (verificadas por `tests/storage/contract.ts`):
+ * - `read`/`stat` devuelven `undefined` si la ruta no existe (nunca lanzan por
+ *   fichero inexistente).
+ * - `write`/`append` crean los directorios intermedios necesarios.
+ * - `list` devuelve los nombres de los hijos **inmediatos** (no recursivo),
+ *   ordenados alfabéticamente, y `[]` si el directorio no existe.
+ * - `mkdir` es idempotente y recursivo.
+ * - `delete` es idempotente (no lanza si la ruta no existe).
+ *
+ * Este módulo **no** contiene I/O: solo tipos. `router/` nunca lo importa.
+ */
+/** Metadatos de una entrada del storage. */
+export type StorageStat = {
+    /** Tamaño en bytes del contenido (0 para directorios). */
+    size: number;
+    /** Última modificación en epoch ms. */
+    mtimeMs: number;
+    /** `true` si la entrada es un directorio. */
+    isDirectory: boolean;
+};
+/** Contrato de persistencia con semántica de sistema de ficheros virtual. */
+export interface StorageProvider {
+    /** Lee el contenido de un fichero; `undefined` si no existe. */
+    read(path: string): Promise<string | undefined>;
+    /** Escribe (sobrescribe) un fichero, creando directorios intermedios. */
+    write(path: string, content: string): Promise<void>;
+    /** Añade contenido al final de un fichero, creándolo si no existe. */
+    append(path: string, content: string): Promise<void>;
+    /** `true` si la ruta existe como fichero o directorio. */
+    exists(path: string): Promise<boolean>;
+    /** Nombres de los hijos inmediatos de un directorio, ordenados; `[]` si no existe. */
+    list(dir: string): Promise<string[]>;
+    /** `true` solo si la ruta existe y es un directorio. */
+    isDirectory(path: string): Promise<boolean>;
+    /** Crea un directorio (recursivo, idempotente). */
+    mkdir(dir: string): Promise<void>;
+    /** Borra un fichero; idempotente si no existe. */
+    delete(path: string): Promise<void>;
+    /** Metadatos de la entrada; `undefined` si no existe. */
+    stat(path: string): Promise<StorageStat | undefined>;
+}
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/storage/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG;IACxB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChD,yEAAyE;IACzE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,sEAAsE;IACtE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,sFAAsF;IACtF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,wDAAwD;IACxD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,mDAAmD;IACnD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,kDAAkD;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,yDAAyD;IACzD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACtD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmanuelcorral/openteam",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "description": "Plugin opencode de routing coste-consciente local-first con orquestación Squad.",
   "license": "MIT",
   "author": "Jose Manuel Corral",