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

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);
}
}