karajan-code 4.23.0 → 4.24.0

package/README.md

@@ -59,6 +59,14 @@ kj init && kj env install && kj harden && kj review --install-gate
 git config core.hooksPath .karajan/hooks
 ```
 
+Already installed and just want to work — even with no computing background? One command:
+
+```sh
+kj go
+```
+
+It detects your agent (Claude Code or Codex; asks which one only if you have both), prepares the project silently the first time, opens the board in your browser, and drops you into a conversation that already follows the method. Your agent account and login stay yours — kj never touches credentials.
+
 Requires git and at least one AI agent CLI — two enables cross-AI review; three enables arbitration. The npm route is `npm install -g @karajan-family/code` (published as `karajan-code` before joining the scope; the legacy name still installs the same versions). All install routes (npm, binaries, brew, Python wrapper) in the [install docs](https://karajancode.com/docs/v4/install/).
 
 ## The daily loop

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "4.23.0",
+  "version": "4.24.0",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",

package/packages/hu-board/public/index.html

@@ -53,6 +53,7 @@
     <div class="modal" id="modal-content"></div>
   </div>
 
+  <script src="/utils/maggle-mode.js"></script>
   <script src="/utils/formatters.js"></script>
   <script src="/utils/modals.js"></script>
   <script src="/utils/api.js"></script>

package/packages/hu-board/public/utils/board-view.js

@@ -87,48 +87,49 @@ async function renderBoard() {
 
     // KJC-TSK-0403: 3 canonical lanes. Failed eliminado — HUs con
     // result=fail aparecen en Pending con badge ✗.
+    // Maggle mode (KJC-TSK-0810): plain label first, jargon as tooltip.
     const visibleColumns = [
-      { title: 'Pending', cls: 'pending', rows: columns.pending },
-      { title: 'Running', cls: 'running', rows: columns.running },
-      { title: 'Done', cls: 'done', rows: columns.done },
+      { title: maggleText('column.pending', 'Pending'), cls: 'pending', rows: columns.pending },
+      { title: maggleText('column.running', 'Running'), cls: 'running', rows: columns.running },
+      { title: maggleText('column.done', 'Done'), cls: 'done', rows: columns.done },
     ];
 
     app.innerHTML = `
       <div class="section-header">
-        <span class="section-header__title" title="${selectedProject ? esc(selectedProject) : ''}">Story Board${selectedProject ? ` - ${esc(projectDisplayName)}` : ''}</span>
+        <span class="section-header__title" title="${selectedProject ? esc(selectedProject) : ''}">${maggleText('board.title', 'Story Board')}${selectedProject ? ` - ${esc(projectDisplayName)}` : ''}</span>
         ${selectedProject ? `
           <button class="control-btn project-rename-btn"
                   style="background:transparent;border:none;color:var(--text-muted);cursor:pointer;font-size:0.9rem;padding:2px 6px;"
                   title="Renombrar este proyecto"
                   onclick="event.stopPropagation(); window.renameProjectModal('${esc(selectedProject)}', '${esc(projectDisplayName.replace(/'/g, '&#39;'))}');">✎</button>
         ` : ''}
-        <span class="section-header__count">${stories.length} stories</span>
+        <span class="section-header__count" title="stories">${stories.length} ${maggleText('board.stories', 'stories')}</span>
         ${costSummary ? `<span class="section-header__cost" title="${esc(costSummary.tooltip)}">💵 ${esc(costSummary.label)}</span>` : ''}
         ${cacheSummary ? `<span class="section-header__cache" title="${esc(cacheSummary.tooltip)}">${esc(cacheSummary.label)}</span>` : ''}
         ${isRunning ? `
           <button id="running-badge-btn" class="section-header__badge"
                 style="margin-left:auto;padding:4px 10px;font-size:0.8rem;background:var(--color-yellow,#eab308);color:#000;border-radius:var(--radius-sm);font-weight:600;border:none;cursor:pointer;"
                 title="Abrir el log de la HU en marcha">
-            ⚙ ${runningCount} running…
+            ⚙ ${runningCount} ${maggleText('board.running', 'running')}…
           </button>
           <button id="stop-run-btn" class="control-btn"
                 style="padding:4px 10px;font-size:0.8rem;background:var(--color-red,#ef4444);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer;font-weight:600;"
-                title="Abortar todos los kj run en marcha de este proyecto (SIGTERM con escalado a SIGKILL tras 5s)">
-            ⏹ Stop
+                title="${maggleText('board.stopTitle', 'Abortar todos los kj run en marcha de este proyecto (SIGTERM con escalado a SIGKILL tras 5s)')}">
+            ${maggleText('board.stop', '⏹ Stop')}
           </button>
         ` : ''}
         ${lastOpenedLog ? `
           <button class="control-btn" id="view-log-btn"
                   style="${isRunning ? '' : 'margin-left:auto;'}padding:6px 12px;font-size:0.85rem;background:var(--bg-primary);border:1px solid var(--border);color:var(--text);border-radius:var(--radius-sm);cursor:pointer;"
                   title="Re-open the log of the most recent run/command">
-            📜 View log
+            ${maggleText('board.viewLog', '📜 View log')}
           </button>
         ` : ''}
         ${canRun ? `
           <button class="control-btn" id="run-plan-btn"
                   style="margin-left:auto;padding:6px 14px;font-size:0.9rem;background:var(--color-green);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer;font-weight:600;"
-                  title="Launch kj run --plan over every plan in this project">
-            ▶ Run plan (${awaitingCount} HU${awaitingCount === 1 ? '' : 's'})
+                  title="${maggleText('board.runTitle', 'Launch kj run --plan over every plan in this project')}">
+            ${maggleText('board.run', '▶ Run plan')} (${awaitingCount} ${maggleText('board.story', 'HU')}${awaitingCount === 1 ? '' : 's'})
           </button>
         ` : ''}
       </div>
@@ -138,7 +139,7 @@ async function renderBoard() {
         </div>
       </div>
       <div id="rag-panel" class="rag-panel" style="margin:8px 0;display:flex;gap:8px;align-items:flex-start;flex-wrap:wrap;">
-        <input id="rag-query" type="text" placeholder="🔍 RAG search: ask anything about this project's plans / onboarding / code…"
+        <input id="rag-query" type="text" placeholder="${maggleText('board.ragPlaceholder', "🔍 RAG search: ask anything about this project's plans / onboarding / code…")}"
                style="flex:1;min-width:260px;padding:6px 10px;font-size:0.85rem;background:var(--bg-primary);border:1px solid var(--border);color:var(--text);border-radius:var(--radius-sm);" />
         <select id="rag-scope" style="padding:6px 10px;font-size:0.85rem;background:var(--bg-primary);border:1px solid var(--border);color:var(--text);border-radius:var(--radius-sm);">
           <option value="all">All</option><option value="plans">Plans</option><option value="onboarding">Onboarding</option><option value="code">Code</option>
@@ -305,7 +306,7 @@ function renderKanbanColumn(title, cssClass, stories) {
   return `
     <div class="kanban__column kanban__column--${cssClass}" data-column="${cssClass}"${stories.length === 0 ? ' style="opacity:0.55"' : ''}>
       <div class="kanban__column-header">
-        <span class="kanban__column-title">${title}</span>
+        <span class="kanban__column-title" title="${cssClass}">${title}</span>
         <span class="kanban__column-count" data-column-count>${stories.length}</span>
       </div>
       ${stories.map(renderStoryCard).join('')}

package/packages/hu-board/public/utils/command-launcher.js

@@ -60,10 +60,25 @@ async function showCommandLauncher() {
     },
   };
 
+  // Maggle mode (KJC-TSK-0810 AC2): the frequent action leads in plain
+  // language — one textarea, clear promise of what will happen. The full
+  // technical launcher (file paths, architect, clean) stays one click
+  // away behind "Más opciones…".
+  const maggle = isMaggleMode();
+  let advancedVisible = !maggle;
+  if (maggle) {
+    SCHEMAS.plan.label = maggleText('launcher.planLabel', SCHEMAS.plan.label);
+    SCHEMAS.plan.help = maggleText('launcher.planHelp', SCHEMAS.plan.help);
+    SCHEMAS.plan.simpleFields = [
+      { name: 'task', label: maggleText('launcher.taskLabel', 'Task'), type: 'textarea', rows: 6 },
+    ];
+  }
+
   let active = 'plan';
   const renderForm = () => {
     const s = SCHEMAS[active];
-    const fields = s.fields.map((f) => {
+    const visibleFields = (!advancedVisible && s.simpleFields) ? s.simpleFields : s.fields;
+    const fields = visibleFields.map((f) => {
       const id = `cmd-field-${f.name}`;
       if (f.type === 'textarea') {
         return `
@@ -90,14 +105,14 @@ async function showCommandLauncher() {
 
     dlg.innerHTML = `
       <div style="padding:14px 18px;border-bottom:1px solid var(--border);font-weight:600;display:flex;align-items:center;justify-content:space-between;gap:10px">
-        <span>⚡ Run a Karajan command</span>
+        <span>${esc(maggleText('launcher.title', '⚡ Run a Karajan command'))}</span>
         <button id="cmd-close" type="button" class="control-btn"
                 style="padding:4px 10px;border:1px solid var(--border);background:var(--bg-primary);color:var(--text);border-radius:var(--radius-sm);cursor:pointer">
           ✕
         </button>
       </div>
       <div style="padding:12px 18px;display:flex;gap:8px;border-bottom:1px solid var(--border)">
-        ${Object.entries(SCHEMAS).map(([key, s]) => `
+        ${Object.entries(SCHEMAS).filter(([key]) => advancedVisible || key === 'plan').map(([key, s]) => `
           <button type="button" data-cmd="${key}"
                   style="padding:6px 12px;border:1px solid var(--border);
                          background:${key === active ? 'var(--color-green)' : 'var(--bg-primary)'};
@@ -106,6 +121,13 @@ async function showCommandLauncher() {
             ${esc(s.label)}
           </button>
         `).join('')}
+        ${maggle && !advancedVisible ? `
+          <button type="button" id="cmd-more"
+                  style="margin-left:auto;padding:6px 12px;border:1px solid var(--border);background:var(--bg-primary);color:var(--text-muted);border-radius:var(--radius-sm);cursor:pointer;font-size:0.85rem"
+                  title="Comandos técnicos: kj plan con ficheros, kj architect, kj clean">
+            ${esc(maggleText('launcher.more', 'More…'))}
+          </button>
+        ` : ''}
       </div>
       <form id="cmd-form" onsubmit="return false"
             style="padding:14px 18px;display:flex;flex-direction:column;gap:12px;width:min(640px, 88vw);box-sizing:border-box">
@@ -114,11 +136,11 @@ async function showCommandLauncher() {
         <div style="display:flex;justify-content:flex-end;gap:8px;padding-top:8px;border-top:1px solid var(--border)">
           <button type="button" id="cmd-cancel" class="control-btn"
                   style="padding:6px 14px;border:1px solid var(--border);background:var(--bg-primary);color:var(--text);border-radius:var(--radius-sm);cursor:pointer">
-            Cancel
+            ${esc(maggleText('launcher.cancel', 'Cancel'))}
           </button>
           <button type="button" id="cmd-submit" class="control-btn"
                   style="padding:6px 14px;border:none;background:var(--color-green);color:#fff;border-radius:var(--radius-sm);cursor:pointer;font-weight:600">
-            Run
+            ${esc(maggleText('launcher.submit', 'Run'))}
           </button>
         </div>
       </form>
@@ -127,6 +149,8 @@ async function showCommandLauncher() {
     dlg.querySelectorAll('[data-cmd]').forEach((btn) => {
       btn.addEventListener('click', () => { active = btn.dataset.cmd; renderForm(); });
     });
+    const moreBtn = dlg.querySelector('#cmd-more');
+    if (moreBtn) moreBtn.addEventListener('click', () => { advancedVisible = true; renderForm(); });
     dlg.querySelector('#cmd-close').addEventListener('click', () => dlg.close());
     dlg.querySelector('#cmd-cancel').addEventListener('click', () => dlg.close());
     dlg.querySelector('#cmd-submit').addEventListener('click', () => submitCommand(active));
@@ -146,9 +170,21 @@ async function showCommandLauncher() {
     }
     // plan / architect: at least one of taskFile or task is required.
     if ((command === 'plan' || command === 'architect') && !body.taskFile && !body.task) {
-      await showError('Provide either a SPEC file path or paste the task text.', { title: 'Missing input' });
+      await showError(
+        maggle ? 'Escribe primero qué quieres pedir — con tus palabras vale.' : 'Provide either a SPEC file path or paste the task text.',
+        { title: 'Missing input' }
+      );
       return;
     }
+    // AC2: before launching, the maggle confirms knowing exactly what
+    // will happen — in their language, never a command name alone.
+    if (maggle && command === 'plan') {
+      const ok = await showConfirm(maggleText('launcher.confirm', ''), {
+        title: SCHEMAS.plan.label,
+        okLabel: maggleText('launcher.submit', 'Run'),
+      });
+      if (!ok) return;
+    }
     if (command === 'clean' && body.nuke) {
       const ok = await showConfirm(
         '`kj clean --nuke` will delete EVERY plan / session / batch + wipe the HU Board DB. Cannot be undone.',

package/packages/hu-board/public/utils/log-panel.js

@@ -79,13 +79,13 @@ function openGenericLogPanel({ id, label, tailUrl }) {
                    border-bottom:1px solid var(--border);
                    user-select:none;flex-shrink:0">
       <div style="display:flex;align-items:baseline;gap:10px;min-width:0">
-        <strong style="color:var(--text)">${esc(label)}</strong>
+        <strong style="color:var(--text)" title="${esc(label)}">${esc(maggleText('log.label', label))}</strong>
         <span style="font-family:var(--font-mono, monospace);font-size:0.78rem;
                      color:var(--text-muted);overflow:hidden;text-overflow:ellipsis;
                      white-space:nowrap">${esc(id)}</span>
       </div>
       <div style="display:flex;align-items:center;gap:6px;flex-shrink:0">
-        <span id="log-status" style="font-size:0.75rem;color:var(--text-muted);margin-right:8px">connecting…</span>
+        <span id="log-status" style="font-size:0.75rem;color:var(--text-muted);margin-right:8px">${maggleText('log.connecting', 'connecting…')}</span>
         <button id="log-min" type="button" title="Minimize (run keeps going)"
                 style="${winBtnStyle('#facc15')}">_</button>
         <button id="log-max" type="button" title="Maximize / Restore"
@@ -101,8 +101,8 @@ function openGenericLogPanel({ id, label, tailUrl }) {
                 white-space:pre-wrap;word-break:break-word"></pre>
     <footer style="padding:6px 12px;border-top:1px solid var(--border);
                    font-size:0.7rem;color:var(--text-muted);flex-shrink:0">
-      Closing this panel does NOT stop the run. It keeps going in the background;
-      reopen with the 📜 View log button on the board.
+      ${maggleText('log.footer', `Closing this panel does NOT stop the run. It keeps going in the background;
+      reopen with the 📜 View log button on the board.`)}
     </footer>
   `;
 

package/packages/hu-board/public/utils/maggle-mode.js

@@ -0,0 +1,124 @@
+// KJC-TSK-0810 (MGL-C) — maggle mode: the board in plain language.
+//
+// Classic script (no exports), loaded FIRST among the utils so the other
+// scripts can call maggleText() at render time. `kj go` opens the board at
+// /?maggle=1; the choice persists in localStorage so reloads keep the
+// plain-language UI, and ?maggle=0 (the "modo experto" link) clears it.
+// A dev opening the board directly sees no change. If storage is
+// unavailable the mode degrades to the technical UI — it never breaks.
+
+const MAGGLE_STORE_KEY = 'kj-maggle-mode';
+
+// Plain label first; the technical term survives as tooltip/secondary
+// detail where each call site renders it (AC1: llano delante, jerga detrás).
+const MAGGLE_LABELS = {
+  'column.pending': 'Por hacer',
+  'column.running': 'En marcha',
+  'column.done': 'Hecho',
+  'board.title': 'Tu trabajo',
+  'board.stories': 'tareas',
+  'board.story': 'tarea',
+  'board.run': '▶ Continuar con lo pendiente',
+  'board.runTitle': 'Karajan seguirá con las tareas que faltan, una a una. Podrás ver la actividad aquí.',
+  'board.stop': '⏹ Parar',
+  'board.stopTitle': 'Detiene el trabajo en marcha. Lo ya terminado se conserva.',
+  'board.viewLog': '📜 Ver actividad',
+  'board.running': 'en marcha',
+  'board.ragPlaceholder': '🔍 Pregunta lo que quieras sobre este proyecto…',
+  'header.subtitle': 'tu tablero de trabajo',
+  'nav.board': 'Tablero',
+  'nav.dashboard': 'Proyectos',
+  'nav.more': 'Más',
+  'picker.hint': 'Elige un proyecto para ver su tablero. Puedes cambiar de proyecto arriba a la derecha.',
+  'picker.project': 'proyecto',
+  'launcher.title': '📝 Pedir trabajo a Karajan',
+  'launcher.planLabel': '📝 Pedir trabajo nuevo',
+  'launcher.planHelp': 'Cuéntale a Karajan qué quieres construir o cambiar, con tus palabras. Lo convertirá en tareas que verás en el tablero — todavía no toca tu código.',
+  'launcher.taskLabel': 'Qué quieres pedir',
+  'launcher.submit': 'Pedir',
+  'launcher.cancel': 'Cancelar',
+  'launcher.more': 'Más opciones…',
+  'launcher.confirm': 'Voy a convertir tu petición en tareas del tablero. Tardará unos minutos y podrás seguir la actividad en esta ventana. ¿Sigo?',
+  'log.label': 'Actividad',
+  'log.connecting': 'conectando…',
+  'log.footer': 'Cerrar esta ventana NO detiene el trabajo: sigue en marcha. Vuelve a abrirla con el botón «📜 Ver actividad» del tablero.',
+};
+
+function isMaggleMode() {
+  try {
+    const flag = new URLSearchParams(location.search || '').get('maggle');
+    if (flag === '1') { localStorage.setItem(MAGGLE_STORE_KEY, '1'); return true; }
+    if (flag === '0') { localStorage.removeItem(MAGGLE_STORE_KEY); return false; }
+    return localStorage.getItem(MAGGLE_STORE_KEY) === '1';
+  } catch {
+    return false;
+  }
+}
+
+/** Plain label when maggle mode is on; the technical one otherwise. */
+function maggleText(key, technical) {
+  if (!isMaggleMode()) return technical;
+  return MAGGLE_LABELS[key] || technical;
+}
+
+// AC4: an error shown to a maggle is never a stacktrace alone. Pure —
+// the caller (showError) decides by mode and renders the HTML.
+function maggleErrorParts(rawMessage) {
+  return {
+    headline: 'Algo no ha salido como se esperaba',
+    next: 'No has roto nada. Vuelve a intentarlo; si se repite, cuéntaselo a tu agente en la conversación — este detalle le sirve para arreglarlo.',
+    detail: rawMessage,
+  };
+}
+
+// AC2 (nav half): the header keeps Tablero + Proyectos in plain Spanish
+// and folds every advanced view behind one "Más" toggle, which also
+// reveals the way back to the expert UI.
+function applyMaggleChrome() {
+  if (!isMaggleMode()) return;
+  document.body.classList.add('maggle-mode');
+  const subtitle = document.querySelector('.header__subtitle');
+  if (subtitle) subtitle.textContent = MAGGLE_LABELS['header.subtitle'];
+  const nav = document.querySelector('.header__nav');
+  if (!nav) return;
+  const KEEP = { board: MAGGLE_LABELS['nav.board'], dashboard: MAGGLE_LABELS['nav.dashboard'] };
+  const advanced = [];
+  for (const btn of nav.querySelectorAll('.nav-btn')) {
+    const view = btn.dataset.view;
+    if (view && KEEP[view]) {
+      btn.title = `${btn.textContent.trim()} — ${btn.title}`;
+      btn.textContent = KEEP[view];
+    } else {
+      btn.style.display = 'none';
+      advanced.push(btn);
+    }
+  }
+  if (advanced.length === 0) return;
+  const more = document.createElement('button');
+  more.className = 'nav-btn';
+  more.textContent = `${MAGGLE_LABELS['nav.more']} ▾`;
+  more.title = 'Vistas avanzadas y volver al modo experto';
+  more.addEventListener('click', () => {
+    const hidden = advanced[0].style.display === 'none';
+    for (const btn of advanced) btn.style.display = hidden ? '' : 'none';
+    more.textContent = `${MAGGLE_LABELS['nav.more']} ${hidden ? '▴' : '▾'}`;
+    let expert = document.getElementById('maggle-expert-link');
+    if (hidden && !expert) {
+      expert = document.createElement('a');
+      expert.id = 'maggle-expert-link';
+      expert.className = 'nav-btn';
+      expert.href = '/?maggle=0';
+      expert.textContent = 'Modo experto';
+      expert.title = 'Vuelve a la interfaz técnica (Pending/Running/Done, comandos kj)';
+      more.after(expert);
+    } else if (!hidden && expert) {
+      expert.remove();
+    }
+  });
+  // After the LAST nav button, so the plain row reads Tablero | Proyectos | Más.
+  advanced.at(-1).after(more);
+}
+
+if (typeof document !== 'undefined' && document.addEventListener) {
+  document.addEventListener('DOMContentLoaded', applyMaggleChrome);
+}

package/packages/hu-board/public/utils/modals.js

@@ -74,14 +74,23 @@ function ensureDialog() {
 function showError(message, opts = {}) {
   return new Promise((resolve) => {
     const dlg = ensureDialog();
-    const title = opts.title || 'Error';
+    // Maggle mode (KJC-TSK-0810 AC4): plain headline + next step, the raw
+    // message demoted to a collapsed technical detail — never alone.
+    const maggle = isMaggleMode() ? maggleErrorParts(message) : null;
+    const title = maggle ? maggle.headline : (opts.title || 'Error');
+    const body = maggle
+      ? `${esc(maggle.next)}
+         <details style="margin-top:10px"><summary style="cursor:pointer;color:var(--text-muted)">Detalle técnico${opts.title ? ` — ${esc(opts.title)}` : ''}</summary>
+           <pre style="white-space:pre-wrap;font-size:0.8rem;color:var(--text-muted);margin:8px 0 0">${esc(maggle.detail)}</pre>
+         </details>`
+      : esc(message);
     dlg.innerHTML = `
       <div style="padding:14px 18px;border-bottom:1px solid var(--border);
                   font-weight:600;color:var(--color-red,#ef4444)">
         ${esc(title)}
       </div>
       <div style="padding:16px 18px;font-size:0.9rem;line-height:1.5;
-                  white-space:pre-wrap">${esc(message)}</div>
+                  white-space:pre-wrap">${body}</div>
       <div style="padding:12px 18px;border-top:1px solid var(--border);
                   text-align:right">
         <button id="app-dialog-ok" class="control-btn"

package/packages/hu-board/public/utils/project-picker-view.js

@@ -70,11 +70,11 @@ async function renderProjectPicker() {
 
   app.innerHTML = `
     <div class="section-header">
-      <span class="section-header__title">Story Board</span>
-      <span class="section-header__count">${sorted.length} project${sorted.length === 1 ? '' : 's'}</span>
+      <span class="section-header__title">${maggleText('board.title', 'Story Board')}</span>
+      <span class="section-header__count">${sorted.length} ${maggleText('picker.project', 'project')}${sorted.length === 1 ? '' : 's'}</span>
     </div>
     <p style="padding:8px 4px 16px;color:var(--text-muted);font-size:0.9rem">
-      Pick a project to see its kanban. Use the project selector in the header to switch later.
+      ${maggleText('picker.hint', 'Pick a project to see its kanban. Use the project selector in the header to switch later.')}
     </p>
     <div style="display:grid;grid-template-columns:repeat(auto-fill, minmax(320px, 1fr));gap:14px">
       ${sorted.map((p) => {

package/scripts/install-binary.ps1

@@ -62,7 +62,10 @@ try {
       Write-Host "kj-install: Node $(& node --version) found — installing via npm (full product)..."
       & npm install -g (Get-NpmPkg)
       if ($LASTEXITCODE -ne 0) { throw "npm install failed (exit $LASTEXITCODE)." }
-      Write-Host "kj-install: installed. Run 'kj doctor' next, then 'kj install-tools' to complete the whole stack."
+      Write-Host ""
+      Write-Host "  Listo. Ahora escribe:  kj go"
+      Write-Host ""
+      Write-Host "  (avanzado: 'kj doctor' revisa la instalacion, 'kj install-tools' completa el stack)"
       return
     }
 
@@ -137,7 +140,10 @@ try {
     Add-UserPath $installDir
     $installed = (& (Join-Path $installDir "kj.cmd") --version) 2>$null
     Write-Host "kj-install: installed kj $installed (full product) — kj at $(Join-Path $installDir 'kj.cmd')"
-    Write-Host "kj-install: next — run 'kj doctor', then 'kj install-tools' to complete the whole stack."
+    Write-Host ""
+    Write-Host "  Listo. Ahora escribe:  kj go"
+    Write-Host ""
+    Write-Host "  (avanzado: 'kj doctor' revisa la instalacion, 'kj install-tools' completa el stack)"
     return
   }
 
@@ -168,7 +174,10 @@ try {
   Add-UserPath $installDir
   $installed = (& $dest --version) 2>$null
   Write-Host "kj-install: installed standalone kj $installed to $dest"
-  Write-Host "kj-install: next — run 'kj doctor'. For the full product later: re-run without KJ_STANDALONE."
+  Write-Host ""
+  Write-Host "  Listo. Ahora escribe:  kj go"
+  Write-Host ""
+  Write-Host "  (avanzado: 'kj doctor' revisa la instalacion; para el producto completo, re-ejecuta sin KJ_STANDALONE)"
 } finally {
   Remove-Item -Path $tmp -Recurse -Force -ErrorAction SilentlyContinue
 }

package/scripts/install-binary.sh

@@ -71,7 +71,11 @@ if [ "$MODE" = "full" ]; then
   if node_ok; then
     echo "kj-install: Node $(node --version) found — installing via npm (full product)..."
     npm install -g "$(npm_pkg)" || die "npm install failed. If it was a permissions error, set a user prefix (npm config set prefix ~/.local) and re-run."
-    echo "kj-install: installed $(kj --version 2>/dev/null || echo karajan-code). Run 'kj doctor' next."
+    echo "kj-install: installed $(kj --version 2>/dev/null || echo karajan-code)."
+    echo ""
+    echo "  Listo. Ahora escribe:  kj go"
+    echo ""
+    echo "  (avanzado: 'kj doctor' revisa la instalacion, 'kj install-tools' completa el stack)"
     exit 0
   fi
 
@@ -125,7 +129,10 @@ if [ "$MODE" = "full" ]; then
   installed="$("${INSTALL_DIR}/kj" --version 2>/dev/null || echo '?')"
   echo "kj-install: installed kj ${installed} (full product) — kj at ${INSTALL_DIR}/kj"
   path_hint "$INSTALL_DIR"
-  echo "kj-install: next — run 'kj doctor', then 'kj install-tools' to complete the whole stack."
+  echo ""
+  echo "  Listo. Ahora escribe:  kj go"
+  echo ""
+  echo "  (avanzado: 'kj doctor' revisa la instalacion, 'kj install-tools' completa el stack)"
   exit 0
 fi
 
@@ -156,4 +163,7 @@ fi
 installed="$("${INSTALL_DIR}/kj" --version 2>/dev/null || echo '?')"
 echo "kj-install: installed standalone kj ${installed} to ${INSTALL_DIR}/kj"
 path_hint "$INSTALL_DIR"
-echo "kj-install: next — run 'kj doctor'. For the full product later: re-run this installer without --standalone."
+echo ""
+echo "  Listo. Ahora escribe:  kj go"
+echo ""
+echo "  (avanzado: 'kj doctor' revisa la instalacion; para el producto completo, re-ejecuta sin --standalone)"

package/src/cli/advanced-commands.js

@@ -7,6 +7,7 @@
 
 /** The few commands a newcomer needs. Shown in `kj --help`. */
 export const CORE_COMMANDS = [
+  "go",
   "start",
   "init",
   "run",

package/src/cli/register-meta.js

@@ -4,6 +4,7 @@ import { researcherCommand } from "../commands/researcher.js";
 import { architectCommand } from "../commands/architect.js";
 import { onboardCommand } from "../commands/onboard.js";
 import { startCommand } from "../commands/start.js";
+import { goCommand } from "../commands/go.js";
 import { identityCommand } from "../commands/identity.js";
 import { policyCommand } from "../commands/policy.js";
 import { claimsCommand, claimsGateCommand } from "../commands/claims.js";
@@ -148,6 +149,17 @@ export function registerMeta(program, { pkgVersion }) {
       });
     });
 
+  // MGL-A (KJC-TSK-0808): the muggle launcher — one command, at most one
+  // question, and the person lands inside a governed conversation.
+  program
+    .command("go")
+    .description("Arranca Karajan sin saber nada: detecta tu agente, prepara el proyecto, abre el tablero y te deja en la conversación")
+    .action(async (flags) => {
+      await withConfig(pkgVersion, "go", flags, async ({ config, logger }) => {
+        await goCommand({ config, logger, flags });
+      });
+    });
+
   program
     .command("start")
     .description("Single entry point: assess the project and recommend the next step")

package/src/commands/board.js

@@ -87,8 +87,23 @@ async function findAvailablePort(desiredPort, maxTries = 10) {
  * @returns {string}
  */
 export function buildBoardUrl(port, projectSlug) {
-  const base = `http://localhost:${port}`;
-  return projectSlug ? `${base}/#board/${projectSlug}` : base;
+  return projectSlug ? boardUrl(port, `/#board/${projectSlug}`) : boardUrl(port);
+}
+
+/**
+ * Base board URL plus an optional absolute path (query and/or hash) —
+ * `kj go` opens `/?maggle=1` so the frontend renders in plain language
+ * (KJC-TSK-0810). A relative path is a caller bug, not something to fix
+ * up silently.
+ * @param {number} port
+ * @param {string} [path]
+ * @returns {string}
+ */
+export function boardUrl(port, path = "") {
+  if (path && !path.startsWith("/")) {
+    throw new Error(`board path must start with "/": ${path}`);
+  }
+  return `http://localhost:${port}${path}`;
 }
 
 /**
@@ -368,7 +383,7 @@ export function renderBoardBanner({ url, status, projectName }) {
   return ["", rule, ...content, rule, ""].join("\n");
 }
 
-export async function boardCommand({ action = "start", port = 4000, bind = "127.0.0.1", logger }) {
+export async function boardCommand({ action = "start", port = 4000, bind = "127.0.0.1", logger, path }) {
   switch (action) {
     case "start": {
       let result;
@@ -422,7 +437,7 @@ export async function boardCommand({ action = "start", port = 4000, bind = "127.
         logger.info("HU Board is not running. Starting it first...");
         await startBoard(port);
       }
-      const url = `http://localhost:${port}`;
+      const url = boardUrl(port, path);
       // eslint-disable-next-line import-x/no-unresolved -- optional peer; the .catch handles its absence
       const { default: open } = await import("open").catch(() => ({ default: null }));
       if (open) {

package/src/commands/go.js

@@ -0,0 +1,110 @@
+/**
+ * `kj go` (MGL-A, KJC-TSK-0808, epic KJC-PCS-0084) — the muggle launcher.
+ * One command for a person with no computing background: detect their agents,
+ * ask AT MOST one question, prepare the project silently, open the board, and
+ * leave them inside a conversation that already knows the method. What cannot
+ * be hidden is said honestly: the agent's account and login are THEIRS — kj
+ * never touches credentials. Everything is injectable so tests spawn nothing.
+ */
+import { existsSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { checkBinary } from "../utils/agent-detect.js";
+import { createCliAskQuestion } from "../utils/cli-ask-question.js";
+import { envInstallCommand } from "./env.js";
+import { boardCommand } from "./board.js";
+// The interactive launchers a muggle can live inside (v1: the two the epic
+// names). Auth heuristics are the same cheap file checks reviewer-fallback
+// uses: menu signal, never a spawned process.
+export const MAGGLE_AGENTS = [
+  { name: "claude", label: "Claude Code (Anthropic)", authPaths: [".claude.json", ".claude"], install: "npm install -g @anthropic-ai/claude-code", login: "claude   (sigue el enlace de inicio de sesión que te muestre)" },
+  { name: "codex", label: "Codex (OpenAI)", authPaths: [".codex/auth.json"], install: "npm install -g @openai/codex", login: "codex login" },
+];
+export async function detectMaggleAgents({ home = os.homedir(), checkBin = checkBinary } = {}) {
+  return Promise.all(
+    MAGGLE_AGENTS.map(async (a) => {
+      let installed = false;
+      try { installed = (await checkBin(a.name)).ok; } catch { /* not installed */ }
+      const authenticated = installed && a.authPaths.some((p) => existsSync(path.join(home, p)));
+      return { ...a, installed, authenticated };
+    }),
+  );
+}
+/** The session's opening prompt — SHORT and in plain language. The full
+ * playbook already lives in the agent files env-install wrote; duplicating it
+ * here would dilute it. This prompt sets the tone for a muggle. */
+export function buildGoPrompt() {
+  return [
+    "Arrancas dentro de un proyecto gobernado por Karajan (las reglas del método ya están en los ficheros de agente de este proyecto: síguelas siempre).",
+    "La persona que te habla puede no saber programar. Habla en lenguaje llano: sin jerga, sin siglas sin explicar, y resume cada resultado en una o dos frases antes del detalle.",
+    "Antes de cambios importantes, di en llano qué vas a hacer y qué pasará. Si algo falla, explica qué pasó y cuál es el siguiente paso — nunca un volcado de error a secas.",
+    "El tablero del proyecto está abierto en su navegador: cuando termines algo, recuérdale que puede verlo ahí.",
+    "Empieza presentándote en dos frases y preguntando qué quiere construir o cambiar hoy.",
+  ].join("\n");
+}
+async function defaultPrepare({ config, logger }) {
+  await envInstallCommand({ config, logger, flags: { yes: true } });
+}
+export async function defaultBoard({ config, logger, runBoard = boardCommand }) {
+  const port = config.hu_board?.port || 4000;
+  await runBoard({ action: "start", port, bind: "127.0.0.1", logger });
+  // /?maggle=1 switches the frontend to plain language (KJC-TSK-0810) —
+  // the muggle's window opens already speaking their language.
+  await runBoard({ action: "open", port, bind: "127.0.0.1", path: "/?maggle=1", logger });
+}
+function defaultLaunch(agent, prompt) {
+  // Interactive session: the muggle LIVES here. CLAUDECODE is stripped so a
+  // nested Claude does not refuse to start (the known subprocess quirk).
+  const { CLAUDECODE: _omit, ...env } = process.env;
+  return new Promise((resolvePromise) => {
+    const child = spawn(agent.name, [prompt], { stdio: "inherit", env });
+    child.on("exit", (code) => resolvePromise(code ?? 0));
+    child.on("error", (err) => {
+      console.error(`No se pudo arrancar ${agent.label}: ${err.message}`);
+      resolvePromise(1);
+    });
+  });
+}
+export async function goCommand({ config = {}, logger = console, flags = {}, deps = {} } = {}) {
+  const projectDir = config.projectDir || process.cwd();
+  const agents = await (deps.detect ?? detectMaggleAgents)();
+  const ready = agents.filter((a) => a.installed && a.authenticated);
+  const needLogin = agents.filter((a) => a.installed && !a.authenticated);
+  if (ready.length === 0) {
+    if (needLogin.length > 0) {
+      logger.error?.("Tienes el agente instalado pero falta iniciar sesión — eso solo puedes hacerlo tú (la cuenta es tuya; Karajan nunca toca tus credenciales):");
+      for (const a of needLogin) logger.error?.(`  ${a.label}:  ${a.login}`);
+      logger.error?.("Cuando hayas iniciado sesión, vuelve a escribir: kj go");
+    } else {
+      logger.error?.("Karajan trabaja con un agente de IA que aún no tienes instalado. Elige uno, instálalo con su comando, e inicia sesión con TU cuenta (la cuenta es tuya):");
+      for (const a of agents) logger.error?.(`  ${a.label}:  ${a.install}`);
+      logger.error?.("Después, vuelve a escribir: kj go");
+    }
+    process.exitCode = 1;
+    return 1;
+  }
+  let chosen = ready[0];
+  if (ready.length > 1) {
+    const ask = deps.ask ?? createCliAskQuestion({ flags });
+    const answer = await ask("¿Con cuál de tus agentes quieres trabajar?", { options: ready.map((a) => a.name), default: ready[0].name });
+    chosen = ready.find((a) => a.name === String(answer).trim()) ?? ready[0];
+  }
+  logger.info?.(`Trabajarás con ${chosen.label}.`);
+  // Prepare ONCE: decisions already taken are never re-asked.
+  if (!existsSync(path.join(projectDir, ".karajan", "review-gate"))) {
+    logger.info?.("Preparando tu proyecto (solo la primera vez)…");
+    await (deps.prepare ?? defaultPrepare)({ config, logger });
+  }
+  // The board is the muggle's window — unless the project turned it off
+  // (hu_board.enabled false is respected: KJC-BUG-0152). A board failure is
+  // said and never stops the conversation from starting.
+  if (config.hu_board?.enabled !== false) {
+    try { await (deps.board ?? defaultBoard)({ config, logger }); } catch (err) { logger.warn?.(`El tablero no pudo abrirse (${err.message}) — la conversación arranca igual.`); }
+  }
+  const prompt = (deps.prompt ?? buildGoPrompt)();
+  logger.info?.("Abriendo tu conversación… (escribe ahí lo que necesites, en tu idioma)");
+  const code = await (deps.launch ?? defaultLaunch)(chosen, prompt);
+  process.exitCode = code;
+  return code;
+}

package/src/steward/phantom-coverage.js

@@ -75,12 +75,27 @@ export function detectPhantomUnit({ sourceAnalysis, testSource, file = "<test>"
 const literalsOf = (tree, minLength) => {
   const out = [];
   walk(tree, (n) => {
-    if (n.type === "StringLiteral" && n.value.trim().length >= minLength) out.push({ value: n.value, line: n.loc.start.line });
-    if (n.type === "TemplateElement" && n.value.cooked && n.value.cooked.trim().length >= minLength) out.push({ value: n.value.cooked, line: n.loc.start.line });
+    if (n.type === "StringLiteral" && n.value.trim().length >= minLength) out.push({ value: n.value, line: n.loc.start.line, template: false });
+    if (n.type === "TemplateElement" && n.value.cooked && n.value.cooked.trim().length >= minLength) out.push({ value: n.value.cooked, line: n.loc.start.line, template: true });
   });
   return out;
 };
 
+// KJC-BUG-0158 (GREBLA's field validation): an interpolated label —
+// aria-label="Head al que reporta ${name}" — never matches the RESOLVED
+// string a test looks for, and in Lit that is the usual case, not the
+// exception. The static chunk carries markup before the label, so the right
+// crossing is: the longest SUFFIX of a template chunk that is a PREFIX of the
+// test's literal. Threshold contains false positives; a LIVE chunk producing
+// the same start absolves — covering interpolation must never accuse live UI.
+const PREFIX_MIN = 8;
+const overlap = (chunk, wanted) => {
+  for (let k = Math.min(chunk.length, wanted.length); k >= PREFIX_MIN; k--) {
+    if (chunk.endsWith(wanted.slice(0, k))) return k;
+  }
+  return 0;
+};
+
 /**
  * E2E detector: literals the test looks for that ONLY exist inside
  * unreachable spans of the source. A literal also present in reachable code
@@ -99,15 +114,37 @@ export function detectPhantomE2E({ sourceText, sourceAnalysis, testSource, file
   }
   const deadSpans = observableClasses(sourceAnalysis).flatMap((c) => c.unreachable.map((u) => [u.line, u.endLine]));
   const inDead = (line) => deadSpans.some(([a, b]) => line >= a && line <= b);
+  const sourceLits = literalsOf(sourceTree, minLength);
   const onlyInDead = new Map(); // literal → line where it lives
-  for (const lit of literalsOf(sourceTree, minLength)) {
+  for (const lit of sourceLits) {
     if (inDead(lit.line)) { if (!onlyInDead.has(lit.value)) onlyInDead.set(lit.value, lit.line); }
     else onlyInDead.set(lit.value, -1); // seen reachable — poisoned, never reportable
   }
-  const wanted = new Set(literalsOf(testTree, minLength).map((l) => l.value));
-  const phantoms = [...wanted]
-    .filter((v) => onlyInDead.get(v) !== undefined && onlyInDead.get(v) !== -1)
-    .map((v) => ({ literal: v, line: onlyInDead.get(v), file }));
+  // KJC-BUG-0159 (GREBLA's field catch): file+line point at the TEST — that is
+  // where the fix happens; the dead code's spot travels as sourceLine. A
+  // finding at spec.js:2183 on a 32-line spec sends the reader nowhere.
+  const wanted = new Map(); // literal → its line IN THE TEST (first sighting)
+  for (const l of literalsOf(testTree, minLength)) if (!wanted.has(l.value)) wanted.set(l.value, l.line);
+  const phantoms = [...wanted.entries()]
+    .filter(([v]) => onlyInDead.get(v) !== undefined && onlyInDead.get(v) !== -1)
+    .map(([v, testLine]) => ({ literal: v, file, line: testLine, sourceLine: onlyInDead.get(v) }));
+  // KJC-BUG-0158: interpolated labels match by static-chunk prefix. Dead wins
+  // only when NO live chunk produces at least the same start.
+  const chunks = sourceLits.filter((l) => l.template);
+  for (const [v, testLine] of wanted) {
+    if (phantoms.some((p) => p.literal === v)) continue;
+    // the exact literal living in REACHABLE code absolves here too (codex's
+    // catch): that test does point at something alive.
+    if (onlyInDead.get(v) === -1) continue;
+    let kDead = 0, kLive = 0, deadLine = 0;
+    for (const c of chunks) {
+      // a chunk CONTAINING the whole literal is the strongest match either way
+      const k = c.value.includes(v) ? v.length : overlap(c.value, v);
+      if (inDead(c.line)) { if (k > kDead) { kDead = k; deadLine = c.line; } }
+      else if (k > kLive) kLive = k;
+    }
+    if (kDead >= PREFIX_MIN && kDead > kLive) phantoms.push({ literal: v, file, line: testLine, sourceLine: deadLine });
+  }
   return { observable: true, phantoms };
 }