@jaimevalasek/aioson 1.21.8 → 1.22.0

package/src/i18n/messages/en.js

@@ -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})',

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}',

package/src/i18n/messages/fr.js

@@ -160,12 +160,12 @@ module.exports = {
       'aioson squad:pipeline [path] [--sub=list|show|status] [--pipeline=<slug>] [--locale=fr]',
     help_squad_investigate:
       'aioson squad:investigate [path] [--sub=list|show|score|link|register] [--investigation=<slug>] [--squad=<slug>] [--locale=fr]',
-    help_squad_learning:
-      'aioson squad:learning [path] [--sub=list|stats|archive|promote|export] [--squad=<slug>] [--status=<status>] [--locale=fr]',
-    help_quality_audit:
-      'aioson quality:audit [path] [--feature=<slug>] [--provider-output=<path>] [--baseline=<path>] [--changed=<path[,path]>] [--json] [--locale=fr]',
-    help_squad_dashboard:
-      'aioson squad:dashboard [path] [--port=4180] [--squad=<slug>] [--locale=fr]',
+    help_squad_learning:
+      'aioson squad:learning [path] [--sub=list|stats|archive|promote|export] [--squad=<slug>] [--status=<status>] [--locale=fr]',
+    help_quality_audit:
+      'aioson quality:audit [path] [--feature=<slug>] [--provider-output=<path>] [--baseline=<path>] [--changed=<path[,path]>] [--json] [--locale=fr]',
+    help_squad_dashboard:
+      'aioson squad:dashboard [path] [--port=4180] [--squad=<slug>] [--locale=fr]',
     help_squad_worker:
       'aioson squad:worker [path] [--sub=list|run|test|logs|scaffold] [--squad=<slug>] [--worker=<slug>] [--input=<json>] [--locale=fr]',
     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=fr]',
     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=fr]',
+      '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=fr]',
     dashboard_moved:
       'Le flux `{command}` a été supprimé du CLI. Le dashboard AIOSON est désormais installé séparément. Ouvrez l application dashboard sur votre ordinateur, créez ou ajoutez un projet, puis sélectionnez le dossier qui contient déjà `.aioson/`.',
     dashboard_moved_line: '{message}\n',
@@ -323,6 +323,8 @@ module.exports = {
     bootstrap_coverage_hint_seed: 'Executez /discover pour creer .aioson/context/bootstrap/{what-is,how-it-works,what-it-does,current-state}.md',
     features_dir_present: 'Repertoire features present (.aioson/context/features/)',
     features_dir_present_hint: 'Creez .aioson/context/features/ pour heberger les dossiers par feature (doctor --fix le cree).',
+    auto_handoff_declared: 'Flag autopilot handoff declare (auto_handoff dans project.context.md)',
+    auto_handoff_declared_hint: 'Le protocole autopilot-handoff est installe mais auto_handoff n\'est pas defini dans le frontmatter de project.context.md — l\'autopilot reste inactif. Definissez auto_handoff: true pour l\'activer, ou auto_handoff: false pour faire taire cet avertissement.',
     claude_commands_present: 'Slash commands de Claude presents ({missing} absents sur {required})',
     claude_commands_present_hint: 'Absents : {paths}. Executez `aioson doctor . --fix` pour les restaurer.',
     version_drift: 'Version du CLI conforme a project.context.md (contexte : {context}, CLI : {cli})',
@@ -612,7 +614,7 @@ module.exports = {
     note_product_optional:
       '@product est optionnel pour MICRO — passez directement a @dev si l idee est deja claire.',
     note_feature_flow:
-      'Flux nouvelle feature (apres configuration initiale) : @product → @analyst → @scope-check → @dev → @qa. Pas de @setup.'
+      'Flux nouvelle feature (apres configuration initiale) : @product → @analyst → @scope-check → @dev → @qa. Pas de @setup.'
   },
   parallel_init: {
     context_missing:
@@ -1028,7 +1030,7 @@ module.exports = {
     folder_required_example_prompt:
       '  Prompt pret     : aioson agent:prompt analyst --tool=codex',
     folder_required_example_next:
-      '  Workflow apres scan complet : @analyst -> @scope-check -> @architect -> @dev',
+      '  Workflow apres scan complet : @analyst -> @scope-check -> @architect -> @dev',
     folder_not_found: 'Le dossier "{folder}" est introuvable dans ce projet. Dossiers de premier niveau detectes : {available}',
     config_missing: '{file} introuvable. Pour utiliser le mode LLM, copiez aioson-models.json et renseignez vos cles API.',
     config_invalid: 'JSON invalide dans aioson-models.json : {error}',

package/src/i18n/messages/pt-BR.js

@@ -424,6 +424,8 @@ module.exports = {
     bootstrap_coverage_hint_seed: 'Rode /discover para criar .aioson/context/bootstrap/{what-is,how-it-works,what-it-does,current-state}.md',
     features_dir_present: 'Diretorio de features presente (.aioson/context/features/)',
     features_dir_present_hint: 'Crie .aioson/context/features/ para hospedar dossies por feature (doctor --fix cria automaticamente).',
+    auto_handoff_declared: 'Flag de autopilot handoff declarada (auto_handoff no project.context.md)',
+    auto_handoff_declared_hint: 'O protocolo autopilot-handoff esta instalado mas auto_handoff nao esta definido no frontmatter do project.context.md — o autopilot fica inativo. Defina auto_handoff: true para ativar, ou auto_handoff: false para silenciar este aviso.',
     claude_commands_present: 'Slash commands do Claude presentes ({missing} ausentes de {required})',
     claude_commands_present_hint: 'Ausentes: {paths}. Rode `aioson doctor . --fix` para restaurar a partir do template.',
     version_drift: 'Versao do CLI bate com project.context.md (contexto: {context}, CLI: {cli})',

package/src/lib/dev-resume.js

@@ -49,34 +49,34 @@ function readClassificationFromFrontmatters(rawList) {
   return null;
 }
 
-function extractDevStateFields(raw) {
-  if (!raw) return { active_feature: null, active_phase: null, next_step: null, status: null };
-  const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!fmMatch) return { active_feature: null, active_phase: null, next_step: null, status: null };
-  const fm = {};
-  for (const line of fmMatch[1].split(/\r?\n/)) {
+function extractDevStateFields(raw) {
+  if (!raw) return { active_feature: null, active_phase: null, next_step: null, status: null };
+  const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!fmMatch) return { active_feature: null, active_phase: null, next_step: null, status: null };
+  const fm = {};
+  for (const line of fmMatch[1].split(/\r?\n/)) {
     const idx = line.indexOf(':');
     if (idx === -1) continue;
     const key = line.slice(0, idx).trim();
     const val = line.slice(idx + 1).trim().replace(/^["']|["']$/g, '');
     fm[key] = val;
-  }
-  return {
-    active_feature: fm.active_feature || null,
-    active_phase: fm.active_phase || null,
-    next_step: fm.next_step || null,
-    status: fm.status || null
-  };
-}
-
-function isCurrentDevStateForFeature(fields, featureSlug) {
-  if (!fields) return false;
-  if (!fields.active_feature) return false;
-  const status = String(fields.status || '').toLowerCase();
-  if (status === 'done' || status === 'abandoned') return false;
-  if (fields.active_feature !== featureSlug) return false;
-  return true;
-}
+  }
+  return {
+    active_feature: fm.active_feature || null,
+    active_phase: fm.active_phase || null,
+    next_step: fm.next_step || null,
+    status: fm.status || null
+  };
+}
+
+function isCurrentDevStateForFeature(fields, featureSlug) {
+  if (!fields) return false;
+  if (!fields.active_feature) return false;
+  const status = String(fields.status || '').toLowerCase();
+  if (status === 'done' || status === 'abandoned') return false;
+  if (fields.active_feature !== featureSlug) return false;
+  return true;
+}
 
 function extractCodeMapPaths(dossierRaw) {
   if (!dossierRaw) return [];
@@ -91,6 +91,42 @@ function extractCodeMapPaths(dossierRaw) {
   return Array.from(new Set(paths));
 }
 
+function readCorrectionsStatus(raw) {
+  const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  // No frontmatter or no status field: treat as open — a corrections plan
+  // must never be silently skipped because of a malformed header.
+  if (!fmMatch) return 'open';
+  for (const line of fmMatch[1].split(/\r?\n/)) {
+    const m = line.match(/^status:\s*([^#]*)/);
+    if (m) {
+      const val = m[1].trim().replace(/^["']|["']$/g, '').toLowerCase();
+      return val || 'open';
+    }
+  }
+  return 'open';
+}
+
+async function listOpenCorrections(targetDir, featureSlug) {
+  const planDir = path.join(targetDir, '.aioson', 'plans', featureSlug);
+  let entries;
+  try {
+    entries = await fs.readdir(planDir);
+  } catch (err) {
+    if (err && err.code === 'ENOENT') return [];
+    throw err;
+  }
+  const out = [];
+  for (const name of entries.filter((n) => /^corrections-.+\.md$/.test(n)).sort()) {
+    const raw = await readFileOrNull(path.join(planDir, name));
+    if (!raw) continue;
+    const status = readCorrectionsStatus(raw);
+    if (status === 'open' || status === 'in_progress') {
+      out.push(`.aioson/plans/${featureSlug}/${name}`);
+    }
+  }
+  return out;
+}
+
 function deriveNextStepFromPlan(planRaw) {
   if (!planRaw) return null;
   const lines = planRaw.split('\n');
@@ -121,12 +157,12 @@ async function buildDevResumeData(projectPath) {
   const specRaw = await readFileOrNull(path.join(ctxDir, `spec-${featureSlug}.md`));
   const classification = readClassificationFromFrontmatters([dossierRaw, prdRaw, specRaw]);
 
-  const devStateRaw = await readFileOrNull(path.join(ctxDir, 'dev-state.md'));
-  const devStateFields = extractDevStateFields(devStateRaw);
-  const useDevState = isCurrentDevStateForFeature(devStateFields, featureSlug);
-
-  const planManifestPath = path.join(targetDir, '.aioson', 'plans', featureSlug, 'manifest.md');
-  const planRaw = await readFileOrNull(planManifestPath);
+  const devStateRaw = await readFileOrNull(path.join(ctxDir, 'dev-state.md'));
+  const devStateFields = extractDevStateFields(devStateRaw);
+  const useDevState = isCurrentDevStateForFeature(devStateFields, featureSlug);
+
+  const planManifestPath = path.join(targetDir, '.aioson', 'plans', featureSlug, 'manifest.md');
+  const planRaw = await readFileOrNull(planManifestPath);
   const sheldonPlan = planRaw ? `.aioson/plans/${featureSlug}/manifest.md` : null;
 
   const artifactsConsumed = Array.isArray(lastHandoff && lastHandoff.artifact_uris)
@@ -137,22 +173,35 @@ async function buildDevResumeData(projectPath) {
     ? lastHandoff.decision_rationale
     : [];
 
+  // QA corrections plans with status open/in_progress take precedence over any
+  // persisted next_step: a stale dev-state pointer must not hide mandatory
+  // corrections from a fresh @dev session (loop-guardrails incident, 2026-06-09).
+  const openCorrections = await listOpenCorrections(targetDir, featureSlug);
+  const baseNextStep = useDevState && devStateFields.next_step
+    ? devStateFields.next_step
+    : deriveNextStepFromPlan(planRaw);
+
   return {
-    feature_slug: featureSlug,
-    classification,
-    current_phase: useDevState && devStateFields.active_phase ? devStateFields.active_phase : 'unknown',
-    artifacts_consumed: artifactsConsumed,
-    code_map_paths: extractCodeMapPaths(dossierRaw),
-    sheldon_plan: sheldonPlan,
-    next_step: useDevState && devStateFields.next_step ? devStateFields.next_step : deriveNextStepFromPlan(planRaw),
-    decision_rationale: decisionRationale.length > 0 ? decisionRationale : undefined
-  };
-}
+    feature_slug: featureSlug,
+    classification,
+    current_phase: useDevState && devStateFields.active_phase ? devStateFields.active_phase : 'unknown',
+    artifacts_consumed: artifactsConsumed,
+    code_map_paths: extractCodeMapPaths(dossierRaw),
+    sheldon_plan: sheldonPlan,
+    next_step: openCorrections.length > 0
+      ? `Apply mandatory corrections from ${openCorrections[0]}, then return to @qa for re-verification`
+      : baseNextStep,
+    open_corrections: openCorrections.length > 0 ? openCorrections : undefined,
+    decision_rationale: decisionRationale.length > 0 ? decisionRationale : undefined
+  };
+}
 
 module.exports = {
-  buildDevResumeData,
-  extractDevStateFields,
-  isCurrentDevStateForFeature,
-  extractCodeMapPaths,
-  deriveNextStepFromPlan
-};
+  buildDevResumeData,
+  extractDevStateFields,
+  isCurrentDevStateForFeature,
+  extractCodeMapPaths,
+  deriveNextStepFromPlan,
+  readCorrectionsStatus,
+  listOpenCorrections
+};

package/src/preflight-engine.js

@@ -225,9 +225,9 @@ async function scanActiveManifest(targetDir, slug) {
 async function scanArtifacts(targetDir, slug) {
   const dir = contextDir(targetDir);
 
-  async function check(name, filePath) {
-    const stat = await fileStat(filePath);
-    if (!stat) return { exists: false };
+  async function check(name, filePath) {
+    const stat = await fileStat(filePath);
+    if (!stat) return { exists: false };
 
     const content = await readFileSafe(filePath);
     const fm = content ? parseFrontmatter(content) : {};
@@ -237,37 +237,37 @@ async function scanArtifacts(targetDir, slug) {
       path: path.relative(targetDir, filePath),
       size: stat.size,
       frontmatter: fm,
-      content
-    };
-  }
-
-  async function checkFirst(name, filePaths) {
-    for (const filePath of filePaths) {
-      const result = await check(name, filePath);
-      if (result.exists) return result;
-    }
-    return { exists: false };
-  }
-
-  const designDocCandidates = slug
-    ? [path.join(dir, `design-doc-${slug}.md`), path.join(dir, 'design-doc.md')]
-    : [path.join(dir, 'design-doc.md')];
-  const readinessCandidates = slug
-    ? [path.join(dir, `readiness-${slug}.md`), path.join(dir, 'readiness.md')]
-    : [path.join(dir, 'readiness.md')];
-
-  const results = {
-    project_context: await check('project.context', path.join(dir, 'project.context.md')),
-    prd: slug ? await check('prd', path.join(dir, `prd-${slug}.md`)) : { exists: false },
-    sheldon_enrichment: slug ? await check('sheldon', path.join(dir, `sheldon-enrichment-${slug}.md`)) : { exists: false },
-    requirements: slug ? await check('requirements', path.join(dir, `requirements-${slug}.md`)) : { exists: false },
-    spec: slug ? await check('spec', path.join(dir, `spec-${slug}.md`)) : await check('spec', path.join(dir, 'spec.md')),
-    architecture: await check('architecture', path.join(dir, 'architecture.md')),
-    design_doc: await checkFirst('design-doc', designDocCandidates),
-    readiness: await checkFirst('readiness', readinessCandidates),
-    implementation_plan: slug ? await check('impl-plan', path.join(dir, `implementation-plan-${slug}.md`)) : { exists: false },
-    conformance: slug ? await check('conformance', path.join(dir, `conformance-${slug}.yaml`)) : { exists: false },
-    dev_state: await check('dev-state', path.join(dir, 'dev-state.md')),
+      content
+    };
+  }
+
+  async function checkFirst(name, filePaths) {
+    for (const filePath of filePaths) {
+      const result = await check(name, filePath);
+      if (result.exists) return result;
+    }
+    return { exists: false };
+  }
+
+  const designDocCandidates = slug
+    ? [path.join(dir, `design-doc-${slug}.md`), path.join(dir, 'design-doc.md')]
+    : [path.join(dir, 'design-doc.md')];
+  const readinessCandidates = slug
+    ? [path.join(dir, `readiness-${slug}.md`), path.join(dir, 'readiness.md')]
+    : [path.join(dir, 'readiness.md')];
+
+  const results = {
+    project_context: await check('project.context', path.join(dir, 'project.context.md')),
+    prd: slug ? await check('prd', path.join(dir, `prd-${slug}.md`)) : { exists: false },
+    sheldon_enrichment: slug ? await check('sheldon', path.join(dir, `sheldon-enrichment-${slug}.md`)) : { exists: false },
+    requirements: slug ? await check('requirements', path.join(dir, `requirements-${slug}.md`)) : { exists: false },
+    spec: slug ? await check('spec', path.join(dir, `spec-${slug}.md`)) : await check('spec', path.join(dir, 'spec.md')),
+    architecture: await check('architecture', path.join(dir, 'architecture.md')),
+    design_doc: await checkFirst('design-doc', designDocCandidates),
+    readiness: await checkFirst('readiness', readinessCandidates),
+    implementation_plan: slug ? await check('impl-plan', path.join(dir, `implementation-plan-${slug}.md`)) : { exists: false },
+    conformance: slug ? await check('conformance', path.join(dir, `conformance-${slug}.yaml`)) : { exists: false },
+    dev_state: await check('dev-state', path.join(dir, 'dev-state.md')),
     features: await check('features', path.join(dir, 'features.md'))
   };
 
@@ -362,19 +362,19 @@ async function readProjectPulse(targetDir) {
 // ─── Classification reader ────────────────────────────────────────────────────
 
 async function detectClassification(targetDir, slug) {
-  // 1. Try project context
-  const ctx = await loadProjectContext(targetDir);
-  if (ctx.data.classification) return ctx.data.classification.toUpperCase();
-
-  // 2. Try spec frontmatter
+  // Feature classification takes precedence over the project classification —
+  // same contract as resolveClassification (handoff-contract.js) and
+  // workflow:next sequencing. A SMALL feature inside a MEDIUM project must be
+  // gated as SMALL; the project value is only the fallback.
   if (slug) {
+    // 1. Try spec frontmatter
     const specContent = await readFileSafe(path.join(contextDir(targetDir), `spec-${slug}.md`));
     if (specContent) {
       const fm = parseFrontmatter(specContent);
       if (fm.classification) return fm.classification.toUpperCase();
     }
 
-    // 3. Try PRD frontmatter
+    // 2. Try PRD frontmatter
     const prdContent = await readFileSafe(path.join(contextDir(targetDir), `prd-${slug}.md`));
     if (prdContent) {
       const fm = parseFrontmatter(prdContent);
@@ -382,6 +382,10 @@ async function detectClassification(targetDir, slug) {
     }
   }
 
+  // 3. Fall back to project context
+  const ctx = await loadProjectContext(targetDir);
+  if (ctx.data.classification) return ctx.data.classification.toUpperCase();
+
   return null;
 }
 
@@ -464,15 +468,15 @@ async function discoverDesignDocs(targetDir, agent) {
 
 // ─── Context package builder ──────────────────────────────────────────────────
 
-function buildContextPackage(agent, slug, classification, artifacts, devState, manifest) {
-  const pkg = [];
-  const designDoc = artifacts.design_doc || { exists: false };
-  const readiness = artifacts.readiness || { exists: false };
-
-  if (artifacts.project_context.exists) pkg.push(artifacts.project_context.path);
+function buildContextPackage(agent, slug, classification, artifacts, devState, manifest) {
+  const pkg = [];
+  const designDoc = artifacts.design_doc || { exists: false };
+  const readiness = artifacts.readiness || { exists: false };
+
+  if (artifacts.project_context.exists) pkg.push(artifacts.project_context.path);
 
   if (slug) {
-    const downstreamAgents = ['discovery-design-doc', 'pm', 'orchestrator', 'dev', 'deyvin', 'qa'];
+    const downstreamAgents = ['discovery-design-doc', 'pm', 'orchestrator', 'dev', 'deyvin', 'qa'];
     const shouldCarryFullFeatureContext = downstreamAgents.includes(agent);
 
     if (shouldCarryFullFeatureContext && artifacts.prd.exists) pkg.push(artifacts.prd.path);
@@ -483,10 +487,10 @@ function buildContextPackage(agent, slug, classification, artifacts, devState, m
 
     if (artifacts.spec.exists) pkg.push(artifacts.spec.path);
 
-    if (shouldCarryFullFeatureContext && artifacts.architecture.exists) pkg.push(artifacts.architecture.path);
-    if (shouldCarryFullFeatureContext && designDoc.exists) pkg.push(designDoc.path);
-    if (shouldCarryFullFeatureContext && readiness.exists) pkg.push(readiness.path);
-    if (shouldCarryFullFeatureContext && artifacts.conformance.exists) pkg.push(artifacts.conformance.path);
+    if (shouldCarryFullFeatureContext && artifacts.architecture.exists) pkg.push(artifacts.architecture.path);
+    if (shouldCarryFullFeatureContext && designDoc.exists) pkg.push(designDoc.path);
+    if (shouldCarryFullFeatureContext && readiness.exists) pkg.push(readiness.path);
+    if (shouldCarryFullFeatureContext && artifacts.conformance.exists) pkg.push(artifacts.conformance.path);
 
     // Manifest precedence (AC-SDLC-24, AC-SDLC-25):
     // If active Sheldon manifest exists and is not done, it is the primary execution artifact.
@@ -608,11 +612,11 @@ function parseFeaturesMap(content) {
 
 // ─── Readiness evaluator ─────────────────────────────────────────────────────
 
-function evaluateReadiness(artifacts, phaseGates, classification, agent, devState, slug) {
-  const blockers = [];
-  const warnings = [];
-  const designDoc = artifacts.design_doc || { exists: false };
-  const readiness = artifacts.readiness || { exists: false };
+function evaluateReadiness(artifacts, phaseGates, classification, agent, devState, slug) {
+  const blockers = [];
+  const warnings = [];
+  const designDoc = artifacts.design_doc || { exists: false };
+  const readiness = artifacts.readiness || { exists: false };
 
   if (!artifacts.project_context.exists) blockers.push('project.context.md missing');
 
@@ -625,11 +629,11 @@ function evaluateReadiness(artifacts, phaseGates, classification, agent, devStat
     }
   }
 
-  if (agent === 'analyst') {
-    if (slug && !artifacts.prd.exists) {
-      warnings.push('prd file missing — feature is not framed yet; @analyst may run project discovery/research only, or hand off to @product/@briefing to create prd-{slug}.md before formal feature requirements');
-    }
-  }
+  if (agent === 'analyst') {
+    if (slug && !artifacts.prd.exists) {
+      warnings.push('prd file missing — feature is not framed yet; @analyst may run project discovery/research only, or hand off to @product/@briefing to create prd-{slug}.md before formal feature requirements');
+    }
+  }
 
   if (agent === 'architect') {
     if (!artifacts.requirements.exists) {
@@ -637,25 +641,25 @@ function evaluateReadiness(artifacts, phaseGates, classification, agent, devStat
     }
   }
 
-  if (agent === 'pm') {
+  if (agent === 'pm') {
     if (!artifacts.architecture.exists) {
       blockers.push('architecture.md missing — @architect must complete design first (Gate B)');
     }
     if (!artifacts.requirements.exists) {
       warnings.push('requirements file missing — @pm should review it before writing the implementation plan');
     }
-  }
-
-  if (agent === 'discovery-design-doc') {
-    if (!artifacts.architecture.exists) {
-      blockers.push('architecture.md missing — @architect must complete design first (Gate B)');
-    }
-    if (!designDoc.exists) {
-      warnings.push('design-doc.md missing — @discovery-design-doc must create the project baseline before implementation');
-    }
-  }
-
-  if (agent === 'orchestrator') {
+  }
+
+  if (agent === 'discovery-design-doc') {
+    if (!artifacts.architecture.exists) {
+      blockers.push('architecture.md missing — @architect must complete design first (Gate B)');
+    }
+    if (!designDoc.exists) {
+      warnings.push('design-doc.md missing — @discovery-design-doc must create the project baseline before implementation');
+    }
+  }
+
+  if (agent === 'orchestrator') {
     if (!artifacts.requirements.exists) {
       blockers.push('requirements file missing — Gate A not satisfied');
     }
@@ -673,16 +677,16 @@ function evaluateReadiness(artifacts, phaseGates, classification, agent, devStat
     }
   }
 
-  if (agent === 'dev' || agent === 'deyvin') {
-    if (!artifacts.spec.exists) blockers.push('spec file missing');
-    if (classification && classification !== 'MICRO') {
-      if (!designDoc.exists) {
-        blockers.push('design-doc.md missing — @discovery-design-doc must run before implementation');
-      }
-      if (!readiness.exists) {
-        blockers.push('readiness.md missing — @discovery-design-doc must run before implementation');
-      }
-    }
+  if (agent === 'dev' || agent === 'deyvin') {
+    if (!artifacts.spec.exists) blockers.push('spec file missing');
+    if (classification && classification !== 'MICRO') {
+      if (!designDoc.exists) {
+        blockers.push('design-doc.md missing — @discovery-design-doc must run before implementation');
+      }
+      if (!readiness.exists) {
+        blockers.push('readiness.md missing — @discovery-design-doc must run before implementation');
+      }
+    }
     if (classification === 'MEDIUM') {
       const implementationPlan = artifacts.implementation_plan || { exists: false, frontmatter: {} };
       if (!implementationPlan.exists) {

package/template/.aioson/agents/analyst.md

@@ -366,6 +366,10 @@ Action: /scope-check or /architect
 ```
 > Recommended: `/clear` before activating — fresh context window.
 
+## Autopilot handoff
+
+If `auto_handoff: true` in `project.context.md` frontmatter and a feature workflow is active, follow `.aioson/docs/autopilot-handoff.md`: after Gate A is approved and all closing duties above are done, do not stop for manual activation. Determine the next agent from the workflow state (never guess) and auto-invoke `Skill(aioson:agent:<next>)` with `"continue feature {slug} — autopilot handoff from @analyst"`. No user prompt — Ctrl+C interrupts. Emit the manual handoff instead when any stop condition applies: next agent is `@dev`, Gate A not approved, context ≥ `context_warning_threshold`, or routing is ambiguous.
+
 ## Strategic commands (use during session)
 
 - Search memory before web research: `aioson memory:search . --query="<topic>" 2>/dev/null || true`

package/template/.aioson/agents/architect.md

@@ -140,6 +140,10 @@ Action: /pm or /dev
 ```
 > Recommended: `/clear` before activating — fresh context window.
 
+## Autopilot handoff
+
+If `auto_handoff: true` in `project.context.md` frontmatter, a feature workflow is active, and Gate B passed, follow `.aioson/docs/autopilot-handoff.md`: auto-invoke `Skill(aioson:agent:<next>)` for the next workflow stage with `"continue feature {slug} — autopilot handoff from @architect"`. No user prompt — Ctrl+C interrupts. Emit the manual handoff instead when Gate B is blocked, the next agent is `@dev`, or context ≥ `context_warning_threshold`.
+
 ## Rules
 - Do not redesign entities produced by `@analyst`. Consume the data design as-is.
 - Keep architecture proportional to classification. Never apply MEDIUM patterns to a MICRO project.

package/template/.aioson/agents/dev.md

@@ -152,7 +152,7 @@ If flagged, recommend a new chat and offer a handoff with slug, completed phase,
 
 Check `.aioson/context/features/{slug}/dossier.md` before per-slug PRD/spec. If present, read it FIRST — it consolidates Why/What + code map and is the canonical entry point for chained context. If absent, continue with standard input (legacy flow).
 
-**Auto-resume (session start):** `aioson dev:resume-data .` returns `{feature_slug, classification, current_phase, artifacts_consumed, code_map_paths, sheldon_plan, next_step}` or `null` (cold start). Skip discovery, start on `next_step`, then emit `aioson runtime:emit . --agent=dev --type=dev_auto_resume --summary="<feature>: phase <N> auto-resumed" 2>/dev/null || true`.
+**Auto-resume (session start):** `aioson dev:resume-data .` returns `{feature_slug, classification, current_phase, artifacts_consumed, code_map_paths, sheldon_plan, next_step, open_corrections?}` or `null` (cold start). When `open_corrections` is non-empty, those QA corrections plans are the top priority regardless of any other pointer. Skip discovery, start on `next_step`, then emit `aioson runtime:emit . --agent=dev --type=dev_auto_resume --summary="<feature>: phase <N> auto-resumed" 2>/dev/null || true`.
 
 **Drift detection (prompt-driven):** before modifying/creating a file, check if its path is in `code_map_paths`. If registered AND your change diverges from the upstream plan, or a Sheldon plan step already ran without an Agent Trail entry → DRIFT. On DRIFT: emit `aioson runtime:emit . --agent=dev --type=dev_drift_detected --summary="Drift detected: {what}" 2>/dev/null || true`, give the user 3 options (proceed/revise/abort), record `dossier:add-finding --section="Agent Trail" --content="DRIFT: {what}. Decision. Reason."`.
 
@@ -285,6 +285,8 @@ Run `aioson` CLI yourself to keep the workflow moving:
 
 If `.aioson/runtime/qa-dev-cycle.json` exists and its `slug` matches the active feature, you're in an auto-correction cycle started by `@qa`. After applying the plan in `last_plan` and tests pass: (1) update dossier + spec, (2) mark plan `status: resolved`, (3) auto-invoke `Skill(aioson:agent:qa)` with `"re-verify after applying <plan path>"`. No user prompt — Ctrl+C interrupts. If the file is absent or slug differs, manual handoff as before.
 
+**Safety net — open corrections without the cycle file:** on every activation with an active feature, also check `.aioson/plans/{active-feature}/corrections-*.md`. If any has frontmatter `status: open` or `in_progress`, those mandatory corrections take priority over the dev-state `next_step` — apply them first, mark the plan `resolved`, then hand off to `@qa` for re-verification. `aioson dev:resume-data` surfaces them as `open_corrections` and already rewrites `next_step` accordingly; trust that over a stale dev-state pointer. This covers QA sessions that created a corrections plan but failed to persist the trail.
+
 ## Optional scope drift checkpoint
 
 After a feature slice lands, recommend optional `@scope-check --scope-mode=post-dev` before `@qa` when the implementation changed planned behavior, touched unexpected files, skipped a planned item, or required a trade-off not already captured in the design artifacts. Skip the recommendation for routine implementation that matches the approved plan.

package/template/.aioson/agents/discovery-design-doc.md

@@ -66,5 +66,9 @@ aioson dossier:add-finding . --slug={slug} --agent=discovery-design-doc --sectio
 
 Skip silently when the dossier is absent — projects without dossier still get the appropriate design-doc/readiness pair as the primary handoff.
 
+## Autopilot handoff
+
+If `auto_handoff: true` in `project.context.md` frontmatter, a feature workflow is active, and readiness is `ready` or `ready_with_warnings`, follow `.aioson/docs/autopilot-handoff.md`: auto-invoke `Skill(aioson:agent:<next>)` for the next workflow stage with `"continue feature {slug} — autopilot handoff from @discovery-design-doc"`. No user prompt — Ctrl+C interrupts. Emit the manual handoff instead when readiness is `blocked`, the next agent is `@dev` (standard handoff + recommend `/clear`), or context ≥ `context_warning_threshold`.
+
 ## Observability
 At session end, register: `aioson agent:done . --agent=discovery-design-doc --summary="Design doc <slug>: readiness=<level>, next=<agent>" 2>/dev/null || true`