trackops 2.0.3 → 2.0.4

package/lib/server.js

@@ -7,13 +7,13 @@ const os = require("os");
 const path = require("path");
 const { spawn, spawnSync } = require("child_process");
 
-const config = require("./config");
-const control = require("./control");
-const env = require("./env");
-const registry = require("./registry");
-const { t, setLocale, getMessages } = require("./i18n");
-const { normalizeLocale } = require("./locale");
-const runtimeState = require("./runtime-state");
+const config = require("./config");
+const control = require("./control");
+const env = require("./env");
+const registry = require("./registry");
+const { t, setLocale, getMessages } = require("./i18n");
+const { normalizeLocale } = require("./locale");
+const runtimeState = require("./runtime-state");
 
 const UI_DIR = path.join(__dirname, "..", "ui");
 const DEFAULT_HOST = "127.0.0.1";
@@ -42,19 +42,19 @@ function sendJson(res, statusCode, payload) {
   res.end(JSON.stringify(payload));
 }
 
-function sendText(res, statusCode, message) {
-  res.writeHead(statusCode, { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-store" });
-  res.end(message);
-}
-
-function readJsonFileSafe(filePath) {
-  if (!filePath || !fs.existsSync(filePath)) return null;
-  try {
-    return JSON.parse(fs.readFileSync(filePath, "utf8"));
-  } catch (_error) {
-    return null;
-  }
-}
+function sendText(res, statusCode, message) {
+  res.writeHead(statusCode, { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-store" });
+  res.end(message);
+}
+
+function readJsonFileSafe(filePath) {
+  if (!filePath || !fs.existsSync(filePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch (_error) {
+    return null;
+  }
+}
 
 function parseBody(req) {
   return new Promise((resolve, reject) => {
@@ -365,61 +365,61 @@ function loadControlApi(projectRoot) {
   return control.forProject(projectRoot);
 }
 
-function buildI18nPayload(controlState) {
+function buildI18nPayload(controlState) {
   const phases = config.getPhases(controlState);
   const locale = config.getLocale(controlState);
   const statusLabels = {};
   for (const s of control.STATUS_ORDER) {
     statusLabels[s] = control.statusLabel(s);
   }
-  return { locale, statusLabels, phases, messages: getMessages(locale) };
-}
-
-function buildOperaState(projectRoot, controlState) {
-  const context = config.ensureContext(projectRoot);
-  const operaBootstrap = require("./opera-bootstrap");
-  const bootstrapState =
-    controlState.meta?.opera?.bootstrap ||
-    operaBootstrap.detectLegacyBootstrap(context, controlState) ||
-    operaBootstrap.createAwaitingBootstrapState(context);
-  const qualityReport = readJsonFileSafe(path.join(context.paths.bootstrapDir, "quality-report.json"));
-  const localeDoctor = runtimeState.doctorLocale(controlState.meta?.locale || null);
-
-  return {
-    installed: config.isOperaInstalled(controlState),
-    version: controlState.meta?.opera?.version || null,
-    model: controlState.meta?.opera?.model || null,
-    stableTag: controlState.meta?.opera?.stableTag || null,
-    contractVersion: controlState.meta?.opera?.contractVersion || null,
-    contractReadiness: controlState.meta?.opera?.contractReadiness || qualityReport?.contractReadiness || "hypothesis",
-    qualityStatus: controlState.meta?.opera?.qualityStatus || qualityReport?.status || null,
-    qualityReport,
-    legacyStatus: controlState.meta?.opera?.legacyStatus || bootstrapState?.status || "supported",
-    localeSource: localeDoctor.source,
-    bootstrap: bootstrapState,
-    contractFile: context.paths.contractFile,
-    policyFile: context.paths.autonomyPolicyFile,
-  };
-}
-
-function getStatePayload(projectRef) {
-  const project = resolveProjectEntry(projectRef);
-  const api = loadControlApi(project.root);
-  const controlState = api.loadControl();
-  const runtime = api.refreshRepoRuntime({ quiet: true });
-  const envState = env.auditEnvironment(project.root, controlState);
-  const operaState = buildOperaState(project.root, controlState);
-
-  return {
-    project,
-    control: controlState,
-    derived: api.derive(controlState),
-    runtime,
-    env: envState,
-    opera: operaState,
-    docsDirty: api.getDocDrift(controlState),
-    i18n: buildI18nPayload(controlState),
-    generatedAt: new Date().toISOString(),
+  return { locale, statusLabels, phases, messages: getMessages(locale) };
+}
+
+function buildOperaState(projectRoot, controlState) {
+  const context = config.ensureContext(projectRoot);
+  const operaBootstrap = require("./opera-bootstrap");
+  const bootstrapState =
+    controlState.meta?.opera?.bootstrap ||
+    operaBootstrap.detectLegacyBootstrap(context, controlState) ||
+    operaBootstrap.createAwaitingBootstrapState(context);
+  const qualityReport = readJsonFileSafe(path.join(context.paths.bootstrapDir, "quality-report.json"));
+  const localeDoctor = runtimeState.doctorLocale(controlState.meta?.locale || null);
+
+  return {
+    installed: config.isOperaInstalled(controlState),
+    version: controlState.meta?.opera?.version || null,
+    model: controlState.meta?.opera?.model || null,
+    stableTag: controlState.meta?.opera?.stableTag || null,
+    contractVersion: controlState.meta?.opera?.contractVersion || null,
+    contractReadiness: controlState.meta?.opera?.contractReadiness || qualityReport?.contractReadiness || "hypothesis",
+    qualityStatus: controlState.meta?.opera?.qualityStatus || qualityReport?.status || null,
+    qualityReport,
+    legacyStatus: controlState.meta?.opera?.legacyStatus || bootstrapState?.status || "supported",
+    localeSource: localeDoctor.source,
+    bootstrap: bootstrapState,
+    contractFile: context.paths.contractFile,
+    policyFile: context.paths.autonomyPolicyFile,
+  };
+}
+
+function getStatePayload(projectRef) {
+  const project = resolveProjectEntry(projectRef);
+  const api = loadControlApi(project.root);
+  const controlState = api.loadControl();
+  const runtime = api.refreshRepoRuntime({ quiet: true });
+  const envState = env.auditEnvironment(project.root, controlState);
+  const operaState = buildOperaState(project.root, controlState);
+
+  return {
+    project,
+    control: controlState,
+    derived: api.derive(controlState),
+    runtime,
+    env: envState,
+    opera: operaState,
+    docsDirty: api.getDocDrift(controlState),
+    i18n: buildI18nPayload(controlState),
+    generatedAt: new Date().toISOString(),
   };
 }
 
@@ -650,29 +650,50 @@ async function handleApi(req, res, url) {
       if (!body.root) { sendJson(res, 400, { ok: false, error: "Project path required." }); return; }
       try {
         const initMod = require("./init");
-        const result = initMod.initProject(body.root, { locale: body.locale || null });
-        if (body.withOpera) {
-          const opera = require("./opera");
-          await opera.install(result.root, {
-            locale: body.locale || null,
-            bootstrap: body.bootstrap !== false,
-            interactive: false,
-            answers: body.bootstrapAnswers || {},
-            bootstrapMode: body.bootstrapMode || "auto",
-            technicalLevel: body.technicalLevel || null,
-            projectState: body.projectState || null,
-            docsState: body.docsState || null,
-            decisionOwnership: body.decisionOwnership || null,
-          });
-        }
-        const project = registry.registerProject(result.root);
-        sendJson(res, 201, { ok: true, project, projects: registry.listProjects() });
+        const result = initMod.initProject(body.root, { locale: body.locale || null });
+        if (body.withOpera) {
+          const opera = require("./opera");
+          await opera.install(result.root, {
+            locale: body.locale || null,
+            bootstrap: body.bootstrap !== false,
+            interactive: false,
+            answers: body.bootstrapAnswers || {},
+            bootstrapMode: body.bootstrapMode || "auto",
+            technicalLevel: body.technicalLevel || null,
+            projectState: body.projectState || null,
+            docsState: body.docsState || null,
+            decisionOwnership: body.decisionOwnership || null,
+          });
+        }
+        const project = registry.registerProject(result.root);
+        sendJson(res, 201, { ok: true, project, projects: registry.listProjects() });
       } catch (err) {
         sendJson(res, 500, { ok: false, error: err.message });
       }
       return;
     }
 
+    /* POST /api/projects/purge-unavailable — Elimina todos los proyectos no disponibles */
+    if (req.method === "POST" && url.pathname === "/api/projects/purge-unavailable") {
+      try {
+        const { removed } = registry.purgeUnavailable();
+        sendJson(res, 200, { ok: true, removed, projects: registry.listProjects() });
+      } catch (err) {
+        sendJson(res, 500, { ok: false, error: err.message });
+      }
+      return;
+    }
+
+    /* DELETE /api/projects/:id — Desregistrar proyecto */
+    if (req.method === "DELETE" && /^\/api\/projects\/[^/]+$/.test(url.pathname)) {
+      const projectId = decodeURIComponent(url.pathname.split("/").pop());
+      const exists = registry.loadRegistry().projects.find((p) => p.id === projectId);
+      if (!exists) { sendJson(res, 404, { ok: false, error: "Project not found." }); return; }
+      registry.unregisterById(projectId);
+      sendJson(res, 200, { ok: true, projects: registry.listProjects() });
+      return;
+    }
+
     if (req.method === "GET" && url.pathname === "/api/state") {
       sendJson(res, 200, getStatePayload(url.searchParams.get("project")));
       return;
@@ -720,7 +741,7 @@ async function handleApi(req, res, url) {
       return;
     }
 
-    if (req.method === "POST" && url.pathname === "/api/sync") {
+    if (req.method === "POST" && url.pathname === "/api/sync") {
       const body = await parseBody(req);
       const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
       const api = loadControlApi(project.root);
@@ -728,116 +749,200 @@ async function handleApi(req, res, url) {
       api.syncDocs(controlState);
       api.refreshRepoRuntime({ quiet: true });
       sendJson(res, 200, { ok: true, state: getStatePayload(project.id) });
-      return;
-    }
-
-    if (req.method === "GET" && url.pathname === "/api/env") {
-      const project = resolveProjectEntry(url.searchParams.get("project"));
-      const api = loadControlApi(project.root);
-      const controlState = api.loadControl();
-      sendJson(res, 200, env.auditEnvironment(project.root, controlState));
-      return;
-    }
-
-    if (req.method === "POST" && url.pathname === "/api/env/sync") {
-      const body = await parseBody(req);
-      const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
-      const api = loadControlApi(project.root);
-      const controlState = api.loadControl();
-      const result = env.syncEnvironment(project.root, controlState);
-      api.syncDocs(api.loadControl());
-      api.refreshRepoRuntime({ quiet: true });
-      sendJson(res, 200, result);
-      return;
-    }
-
-    if (req.method === "GET" && url.pathname === "/api/opera/bootstrap") {
-      const project = resolveProjectEntry(url.searchParams.get("project"));
-      const api = loadControlApi(project.root);
-      const controlState = api.loadControl();
-      const operaState = buildOperaState(project.root, controlState);
-      const bootstrap = operaState.bootstrap;
-      sendJson(res, 200, {
-        ok: true,
-        mode: bootstrap.mode || null,
-        status: bootstrap.status || "awaiting_intake",
-        technicalLevel: bootstrap.technicalLevel || null,
-        projectState: bootstrap.projectState || null,
-        documentationState: bootstrap.documentationState || null,
-        decisionOwnership: bootstrap.decisionOwnership || null,
-        handoffFiles: bootstrap.handoffFiles || null,
-        intakeFiles: bootstrap.intakeFiles || null,
-        reviewFiles: bootstrap.reviewFiles || null,
-        contractVersion: operaState.contractVersion,
-        contractReadiness: operaState.contractReadiness,
-        legacyStatus: operaState.legacyStatus,
-        qualityReport: operaState.qualityReport,
-      });
-      return;
-    }
-
-    if (req.method === "GET" && url.pathname === "/api/opera/handoff") {
-      const project = resolveProjectEntry(url.searchParams.get("project"));
-      const context = config.ensureContext(project.root);
-      const operaBootstrap = require("./opera-bootstrap");
-      const files = operaBootstrap.bootstrapFilePaths(context);
-      let handoffJson = null;
-      if (fs.existsSync(files.json)) {
-        try {
-          handoffJson = JSON.parse(fs.readFileSync(files.json, "utf8"));
-        } catch (_error) {
-          handoffJson = null;
-        }
-      }
-      sendJson(res, 200, {
-        ok: true,
-        markdownFile: files.markdown,
-        jsonFile: files.json,
-        openQuestionsFile: files.openQuestions,
-        qualityReportFile: files.qualityReport,
-        markdown: fs.existsSync(files.markdown) ? fs.readFileSync(files.markdown, "utf8") : "",
-        json: handoffJson,
-        openQuestions: fs.existsSync(files.openQuestions) ? fs.readFileSync(files.openQuestions, "utf8") : "",
-        qualityReport: readJsonFileSafe(files.qualityReport),
-      });
-      return;
-    }
-
-    if (req.method === "POST" && url.pathname === "/api/opera/bootstrap/intake") {
-      const body = await parseBody(req);
-      const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
-      const opera = require("./opera");
-      const profile = await opera.runBootstrap(project.root, {
-        interactive: false,
-        bootstrapMode: body.bootstrapMode || "auto",
-        technicalLevel: body.technicalLevel || null,
-        projectState: body.projectState || null,
-        docsState: body.documentationState || body.docsState || null,
-        decisionOwnership: body.decisionOwnership || null,
-        answers: body.answers || {},
-      });
-      sendJson(res, 200, { ok: true, profile, state: getStatePayload(project.id) });
-      return;
-    }
-
-    if (req.method === "GET" && url.pathname === "/api/opera/status") {
-      const project = resolveProjectEntry(url.searchParams.get("project"));
-      const api = loadControlApi(project.root);
-      const controlState = api.loadControl();
-      sendJson(res, 200, { ok: true, ...buildOperaState(project.root, controlState) });
-      return;
-    }
-
-    if (req.method === "POST" && url.pathname === "/api/opera/bootstrap/resume") {
-      const body = await parseBody(req);
-      const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
-      const opera = require("./opera");
-      const profile = await opera.runBootstrap(project.root, { interactive: false, resume: true });
-      sendJson(res, 200, { ok: true, profile, state: getStatePayload(project.id) });
-      return;
-    }
-
-    if (req.method === "POST" && url.pathname === "/api/commands") {
+      return;
+    }
+
+    /* GET /api/analytics — Datos analíticos computados */
+    if (req.method === "GET" && url.pathname === "/api/analytics") {
+      const project = resolveProjectEntry(url.searchParams.get("project"));
+      const api = loadControlApi(project.root);
+      const controlState = api.loadControl();
+      const range = url.searchParams.get("range") || "30";
+      const tasks = controlState.tasks || [];
+      const now = new Date();
+
+      // Rango de fechas
+      const rangeDays = range === "all" ? 365 : parseInt(range, 10) || 30;
+      const startDate = new Date(now);
+      startDate.setDate(startDate.getDate() - rangeDays);
+      const startISO = startDate.toISOString().slice(0, 10);
+
+      // Velocity: completions por semana
+      const velocity = [];
+      const completions = tasks.flatMap(t =>
+        (t.history || []).filter(h => h.action === "complete" && h.at >= startISO).map(h => h.at.slice(0, 10))
+      );
+      const weekMap = new Map();
+      completions.forEach(dateStr => {
+        const d = new Date(dateStr);
+        const year = d.getFullYear();
+        const jan1 = new Date(year, 0, 1);
+        const weekNum = Math.ceil(((d - jan1) / 86400000 + jan1.getDay() + 1) / 7);
+        const weekKey = `${year}-W${String(weekNum).padStart(2, "0")}`;
+        weekMap.set(weekKey, (weekMap.get(weekKey) || 0) + 1);
+      });
+      for (const [week, completed] of [...weekMap.entries()].sort()) {
+        velocity.push({ week, completed });
+      }
+
+      // Burndown: remaining required tasks over time
+      const burndown = [];
+      const requiredTasks = tasks.filter(t => t.required !== false);
+      for (let d = new Date(startDate); d <= now; d.setDate(d.getDate() + 1)) {
+        const dateStr = d.toISOString().slice(0, 10);
+        const remaining = requiredTasks.filter(t => {
+          const completeEntry = (t.history || []).find(h => h.action === "complete");
+          return !completeEntry || completeEntry.at.slice(0, 10) > dateStr;
+        }).length;
+        burndown.push({ date: dateStr, remaining });
+      }
+
+      // Heatmap: activity counts per day
+      const heatmap = [];
+      const dayMap = new Map();
+      tasks.forEach(t => {
+        (t.history || []).forEach(h => {
+          if (h.at >= startISO) {
+            const day = h.at.slice(0, 10);
+            dayMap.set(day, (dayMap.get(day) || 0) + 1);
+          }
+        });
+      });
+      for (const [date, count] of [...dayMap.entries()].sort()) {
+        heatmap.push({ date, count });
+      }
+
+      // Average cycle time (start → complete)
+      let totalCycle = 0, cycleCount = 0;
+      tasks.forEach(t => {
+        const startEntry = (t.history || []).find(h => h.action === "start" || h.action === "create");
+        const completeEntry = (t.history || []).find(h => h.action === "complete");
+        if (startEntry && completeEntry) {
+          totalCycle += new Date(completeEntry.at) - new Date(startEntry.at);
+          cycleCount++;
+        }
+      });
+      const avgCycleTime = cycleCount > 0 ? Math.round(totalCycle / cycleCount) : 0;
+
+      sendJson(res, 200, {
+        ok: true,
+        velocity,
+        burndown: burndown.filter((_, i) => i % Math.max(1, Math.floor(burndown.length / 60)) === 0), // Max ~60 points
+        heatmap,
+        avgCycleTime,
+        range,
+        generatedAt: now.toISOString(),
+      });
+      return;
+    }
+
+    if (req.method === "GET" && url.pathname === "/api/env") {
+      const project = resolveProjectEntry(url.searchParams.get("project"));
+      const api = loadControlApi(project.root);
+      const controlState = api.loadControl();
+      sendJson(res, 200, env.auditEnvironment(project.root, controlState));
+      return;
+    }
+
+    if (req.method === "POST" && url.pathname === "/api/env/sync") {
+      const body = await parseBody(req);
+      const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
+      const api = loadControlApi(project.root);
+      const controlState = api.loadControl();
+      const result = env.syncEnvironment(project.root, controlState);
+      api.syncDocs(api.loadControl());
+      api.refreshRepoRuntime({ quiet: true });
+      sendJson(res, 200, result);
+      return;
+    }
+
+    if (req.method === "GET" && url.pathname === "/api/opera/bootstrap") {
+      const project = resolveProjectEntry(url.searchParams.get("project"));
+      const api = loadControlApi(project.root);
+      const controlState = api.loadControl();
+      const operaState = buildOperaState(project.root, controlState);
+      const bootstrap = operaState.bootstrap;
+      sendJson(res, 200, {
+        ok: true,
+        mode: bootstrap.mode || null,
+        status: bootstrap.status || "awaiting_intake",
+        technicalLevel: bootstrap.technicalLevel || null,
+        projectState: bootstrap.projectState || null,
+        documentationState: bootstrap.documentationState || null,
+        decisionOwnership: bootstrap.decisionOwnership || null,
+        handoffFiles: bootstrap.handoffFiles || null,
+        intakeFiles: bootstrap.intakeFiles || null,
+        reviewFiles: bootstrap.reviewFiles || null,
+        contractVersion: operaState.contractVersion,
+        contractReadiness: operaState.contractReadiness,
+        legacyStatus: operaState.legacyStatus,
+        qualityReport: operaState.qualityReport,
+      });
+      return;
+    }
+
+    if (req.method === "GET" && url.pathname === "/api/opera/handoff") {
+      const project = resolveProjectEntry(url.searchParams.get("project"));
+      const context = config.ensureContext(project.root);
+      const operaBootstrap = require("./opera-bootstrap");
+      const files = operaBootstrap.bootstrapFilePaths(context);
+      let handoffJson = null;
+      if (fs.existsSync(files.json)) {
+        try {
+          handoffJson = JSON.parse(fs.readFileSync(files.json, "utf8"));
+        } catch (_error) {
+          handoffJson = null;
+        }
+      }
+      sendJson(res, 200, {
+        ok: true,
+        markdownFile: files.markdown,
+        jsonFile: files.json,
+        openQuestionsFile: files.openQuestions,
+        qualityReportFile: files.qualityReport,
+        markdown: fs.existsSync(files.markdown) ? fs.readFileSync(files.markdown, "utf8") : "",
+        json: handoffJson,
+        openQuestions: fs.existsSync(files.openQuestions) ? fs.readFileSync(files.openQuestions, "utf8") : "",
+        qualityReport: readJsonFileSafe(files.qualityReport),
+      });
+      return;
+    }
+
+    if (req.method === "POST" && url.pathname === "/api/opera/bootstrap/intake") {
+      const body = await parseBody(req);
+      const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
+      const opera = require("./opera");
+      const profile = await opera.runBootstrap(project.root, {
+        interactive: false,
+        bootstrapMode: body.bootstrapMode || "auto",
+        technicalLevel: body.technicalLevel || null,
+        projectState: body.projectState || null,
+        docsState: body.documentationState || body.docsState || null,
+        decisionOwnership: body.decisionOwnership || null,
+        answers: body.answers || {},
+      });
+      sendJson(res, 200, { ok: true, profile, state: getStatePayload(project.id) });
+      return;
+    }
+
+    if (req.method === "GET" && url.pathname === "/api/opera/status") {
+      const project = resolveProjectEntry(url.searchParams.get("project"));
+      const api = loadControlApi(project.root);
+      const controlState = api.loadControl();
+      sendJson(res, 200, { ok: true, ...buildOperaState(project.root, controlState) });
+      return;
+    }
+
+    if (req.method === "POST" && url.pathname === "/api/opera/bootstrap/resume") {
+      const body = await parseBody(req);
+      const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
+      const opera = require("./opera");
+      const profile = await opera.runBootstrap(project.root, { interactive: false, resume: true });
+      sendJson(res, 200, { ok: true, profile, state: getStatePayload(project.id) });
+      return;
+    }
+
+    if (req.method === "POST" && url.pathname === "/api/commands") {
       const body = await parseBody(req);
       const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
       const commandText = String(body.command || "").trim();
@@ -921,10 +1026,10 @@ async function handleApi(req, res, url) {
 
     /* ── Skills Hub ── */
 
-    if (req.method === "GET" && url.pathname === "/api/skills/local") {
-      const project = resolveProjectEntry(url.searchParams.get("project"));
-      const context = config.ensureContext(project.root);
-      const skillsDir = fs.existsSync(context.paths.skillsDir) ? context.paths.skillsDir : null;
+    if (req.method === "GET" && url.pathname === "/api/skills/local") {
+      const project = resolveProjectEntry(url.searchParams.get("project"));
+      const context = config.ensureContext(project.root);
+      const skillsDir = fs.existsSync(context.paths.skillsDir) ? context.paths.skillsDir : null;
       
       const skills = [];
       if (skillsDir) {
@@ -961,7 +1066,7 @@ async function handleApi(req, res, url) {
       const catalog = [
         { id: "changelog-updater", title: "Changelog Updater", description: "Mantiene automatizado el CHANGELOG basado en commits.", url: "https://skills.sh/changelog-updater.md" },
         { id: "commiter", title: "Git Commiter", description: "Genera mensajes de commit strictos siguiendo Conventional Commits y Emojis.", url: "https://skills.sh/commiter.md" },
-        { id: "project-starter-skill", title: "Project Starter", description: "Skill para discovery y estructuracion inicial guiada con TrackOps y OPERA.", url: "https://skills.sh/project-starter.md" },
+        { id: "project-starter-skill", title: "Project Starter", description: "Skill para discovery y estructuracion inicial guiada con TrackOps y OPERA.", url: "https://skills.sh/project-starter.md" },
         { id: "tdd-master", title: "TDD Master", description: "Fuerza el ciclo Red-Green-Refactor en las implementaciones.", url: "https://skills.sh/tdd-master.md" },
         { id: "e2e-tester", title: "E2E Tester", description: "Plantillas y comandos para frameworks de Test End-to-End.", url: "https://skills.sh/e2e-tester.md" }
       ];
@@ -972,16 +1077,16 @@ async function handleApi(req, res, url) {
       return;
     }
 
-    if (req.method === "POST" && url.pathname === "/api/skills/install") {
+    if (req.method === "POST" && url.pathname === "/api/skills/install") {
       const body = await parseBody(req);
       const project = resolveProjectEntry(body.projectId || body.project || url.searchParams.get("project"));
       const skillId = body.skillId;
       
       if (!skillId) { sendJson(res, 400, { ok: false, error: "Missing skillId parameter" }); return; }
 
-      const context = config.ensureContext(project.root);
-      const skillsDir = context.paths.skillsDir;
-      if (!fs.existsSync(skillsDir)) fs.mkdirSync(skillsDir, { recursive: true });
+      const context = config.ensureContext(project.root);
+      const skillsDir = context.paths.skillsDir;
+      if (!fs.existsSync(skillsDir)) fs.mkdirSync(skillsDir, { recursive: true });
       
       const targetSkillDir = path.join(skillsDir, skillId);
       if (!fs.existsSync(targetSkillDir)) fs.mkdirSync(targetSkillDir, { recursive: true });
@@ -1012,7 +1117,7 @@ Instructions para el agente relativas a esta skill...
 /* ── server start ── */
 
 async function run(args = []) {
-  startupRoot = config.resolveProjectRoot() || process.cwd();
+  startupRoot = config.resolveProjectRoot() || process.cwd();
 
   try {
     const ctrl = config.loadControl(startupRoot);

package/locales/en.json

@@ -229,6 +229,7 @@
 
   "bootstrap.header": "OPERA bootstrap",
   "bootstrap.subtitle": "Classify the user and the project first. TrackOps will decide whether to continue in the terminal or route discovery to the agent.",
+  "bootstrap.instructions": "Answer with low|medium|high|senior, or press Enter to keep the default value when you are unsure.",
   "bootstrap.question.technicalLevel": "User technical level",
   "bootstrap.question.projectState": "Current project state",
   "bootstrap.question.docsState": "Available documentation",
@@ -250,6 +251,9 @@
   "bootstrap.pending": "OPERA bootstrap saved as pending. Resume with 'trackops opera bootstrap --resume'.",
   "bootstrap.awaitingAgent": "OPERA bootstrap has been routed to the agent. Complete the handoff and resume with 'trackops opera bootstrap --resume'.",
   "bootstrap.handoffFile": "Handoff file",
+  "bootstrap.next.handoff": "Next step: run 'trackops opera handoff --print', paste the context into your agent, and come back when ops/bootstrap/intake.json and ops/bootstrap/spec-dossier.md exist.",
+  "bootstrap.next.directCompleted": "Next step: review 'trackops opera status' and continue normal work with 'trackops next' and 'trackops sync'.",
+  "bootstrap.next.directPending": "Next step: complete the missing data and resume with 'trackops opera bootstrap --resume'.",
   "bootstrap.infer.envSourceHint": "Environment files detected",
   "bootstrap.noneDefined": "Not defined yet.",
   "bootstrap.pendingValue": "Pending definition.",

package/locales/es.json

@@ -229,6 +229,7 @@
 
   "bootstrap.header": "Bootstrap OPERA",
   "bootstrap.subtitle": "Primero clasifica al usuario y el estado del proyecto. TrackOps decidira si continuar por terminal o derivar el arranque al agente.",
+  "bootstrap.instructions": "Responde con low|medium|high|senior o con sus equivalentes bajo|medio|alto. Si no sabes una respuesta, pulsa Enter para aceptar el valor por defecto.",
   "bootstrap.question.technicalLevel": "Nivel tecnico del usuario",
   "bootstrap.question.projectState": "Estado actual del proyecto",
   "bootstrap.question.docsState": "Documentacion disponible",
@@ -250,6 +251,9 @@
   "bootstrap.pending": "Bootstrap OPERA guardado como pendiente. Reanuda con 'trackops opera bootstrap --resume'.",
   "bootstrap.awaitingAgent": "Bootstrap OPERA derivado al agente. Completa el handoff y reanuda con 'trackops opera bootstrap --resume'.",
   "bootstrap.handoffFile": "Archivo de handoff",
+  "bootstrap.next.handoff": "Siguiente paso: ejecuta 'trackops opera handoff --print', pega el contexto en tu agente y vuelve cuando existan ops/bootstrap/intake.json y ops/bootstrap/spec-dossier.md.",
+  "bootstrap.next.directCompleted": "Siguiente paso: revisa 'trackops opera status' y continua el trabajo normal con 'trackops next' y 'trackops sync'.",
+  "bootstrap.next.directPending": "Siguiente paso: completa los datos pendientes y reanuda con 'trackops opera bootstrap --resume'.",
   "bootstrap.infer.envSourceHint": "Detectados archivos de entorno",
   "bootstrap.noneDefined": "Aun no definido.",
   "bootstrap.pendingValue": "Pendiente de definir.",