Stand-in import of elffuss/code

One parentless commit with only the files that the open seed tasks touch and the modules they import.
The full squashed import (SPEC 8.6) is a later step: this tree is not the cutoff tree.

T2T-StandIn-Source-Commit: 43f95b7333efe73aeaebf806023f17bffea27aba
This commit is contained in:
2026-10-01 00:00:00 +00:00
commit 42a4a9a67c
47 changed files with 13789 additions and 0 deletions

125
web/js/tools/clone.js Normal file
View File

@@ -0,0 +1,125 @@
// Descarga un repo PÚBLICO (GitHub/Bitbucket) en una carpeta real elegida por
// el usuario, para abrirlo como proyecto sin necesitar git instalado. Mismo
// patrón que skills.js: árbol de Git vía API + contenidos por raw CDN (sin
// tope de la API, solo la llamada al árbol cuenta contra el límite 60/h).
//
// RESUMIBLE por diseño: listRepo() (el árbol) y downloadFiles() (los ficheros)
// están separados a propósito — quien llama (main.js) persiste la lista y qué
// rutas ya se descargaron, así una descarga interrumpida (recarga, pestaña
// cerrada) continúa donde se quedó en vez de volver a empezar.
const MAX_FILES = 4000;
const MAX_FILE_BYTES = 4 * 1024 * 1024; // ficheros más grandes se saltan (binarios enormes)
const CONCURRENCY = 10;
export function parseRepoUrl(raw) {
const url = String(raw || '').trim().replace(/\.git$/, '').replace(/\/+$/, '');
let m = url.match(/^(?:https?:\/\/)?(?:www\.)?github\.com\/([\w.-]+)\/([\w.-]+)(?:\/tree\/([\w./-]+))?/i);
if (m) return { host: 'github', owner: m[1], repo: m[2], branch: m[3] || null };
m = url.match(/^(?:https?:\/\/)?(?:www\.)?bitbucket\.org\/([\w.-]+)\/([\w.-]+)(?:\/src\/([\w./-]+))?/i);
if (m) return { host: 'bitbucket', owner: m[1], repo: m[2], branch: m[3] || null };
throw new Error('URL no reconocida. Usa github.com/usuario/repo o bitbucket.org/usuario/repo');
}
// escribe un fichero (texto o binario) en `root`, creando subcarpetas
async function writeInto(root, path, blob) {
const parts = path.split('/'); const name = parts.pop();
let dir = root;
for (const seg of parts) dir = await dir.getDirectoryHandle(seg, { create: true });
const fh = await dir.getFileHandle(name, { create: true });
const w = await fh.createWritable();
await w.write(blob);
await w.close();
}
// pool de concurrencia simple: corre `items` a través de `worker`, máx N a la vez
async function pool(items, n, worker) {
let i = 0;
const runners = Array.from({ length: Math.min(n, items.length) }, async () => {
while (i < items.length) await worker(items[i++]);
});
await Promise.all(runners);
}
// ── listar (una sola vez, resultado persistible) ─────────────────────────
async function listGithubFiles({ owner, repo, branch }) {
if (!branch) {
const r = await fetch(`https://api.github.com/repos/${owner}/${repo}`);
if (r.status === 403) throw new Error('GitHub limitó las peticiones (60/h sin login). Reintenta en unos minutos.');
if (!r.ok) throw new Error(`Repo no encontrado o privado (HTTP ${r.status})`);
branch = (await r.json()).default_branch || 'main';
}
let tree = null;
for (const b of [branch, 'main', 'master']) {
const r = await fetch(`https://api.github.com/repos/${owner}/${repo}/git/trees/${b}?recursive=1`);
if (r.ok) { tree = (await r.json()).tree || []; branch = b; break; }
if (r.status === 403) throw new Error('GitHub limitó las peticiones (60/h sin login). Reintenta en unos minutos.');
}
if (!tree) throw new Error('No pude leer el árbol del repo');
const blobs = tree.filter(n => n.type === 'blob');
const files = blobs.filter(n => !n.size || n.size <= MAX_FILE_BYTES).slice(0, MAX_FILES).map(n => ({ path: n.path, size: n.size || 0 }));
return { branch, files, skipped: blobs.length - files.length };
}
// Bitbucket no tiene un único endpoint de árbol recursivo: se camina por directorios.
async function bitbucketWalk(owner, repo, branch, path, files) {
if (files.length >= MAX_FILES) return;
let url = `https://api.bitbucket.org/2.0/repositories/${owner}/${repo}/src/${branch}/${path}?pagelen=100`;
while (url && files.length < MAX_FILES) {
const r = await fetch(url);
if (!r.ok) throw new Error(`Bitbucket: HTTP ${r.status} (¿repo privado o rama incorrecta?)`);
const data = await r.json();
for (const e of data.values || []) {
if (files.length >= MAX_FILES) break;
if (e.type === 'commit_directory') await bitbucketWalk(owner, repo, branch, e.path, files);
else if (e.type === 'commit_file' && (!e.size || e.size <= MAX_FILE_BYTES)) files.push({ path: e.path, size: e.size || 0 });
}
url = data.next || null;
}
}
async function listBitbucketFiles({ owner, repo, branch }) {
if (!branch) {
const r = await fetch(`https://api.bitbucket.org/2.0/repositories/${owner}/${repo}`);
if (!r.ok) throw new Error(`Repo no encontrado o privado (HTTP ${r.status})`);
branch = (await r.json()).mainbranch?.name || 'main';
}
const files = [];
await bitbucketWalk(owner, repo, branch, '', files);
return { branch, files, skipped: 0 };
}
// Lista el repo completo UNA vez. Devuelve todo lo necesario para persistir
// el trabajo: { host, owner, repo, branch, files:[{path,size}], skipped }.
export async function listRepo(url) {
const info = parseRepoUrl(url);
const { branch, files, skipped } = info.host === 'github' ? await listGithubFiles(info) : await listBitbucketFiles(info);
if (!files.length) throw new Error('El repo está vacío (o no pude listarlo)');
return { host: info.host, owner: info.owner, repo: info.repo, branch, files, skipped };
}
// Descarga los ficheros de `job.files` que NO estén en `doneSet` (Set de
// rutas). Llama a onFileDone(path) tras cada escritura para que quien invoque
// persista el progreso — así una interrupción se retoma sin re-descargar nada.
export async function downloadFiles(job, targetHandle, doneSet, onProgress, onFileDone) {
const { host, owner, repo, branch, files } = job;
const pending = files.filter(f => !doneSet.has(f.path));
let done = files.length - pending.length;
onProgress?.({ text: `${done}/${files.length}`, done, total: files.length });
await pool(pending, CONCURRENCY, async f => {
onProgress?.({ text: `Descargando ${f.path}…`, done, total: files.length });
const url = host === 'github'
? `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${f.path}`
: `https://api.bitbucket.org/2.0/repositories/${owner}/${repo}/src/${branch}/${f.path}`;
const r = await fetch(url);
if (r.ok) await writeInto(targetHandle, f.path, await r.blob());
done++;
onFileDone?.(f.path);
onProgress?.({ text: `${done}/${files.length}`, done, total: files.length });
});
}
// Conveniencia: listar + descargar todo de una vez (sin resumibilidad; para
// quien no necesite persistir progreso entre sesiones).
export async function cloneToHandle(url, targetHandle, onProgress) {
const job = await listRepo(url);
await downloadFiles(job, targetHandle, new Set(), onProgress);
return { count: job.files.length, skipped: job.skipped };
}

638
web/js/tools/code.js Normal file
View File

@@ -0,0 +1,638 @@
// Herramientas de proyecto: el único mundo que toca Elffuss Code es la
// carpeta de código que el usuario abre con el picker nativo.
import * as db from '../db.js';
let projectHandle = null;
let projectName = '';
let currentFile = null; // ruta abierta en el editor
let onFileWritten = () => {}; // el IDE refresca pestañas/árbol
export function setOnFileWritten(fn) { onFileWritten = fn; }
export function setCurrentFile(path) { currentFile = path; }
export function current() { return { projectName, currentFile }; }
export function handle() { return projectHandle; }
// Lee un archivo de texto dentro de un dir handle por ruta (soporta subdirs).
async function readIn(dir, path) {
const parts = path.split('/'); const name = parts.pop();
for (const p of parts) dir = await dir.getDirectoryHandle(p);
return (await (await dir.getFileHandle(name)).getFile()).text();
}
// Integración git SIN dependencias: parsea el .git directamente (rama + último
// commit). Suficiente para orientar; commitear se le pide al agente/terminal.
export async function gitInfo() {
if (!projectHandle) return { isRepo: false };
let git;
try { git = await projectHandle.getDirectoryHandle('.git'); }
catch { return { isRepo: false }; }
const out = { isRepo: true, branch: '(detached)', lastCommit: null };
try {
const head = (await readIn(git, 'HEAD')).trim();
out.branch = head.match(/ref:\s*refs\/heads\/(.+)/)?.[1] || head.slice(0, 7);
} catch { /* sin HEAD */ }
try {
const last = (await readIn(git, 'logs/HEAD')).trim().split('\n').pop();
const m = last.match(/^\S+ \S+ (.+?) <[^>]*> (\d+)[^\t]*\t(.+)$/);
if (m) out.lastCommit = { author: m[1], when: new Date(+m[2] * 1000), msg: m[3] };
} catch { /* sin logs (repo recién creado) */ }
return out;
}
// Lista plana de archivos (para el command palette). Cacheada por proyecto.
let fileListCache = null;
export function invalidateFileList() { fileListCache = null; }
export async function fileList() {
if (fileListCache) return fileListCache;
if (!projectHandle) return [];
const files = [];
async function walk(dir, prefix, depth) {
if (depth > 8 || files.length > 4000) return;
for await (const e of dir.values()) {
if (IGNORE.has(e.name)) continue;
const p = prefix ? prefix + '/' + e.name : e.name;
if (e.kind === 'directory') await walk(e, p, depth + 1);
else files.push(p);
}
}
await walk(projectHandle, '', 0);
fileListCache = files;
return files;
}
export async function openProject(handle) {
projectHandle = handle;
projectName = handle.name || 'proyecto';
await db.set('kv', 'project', handle).catch(() => {});
return projectName;
}
// Reabrir el último proyecto (el navegador puede exigir un gesto para re-conceder).
export async function restoreProject() {
const h = await db.get('kv', 'project').catch(() => null);
if (!h) return null;
const q = h.queryPermission ? await h.queryPermission({ mode: 'readwrite' }) : 'granted';
if (q === 'granted') {
projectHandle = h;
projectName = h.name || 'proyecto';
return { name: projectName, ready: true };
}
return { name: h.name, ready: false, handle: h };
}
export async function regrant(h) {
if (await h.requestPermission({ mode: 'readwrite' }) !== 'granted')
throw new Error('permiso denegado');
return openProject(h);
}
const IGNORE = new Set(['node_modules', '.git', 'dist', 'build', 'target', '__pycache__', '.next', 'venv', '.venv', '.DS_Store']);
const MAX_READ = 60_000;
// Normaliza rutas del modelo: quita ./ y / iniciales y segmentos '.'
const normalize = path => (path || '').split('/').filter(p => p && p !== '.');
async function dirOf(path, { create = false } = {}) {
if (!projectHandle) throw new Error('No hay proyecto abierto');
const parts = normalize(path);
const name = parts.pop();
let dir = projectHandle;
for (const p of parts) dir = await dir.getDirectoryHandle(p, { create });
return { dir, name };
}
// Buscar archivos por nombre (para sugerir cuando el modelo inventa rutas, o
// para resolver un enlace del chat que solo mencionaba el nombre del fichero).
export async function findByName(basename, limit = 5) {
const hits = [];
let visited = 0;
async function walk(dir, prefix) {
if (hits.length >= limit || visited > 500) return;
for await (const e of dir.values()) {
if (IGNORE.has(e.name)) continue;
visited++;
const p = prefix ? prefix + '/' + e.name : e.name;
if (e.kind === 'directory') await walk(e, p);
else if (e.name.toLowerCase() === basename.toLowerCase()) hits.push(p);
if (hits.length >= limit || visited > 500) return;
}
}
await walk(projectHandle, '');
return hits;
}
// Árbol de texto (para el modelo y el CONTEXTO). Ignora dependencias/binarios.
const TREE_MAX = 800;
export async function tree({ path = '', depth = 3 } = {}) {
if (!projectHandle) throw new Error('No hay proyecto abierto');
let root = projectHandle;
for (const p of normalize(path)) root = await root.getDirectoryHandle(p);
const out = [];
let count = 0, truncated = false;
async function walk(dir, prefix, d) {
if (d > depth || count >= TREE_MAX) return;
const entries = [];
for await (const e of dir.values()) entries.push(e);
entries.sort((a, b) => (a.kind !== b.kind) ? (a.kind === 'directory' ? -1 : 1) : a.name.localeCompare(b.name));
for (const e of entries) {
if (IGNORE.has(e.name)) continue;
if (++count > TREE_MAX) { truncated = true; return; }
out.push(prefix + (e.kind === 'directory' ? '📁 ' : '') + e.name);
if (e.kind === 'directory') { await walk(e, prefix + ' ', d + 1); if (truncated) return; }
}
}
await walk(root, '', 1);
let res = out.join('\n') || '(vacío)';
// Corte con AVISO y guía (como read/search): un «…» pelado se lee como «esto
// es todo» y el modelo trabaja sobre un árbol incompleto sin saberlo.
if (truncated)
res += `\n… árbol recortado (>${TREE_MAX} entradas). Acota con code.tree({path:"subcarpeta"}) o localiza con code.search.`;
return res;
}
const PAGE_SIZE = 100, PAGE_MAX = 500;
// Lectura completa (comportamiento de siempre) O por páginas de líneas — para
// ficheros grandes, o para plantarse justo en el número de línea que dio
// code.search y traer contexto antes/después sin volcar el fichero entero.
// offset: línea 1-based donde empezar (con limit, PAGE_SIZE por defecto)
// around: centra la página en esa línea (offset = around - limit/2)
// Sin offset/limit/around → fichero completo tal cual (no rompe nada que ya
// dependa de leerlo entero, p.ej. code.edit).
export async function read({ path, offset, limit, around } = {}) {
if (!path) throw new Error('Falta path');
let file;
try {
const { dir, name } = await dirOf(path);
file = await (await dir.getFileHandle(name)).getFile();
} catch {
// error que ENSEÑA: el modelo puede auto-corregirse en el siguiente paso
const base = normalize(path).pop() || path;
const hits = await findByName(base).catch(() => []);
throw new Error(`no existe «${path}» en este proyecto.` +
(hits.length ? ` ¿Quizá: ${hits.join(' · ')}?` : '') +
' Consulta el árbol (code.tree) o busca (code.search) antes de leer.');
}
const full = await file.text();
if (offset == null && limit == null && around == null) {
return full.length > MAX_READ ? full.slice(0, MAX_READ) + `\n… (recortado, ${file.size} bytes)` : full;
}
const lines = full.split('\n');
const total = lines.length;
const size = Math.max(1, Math.min(Math.round(limit) || PAGE_SIZE, PAGE_MAX));
const start = around != null
? Math.max(1, Math.round(around) - Math.floor(size / 2))
: Math.max(1, Math.round(offset) || 1);
const startIdx = start - 1;
// Pedir más allá del final devolvía un rango imposible («líneas 999-998 de 6»)
// y CERO contenido: el modelo se quedaba sin nada que hacer. Mejor decírselo.
if (startIdx >= total)
return `${path}: solo tiene ${total} líneas y pediste desde la ${start} — usa offset entre 1 y ${total}.`;
const slice = lines.slice(startIdx, startIdx + size);
const endLine = startIdx + slice.length;
const numbered = slice.map((l, i) => `${start + i}→${l}`).join('\n');
const more = endLine < total ? `\n… quedan líneas ${endLine + 1}-${total} — pide code.read con offset:${endLine + 1} para seguir` : '';
return `${path}: líneas ${start}-${endLine} de ${total}\n${numbered}${more}`;
}
// Aprobación de escritura: si «Auto» está apagado, el IDE pide confirmación
// antes de que la elfa toque archivos (como «Edit automatically» del plugin).
let approveWrite = async () => true;
export function setWriteApprover(fn) { approveWrite = fn; }
// `write` reescribe el fichero ENTERO, así que es la vía por la que se pierde
// código. Medido: tras dos rechazos de la guarda de sintaxis en `edit`, el
// modelo se escapó por aquí y reescribió el fichero. En uno de cuatro líneas da
// igual; en uno de seiscientas, así es como desaparece medio proyecto.
// `_interno` lo pone `edit`, que ya ha comprobado lo suyo sobre el texto exacto.
export async function write({ path, content = '', _interno = false } = {}) {
if (!path) throw new Error('Falta path');
if (!_interno) {
let previo = null;
try { const { dir, name } = await dirOf(path); previo = await (await (await dir.getFileHandle(name)).getFile()).text(); }
catch { /* fichero nuevo: nada que preservar */ }
if (previo !== null) {
const antes = previo.split('\n').length, ahora = content.split('\n').length;
// Un fichero con cuerpo que se queda en menos de la mitad casi nunca es
// intencionado: es el modelo reescribiendo de memoria lo que no recuerda.
if (antes >= 40 && ahora < antes * 0.5) {
anota('truncaria', path, { antes, ahora });
throw new Error(`Eso dejaría ${path} en ${ahora} líneas cuando tiene ${antes}: perderías el resto del fichero. ` +
`Para cambiar una parte usa code.edit con «search» y «replace»; code.write solo para ficheros nuevos o reescrituras completas de verdad.`);
}
revisaSintaxis(path, previo, content);
}
}
if (!await approveWrite(path, content)) return `Cambio en ${path} rechazado por el usuario`;
const { dir, name } = await dirOf(path, { create: true });
const fh = await dir.getFileHandle(name, { create: true });
const w = await fh.createWritable();
await w.write(content);
await w.close();
invalidateFileList();
onFileWritten(path, content);
return `Escrito ${path} (${content.split('\n').length} líneas)`;
}
// Edición PARCIAL (no hace falta reescribir el fichero entero): sustituye
// `search` por `replace`. Primero intenta coincidencia EXACTA (rápida, sin
// ambigüedad); si no la encuentra tal cual —el modelo puede recordar mal un
// espacio o un salto de línea—, cae a un parcheado difuso (diff-match-patch,
// la misma librería que usan herramientas como aider) que localiza el punto
// más parecido dentro del fichero real. Si ni así hay confianza suficiente,
// falla con un mensaje claro para que el agente reintente con más contexto
// — nunca escribe una coincidencia dudosa.
// Telemetría de edición: por qué vía se resolvió cada intento. Sin esto,
// «la edición falla» no es accionable — no sabes si el modelo cita mal, si
// cita ambiguo o si no encuentra el sitio.
export const editStats = { total: 0, exacta: 0, bloque: 0, nucleo: 0, difusa: 0, ambigua: 0, noEncontrado: 0, sinCambio: 0, noExiste: 0, rompeSintaxis: 0, yaAplicado: 0, truncaria: 0, detalle: [] };
export function resetEditStats() {
editStats.total = editStats.exacta = editStats.bloque = editStats.nucleo = editStats.difusa = 0;
editStats.ambigua = editStats.noEncontrado = editStats.sinCambio = editStats.noExiste = editStats.rompeSintaxis = editStats.yaAplicado = editStats.truncaria = 0;
editStats.detalle.length = 0;
}
const anota = (via, path, extra) => { editStats[via]++; editStats.detalle.push({ via, path, ...extra }); };
// read() paginado devuelve «12→código» para que el modelo pueda pedir un
// offset; el efecto secundario es que el modelo copia ESE texto como «search»,
// con el número pegado delante. Entonces la cita no existe en el fichero y la
// edición no puede encajar NUNCA — un fichero que pasa de una página se vuelve
// ineditable. Se los quitamos, pero solo si TODAS las líneas los llevan: así
// una flecha suelta dentro del código de verdad no se toca.
const SIN_NUMEROS = /^[ \t]*\d+→/;
// Exigir que TODAS las líneas lleven número no valía: un modelo pequeño numera
// unas sí y otras no, la limpieza no se disparaba y la cita no podía casar. Con
// mayoría basta, y «\d+→» al principio de línea es lo bastante raro en código
// real como para no llevarse nada por delante. Se mira search y replace por
// separado: si los números se colaran en «replace» acabarían ESCRITOS dentro
// del fichero, que es peor que no editar.
function quitaNumerosDeLinea(txt) {
if (txt == null) return txt;
const lineas = txt.split('\n');
const conCuerpo = lineas.filter(l => l.trim());
if (!conCuerpo.length) return txt;
const numeradas = conCuerpo.filter(l => SIN_NUMEROS.test(l)).length;
return numeradas / conCuerpo.length >= 0.6 ? lineas.map(l => l.replace(SIN_NUMEROS, '')).join('\n') : txt;
}
// Una edición que deja el fichero sintácticamente roto es peor que una que no
// se aplica: el modelo dice «arreglado» y lo que hay es un fichero que ya ni
// carga. Caso real medido: el modelo sustituyó la línea de la firma por una
// función entera CON su llave de cierre, dejando huérfano el cuerpo de antes
// («Illegal return statement»). new Function() solo PARSEA, no ejecuta; para
// que trague un módulo hay que quitarle import/export, que son sintaxis de
// módulo. Solo se rechaza si el fichero estaba BIEN antes: si ya venía roto,
// la edición es justamente lo que viene a arreglarlo.
const ES_JS = /\.(js|mjs|cjs|jsx)$/i;
function seParsea(codigo) {
const sinModulo = codigo
.replace(/^\s*import\s+[^;]*;?\s*$/gm, '')
.replace(/^\s*export\s+default\s+/gm, 'void ')
.replace(/^\s*export\s*\{[^}]*\}\s*;?\s*$/gm, '')
.replace(/^(\s*)export\s+/gm, '$1');
try { new Function(sinModulo); return true; } catch (e) { return e instanceof SyntaxError ? String(e.message) : true; }
}
function revisaSintaxis(path, antes, despues) {
if (!ES_JS.test(path)) return;
if (seParsea(antes) !== true) return; // ya estaba roto: no estorbar
const mal = seParsea(despues);
if (mal !== true) {
anota('rompeSintaxis', path, { error: String(mal).slice(0, 80) });
throw new Error(`Esa edición dejaría ${path} sin poder cargarse (${mal}). ` +
`Suele pasar por cerrar una llave de más: revisa que «replace» encaje con lo que rodea a «search», ` +
`o incluye en «search» el bloque completo que vas a sustituir.`);
}
}
export async function edit({ path, search, replace } = {}) {
editStats.total++;
if (!path) throw new Error('Falta path');
if (search == null || replace == null) throw new Error('Faltan search y replace');
// Cada uno por su cuenta: el modelo puede numerar solo uno de los dos.
search = quitaNumerosDeLinea(search);
replace = quitaNumerosDeLinea(replace);
// Contenido COMPLETO, sin el tope de MAX_READ. edit reescribe el fichero
// entero, así que leer la vista recortada de read() truncaría todo lo que
// hubiese más allá de MAX_READ (bug histórico: editar un fichero >60KB lo
// dejaba en 60KB y metía el marcador «… (recortado)» dentro del código).
let current;
try {
const { dir, name } = await dirOf(path);
current = await (await (await dir.getFileHandle(name)).getFile()).text();
} catch {
anota('noExiste', path, {});
await read({ path }); // relanza el error «que enseña» (sugiere code.tree/search); nunca retorna
throw new Error(`no existe «${path}»`);
}
// Reintentar sobre algo YA hecho era un error igual que no encontrarlo, así
// que el modelo volvía a intentarlo en bucle. Si el resultado ya está y la
// cita ya no, la edición sobra: decirlo como estado y seguir. Se exige el
// «replace» COMPLETO presente y el «search» ausente, para no dar por buena
// una edición que no ocurrió.
if (replace.trim().length >= 8 && current.includes(replace) && !current.includes(search)) {
anota('yaAplicado', path, {});
return `Ese cambio ya está en ${path} — no hace falta editar. Sigue con lo siguiente.`;
}
const first = current.indexOf(search);
if (first !== -1) {
if (current.indexOf(search, first + 1) !== -1) {
anota('ambigua', path, { fase: 'exacta' });
// decir DÓNDE está, igual que en las vías difusas: pedir «más contexto»
// a secas hace que un modelo pequeño cite más largo y peor.
const lineas = [];
for (let i = current.indexOf(search); i !== -1 && lineas.length < 8; i = current.indexOf(search, i + 1))
lineas.push(current.slice(0, i).split('\n').length);
throw new Error(`«search» aparece ${lineas.length} veces en ${path} (líneas ${lineas.join(', ')}). ` +
`Cita un bloque que incluya alguna línea que solo exista en el sitio que quieres cambiar.`);
}
const siguiente = current.slice(0, first) + replace + current.slice(first + search.length);
// La vía difusa ya comprobaba esto abajo; la exacta no. Un search idéntico
// al replace escribía el mismo fichero y devolvía ÉXITO, así que el agente
// daba la tarea por arreglada sin haber cambiado una coma.
if (siguiente === current) {
anota('sinCambio', path, { fase: 'exacta' });
throw new Error(`La edición en ${path} no cambió nada: «search» y «replace» son iguales. Escribe en «replace» el código YA corregido.`);
}
revisaSintaxis(path, current, siguiente);
anota('exacta', path, {});
return write({ path, content: siguiente, _interno: true });
}
// fallback difuso, LOCAL y por líneas (sin depender de esm.sh en tiempo de
// edición — eso rompería la edición sin conexión, justo lo contrario del
// producto). El error típico del modelo al recordar «search» es la sangría o
// los espacios; localizamos el bloque normalizando espacios y, si hace falta,
// por parecido de líneas — y sustituimos ESE bloque, esté donde esté (también
// en lo hondo de un fichero grande).
const norm = s => s.replace(/[ \t]+/g, ' ').trim(); // .trim() se lleva también el \r final
// Partimos guardando el offset de carácter de cada línea: así el bloque se
// sustituye por CORTE EXACTO y todo lo de fuera queda byte a byte igual
// (incluidos sus finales de línea). Con split/join se reescribía el fichero
// entero y un fichero CRLF acababa con finales de línea MEZCLADOS.
const curLines = [], lineStart = [];
for (let i = 0; i <= current.length;) {
const nl = current.indexOf('\n', i);
lineStart.push(i);
if (nl === -1) { curLines.push(current.slice(i)); break; }
curLines.push(current.slice(i, nl)); // puede acabar en \r
i = nl + 1;
}
const crlf = (current.match(/\r\n/g) || []).length;
const eol = crlf && crlf * 2 >= (current.match(/\n/g) || []).length ? '\r\n' : '\n';
const nCur = curLines.map(norm); // normalizamos UNA vez
let seaLines = search.replace(/[\r\n]+$/, '').split(/\r?\n/);
let repLines = replace.split(/\r?\n/);
// Posiciones donde un bloque de líneas encaja (ignorando espacios).
const locate = (nBlock) => {
const at = [];
for (let i = 0; i + nBlock.length <= nCur.length; i++) {
let same = true;
for (let j = 0; j < nBlock.length; j++) if (nCur[i + j] !== nBlock[j]) { same = false; break; }
if (same) { at.push(i); if (at.length > 8) break; }
}
return at;
};
// Pedir «más contexto» a un modelo pequeño produce citas más largas y peores.
// Decirle en qué líneas está le deja elegir con un bloque MÁS corto y único.
const ambiguous = (donde = []) => new Error(
`«search» encaja en ${donde.length || 'varios'} sitios de ${path}` +
(donde.length ? ` (líneas ${donde.map(i => i + 1).join(', ')})` : '') +
`. Cita un bloque que incluya alguna línea que solo exista en el sitio que quieres cambiar.`);
let start = -1, k = seaLines.length;
// 1) el bloque ENTERO, idéntico salvo espacios → tiene que ser ÚNICO
{
const at = locate(seaLines.map(norm));
if (at.length > 1) { anota('ambigua', path, { fase: 'bloque' }); throw ambiguous(at); }
if (at.length === 1) { start = at[0]; anota('bloque', path, {}); }
}
// 2) si no aparece entero, puede ser que el fichero tenga líneas que el modelo
// NO vio (un comentario añadido después, p. ej.) metidas dentro del bloque.
// Como search y replace comparten el contexto sin tocar al principio y al
// final, recortamos esa parte común y buscamos solo el NÚCLEO que cambia: así
// lo que el modelo no vio se queda donde estaba en vez de desaparecer.
if (start === -1) {
let pre = 0, suf = 0;
while (pre < seaLines.length && pre < repLines.length && norm(seaLines[pre]) === norm(repLines[pre])) pre++;
while (suf < seaLines.length - pre && suf < repLines.length - pre &&
norm(seaLines[seaLines.length - 1 - suf]) === norm(repLines[repLines.length - 1 - suf])) suf++;
const core = seaLines.slice(pre, seaLines.length - suf);
if (core.length) {
let at = locate(core.map(norm));
if (at.length > 1) {
// desempate por CONTEXTO: gana el candidato con más líneas del contexto
// recortado alrededor (y solo si gana en solitario).
const ctx = [...seaLines.slice(0, pre), ...seaLines.slice(seaLines.length - suf)].map(norm).filter(Boolean);
const near = i => {
const from = Math.max(0, i - pre - 3), to = Math.min(nCur.length, i + core.length + suf + 3);
const around = nCur.slice(from, to);
return ctx.filter(c => around.includes(c)).length;
};
const scored = at.map(i => ({ i, s: near(i) })).sort((a, b) => b.s - a.s);
if (ctx.length && scored[0].s > scored[1].s) at = [scored[0].i];
}
if (at.length > 1) { anota('ambigua', path, { fase: 'nucleo' }); throw ambiguous(at); }
if (at.length === 1) { start = at[0]; k = core.length; repLines = repLines.slice(pre, repLines.length - suf); anota('nucleo', path, { pre, suf }); }
}
}
// 3) por parecido: la ventana con más líneas coincidentes, exigiendo ≥70% y
// que gane con claridad a la segunda mejor (sin ambigüedad)
let mejorVentana = null;
if (start === -1) {
const nSea = seaLines.map(norm);
let best = -1, bestScore = 0, second = 0;
for (let i = 0; i + k <= nCur.length; i++) {
let hit = 0;
for (let j = 0; j < k; j++) if (nCur[i + j] === nSea[j]) hit++;
const score = hit / k;
if (score > bestScore) { second = bestScore; bestScore = score; best = i; }
else if (score > second) second = score;
}
if (bestScore >= 0.7 && bestScore - second >= 0.2) { start = best; anota('difusa', path, { parecido: +bestScore.toFixed(2) }); }
else if (bestScore > 0) anota('noEncontrado', path, { mejorParecido: +bestScore.toFixed(2), segundo: +second.toFixed(2) });
// Pedirle que RELEA le cuesta un turno entero y a un modelo pequeño le sale
// una cita más larga y peor. Como ya sabemos dónde está lo más parecido,
// se lo damos literal y numerado: puede copiar de ahí en el mismo turno.
if (best >= 0 && bestScore > 0) {
const desde = Math.max(0, best - 2), hasta = Math.min(curLines.length, best + k + 2);
mejorVentana = curLines.slice(desde, hasta)
.map((l, i) => `${desde + i + 1}→${l}`).slice(0, 12).join('\n');
}
}
if (start === -1)
throw new Error(`No encontré en ${path} el bloque que citas. ` +
(mejorVentana ? `Lo más parecido que hay es esto (copia «search» LITERAL de aquí, sin los números):\n${mejorVentana}`
: `Léelo con code.read y copia «search» literal de esas líneas.`));
// Corte exacto del bloque [start, start+k): desde el inicio de su primera
// línea hasta el inicio de la siguiente (es decir, salto de línea incluido).
const cutFrom = lineStart[start];
const hasTrailingNL = start + k < lineStart.length;
const cutTo = hasTrailingNL ? lineStart[start + k] : current.length;
const block = repLines.join(eol) + (hasTrailingNL ? eol : '');
const nextContent = current.slice(0, cutFrom) + block + current.slice(cutTo);
if (nextContent === current) {
anota('sinCambio', path, {});
throw new Error(`La edición en ${path} no cambió nada — revisa «replace».`);
}
revisaSintaxis(path, current, nextContent);
return write({ path, content: nextContent, _interno: true });
}
// grep-lite por el proyecto (texto, con límites para no arrasar). Los topes
// existen por rendimiento, pero si se alcanzan hay que DECÍRSELO al modelo
// (igual que read() avisa «quedan líneas…»); si no, un corte silencioso se lee
// como «no hay más» y el modelo da por cerrada una búsqueda incompleta.
const SEARCH_MAX_FILES = 1500, SEARCH_MAX_HITS = 80, SEARCH_MAX_BYTES = 2_000_000;
// Binarios: NO pueden contener el texto que se busca y leerlos como texto es
// caro. Fuera de esta lista quedan .svg/.json/.md/.csv, que son texto y sí se
// buscan. (Antes el tope de tamaño hacía de filtro accidental de binarios.)
const BINARY_EXT = /\.(png|jpe?g|gif|webp|avif|ico|bmp|tiff?|mp[34]|m4a|wav|ogg|mov|avi|webm|pdf|zip|gz|bz2|xz|tar|7z|rar|woff2?|ttf|eot|otf|wasm|bin|exe|dll|so|dylib|class|jar|pyc|sqlite3?)$/i;
export async function search({ query, ext = '' } = {}) {
if (!query) throw new Error('Falta query');
if (!projectHandle) throw new Error('No hay proyecto abierto');
const results = [];
const skipped = []; // ficheros de texto NO buscados por tamaño
let checked = 0, capped = false;
const q = query.toLowerCase();
async function walk(dir, prefix) {
if (results.length >= SEARCH_MAX_HITS || checked >= SEARCH_MAX_FILES) { capped = true; return; }
for await (const e of dir.values()) {
if (IGNORE.has(e.name)) continue;
const p = prefix ? prefix + '/' + e.name : e.name;
if (e.kind === 'directory') { await walk(e, p); if (capped) return; continue; }
if (ext && !e.name.endsWith(ext)) continue;
if (BINARY_EXT.test(e.name)) continue;
const f = await e.getFile();
// Un fichero grande es justo donde el modelo NO puede leerlo entero, así
// que es el que más falta hace buscar. Se busca hasta SEARCH_MAX_BYTES; y
// lo que quede fuera se DICE (antes: >200KB se saltaba en silencio, y
// «Sin resultados» sonaba a «ese código no existe» siendo mentira).
if (f.size > SEARCH_MAX_BYTES) { skipped.push(p); continue; }
checked++;
const lines = (await f.text()).split('\n');
for (let i = 0; i < lines.length; i++) {
if (lines[i].toLowerCase().includes(q)) {
results.push(`${p}:${i + 1}: ${lines[i].trim().slice(0, 140)}`);
if (results.length >= SEARCH_MAX_HITS) { capped = true; break; }
}
}
if (results.length >= SEARCH_MAX_HITS || checked >= SEARCH_MAX_FILES) { capped = true; return; }
}
}
await walk(projectHandle, '');
// Todo lo que la búsqueda NO ha mirado se cuenta; un resultado incompleto que
// se presenta como completo es peor que no buscar.
const notes = [];
if (capped) notes.push(`búsqueda cortada (${results.length} resultados, ${checked} ficheros revisados) — puede haber más: afina con ext o un término más concreto`);
if (skipped.length) notes.push(`${skipped.length} fichero(s) NO buscados por tamaño (>${SEARCH_MAX_BYTES / 1e6} MB): ${skipped.slice(0, 3).join(', ')}${skipped.length > 3 ? '…' : ''} — mira dentro con code.read`);
const tail = notes.length ? '\n… ' + notes.join('. ') + '.' : '';
if (!results.length)
return `Sin resultados para «${query}»` + (tail || '');
return results.join('\n') + tail;
}
// ── code.run: ejecutar el código y ver qué hace de verdad ───────────────────
//
// Medido con Gemma E4B: arregló un bug DOS veces (cambió la constante Y el
// operador) y dejó un fichero perfectamente válido pero incorrecto, rematando
// con «aplicado correctamente». Ninguna guarda sintáctica puede ver eso: la
// única forma de saberlo es ejecutarlo.
//
// Corre en un Worker de módulo: sin DOM, sin acceso a la página, y se le corta
// el paso por tiempo si se cuelga en un bucle. Los imports relativos se
// resuelven a mano contra el proyecto — sin build, un blob no sabe resolver
// «./otro.js» por su cuenta, y sin esto solo servirían los ficheros sueltos.
const RUN_MS = 4000, RUN_MAX_MODULOS = 40;
async function moduloComoBlob(path, hechos = new Map(), profundidad = 0) {
const clave = normalize(path).join('/');
if (hechos.has(clave)) return hechos.get(clave);
if (hechos.size >= RUN_MAX_MODULOS || profundidad > 12)
throw new Error(`demasiados ficheros encadenados desde ${path}`);
hechos.set(clave, null); // marca de ciclo
const { dir, name } = await dirOf(clave);
let txt = await (await (await dir.getFileHandle(name)).getFile()).text();
// reescribir cada import/export relativo al blob del fichero al que apunta
const relativos = [...txt.matchAll(/(from\s*|import\s*\(\s*)(['"])(\.[^'"]+)\2/g)];
for (const m of relativos) {
const destino = normalize(clave.split('/').slice(0, -1).join('/') + '/' + m[3]).join('/');
let url;
try { url = await moduloComoBlob(destino, hechos, profundidad + 1); }
catch { continue; } // que falle al importar, no aquí
if (url) txt = txt.split(m[0]).join(`${m[1]}${m[2]}${url}${m[2]}`);
}
const url = URL.createObjectURL(new Blob([txt], { type: 'text/javascript' }));
hechos.set(clave, url);
return url;
}
export async function run({ path, expr } = {}) {
if (!path) throw new Error('Falta path');
if (!expr) throw new Error('Falta expr: qué quieres evaluar, p.ej. "m.max([])"');
if (!ES_JS.test(path)) throw new Error(`code.run solo ejecuta JavaScript, y ${path} no lo es`);
if (/^\s*import[\s{]/.test(expr) || /\brequire\s*\(/.test(expr))
throw new Error(`«expr» es solo una EXPRESIÓN, no un programa: el módulo ya está importado. ` +
`Escribe directamente la llamada, p.ej. «miFuncion(1, 2)» o «m.miFuncion(1, 2)».`);
const hechos = new Map();
let url;
try { url = await moduloComoBlob(path, hechos); }
catch (e) { throw new Error(`no pude preparar ${path} para ejecutarlo: ${e.message}`); }
// Los nombres exportados se ATAN como variables sueltas, además de en «m».
// Medido: el modelo escribe «slugify(...)» de forma natural, le saltaba un
// «slugify is not defined», y de ahí concluía que su arreglo estaba mal y se
// ponía a destrozar código que YA funcionaba — le quitó el export y rompió el
// módulo. La herramienta de comprobar le enseñó que lo correcto era incorrecto.
// Y si aun así nombra algo que no existe, el error DICE qué hay exportado, en
// vez de dejarle deducir que el fichero está roto.
const guion = `
self.onmessage = async ({ data }) => {
try {
const m = await import(data.url);
const nombres = Object.keys(m).filter(n => /^[A-Za-z_$][\\w$]*$/.test(n));
const fn = new Function('m', ...nombres, 'return (' + data.expr + ')');
const valor = await fn(m, ...nombres.map(n => m[n]));
let texto;
try { texto = JSON.stringify(valor); } catch { texto = String(valor); }
if (texto === undefined) texto = String(valor);
self.postMessage({ ok: true, tipo: typeof valor, texto });
} catch (e) {
let exporta = [];
try { exporta = Object.keys(await import(data.url)); } catch { /* ni carga */ }
self.postMessage({ ok: false, error: e.message, exporta });
}
};`;
const wUrl = URL.createObjectURL(new Blob([guion], { type: 'text/javascript' }));
const worker = new Worker(wUrl, { type: 'module' });
try {
const r = await new Promise((resolve) => {
// Un bucle infinito en el código del usuario no puede colgar el IDE.
const reloj = setTimeout(() => resolve({ ok: false, error: `no terminó en ${RUN_MS} ms (¿bucle infinito?)` }), RUN_MS);
worker.onmessage = e => { clearTimeout(reloj); resolve(e.data); };
worker.onerror = e => { clearTimeout(reloj); resolve({ ok: false, error: e.message || 'error al cargar el módulo' }); };
worker.postMessage({ url, expr });
});
if (r.ok) return `${expr} → ${r.texto} (${r.tipo})`;
// Un «X is not defined» sin más lleva al modelo a «el fichero está mal».
// Decirle qué exporta de verdad corta esa deducción en seco.
const noDefinido = /(\w+) is not defined/.exec(r.error || '');
const pista = noDefinido && r.exporta?.length
? ` — «${noDefinido[1]}» no está en ${path}, que exporta: ${r.exporta.join(', ')}. Llámalo por su nombre o con m.<nombre>; el fichero NO tiene por qué estar mal.`
: (r.exporta?.length ? ` (${path} exporta: ${r.exporta.join(', ')})` : '');
return `${expr} lanzó: ${r.error}${pista}`;
} finally {
worker.terminate();
URL.revokeObjectURL(wUrl);
for (const u of hechos.values()) if (u) URL.revokeObjectURL(u);
}
}

58
web/js/tools/index.js Normal file
View File

@@ -0,0 +1,58 @@
// Registro de herramientas de Elffuss Code: proyecto abierto + shell + web.
import * as code from './code.js';
import * as shell from '../shell.js';
import * as web from './web.js';
export { code };
// El terminal (UI) se engancha aquí para reflejar lo que ejecuta la elfa.
let onTerminalEcho = () => {};
export function setTerminalEcho(fn) { onTerminalEcho = fn; }
export const TOOLS = {
'code.tree': { desc: 'Ver el árbol de archivos del proyecto', params: { path: 'subcarpeta (opcional)', depth: 'niveles (3)' }, run: a => code.tree(a) },
'code.read': { desc: 'Leer un archivo del proyecto. Sin más parámetros, lo lee ENTERO. Para ficheros grandes, pagina de 100 en 100 líneas con offset (offset:101 = siguiente página tras la primera). Para ir directo a donde dio un resultado de code.search (que ya incluye número de línea), usa around:N — trae ~100 líneas centradas en la línea N, con cada línea numerada (N→contenido) para poder citarla o editarla con precisión', params: { path: 'ruta relativa', offset: 'línea 1-based donde empezar (opcional)', limit: 'líneas a devolver, 100 por defecto (opcional)', around: 'centra la página en esta línea, p.ej. la que dio code.search (opcional)' }, run: a => code.read(a) },
'code.write': { desc: 'Escribir/crear un archivo (contenido COMPLETO; se refleja al instante en el editor). Para cambios PEQUEÑOS en un fichero YA existente, usa mejor code.edit', params: { path: 'ruta', content: 'contenido íntegro' }, run: a => code.write(a) },
'code.edit': { desc: 'Editar PARTE de un fichero existente sin reescribirlo entero: sustituye "search" (copia literal de unas pocas líneas, con contexto suficiente para ser única en el fichero) por "replace". Preferible a code.write para cambios pequeños/medianos — más rápido y sin riesgo de perder el resto del fichero. Si falla (no encuentra el punto con confianza), relee el fichero y reintenta con un search más ajustado', params: { path: 'ruta', search: 'texto exacto a sustituir', replace: 'texto nuevo' }, run: a => code.edit(a) },
'code.run': { desc: 'EJECUTAR una expresión contra un módulo JS del proyecto y ver qué devuelve de verdad. Úsalo SIEMPRE después de arreglar algo, para comprobar que el arreglo funciona antes de darlo por bueno: code.run con path del fichero y expr como "max([])" — las funciones exportadas se llaman por su nombre a secas, sin import ni require (también valen como m.max). Corre aislado y con límite de tiempo', params: { path: 'ruta del .js', expr: 'expresión a evaluar, p.ej. m.suma(2,3)' }, run: a => code.run(a) },
'code.search': { desc: 'Buscar texto en el proyecto (grep)', params: { query: 'texto', ext: 'filtro extensión (opcional)' }, run: a => code.search(a) },
'terminal.run': { desc: 'Ejecutar un comando de shell sobre los ficheros del proyecto (ls, cat, grep, find, mkdir, echo>fichero, git status…). node/npm/python REALES si el usuario tiene un Bridge local conectado (⚙ Ajustes → 🔌 Bridge local); si no está conectado, el propio resultado lo indica', params: { command: 'la línea de comando' }, run: async a => { const out = await shell.runForAgent(a.command || ''); onTerminalEcho(a.command || '', out); return out; } },
'web.search': { desc: 'Buscar en internet (docs, errores, APIs) — devuelve títulos, URLs y fragmentos', params: { query: 'qué buscar' }, run: a => web.search(a) },
'web.fetch': { desc: 'Leer el contenido de texto de una URL (documentación, referencia)', params: { url: 'https://…' }, run: a => web.fetchUrl(a) },
};
export function toolHelp() {
return Object.entries(TOOLS).map(([n, t]) =>
`- ${n}(${Object.keys(t.params).join(', ')}): ${t.desc}`).join('\n');
}
export async function runTool(name, args) {
const tool = TOOLS[name];
if (!tool) throw new Error(`Herramienta desconocida: ${name}`);
return tool.run(args || {});
}
// CONTEXTO AHORA del IDE: proyecto, archivo abierto y árbol resumido.
export async function snapshot() {
const { projectName, currentFile } = code.current();
const parts = [
'Fecha y hora: ' + new Date().toLocaleString(),
'Proyecto abierto: ' + (projectName || 'ninguno'),
'Archivo abierto en el editor: ' + (currentFile || 'ninguno'),
];
try { parts.push('Árbol del proyecto (resumen):\n' + await code.tree({ depth: 2 })); }
catch { /* aún sin proyecto */ }
// GROUNDING: incluye el contenido REAL de los archivos clave (README, config)
// para que el modelo NO alucine sobre el proyecto — el heal no domina las
// herramientas code.* así que le damos el material masticado.
for (const key of ['README.md', 'readme.md', 'package.json', 'pyproject.toml', 'Cargo.toml', 'go.mod']) {
try { const body = await code.read({ path: key }); parts.push(`Contenido REAL de ${key}:\n${body.slice(0, 1400)}`); break; } catch { /* siguiente */ }
}
if (currentFile) {
try {
const body = await code.read({ path: currentFile });
parts.push(`Contenido REAL del archivo abierto ${currentFile}:\n` + body.slice(0, 2000));
} catch { /* borrado */ }
}
return parts.join('\n');
}

52
web/js/tools/web.js Normal file
View File

@@ -0,0 +1,52 @@
// Búsqueda y lectura web para la elfa de Code (docs, errores, APIs). fetch
// directo si el sitio permite CORS; si no, cae al proxy del servidor
// (/proxy?url=… → mismo backend que Elffuss Claw). Sin gate de permisos: un
// agente de código necesita consultar internet de serie.
const MAX = 8000;
function toText(html) {
const doc = new DOMParser().parseFromString(html, 'text/html');
doc.querySelectorAll('script,style,noscript,svg,iframe').forEach(n => n.remove());
return ((doc.body?.innerText || doc.body?.textContent || '').replace(/\n{3,}/g, '\n\n').trim()) || html.slice(0, MAX);
}
async function proxyGet(url) {
let lastErr;
for (const target of [url, '/proxy?url=' + encodeURIComponent(url)]) {
try { const r = await fetch(target); if (!r.ok) throw new Error('HTTP ' + r.status); return await r.text(); }
catch (e) { lastErr = e; }
}
throw lastErr || new Error('sin respuesta');
}
export async function fetchUrl({ url } = {}) {
if (!/^https?:\/\//.test(url || '')) throw new Error('URL inválida (usa https://…)');
const text = toText(await proxyGet(url));
return `[${url}]\n` + (text.length > MAX ? text.slice(0, MAX) + '\n… (recortado)' : text);
}
// Búsqueda REAL en DuckDuckGo. Parseo tolerante: cada resultado es un enlace
// con ?uddg=<url real>. Independiente de clases (robusto a cambios de HTML).
export async function search({ query } = {}) {
if (!query) throw new Error('Falta query');
let html = '';
for (const ep of ['https://html.duckduckgo.com/html/?q=', 'https://lite.duckduckgo.com/lite/?q=']) {
try { html = await proxyGet(ep + encodeURIComponent(query)); if (html.includes('uddg=') || html.includes('result')) break; }
catch { /* siguiente endpoint */ }
}
const doc = new DOMParser().parseFromString(html, 'text/html');
const seen = new Set(), out = [];
for (const a of doc.querySelectorAll('a[href*="uddg="]')) {
const m = a.getAttribute('href').match(/uddg=([^&]+)/);
if (!m) continue;
const href = decodeURIComponent(m[1]);
const title = a.textContent.trim();
if (!title || title.length < 3 || seen.has(href)) continue;
seen.add(href);
const block = a.closest('tr, div, article') || a.parentElement;
const snip = (block?.textContent || '').replace(title, '').replace(/\s+/g, ' ').trim().slice(0, 160);
out.push(`• ${title}\n ${href}${snip ? '\n ' + snip : ''}`);
if (out.length >= 8) break;
}
return out.length ? `Resultados para «${query}»:\n\n` + out.join('\n\n') : `Sin resultados para «${query}».`;
}