oficina-opencode 2.0.1 → 2.1.0

package/dist/core/recovery.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Reconciliación: qué hacer cuando la corrida quedó a medias.
+ *
+ * ## Por qué existe
+ *
+ * La oficina escribe en disco, en varios archivos, sin transaccion. Eso
+ * significa que un proceso que muere en el momento equivocado deja el
+ * estado incoherente:
+ *
+ * - El agente escribió `handoff.md` pero murió antes de llamar a
+ *   `oficina_submit`: la card sigue en `in_progress` con la entrega ya
+ *   escrita en disco. Nadie la va a terminar.
+ * - La card quedó en `done` pero `gates.md` no se escribió: se cerró sin
+ *   gate. Eso es exactamente lo que el invariante `gate-required-before-done`
+ *   dice que no puede pasar, y si pasó, fue por un crash.
+ * - Un agente murió con el lease tomado: la card queda trabada hasta que
+ *   el TTL vence (30 minutos por defecto).
+ * - Un agente terminó su card pero quedó `working` en el roster: ocupa
+ *   presupuesto de agentes para siempre.
+ *
+ * ## Qué hace
+ *
+ * Compara **estado vs artefactos vs filesystem** y reporta las
+ * incoherencias. Algunas se reparan solas (un lease huerfano se libera); las
+ * que requieren una decision (una card `done` sin gate) se reportan para
+ * que el Integrador decida.
+ *
+ * ## Lo que NO hace
+ *
+ * No adivina. No "completa" una card a la que le falta evidencia: la marca
+ * como incompleta y deja que un humano o un agente la retome. Un sistema
+ * que se auto-repara inventando evidencia es peor que uno que dice "esto
+ * esta roto".
+ */
+import type { OfficeState } from "./types.js";
+import type { Office } from "./office.js";
+export type RecoveryIssueKind = "card-in-progress-without-owner" | "review-without-artifacts" | "done-without-gate" | "orphaned-artifact" | "stale-lease" | "lease-without-owner" | "agent-still-working-on-done-card" | "blocked-by-unresolvable-dependency" | "review-without-evidence";
+export type RecoverySeverity = "critical" | "warning";
+export interface RecoveryIssue {
+    kind: RecoveryIssueKind;
+    severity: RecoverySeverity;
+    cardId?: string;
+    agentId?: string;
+    detail: string;
+    /** Accion sugerida. */
+    repair: string;
+    /** true si la reconciliacion la resolvio sola. */
+    repaired: boolean;
+}
+export interface RecoveryReport {
+    runId: string;
+    checkedAt: string;
+    issues: RecoveryIssue[];
+    /** Resumen legible para el board. */
+    summary: string;
+    /** healthy = no hay issues criticos sin reparar. */
+    healthy: boolean;
+}
+export interface ReconcileOptions {
+    /** Aplicar las reparaciones seguras (liberar leases huerfanos). */
+    autoRepair?: boolean;
+    /** Reloj inyectable para tests deterministas. */
+    clock?: () => number;
+    /** No escribir nada, solo reportar. */
+    dryRun?: boolean;
+}
+/**
+ * Reconcilia la corrida.
+ *
+ * Devuelve el reporte. Con `autoRepair` aplica las reparaciones que no
+ * requieren decision humana (liberar leases, liberar agentes que
+ * empezaron la card de otro).
+ */
+export declare function reconcile(office: Office, options?: ReconcileOptions): Promise<RecoveryReport>;
+/** Renderiza el reporte como markdown. */
+export declare function renderRecoveryReport(issues: RecoveryIssue[]): string;
+/**
+ * El estado que una card deberia tener, dado lo que hay en disco.
+ *
+ * Se usa para el caso "el agente escribio y murio": si el handoff esta
+ * escrito pero la card sigue en `in_progress`, la card puede pasar a
+ * `review` sin que el agente tenga que volver a trabajar.
+ */
+export declare function inferCardStateFromDisk(office: Office, cardId: string): Promise<"incomplete" | "deliverable" | "unknown">;
+/** Snapshot del estado para detectar cambios inesperados. */
+export declare function stateFingerprint(state: OfficeState): string;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/core/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/core/recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAKzC,MAAM,MAAM,iBAAiB,GACzB,gCAAgC,GAChC,0BAA0B,GAC1B,mBAAmB,GACnB,mBAAmB,GACnB,aAAa,GACb,qBAAqB,GACrB,kCAAkC,GAClC,oCAAoC,GACpC,yBAAyB,CAAA;AAE7B,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAAA;AAErD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAA;IACvB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IACpB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAYD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA4OzB;AAED,0CAA0C;AAC1C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAuBpE;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC,CAOnD;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAO3D"}

package/dist/core/recovery.js

@@ -0,0 +1,325 @@
+/**
+ * Reconciliación: qué hacer cuando la corrida quedó a medias.
+ *
+ * ## Por qué existe
+ *
+ * La oficina escribe en disco, en varios archivos, sin transaccion. Eso
+ * significa que un proceso que muere en el momento equivocado deja el
+ * estado incoherente:
+ *
+ * - El agente escribió `handoff.md` pero murió antes de llamar a
+ *   `oficina_submit`: la card sigue en `in_progress` con la entrega ya
+ *   escrita en disco. Nadie la va a terminar.
+ * - La card quedó en `done` pero `gates.md` no se escribió: se cerró sin
+ *   gate. Eso es exactamente lo que el invariante `gate-required-before-done`
+ *   dice que no puede pasar, y si pasó, fue por un crash.
+ * - Un agente murió con el lease tomado: la card queda trabada hasta que
+ *   el TTL vence (30 minutos por defecto).
+ * - Un agente terminó su card pero quedó `working` en el roster: ocupa
+ *   presupuesto de agentes para siempre.
+ *
+ * ## Qué hace
+ *
+ * Compara **estado vs artefactos vs filesystem** y reporta las
+ * incoherencias. Algunas se reparan solas (un lease huerfano se libera); las
+ * que requieren una decision (una card `done` sin gate) se reportan para
+ * que el Integrador decida.
+ *
+ * ## Lo que NO hace
+ *
+ * No adivina. No "completa" una card a la que le falta evidencia: la marca
+ * como incompleta y deja que un humano o un agente la retome. Un sistema
+ * que se auto-repara inventando evidencia es peor que uno que dice "esto
+ * esta roto".
+ */
+import path from "node:path";
+import fs from "node:fs/promises";
+import { logger } from "./log.js";
+const log = logger("oficina:recovery");
+/** ¿Existe un artefacto de la card? */
+async function artifactExists(cardDir, name) {
+    try {
+        await fs.access(path.join(cardDir, name));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Reconcilia la corrida.
+ *
+ * Devuelve el reporte. Con `autoRepair` aplica las reparaciones que no
+ * requieren decision humana (liberar leases, liberar agentes que
+ * empezaron la card de otro).
+ */
+export async function reconcile(office, options = {}) {
+    const autoRepair = options.autoRepair ?? true;
+    const dryRun = options.dryRun ?? false;
+    const clock = options.clock ?? Date.now;
+    const now = new Date(clock()).toISOString();
+    const state = await office.loadState();
+    const roster = await office.loadRoster(state.runId);
+    const issues = [];
+    const artifactsRoot = office.paths.artifactsDir;
+    const leasesDir = office.paths.leasesDir;
+    /* ── Cards vs artefactos ─────────────────────────────────────────────── */
+    for (const cardId of state.order) {
+        const card = state.cards[cardId];
+        if (!card)
+            continue;
+        const cardDir = path.join(artifactsRoot, cardId);
+        // Una card en review sin handoff: la entrega se perdio en el camino.
+        if (card.state === "review") {
+            const tieneHandoff = await artifactExists(cardDir, "handoff.md");
+            const tieneEvidencia = await artifactExists(cardDir, "evidence.md");
+            if (!tieneHandoff) {
+                issues.push({
+                    kind: "review-without-artifacts",
+                    severity: "warning",
+                    cardId,
+                    detail: `La card esta en review pero no tiene handoff.md. ` +
+                        `Lo mas probable es que el agente escribiera el artefacto y muriera antes de entregar.`,
+                    repair: "Devolver la card a in_progress para que el agente la retome, o revisar el handoff a mano.",
+                    repaired: false,
+                });
+            }
+            else if (!tieneEvidencia) {
+                issues.push({
+                    kind: "review-without-evidence",
+                    severity: "warning",
+                    cardId,
+                    detail: `La card esta en review sin evidence.md: no hay evidencia de que se haya hecho el trabajo.`,
+                    repair: "Pedir la evidencia antes de correr los gates.",
+                    repaired: false,
+                });
+            }
+        }
+        // Una card cerrada sin gate: el invariante deberia haberlo impedido.
+        if (card.state === "done") {
+            const tieneGate = await artifactExists(cardDir, "gates.md");
+            if (!tieneGate) {
+                issues.push({
+                    kind: "done-without-gate",
+                    severity: "critical",
+                    cardId,
+                    detail: `La card esta en done pero no tiene gates.md. Se cerro sin gate: ` +
+                        `el invariante gate-required-before-done fue vulnerado (probablemente por un crash).`,
+                    repair: "Reabrir la card y correr los gates de verdad.",
+                    repaired: false,
+                });
+            }
+        }
+        // Una card en progreso sin dueño.
+        if ((card.state === "in_progress" || card.state === "rework") && !card.owner) {
+            issues.push({
+                kind: "card-in-progress-without-owner",
+                severity: "critical",
+                cardId,
+                detail: `La card esta en ${card.state} pero no tiene owner. Nadie la va a terminar.`,
+                repair: "Liberar la card para que otro agente la reclame.",
+                repaired: false,
+            });
+        }
+        // Una dependencia que nunca se va a resolver.
+        if (card.state === "blocked") {
+            const pendientes = card.dependsOn.filter((d) => {
+                const dep = state.cards[d];
+                return dep && dep.state !== "done";
+            });
+            if (pendientes.length > 0) {
+                issues.push({
+                    kind: "blocked-by-unresolvable-dependency",
+                    severity: "warning",
+                    cardId,
+                    detail: `La card esta bloqueada y depende de ${pendientes.join(", ")}, que no estan en done.`,
+                    repair: "Revisar la dependencia o replanificar.",
+                    repaired: false,
+                });
+            }
+        }
+    }
+    /* ── Artefactos huerfanos ────────────────────────────────────────────── */
+    let cardDirs = [];
+    try {
+        cardDirs = (await fs.readdir(artifactsRoot, { withFileTypes: true }))
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    catch {
+        cardDirs = [];
+    }
+    for (const dirName of cardDirs) {
+        if (state.cards[dirName])
+            continue;
+        issues.push({
+            kind: "orphaned-artifact",
+            severity: "warning",
+            cardId: dirName,
+            detail: `Hay artefactos de una card que no existe en el estado (${dirName}).`,
+            repair: "Se puede borrar el directorio: no lo va a usar nadie.",
+            repaired: false,
+        });
+    }
+    /* ── Leases vs estado ────────────────────────────────────────────────── */
+    let leaseFiles = [];
+    try {
+        leaseFiles = (await fs.readdir(leasesDir)).filter((f) => f.endsWith(".json"));
+    }
+    catch {
+        leaseFiles = [];
+    }
+    for (const file of leaseFiles) {
+        const taskId = file.replace(/\.json$/, "");
+        const card = state.cards[taskId];
+        if (!card) {
+            issues.push({
+                kind: "stale-lease",
+                severity: "warning",
+                cardId: taskId,
+                detail: `Hay un lease de una task que no existe en el estado.`,
+                repair: "Liberar el lease.",
+                repaired: false,
+            });
+            if (autoRepair && !dryRun) {
+                await office.leases.release(taskId, "desconocido").catch(() => false);
+                const last = issues[issues.length - 1];
+                last.repaired = true;
+            }
+            continue;
+        }
+        if (card.state === "done" || card.state === "review") {
+            const holder = await office.leases.holder(taskId);
+            if (holder) {
+                issues.push({
+                    kind: "stale-lease",
+                    severity: "warning",
+                    cardId: taskId,
+                    agentId: holder,
+                    detail: `La card esta en ${card.state} pero ${holder} sigue con el lease tomado.`,
+                    repair: "Liberar el lease.",
+                    repaired: false,
+                });
+                if (autoRepair && !dryRun) {
+                    await office.leases.release(taskId, holder).catch(() => false);
+                    const last = issues[issues.length - 1];
+                    last.repaired = true;
+                }
+            }
+        }
+        if (!card.owner) {
+            issues.push({
+                kind: "lease-without-owner",
+                severity: "warning",
+                cardId: taskId,
+                detail: `Hay un lease tomado de una card sin owner.`,
+                repair: "Liberar el lease.",
+                repaired: false,
+            });
+        }
+    }
+    /* ── Roster vs estado ────────────────────────────────────────────────── */
+    for (const agent of Object.values(roster.agents)) {
+        if (!agent.currentCard)
+            continue;
+        const card = state.cards[agent.currentCard];
+        if (!card) {
+            issues.push({
+                kind: "stale-lease",
+                severity: "warning",
+                agentId: agent.id,
+                cardId: agent.currentCard,
+                detail: `El agente apunta a una card que no existe.`,
+                repair: "Liberar el agente.",
+                repaired: false,
+            });
+            continue;
+        }
+        if (card.state === "done" && agent.state === "working") {
+            issues.push({
+                kind: "agent-still-working-on-done-card",
+                severity: "warning",
+                agentId: agent.id,
+                cardId: card.id,
+                detail: `La card esta en done pero el agente sigue marcado como working.`,
+                repair: "Liberar el agente a idle_available.",
+                repaired: false,
+            });
+            if (autoRepair && !dryRun) {
+                agent.state = "idle_available";
+                agent.currentCard = null;
+                agent.canAccept = true;
+                agent.idleSince = now;
+                await office.saveRoster(roster);
+                const last = issues[issues.length - 1];
+                last.repaired = true;
+            }
+        }
+    }
+    const criticas = issues.filter((i) => i.severity === "critical" && !i.repaired);
+    const report = {
+        runId: state.runId,
+        checkedAt: now,
+        issues,
+        summary: renderRecoveryReport(issues),
+        healthy: criticas.length === 0,
+    };
+    log.info("reconciliacion completa", {
+        runId: state.runId,
+        issues: issues.length,
+        criticas: criticas.length,
+        reparadas: issues.filter((i) => i.repaired).length,
+    });
+    return report;
+}
+/** Renderiza el reporte como markdown. */
+export function renderRecoveryReport(issues) {
+    if (issues.length === 0)
+        return "Todo consistente. Sin nada que reconciliar.";
+    const lines = [];
+    const criticas = issues.filter((i) => i.severity === "critical");
+    const avisos = issues.filter((i) => i.severity === "warning");
+    if (criticas.length > 0) {
+        lines.push(`## Criticos (${criticas.length})`, "");
+        for (const i of criticas) {
+            lines.push(`- **${i.kind}**${i.cardId ? ` \`${i.cardId}\`` : ""}: ${i.detail}`);
+            lines.push(`  - Repair: ${i.repair}${i.repaired ? " *(ya reparado)*" : ""}`);
+        }
+        lines.push("");
+    }
+    if (avisos.length > 0) {
+        lines.push(`## Avisos (${avisos.length})`, "");
+        for (const i of avisos) {
+            lines.push(`- **${i.kind}**${i.cardId ? ` \`${i.cardId}\`` : ""}: ${i.detail}`);
+            lines.push(`  - Repair: ${i.repair}${i.repaired ? " *(ya reparado)*" : ""}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * El estado que una card deberia tener, dado lo que hay en disco.
+ *
+ * Se usa para el caso "el agente escribio y murio": si el handoff esta
+ * escrito pero la card sigue en `in_progress`, la card puede pasar a
+ * `review` sin que el agente tenga que volver a trabajar.
+ */
+export async function inferCardStateFromDisk(office, cardId) {
+    const cardDir = path.join(office.paths.artifactsDir, cardId);
+    if (await artifactExists(cardDir, "handoff.md")) {
+        if (await artifactExists(cardDir, "evidence.md"))
+            return "deliverable";
+        return "incomplete";
+    }
+    return "unknown";
+}
+/** Snapshot del estado para detectar cambios inesperados. */
+export function stateFingerprint(state) {
+    const parts = state.order.map((id) => {
+        const c = state.cards[id];
+        if (!c)
+            return `${id}:?`;
+        return `${id}:${c.state}:${c.owner ?? "-"}:${c.attempts}:${c.rejections}`;
+    });
+    return parts.join("|");
+}
+//# sourceMappingURL=recovery.js.map

package/dist/core/recovery.js.map

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

package/dist/core/sandbox.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Sandbox: resolución y validación de rutas.
+ *
+ * ## Por qué existe
+ *
+ * El guard de scope comparaba strings:
+ *
+ *     const relative = path.relative(projectRoot, absolute)
+ *     if (!matchesScope(relative, mayTouch)) throw ...
+ *
+ * Eso tiene tres agujeros, y los tres son reales:
+ *
+ * 1. **Symlinks.** `src/link.ts` -> `../../etc/secrets.ts`. El path relativo
+ *    es `src/link.ts`, que matchea `src/**`. El guard autoriza. La
+ *    escritura ocurre afuera. Verificar el path **después** de resolver los
+ *    symlinks es la diferencia entre "está en el scope" y "termina en el
+ *    scope".
+ *
+ * 2. **`..` con `mayTouch: ["**"]`.** `**` matcheaba cualquier string,
+ *    incluido `../../etc/passwd`. El `**` tiene que significar "todo el
+ *    proyecto", nunca "todo el filesystem".
+ *
+ * 3. **Paths absolutos.** `/etc/passwd` o `C:\Windows\...` tienen un
+ *    relativo que empieza en `..`, y con `**` pasaban.
+ *
+ * ## La regla
+ *
+ * Ninguna ruta se autoriza por comparación de strings. Se resuelve primero
+ * (absoluta → normalizada → symlinks resueltos → realpath) y recién ahí se
+ * decide. Y la decisión es **fail-closed**: ante cualquier duda, se deniega.
+ *
+ * ## Qué NO promete
+ *
+ * Un sandbox a nivel de aplicación no puede⬇️ contener un `bash` que el modelo
+ * redacta con un interpreter embebido. Eso sí se cubre, pero con otra
+ * técnica: se analiza el comando antes de ejecutarlo y se instalan
+ * *tripwires* después. Ver `analyzeShellCommand` y el modulo de deteccion.
+ */
+/**
+ * Glob mínimo a regex. Soporta `*`, `**` y `?`.
+ *
+ * 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.
+ */
+export declare function globToRegex(glob: string): RegExp;
+/** Normaliza un glob: sin `./` inicial, sin `/` inicial, con `/` como separador. */
+export declare function normalizeGlob(glob: string): string;
+/**
+ * ¿El path cae dentro de alguno de los globs?
+ *
+ * Ojo con `**`: matchea todo lo que se le pase. Por eso `checkScope` nunca
+ * llama a esta función antes de verificar la contención en el proyecto.
+ */
+export declare function matchesScope(relativePath: string, globs: string[]): boolean;
+/**
+ * ¿`target` está dentro de `root`?
+ *
+ * La comparación es sobre paths ya resueltos, y el separador final se exige
+ * explícitamente: `/proj-evil` NO está dentro de `/proj`.
+ */
+export declare function isInsideRoot(root: string, target: string): boolean;
+/** Relativo con `/` como separador. */
+export declare function toPosix(p: string): string;
+export interface ResolvedTarget {
+    /** Path absoluto normalizado lexicograficamente. */
+    absolute: string;
+    /** Path real: symlinks resueltos, con la cola inexistente re-enganchada. */
+    resolved: string;
+    /** Relativo al root, del path REAL. "" si es el root mismo. */
+    relative: string;
+    /** Relativo al root, del path LEXICOGRAFICO. */
+    lexicalRelative: string;
+    /** Symlinks encontrados en el camino, del mas externo al mas interno. */
+    symlinks: string[];
+    /** ¿El archivo (o su directorio padre) existe? */
+    exists: boolean;
+    /** ¿El path lexical esta dentro del root? */
+    insideLexically: boolean;
+    /** ¿El path real esta dentro del root? */
+    insidePhysically: boolean;
+}
+/**
+ * Resuelve un path contra el root, deshaciendo symlinks.
+ *
+ * Devuelve toda la información que `checkScope` necesita para decidir, y
+ * no decide: la decision vive en un solo lugar.
+ */
+export declare function resolveTarget(root: string, rawPath: string): Promise<ResolvedTarget>;
+/**
+ * Archivos que NUNCA se pueden escribir, pase lo que pase.
+ *
+ * No son negociables por el scope de la card: un `mayTouch: ["**"]` no
+ * habilita a tocar el `.npmrc` de alguien ni una clave privada.
+ */
+export declare const SENSITIVE_PATTERNS: readonly string[];
+/**
+ * Excepciones: archivos que matchean un patrón sensible pero son inocuos.
+ *
+ * `.env.example` es un template sin secretos; bloquearlo obliga a los
+ * agentes a hacer un rodeo por el `.env` real.
+ */
+export declare const SENSITIVE_EXCEPTIONS: readonly string[];
+/** ¿El path relativo cae en un patrón sensible y no es una excepción? */
+export declare function isSensitive(relativePath: string): boolean;
+export interface ScopePolicy {
+    mayTouch: string[];
+    forbidden: string[];
+}
+export type ScopeVerdictKind = "allowed" | "invalid" | "outside-project" | "symlink-escape" | "sensitive" | "forbidden" | "out-of-scope";
+export interface ScopeVerdict {
+    allowed: boolean;
+    kind: ScopeVerdictKind;
+    /** Razón legible en español, lista para mostrarle al modelo. */
+    reason: string;
+    /** Path real (symlinks resueltos). */
+    resolved: string;
+    /** Relativo al root, del path real. */
+    relative: string;
+    /** Symlinks encontrados en el camino. */
+    symlinks: string[];
+}
+/**
+ * Rutas que la propia oficina usa como canal de entrega.
+ *
+ * El agente tiene que poder escribir `handoff.md`, `evidence.md`,
+ * `review.md` y `gates.md`: son la evidencia de su trabajo. El scope de la
+ * card es `src/**`, asi que sin esta excepcion el agente no podria
+ * entregar nunca.
+ *
+ * OJO: solo los directorios de entrega. `state.json`, `roster.json`, el bus
+ * y los leases son del motor — que un agente pueda escribir ahi seria
+ * falsear la verdad de la corrida.
+ */
+export declare const OFFICE_WRITABLE: readonly string[];
+export interface ScopeCheckOptions {
+    /** Ignorar la lista de sensibles (solo para uso interno de la oficina). */
+    ignoreSensitive?: boolean;
+    /** Rutas que el agente puede escribir aunque no esten en `mayTouch`. */
+    officeWritable?: readonly string[];
+}
+/**
+ * Decide si un path puede escribirse.
+ *
+ * El orden de las comprobaciones es intencionado: primero lo que invalida
+ * la ruta, después lo que la vuelve peligrosa, y recién al final si entra
+ * en el scope permitido. Así el error que recibe el modelo dice la verdad
+ * mas específica posible.
+ */
+export declare function checkScope(root: string, rawPath: string, policy: ScopePolicy, options?: ScopeCheckOptions): Promise<ScopeVerdict>;
+export interface ShellCandidate {
+    /** Path afectado por la escritura. */
+    target: string;
+    /** Verbo que produce la escritura ("redirect", "tee", "cp", ...). */
+    op: string;
+    /**
+     * true si se detecto una escritura pero no se pudo extraer un path
+     * confiable. En ese caso hay que armar el tripwire: no se puede
+     * autorizar en blindness.
+     */
+    uncertain: boolean;
+}
+/**
+ * Extrae los paths que un comando de shell puede escribir.
+ *
+ * ## Por qué no es un parser de shell
+ *
+ * Un parser completo de shell (con here-docs, substituciones, funciones,
+ * `eval`, interpreters embebidos) es un proyecto entero y sigue siendo
+ * evadible. Lo que hace falta aca es otra cosa: **no dejar pasar en
+ * silencio** una escritura que no entendimos.
+ *
+ * Por eso la funcion devuelve tambien los targets `uncertain`: cuando
+ * vemos una escritura pero no sabemos a donde apunta, el comando no se
+ * autoriza a ciegas — se deja pasar con el tripwire armed, y el
+ * tripwire es el que detecta la escribir fuera del scope despues.
+ */
+export declare function analyzeShellCommand(command: string): ShellCandidate[];
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/core/sandbox.d.ts.map

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