oficina-opencode 0.0.0-stage → 2.0.1

package/dist/core/types.d.ts

@@ -0,0 +1,333 @@
+/**
+ * OFICINA — schema único del sistema.
+ *
+ * Todo lo que cruza el sistema (bus, roster, cards, fichas, gates) usa estas
+ * formas. Un rol venga de agency-agents o de la factory se materializa en la
+ * misma `Ficha`; una card, sin importar qué coordinó el Commander, usa la
+ * misma `Card`. Esa unificación es lo que permite que el matching de
+ * capacidades, la rotación, la auditoría y el bus no necesiten saber el
+ * origen de nada.
+ */
+/**
+ * Invariantes globales.
+ *
+ * Los marcados `hard` son los que el sistema NUNCA puede violar: los
+ * implementa `assertInvariants` en código, no la disciplina del agente. Un
+ * prompt puede pedirle al modelo que no toque archivos fuera de scope; el
+ * guard de scope lo impide aunque el modelo se lo salte.
+ */
+export interface Limits {
+    /** Especialistas simultáneos. 10 base, 14 hard cap. */
+    maxConcurrentAgents: number;
+    /** Niveles de spawn bajo un coordinador. */
+    maxSpawnDepth: number;
+    /** Spawns totales por corrida. */
+    maxSpawnsTotal: number;
+    /** Saltos máximos en una cadena de ayuda (anti-deadlock). */
+    maxHelpChainHops: number;
+    /** Mensajes por agente (anti-spam). */
+    maxMessagesPerAgent: number;
+    /** TTL de un mensaje, en segundos. */
+    msgTtlSec: number;
+    /** TTL de un lease, en segundos. */
+    leaseTtlSec: number;
+    /** Intervalo de heartbeat, en segundos. */
+    heartbeatSec: number;
+    /** Rechazos de review antes de escalar. */
+    maxReviewRejections: number;
+    /** Cards por corrida. */
+    maxCards: number;
+    /** Invocaciones de subagente por corrida. */
+    maxAgentCalls: number;
+    /** Cobertura mínima (0..1) para aceptar un match del catálogo. */
+    minCatalogCoverage: number;
+    /** Invariante duro: sin gates en PASS no hay DONE. */
+    gateRequiredBeforeDone: boolean;
+    /** Invariante duro: el revisor nunca es el owner. */
+    reviewerNeqOwner: boolean;
+}
+export declare const DEFAULT_LIMITS: Limits;
+/** Ciclo de vida de un agente desplegado. */
+export type AgentState = "deployed" | "working" | "idle_available" | "blocked" | "retired";
+/** Estados de una card. Las transiciones válidas viven en `state.ts`. */
+export type CardState = "todo" | "in_progress" | "review" | "rework" | "done" | "blocked" | "escalated";
+/** Dominios particionados de los tres coordinadores. */
+export type CoordinatorDomain = "command" | "arch" | "flow";
+export type CoordinatorId = "commander" | "architect" | "integrator";
+export type FichaSourceKind = "agency-agents" | "factory";
+export interface FichaSource {
+    kind: FichaSourceKind;
+    /** División de origen en agency-agents, si aplica. */
+    division?: string;
+    /** Path relativo al repo de origen. */
+    path?: string;
+    /** El system prompt original, verbatim. */
+    sourcePrompt?: string;
+    /** El "vibe" del agente: la personality hook de una línea. */
+    vibe?: string;
+    /** Las misiones declaradas del agente (de "Core Mission"). */
+    missions?: string[];
+    /** Los entregables declarados (de "Technical Deliverables"). */
+    deliverables?: string[];
+    /** Las reglas críticas declaradas (de "Critical Rules"). */
+    rules?: string[];
+}
+/**
+ * La ficha es lo que un agente recibe al desplegarse. Todo lo que el bus, los
+ * coordinadores y el matching de ayuda necesitan saber de un rol cabe acá.
+ */
+export interface Ficha {
+    /** Id de despliegue, único por corrida. */
+    id: string;
+    /** Rol canónico. */
+    role: string;
+    displayName: string;
+    source: FichaSource;
+    capabilities: string[];
+    tools: string[];
+    scope: {
+        mayTouch: string[];
+        forbidden: string[];
+    };
+    /** Si este rol puede desplegar subagentes. */
+    canDelegate: boolean;
+    delegateBudget: number;
+    /** Con qué roles tiene relación de pares (para pedir ayuda). */
+    peers: string[];
+    /** Límites duros, leídos por los coordinadores. */
+    mustNot: string[];
+    /** Qué hace al terminar su objetivo. */
+    onFinish: "idle-join" | "retire";
+    /** A qué coordinador escala. */
+    escalateTo: CoordinatorId;
+}
+export type CardType = "exploration" | "design" | "implementation" | "bugfix" | "refactor" | "testing" | "docs" | "security" | "infra";
+export interface Card {
+    id: string;
+    title: string;
+    type: CardType;
+    state: CardState;
+    /** Id del agente owner (ficha `id`). */
+    owner: string | null;
+    /** Id del agente revisor. Distinto del owner por invariante. */
+    reviewer: string | null;
+    /** Capabilities que la card requiere. */
+    requiredCapabilities: string[];
+    scope: {
+        mayTouch: string[];
+        forbidden: string[];
+    };
+    /** Criterios de aceptación verificables. */
+    acceptance: string[];
+    /** Condición que debe cumplirse para pasar a DONE. */
+    gate: string;
+    dependsOn: string[];
+    /** Intentos de ejecución. */
+    attempts: number;
+    /** Rechazos acumulados del revisor. */
+    rejections: number;
+    /** Artefactos de esta card, relativos a la office dir. */
+    artifacts: string;
+    /** Resultado final. */
+    result: string | null;
+    /** Ids de cards donde este agente pidió ayuda. */
+    helpRequests: string[];
+    /** Cuántos saltos lleva la cadena de ayuda de esta card. */
+    helpHops: number;
+}
+export type MessageKind = "HELP_REQUEST" | "HELP_ACCEPT" | "HELP_DECLINE" | "HELP_PARTIAL" | "HELP_QUESTION" | "QUESTION" | "ANSWER" | "SPAWN_REQUEST" | "SPAWN_APPROVED" | "SPAWN_REJECTED" | "CLAIM" | "RELEASE" | "STATUS" | "NOTICE";
+export type MessagePriority = "low" | "normal" | "high" | "critical";
+/** Envelope de mensaje del bus. Append-only, con seq monótono por canal. */
+export interface BusMessage {
+    id: string;
+    /** Secuencia monótona dentro del canal. */
+    seq: number;
+    from: string;
+    /** Destinatarios. `["*"]` es broadcast al pool. */
+    to: string[];
+    kind: MessageKind;
+    /** Card o subject al que se refiere. */
+    subject: string;
+    body: Record<string, unknown>;
+    replyTo: string | null;
+    inReplyTo: string | null;
+    ttlSec: number;
+    createdAt: string;
+    priority: MessagePriority;
+    /** Clave de idempotencia: evita storms de "me ayudás?". */
+    idempotencyKey: string | null;
+    /** Cuántos saltos lleva esta cadena de ayuda. */
+    hops: number;
+}
+export interface BusAck {
+    messageId: string;
+    agentId: string;
+    ackedAt: string;
+}
+export interface RosterEntry {
+    id: string;
+    role: string;
+    displayName: string;
+    state: AgentState;
+    capabilities: string[];
+    fichaPath: string;
+    /** Card en la que está trabajando. */
+    currentCard: string | null;
+    /** Lease tomado, si hay. */
+    lease: string | null;
+    idleSince: string | null;
+    canAccept: boolean;
+    /** Cuántas veces pidió ayuda / ayudó a otro (anti-monotonía). */
+    helpGiven: number;
+    helpReceived: number;
+    /** Pares con los que ya colaboraron, para rotar. */
+    helpedPeers: string[];
+    lastHeartbeat: string;
+    source: FichaSource;
+}
+export interface Roster {
+    version: number;
+    runId: string;
+    agents: Record<string, RosterEntry>;
+    updatedAt: string;
+}
+export type GatePhase = "build" | "typecheck" | "lint" | "test" | "secrecy" | "diff";
+export type GateOutcome = "pass" | "fail" | "na" | "not_run";
+export interface GatePhaseResult {
+    phase: GatePhase;
+    command: string | null;
+    outcome: GateOutcome;
+    exitCode: number | null;
+    /** Salida real, recortada. */
+    output: string;
+    detail: string;
+    /** Si falló, el motivo por el que la card no puede pasar. */
+    reason?: string;
+}
+export interface GateResult {
+    cardId: string;
+    technical: GatePhaseResult[];
+    security: GatePhaseResult[];
+    technicalOutcome: GateOutcome;
+    securityOutcome: GateOutcome;
+    passed: boolean;
+    ranAt: string;
+}
+export type RunStatus = "planning" | "running" | "paused" | "delivered" | "blocked" | "escalated" | "abandoned";
+export interface OfficeState {
+    version: number;
+    runId: string;
+    objective: string;
+    createdAt: string;
+    updatedAt: string;
+    status: RunStatus;
+    /** Cards del plan, indexadas por id. */
+    cards: Record<string, Card>;
+    /** Orden de ejecución. */
+    order: string[];
+    budget: {
+        cardsUsed: number;
+        maxCards: number;
+        agentCallsUsed: number;
+        maxAgentCalls: number;
+        spawnsUsed: number;
+        maxSpawnsTotal: number;
+    };
+    /** Bitácora de decisiones. */
+    decisions: DecisionRecord[];
+    /** Escalaciones al usuario. */
+    escalations: Escalation[];
+    /** Contexto acumulado (evita repetición). */
+    context: ContextLedger;
+    /** Iteración del loop principal. */
+    iteration: number;
+    /** Ids de cards pendientes de gate. */
+    pendingGates: string[];
+    /**
+     * Qué sesión está haciendo qué.
+     *
+     * Lo usa el guard de scope: cuando una sesión intenta editar un archivo,
+     * el motor necesita saber contra qué card está trabajando esa sesión.
+     */
+    sessions: Record<string, SessionBinding>;
+}
+export interface SessionBinding {
+    /** Id de agente. */
+    agentId: string;
+    /** Card en curso de esa sesión. */
+    cardId: string | null;
+    updatedAt: string;
+    /** Cuántas veces el motor auto-reanudó esta sesión. */
+    autoResumes: number;
+}
+export interface DecisionRecord {
+    at: string;
+    cardId: string;
+    decision: "approved" | "rework" | "replan" | "escalated" | "spawn_approved" | "spawn_rejected";
+    reason: string;
+    actor: string;
+}
+export interface Escalation {
+    id: string;
+    cardId: string;
+    at: string;
+    cause: string;
+    attempts: {
+        iteration: number;
+        summary: string;
+    }[];
+    options: EscalationOption[];
+    recommendation: string;
+    status: "open" | "resolved";
+}
+export interface EscalationOption {
+    id: string;
+    label: string;
+    tradeoff: string;
+}
+export interface ContextLedger {
+    decisions: string[];
+    constraints: string[];
+    pieces: string[];
+    traps: string[];
+    open: string[];
+}
+export interface CatalogAgent {
+    /** Slug del archivo, sin extensión. */
+    slug: string;
+    displayName: string;
+    description: string;
+    /** La personality hook de una línea que trae el frontmatter. */
+    vibe: string;
+    division: string;
+    path: string;
+    /**
+     * Capabilities inferidas del **cuerpo**, no del nombre.
+     *
+     * Es la diferencia entre "de qué se ocupa" (description) y "en qué es
+     * exactamente bueno" (Core Mission + Advanced Capabilities + Deliverables).
+     */
+    capabilities: string[];
+    /** Subtítulos de "Core Mission": la especialidad declarada. */
+    missions: string[];
+    /** Subtítulos de "Technical Deliverables": lo que sabe producir. */
+    deliverables: string[];
+    /** Subtítulos de "Advanced Capabilities". */
+    advanced: string[];
+    /** Items de "Critical Rules". */
+    rules: string[];
+    /** Secciones H2 parseadas del cuerpo. */
+    sections: Record<string, string>;
+    /** Prompt original completo. */
+    sourcePrompt: string;
+    /** Texto indexable para matching. */
+    searchText: string;
+}
+export interface CatalogMatch {
+    agent: CatalogAgent;
+    /** 0..1. */
+    coverage: number;
+    matched: string[];
+    missing: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -0,0 +1,27 @@
+/**
+ * OFICINA — schema único del sistema.
+ *
+ * Todo lo que cruza el sistema (bus, roster, cards, fichas, gates) usa estas
+ * formas. Un rol venga de agency-agents o de la factory se materializa en la
+ * misma `Ficha`; una card, sin importar qué coordinó el Commander, usa la
+ * misma `Card`. Esa unificación es lo que permite que el matching de
+ * capacidades, la rotación, la auditoría y el bus no necesiten saber el
+ * origen de nada.
+ */
+export const DEFAULT_LIMITS = {
+    maxConcurrentAgents: 10,
+    maxSpawnDepth: 2,
+    maxSpawnsTotal: 20,
+    maxHelpChainHops: 2,
+    maxMessagesPerAgent: 150,
+    msgTtlSec: 900,
+    leaseTtlSec: 1800,
+    heartbeatSec: 60,
+    maxReviewRejections: 3,
+    maxCards: 20,
+    maxAgentCalls: 40,
+    minCatalogCoverage: 0.6,
+    gateRequiredBeforeDone: true,
+    reviewerNeqOwner: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +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"}

package/dist/hooks/compacting.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Hook: el estado de la oficina sobrevive a la compactación.
+ *
+ * Cuando la sesión se compacta, el modelo pierde el contexto conversacional.
+ * Sin este hook, la oficina se olvida de a mitad de camino: el agente deja de
+ * saber qué hizo, repite trabajo y el ciclo se rompe.
+ *
+ * Con este hook, el resumen de compactación incluye el estado real de la
+ * oficina — leído del disco, no del contexto que se está por perder.
+ */
+import type { Office } from "../core/office.js";
+export declare function createCompactingHook(office: Office): (input: {
+    sessionID: string;
+}, output: {
+    context: string[];
+    prompt?: string;
+}) => Promise<void>;
+//# sourceMappingURL=compacting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compacting.d.ts","sourceRoot":"","sources":["../../src/hooks/compacting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAK/C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,IAE/C,OAAO;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC5B,QAAQ;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAC7C,OAAO,CAAC,IAAI,CAAC,CA6DjB"}

package/dist/hooks/compacting.js

@@ -0,0 +1,72 @@
+/**
+ * Hook: el estado de la oficina sobrevive a la compactación.
+ *
+ * Cuando la sesión se compacta, el modelo pierde el contexto conversacional.
+ * Sin este hook, la oficina se olvida de a mitad de camino: el agente deja de
+ * saber qué hizo, repite trabajo y el ciclo se rompe.
+ *
+ * Con este hook, el resumen de compactación incluye el estado real de la
+ * oficina — leído del disco, no del contexto que se está por perder.
+ */
+import { logger } from "../core/log.js";
+const log = logger("oficina:compacting");
+export function createCompactingHook(office) {
+    return async function onCompacting(input, output) {
+        try {
+            const state = await office.loadState();
+            if (!state.objective)
+                return;
+            const cards = Object.values(state.cards);
+            const done = cards.filter((c) => c.state === "done");
+            const pending = cards.filter((c) => c.state !== "done");
+            const roster = await office.loadRoster(state.runId);
+            const context = [
+                "## 🏢 OFICINA — estado (leído del disco, sobrevivió a la compactación)",
+                "",
+                `**Objetivo:** ${state.objective}`,
+                `**Estado de la corrida:** ${state.status}`,
+                `**Progreso:** ${done.length}/${cards.length} cards DONE`,
+                "",
+                "### Cards terminadas",
+                ...(done.length > 0
+                    ? done.map((c) => `- ${c.id}: ${c.title} — ${c.result ?? "completada"}`)
+                    : ["(ninguna)"]),
+                "",
+                "### Cards pendientes",
+                ...(pending.length > 0
+                    ? pending.map((c) => `- ${c.id} [${c.state}] ${c.title} · owner=${c.owner ?? "—"} · gate: ${c.gate} · intentos=${c.attempts} · rechazos=${c.rejections}`)
+                    : ["(ninguna)"]),
+                "",
+                `**Agentes en el roster:** ${Object.values(roster.agents)
+                    .map((a) => `${a.id}(${a.role}:${a.state})`)
+                    .join(", ") || "—"}`,
+                "",
+                "### Contexto acumulado",
+                ...(state.context.decisions.length > 0
+                    ? ["", "**Decisiones:**", ...state.context.decisions.map((d) => `- ${d}`)]
+                    : []),
+                ...(state.context.constraints.length > 0
+                    ? ["", "**Constraints:**", ...state.context.constraints.map((c) => `- ${c}`)]
+                    : []),
+                ...(state.context.pieces.length > 0
+                    ? ["", "**Piezas construidas:**", ...state.context.pieces.map((p) => `- ${p}`)]
+                    : []),
+                ...(state.context.traps.length > 0
+                    ? ["", "**Trampas:**", ...state.context.traps.map((t) => `- ${t}`)]
+                    : []),
+                "",
+                "Continuá desde donde quedó. No repitas trabajo ya hecho: leé `.oficina/artifacts/`.",
+            ].join("\n");
+            output.context.push(context);
+            log.info("estado inyectado en la compactación", {
+                sessionID: input.sessionID,
+                done: done.length,
+                pending: pending.length,
+            });
+        }
+        catch (err) {
+            log.error("fallo inyectando el estado en la compactación", { error: String(err) });
+        }
+    };
+}
+//# sourceMappingURL=compacting.js.map

package/dist/hooks/compacting.js.map

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

package/dist/hooks/scopeGuard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Hook: guard de scope.
+ *
+ * ESTE es el hook que convierte "no toques archivos fuera de tu scope" de
+ * 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.
+ *
+ * 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.
+ */
+import type { Office } from "../core/office.js";
+export interface ScopeGuardOptions {
+    /** Si es false, el guard solo avisa y no bloquea. */
+    enforce: boolean;
+}
+/**
+ * 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;
+/** ¿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;
+export declare function createScopeGuardHook(office: Office, options?: ScopeGuardOptions): (input: {
+    tool: string;
+    sessionID: string;
+    callID: string;
+}, output: {
+    args: Record<string, unknown>;
+}) => Promise<void>;
+//# sourceMappingURL=scopeGuard.d.ts.map

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

@@ -0,0 +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"}

package/dist/hooks/scopeGuard.js

@@ -0,0 +1,114 @@
+/**
+ * Hook: guard de scope.
+ *
+ * ESTE es el hook que convierte "no toques archivos fuera de tu scope" de
+ * 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.
+ *
+ * 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.
+ */
+import path from "node:path";
+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 `?`.
+ *
+ * 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 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);
+    });
+}
+/** Extrae el path del argumento de una tool de escritura. */
+export function extractPath(tool, args) {
+    const candidates = ["filePath", "path", "file", "target", "notebook_path"];
+    for (const key of candidates) {
+        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;
+}
+export function createScopeGuardHook(office, options = { enforce: true }) {
+    return async function onToolExecuteBefore(input, output) {
+        if (!output?.args)
+            return;
+        if (!WRITE_TOOLS.has(input.tool))
+            return;
+        try {
+            const state = await office.loadState();
+            const card = office.sessionCard(state, input.sessionID);
+            // 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)
+                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/"))
+                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.`);
+            }
+            log.debug("scope ok", { card: card.id, file: relative });
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.startsWith("[OFICINA]")) {
+                if (options.enforce)
+                    throw err;
+                log.warn("scope violado (sin bloquear)", { error: err.message });
+                return;
+            }
+            log.error("fallo en el guard de scope", { error: String(err) });
+        }
+    };
+}
+//# sourceMappingURL=scopeGuard.js.map

package/dist/hooks/scopeGuard.js.map

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