oficina-opencode 2.0.0 → 2.1.0

package/dist/core/types.js

@@ -22,6 +22,7 @@ export const DEFAULT_LIMITS = {
     maxAgentCalls: 40,
     minCatalogCoverage: 0.6,
     gateRequiredBeforeDone: true,
+    evidenceRequiredBeforeDone: true,
     reviewerNeqOwner: true,
 };
 //# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6CH,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,mBAAmB,EAAE,EAAE;IACvB,aAAa,EAAE,CAAC;IAChB,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,CAAC;IACnB,mBAAmB,EAAE,GAAG;IACxB,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,CAAC;IACtB,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE,EAAE;IACjB,kBAAkB,EAAE,GAAG;IACvB,sBAAsB,EAAE,IAAI;IAC5B,gBAAgB,EAAE,IAAI;CACvB,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqDH,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,mBAAmB,EAAE,EAAE;IACvB,aAAa,EAAE,CAAC;IAChB,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,CAAC;IACnB,mBAAmB,EAAE,GAAG;IACxB,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,CAAC;IACtB,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE,EAAE;IACjB,kBAAkB,EAAE,GAAG;IACvB,sBAAsB,EAAE,IAAI;IAC5B,0BAA0B,EAAE,IAAI;IAChC,gBAAgB,EAAE,IAAI;CACvB,CAAA"}

package/dist/hooks/scopeGuard.d.ts

@@ -5,30 +5,102 @@
  * una instrucción en una restricción. Un prompt le pide al modelo que sea
  * cuidadoso; este hook le impide hacerlo.
  *
- * Cuando una sesión intenta escribir un archivo que no está en el scope de
- * su card, la operación se rechaza con un error que explica qué hacer.
+ * ## Qué cambió y por qué
  *
- * El guard tiene una salida: si el archivo es claramente correcto y el
- * modelo insiste, el scope de la card se puede ampliar. Pero el default es
- * denegar.
+ * La versión anterior comparaba strings:
+ *
+ *     const relative = path.relative(projectRoot, absolute)
+ *     if (!matchesScope(relative, mayTouch)) throw ...
+ *
+ * Eso se puede eludir por tres vías, y las tres eran reales:
+ *
+ *   1. **Symlink.** `src/link.ts` -> `../../etc/secrets.ts`. El relativo es
+ *      `src/link.ts`, que matchea `src/**`. Autorizado. La escritura pasa.
+ *   2. **`mayTouch: ["**"]`.** `**` matcheaba cualquier string, incluido
+ *      `../../etc/passwd`. Un `**` tiene que significar "el proyecto", no
+ *      "el filesystem".
+ *   3. **Paths absolutos.** `/etc/passwd` tiene un relativo `../../etc/passwd`
+ *      y con `**` pasaba de largo.
+ *
+ * Ahora la ruta se **resuelve** (absoluta -> normalizada -> symlinks
+ * resueltos -> realpath) y recién ahí se decide. Y la decisión es
+ * fail-closed.
+ *
+ * ## Qué cubre ahora
+ *
+ * - **Todas las tools que escriben un archivo**, no solo `edit`/`write`:
+ *   `patch` (incluyendo diffs multi-archivo), `multiedit`, `notebook_edit`,
+ *   `str_replace`, y las variantes con prefijo de provider.
+ * - **Los comandos de shell.** `bash > ../fuera`, `cp a /etc/passwd`,
+ *   `sed -i`, `python -c "open(...)"` se analizan antes de ejecutarse.
+ * - **Los subagentes.** Un subagente es una sesion hija; el guard sube por
+ *   la cadena de padres hasta encontrar la sesion que tiene la card, y le
+ *   aplica el MISMO scope. Sin esto, delegar era un escalón para salirse.
+ * - **Los archivos sensibles.** `.env`, `.npmrc`, `.git/**`, claves privadas:
+ *   jamas escribibles, pase lo que pase el scope de la card.
+ *
+ * ## Lo que este hook NO puede hacer
+ *
+ * Un comando de shell con un interpreter embebido puede escribir en
+ * cualquier lado, y no hay forma de saberlo antes de correrlo. Para eso
+ * esta el tripwire (`core/tripwire.ts`): se arma antes del comando y se
+ * verifica despues. Es deteccion, no prevencion — y por eso el README lo
+ * dice asi, en vez de prometer un aislamiento que no existe.
  */
+import type { Card, OfficeState } from "../core/types.js";
 import type { Office } from "../core/office.js";
+import { globToRegex, matchesScope } from "../core/sandbox.js";
 export interface ScopeGuardOptions {
     /** Si es false, el guard solo avisa y no bloquea. */
     enforce: boolean;
+    /**
+     * Resuelve el `parentID` de una sesión.
+     *
+     * Es lo que hace que los subagentes hereden el scope: el hijo sube por
+     * la cadena hasta encontrar la sesión con la card.
+     */
+    resolveParentSession?: (sessionID: string) => Promise<string | undefined>;
+    /**
+     * Qué hacer con los comandos de shell.
+     *
+     * - `block`: un comando que claramente escribe fuera del scope se bloquea.
+     * - `warn`: se avisa pero se deja pasar (el tripwire cubre).
+     */
+    shellPolicy?: "block" | "warn";
+    /** Profundidad maxima de la cadena de padres que se recorre. */
+    maxParentDepth?: number;
 }
 /**
- * Glob mínimo a regex. Soporta `*`, `**` y `?`.
+ * Extrae TODOS los paths que una tool de escritura quiere tocar.
  *
- * El orden de los reemplazos importa: el `?` se convierte ANTES de insertar
- * los patrones de `**`, porque el grupo insertado contiene un `?` literal
- * que, si se convierte después, se rompe y deja de matchear.
+ * La versión anterior devolvía un solo path, y para `patch` leía **solo el
+ * primer** `---` del diff. Un diff de cinco archivos pasaba el control con
+ * el primero y se escribían los otros cuatro.
+ */
+export declare function extractPaths(tool: string, args: Record<string, unknown>): string[];
+/**
+ * Paths de un diff unificado.
+ *
+ * Lee **todas** las lineas `---` y `+++`. Si el diff usa el prefijo de git
+ * (`a/`, `b/`) se lo saca, pero solo si AMBOS lados lo usan: un archivo
+ * llamado `a/notas.md` es un path legitimo.
+ */
+export declare function pathsFromPatch(patch: string): string[];
+/**
+ * El path de una tool de escritura. Se mantiene por compatibilidad con el
+ * API anterior; `extractPaths` es la version que hay que usar.
  */
-export declare function globToRegex(glob: string): RegExp;
-/** ¿El path cae dentro de alguno de los globs? */
-export declare function matchesScope(relativePath: string, globs: string[]): boolean;
-/** Extrae el path del argumento de una tool de escritura. */
 export declare function extractPath(tool: string, args: Record<string, unknown>): string | undefined;
+/** El comando de una tool de shell. */
+export declare function extractCommand(args: Record<string, unknown>): string | undefined;
+/**
+ * La card que gobierna una sesión.
+ *
+ * Primero mira el binding directo. Si no hay, sube por la cadena de
+ * padres: un subagente es una sesión hija, y su scope es el de quien lo
+ * lanzo.
+ */
+export declare function resolveScopeCard(state: OfficeState, sessionID: string, options: ScopeGuardOptions): Promise<Card | undefined>;
 export declare function createScopeGuardHook(office: Office, options?: ScopeGuardOptions): (input: {
     tool: string;
     sessionID: string;
@@ -36,4 +108,5 @@ export declare function createScopeGuardHook(office: Office, options?: ScopeGuar
 }, output: {
     args: Record<string, unknown>;
 }) => Promise<void>;
+export { globToRegex, matchesScope };
 //# sourceMappingURL=scopeGuard.d.ts.map

package/dist/hooks/scopeGuard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scopeGuard.d.ts","sourceRoot":"","sources":["../../src/hooks/scopeGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAQ/C,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWhD;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAM3E;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAe3F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAqC,IAE/F,OAAO;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1D,QAAQ;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KACxC,OAAO,CAAC,IAAI,CAAC,CAkDjB"}
+{"version":3,"file":"scopeGuard.d.ts","sourceRoot":"","sources":["../../src/hooks/scopeGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAGL,WAAW,EACX,YAAY,EAEb,MAAM,oBAAoB,CAAA;AA8C3B,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACzE;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC9B,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AASD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAiDlF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA2BtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAE3F;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAMhF;AAMD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAkC3B;AAUD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAqC,IAI/F,OAAO;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1D,QAAQ;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KACxC,OAAO,CAAC,IAAI,CAAC,CAoFjB;AAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAA"}

package/dist/hooks/scopeGuard.js

@@ -5,100 +5,333 @@
  * una instrucción en una restricción. Un prompt le pide al modelo que sea
  * cuidadoso; este hook le impide hacerlo.
  *
- * Cuando una sesión intenta escribir un archivo que no está en el scope de
- * su card, la operación se rechaza con un error que explica qué hacer.
+ * ## Qué cambió y por qué
  *
- * El guard tiene una salida: si el archivo es claramente correcto y el
- * modelo insiste, el scope de la card se puede ampliar. Pero el default es
- * denegar.
+ * La versión anterior comparaba strings:
+ *
+ *     const relative = path.relative(projectRoot, absolute)
+ *     if (!matchesScope(relative, mayTouch)) throw ...
+ *
+ * Eso se puede eludir por tres vías, y las tres eran reales:
+ *
+ *   1. **Symlink.** `src/link.ts` -> `../../etc/secrets.ts`. El relativo es
+ *      `src/link.ts`, que matchea `src/**`. Autorizado. La escritura pasa.
+ *   2. **`mayTouch: ["**"]`.** `**` matcheaba cualquier string, incluido
+ *      `../../etc/passwd`. Un `**` tiene que significar "el proyecto", no
+ *      "el filesystem".
+ *   3. **Paths absolutos.** `/etc/passwd` tiene un relativo `../../etc/passwd`
+ *      y con `**` pasaba de largo.
+ *
+ * Ahora la ruta se **resuelve** (absoluta -> normalizada -> symlinks
+ * resueltos -> realpath) y recién ahí se decide. Y la decisión es
+ * fail-closed.
+ *
+ * ## Qué cubre ahora
+ *
+ * - **Todas las tools que escriben un archivo**, no solo `edit`/`write`:
+ *   `patch` (incluyendo diffs multi-archivo), `multiedit`, `notebook_edit`,
+ *   `str_replace`, y las variantes con prefijo de provider.
+ * - **Los comandos de shell.** `bash > ../fuera`, `cp a /etc/passwd`,
+ *   `sed -i`, `python -c "open(...)"` se analizan antes de ejecutarse.
+ * - **Los subagentes.** Un subagente es una sesion hija; el guard sube por
+ *   la cadena de padres hasta encontrar la sesion que tiene la card, y le
+ *   aplica el MISMO scope. Sin esto, delegar era un escalón para salirse.
+ * - **Los archivos sensibles.** `.env`, `.npmrc`, `.git/**`, claves privadas:
+ *   jamas escribibles, pase lo que pase el scope de la card.
+ *
+ * ## Lo que este hook NO puede hacer
+ *
+ * Un comando de shell con un interpreter embebido puede escribir en
+ * cualquier lado, y no hay forma de saberlo antes de correrlo. Para eso
+ * esta el tripwire (`core/tripwire.ts`): se arma antes del comando y se
+ * verifica despues. Es deteccion, no prevencion — y por eso el README lo
+ * dice asi, en vez de prometer un aislamiento que no existe.
  */
-import path from "node:path";
+import { analyzeShellCommand, checkScope, globToRegex, matchesScope, } from "../core/sandbox.js";
 import { logger } from "../core/log.js";
 const log = logger("oficina:scope-guard");
-/** Tools que escriben en disco. */
-const WRITE_TOOLS = new Set(["edit", "write", "patch", "multiedit", "apply_patch"]);
 /**
- * Glob mínimo a regex. Soporta `*`, `**` y `?`.
+ * Tools que escriben UN archivo.
  *
- * El orden de los reemplazos importa: el `?` se convierte ANTES de insertar
- * los patrones de `**`, porque el grupo insertado contiene un `?` literal
- * que, si se convierte después, se rompe y deja de matchear.
+ * Se listan con prefijos porque cada provider registra sus tools con
+ * nombre distinto (`str_replace`, `str_replace_based_edit_tool`,
+ * `edit_notebook_file`...). El prefijo cubre la familia entera.
  */
-export function globToRegex(glob) {
-    const escaped = glob
-        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
-        // `?` primero: los patrones insertados después contienen `?` literal.
-        .replace(/\?/g, ".")
-        .replace(/\*\*\//g, "\u0000")
-        .replace(/\*\*/g, "\u0001")
-        .replace(/\*/g, "[^/]*")
-        .replace(/\u0000/g, "(?:.*/)?")
-        .replace(/\u0001/g, ".*");
-    return new RegExp(`^${escaped}$`);
-}
-/** ¿El path cae dentro de alguno de los globs? */
-export function matchesScope(relativePath, globs) {
-    const normalized = relativePath.replace(/\\/g, "/").replace(/^\.\//, "");
-    return globs.some((glob) => {
-        if (glob === "**")
-            return true;
-        return globToRegex(glob).test(normalized);
+const FILE_WRITE_TOOLS = new Set([
+    "edit",
+    "write",
+    "patch",
+    "multiedit",
+    "apply_patch",
+    "notebook_edit",
+    "str_replace",
+    "str_replace_editor",
+    "str_replace_based_edit_tool",
+    "edit_file",
+    "edit_notebook_file",
+    "create_file",
+    "write_file",
+    "create_or_update_file",
+    "multi_edit",
+]);
+/** Tools que ejecutan shell. */
+const SHELL_TOOLS = new Set([
+    "bash",
+    "shell",
+    "run",
+    "run_command",
+    "execute_command",
+    "terminal",
+    "powershell",
+    "cmd",
+    "powershell.exe",
+]);
+/** Tools que delegan a otro agente. */
+const DELEGATE_TOOLS = new Set(["task", "agent", "subagent", "spawn_agent"]);
+/* ────────────────────────────────────────────────────────────────────────────
+ * Extraccion de paths
+ * ──────────────────────────────────────────────────────────────────────────── */
+/** Claves de argumento que contienen un path de archivo. */
+const PATH_KEYS = ["filePath", "path", "file", "target", "notebook_path", "filename", "file_path"];
+/**
+ * Extrae TODOS los paths que una tool de escritura quiere tocar.
+ *
+ * La versión anterior devolvía un solo path, y para `patch` leía **solo el
+ * primer** `---` del diff. Un diff de cinco archivos pasaba el control con
+ * el primero y se escribían los otros cuatro.
+ */
+export function extractPaths(tool, args) {
+    const out = [];
+    for (const key of PATH_KEYS) {
+        const value = args[key];
+        if (typeof value === "string" && value.length > 0)
+            out.push(value);
+        else if (Array.isArray(value)) {
+            for (const v of value)
+                if (typeof v === "string" && v.length > 0)
+                    out.push(v);
+        }
+    }
+    // El tool `patch` puede traer los paths dentro de un patch estructurado.
+    const patch = args.patch ?? args.diff ?? args.edits;
+    if (typeof patch === "string") {
+        out.push(...pathsFromPatch(patch));
+    }
+    else if (Array.isArray(patch)) {
+        for (const entry of patch) {
+            if (typeof entry === "string")
+                out.push(...pathsFromPatch(entry));
+            else if (entry && typeof entry === "object") {
+                const rec = entry;
+                for (const key of PATH_KEYS) {
+                    const v = rec[key];
+                    if (typeof v === "string" && v.length > 0)
+                        out.push(v);
+                }
+            }
+        }
+    }
+    // Estructura `{ path, edits }` que usan algunos providers.
+    const edits = args.edits;
+    if (Array.isArray(edits)) {
+        for (const e of edits) {
+            if (e && typeof e === "object") {
+                const rec = e;
+                for (const key of PATH_KEYS) {
+                    const v = rec[key];
+                    if (typeof v === "string" && v.length > 0)
+                        out.push(v);
+                }
+            }
+        }
+    }
+    // Deduplicar conservando el orden.
+    const seen = new Set();
+    return out.filter((p) => {
+        if (seen.has(p))
+            return false;
+        seen.add(p);
+        return true;
     });
 }
-/** Extrae el path del argumento de una tool de escritura. */
+/**
+ * Paths de un diff unificado.
+ *
+ * Lee **todas** las lineas `---` y `+++`. Si el diff usa el prefijo de git
+ * (`a/`, `b/`) se lo saca, pero solo si AMBOS lados lo usan: un archivo
+ * llamado `a/notas.md` es un path legitimo.
+ */
+export function pathsFromPatch(patch) {
+    const minus = [];
+    const plus = [];
+    for (const line of patch.split(/\r?\n/)) {
+        const m = /^---+\s+(.+?)\s*$/.exec(line);
+        if (m?.[1])
+            minus.push(m[1]);
+        const p = /^\+\+\+\s+(.+?)\s*$/.exec(line);
+        if (p?.[1])
+            plus.push(p[1]);
+    }
+    const usaPrefijoGit = minus.length > 0 &&
+        minus.every((p) => p.startsWith("a/")) &&
+        plus.length > 0 &&
+        plus.every((p) => p.startsWith("b/"));
+    const strip = (p) => (usaPrefijoGit ? p.slice(2) : p);
+    // `--- /dev/null` marca un archivo nuevo: el path real viene del `+++`.
+    const out = [];
+    for (const p of [...minus, ...plus]) {
+        if (p === "/dev/null" || p === "dev/null")
+            continue;
+        const clean = strip(p);
+        if (clean)
+            out.push(clean);
+    }
+    return out;
+}
+/**
+ * El path de una tool de escritura. Se mantiene por compatibilidad con el
+ * API anterior; `extractPaths` es la version que hay que usar.
+ */
 export function extractPath(tool, args) {
-    const candidates = ["filePath", "path", "file", "target", "notebook_path"];
-    for (const key of candidates) {
+    return extractPaths(tool, args)[0];
+}
+/** El comando de una tool de shell. */
+export function extractCommand(args) {
+    for (const key of ["command", "cmd", "script", "input", "shellCommand"]) {
         const value = args[key];
         if (typeof value === "string" && value.length > 0)
             return value;
     }
-    // El tool `patch` puede traer los paths dentro de un patch estructurado.
-    if (tool === "patch" || tool === "apply_patch") {
-        const patch = args.patch ?? args.diff;
-        if (typeof patch === "string") {
-            const m = /^---+\s+(.+)$/m.exec(patch);
-            if (m?.[1])
-                return m[1].trim();
+    return undefined;
+}
+/* ────────────────────────────────────────────────────────────────────────────
+ * Resolucion de scope
+ * ──────────────────────────────────────────────────────────────────────────── */
+/**
+ * La card que gobierna una sesión.
+ *
+ * Primero mira el binding directo. Si no hay, sube por la cadena de
+ * padres: un subagente es una sesión hija, y su scope es el de quien lo
+ * lanzo.
+ */
+export async function resolveScopeCard(state, sessionID, options) {
+    const direct = state.sessions[sessionID];
+    if (direct?.cardId) {
+        const card = state.cards[direct.cardId];
+        if (card)
+            return card;
+    }
+    const resolveParent = options.resolveParentSession;
+    if (!resolveParent)
+        return undefined;
+    const maxDepth = options.maxParentDepth ?? 6;
+    const visited = new Set([sessionID]);
+    let current = sessionID;
+    for (let depth = 0; depth < maxDepth; depth += 1) {
+        let parent;
+        try {
+            parent = await resolveParent(current);
         }
+        catch (err) {
+            log.debug("no se pudo resolver el padre de la sesion", { sessionID: current, error: String(err) });
+            return undefined;
+        }
+        if (!parent || visited.has(parent))
+            break;
+        visited.add(parent);
+        const binding = state.sessions[parent];
+        if (binding?.cardId) {
+            const card = state.cards[binding.cardId];
+            if (card)
+                return card;
+        }
+        current = parent;
     }
     return undefined;
 }
+/* ────────────────────────────────────────────────────────────────────────────
+ * Hook
+ * ──────────────────────────────────────────────────────────────────────────── */
+function scopeError(verdict, card) {
+    return new Error(`[OFICINA] Scope violado: ${verdict.reason} (card ${card.id})`);
+}
 export function createScopeGuardHook(office, options = { enforce: true }) {
+    const shellPolicy = options.shellPolicy ?? "block";
     return async function onToolExecuteBefore(input, output) {
-        if (!output?.args)
+        const args = output?.args;
+        if (!args || typeof args !== "object")
             return;
-        if (!WRITE_TOOLS.has(input.tool))
+        const tool = String(input.tool ?? "");
+        const isFileWrite = FILE_WRITE_TOOLS.has(tool);
+        const isShell = SHELL_TOOLS.has(tool);
+        const isDelegate = DELEGATE_TOOLS.has(tool);
+        if (!isFileWrite && !isShell && !isDelegate)
             return;
         try {
             const state = await office.loadState();
-            const card = office.sessionCard(state, input.sessionID);
+            const card = await resolveScopeCard(state, input.sessionID, options);
             // Sin card activa no hay scope que aplicar: el agente está en
             // exploración libre o en una operación que no es de la oficina.
             if (!card)
                 return;
-            const rawPath = extractPath(input.tool, output.args);
-            if (!rawPath)
+            const policy = { mayTouch: card.scope.mayTouch, forbidden: card.scope.forbidden };
+            const projectRoot = office.paths.projectRoot;
+            /* ── Archivos ────────────────────────────────────────────────────── */
+            if (isFileWrite) {
+                const paths = extractPaths(tool, args);
+                if (paths.length === 0)
+                    return;
+                for (const p of paths) {
+                    const verdict = await checkScope(projectRoot, p, policy);
+                    if (!verdict.allowed) {
+                        log.warn("scope violado (archivo)", { card: card.id, path: p, kind: verdict.kind });
+                        if (options.enforce)
+                            throw scopeError(verdict, card);
+                    }
+                }
+                log.debug("scope ok", { card: card.id, tool, paths: paths.length });
                 return;
-            const absolute = path.isAbsolute(rawPath)
-                ? rawPath
-                : path.join(office.paths.projectRoot, rawPath);
-            const relative = path.relative(office.paths.projectRoot, absolute).replace(/\\/g, "/");
-            // Los artefactos de la oficina siempre están permitidos: son el canal.
-            if (relative.startsWith(".oficina/"))
+            }
+            /* ── Shell ───────────────────────────────────────────────────────── */
+            if (isShell) {
+                const command = extractCommand(args);
+                if (!command)
+                    return;
+                const candidates = analyzeShellCommand(command);
+                if (candidates.length === 0)
+                    return;
+                for (const candidate of candidates) {
+                    if (candidate.uncertain) {
+                        // Hay una escritura que no sabemos interpretar. No se bloquea
+                        // (seria inservible) pero se avisa: el tripwire va a vigilar.
+                        log.warn("shell con escritura no interpretable", {
+                            card: card.id,
+                            op: candidate.op,
+                            command: command.slice(0, 200),
+                        });
+                        continue;
+                    }
+                    const verdict = await checkScope(projectRoot, candidate.target, policy);
+                    if (!verdict.allowed) {
+                        log.warn("scope violado (shell)", {
+                            card: card.id,
+                            target: candidate.target,
+                            op: candidate.op,
+                            kind: verdict.kind,
+                        });
+                        if (options.enforce && shellPolicy === "block") {
+                            throw scopeError(verdict, card);
+                        }
+                    }
+                }
                 return;
-            const mayTouch = card.scope.mayTouch;
-            const forbidden = card.scope.forbidden;
-            if (matchesScope(relative, forbidden)) {
-                throw new Error(`[OFICINA] Scope violado: \`${relative}\` está en el scope forbidden de la card ${card.id}. ` +
-                    `Forbidden: ${forbidden.join(", ")}. No lo toques. Si realmente hace falta, pedí que se amplíe el scope.`);
             }
-            if (!matchesScope(relative, mayTouch)) {
-                throw new Error(`[OFICINA] Scope violado: \`${relative}\` está fuera del scope de la card ${card.id}. ` +
-                    `Podés tocar: ${mayTouch.join(", ")}. ` +
-                    `Si el archivo es necesario, pedí por el bus que se amplíe el scope, o pedí ayuda a un peer que lo cubra.`);
+            /* ── Delegacion ──────────────────────────────────────────────────── */
+            // Delegar no escribe, pero crea un actor nuevo. Se registra para que
+            // el subagente herede el scope cuando el motor cree su sesion.
+            if (isDelegate) {
+                log.debug("delegacion dentro de scope", { card: card.id, tool });
             }
-            log.debug("scope ok", { card: card.id, file: relative });
         }
         catch (err) {
             if (err instanceof Error && err.message.startsWith("[OFICINA]")) {
@@ -111,4 +344,5 @@ export function createScopeGuardHook(office, options = { enforce: true }) {
         }
     };
 }
+export { globToRegex, matchesScope };
 //# sourceMappingURL=scopeGuard.js.map

package/dist/hooks/scopeGuard.js.map

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

package/dist/index.d.ts

@@ -8,10 +8,18 @@
  *   incansablemente" sea una propiedad del sistema y no un pedido.
  * - **Hook `tool.execute.before`**: guard de scope. "No toques fuera de tu
  *   scope" pasa de ser una instrucción a ser una restricción.
+ * - **Hook `tool.execute.after`**: tripwire. Detecta lo que el guard no
+ *   pudo ver: escrituras que se colaron por un comando de shell.
+ * - **Hook `permission.ask`**: segunda capa de enforcement, a nivel del
+ *   framework. Cuando OpenCode pide permiso para una escritura, la oficina
+ *   lo deniega si está fuera del scope.
+ * - **Hook `event` → message.updated**: contabilidad de costo. El motor ya
+ *   sabe cuánto costó cada llamada; la oficina lo anota y lo presupuesta.
  * - **Hook `experimental.chat.system.transform`**: el estado de la oficina
  *   viaja con cada llamada. El agente no repregunta lo que ya sabe.
  * - **Hook `experimental.session.compacting`**: el estado sobrevive a la
  *   compactación.
+ * - **Hook `experimental.compaction.autocontinue`**: el freno de emergencia.
  *
  * Lo que NO hace: decidir el plan, escribir código ni emitir el veredicto de
  * review. Eso sigue siendo del modelo. El código pone los límites; el modelo
@@ -27,6 +35,8 @@ export interface OficinaOptions {
     maxAutoResumes?: number;
     /** Si es false, el guard de scope avisa pero no bloquea. */
     enforceScope?: boolean;
+    /** Tope de archivos que mira el tripwire por comando. */
+    tripwireMaxFiles?: number;
 }
 export declare const OficinaPlugin: Plugin;
 export default OficinaPlugin;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAA;AAW9D,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,MAmF3B,CAAA;AAED,eAAe,aAAa,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACnC,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAA;AAa9D,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,eAAO,MAAM,aAAa,EAAE,MAqR3B,CAAA;AAED,eAAe,aAAa,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACnC,cAAc,iBAAiB,CAAA"}