oficina-opencode 0.0.0-stage → 2.0.1

package/dist/core/paths.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Resolución de paths de la oficina.
+ *
+ * El problema que resuelve: los permisos y las rutas relativas de OpenCode
+ * resuelven contra el directorio de trabajo de la sesión, que no siempre es el
+ * proyecto. Si la oficina asumiera `cwd`, escribiría sus artefactos en el
+ * lugar equivocado y los agentes no se encontrarían.
+ *
+ * La regla: `PROJECT_ROOT` se detecta por marcadores de proyecto y todos los
+ * paths de la oficina son absolutos.
+ */
+export declare const PROJECT_MARKERS: string[];
+export interface ResolvedPaths {
+    /** Raíz del proyecto. */
+    projectRoot: string;
+    /** Directorio de la oficina: `<projectRoot>/.oficina`. */
+    officeDir: string;
+    /** `<officeDir>/bus`. */
+    busDir: string;
+    /** `<officeDir>/inbox`. */
+    inboxDir: string;
+    /** `<officeDir>/leases`. */
+    leasesDir: string;
+    /** `<officeDir>/artifacts`. */
+    artifactsDir: string;
+    /** `<officeDir>/fichas`. */
+    fichasDir: string;
+    /** `<officeDir>/roster.json`. */
+    rosterPath: string;
+    /** `<officeDir>/state.json`. */
+    statePath: string;
+    /** `<officeDir>/context.md`. */
+    contextPath: string;
+    /** `<officeDir>/board.md`. */
+    boardPath: string;
+    /** `<officeDir>/config.json`. */
+    configPath: string;
+    /** Si se usó el fallback global en vez del project-local. */
+    fallback: boolean;
+}
+/** ¿El directorio parece la raíz de un proyecto? */
+export declare function looksLikeProjectRoot(dir: string): Promise<boolean>;
+/**
+ * Resuelve el project root.
+ *
+ * 1. Si `cwd` es un project root → ese.
+ * 2. Si no, busca subdirectorios de primer nivel que lo sean. Si hay
+ *    exactamente uno → ese. Si hay varios → el de mayor cantidad de fuentes.
+ * 3. Si no hay ninguno → `cwd`.
+ */
+export declare function resolveProjectRoot(cwd: string): Promise<string>;
+/**
+ * Resuelve todos los paths de la oficina.
+ *
+ * Intenta `<projectRoot>/.oficina`. Si no se puede crear (proyecto de solo
+ * lectura, sandbox), cae a `~/.oficina/<slug>`.
+ */
+export declare function resolvePaths(cwd: string): Promise<ResolvedPaths>;
+/** Path de una card. */
+export declare function cardDir(paths: ResolvedPaths, cardId: string): string;
+/** Path del inbox de un agente. */
+export declare function inboxDirOf(paths: ResolvedPaths, agentId: string): string;
+/** Path de un lease. */
+export declare function leasePath(paths: ResolvedPaths, taskId: string): string;
+/** Convierte un path absoluto a relativo al project root, para artefactos. */
+export declare function relToProject(paths: ResolvedPaths, target: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,eAAO,MAAM,eAAe,UAgB3B,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,oDAAoD;AACpD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKxE;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BrE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiCtE;AAED,wBAAwB;AACxB,wBAAgB,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,mCAAmC;AACnC,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAwB;AACxB,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGzE"}

package/dist/core/paths.js

@@ -0,0 +1,136 @@
+/**
+ * Resolución de paths de la oficina.
+ *
+ * El problema que resuelve: los permisos y las rutas relativas de OpenCode
+ * resuelven contra el directorio de trabajo de la sesión, que no siempre es el
+ * proyecto. Si la oficina asumiera `cwd`, escribiría sus artefactos en el
+ * lugar equivocado y los agentes no se encontrarían.
+ *
+ * La regla: `PROJECT_ROOT` se detecta por marcadores de proyecto y todos los
+ * paths de la oficina son absolutos.
+ */
+import path from "node:path";
+import fs from "node:fs/promises";
+import { exists } from "./fsx.js";
+export const PROJECT_MARKERS = [
+    "package.json",
+    "pyproject.toml",
+    "setup.py",
+    "setup.cfg",
+    "requirements.txt",
+    "Cargo.toml",
+    "go.mod",
+    "pom.xml",
+    "build.gradle",
+    "build.gradle.kts",
+    "Makefile",
+    "composer.json",
+    "Gemfile",
+    "deno.json",
+    ".git",
+];
+/** ¿El directorio parece la raíz de un proyecto? */
+export async function looksLikeProjectRoot(dir) {
+    for (const marker of PROJECT_MARKERS) {
+        if (exists(path.join(dir, marker)))
+            return true;
+    }
+    return false;
+}
+/**
+ * Resuelve el project root.
+ *
+ * 1. Si `cwd` es un project root → ese.
+ * 2. Si no, busca subdirectorios de primer nivel que lo sean. Si hay
+ *    exactamente uno → ese. Si hay varios → el de mayor cantidad de fuentes.
+ * 3. Si no hay ninguno → `cwd`.
+ */
+export async function resolveProjectRoot(cwd) {
+    const abs = path.resolve(cwd);
+    if (await looksLikeProjectRoot(abs))
+        return abs;
+    let entries = [];
+    try {
+        entries = (await fs.readdir(abs, { withFileTypes: true }))
+            .filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules")
+            .map((e) => e.name);
+    }
+    catch {
+        return abs;
+    }
+    const candidates = [];
+    for (const name of entries) {
+        const dir = path.join(abs, name);
+        if (await looksLikeProjectRoot(dir)) {
+            let weight = 0;
+            for (const sub of ["src", "lib", "app", "packages", "server", "client"]) {
+                if (exists(path.join(dir, sub)))
+                    weight += 10;
+            }
+            candidates.push({ dir, weight });
+        }
+    }
+    if (candidates.length === 0)
+        return abs;
+    if (candidates.length === 1)
+        return candidates[0].dir;
+    candidates.sort((a, b) => b.weight - a.weight);
+    return candidates[0].dir;
+}
+/**
+ * Resuelve todos los paths de la oficina.
+ *
+ * Intenta `<projectRoot>/.oficina`. Si no se puede crear (proyecto de solo
+ * lectura, sandbox), cae a `~/.oficina/<slug>`.
+ */
+export async function resolvePaths(cwd) {
+    const projectRoot = await resolveProjectRoot(cwd);
+    const localOffice = path.join(projectRoot, ".oficina");
+    let officeDir = localOffice;
+    let fallback = false;
+    try {
+        await fs.mkdir(localOffice, { recursive: true });
+        const probe = path.join(localOffice, ".write-probe");
+        await fs.writeFile(probe, "ok");
+        await fs.rm(probe, { force: true });
+    }
+    catch {
+        const slug = path.basename(projectRoot).replace(/[^a-zA-Z0-9._-]/g, "-") || "proyecto";
+        officeDir = path.join(process.env.HOME ?? process.env.USERPROFILE ?? ".", ".oficina", slug);
+        await fs.mkdir(officeDir, { recursive: true });
+        fallback = true;
+    }
+    return {
+        projectRoot,
+        officeDir,
+        busDir: path.join(officeDir, "bus"),
+        inboxDir: path.join(officeDir, "inbox"),
+        leasesDir: path.join(officeDir, "leases"),
+        artifactsDir: path.join(officeDir, "artifacts"),
+        fichasDir: path.join(officeDir, "fichas"),
+        rosterPath: path.join(officeDir, "roster.json"),
+        statePath: path.join(officeDir, "state.json"),
+        contextPath: path.join(officeDir, "context.md"),
+        boardPath: path.join(officeDir, "board.md"),
+        configPath: path.join(officeDir, "config.json"),
+        fallback,
+    };
+}
+/** Path de una card. */
+export function cardDir(paths, cardId) {
+    return path.join(paths.artifactsDir, cardId);
+}
+/** Path del inbox de un agente. */
+export function inboxDirOf(paths, agentId) {
+    return path.join(paths.inboxDir, agentId);
+}
+/** Path de un lease. */
+export function leasePath(paths, taskId) {
+    return path.join(paths.leasesDir, `${taskId}.json`);
+}
+/** Convierte un path absoluto a relativo al project root, para artefactos. */
+export function relToProject(paths, target) {
+    const rel = path.relative(paths.projectRoot, target);
+    return rel.startsWith("..") ? target : rel;
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

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

package/dist/core/retry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Retry: la política de 3 golpes.
+ *
+ * Un rechazo de review no es un evento, es un estado. Un agente que "no
+ * cumple" y se le deja reintentar sin límite produce un loop infinito que
+ * quema presupuesto sin avanzar. Los contadores viven acá, en código.
+ *
+ *   rechazo 1 → REWORK   (mismo owner, con el feedback del review)
+ *   rechazo 2 → REPLAN   (el Director rehace la card: puede cambiar owner,
+ *                          scope o enfoque; si el owner ya falló dos veces,
+ *                          se rota)
+ *   rechazo 3 → ESCALATE (al usuario, con opciones concretas)
+ */
+import type { Card, Limits, OfficeState } from "./types.js";
+export type RetryAction = "rework" | "replan" | "escalate" | "approve";
+export interface RetryDecision {
+    action: RetryAction;
+    /** Qué tiene que pasar, en texto, para el siguiente intento. */
+    instruction: string;
+    /** Si el owner debe cambiar. */
+    rotateOwner: boolean;
+    reason: string;
+}
+/** Calcula la próxima acción dado el estado de rechazo de una card. */
+export declare function decideRetry(card: Card, limits?: Limits): RetryDecision;
+/** Registra un rechazo y devuelve la card actualizada. */
+export declare function recordRejection(card: Card, reason: string): Card;
+/** Registra una aprobación. */
+export declare function recordApproval(card: Card, note: string): Card;
+/** Suma el presupuesto de llamadas a subagentes. */
+export declare function consumeAgentCall(state: OfficeState, calls?: number): void;
+/** Suma el presupuesto de cards. */
+export declare function consumeCard(state: OfficeState): void;
+/** Suma el presupuesto de spawns. */
+export declare function consumeSpawn(state: OfficeState): void;
+/** ¿Queda presupuesto? */
+export declare function hasBudget(state: OfficeState, limits: Limits): {
+    ok: boolean;
+    reason: string;
+};
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG3D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;AAEtE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAA;IACnB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,WAAW,EAAE,OAAO,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAqB,GAAG,aAAa,CAwBpF;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKhE;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG7D;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,SAAI,GAAG,IAAI,CAGpE;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAGpD;AAED,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAGrD;AAED,0BAA0B;AAC1B,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiB7F"}

package/dist/core/retry.js

@@ -0,0 +1,86 @@
+/**
+ * Retry: la política de 3 golpes.
+ *
+ * Un rechazo de review no es un evento, es un estado. Un agente que "no
+ * cumple" y se le deja reintentar sin límite produce un loop infinito que
+ * quema presupuesto sin avanzar. Los contadores viven acá, en código.
+ *
+ *   rechazo 1 → REWORK   (mismo owner, con el feedback del review)
+ *   rechazo 2 → REPLAN   (el Director rehace la card: puede cambiar owner,
+ *                          scope o enfoque; si el owner ya falló dos veces,
+ *                          se rota)
+ *   rechazo 3 → ESCALATE (al usuario, con opciones concretas)
+ */
+import { nowIso } from "./fsx.js";
+/** Calcula la próxima acción dado el estado de rechazo de una card. */
+export function decideRetry(card, limits = {}) {
+    const max = limits.maxReviewRejections ?? 3;
+    const rejections = card.rejections;
+    if (rejections <= 0) {
+        return { action: "approve", instruction: "", rotateOwner: false, reason: "sin rechazos previos" };
+    }
+    if (rejections < max) {
+        const rotate = rejections >= 2;
+        return {
+            action: rejections === 1 ? "rework" : "replan",
+            instruction: rotate
+                ? "Rehacé la card desde cero: revisá el scope, elegí un owner distinto y atacá el problema de otra forma. No repitas el intento anterior."
+                : "Corregí exactamente lo que el review marcó. No reescribas lo que ya estaba bien.",
+            rotateOwner: rotate,
+            reason: `${rejections} de ${max} rechazos`,
+        };
+    }
+    return {
+        action: "escalate",
+        instruction: "",
+        rotateOwner: true,
+        reason: `${rejections} rechazos agotaron el máximo de ${max}`,
+    };
+}
+/** Registra un rechazo y devuelve la card actualizada. */
+export function recordRejection(card, reason) {
+    card.rejections += 1;
+    card.attempts += 1;
+    card.result = `RECHAZADO (${card.rejections}): ${reason}`;
+    return card;
+}
+/** Registra una aprobación. */
+export function recordApproval(card, note) {
+    card.result = `APROBADO: ${note}`;
+    return card;
+}
+/** Suma el presupuesto de llamadas a subagentes. */
+export function consumeAgentCall(state, calls = 1) {
+    state.budget.agentCallsUsed += calls;
+    state.updatedAt = nowIso();
+}
+/** Suma el presupuesto de cards. */
+export function consumeCard(state) {
+    state.budget.cardsUsed += 1;
+    state.updatedAt = nowIso();
+}
+/** Suma el presupuesto de spawns. */
+export function consumeSpawn(state) {
+    state.budget.spawnsUsed += 1;
+    state.updatedAt = nowIso();
+}
+/** ¿Queda presupuesto? */
+export function hasBudget(state, limits) {
+    if (state.budget.cardsUsed >= state.budget.maxCards) {
+        return { ok: false, reason: `presupuesto de cards agotado (${state.budget.cardsUsed}/${state.budget.maxCards})` };
+    }
+    if (state.budget.agentCallsUsed >= state.budget.maxAgentCalls) {
+        return {
+            ok: false,
+            reason: `presupuesto de invocaciones agotado (${state.budget.agentCallsUsed}/${state.budget.maxAgentCalls})`,
+        };
+    }
+    if (state.budget.spawnsUsed >= state.budget.maxSpawnsTotal) {
+        return {
+            ok: false,
+            reason: `presupuesto de spawns agotado (${state.budget.spawnsUsed}/${state.budget.maxSpawnsTotal})`,
+        };
+    }
+    return { ok: true, reason: "presupuesto disponible" };
+}
+//# sourceMappingURL=retry.js.map

package/dist/core/retry.js.map

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

package/dist/core/roster.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Roster: la single source of truth de quién existe y qué está haciendo.
+ *
+ * Todos lo leen, nadie lo re-declara. El Integrador lo mantiene; los
+ * especialistas se auto-registran y reportan estado.
+ */
+import type { AgentState, Roster, RosterEntry, Ficha, FichaSource } from "./types.js";
+export declare class RosterStore {
+    private readonly rosterPath;
+    private readonly clock;
+    constructor(rosterPath: string, clock?: () => number);
+    /** Lee el roster. Si no existe, uno vacío. */
+    load(runId: string): Promise<Roster>;
+    /** Escribe el roster. */
+    save(roster: Roster): Promise<void>;
+    /** Registra o actualiza un agente a partir de su ficha. */
+    upsert(roster: Roster, ficha: Ficha, state?: AgentState): Promise<RosterEntry>;
+    /** Cambia el estado de un agente. */
+    setState(roster: Roster, agentId: string, state: AgentState): RosterEntry | undefined;
+    /** Marca heartbeat. Un agente sin heartbeat está muerto. */
+    heartbeat(roster: Roster, agentId: string): void;
+    /** Asigna una card a un agente. */
+    assign(roster: Roster, agentId: string, cardId: string): void;
+    /** Libera al agente. Vuelve al pool si corresponde. */
+    release(roster: Roster, agentId: string): void;
+    /** Agentes disponibles para aceptar trabajo. */
+    idlePool(roster: Roster): RosterEntry[];
+    /** Agentes trabajando. */
+    workingAgents(roster: Roster): RosterEntry[];
+    /**
+     * Agentes cuyo heartbeat venció.
+     *
+     * Un agente que no da señales está muerto: su card se reasigna y su lease
+     * expira. Sin esto, una corrida queda trabada por un subagente que murió
+     * en silencio.
+     */
+    deadAgents(roster: Roster, timeoutSec: number): RosterEntry[];
+    /** Registra que un agente ayudó a otro (anti-monotonía). */
+    recordHelp(roster: Roster, helperId: string, helpedId: string): void;
+    /** Ubica un agente por rol. */
+    findByRole(roster: Roster, role: string): RosterEntry | undefined;
+    /** Agentes que tienen una capability dada. */
+    findByCapability(roster: Roster, capability: string): RosterEntry[];
+}
+/** Construye la fuente de una ficha desde el roster. */
+export declare function sourceOf(entry: RosterEntry): FichaSource;
+//# sourceMappingURL=roster.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../../src/core/roster.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGrF,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAM,MAAiB;IAGjD,8CAA8C;IACxC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW1C,yBAAyB;IACnB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,2DAA2D;IACrD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,UAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BhG,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS;IAUrF,4DAA4D;IAC5D,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKhD,mCAAmC;IACnC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAS7D,uDAAuD;IACvD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAU9C,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAMvC,0BAA0B;IAC1B,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAI5C;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE;IAU7D,4DAA4D;IAC5D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUpE,+BAA+B;IAC/B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjE,8CAA8C;IAC9C,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE;CAGpE;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAExD"}

package/dist/core/roster.js

@@ -0,0 +1,146 @@
+/**
+ * Roster: la single source of truth de quién existe y qué está haciendo.
+ *
+ * Todos lo leen, nadie lo re-declara. El Integrador lo mantiene; los
+ * especialistas se auto-registran y reportan estado.
+ */
+import { nowIso, readJson, writeJsonAtomic } from "./fsx.js";
+export class RosterStore {
+    rosterPath;
+    clock;
+    constructor(rosterPath, clock = Date.now) {
+        this.rosterPath = rosterPath;
+        this.clock = clock;
+    }
+    /** Lee el roster. Si no existe, uno vacío. */
+    async load(runId) {
+        const existing = await readJson(this.rosterPath);
+        if (existing)
+            return existing;
+        return {
+            version: 2,
+            runId,
+            agents: {},
+            updatedAt: nowIso(this.clock),
+        };
+    }
+    /** Escribe el roster. */
+    async save(roster) {
+        roster.updatedAt = nowIso(this.clock);
+        await writeJsonAtomic(this.rosterPath, roster);
+    }
+    /** Registra o actualiza un agente a partir de su ficha. */
+    async upsert(roster, ficha, state = "deployed") {
+        const existing = roster.agents[ficha.id];
+        const entry = existing ?? {
+            id: ficha.id,
+            role: ficha.role,
+            displayName: ficha.displayName,
+            state,
+            capabilities: [...ficha.capabilities],
+            fichaPath: "",
+            currentCard: null,
+            lease: null,
+            idleSince: null,
+            canAccept: true,
+            helpGiven: 0,
+            helpReceived: 0,
+            helpedPeers: [],
+            lastHeartbeat: nowIso(this.clock),
+            source: ficha.source,
+        };
+        entry.role = ficha.role;
+        entry.displayName = ficha.displayName;
+        entry.capabilities = [...ficha.capabilities];
+        entry.source = ficha.source;
+        entry.lastHeartbeat = nowIso(this.clock);
+        roster.agents[ficha.id] = entry;
+        return entry;
+    }
+    /** Cambia el estado de un agente. */
+    setState(roster, agentId, state) {
+        const entry = roster.agents[agentId];
+        if (!entry)
+            return undefined;
+        entry.state = state;
+        entry.idleSince = state === "idle_available" ? nowIso(this.clock) : null;
+        entry.canAccept = state === "idle_available";
+        entry.lastHeartbeat = nowIso(this.clock);
+        return entry;
+    }
+    /** Marca heartbeat. Un agente sin heartbeat está muerto. */
+    heartbeat(roster, agentId) {
+        const entry = roster.agents[agentId];
+        if (entry)
+            entry.lastHeartbeat = nowIso(this.clock);
+    }
+    /** Asigna una card a un agente. */
+    assign(roster, agentId, cardId) {
+        const entry = roster.agents[agentId];
+        if (!entry)
+            return;
+        entry.currentCard = cardId;
+        entry.state = "working";
+        entry.canAccept = false;
+        entry.idleSince = null;
+    }
+    /** Libera al agente. Vuelve al pool si corresponde. */
+    release(roster, agentId) {
+        const entry = roster.agents[agentId];
+        if (!entry)
+            return;
+        entry.currentCard = null;
+        entry.lease = null;
+        if (entry.state !== "retired" && entry.state !== "blocked") {
+            this.setState(roster, agentId, "idle_available");
+        }
+    }
+    /** Agentes disponibles para aceptar trabajo. */
+    idlePool(roster) {
+        return Object.values(roster.agents)
+            .filter((a) => a.state === "idle_available" && a.canAccept && a.lease === null)
+            .sort((a, b) => (a.idleSince ?? "").localeCompare(b.idleSince ?? ""));
+    }
+    /** Agentes trabajando. */
+    workingAgents(roster) {
+        return Object.values(roster.agents).filter((a) => a.state === "working");
+    }
+    /**
+     * Agentes cuyo heartbeat venció.
+     *
+     * Un agente que no da señales está muerto: su card se reasigna y su lease
+     * expira. Sin esto, una corrida queda trabada por un subagente que murió
+     * en silencio.
+     */
+    deadAgents(roster, timeoutSec) {
+        const cutoff = this.clock() - timeoutSec * 1000;
+        return Object.values(roster.agents).filter((a) => a.state !== "retired" &&
+            a.state !== "idle_available" &&
+            Date.parse(a.lastHeartbeat) < cutoff);
+    }
+    /** Registra que un agente ayudó a otro (anti-monotonía). */
+    recordHelp(roster, helperId, helpedId) {
+        const helper = roster.agents[helperId];
+        const helped = roster.agents[helpedId];
+        if (helper) {
+            helper.helpGiven += 1;
+            if (!helper.helpedPeers.includes(helpedId))
+                helper.helpedPeers.push(helpedId);
+        }
+        if (helped)
+            helped.helpReceived += 1;
+    }
+    /** Ubica un agente por rol. */
+    findByRole(roster, role) {
+        return Object.values(roster.agents).find((a) => a.role === role);
+    }
+    /** Agentes que tienen una capability dada. */
+    findByCapability(roster, capability) {
+        return Object.values(roster.agents).filter((a) => a.capabilities.includes(capability));
+    }
+}
+/** Construye la fuente de una ficha desde el roster. */
+export function sourceOf(entry) {
+    return entry.source;
+}
+//# sourceMappingURL=roster.js.map

package/dist/core/roster.js.map

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

package/dist/core/router.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Router: qué agente hace qué card, y con qué rotación.
+ *
+ * Dos reglas hardcoded que vienen de los síntomas reportados:
+ *
+ * 1. **El revisor nunca es el owner.** Sin auto-aprobación.
+ * 2. **Rotación.** Si el mismo agente sería owner de 3 cards del mismo tipo
+ *    seguidas, la cuarta la toma otro. El "subagente monotono" es un bug de
+ *    routing, no de capacidad.
+ *
+ * La extensión: la rotación también aplica a la ayuda. Si el par A↔B ya se
+ * ayudaron dos veces, el tercer pedido se enruta a un tercero.
+ */
+import type { Card, CatalogAgent, Ficha, Roster, RosterEntry } from "./types.js";
+export interface RouteOptions {
+    /** Un agente con este rol ya hizo N cards del mismo tipo seguidos. */
+    ownerStreak?: number;
+    /** Máximo de cards del mismo tipo con el mismo owner antes de rotar. */
+    rotationThreshold?: number;
+    /** Pares que ya colaboraron N veces. */
+    pairCollaborationCount?: number;
+    /** Máximo de colaboraciones por par antes de enrutar a un tercero. */
+    pairRotationThreshold?: number;
+}
+export interface RouteResult {
+    owner: RosterEntry | null;
+    reviewer: RosterEntry | null;
+    /** Por qué se eligió ese owner. */
+    reason: string;
+    /** Si no hay owner posible, qué haría falta. */
+    missing: string[];
+}
+/** Tipo de card → rol canónico que debería ejecutarla. */
+export declare const ROLE_BY_CARD_TYPE: Record<Card["type"], string[]>;
+export declare const DEFAULT_ROTATION_THRESHOLD = 3;
+export declare const DEFAULT_PAIR_ROTATION_THRESHOLD = 2;
+/**
+ * Elige owner y reviewer para una card.
+ *
+ * Preferencia de owner:
+ * 1. Rol canónico del tipo de card (si está en el roster y está libre).
+ * 2. Mejor match por capabilities entre los agentes libres.
+ * 3. Agente idle del pool (para repartir carga).
+ *
+ * El reviewer se elige entre los que NO son el owner, priorizando los que no
+ * hayan reciente-compliant colaborado con el owner (umbral de anti-monotonía).
+ */
+export declare function routeCard(card: Card, roster: Roster, catalog?: CatalogAgent[], options?: RouteOptions): RouteResult;
+/**
+ * A quién enrutar un pedido de ayuda.
+ *
+ * 1. Los peers declarados en la ficha que estén libres.
+ * 2. Un tercero si el par ya colaboró demasiado (anti-monotonía extendida).
+ */
+export declare function routeHelp(requesterId: string, roster: Roster, requesterPeers?: string[], options?: RouteOptions): {
+    targets: string[];
+    reason: string;
+};
+/**
+ * Calcula la racha de cards del mismo tipo con el mismo owner.
+ *
+ * Se usa para decidir rotación.
+ */
+export declare function ownerStreak(cards: Record<string, Card> | Card[], order: string[], ownerId: string, type: Card["type"]): number;
+/** Construye la ficha de un agente de roster (para renderizar artefactos). */
+export declare function fichaFromEntry(entry: RosterEntry, source?: Ficha["source"]): Ficha;
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/core/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGhF,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,wCAAwC;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,sEAAsE;IACtE,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;IAC5B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAU5D,CAAA;AAED,eAAO,MAAM,0BAA0B,IAAI,CAAA;AAC3C,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAY,EAAO,EAC5B,OAAO,GAAE,YAAiB,GACzB,WAAW,CAwFb;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAM,EAAO,EAC7B,OAAO,GAAE,YAAiB,GACzB;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgCvC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,EACpC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GACjB,MAAM,CAcR;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAgBlF"}