@hoilab/ada-cli 0.85.0 → 0.85.3

package/dist/core/capability/fs.js

@@ -0,0 +1,106 @@
+/**
+ * Helpers de FS para el capability registry (B01).
+ *
+ * Lectura cacheada con guardia FIFO/socket (igual que
+ * `oh-my-pi/packages/coding-agent/src/capability/fs.ts:~22`): antes de leer
+ * con `fs.readFile`, se hace `stat.isFile()` para no colgarse leyendo un
+ * FIFO/socket/char-device — en discovery se escanean directorios ajenos
+ * (~/.claude, ~/.cursor) donde puede haber FIFOs.
+ *
+ * También provee `findRepoRoot` walk-up buscando `.git` (fichero o directorio),
+ * usado para construir `LoadContext.repoRoot`.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+const contentCache = new Map();
+const dirCache = new Map();
+function resolvePath(filePath) {
+    return path.resolve(filePath);
+}
+export async function readFile(filePath) {
+    const abs = resolvePath(filePath);
+    if (contentCache.has(abs))
+        return contentCache.get(abs) ?? null;
+    try {
+        const stats = await fs.promises.stat(abs);
+        if (!stats.isFile()) {
+            contentCache.set(abs, null);
+            return null;
+        }
+        const content = await fs.promises.readFile(abs, "utf-8");
+        contentCache.set(abs, content);
+        return content;
+    }
+    catch {
+        contentCache.set(abs, null);
+        return null;
+    }
+}
+export async function readDirEntries(dirPath) {
+    const abs = resolvePath(dirPath);
+    if (dirCache.has(abs))
+        return dirCache.get(abs) ?? [];
+    try {
+        const entries = await fs.promises.readdir(abs, { withFileTypes: true });
+        dirCache.set(abs, entries);
+        return entries;
+    }
+    catch {
+        dirCache.set(abs, []);
+        return [];
+    }
+}
+export async function readDir(dirPath) {
+    const entries = await readDirEntries(dirPath);
+    return entries.map((e) => e.name);
+}
+export async function walkUp(startDir, name, opts = {}) {
+    const { file = true, dir = true } = opts;
+    let current = resolvePath(startDir);
+    while (true) {
+        const entries = await readDirEntries(current);
+        const entry = entries.find((e) => e.name === name);
+        if (entry) {
+            if (file && entry.isFile())
+                return path.join(current, name);
+            if (dir && entry.isDirectory())
+                return path.join(current, name);
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/**
+ * Camina hacia arriba desde startDir buscando `.git` (fichero o directorio).
+ * Devuelve el directorio que contiene `.git` o null si no hay repo.
+ */
+export async function findRepoRoot(startDir) {
+    let current = resolvePath(startDir);
+    while (true) {
+        const entries = await readDirEntries(current);
+        if (entries.some((e) => e.name === ".git"))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+export function cacheStats() {
+    return { content: contentCache.size, dir: dirCache.size };
+}
+export function clearCache() {
+    contentCache.clear();
+    dirCache.clear();
+}
+export function invalidate(filePath) {
+    const abs = resolvePath(filePath);
+    contentCache.delete(abs);
+    dirCache.delete(abs);
+    const parent = path.dirname(abs);
+    if (parent !== abs)
+        dirCache.delete(parent);
+}
+//# sourceMappingURL=fs.js.map

package/dist/core/capability/fs.js.map

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

package/dist/core/capability/index.d.ts

@@ -0,0 +1,68 @@
+import type { CapabilityDefinition, CapabilityProvider, CapabilityResult, LoadContext, LoadOptions } from "./types.ts";
+export type { CapabilityDefinition, CapabilityEntry, CapabilityProvider, CapabilityResult, LoadContext, LoadOptions, LoadResult, SourceMeta, } from "./types.ts";
+/**
+ * Define una capability nueva. Lanza si ya existe.
+ */
+export declare function defineCapability<T>(def: CapabilityDefinition<T>): CapabilityDefinition<T> & {
+    providers: CapabilityProvider<T>[];
+};
+/**
+ * Registra un provider para una capability ya definida. Inserta en orden de
+ * prioridad descendente (first-wins en dedup).
+ */
+export declare function registerProvider<T>(capabilityId: string, provider: CapabilityProvider<T>): void;
+/**
+ * Lista IDs de capabilities registradas.
+ */
+export declare function listCapabilities(): string[];
+/**
+ * Obtiene la definición de una capability (para introspección / /status).
+ */
+export declare function getCapability<T>(id: string): (CapabilityDefinition<T> & {
+    providers: CapabilityProvider<T>[];
+}) | undefined;
+export declare function disableProvider(id: string): void;
+export declare function enableProvider(id: string): void;
+export declare function isProviderEnabled(id: string): boolean;
+export declare function getDisabledProviders(): string[];
+export declare function clearRegistryForTesting(): void;
+/**
+ * Carga una capability agregando N providers con prioridad y dedup first-wins.
+ *
+ * Es la función habilitadora de B02 (config ajena), B03 (marketplace) y D07
+ * (TTSR scoping): cada nueva fuente de config se convierte en una entrada de
+ * registro, no en un `if` más.
+ *
+ * @param capability - definición con key/equivalent/validate.
+ * @param providers  - providers a agregar (ya ordenados o no; se reordenan por priority).
+ * @param ctx        - contexto de carga (cwd/home/repoRoot).
+ * @param options    - filter / suppress / includeInvalid.
+ */
+export declare function loadCapabilities<T>(capability: CapabilityDefinition<T>, providers: CapabilityProvider<T>[], ctx: LoadContext, options?: LoadOptions<T>): Promise<CapabilityResult<T>>;
+/**
+ * Variante que resuelve la capability por ID del registro global. Útil para
+ * callers que ya registraron providers vía defineCapability/registerProvider.
+ */
+export declare function loadCapability<T>(capabilityId: string, options?: LoadOptions<T> & {
+    ctx?: LoadContext;
+}): Promise<CapabilityResult<T>>;
+/**
+ * Dedup first-wins por clave exacta y por equivalencia semántica. Es LA
+ * máquina de sombreado del registry: los perdedores quedan marcados con
+ * `_shadowed = true` (en el propio objeto, visible en diagnóstico) y no se
+ * devuelven entre los supervivientes.
+ *
+ * Exportada para que otros agregadores multi-origen (p.ej. descubrimiento
+ * MCP) reutilicen la misma semántica en vez de reimplementarla.
+ */
+export declare function dedupFirstWins<T extends {
+    _shadowed?: boolean;
+}>(items: T[], key: (item: T) => string | undefined, equivalent?: (a: T, b: T) => boolean, clavesReservadas?: Iterable<string>): T[];
+/**
+ * Resuelve el repo root caminando hacia arriba buscando `.git`.
+ * Re-exportado desde fs.ts para callers que construyen su LoadContext.
+ */
+export { findRepoRoot } from "./fs.ts";
+export declare function makeLoadContext(overrides?: Partial<LoadContext>): LoadContext;
+export declare function resolvePath(p: string, cwd?: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/capability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/capability/index.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACX,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,WAAW,EAEX,MAAM,YAAY,CAAC;AAGpB,YAAY,EACX,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,UAAU,EACV,UAAU,GACV,MAAM,YAAY,CAAC;AASpB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC1B,oBAAoB,CAAC,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAYlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAO/F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC9B,EAAE,EAAE,MAAM,GACR,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAAC,GAAG,SAAS,CAEhF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEhD;AACD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE/C;AACD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD;AACD,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AACD,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACvC,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACnC,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAClC,GAAG,EAAE,WAAW,EAChB,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAgB9B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACrC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,WAAW,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,WAAW,CAAA;CAAO,GAClD,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAY9B;AAGD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,EAC/D,KAAK,EAAE,CAAC,EAAE,EACV,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,EACpC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,EACpC,gBAAgB,GAAE,QAAQ,CAAC,MAAM,CAAM,GACrC,CAAC,EAAE,CAuBL;AAgGD;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,wBAAgB,eAAe,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAMjF;AAGD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/core/capability/index.js

@@ -0,0 +1,258 @@
+import * as os from "node:os";
+import * as path from "node:path";
+import { withHostGuard } from "../higiene/withHostGuard.js";
+/**
+ * Capability registry multi-origen — motor de agregación (B01).
+ *
+ * Reproduce el patrón de `oh-my-pi/packages/coding-agent/src/capability/index.ts`
+ * (~420 LOC): `loadCapability` agrega N providers con prioridad, dedup
+ * first-wins, semánticas filter vs suppress vs equivalent, validación
+ * post-dedup e introspección. Adaptado a Node puro y a Ada (sin Bun.file,
+ * sin Settings acoplado, sin prioridades mágicas dispersas).
+ *
+ * Contrato clave:
+ * - Providers se ordenan por `priority` descendente (mayor primero). A igualdad,
+ *   se preserva el orden de registro.
+ * - `filter`: el item no existe para el dedup (no reclama clave).
+ * - `suppress`: el item reclama clave y hace shadow de homónimos de menor
+ *   prioridad, pero nunca equivalence-shadow a survivors con clave distinta.
+ * - `equivalent`: dedup semántico entre claves distintas; el primero gana.
+ * - `key() === undefined`: nunca deduplicar.
+ * - Validación DESPUÉS del dedup, solo sobre survivors. Los inválidos se
+ *   descartan con warning, no abortan la carga.
+ */
+import { findRepoRoot } from "./fs.js";
+// =============================================================================
+// Registro global opcional (defineCapability / registerProvider)
+// =============================================================================
+const capabilities = new Map();
+const disabledProviders = new Set();
+/**
+ * Define una capability nueva. Lanza si ya existe.
+ */
+export function defineCapability(def) {
+    if (capabilities.has(def.id)) {
+        throw new Error(`Capability "${def.id}" ya está definida`);
+    }
+    const entry = { ...def, providers: [] };
+    capabilities.set(def.id, entry);
+    return entry;
+}
+/**
+ * Registra un provider para una capability ya definida. Inserta en orden de
+ * prioridad descendente (first-wins en dedup).
+ */
+export function registerProvider(capabilityId, provider) {
+    const cap = capabilities.get(capabilityId);
+    if (!cap)
+        throw new Error(`Capability desconocida: "${capabilityId}". Define primero con defineCapability().`);
+    const providers = cap.providers;
+    const idx = providers.findIndex((p) => p.priority < provider.priority);
+    if (idx === -1)
+        providers.push(provider);
+    else
+        providers.splice(idx, 0, provider);
+}
+/**
+ * Lista IDs de capabilities registradas.
+ */
+export function listCapabilities() {
+    return [...capabilities.keys()];
+}
+/**
+ * Obtiene la definición de una capability (para introspección / /status).
+ */
+export function getCapability(id) {
+    return capabilities.get(id);
+}
+export function disableProvider(id) {
+    disabledProviders.add(id);
+}
+export function enableProvider(id) {
+    disabledProviders.delete(id);
+}
+export function isProviderEnabled(id) {
+    return !disabledProviders.has(id);
+}
+export function getDisabledProviders() {
+    return [...disabledProviders];
+}
+export function clearRegistryForTesting() {
+    capabilities.clear();
+    disabledProviders.clear();
+}
+// =============================================================================
+// Núcleo: agregación multi-provider con dedup priorizado
+// =============================================================================
+/**
+ * Carga una capability agregando N providers con prioridad y dedup first-wins.
+ *
+ * Es la función habilitadora de B02 (config ajena), B03 (marketplace) y D07
+ * (TTSR scoping): cada nueva fuente de config se convierte en una entrada de
+ * registro, no en un `if` más.
+ *
+ * @param capability - definición con key/equivalent/validate.
+ * @param providers  - providers a agregar (ya ordenados o no; se reordenan por priority).
+ * @param ctx        - contexto de carga (cwd/home/repoRoot).
+ * @param options    - filter / suppress / includeInvalid.
+ */
+export async function loadCapabilities(capability, providers, ctx, options = {}) {
+    // Filtrar por disabled y por allowlist/blocklist de options.
+    let active = providers.filter((p) => !disabledProviders.has(p.id));
+    if (options.providers) {
+        const allow = new Set(options.providers);
+        active = active.filter((p) => allow.has(p.id));
+    }
+    if (options.excludeProviders) {
+        const deny = new Set(options.excludeProviders);
+        active = active.filter((p) => !deny.has(p.id));
+    }
+    // Ordenar por prioridad descendente, estable (first-wins en empate).
+    const sorted = [...active].sort((a, b) => b.priority - a.priority);
+    return loadImpl(capability, sorted, ctx, options);
+}
+/**
+ * Variante que resuelve la capability por ID del registro global. Útil para
+ * callers que ya registraron providers vía defineCapability/registerProvider.
+ */
+export async function loadCapability(capabilityId, options = {}) {
+    const cap = capabilities.get(capabilityId);
+    if (!cap)
+        throw new Error(`Capability desconocida: "${capabilityId}"`);
+    const ctx = options.ctx ?? {
+        cwd: options.cwd ?? process.cwd(),
+        home: os.homedir(),
+        repoRoot: await findRepoRoot(options.cwd ?? process.cwd()),
+    };
+    const { ctx: _omit, ...rest } = options;
+    return loadCapabilities(cap, cap.providers, ctx, rest);
+}
+// Implementación compartida: carga concurrente + dedup + validación post-dedup.
+/**
+ * Dedup first-wins por clave exacta y por equivalencia semántica. Es LA
+ * máquina de sombreado del registry: los perdedores quedan marcados con
+ * `_shadowed = true` (en el propio objeto, visible en diagnóstico) y no se
+ * devuelven entre los supervivientes.
+ *
+ * Exportada para que otros agregadores multi-origen (p.ej. descubrimiento
+ * MCP) reutilicen la misma semántica en vez de reimplementarla.
+ */
+export function dedupFirstWins(items, key, equivalent, clavesReservadas = []) {
+    const seen = new Set(clavesReservadas);
+    const deduped = [];
+    for (const item of items) {
+        const k = key(item);
+        if (k === undefined) {
+            deduped.push(item);
+            continue;
+        }
+        const keySeen = seen.has(k);
+        seen.add(k);
+        const aliasSeen = !keySeen && equivalent !== undefined && deduped.some((existing) => equivalent(existing, item));
+        if (keySeen || aliasSeen) {
+            item._shadowed = true;
+        }
+        else {
+            deduped.push(item);
+        }
+    }
+    return deduped;
+}
+async function loadImpl(capability, providers, ctx, options) {
+    const allItems = [];
+    const suppressedItems = new Set();
+    const allWarnings = [];
+    const contributingProviders = [];
+    const results = await Promise.all(providers.map(async (provider) => {
+        const boxed = await withHostGuard(() => provider.load(ctx).then((v) => ({ __v: v })), {
+            name: `capability:${provider.id}`,
+            timeoutMs: 5000,
+        });
+        if (boxed === undefined) {
+            return { provider, error: new Error("provider abortado por hostGuard") };
+        }
+        return { provider, result: boxed.__v };
+    }));
+    for (const entry of results) {
+        const { provider } = entry;
+        if ("error" in entry) {
+            const msg = entry.error instanceof Error ? entry.error.message : String(entry.error);
+            allWarnings.push(`[${provider.displayName}] Fallo al cargar: ${msg}`);
+            continue;
+        }
+        const result = entry.result;
+        if (!result)
+            continue;
+        if (result.warnings) {
+            allWarnings.push(...result.warnings.map((w) => `[${provider.displayName}] ${w}`));
+        }
+        let contributed = 0;
+        for (const raw of result.items) {
+            const item = raw;
+            if (!item._source) {
+                allWarnings.push(`[${provider.displayName}] Item sin _source, se ignora`);
+                continue;
+            }
+            // filter: como si nunca hubiera existido.
+            if (options.filter && !options.filter(item)) {
+                continue;
+            }
+            // suppress: reclama clave pero no sobrevive.
+            if (options.suppress?.(item)) {
+                const shadowed = item;
+                suppressedItems.add(shadowed);
+                allItems.push(shadowed);
+                continue;
+            }
+            allItems.push(item);
+            contributed += 1;
+        }
+        if (contributed > 0)
+            contributingProviders.push(provider.id);
+    }
+    // Dedup first-wins por key y por equivalencia semántica (máquina compartida).
+    const equivalent = capability.equivalent;
+    const visibles = allItems.filter((it) => !suppressedItems.has(it));
+    const reservadas = allItems
+        .filter((it) => suppressedItems.has(it))
+        .map((it) => capability.key(it))
+        .filter((k) => k !== undefined);
+    const deduped = dedupFirstWins(visibles, (it) => capability.key(it), equivalent, reservadas);
+    // Validación post-dedup (solo survivors). Los inválidos se descartan con warning.
+    if (capability.validate && !options.includeInvalid) {
+        for (let i = deduped.length - 1; i >= 0; i--) {
+            const error = capability.validate(deduped[i]);
+            if (error) {
+                const source = deduped[i]._source;
+                allWarnings.push(`[${source?.providerName ?? "desconocido"}] Item inválido en ${source?.path ?? "desconocido"}: ${error}`);
+                deduped.splice(i, 1);
+            }
+        }
+    }
+    // `all` expone items visibles (suprimidos no se exponen, igual que omp).
+    const all = suppressedItems.size > 0 ? allItems.filter((it) => !suppressedItems.has(it)) : allItems;
+    return {
+        items: deduped,
+        all,
+        warnings: allWarnings,
+        providers: contributingProviders,
+    };
+}
+/**
+ * Resuelve el repo root caminando hacia arriba buscando `.git`.
+ * Re-exportado desde fs.ts para callers que construyen su LoadContext.
+ */
+export { findRepoRoot } from "./fs.js";
+// Helper para construir un LoadContext mínimo en tests o callers simples.
+export function makeLoadContext(overrides = {}) {
+    return {
+        cwd: overrides.cwd ?? process.cwd(),
+        home: overrides.home ?? os.homedir(),
+        repoRoot: overrides.repoRoot ?? null,
+    };
+}
+// Resolver path absoluto (útil en tests).
+export function resolvePath(p, cwd) {
+    return cwd ? path.resolve(cwd, p) : path.resolve(p);
+}
+//# sourceMappingURL=index.js.map

package/dist/core/capability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/capability/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAuBvC,gFAAgF;AAChF,iEAAiE;AACjE,gFAAgF;AAEhF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAwF,CAAC;AACrH,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,GAA4B;IAE5B,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,EAA6B,EAE/D,CAAC;IACF,YAAY,CAAC,GAAG,CACf,GAAG,CAAC,EAAE,EACN,KAAgG,CAChG,CAAC;IACF,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAI,YAAoB,EAAE,QAA+B;IACxF,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,2CAA2C,CAAC,CAAC;IAC/G,MAAM,SAAS,GAAG,GAAG,CAAC,SAAoC,CAAC;IAC3D,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvE,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,SAAS,CAAC,IAAI,CAAC,QAA4C,CAAC,CAAC;;QACxE,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,QAA4C,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC/B,OAAO,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,EAAU;IAEV,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,CAAmF,CAAC;AAC/G,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACzC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,EAAU;IACxC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC3C,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC;AACD,MAAM,UAAU,oBAAoB;IACnC,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;AAC/B,CAAC;AACD,MAAM,UAAU,uBAAuB;IACtC,YAAY,CAAC,KAAK,EAAE,CAAC;IACrB,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAChF,yDAAyD;AACzD,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,UAAmC,EACnC,SAAkC,EAClC,GAAgB,EAChB,UAA0B,EAAE;IAE5B,6DAA6D;IAC7D,IAAI,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC/C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,qEAAqE;IACrE,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEnE,OAAO,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,YAAoB,EACpB,UAAkD,EAAE;IAEpD,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAE7B,CAAC;IACb,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,GAAG,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACjC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE;QAClB,QAAQ,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;KAC1D,CAAC;IACF,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,OAAiD,CAAC;IAClF,OAAO,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,gFAAgF;AAChF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC7B,KAAU,EACV,GAAoC,EACpC,UAAoC,EACpC,mBAAqC,EAAE;IAEvC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAEpB,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACV,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,MAAM,SAAS,GAAG,CAAC,OAAO,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACjH,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AACD,KAAK,UAAU,QAAQ,CACtB,UAAmC,EACnC,SAAkC,EAClC,GAAgB,EAChB,OAAuB;IAGvB,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAY,CAAC;IAC5C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,qBAAqB,GAAa,EAAE,CAAC;IAE3C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAU,CAAC,EAAE;YAC9F,IAAI,EAAE,cAAc,QAAQ,CAAC,EAAE,EAAE;YACjC,SAAS,EAAE,IAAI;SACf,CAAC,CAAC;QACH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,iCAAiC,CAAC,EAAE,CAAC;QAC1E,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACxC,CAAC,CAAC,CACF,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;QAC3B,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrF,WAAW,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,WAAW,sBAAsB,GAAG,EAAE,CAAC,CAAC;YACtE,SAAS;QACV,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,GAAkC,CAAC;YAChD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACnB,WAAW,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,WAAW,+BAA+B,CAAC,CAAC;gBAC1E,SAAS;YACV,CAAC;YACD,0CAA0C;YAC1C,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,SAAS;YACV,CAAC;YACD,6CAA6C;YAC7C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAG,IAAgB,CAAC;gBAClC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,SAAS;YACV,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,IAAgB,CAAC,CAAC;YAChC,WAAW,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,WAAW,GAAG,CAAC;YAAE,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,8EAA8E;IAC9E,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,QAAQ;SACzB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAE7F,kFAAkF;IAClF,IAAI,UAAU,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QACpD,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;YAC/C,IAAI,KAAK,EAAE,CAAC;gBACX,MAAM,MAAM,GAAI,OAAO,CAAC,CAAC,CAAiC,CAAC,OAAO,CAAC;gBACnE,WAAW,CAAC,IAAI,CACf,IAAI,MAAM,EAAE,YAAY,IAAI,aAAa,sBAAsB,MAAM,EAAE,IAAI,IAAI,aAAa,KAAK,KAAK,EAAE,CACxG,CAAC;gBACF,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACtB,CAAC;QACF,CAAC;IACF,CAAC;IAED,yEAAyE;IACzE,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEpG,OAAO;QACN,KAAK,EAAE,OAAO;QACd,GAAG;QACH,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,qBAAqB;KAChC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAC,YAAkC,EAAE;IACnE,OAAO;QACN,GAAG,EAAE,SAAS,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACnC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE;QACpC,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,IAAI;KACpC,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,GAAY;IAClD,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,168 @@
+/**
+ * Tipos del capability registry multi-origen (B01).
+ *
+ * Inversión de control: cada fuente nueva de config es un provider
+ * registrado, no un `if` más repartido por el código. Patrón tomado de
+ * oh-my-pi `capability/types.ts` (~170 LOC) y `capability/index.ts` (~420 LOC)
+ * con fiel reproducción de: providers priorizados, filter vs suppress vs
+ * equivalent, dedup first-wins y validación post-dedup.
+ *
+ * No se copian antipatrones: sin doble subsistema plugins/eventos, sin compat
+ * layer pi, sin prioridades mágicas dispersas — aquí la prioridad es un número
+ * explícito por provider y la precedencia se documenta con su bug (issue #7654)
+ * tal cual en omp.
+ */
+/**
+ * Contexto que recibe cada provider al cargar.
+ */
+export interface LoadContext {
+    /** Directorio de trabajo del proyecto (cwd del proceso o del workspace). */
+    cwd: string;
+    /** Directorio home del usuario. */
+    home: string;
+    /**
+     * Raíz del repo git (directorio que contiene `.git`), o null si no hay repo.
+     * Útil para providers que buscan ficheros walk-up.
+     */
+    repoRoot: string | null;
+}
+/**
+ * Metadatos de procedencia que se adjuntan a cada item cargado.
+ * Es lo que permite `/status` y el diagnóstico de shadowing.
+ */
+export interface SourceMeta {
+    /** ID del provider que cargó el item (p.ej. "claude", "native"). */
+    provider: string;
+    /** Nombre legible del provider (para UI). */
+    providerName: string;
+    /** Ruta absoluta al fichero origen. */
+    path: string;
+    /** Nivel de donde vino: user (~/.claude) vs project (.claude/) vs native (.omp). */
+    level: "user" | "project" | "native";
+}
+/**
+ * Resultado que devuelve cada provider al cargar.
+ */
+export interface LoadResult<T> {
+    items: Array<T & {
+        _source: SourceMeta;
+    }>;
+    /** Warnings de parseo, ficheros rotos, etc. No abortan la carga. */
+    warnings?: string[];
+}
+/**
+ * Provider de una capability. Cada fuente de config (native, claude, codex,
+ * cursor, etc.) implementa esta interfaz para cada capability que soporta.
+ *
+ * La prioridad determina el orden de precedencia: mayor prioridad gana en el
+ * dedup (first-wins). Rangos sugeridos (igual que omp):
+ *   100+ : primarios (native/ada)
+ *   50-99: herramientas específicas (claude, codex, gemini)
+ *   1-49 : estándares compartidos (mcp-json, agents-md)
+ */
+export interface CapabilityProvider<T> {
+    /** ID único del provider (p.ej. "claude"). */
+    id: string;
+    /** Nombre legible para UI (p.ej. "Claude Code"). */
+    displayName: string;
+    /** Descripción corta para settings/UI. */
+    description: string;
+    /** Prioridad: mayor = se comprueba primero, gana en conflictos. */
+    priority: number;
+    /**
+     * Carga los items de este provider. Debe devolverlos en orden
+     * proyecto-antes-de-usuario para que un `enabled:false` de proyecto
+     * reclame la clave antes que el homónimo de usuario (bug #7654).
+     */
+    load(ctx: LoadContext): Promise<LoadResult<T>>;
+}
+/** Entrada ya cargada con su metadato de origen. */
+export type CapabilityEntry<T> = T & {
+    _source: SourceMeta;
+};
+/**
+ * Opciones de carga. Reproducen fielmente las semánticas de omp:
+ * - filter: el item es como si nunca hubiera existido (no reclama clave).
+ * - suppress: el item reclama clave y ensombrece homónimos de menor
+ *   prioridad, pero nunca sobrevive ni ensombrece por equivalencia semántica
+ *   a un survivor con clave distinta (un alias suprimido no puede starvear
+ *   una conexión equivalente habilitada).
+ * - equivalent: dedup semántico más allá de la clave (p.ej. dos MCP con
+ *   distinto nombre pero misma conexión).
+ */
+export interface LoadOptions<T = unknown> {
+    /**
+     * Descarta items antes del dedup como si nunca hubieran existido. Un item
+     * filtrado ni sobrevive ni reclama su clave, así que no puede hacer shadow.
+     */
+    filter?(item: T & {
+        _source: SourceMeta;
+    }): boolean;
+    /**
+     * Excluye del resultado pero deja que el item reclame su clave. Un item
+     * suprimido de mayor prioridad ensombrece homónimos de menor prioridad
+     * (un server de proyecto `enabled:false` mantiene apagado el homónimo de
+     * usuario), pero nunca hace equivalence-shadow a un survivor con clave
+     * distinta.
+     */
+    suppress?(item: T & {
+        _source: SourceMeta;
+    }): boolean;
+    /** Incluir items que fallan validate(). Default: false (se descartan). */
+    includeInvalid?: boolean;
+    /** Solo estos providers (por ID). Default: todos. */
+    providers?: string[];
+    /** Excluir estos providers (por ID). */
+    excludeProviders?: string[];
+    /** cwd custom. Si no se pasa, quien llama resuelve el cwd. */
+    cwd?: string;
+}
+/**
+ * Resultado agregado tras cargar una capability desde todos los providers.
+ */
+export interface CapabilityResult<T> {
+    /** Items deduplicados en orden de prioridad (first-wins). */
+    items: Array<T & {
+        _source: SourceMeta;
+    }>;
+    /** Todos los items incluyendo duplicados ensombrecidos (para diagnóstico). */
+    all: Array<T & {
+        _source: SourceMeta;
+        _shadowed?: boolean;
+    }>;
+    /** Warnings agregados de todos los providers. */
+    warnings: string[];
+    /** Qué providers aportaron al menos un item no filtrado/suprimido. */
+    providers: string[];
+}
+/**
+ * Definición de una capability: qué se busca y cómo se deduplica/valida.
+ */
+export interface CapabilityDefinition<T> {
+    /** ID de la capability (p.ej. "mcps", "skills"). */
+    id: string;
+    /** Nombre legible para UI. */
+    displayName: string;
+    /** Descripción corta. */
+    description: string;
+    /**
+     * Clave de dedup. Items con la misma clave: gana el primero (mayor
+     * prioridad). `undefined` = nunca deduplicar (todos se conservan).
+     */
+    key(item: T): string | undefined;
+    /**
+     * Equivalencia semántica entre items de claves distintas. Si dos items
+     * con claves diferentes son equivalentes, el primero gana y el segundo se
+     * marca como shadowed. Permite no duplicar conexiones MCP textualmente
+     * distintas pero conectivamente iguales.
+     */
+    equivalent?(left: T, right: T): boolean;
+    /** Validación. Devuelve mensaje de error si inválido, undefined si válido. */
+    validate?(item: T): string | undefined;
+    /**
+     * ID de extensión para filtrar por disabledExtensions. Cuando está presente,
+     * loadCapabilities puede ocultar items deshabilitados vía settings.
+     */
+    toExtensionId?(item: T): string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/capability/types.js

@@ -0,0 +1,16 @@
+/**
+ * Tipos del capability registry multi-origen (B01).
+ *
+ * Inversión de control: cada fuente nueva de config es un provider
+ * registrado, no un `if` más repartido por el código. Patrón tomado de
+ * oh-my-pi `capability/types.ts` (~170 LOC) y `capability/index.ts` (~420 LOC)
+ * con fiel reproducción de: providers priorizados, filter vs suppress vs
+ * equivalent, dedup first-wins y validación post-dedup.
+ *
+ * No se copian antipatrones: sin doble subsistema plugins/eventos, sin compat
+ * layer pi, sin prioridades mágicas dispersas — aquí la prioridad es un número
+ * explícito por provider y la precedencia se documenta con su bug (issue #7654)
+ * tal cual en omp.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/capability/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/capability/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}