oficina-opencode 0.0.0-stage → 2.0.0

package/dist/core/catalog.d.ts

@@ -0,0 +1,303 @@
+/**
+ * Catálogo: resolución de roles desde agency-agents.
+ *
+ * ## Por qué esto no es un `grep` de descripciones
+ *
+ * El repo de agency-agents tiene 306 agentes en 25 divisiones. Cada uno trae
+ * un *briefing* de 10 secciones, y la especialidad real NO está en el
+ * `description` del frontmatter: está en el cuerpo.
+ *
+ * Un agente de statistics, por ejemplo, declara:
+ * - description: "Expert in quantitative research methodology..."
+ * - Core Mission → "Pressure-Test Quantitative Claims", "Design Sound Studies"
+ * - Technical Deliverables → "Claim Interrogation Framework", "Effect Size Report"
+ * - Advanced Capabilities → "Causal Inference", "Experimental Design"
+ *
+ * La `description` dice "de qué se ocupa". El cuerpo dice **en qué es
+ * exactamente bueno**. Un matcher que solo mira la description no puede
+ * distinguir a un metodólogo de un analista de datos, aunque uno de los dos
+ * sea exactamente lo que la card necesita.
+ *
+ * Por eso el parser extrae las secciones del cuerpo y el matching pondera
+ * cada campo por lo que aporta.
+ */
+import type { CatalogAgent, CatalogMatch } from "./types.js";
+/** Parsea frontmatter YAML simple (clave: valor, sin anidación). */
+export declare function parseFrontmatter(content: string): {
+    data: Record<string, string>;
+    body: string;
+};
+/** Limpia un encabezado de sección de los emoji y espacios que agency-agents usa. */
+export declare function normalizeHeading(raw: string): string;
+/**
+ * Divide el cuerpo en secciones H2.
+ *
+ * Los encabezados de agency-agents vienen con emoji (`## 🎯 Your Identity &
+ * Memory`) o lisos (`## Core Mission`). Se normalizan para que el matching
+ * sea estable.
+ */
+export declare function parseSections(body: string): Record<string, string>;
+/**
+ * Busca una sección por cualquiera de sus nombres posibles.
+ *
+ * La estructura de agency-agents tiene variantes con y sin el "Your", y
+ * con y sin emoji. En vez de hardcodear 20 nombres, se busca por coincidencia
+ * de palabra clave.
+ */
+export declare function findSection(sections: Record<string, string>, ...keywords: string[]): string | undefined;
+/** Extrae los subtítulos H3 de un bloque de texto. */
+export declare function extractSubheadings(block: string | undefined): string[];
+/**
+ * Extrae las etiquetas de una sección "Core Mission".
+ *
+ * La sección viene en dos formatos y ambos son válidos en el repo real:
+ *
+ * 1. **Subtítulos H3** — `### Pressure-Test Quantitative Claims`
+ * 2. **Lista de bullets** — `- **Subvert Default Biases**: Ensure generated...`
+ *
+ * Se intentan los H3 primero. Si no hay, se cae a los bullets, y de cada
+ * bullet se extrae la etiqueta: la parte en negrita si la hay, o las
+ * primeras palabras antes del primer `:`.
+ *
+ * Sin este fallback, la mitad del catálogo queda sin misión declarada y el
+ * matching pierde la señal más fuerte que tiene.
+ */
+export declare function extractMissionLabels(block: string | undefined): string[];
+/** Extrae los items numerados o con guion de un bloque de texto. */
+export declare function extractListItems(block: string | undefined): string[];
+/**
+ * Mapa de tokens a dominios.
+ *
+ * Solo se usa para el fallback por tokens (cuando no hay match estructural).
+ * El matching principal es por secciones.
+ */
+export declare const CAPABILITY_TAXONOMY: Record<string, string[]>;
+/**
+ * Afinidad de división.
+ *
+ * Si la card pide capacidades de un dominio, la división homónima del
+ * catálogo es una señal fuerte. "gis" → división `gis`. "game" →
+ * `game-development`. Es una señal barata y muy precisa.
+ */
+export declare const DIVISION_AFFINITY: Record<string, string[]>;
+/**
+ * Convierte una frase en un conjunto de tokens con señal.
+ *
+ * Se filtran stopwords y tokens de menos de 3 caracteres. Los tokens de
+ * más de 3 caracteres se consideran "concepts" para el matching.
+ */
+export declare function capabilityTokens(phrase: string): Set<string>;
+/**
+ * Infiere capabilities de un agente.
+ *
+ * Tres fuentes, en orden de valor:
+ * 1. Los subtítulos de "Core Mission" — **la** especialidad del agente.
+ * 2. Los subtítulos de "Advanced Capabilities" — lo que maneja mejor.
+ * 3. Los subtítulos de "Technical Deliverables" — lo que produce.
+ *
+ * Más los tokens de la descripción y del nombre, como respaldo.
+ */
+export declare function extractCapabilities(agent: {
+    displayName: string;
+    description: string;
+    missions: string[];
+    deliverables: string[];
+    advanced: string[];
+}): string[];
+/**
+ * Convierte los subtítulos de misión en etiquetas legibles.
+ *
+ * "Pressure-Test Quantitative Claims" → "pressure-test quantitative claims".
+ * Se usan como capabilitiesdirectly comparables con lo que pide la card.
+ */
+export declare function missionTags(missions: string[]): string[];
+export interface CatalogScanOptions {
+    /** Raíz del repo agency-agents. */
+    root: string;
+    /** Divisiones a considerar. Vacío = todas. */
+    divisions?: string[];
+    /** Si es true, ignora las divisiones sin agentes de código. */
+    codeOnly?: boolean;
+}
+export declare function scanCatalog(options: CatalogScanOptions): Promise<CatalogAgent[]>;
+/** "frontend-developer" → "Frontend Developer". */
+export declare function titleize(slug: string): string;
+/**
+ * Pesos de cada señal en el score.
+ *
+ * El orden reflects dónde está la información real:
+ *
+ * 1. **El nombre del rol** (`engineering-frontend-developer`) es la etiqueta
+ *    más literal de la especialidad que existe. ElCommander también pide
+ *    roles por nombre, así que es la señal más alineada entre las dos
+ *    listas.
+ *
+ * 2. **La misión declarada** ("Create Modern Web Applications") es lo que el
+ *    agente dice que sabe hacer. El overlap literal es preciso; el
+ *    conceptual (con taxonomía) bridgea sinónimos.
+ *
+ * 3. **El cuerpo completo** es un pajaro: 300 líneas donde cualquier
+ *    palabra genérica ("review", "design", "audit") aparece en todos. Por
+ *    eso casi no pesa. Con peso alto, un "Legal Document Review" ganaba el
+ *    match de "revisar la seguridad de una API" por la palabra "review".
+ */
+export declare const MATCH_WEIGHTS: {
+    /** El nombre del rol y su display name. */
+    readonly name: 0.35;
+    /** La misión, overlap literal. */
+    readonly missionLiteral: 0.28;
+    /** La misión, overlap conceptual (taxonomía + lematización). */
+    readonly missionConcept: 0.18;
+    /** Capabilities inferidas del cuerpo. */
+    readonly capabilities: 0.05;
+    /** Lo que el agente sabe producir. */
+    readonly deliverables: 0.03;
+    /**
+     * La división: contexto, no especialidad — pero señal fuerte. Una card de
+     * e2e testing tiene que ir a la división `testing`, no a `engineering`.
+     */
+    readonly division: 0.1;
+    /** El texto completo: ruido puro. */
+    readonly text: 0.01;
+};
+/**
+ * Convierte una frase en un conjunto de tokens **y conceptos**.
+ *
+ * ## Por qué se conservan los tokens crudos
+ *
+ * La primera versión de esta función reemplazaba cada token por su grupo
+ * completo de alias. El efecto fue contraproducente: el objetivo
+ * `{playwright, e2e, testing, checkout, browser}` colapsaba a un solo
+ * concepto `testing`, y cualquier agente que mencionara "Testing" una vez
+ * (un code reviewer, por ejemplo)得分 100% de cobertura conceptual.
+ *
+ * La granularidad se pierde al colapsar. Por eso los tokens crudos se
+ * **conservan** y el concepto se **agrega**:
+ *
+ * - "web"    → {web, react}      (puentea con "frontend" y "react")
+ * - "Testing"→ {testing}         (no colapsa a sus 13 alias)
+ *
+ * Ahora un agente tiene que coincidir en **varias** de las cosas pedidas,
+ * no en una sola.
+ */
+export declare function canonicalConcepts(phrase: string): Set<string>;
+/**
+ * Sinónimos **por capability**.
+ *
+ * ## Por qué no alcanza con la taxonomía
+ *
+ * La taxonomía agrupa por *concepto*: "e2e" y "testing" caen en el mismo
+ * grupo. Con eso, un agente que dice "testing" matcheaba "e2e", y un PDF
+ * engine que menciona "Playwright" le ganaba a un Test Automation Engineer
+ * que decía "end-to-end" — que es la misma palabra escrita larga.
+ *
+ * Los sinónimos van **por capability**: "e2e" es "end-to-end", pero
+ * "e2e" NO es "playwright". Esa distinción es la que separa a un
+ * especialista de un generalista que menciona la tool de pasada.
+ */
+export declare const CAPABILITY_SYNONYMS: Record<string, string[]>;
+/**
+ * Sinónimos de una capability.
+ *
+ * Si la capability no está en la tabla, sus sinónimos son ella misma: el
+ * match es literal o lematizado.
+ */
+export declare function synonymsOf(capability: string): Set<string>;
+/**
+ * ¿El agente menciona esta capability, por sinonimia o lematización?
+ *
+ * La capability puede ser una **frase** ("react components"), no un token
+ * suelto: se tokeniza y se busca cualquiera de sus partes. Un token solo
+ * ("react") se busca como synonym group.
+ */
+export declare function mentionsCapability(agentTokens: Set<string>, capability: string): boolean;
+/**
+ * Fracción de las capabilities objetivo que el agente menciona.
+ *
+ * Una capability puede ser una **frase** ("react component accessibility").
+ * En ese caso cuenta como varias: cada palabra se evalúa por separado. Si no,
+ * "react component accessibility" valdría lo mismo que "react", y un agente
+ * que solo menciona accesibilidad ganaría una card de frontend.
+ */
+export declare function capabilityCoverage(agentTokens: Set<string>, target: string[]): number;
+/**
+ * Lematiza un token: "testing" → "test", "validation" → "validat".
+ *
+ * ## Por qué hace falta
+ *
+ * El Commander pide capabilities en sus palabras ("testing", "validation") y
+ * los agentes de agency-agents usan las suyas ("test", "validate"). Sin
+ * lematizar, dos palabras que significan lo mismo no se ven nunca.
+ *
+ * Es la diferencia entre un matcher de palabras y uno de conceptos.
+ */
+export declare function stem(token: string): string;
+/** Afinidad de la división con las capabilities pedidas. */
+export declare function divisionAffinity(division: string, target: string[]): number;
+/**
+ * Matchea un objetivo de capabilities contra el catálogo.
+ *
+ * El score es ponderado por campo, no una bolsa de tokens. Un agente cuyo
+ * "Core Mission" menciona literalmente lo que la card necesita gana sobre
+ * uno que menciona la palabra de pasada en el cuerpo.
+ */
+export declare function matchCapabilities(catalog: CatalogAgent[], target: string[], options?: {
+    division?: string;
+    minCoverage?: number;
+}): CatalogMatch | undefined;
+/**
+ * Resuelve un rol: catálogo primero, factory si la cobertura es baja.
+ *
+ * ## La cobertura es sobre el PANEL, no sobre el primario
+ *
+ * Un objetivo casi nunca es de un solo dominio. Si el primario cubre la
+ * mitad y un complemento cubre la otra mitad, el objetivo **está cubierto**
+ * y no hace falta fabricar un rol.
+ *
+ * La cobertura se mide como:Concepts cubiertos por el panel / concepts
+ * pedidos. El umbral de 0.6 significa "el equipo cubre el 60% de lo que
+ * la card pide". Por debajo, se fabrica el rol.
+ */
+export declare function resolveRole(catalog: CatalogAgent[], target: string[], minCoverage: number): {
+    match: CatalogMatch | undefined;
+    needsFactory: boolean;
+    panel?: RolePanel;
+};
+/**
+ * Devuelve los mejores N agentes para un objetivo, ordenados por cobertura.
+ *
+ * Útil para que el Comandante vea alternativas: "este es el mejor, pero
+ * estos dos también sirven y podrían repartir la carga".
+ */
+export declare function rankCandidates(catalog: CatalogAgent[], target: string[], limit?: number): CatalogMatch[];
+/**
+ * Construye un **panel de roles**: un primario más los complementos.
+ *
+ * ## Por qué un panel y no un solo agente
+ *
+ * Un objetivo casi nunca es de un solo dominio. "Formulario de login en
+ * React con validación y accesibilidad" necesita un frontend (que no sabe
+ * de ARIA) y un especialista en accesibilidad (que no sabe de React).
+ *
+ * Si el sistema elige uno solo, deja huecos. Si elige varios sin criterio,
+ * duplica capacidad.
+ *
+ * El panel resuelve las dos cosas:
+ * - **Primario**: el mejor match global. Se lleva la card.
+ * - **Complementos**: los agentes que cubren lo que el primario NO cubre.
+ *   Cada uno entra con un rol distinto y sin pisar al primario.
+ *
+ * Es la misma lógica del equipo real: nadie hace de frontend y de
+ * especialista en accesibilidad a la vez, pero los dos están en la oficina.
+ */
+export interface RolePanel {
+    primary: CatalogMatch | null;
+    complements: CatalogMatch[];
+    /** Capabilities que nadie del panel cubre. */
+    uncovered: string[];
+}
+export declare function buildPanel(catalog: CatalogAgent[], target: string[], options?: {
+    maxComplements?: number;
+    minComplementCoverage?: number;
+}): RolePanel;
+//# sourceMappingURL=catalog.d.ts.map

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

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