@jaimevalasek/aioson 1.21.7 → 1.22.0

package/src/harness/glob-match.js

@@ -0,0 +1,126 @@
+'use strict';
+
+/**
+ * Glob matcher mínimo e determinístico para o scope guard (loop-guardrails D1).
+ *
+ * Subset estrito suportado: `**`, `*`, `?` (incluindo `**` + `/` nas bordas).
+ * Qualquer sintaxe fora do subset (extglob `{}[]!()`, classes, negação) é
+ * REJEITADA pelo validador — nunca mismatch silencioso em fronteira de
+ * segurança. `picomatch` é o upgrade path documentado se o subset apertar.
+ *
+ * Semântica de caminho (decisão registrada em spec-loop-guardrails.md):
+ * - paths e patterns são normalizados para `/` antes do match (EC-6);
+ * - pattern SEM `/` casa contra o basename de qualquer profundidade
+ *   (estilo gitignore: `*.pem` casa `certs/server.pem`);
+ * - pattern COM `/` casa contra o caminho relativo completo.
+ */
+
+const INVALID_GLOB_CHARS = /[{}[\]()!]/;
+
+/** Normaliza separadores para `/` e remove `./` inicial. */
+function normalizePath(p) {
+  let out = String(p == null ? '' : p).replace(/\\/g, '/');
+  while (out.startsWith('./')) out = out.slice(2);
+  return out;
+}
+
+/**
+ * Valida um pattern contra o subset estrito.
+ * Retorna { ok: true } ou { ok: false, reason }.
+ */
+function validateGlobPattern(pattern) {
+  if (typeof pattern !== 'string' || pattern.trim() === '') {
+    return { ok: false, reason: 'pattern must be a non-empty string' };
+  }
+  const normalized = normalizePath(pattern);
+  const invalid = normalized.match(INVALID_GLOB_CHARS);
+  if (invalid) {
+    return {
+      ok: false,
+      reason: `unsupported glob syntax "${invalid[0]}" — only **, * and ? are allowed (strict subset)`
+    };
+  }
+  return { ok: true };
+}
+
+const REGEX_SPECIALS = /[.+^$|]/g;
+
+/** Compila um pattern (já validado) para RegExp anchored. */
+function globToRegExp(pattern) {
+  const normalized = normalizePath(pattern);
+  let regex = '';
+  let i = 0;
+  while (i < normalized.length) {
+    const ch = normalized[i];
+    if (ch === '*') {
+      if (normalized[i + 1] === '*') {
+        // `**` — atravessa separadores
+        const prev = normalized[i - 1];
+        const next = normalized[i + 2];
+        if ((prev === undefined || prev === '/') && next === '/') {
+          // `**/` no início ou após `/` — zero ou mais segmentos completos
+          regex += '(?:[^/]+/)*';
+          i += 3;
+          continue;
+        }
+        if (next === undefined && (prev === undefined || prev === '/')) {
+          // `/**` no fim ou pattern `**` puro — qualquer resto (inclusive vazio? não:
+          // `secrets/**` exige algo dentro de secrets/; `**` puro casa tudo)
+          regex += prev === '/' ? '.+' : '.*';
+          i += 2;
+          continue;
+        }
+        // `**` colado em texto (ex.: `a**b`) — trata como `.*`
+        regex += '.*';
+        i += 2;
+        continue;
+      }
+      regex += '[^/]*';
+      i += 1;
+      continue;
+    }
+    if (ch === '?') {
+      regex += '[^/]';
+      i += 1;
+      continue;
+    }
+    regex += ch.replace(REGEX_SPECIALS, '\\$&');
+    i += 1;
+  }
+  return new RegExp(`^${regex}$`);
+}
+
+/**
+ * Casa um path contra um pattern do subset.
+ * Pattern sem `/` casa contra o basename (estilo gitignore).
+ */
+function matchGlob(pattern, filePath) {
+  const normalizedPattern = normalizePath(pattern);
+  const normalizedPath = normalizePath(filePath);
+  if (!normalizedPattern || !normalizedPath) return false;
+
+  if (!normalizedPattern.includes('/')) {
+    const basename = normalizedPath.split('/').pop();
+    return globToRegExp(normalizedPattern).test(basename);
+  }
+  return globToRegExp(normalizedPattern).test(normalizedPath);
+}
+
+/**
+ * Retorna o primeiro pattern da lista que casa o path, ou null.
+ */
+function matchAny(patterns, filePath) {
+  if (!Array.isArray(patterns)) return null;
+  for (const pattern of patterns) {
+    if (matchGlob(pattern, filePath)) return pattern;
+  }
+  return null;
+}
+
+module.exports = {
+  normalizePath,
+  validateGlobPattern,
+  globToRegExp,
+  matchGlob,
+  matchAny
+};

package/src/harness/guard-events.js

@@ -0,0 +1,71 @@
+'use strict';
+
+/**
+ * Telemetria dos guards do self:loop (loop-guardrails D6).
+ *
+ * Helper único de emissão para os tipos de evento novos (requirements §2.5):
+ * scope_violation, budget_warning, budget_exceeded, runtime_exceeded,
+ * human_gate_requested, human_gate_decision, criteria_check_failed,
+ * failure_signature_repeat, contract_invalid, diff_limit_exceeded.
+ *
+ * Sempre best-effort (espelha BR-NC-11 / neural-chain-telemetry): telemetria
+ * NUNCA quebra o loop. `token_count` carrega a estimativa chars/4 quando o
+ * evento é de tentativa (REQ-7) — telemetria apenas; enforcement lê o
+ * acumulador em progress.json (D3).
+ */
+
+const GUARD_EVENT_TYPES = Object.freeze([
+  'scope_violation',
+  'budget_warning',
+  'budget_exceeded',
+  'runtime_exceeded',
+  'human_gate_requested',
+  'human_gate_decision',
+  'criteria_check_failed',
+  'failure_signature_repeat',
+  'contract_invalid',
+  'diff_limit_exceeded'
+]);
+
+/**
+ * Emite um evento de guard no runtime store. Nunca lança.
+ *
+ * @param {string} targetDir — raiz do projeto
+ * @param {object} event
+ * @param {string} event.eventType — um de GUARD_EVENT_TYPES
+ * @param {string} [event.agent] — default 'self-loop'
+ * @param {string} [event.message]
+ * @param {object} [event.payload] — vai para payload_json (slug, attempt, etc.)
+ * @param {number|null} [event.tokenCount] — estimativa chars/4 da tentativa
+ * @returns {boolean} true se gravou
+ */
+async function emitGuardEvent(targetDir, { eventType, agent = 'self-loop', message = '', payload = null, tokenCount = null } = {}) {
+  if (!GUARD_EVENT_TYPES.includes(eventType)) return false;
+  let db = null;
+  try {
+    const { openRuntimeDb } = require('../runtime-store');
+    const opened = await openRuntimeDb(targetDir);
+    db = opened.db;
+    db.prepare(`
+      INSERT INTO execution_events (event_type, agent_name, message, payload_json, token_count, created_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(
+      eventType,
+      agent,
+      message || eventType,
+      payload ? JSON.stringify(payload) : null,
+      tokenCount === null || tokenCount === undefined ? null : Math.round(tokenCount),
+      new Date().toISOString()
+    );
+    return true;
+  } catch {
+    return false; // D6: telemetria nunca quebra o loop
+  } finally {
+    try { if (db) db.close(); } catch { /* ignore */ }
+  }
+}
+
+module.exports = {
+  GUARD_EVENT_TYPES,
+  emitGuardEvent
+};

package/src/harness/human-gate.js

@@ -0,0 +1,182 @@
+'use strict';
+
+/**
+ * Human gates temáticos do self:loop (loop-guardrails REQ-12/13/14/15 + D4).
+ *
+ * Estado em disco:
+ * - `.aioson/plans/{slug}/gates/{id}.json` — decisão humana persistida
+ *   (schema requirements §2.4 + campo aditivo `run_id` para suprimir
+ *   re-detecção do mesmo tema dentro do run)
+ * - `progress.json` — `status='human_gate'` + `pending_gates[]` (D4)
+ *
+ * O tema `publish` é gate de COMANDO (intercepta feature:close, REQ-13) —
+ * nunca entra na detecção por diff.
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const { matchAny } = require('./glob-match');
+
+const GATE_STATUSES = Object.freeze(['pending', 'approved', 'rejected']);
+
+function gatesDir(planDir) {
+  return path.join(planDir, 'gates');
+}
+
+function gatePath(planDir, gateId) {
+  const safeId = String(gateId).replace(/[^A-Za-z0-9._-]/g, '_');
+  return path.join(gatesDir(planDir), `${safeId}.json`);
+}
+
+/** Carrega todos os gates do slug (array vazio se nenhum). */
+function loadGates(planDir) {
+  const dir = gatesDir(planDir);
+  if (!fs.existsSync(dir)) return [];
+  const gates = [];
+  for (const file of fs.readdirSync(dir)) {
+    if (!file.endsWith('.json')) continue;
+    try {
+      gates.push(JSON.parse(fs.readFileSync(path.join(dir, file), 'utf8')));
+    } catch { /* gate corrompido — ignorado na leitura, decisão manual via fs */ }
+  }
+  return gates;
+}
+
+function pendingGates(planDir) {
+  return loadGates(planDir).filter((g) => g.status === 'pending');
+}
+
+/**
+ * Detecção por tema (REQ-12): diff da tentativa casando os globs do tema E
+ * tema listado em required_for. `publish` nunca é detectado por diff (REQ-13).
+ * Temas já cobertos por gate `approved` do MESMO run não re-disparam.
+ *
+ * @returns {Array<{theme, triggeredBy: string[]}>}
+ */
+function detectGates({ changedFiles = [], requiredFor = [], themePaths = {}, existingGates = [], runId = null }) {
+  const detections = [];
+  for (const theme of requiredFor) {
+    if (theme === 'publish') continue; // gate de comando, nunca diff
+    const globs = themePaths[theme] || [];
+    if (!globs.length) continue;
+    const alreadyHandled = existingGates.some(
+      (g) => g.theme === theme && g.run_id === runId && (g.status === 'approved' || g.status === 'pending')
+    );
+    if (alreadyHandled) continue;
+    const triggeredBy = changedFiles
+      .filter((f) => matchAny(globs, f.path))
+      .map((f) => f.path);
+    if (triggeredBy.length > 0) {
+      detections.push({ theme, triggeredBy });
+    }
+  }
+  return detections;
+}
+
+/**
+ * Cria e persiste um gate `pending` (schema §2.4). `id` único por slug:
+ * `{theme}-{n}` com n incremental sobre os gates existentes do tema.
+ */
+function createGate(planDir, { theme, attempt, triggeredBy = [], diffSummary = '', runId = null }) {
+  const existing = loadGates(planDir).filter((g) => g.theme === theme);
+  const id = `${theme}-${existing.length + 1}`;
+  const gate = {
+    id,
+    theme,
+    status: 'pending',
+    attempt,
+    triggered_by: triggeredBy,
+    diff_summary: diffSummary,
+    requested_at: new Date().toISOString(),
+    decided_at: null,
+    decided_by: null,
+    reason: null,
+    run_id: runId
+  };
+  fs.mkdirSync(gatesDir(planDir), { recursive: true });
+  fs.writeFileSync(gatePath(planDir, id), JSON.stringify(gate, null, 2), 'utf8');
+  return gate;
+}
+
+/**
+ * Entra no estado HUMAN_GATE (D4): muta `progress` (caller persiste via cb).
+ */
+function enterHumanGate(progress, gateIds) {
+  progress.status = 'human_gate';
+  const pending = new Set(Array.isArray(progress.pending_gates) ? progress.pending_gates : []);
+  for (const id of gateIds) pending.add(id);
+  progress.pending_gates = [...pending];
+  progress.last_updated = new Date().toISOString();
+  return progress;
+}
+
+/**
+ * Decide um gate (REQ-14). Idempotente: gate já decidido → no-op com aviso.
+ * EC-8: gate inexistente → erro explícito sem efeito colateral.
+ *
+ * @returns {{ ok, error?, idempotent?, gate? }}
+ */
+function decideGate(planDir, gateId, { decision, by = null, reason = null }) {
+  if (!GATE_STATUSES.includes(decision) || decision === 'pending') {
+    return { ok: false, error: 'invalid_decision' };
+  }
+  const file = gatePath(planDir, gateId);
+  if (!fs.existsSync(file)) {
+    return { ok: false, error: 'gate_not_found', gateId };
+  }
+  let gate;
+  try {
+    gate = JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return { ok: false, error: 'gate_corrupted', gateId };
+  }
+  if (gate.status !== 'pending') {
+    return { ok: true, idempotent: true, gate };
+  }
+  if (decision === 'rejected' && !(reason && String(reason).trim())) {
+    return { ok: false, error: 'reason_required_on_reject', gateId };
+  }
+  gate.status = decision;
+  gate.decided_at = new Date().toISOString();
+  gate.decided_by = by || null;
+  gate.reason = reason || null;
+  fs.writeFileSync(file, JSON.stringify(gate, null, 2), 'utf8');
+  return { ok: true, idempotent: false, gate };
+}
+
+/**
+ * Reconcilia `progress` após decisões (REQ-15): remove o gate decidido de
+ * `pending_gates`; sem pendências → `status='in_progress'` (retomada
+ * idempotente; gate rejeitado fica como auditoria e não bloqueia runs novos).
+ * Muta `progress` (caller persiste).
+ */
+function resolveGateState(progress, planDir) {
+  const stillPending = new Set(pendingGates(planDir).map((g) => g.id));
+  const current = Array.isArray(progress.pending_gates) ? progress.pending_gates : [];
+  progress.pending_gates = current.filter((id) => stillPending.has(id));
+  if (progress.pending_gates.length === 0 && progress.status === 'human_gate') {
+    progress.status = 'in_progress';
+  }
+  progress.last_updated = new Date().toISOString();
+  return progress;
+}
+
+/**
+ * Gate de comando `publish` (REQ-13): existe gate publish aprovado?
+ */
+function hasApprovedPublishGate(planDir) {
+  return loadGates(planDir).some((g) => g.theme === 'publish' && g.status === 'approved');
+}
+
+module.exports = {
+  loadGates,
+  pendingGates,
+  detectGates,
+  createGate,
+  enterHumanGate,
+  decideGate,
+  resolveGateState,
+  hasApprovedPublishGate,
+  gatePath
+};

package/src/harness/scope-guard.js

@@ -0,0 +1,115 @@
+'use strict';
+
+/**
+ * Scope guard do self:loop (loop-guardrails REQ-4/5/6 + REQ-10).
+ *
+ * Módulo puro: recebe o changed set (já calculado por git-baseline) e o
+ * contrato RESOLVIDO (contract-schema.resolveContract — defaults proibidos já
+ * mesclados). Não faz I/O.
+ *
+ * Precedência (REQ-5): deny vence allow — path que casa `forbidden_files` é
+ * violação mesmo casando `allowed_files`. Defaults proibidos são sempre
+ * aplicados (REQ-4) porque vêm mesclados do resolveContract.
+ */
+
+const { matchAny } = require('./glob-match');
+
+/**
+ * @param {object} params
+ * @param {Array<{path, status}>} params.changedFiles — changed set da tentativa
+ * @param {Array<{path, reason}>} [params.rehashViolations] — D2 (git-baseline)
+ * @param {string[]|null} params.allowedGlobs — null = sem allowlist
+ * @param {string[]} params.forbiddenGlobs — já mesclados com defaults
+ * @returns {{ ok: boolean, violations: Array<{path, status, glob, reason}> }}
+ */
+function checkScope({ changedFiles = [], rehashViolations = [], allowedGlobs = null, forbiddenGlobs = [] }) {
+  const violations = [];
+
+  for (const file of changedFiles) {
+    const forbiddenMatch = matchAny(forbiddenGlobs, file.path);
+    if (forbiddenMatch) {
+      violations.push({
+        path: file.path,
+        status: file.status,
+        glob: forbiddenMatch,
+        reason: `matches forbidden glob "${forbiddenMatch}"${file.status === 'deleted' ? ' (deletion counts — EC-4)' : ''}`
+      });
+      continue; // deny vence allow (REQ-5)
+    }
+    if (allowedGlobs && !matchAny(allowedGlobs, file.path)) {
+      violations.push({
+        path: file.path,
+        status: file.status,
+        glob: null,
+        reason: 'outside allowed_files allowlist'
+      });
+    }
+  }
+
+  for (const rehash of rehashViolations) {
+    violations.push({
+      path: rehash.path,
+      status: 'modified',
+      glob: null,
+      reason: rehash.reason
+    });
+  }
+
+  return { ok: violations.length === 0, violations };
+}
+
+/** Conta linhas efetivas de diff (+/− excluindo headers +++/---). */
+function countDiffLines(diffPatch) {
+  if (!diffPatch) return 0;
+  let count = 0;
+  for (const line of String(diffPatch).split('\n')) {
+    if ((line.startsWith('+') && !line.startsWith('+++')) ||
+        (line.startsWith('-') && !line.startsWith('---'))) {
+      count += 1;
+    }
+  }
+  return count;
+}
+
+/**
+ * Limites de diff (REQ-10, should-have). Avaliados sobre o MESMO conjunto do
+ * scope guard. `null`/`undefined` = sem limite.
+ *
+ * @returns {{ ok: boolean, exceeded: Array<{limit, actual, max}> }}
+ */
+function checkDiffLimits({ changedFiles = [], diffPatch = '', maxChangedFiles = null, maxDiffLines = null }) {
+  const exceeded = [];
+
+  if (Number.isInteger(maxChangedFiles) && maxChangedFiles > 0 && changedFiles.length > maxChangedFiles) {
+    exceeded.push({ limit: 'max_changed_files', actual: changedFiles.length, max: maxChangedFiles });
+  }
+
+  if (Number.isInteger(maxDiffLines) && maxDiffLines > 0) {
+    const actual = countDiffLines(diffPatch);
+    if (actual > maxDiffLines) {
+      exceeded.push({ limit: 'max_diff_lines', actual, max: maxDiffLines });
+    }
+  }
+
+  return { ok: exceeded.length === 0, exceeded };
+}
+
+/**
+ * Feedback de reparo/rollback injetado na próxima iteração após violação
+ * (REQ-6). Texto direto para o agente: reverter os paths e permanecer no escopo.
+ */
+function buildRollbackFeedback(violations) {
+  const lines = violations.slice(0, 10).map((v) => `  - ${v.path} (${v.reason})`);
+  return [
+    'SCOPE VIOLATION — files were changed outside the contract scope:',
+    ...lines,
+    'Revert these changes (git checkout -- <path> / delete untracked files) and redo the task touching ONLY files inside the allowed scope.'
+  ].join('\n');
+}
+
+module.exports = {
+  checkScope,
+  checkDiffLimits,
+  countDiffLines,
+  buildRollbackFeedback
+};

package/src/i18n/messages/en.js

@@ -182,14 +182,14 @@ module.exports = {
       'aioson plan [path] [--sub=show|status|checkpoint|stale|register] [--feature=<slug>] [--phase=<N>] [--locale=en]',
     help_squad_plan:
       'aioson squad:plan [path] [--sub=show|status|checkpoint|stale|register] [--squad=<slug>] [--round=<N>] [--locale=en]',
-    help_squad_learning:
-      'aioson squad:learning [path] [--sub=list|stats|archive|promote|export] [--squad=<slug>] [--status=<status>] [--locale=en]',
-    help_agent_audit:
-      'aioson agent:audit [path] [--runtime-only|--template-only|--inception] [--locales] [--verbose] [--fix] [--json] [--locale=en]',
-    help_quality_audit:
-      'aioson quality:audit [path] [--feature=<slug>] [--provider-output=<path>] [--baseline=<path>] [--changed=<path[,path]>] [--json] [--locale=en]',
-    help_squad_dashboard:
-      'aioson squad:dashboard [path] [--port=4180] [--squad=<slug>] [--locale=en]',
+    help_squad_learning:
+      'aioson squad:learning [path] [--sub=list|stats|archive|promote|export] [--squad=<slug>] [--status=<status>] [--locale=en]',
+    help_agent_audit:
+      'aioson agent:audit [path] [--runtime-only|--template-only|--inception] [--locales] [--verbose] [--fix] [--json] [--locale=en]',
+    help_quality_audit:
+      'aioson quality:audit [path] [--feature=<slug>] [--provider-output=<path>] [--baseline=<path>] [--changed=<path[,path]>] [--json] [--locale=en]',
+    help_squad_dashboard:
+      'aioson squad:dashboard [path] [--port=4180] [--squad=<slug>] [--locale=en]',
     help_squad_worker:
       'aioson squad:worker [path] [--sub=list|run|test|logs|scaffold] [--squad=<slug>] [--worker=<slug>] [--input=<json>] [--locale=en]',
     help_squad_daemon:
@@ -203,7 +203,7 @@ module.exports = {
     help_commit_prepare:
       'aioson commit:prepare [path] [--staged-only] [--agent-safe] [--mode=guarded|trusted|headless] [--json] [--locale=en]',
     help_learning:
-      'aioson learning [path] [--sub=list|stats|promote|import-from-claude] [--status=<status>] [--id=<learning-id>] [--project-hash=<hash>] [--dry-run] [--select=<n[,n]|all>] [--locale=en]',
+      'aioson learning [path] [--sub=list|stats|promote|import-from-claude] [--status=<status>] [--id=<learning-id>] [--project-hash=<hash>] [--dry-run] [--select=<n[,n]|all>] [--locale=en]',
     help_runtime_init:
       'aioson runtime:init [path] [--json] [--locale=en]',
     help_runtime_ingest:
@@ -222,12 +222,12 @@ module.exports = {
       'aioson runtime:task:fail [path] --task=<key> [--goal=<text>] [--json] [--locale=en]',
     help_runtime_fail:
       'aioson runtime:fail [path] --run=<key> [--message=<text>] [--summary=<text>] [--output=<path>] [--json] [--locale=en]',
-    help_runtime_status:
-      'aioson runtime:status [path] [--json] [--locale=en]',
-    help_agent_recover:
-      'aioson agent:recover [path] [--dry-run] [--older-than=<24h|7d>] [--json] [--locale=en]',
-    help_runtime_log:
-      'aioson runtime:log [path] --agent=<name> --message=<text> [--type=<event>] [--finish] [--status=completed|failed] [--summary=<text>] [--title=<task-title>] [--json] [--locale=en]',
+    help_runtime_status:
+      'aioson runtime:status [path] [--json] [--locale=en]',
+    help_agent_recover:
+      'aioson agent:recover [path] [--dry-run] [--older-than=<24h|7d>] [--json] [--locale=en]',
+    help_runtime_log:
+      'aioson runtime:log [path] --agent=<name> --message=<text> [--type=<event>] [--finish] [--status=completed|failed] [--summary=<text>] [--title=<task-title>] [--json] [--locale=en]',
     help_runtime_session_start:
       'aioson runtime:session:start [path] --agent=<name> [--title=<text>] [--message=<text>] [--session=<key>] [--json] [--locale=en]',
     help_runtime_session_log:
@@ -258,10 +258,10 @@ module.exports = {
       'aioson skill:install [path] --slug=<name> [--from=npm|cloud|./path] [--force] [--json] [--locale=en]',
     help_skill_list:
       'aioson skill:list [path] [--json] [--locale=en]',
-    help_skill_remove:
-      'aioson skill:remove [path] --slug=<name> [--json] [--locale=en]',
-    help_skill_audit:
-      'aioson skill:audit [path] [--json] [--locale=en]',
+    help_skill_remove:
+      'aioson skill:remove [path] --slug=<name> [--json] [--locale=en]',
+    help_skill_audit:
+      'aioson skill:audit [path] [--json] [--locale=en]',
     help_design_hybrid_options:
       'aioson design-hybrid:options [path] [--advanced] [--json] [--locale=en]',
     help_cloud_import_squad:
@@ -450,6 +450,8 @@ module.exports = {
     bootstrap_coverage_hint_seed: 'Run /discover to seed .aioson/context/bootstrap/{what-is,how-it-works,what-it-does,current-state}.md',
     features_dir_present: 'Features directory present (.aioson/context/features/)',
     features_dir_present_hint: 'Create .aioson/context/features/ to host per-feature dossiers (doctor --fix will create it).',
+    auto_handoff_declared: 'Autopilot handoff flag declared (auto_handoff in project.context.md)',
+    auto_handoff_declared_hint: 'The autopilot-handoff protocol is installed but auto_handoff is not set in project.context.md frontmatter — autopilot stays inactive. Set auto_handoff: true to enable it, or auto_handoff: false to silence this warning.',
     claude_commands_present: 'Claude slash commands present ({missing} missing of {required})',
     claude_commands_present_hint: 'Missing: {paths}. Run `aioson doctor . --fix` to restore them from the template.',
     version_drift: 'CLI version matches project.context.md (context: {context}, CLI: {cli})',
@@ -735,7 +737,7 @@ module.exports = {
       'dApp context detected; include Web3 skills during @architect and @dev.',
     note_micro_scope: 'Keep implementation scope minimal and avoid optional agents.',
     note_product_optional: '@product is optional for MICRO — skip it and go straight to @dev if the idea is already clear.',
-    note_feature_flow: 'New feature workflow (after initial setup): @product → @analyst → @scope-check → @dev → @qa. No @setup required.'
+    note_feature_flow: 'New feature workflow (after initial setup): @product → @analyst → @scope-check → @dev → @qa. No @setup required.'
   },
   workflow_next: {
     title: 'Workflow handoff for {mode} ({classification}):',
@@ -1135,6 +1137,7 @@ module.exports = {
     session_already_active: 'Live session already active: {agent} | session: {session} | run: {runKey} ({dbPath})',
     session_started: 'Live session started: {agent} | tool: {tool} | session: {session} ({dbPath})',
     event_recorded: 'Live event recorded: {agent} | {eventType} | {session} ({dbPath})',
+    standalone_event_recorded: 'Standalone runtime event recorded: {agent} | {eventType} | run: {runKey} ({dbPath})',
     handoff_recorded: 'Live handoff recorded: {from} -> {to} | {session} ({dbPath})',
     session_closed: 'Live session closed: {agent} | {session} ({dbPath})',
     process_dead_warning: 'Process is dead while the live session is still open. Close it manually with `aioson live:close . --status=failed`.',
@@ -1209,7 +1212,7 @@ module.exports = {
     folder_required_example_prompt:
       '  Ready prompt    : aioson agent:prompt analyst --tool=codex',
     folder_required_example_next:
-      '  Workflow after full scan: @analyst -> @scope-check -> @architect -> @dev',
+      '  Workflow after full scan: @analyst -> @scope-check -> @architect -> @dev',
     folder_not_found: 'Folder "{folder}" was not found in this project. Top-level directories detected: {available}',
     config_missing: '{file} not found. To use LLM mode, copy aioson-models.json and fill in your API keys.',
     config_invalid: 'Invalid JSON in aioson-models.json: {error}',

package/src/i18n/messages/es.js

@@ -160,12 +160,12 @@ module.exports = {
       'aioson squad:pipeline [path] [--sub=list|show|status] [--pipeline=<slug>] [--locale=es]',
     help_squad_investigate:
       'aioson squad:investigate [path] [--sub=list|show|score|link|register] [--investigation=<slug>] [--squad=<slug>] [--locale=es]',
-    help_squad_learning:
-      'aioson squad:learning [path] [--sub=list|stats|archive|promote|export] [--squad=<slug>] [--status=<status>] [--locale=es]',
-    help_quality_audit:
-      'aioson quality:audit [path] [--feature=<slug>] [--provider-output=<path>] [--baseline=<path>] [--changed=<path[,path]>] [--json] [--locale=es]',
-    help_squad_dashboard:
-      'aioson squad:dashboard [path] [--port=4180] [--squad=<slug>] [--locale=es]',
+    help_squad_learning:
+      'aioson squad:learning [path] [--sub=list|stats|archive|promote|export] [--squad=<slug>] [--status=<status>] [--locale=es]',
+    help_quality_audit:
+      'aioson quality:audit [path] [--feature=<slug>] [--provider-output=<path>] [--baseline=<path>] [--changed=<path[,path]>] [--json] [--locale=es]',
+    help_squad_dashboard:
+      'aioson squad:dashboard [path] [--port=4180] [--squad=<slug>] [--locale=es]',
     help_squad_worker:
       'aioson squad:worker [path] [--sub=list|run|test|logs|scaffold] [--squad=<slug>] [--worker=<slug>] [--input=<json>] [--locale=es]',
     help_squad_daemon:
@@ -179,7 +179,7 @@ module.exports = {
     help_commit_prepare:
       'aioson commit:prepare [path] [--staged-only] [--agent-safe] [--mode=guarded|trusted|headless] [--json] [--locale=es]',
     help_learning:
-      'aioson learning [path] [--sub=list|stats|promote|import-from-claude] [--status=<status>] [--id=<learning-id>] [--project-hash=<hash>] [--dry-run] [--select=<n[,n]|all>] [--locale=es]',
+      'aioson learning [path] [--sub=list|stats|promote|import-from-claude] [--status=<status>] [--id=<learning-id>] [--project-hash=<hash>] [--dry-run] [--select=<n[,n]|all>] [--locale=es]',
     dashboard_moved:
       'El flujo `{command}` fue eliminado del CLI. El dashboard de AIOSON ahora se instala por separado. Abre la app del dashboard en tu computadora, crea o agrega un proyecto y selecciona la carpeta que ya contiene `.aioson/`.',
     dashboard_moved_line: '{message}\n',
@@ -324,6 +324,8 @@ module.exports = {
     bootstrap_coverage_hint_seed: 'Ejecute /discover para sembrar .aioson/context/bootstrap/{what-is,how-it-works,what-it-does,current-state}.md',
     features_dir_present: 'Directorio de features presente (.aioson/context/features/)',
     features_dir_present_hint: 'Cree .aioson/context/features/ para hospedar dossiers por feature (doctor --fix lo crea).',
+    auto_handoff_declared: 'Flag de autopilot handoff declarada (auto_handoff en project.context.md)',
+    auto_handoff_declared_hint: 'El protocolo autopilot-handoff esta instalado pero auto_handoff no esta definido en el frontmatter de project.context.md — el autopilot queda inactivo. Defina auto_handoff: true para activarlo, o auto_handoff: false para silenciar este aviso.',
     claude_commands_present: 'Slash commands de Claude presentes ({missing} ausentes de {required})',
     claude_commands_present_hint: 'Ausentes: {paths}. Ejecute `aioson doctor . --fix` para restaurarlos.',
     version_drift: 'Version del CLI coincide con project.context.md (contexto: {context}, CLI: {cli})',
@@ -609,7 +611,7 @@ module.exports = {
     note_product_optional:
       '@product es opcional para MICRO — omitelo y ve directo a @dev si la idea ya esta clara.',
     note_feature_flow:
-      'Flujo para nueva feature (tras la configuracion inicial): @product → @analyst → @scope-check → @dev → @qa. Sin @setup.'
+      'Flujo para nueva feature (tras la configuracion inicial): @product → @analyst → @scope-check → @dev → @qa. Sin @setup.'
   },
   parallel_init: {
     context_missing:
@@ -1020,7 +1022,7 @@ module.exports = {
     folder_required_example_prompt:
       '  Prompt listo    : aioson agent:prompt analyst --tool=codex',
     folder_required_example_next:
-      '  Flujo tras escaneo completo: @analyst -> @scope-check -> @architect -> @dev',
+      '  Flujo tras escaneo completo: @analyst -> @scope-check -> @architect -> @dev',
     folder_not_found: 'La carpeta "{folder}" no existe en este proyecto. Directorios de nivel superior detectados: {available}',
     config_missing: '{file} no encontrado. Para usar el modo con LLM, copia aioson-models.json y completa tus claves de API.',
     config_invalid: 'JSON invalido en aioson-models.json: {error}',