@hoilab/ada-cli 0.85.0 → 0.85.3

package/dist/utils/version-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/utils/version-check.ts"],"names":[],"mappings":"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","sourcesContent":["import { compare, valid } from \"semver\";\nimport { PACKAGE_NAME } from \"../config.ts\";\nimport { fetchWithRetry } from \"./management-http.ts\";\nimport { getPiUserAgent } from \"./pi-user-agent.ts\";\n\n/**\n * De dónde se pregunta cuál es la última versión: del registro de NUESTRO\n * paquete.\n *\n * Antes apuntaba a `https://pi.dev/api/latest-version`, que es el servidor de\n * upstream. Medido llamándolo:\n *\n *     {\"ok\":true,\"version\":\"0.84.3\",\"packageName\":\"@earendil-works/pi-coding-agent\"}\n *\n * Y `getSelfUpdatePlan` construye `installSpec` con ESE `packageName`. O sea que\n * `ada-cli update` estaba a un release de distancia de instalar el paquete de\n * upstream ENCIMA del nuestro. Hoy no lo hace por aritmética: nuestra versión es\n * 0.84.22 y 0.84.3 no es mayor. En cuanto ellos publiquen 0.85 —y nosotros\n * teníamos pendiente subir a 0.85.0—, `isNewerPackageVersion(\"0.85.0\",\n * \"0.84.22\")` es `true` y el comando que promete actualizar Ada sustituye Ada.\n *\n * Mientras tanto tampoco servía para nada: comparaba nuestra versión con la de\n * otro producto y contestaba «ya estás al día» sin haber mirado nuestro\n * paquete.\n *\n * El registro de npm evita montar un endpoint propio, y de paso quita el\n * `packageName` remoto de la ecuación: npm devuelve el campo `name`, no\n * `packageName`, así que el `?? PACKAGE_NAME` de `getSelfUpdatePlan` cae del\n * lado correcto. Aun así allí se deja de leer del remoto, porque «un servidor\n * decide qué paquete se instala» es una forma peligrosa aunque hoy el servidor\n * sea de fiar.\n */\nconst LATEST_VERSION_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;\nconst DEFAULT_VERSION_CHECK_TIMEOUT_MS = 10000;\n\nexport interface LatestPiRelease {\n\tversion: string;\n\tpackageName?: string;\n\tnote?: string;\n}\n\n/** Include useful errno details hidden behind Node's generic \"fetch failed\" error. */\nexport function formatVersionCheckError(error: unknown): string {\n\tconst rootMessage = error instanceof Error && error.message ? error.message : String(error);\n\tconst cause = error instanceof Error ? error.cause : undefined;\n\tconst causes = cause instanceof AggregateError ? cause.errors : cause === undefined ? [] : [cause];\n\tconst codes = causes\n\t\t.map((value) =>\n\t\t\ttypeof value === \"object\" && value !== null && \"code\" in value && typeof value.code === \"string\"\n\t\t\t\t? value.code\n\t\t\t\t: undefined,\n\t\t)\n\t\t.filter((code): code is string => code !== undefined);\n\n\tif (codes.length > 0) return `${rootMessage} (${[...new Set(codes)].join(\", \")})`;\n\tconst causeMessage = causes.find(\n\t\t(value): value is Error => value instanceof Error && Boolean(value.message),\n\t)?.message;\n\treturn causeMessage ? `${rootMessage} (cause: ${causeMessage})` : rootMessage;\n}\n\nexport function comparePackageVersions(leftVersion: string, rightVersion: string): number | undefined {\n\tconst left = valid(leftVersion.trim());\n\tconst right = valid(rightVersion.trim());\n\tif (!left || !right) {\n\t\treturn undefined;\n\t}\n\treturn compare(left, right);\n}\n\nexport function isNewerPackageVersion(candidateVersion: string, currentVersion: string): boolean {\n\tconst comparison = comparePackageVersions(candidateVersion, currentVersion);\n\tif (comparison !== undefined) {\n\t\treturn comparison > 0;\n\t}\n\treturn candidateVersion.trim() !== currentVersion.trim();\n}\n\nexport async function getLatestPiRelease(\n\tcurrentVersion: string,\n\toptions: { timeoutMs?: number; retry?: boolean } = {},\n): Promise<LatestPiRelease | undefined> {\n\tif (process.env.PI_OFFLINE) return undefined;\n\n\tconst response = await fetchWithRetry(\n\t\tLATEST_VERSION_URL,\n\t\t{\n\t\t\theaders: {\n\t\t\t\t\"User-Agent\": getPiUserAgent(currentVersion),\n\t\t\t\taccept: \"application/json\",\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tmaxRetries: options.retry ? 2 : 0,\n\t\t\ttimeoutMs: options.timeoutMs ?? DEFAULT_VERSION_CHECK_TIMEOUT_MS,\n\t\t},\n\t);\n\tif (!response.ok) return undefined;\n\n\tconst data = (await response.json()) as {\n\t\tpackageName?: unknown;\n\t\tversion?: unknown;\n\t\tnote?: unknown;\n\t};\n\tif (typeof data.version !== \"string\" || !data.version.trim()) {\n\t\treturn undefined;\n\t}\n\tconst packageName =\n\t\ttypeof data.packageName === \"string\" && data.packageName.trim() ? data.packageName.trim() : undefined;\n\tconst note = typeof data.note === \"string\" && data.note.trim() ? data.note.trim() : undefined;\n\treturn {\n\t\tversion: data.version.trim(),\n\t\tpackageName,\n\t\t...(note ? { note } : {}),\n\t};\n}\n\nexport async function getLatestPiVersion(\n\tcurrentVersion: string,\n\toptions: { timeoutMs?: number; retry?: boolean } = {},\n): Promise<string | undefined> {\n\treturn (await getLatestPiRelease(currentVersion, options))?.version;\n}\n\nexport async function checkForNewPiVersion(currentVersion: string): Promise<LatestPiRelease | undefined> {\n\tif (process.env.PI_SKIP_VERSION_CHECK) return undefined;\n\n\ttry {\n\t\tconst latestRelease = await getLatestPiRelease(currentVersion);\n\t\tif (latestRelease && isNewerPackageVersion(latestRelease.version, currentVersion)) {\n\t\t\treturn latestRelease;\n\t\t}\n\t\treturn undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n"]}
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/utils/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,kBAAkB,GAAG,8BAA8B,YAAY,SAAS,CAAC;AAC/E,MAAM,gCAAgC,GAAG,KAAK,CAAC;AAQ/C,sFAAsF;AACtF,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACrD,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,MAAM,MAAM,GAAG,KAAK,YAAY,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,MAAM;SAClB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACd,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC/F,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,SAAS,CACZ;SACA,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAEvD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,WAAW,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAClF,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAC/B,CAAC,KAAK,EAAkB,EAAE,CAAC,KAAK,YAAY,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAC3E,EAAE,OAAO,CAAC;IACX,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,YAAY,YAAY,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,YAAoB;IAC/E,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,gBAAwB,EAAE,cAAsB;IACrF,MAAM,UAAU,GAAG,sBAAsB,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IAC5E,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,UAAU,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,EAAE,KAAK,cAAc,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,cAAsB,EACtB,UAAmD,EAAE;IAErD,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,cAAc,CACpC,kBAAkB,EAClB;QACC,OAAO,EAAE;YACR,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC;YAC5C,MAAM,EAAE,kBAAkB;SAC1B;KACD,EACD;QACC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,gCAAgC;KAChE,CACD,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAEnC,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIlC,CAAC;IACF,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,WAAW,GAChB,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,OAAO;QACN,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAC5B,WAAW;QACX,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,cAAsB,EACtB,UAAmD,EAAE;IAErD,OAAO,CAAC,MAAM,kBAAkB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,cAAsB;IAChE,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB;QAAE,OAAO,SAAS,CAAC;IAExD,IAAI,CAAC;QACJ,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAC/D,IAAI,aAAa,IAAI,qBAAqB,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;YACnF,OAAO,aAAa,CAAC;QACtB,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/utils/windows-self-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"windows-self-update.d.ts","sourceRoot":"","sources":["../../src/utils/windows-self-update.ts"],"names":[],"mappings":"AAiDA,wBAAgB,kCAAkC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAU3E;AAED,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAsB5E","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { copyFileSync, existsSync, mkdirSync, renameSync, rmSync } from \"node:fs\";\nimport { basename, dirname, join, relative, resolve, toNamespacedPath } from \"node:path\";\nimport { getCwdRelativePath } from \"./paths.ts\";\n\nconst QUARANTINE_DIR_NAME = \".pi-native-quarantine\";\n\nfunction normalizePath(path: string): string {\n\treturn toNamespacedPath(resolve(path));\n}\n\nfunction getQuarantineRoot(packageDir: string): string | undefined {\n\tlet current = resolve(packageDir);\n\twhile (true) {\n\t\tif (basename(current).toLowerCase() === \"node_modules\") {\n\t\t\treturn join(current, QUARANTINE_DIR_NAME);\n\t\t}\n\t\tconst parent = dirname(current);\n\t\tif (parent === current) {\n\t\t\treturn undefined;\n\t\t}\n\t\tcurrent = parent;\n\t}\n}\n\nfunction getLoadedSharedObjectsInPackageDir(packageDir: string): string[] {\n\tconst sharedObjects = (process.report.getReport() as { sharedObjects?: unknown }).sharedObjects;\n\tif (!Array.isArray(sharedObjects)) {\n\t\treturn [];\n\t}\n\n\tconst root = normalizePath(packageDir).toLowerCase();\n\tconst seen = new Set<string>();\n\tconst loadedFiles: string[] = [];\n\tfor (const value of sharedObjects) {\n\t\tif (typeof value !== \"string\") {\n\t\t\tcontinue;\n\t\t}\n\t\tconst filePath = normalizePath(value);\n\t\tconst comparisonPath = filePath.toLowerCase();\n\t\tif (getCwdRelativePath(comparisonPath, root) === undefined || seen.has(comparisonPath)) {\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(comparisonPath);\n\t\tloadedFiles.push(filePath);\n\t}\n\treturn loadedFiles;\n}\n\nexport function cleanupWindowsSelfUpdateQuarantine(packageDir: string): void {\n\tconst quarantineRoot = getQuarantineRoot(packageDir);\n\tif (!quarantineRoot) {\n\t\treturn;\n\t}\n\ttry {\n\t\trmSync(quarantineRoot, { recursive: true, force: true });\n\t} catch {\n\t\t// A previous pi process may still be exiting and holding a native addon.\n\t}\n}\n\nexport function quarantineWindowsNativeDependencies(packageDir: string): void {\n\tconst resolvedPackageDir = normalizePath(packageDir);\n\tconst quarantineRoot = getQuarantineRoot(resolvedPackageDir);\n\tif (!quarantineRoot) {\n\t\treturn;\n\t}\n\n\tconst loadedFiles = getLoadedSharedObjectsInPackageDir(resolvedPackageDir);\n\tif (loadedFiles.length === 0) {\n\t\treturn;\n\t}\n\n\tconst quarantineRunDir = join(quarantineRoot, `${Date.now()}-${process.pid}-${randomUUID()}`);\n\tfor (const loadedFile of loadedFiles) {\n\t\tif (!existsSync(loadedFile)) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst quarantinePath = join(quarantineRunDir, relative(resolvedPackageDir, loadedFile));\n\t\tmkdirSync(dirname(quarantinePath), { recursive: true });\n\t\trenameSync(loadedFile, quarantinePath);\n\t\tcopyFileSync(quarantinePath, loadedFile);\n\t}\n}\n"]}
+{"version":3,"file":"windows-self-update.d.ts","sourceRoot":"","sources":["../../src/utils/windows-self-update.ts"],"names":[],"mappings":"AAiDA,wBAAgB,kCAAkC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAU3E;AAED,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAsB5E"}

package/dist/utils/windows-self-update.js.map

@@ -1 +1 @@
-{"version":3,"file":"windows-self-update.js","sourceRoot":"","sources":["../../src/utils/windows-self-update.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { copyFileSync, existsSync, mkdirSync, renameSync, rmSync } from \"node:fs\";\nimport { basename, dirname, join, relative, resolve, toNamespacedPath } from \"node:path\";\nimport { getCwdRelativePath } from \"./paths.ts\";\n\nconst QUARANTINE_DIR_NAME = \".pi-native-quarantine\";\n\nfunction normalizePath(path: string): string {\n\treturn toNamespacedPath(resolve(path));\n}\n\nfunction getQuarantineRoot(packageDir: string): string | undefined {\n\tlet current = resolve(packageDir);\n\twhile (true) {\n\t\tif (basename(current).toLowerCase() === \"node_modules\") {\n\t\t\treturn join(current, QUARANTINE_DIR_NAME);\n\t\t}\n\t\tconst parent = dirname(current);\n\t\tif (parent === current) {\n\t\t\treturn undefined;\n\t\t}\n\t\tcurrent = parent;\n\t}\n}\n\nfunction getLoadedSharedObjectsInPackageDir(packageDir: string): string[] {\n\tconst sharedObjects = (process.report.getReport() as { sharedObjects?: unknown }).sharedObjects;\n\tif (!Array.isArray(sharedObjects)) {\n\t\treturn [];\n\t}\n\n\tconst root = normalizePath(packageDir).toLowerCase();\n\tconst seen = new Set<string>();\n\tconst loadedFiles: string[] = [];\n\tfor (const value of sharedObjects) {\n\t\tif (typeof value !== \"string\") {\n\t\t\tcontinue;\n\t\t}\n\t\tconst filePath = normalizePath(value);\n\t\tconst comparisonPath = filePath.toLowerCase();\n\t\tif (getCwdRelativePath(comparisonPath, root) === undefined || seen.has(comparisonPath)) {\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(comparisonPath);\n\t\tloadedFiles.push(filePath);\n\t}\n\treturn loadedFiles;\n}\n\nexport function cleanupWindowsSelfUpdateQuarantine(packageDir: string): void {\n\tconst quarantineRoot = getQuarantineRoot(packageDir);\n\tif (!quarantineRoot) {\n\t\treturn;\n\t}\n\ttry {\n\t\trmSync(quarantineRoot, { recursive: true, force: true });\n\t} catch {\n\t\t// A previous pi process may still be exiting and holding a native addon.\n\t}\n}\n\nexport function quarantineWindowsNativeDependencies(packageDir: string): void {\n\tconst resolvedPackageDir = normalizePath(packageDir);\n\tconst quarantineRoot = getQuarantineRoot(resolvedPackageDir);\n\tif (!quarantineRoot) {\n\t\treturn;\n\t}\n\n\tconst loadedFiles = getLoadedSharedObjectsInPackageDir(resolvedPackageDir);\n\tif (loadedFiles.length === 0) {\n\t\treturn;\n\t}\n\n\tconst quarantineRunDir = join(quarantineRoot, `${Date.now()}-${process.pid}-${randomUUID()}`);\n\tfor (const loadedFile of loadedFiles) {\n\t\tif (!existsSync(loadedFile)) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst quarantinePath = join(quarantineRunDir, relative(resolvedPackageDir, loadedFile));\n\t\tmkdirSync(dirname(quarantinePath), { recursive: true });\n\t\trenameSync(loadedFile, quarantinePath);\n\t\tcopyFileSync(quarantinePath, loadedFile);\n\t}\n}\n"]}
+{"version":3,"file":"windows-self-update.js","sourceRoot":"","sources":["../../src/utils/windows-self-update.ts"],"names":[],"mappings":"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"}

package/docs/development-fork.md

@@ -0,0 +1,170 @@
+# Desarrollo del fork: cómo trabajar con este proyecto
+
+Este repositorio es un **fork de pi.dev** (earendil-works/pi) rebrandeado como **ada-cli**. Su regla de diseño principal es mantenerse en lockstep con upstream mediante un sync diario determinista, y esa regla condiciona todo lo demás: dónde vive el código nuevo, cuánto puedes tocar los ficheros de upstream y qué comprueba la build antes de dejarte commitear. Esta página explica cómo trabajar con el proyecto sin leerse el código.
+
+## Requisitos e instalación local
+
+Requiere **Node ≥ 22.19** (y **bun** solo para construir el binario standalone).
+
+```bash
+git clone https://github.com/HOILAB/ada-cli
+cd ada-cli
+npm install        # dependencias del monorepo
+npm run build      # construye todos los paquetes (JS)
+```
+
+Tres formas de ejecutarlo:
+
+- **Binario global desde el monorepo:**
+  ```bash
+  cd packages/coding-agent
+  npm install -g .   # instala el binario ada-cli globalmente
+  ada-cli --version  # → 0.84.2
+  ```
+- **Binario standalone** (no necesita Node en runtime):
+  ```bash
+  cd packages/coding-agent
+  npm run build:binary       # produce dist/ada
+  sudo cp dist/ada /usr/local/bin/ada
+  ```
+- **Desde fuente**, sin instalar nada:
+  ```bash
+  /ruta/al/repo/pi-test.sh   # se puede llamar desde cualquier directorio; respeta tu cwd
+  ```
+
+La app de escritorio (`desktop/`, Tauri 2 + Next.js) usa **el mismo SDK publicado en npm** (`@hoilab/ada-cli@<versión>`), no un tarball ni `file:` — las rutas `file:` rompen la externalización de webpack del build de Next:
+
+```bash
+cd desktop
+npm install
+npm run desktop:dev     # ventana Tauri en desarrollo
+npm run desktop:build   # .app/.dmg/.exe de producción
+```
+
+## Los gates: qué valida `npm run check`
+
+`npm run check` es la puerta de entrada de todo commit. Encadena estas comprobaciones (cada una existe por un fallo concreto que ya ocurrió):
+
+| Gate | Qué valida |
+|---|---|
+| `biome check --write --error-on-warnings .` | Formato y lint; reescribe lo formateable y falla con cualquier warning |
+| `check:pinned-deps` | Todas las dependencias (`dependencies`, `devDependencies`, `optionalDependencies`) usan versión exacta `x.y.z` — sin rangos `^` ni `~` |
+| `check:ts-imports` | Los imports relativos terminan en **`.ts`**, nunca `.js` (el código corre con Node strip-only mode, sin emit) |
+| `tsgo --noEmit` | Tipado de todo el monorepo |
+| `check:browser-smoke` | Humo de navegador sobre paquetes de UI |
+| `check:dist-assets` | Los assets que el paquete publicado promete están en `dist/` |
+| `check:desktop` | Typecheck de la app de escritorio |
+| `check:cargas` | Banco de cargas (`test/banco-cargas.test.ts`): herramientas de edición aplicando cargas reales sin corrupción |
+| `check:bytes-fuente` | No hay bytes de control (p. ej. `\0`) en el `.ts`: un byte NUL convierte el fichero en «binario» para git diff y grep, y el código desaparece de toda búsqueda |
+| `check:arranque` | El CLI arranca perezoso: mide tiempo y número de módulos cargados para responder, y falla si alguien reintroduce un import estático en la cadena `cli.ts -> atajos.ts` |
+| `check:fork-budget` | El presupuesto de hunks upstream no ha crecido (`./scripts/sync-ada.sh --check`; hoy **163/163**) |
+| `check:licencias` | Inventario de licencias + SBOM CycloneDX; una dependencia sin licencia declarada **falla** (fail-closed), no sale en verde |
+| `check:docs` | Documentación e índice inseparables: (1) todo `path` de `docs.json` existe, (2) todo fichero de `docs/` está indexado salvo excepciones declaradas con motivo, (3) los enlaces relativos entre páginas (incluidas anclas) apuntan a algo |
+| `check:imports-runtime` | Todo lo que el código importa en producción está en `dependencies`, no solo en `devDependencies` — en el árbol de trabajo funciona, en una instalación limpia da `ERR_MODULE_NOT_FOUND` |
+| `check:shrinkwrap` / `check:install-lock:coding-agent` | El shrinkwrap e install-lock generados están sincronizados con el lock raíz |
+
+Además, el hook **husky pre-commit** ejecuta antes de cada commit:
+
+1. `check-lockfile-commit.mjs` — bloquea commits que toquen el lockfile salvo `PI_ALLOW_LOCKFILE_CHANGE=1`.
+2. `npm run check` completo.
+3. `check:browser-smoke` extra si tocas `packages/ai/*`, `packages/web-ui/*`, `package.json` o `package-lock.json`.
+4. Re-stagea los ficheros que el formateador haya modificado.
+
+Para correr los gates: `npm run check` desde la raíz (salida completa, sin colas). No commitees con `--no-verify`. Cada gate también tiene su script individual (`npm run check:docs`, etc.) para iterar rápido.
+
+## El presupuesto de hunks upstream (163/163)
+
+El fork se reconstruye en cada sync como `main = upstream/main + delta_hoilab`. Por eso, **cada hunk que llevamos en un fichero que upstream también edita es coste de conflicto que pagamos en cada sync futuro, para siempre**. Esa es la restricción de diseño número uno del fork.
+
+Cómo se mide:
+
+```bash
+./scripts/sync-ada.sh --check    # mide y sale, sin tocar nada (no hace fetch)
+ADA_SYNC_HUNK_BUDGET=170 ./scripts/sync-ada.sh   # subir el techo puntualmente en un sync
+```
+
+Qué cuenta y qué no:
+
+- Se mide **en vivo** contra el merge-base con `upstream/main` (`git diff`), no contra `scripts/ada-rebrand.patch`, que es una referencia regenerada que va por detrás del delta real.
+- Solo cuentan ficheros que **existen en upstream**: los nuestros (`workflows/`, `memory-engine/`, `core/proveedores-registry/`, …) aplican limpios siempre y no pueden conflictuar.
+- Solo cuentan **fuentes** (`packages/*/src/`): docs y tests de upstream que rebrandeamos son conflictos triviales que el propio script reaplica; mezclarlos escondería el número que importa detrás de ruido.
+- El umbral es un **trinquete fijado en la medida real** (163/163), no un número redondo: el siguiente hunk añadido a un fichero de upstream rompe el sync y obliga a una decisión explícita, en vez de colarse.
+
+Cuándo es legítimo subir el presupuesto: cuando el cambio **no puede vivir en un fichero nuestro** (un punto de registro, un gate de sesión, el único punto donde ocurre una escritura) y aporta más de lo que cuesta mantenerlo contra los refactors futuros de upstream. Cuándo no: por comodidad o para desbloquear un sprint. Antes de subirlo, comprobar siempre si el cambio puede reescribirse como fichero adicional — casi siempre puede (un barril de exports, una extensión cargada con `-e`, un early return agrupado). Ejemplos reales de ambas decisiones están documentados en ADA-CLI.md (el cliente LSP se enganchó gratis vía `-e`; el cifrado en reposo de `auth.json` compró su hunk porque llegar tarde al camino de lectura habría dejado al CLI sin autenticación).
+
+Si sube, hay que **documentarlo en el mismo commit**, en dos sitios:
+
+1. El historial de subidas en los comentarios de `scripts/sync-ada.sh` (función `check_sync_budget`): de → a, y por qué este cambio no podía ser aditivo.
+2. La tabla equivalente en `ADA-CLI.md` (raíz).
+
+Un presupuesto sin dueño acaba siempre subido en vez de cuestionado.
+
+Nota importante: parte del crecimiento histórico fue **deriva de upstream**, no decisiones nuestras — upstream refactoriza un fichero que no tocábamos y nuestro delta aflora ahí. El guard mide las dos cosas igual; distingüelas al documentar.
+
+## Reglas del fork
+
+1. **0 hunks por defecto.** Todo cambio nuevo vive primero en ficheros nuestros bajo `packages/coding-agent/src/core/`. Un hunk en un fichero de upstream se compra solo con justificación escrita (ver sección anterior).
+2. **Ownership por directorio para trabajo paralelo.** Cuando varios agentes/persona trabajan a la vez, cada uno es dueño de su directorio bajo `src/core/` y nadie edita el ajeno. Las fronteras cruzadas (wiring en ficheros de upstream, índices compartidos como `docs/docs.json`) se serializan en un único punto.
+3. **Commit seriado único.** El trabajo aterriza en commits convencionales seriados; el sync diario captura el delta commiteado y lo reaplica — lo que no está commiteado no viaja (y el sync con árbol sucio se niega a correr para no destruirlo).
+4. **`erasableSyntaxOnly`** (raíz: `tsconfig.base.json`): el código de `packages/*/src`, `packages/*/test` y ejemplos corre con Node strip-only mode. Prohibido: parameter properties (`constructor(private x)`), `enum`, `namespace`/`module`, `import =`/`export =`, cualquier construcción que necesite emit de JS. Usa campos explícitos con asignación en el constructor.
+5. **Imports relativos con extensión `.ts`** (gate `check:ts-imports`).
+6. **`Record` sobre `Map`/`Set` estáticos**: para tablas declarativas conocidas en tiempo de escritura (catálogos, registros), usa objetos `Record` tipados — dan completitud compile-time y son triviales de inspeccionar; `Map`/`Set` quedan para estado mutable en runtime.
+7. Sin emojis en commits, issues, PRs ni código.
+
+## Convenciones de test
+
+Los tests en `packages/coding-agent/test/` siguen tres reglas duras, nacidas de fallos repetidos:
+
+- **Ambos halves.** Una prueba que solo comprueba una AUSENCIA, o que compara dos estados vacíos, da verde también con el código roto. Toda prueba debe tener su caso positivo y su caso negativo juntos: exige que la marca exista *antes* de comprobar que no se reescribe; comprueba el caso revocado junto al válido.
+- **Tres estados.** Donde el dominio lo pide (aprobaciones, dispositions de seguridad), el test cubre los tres estados del contrato — aprobado, denegado, y pendiente/desconocido — no solo el binario feliz.
+- **Prueba de mutación.** Tras escribir las pruebas, rompe temporalmente el mecanismo (quita el arreglo, invierte la condición), confirma que SUS tests caen, y restaura. Un test que sigue verde con el control roto no mide nada. Es también el procedimiento del checklist de auditoría (docs/COMPLIANCE-AUDIT.md §16) para cualquier control que parezca débil.
+
+Ejecutar tests:
+
+```bash
+cd packages/coding-agent
+./test.sh                          # tests sin LLM (no necesitan API keys)
+npm test                           # todos
+tsx --test test/<fichero>.test.ts  # uno concreto
+```
+
+## Cómo añadir un módulo nuevo
+
+1. **Crea el módulo como fichero(s) propios** bajo `packages/coding-agent/src/core/<tu-modulo>/`. Coste de presupuesto: cero.
+2. **Cabecera docstring obligatoria** explicando POR QUÉ existe, qué problema resuelve, qué NO hace y sus límites declarados. Es la fuente de verdad de la documentación de usuario: quien no lee el código tiene que poder confiar solo en la cabecera. Mira cualquier módulo existente (p. ej. `core/proveedores-registry/index.ts`) como plantilla.
+3. **Test** en `packages/coding-agent/test/` siguiendo las convenciones de arriba (ambos halves + prueba de mutación si guarda un control de seguridad).
+4. **Wiring sin tocar upstream siempre que exista la vía:**
+   - Tools nuevas: expórtalas desde tu módulo y cárgalas como **extensión** con `-e`:
+     ```bash
+     ada-cli -e packages/coding-agent/src/core/lsp/extension.ts ...
+     ```
+     Así funciona hoy el cliente LSP: cuatro tools (`lsp_rename`, `lsp_symbols`, `lsp_definition`, `lsp_references`) dadas de alta con `pi.registerTool` sin gastar un solo hunk. El día que haya margen, migrar a builtin es una línea en `builtInExtensions` y tu fichero no cambia.
+   - Exports públicos nuevos: agrúpalos en un barril propio (patrón `src/ada-publico.ts`) en lugar de dispersar exports por ficheros de upstream.
+5. Si NINGUNA vía gratuita sirve (el enganche debe ocurrir en un punto del ciclo de vida de upstream, antes de que algo ya haya leído estado), entonces — y solo entonces — compra el hunk con su documentación (sección del presupuesto).
+6. **Documenta**: página en `packages/coding-agent/docs/` + entrada en `docs.json`. El gate `check:docs` no te deja commitear una sin la otra.
+
+## Cómo añadir un proveedor
+
+El registro de proveedores es declarativo: `packages/coding-agent/src/core/proveedores-registry/`. Añadir un proveedor es **una entrada en `PROVIDERS`** (en `definiciones.ts`), con completitud comprobada en compile-time:
+
+- familia de API, baseUrl por defecto,
+- modelos con contexto y costes,
+- auth como **referencia a la variable de entorno — nunca el valor**,
+- features soportadas.
+
+De ahí salen gratis el resolver por modelo, el listado y el puente con discovery de runtimes (`resolverPorBaseUrl` resuelve endpoints descubiertos contra la tabla). No toques `resolver.ts` ni `tipos.ts` salvo que el tipo del proveedor no quepa en el esquema existente.
+
+## Commits
+
+Formato convencional, mensaje en español, informativo y conciso:
+
+```
+{feat,fix,docs}[(ai,tui,agent,coding-agent)]: <mensaje>
+```
+
+Reglas:
+
+- Commitea **solo los ficheros que cambiaste tú en esta sesión**: revisa `git status` antes de `git add`. Nunca `git add -A` ni `git add .`, nunca `git reset --hard`, `git checkout .`, `git clean -fd`, `git stash` ni `--no-verify`.
+- El mensaje dice qué incluye el cambio y, si toca un hunk de upstream o sube el presupuesto, por qué no pudo ser aditivo — y actualiza la cifra en `sync-ada.sh` + `ADA-CLI.md` en el mismo commit.
+- Si tu commit toca ficheros citados en `docs/COMPLIANCE-AUDIT.md`, actualiza el mapa en el mismo commit.
+- Sin emojis.

package/docs/docs.json

@@ -145,9 +145,34 @@
         }
       ]
     },
+    {
+      "title": "Módulos del fork",
+      "items": [
+        {
+          "title": "Motor: contexto, colaboración y medición",
+          "path": "modules-motor.md"
+        },
+        {
+          "title": "Seguridad: secretos, cifrado, parches y privacidad",
+          "path": "modules-seguridad.md"
+        },
+        {
+          "title": "Infraestructura: brokers, terminal, GC, perfiles",
+          "path": "modules-infraestructura.md"
+        },
+        {
+          "title": "Producto: marketplace, registry, commits, cleanse",
+          "path": "modules-producto.md"
+        }
+      ]
+    },
     {
       "title": "Development",
       "items": [
+        {
+          "title": "Desarrollo del fork",
+          "path": "development-fork.md"
+        },
         {
           "title": "Development",
           "path": "development.md"

package/docs/modules-infraestructura.md

@@ -0,0 +1,115 @@
+# Infraestructura
+
+Módulos de soporte que hacen que el CLI sobreviva a sesiones largas, procesos concurrentes y equipos: brokers por proyecto, terminal robusta, recolección de basura del almacenamiento, perfiles multi-workspace y un broker de credenciales compartidas.
+
+## Broker de daemons — un daemon vivo como máximo por proyecto
+Evita que dos `ada` en el mismo directorio arranquen daemons duplicados (LSP, watchers) que pelean por puertos y ficheros.
+**Activa**: automático al solicitar un daemon vía `getBroker(projectRoot)`; inspección con `ada ps`.
+**Garantiza**:
+- Segundo proceso reutiliza el daemon del primero (Map en memoria + heartbeat).
+- Un daemon sin latido más de 60 s se considera caducado (`DEFAULT_HEARTBEAT_TTL_MS`).
+- Verificación de pid por `startId` para no matar un pid reciclado.
+- `ada ps` en dos formatos: tabla humana (narrando huérfanos) y JSON para scripts/tests.
+- API sin sockets ni locks de fichero; contratos de `ps`/`reap` estables si se añade persistencia futura.
+**No garantiza**:
+- No persiste entre procesos (si hace falta, sería un journal JSONL encima, sin cambiar los contratos).
+**Código**: `src/core/broker/{broker,ps,index}.ts`
+**Test**: `test/broker-ps.test.ts`
+
+## Terminal robusta — output del agente que no tumba el proceso
+Protege el TUI/host PTY cuando un agente atascado vomita megabytes o repite la misma línea miles de veces.
+**Activa**: automática en el camino de escritura de output (`TerminalRunner`); no requiere flags.
+**Garantiza**:
+- Techo de backlog de 64 MiB con descarte FIFO del frente y marcado `truncado` para avisar «[output truncado — se descartaron X bytes del inicio]»; `excedeLimite()` es O(1).
+- Chunking ConPTY: payloads grandes fragmentados en ventanas de 4 KiB para backpressure por chunk y evitar bloqueos del canal PTY.
+- LoopWatchdog: ventana de 1 KiB hasheada (SHA-256) por chunk; repeticiones idénticas consecutivas disparan `onLoopDetected(hash, count)` y opcionalmente jitter delay para frenar al productor sin perder datos.
+- Los tests ejercitan los tres estados con un stream sintético de 1000 líneas idénticas: ok / truncado / bucle-detectado.
+**No garantiza**:
+- El contenido descartado por FIFO no se recupera (solo se reporta cuánto se perdió).
+**Código**: `src/core/terminal/{backlog-guard,conpty,loop-watchdog,runner}.ts`
+**Test**: `test/terminal-robustez.test.ts`
+
+## GC de almacenamiento — blobs huérfanos, sesiones frías y journals limpios
+Recolección de basura productiva sobre el agentDir: purga blobs no referenciados, gzippea sesiones viejas y reconcilia contadores.
+**Activa**: comando/mantenimiento vía `ejecutarGC(opts)` (patrón builtin `ada gc`; wiring documentado en el módulo).
+**Garantiza**:
+- GC de blobs por referencias: recorre sessions buscando sha256 referenciados y purga entradas no referenciadas tras una gracia (7 días por defecto), incluida la caché de disco `<agentDir>/blobs/<sha256>`.
+- Archivo frío: sesiones > N días sin actividad se comprueban a gzip en `cold/` dejando un tombstone JSON (`_cold`, `_archivedAt`); re-hidratación disponible (`rehidratarSesion`) detectando `_cold`.
+- Reconciliación stats/history: re-cuenta sessions/index.json vs filesystem (número, tamaño total, huérfanas) y reporta divergencias.
+- WAL checkpoint TRUNCATE para SQLite en modo WAL (sessions.db, audit.db); best-effort, no falla si no hay fichero o SQLite.
+- Breaker-lock con creación atómica O_EXCL: evita dos GC concurrentes sobre el mismo agentDir (reintento cada 500 ms hasta agotar intentos).
+**No garantiza**:
+- La re-hidratación depende de que el loader detecte el tombstone `_cold`.
+- WAL es best-effort: con JSONL puro es un no-op documentado.
+**Código**: `src/core/gc/{blobs-gc,archivo-frio,reconciliacion,wal,lock,index}.ts`
+**Test**: `test/gc-almacenamiento.test.ts`
+
+## Perfiles multi-workspace — varios workspaces en una sola sesión
+Permite abrir una sesión con perfil y directorios adicionales resueltos ANTES de cualquier carga de config desde disco (pre-import, 0 hunks).
+**Activa**: flags `--profile <nombre>`, `--alias <nombre>`, `--add-dir <dir>` en la línea de comandos.
+**Garantiza**:
+- Lookahead por argv crudo antes de que el parser principal toque `getAgentDir()`.
+- I/O perezoso: solo lee `~/.ada/profiles/<name>.json` si hay `--profile` explícito y no es `default`.
+- `contextosDeTrabajo(perfil, cwd)` devuelve cwd + add-dirs validados para pasar a AgentSession / resource-loader.
+- `FLAG_TABLE` como fuente única de verdad de qué flags consumen valor, consultada tanto por el pre-parser como por el parser principal (patrón espejo omp cli/flag-tables.ts).
+**No garantiza**:
+- Nada más allá de lo declarado en los perfiles: no valida contenido arbitrario de config.
+**Código**: `src/core/perfiles/{resolver,tipos,index}.ts`
+**Test**: `test/perfiles.test.ts`
+
+## Config viva — settings por ruta y valores `!cmd` que se recuperan
+Config que responde al directorio actual y a fallos transitorios, en vez de congelar resultados muertos para siempre.
+**Activa**: capability `"config-viva"` sobre el registro de capabilities (`loadCapability(CAPABILITY_CONFIG_VIVA)` tras registrar su provider); formato opt-in por clave en settings.
+**Garantiza**:
+- Ámbito por prefijo de ruta (C05): `enabledModels` acepta entradas `{ "pathPrefix": "...", "values": [...] }`. Resolución: primera capa (proyecto antes que global) que responda gana; valor plano gana sobre entradas acotadas de su capa; entre coincidencias gana el prefijo MÁS LARGO; sin coincidencia cae a la capa siguiente. API pura, sin I/O.
+- Caché negativa con TTL (C07): éxito de `!cmd` → caché positiva permanente; fallo (undefined o throw) → caché negativa TTL 30 s por defecto; expirado, la siguiente lectura reintenta. Acaba con el «password manager bloqueado desactiva la clave para siempre».
+- Headers vivos (C07): headers `!cmd` re-resueltos como mucho cada TTL (5 s) para proveedores que rotan tokens; el punto de integración con provider-composer está documentado (requeriría hunk upstream).
+- El provider combina ámbito + caché negativa y expone SourceMeta + estadísticas de caché para contar ejecuciones reales.
+**No garantiza**:
+- Headers vivos NO están cableados en provider-composer hoy (documentado, no integrado).
+**Código**: `src/core/config-viva/{ambito,cache-negativa,headers-vivos,proveedor,index}.ts`
+**Test**: `test/config-viva.test.ts`
+
+## Carga de plugins — import paralelo determinista e invalidación cruzada
+Arranque más rápido con N plugins sin sacrificar el orden observable de registro, y recarga coherente cuando cambia un plugin.
+**Activa**: automático al cargar extensiones a través de este importador (el loader upstream no se toca); invalidación vía `invalidarRaiz(raiz)`.
+**Garantiza**:
+- Todos los imports se disparan en paralelo pero los resultados se resuelven EN EL ORDEN DE LA LISTA (el registro es determinista pase lo que pase con el I/O; «última registra gana» sigue siendo predecible).
+- Errores aislados: un plugin que falla al importar no tumba a los demás; cada error se reporta junto a su ruta.
+- Memoización por ruta: recargar con las mismas rutas reusa lo ya cargado; solo se importan los nuevos o los fallados.
+- Invalidación cruzada: registro `raíz → invalidadores`; `invalidarRaiz` ejecuta los invalidadores de esa raíz, vacía sus entradas y purga la caché global de fábricas (`clearExtensionCache`). Sobre-invalidar es seguro (una caché vacía solo fuerza re-import).
+- Importador inyectable (en producción `jiti.import`); la purga fina de módulos es un gancho configurable — si nadie registra purga, los invalidadores registrados se ejecutan igualmente.
+**No garantiza**:
+- Purga por raíz del loader upstream: no existe sin tocar `extensions/loader.ts`; la purga disponible es global.
+**Código**: `src/core/carga-plugins/{paralelo,invalidacion,index}.ts`
+**Test**: `test/carga-plugins.test.ts`
+
+## Kit higiene — código de terceros que nunca tumba el host
+Contención de daños para hooks, providers y extensiones de terceros.
+**Activa**: envolviendo llamadas a código de terceros con las utilidades del kit (`withHostGuard`, `ManagedTimers`, `raceHandlerWithTimeout`).
+**Garantiza**:
+- `withHostGuard`: una Promise de terceros nunca propaga throw al host — clasifica `error.hostGuard=true`, loggea y retorna undefined; no deja promesas colgando si el host muere.
+- `ManagedTimers`: set de timeouts/intervalos registrados con `disposeAll()` para cerrar sin dejar timers huérfanos; handles unref para no bloquear el exit del host.
+- `raceHandlerWithTimeout`: compite handler vs timer, cancela al perdedor y cubre los tres estados — éxito a tiempo, timeout→fallback, error→fallback.
+**No garantiza**:
+- No arregla bugs dentro del código de terceros: solo contiene sus efectos.
+**Código**: `src/core/higiene/{withHostGuard,managed-timers,race-handler,index}.ts`
+**Test**: `test/higiene-kit.test.ts`
+
+## Credenciales compartidas — pool con ranking, enfriamiento y broker HTTP
+Un equipo comparte credenciales de proveedor sin que cada clon de token viva en cada disco, con conmutación inteligente ante fallos.
+**Activa**: modo servidor `ada-cli serve --broker` (broker HTTP); pool + ranking usados por el gateway/pool en memoria; reposo aplicado automáticamente al leer/escribir `auth.json`.
+**Garantiza**:
+- Pool por proveedor: un 401 saca la credencial del pool; un 429 NO la saca (la cuenta sigue buena, solo ocupada) — la confusión de ambos es el error que quema cuentas sanas.
+- Pegajosidad por sesión vía `prompt_cache_key`: anclada a una credencial sana mientras dure; moverla «para equilibrar» rompería el caché de prompts y costaría más de lo que ahorra.
+- Ranking por cuota real: descarta enfriadas por rate-limit (huella del registro persistente), prioriza pegajosa disponible, luego menor uso reciente (empate → orden de declaración estable), y degrada al round-robin del pool si no hay datos — no inventa señales.
+- Enfriamiento 429 persistido: sobrevive a reinicios del broker mediante JSON atómico (temporal + rename + fsync) releído en cada arranque; en disco NUNCA hay claves, solo huellas SHA-256.
+- Broker `/v1/credential`: falla cerrado (sin bearer configurado, lanza antes de abrir el socket); comparación de bearer en tiempo constante; todo excepto `/v1/health` exige bearer; cada resolución y reporte de uso queda en el libro de sesión auditable (`core/audit/libro.ts`).
+- Cliente sin token residente: el secreto devuelto NUNCA se asigna a campo de la clase ni a disco — vive como mucho en la pila para una petición.
+- Cifrado en reposo de `<agentDir>/auth.json`: envuelve el backend upstream transformando solo el contenido dentro de la sección crítica del candado existente; clave aleatoria de 256 bits en el llavero del sistema; cabecera literal distingue claro/cifrado (nunca JSON.parse a ciegas); migración transparente en lectura (recifrado en segundo plano fuera del candado) y escritura atómica con copia de seguridad.
+**No garantiza**:
+- El pool vive en memoria: reiniciar el broker olvida bloqueos y pegajosidad (punto de extensión: persistir `estado()` en `iniciar`/`cerrar`).
+- Sin llavero disponible (CI, contenedor, Linux sin secret-service) NO se cifra auth.json — se avisa una vez y se sigue en claro; cifrar con clave en el mismo disco sería ofuscación.
+- El broker no es proxy de peticiones a proveedores: `/v1/credential` sí entrega el secreto al cliente autenticado (lo mínimo para que el cliente llame al proveedor sin tenerlo en su disco).
+**Código**: `src/core/credenciales/{pool,ranking,ratelimit,servidor,cliente,reposo}.ts`
+**Tests**: `test/pool-credenciales.test.ts`, `test/credenciales-ranking.test.ts`, `test/servidor-credenciales.test.ts`, `test/credenciales-reposo.test.ts`

package/docs/modules-motor.md

@@ -0,0 +1,160 @@
+# Módulos del motor: contexto, colaboración y medición
+
+Páginas de referencia de los subsistemas del motor que viven en `packages/coding-agent/src/core/` y no existían en upstream: gestión append-only del contexto, torre de compactación, colaboración E2E con relay cifrado, preview mid-stream de tool calls, banco medido (metaharness) y guardia de streaming.
+
+## AppendOnlyContextManager — contexto inmutable para prompt-cache
+
+Resuelve el coste invisible de reescribir historial: un solo byte distinto en la posición N invalida el prompt-cache de todo lo que va detrás (~40k tokens de re-prefill por turno reescrito).
+
+**Activa**: automático cargando la extensión `ada-cli -e packages/coding-agent/src/core/appendonly/extension.ts`. La decisión AUTO es pura y sin I/O (`appendOnlyAutoPara(baseUrl, modelo)`): se activa para deepseek (KV-cache prefix reuse documentado), baseUrl en loopback (127.0.0.0/8, localhost, ::1) y redes privadas RFC1918; NO se activa contra proveedores cloud sin garantía de prefix reuse, donde el historial inmutable solo añade restricciones. El criterio del modelo manda sobre el del baseUrl.
+
+**Garantiza**:
+- El historial SOLO crece por append: los turnos ya enviados son inmutables (clonados y congelados en profundidad; cualquier intento de mutación lanza `TypeError`).
+- `prefijoEstable()` congela un hash sha256 del prefijo; los appends posteriores no lo cambian. Solo `compactar(resumen)` lo invalida (añade una entrada resumen al final, nunca borra ni reescribe).
+- `reconstruirDesde(journal)` rehidrata el manager desde el JournalTree verificando los hashes almacenados.
+- `integrarConPruning(mgr, guard)` expone la longitud del prefijo protegido como `cachePrefixLen` al guardia de pruning: el prune solo poda en el sufijo activo.
+- Si el proveedor deja de tener prefix reuse o el historial se encoge (cambio de rama), el estado se descarta y empieza un libro nuevo.
+
+**No garantiza**:
+- No transforma mensajes: es contabilidad e inmutabilidad, no un transform del contexto.
+- No aporta nada contra proveedores cloud sin KV-reuse de prefijo estable.
+- No es builtin: requiere cargar la extensión explícitamente.
+
+**Código**: `packages/coding-agent/src/core/appendonly/append-only-context.ts`, `auto.ts`, `extension.ts`, `index.ts`
+
+**Test**: `test/appendonly.test.ts`, `test/appendonly-auto.test.ts`
+
+## Compactación — prune cache-aware, shake y handoff (/handoff /shake /fresh /drop /btw)
+
+Resuelve el crecimiento del contexto sin destruir el prompt-cache por descuido: una torre de tres plantas con reglas conservadoras y deterministas sobre qué se puede tocar.
+
+**Activa**: comandos slash `/shake`, `/drop`, `/fresh`, `/handoff`, `/btw` (extensión inline registrada por defecto desde `loadBuiltinExtensions`). Cada comando ejecuta el MOTOR REAL y devuelve uno de tres estados: «hecho» (ejecutó), «nada» (contexto válido pero nada que hacer), «uso» (falta argumento).
+
+**Garantiza**:
+- **Prune (1ª planta)**: quirúrgico sobre toolResults, solo cuando el sufijo posterior al candidato cabe en la cola barata de re-cache (por defecto 8.000 tokens, ahorro mínimo 200). Sin reloj ni TTL: la guardia rechaza y contabiliza (`rechazadosPorCache`). Copy-on-write: turnos no tocados se devuelven tal cual.
+- **Shake (2ª planta)**: colapso mecánico de turnos antiguos preservando anclas — primer mensaje user (objetivo original), toolResults referenciados por turnos vivos, cola final protegida (4.000 tokens). Los pares toolCall↔toolResult se eliminan juntos: sin referencias colgantes.
+- **Handoff (3ª planta)**: NO reescribe la historia; cierra la sesión y arranca una nueva cuyo único contexto es un resumen determinista SIN LLM (objetivo original + herramientas usadas + cola reciente) más puntero al journal arbolado de origen. `/handoff` y `/fresh` persisten bajo `<agentDir>/handoff/`.
+- **/btw**: registra notas laterales sin interrumpir; viajan con la próxima operación de contexto a la sesión nueva y se listan con `/btw` sin argumento.
+
+**No garantiza**:
+- El resumen del handoff es mecánico, no semántico: no hay LLM que sintetice.
+- Shake reescribe la historia antigua en bloque: asume que la caché se reconstruye; no respeta el prefijo ya cacheado (para eso está prune).
+- Los eventos evicted del anillo de replay y los turnos colapsados no son recuperables desde el contexto (el journal de origen sí conserva la historia completa).
+
+**Código**: `packages/coding-agent/src/core/compactacion/` (`prune.ts`, `shake.ts`, `handoff.ts`, `comandos.ts`, `extension.ts`, `tipos.ts`)
+
+**Test**: `test/compactacion.test.ts`
+
+## Colaboración — sesión E2E local, kernels persistentes y bucle autoresearch
+
+Resuelve tres huecos de trabajo iterativo: dos agentes escribiendo al mismo journal sin pisarse, estado vivo entre ejecuciones de código, y experimentación con protocolo auditable keep/discard.
+
+**Activa**: programático (clases importables); no hay comando ni extensión de usuario todavía.
+
+**Garantiza**:
+- **SesionColaborativa**: cada agente tiene su instancia apuntando al mismo fichero JSONL; ids con prefijo de agente + sufijo aleatorio nunca colisionan entre procesos ni tras reinicios. `sincronizar()` fusiona por UNIÓN de ids (nunca last-writer-wins): la fusión no pierde entradas de ningún lado; republicación atómica (temp + fsync + rename). Dos ramas hermanas bajo el mismo padre son válidas por construcción — «sin pisarse» no necesita locks.
+- **KernelJs / PoolKernels**: un contexto `node:vm` persiste entre celdas (`let`, `var` y globales sobreviven; cada celda devuelve su última expresión). Una celda fallida NO mata el kernel. El pool registra el kernel como daemon del proyecto en el broker existente (un kernel por proyecto+lenguaje; los tres estados del broker —activo/caducado/huérfano— son los del kernel, inspeccionables vía `ps`).
+- **Bucle autoresearch**: hipótesis → ejecutor INYECTABLE (los tests corren sin gastar llamadas) → parseo de líneas `METRIC nombre=valor` → registro en el journal arbolado → keep/discard sobre la métrica principal. Keep deja la leaf como punto de partida; discard hace fork hacia atrás al último resultado conservado. El journal ES la evidencia auditable.
+
+**No garantiza**:
+- SesionColaborativa no incluye relay ni cifrado: eso lo aporta el rele AG8 (siguiente sección); esta clase es la unidad que sincroniza.
+- Kernels: solo JS en proceso (`LenguajeKernel = "js"`); Py/Rb/Jl esperan subprocess runner. TTL de kernel de 60 s sin latido.
+- Autoresearch: si la salida no trae la métrica principal, no hay valor con el que decidir.
+
+**Código**: `packages/coding-agent/src/core/colaboracion/` (`sesion-colaborativa.ts`, `kernels.ts`, `autoresearch.ts`)
+
+**Test**: `test/colaboracion.test.ts`
+
+## Rele — relay SSE cifrado con secuencia y replay (colaboración E2E)
+
+Resuelve la transmisión en vivo de eventos de sesión a N suscriptores con confidencialidad real: un proceso local escucha SOLO en loopback y retransmite cada evento sellado (scrypt + AES-256-GCM, la primitiva de `share/cifrado.ts`, sin dependencias nuevas).
+
+**Activa**: programático — `ReleServidor` (servidor) y `suscribirse()` (cliente); usado como streamProxy de la colaboración CO1.
+
+**Garantiza**:
+- Token de sala de 256 bits que NUNCA viaja en argv, URLs ni logs: va en la cabecera `x-rele-token` y es TAMBIÉN la clave de sellado. Quien no lo tiene ve ruido autenticado, nada más. Comparación del token en tiempo constante.
+- Todo evento cruza la red como ciphertext autenticado; el cliente entrega eventos ya descifrados por su iterador asíncrono.
+- Secuencia monotónica por sala + anillo de replay (200 eventos): estados de sala «activa», «sin-suscriptores» (los eventos quedan en el anillo) y «cerrada» (los suscriptores terminan limpio con 410).
+- Reconexión con backoff exponencial acotado: el cliente declara `x-rele-desde-seq` y DEDUPLICA por seq (at-least-once → exactly-once).
+- 401 (token erróneo) aborta SIN reintentos; 410 (sala cerrada) termina el iterador normalmente.
+
+**No garantiza**:
+- Eventos evicted del anillo (más allá de los 200 últimos) NO se re-entregan tras un corte largo.
+- El relay es tonto: no interpreta ni persiste eventos; solo sella, numera y reenvía.
+- Escucha solo en loopback: no es un servicio multi-máquina expuesto.
+
+**Código**: `packages/coding-agent/src/core/colaboracion/rele/` (`rele-servidor.ts`, `suscriptor.ts`)
+
+**Test**: `test/rele-stream.test.ts`
+
+## TTSR preview — vista previa mid-stream de argumentos de tools
+
+Resuelve la espera ciega mientras el modelo escribe el JSON de una tool call: un observador puede ver qué lleva escrito en cada delta, sin tocar el contrato actual ni el transcript final.
+
+**Activa**: automática cargando la extensión `ada-cli -e packages/coding-agent/src/core/ttsr/index.ts` (se engancha a los eventos `toolcall_start/delta/end` vía la API pública de extensiones).
+
+**Garantiza**:
+- Captura incremental por `toolCallId`: cada delta se AÑADE, nunca se reescribe.
+- Parse parcial tolerante: un JSON cortado a la mitad devuelve lo entendible (`{ ok, valor, completo }`); jamás lanza.
+- Render recortado a líneas completas: el corte se hace en la última línea nueva, jamás se enseña media línea que cambiaría por debajo del usuario. Viewport por defecto de 24 líneas.
+- Exactly-once: cada prefijo visible se emite UNA vez por toolCallId; pedir preview sin datos nuevos devuelve `undefined`.
+- Solo lectura: el transcript final queda intacto hasta que `toolcall_end` entrega la tool_call completa.
+
+**No garantiza**:
+- Lo mostrado es un prefijo parcial: puede cambiar antes del `end`; no es compromiso del modelo.
+- Vive fuera del transcript: no altera el historial ni sustituye la tool_call final.
+
+**Código**: `packages/coding-agent/src/core/ttsr/` (`captura.ts`, `preview.ts`, `index.ts`)
+
+**Test**: `test/ttsr-preview.test.ts`
+
+## Metaharness — banco medido con percentiles y cold/warm
+
+Resuelve la autocertificación: mide con datos el comportamiento del agente contra un proveedor — aciertos Y coste (round trips, tokens, latencia TTFT/decode) — y compara dos configuraciones con números, no impresiones.
+
+**Activa**: CLI en segundo plano (una corrida tarda minutos y cuesta dinero):
+
+```
+node scripts/metaharness.mjs cargas [--salida f.json]
+node scripts/metaharness.mjs run --entrada casos.json --modelo proveedor/modelo \
+     [--salida f.json] [--timeout ms] [--casos N] [--si] [--cold-warm]
+node scripts/metaharness.mjs comparar ejecucionA.json ejecucionB.json
+```
+
+**Garantiza**:
+- Informe JSON con las métricas del banco (tres estados, ficheros temporales, normalización byte a byte — delegadas en `core/banco`, sin recopiarlas) más eficiencia por caso: vueltas, tokens entrada/salida, latencia, TTFT y decode con percentiles **p50/p95** (interpolación lineal estándar «linear», sin dependencias).
+- `--cold-warm`: dos pasadas con la MISMA instancia de ejecutor; reporta `deltaTokensPrefill` y si la caché mejoró.
+- Anti-autoengaño: si la pasada warm NO reduce el prefill, el informe lleva un AVISO explícito (o el proveedor no sirve el prompt desde caché, o el prefijo no es idéntico entre pasadas).
+- Banco de cargas mal formadas como línea base: motor puro, sin red, sin coste.
+- Ejecutor inyectable: los tests prueban que el harness MIDE con ejecutores deterministas, sin gastar una sola llamada real; el ejecutor real es el que cuesta dinero.
+- Confirmación interactiva antes de correr contra red salvo `--si`.
+
+**No garantiza**:
+- Corridas reales cuestan dinero y minutos: está pensado para segundo plano.
+- Percentiles con muestra vacía devuelven 0 y casos con timeout/error se excluyen de latencia: no inventan medidas.
+- La comparación (`comparar`) compara informes ya producidos; no orquesta corridas.
+
+**Código**: `packages/coding-agent/src/core/metaharness/` (`cli.ts`, `ejecutar.ts`, `comparar.ts`, `tipos.ts`) vía `scripts/metaharness.mjs`
+
+**Test**: `test/metaharness.test.ts`, `test/metaharness-percentiles.test.ts`
+
+## Stream-guard — vigía universal de streams con replay buffer
+
+Resuelve los streams que se cuelgan para siempre: hoy solo el WS de Codex tiene idle-timeout; cualquier otro stream (SSE del rele, MCP, subprocesos largos) puede quedar colgado indefinidamente. `vigilarStream` envuelve CUALQUIER AsyncIterator.
+
+**Activa**: programático — envolver la fuente con `vigilarStream(iterador, opciones)`; combinar con `bufferReplay` para reconexión sin pérdida.
+
+**Garantiza**:
+- **Idle**: sin eventos durante `idleTimeoutMs` (default 30.000 ms) lanza `ErrorStreamIdle` (error clasificado, no genérico), avisa por `onIdle` y cierra la fuente. Reintentar es decisión del consumidor (con replay si usó bufferReplay).
+- **In-flight**: contador global con techo (default 64 streams simultáneos, ajustable); al superarlo la primera lectura rechaza con `ErrorSaturado` hasta que alguno baje.
+- **Limpieza**: el cupo se libera y la fuente se cierra en TODAS las salidas (fin normal, error del consumidor, error del origen, idle).
+- **BufferReplay**: guarda los últimos N eventos numerados y re-entrega desde una secuencia dada con semántica Last-Event-ID de SSE (inclusive-exclusive). El rele AG8 lo usa servidor-side para atender `x-rele-desde-seq`. Seq inválida → `RangeError`; `maxEventos` inválido → error en constructor.
+
+**No garantiza**:
+- No reintenta por ti: clasifica el fallo y deja la política de reintento al consumidor.
+- Los eventos evicted del anillo de replay NO se re-entregan tras un corte mayor que el búfer.
+- El techo de streams es global del proceso: saturar un tipo de stream afecta a todos los vigilados.
+
+**Código**: `packages/coding-agent/src/core/stream-guard/` (`guardia.ts`, `replay.ts`)
+
+**Test**: `test/stream-guard.test.ts`