@jaimevalasek/aioson 1.19.0 → 1.21.0

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [1.21.0] - 2026-06-XX
+
+### Added
+- **Gemini CLI deprecation warning (gemini-phaseout Phase 1).** Google announced (2026-05-20) that the Gemini CLI free/personal tier ends 2026-06-18.
+  - `install-wizard` now flags Gemini as `[DEPRECATED]` in the tool list and prints a post-selection notice when Gemini is chosen.
+  - `doctor` reports `harness:gemini_deprecation` (warning) when `.gemini/permissions.toml` or `.gemini/GEMINI.md` is detected — zero output on projects without `.gemini/`.
+  - `permissions-generator` continues to emit `.gemini/permissions.toml` with a header warning (enterprise unaffected).
+  - `tool-capabilities` Gemini entry annotated as deprecated.
+  - Warning strings localized in all 4 locales (en, pt-BR, es, fr).
+  - Enterprise users (Code Assist Standard/Enterprise) are unaffected.
+  - Hard removal scheduled for v1.22 (post 2026-06-18). Pre-existing `.gemini/permissions.toml` will be preserved.
+  - Recommended migration: `--tool=codex` or `--tool=opencode`.
+
 ## [1.18.0] - 2026-05-27
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaimevalasek/aioson",
-  "version": "1.19.0",
+  "version": "1.21.0",
   "description": "AI operating framework for hyper-personalized software.",
   "keywords": [
     "ai",

package/src/cli.js

@@ -188,7 +188,7 @@ const { runOpShow } = require('./commands/op-show');
 const { runOpReinforce } = require('./commands/op-reinforce');
 const { runOpMigrate } = require('./commands/op-migrate');
 const { runFeatureClose } = require('./commands/feature-close');
-const { runFeatureArchive } = require('./commands/feature-archive');
+const { runFeatureArchive, runFeatureSweep } = require('./commands/feature-archive');
 const { runDossierInit, runDossierShow, runDossierAddFinding, runDossierAddCodemap, runDossierLinkRule, runDossierCompact } = require('./commands/dossier');
 const { runDossierAddResearch } = require('./commands/dossier-add-research');
 const { runDossierAudit } = require('./commands/dossier-audit');
@@ -620,6 +620,8 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'feature-close',
   'feature:archive',
   'feature-archive',
+  'feature:sweep',
+  'feature-sweep',
   'dossier:init',
   'dossier-init',
   'dossier:show',
@@ -1480,7 +1482,13 @@ async function main() {
     } else if (command === 'feature:close' || command === 'feature-close') {
       result = await runFeatureClose({ args, options, logger: commandLogger });
     } else if (command === 'feature:archive' || command === 'feature-archive') {
-      result = await runFeatureArchive({ args, options, logger: commandLogger });
+      if (options.sweep) {
+        result = await runFeatureSweep({ args, options, logger: commandLogger });
+      } else {
+        result = await runFeatureArchive({ args, options, logger: commandLogger });
+      }
+    } else if (command === 'feature:sweep' || command === 'feature-sweep') {
+      result = await runFeatureSweep({ args, options, logger: commandLogger });
     } else if (command === 'dossier:init' || command === 'dossier-init') {
       result = await runDossierInit({ args, options, logger: commandLogger });
     } else if (command === 'dossier:show' || command === 'dossier-show') {

package/src/commands/feature-archive.js

@@ -270,19 +270,42 @@ async function runFeatureArchive({ args = [], options = {}, logger }) {
   const otherSlugs = await readOtherSlugs(featuresPath, slug);
   const rootFiles = await findSlugFiles(ctxDir, slug, otherSlugs);
   const alreadyArchived = (await dirExists(archiveDir)) ? await findArchivedFiles(archiveDir) : [];
-  const dossierSourceDir = path.join(ctxDir, 'features', slug);
-  const dossierTargetDir = path.join(archiveDir, 'dossier');
-  const hasDossierToMove = await dirExists(dossierSourceDir);
-  const dossierAlreadyArchived = await dirExists(dossierTargetDir);
+
+  const SLUG_DIRS = [
+    { label: 'dossier', sourceBase: path.join(ctxDir, 'features'), archiveLabel: 'dossier' },
+    { label: 'plans', sourceBase: path.join(targetDir, '.aioson', 'plans'), archiveLabel: 'plans' },
+    { label: 'briefings', sourceBase: path.join(targetDir, '.aioson', 'briefings'), archiveLabel: 'briefings' }
+  ];
+
+  const dirPlans = [];
+  for (const dir of SLUG_DIRS) {
+    const sourceDir = path.join(dir.sourceBase, slug);
+    const targetDirPath = path.join(archiveDir, dir.archiveLabel);
+    const hasSource = await dirExists(sourceDir);
+    const alreadyDone = await dirExists(targetDirPath);
+    if (hasSource || alreadyDone) {
+      dirPlans.push({
+        label: dir.label,
+        sourceDir,
+        targetDir: targetDirPath,
+        sourceBase: dir.sourceBase,
+        action: hasSource
+          ? (alreadyDone ? 'skip' : 'move')
+          : (alreadyDone ? 'noop' : null),
+        reason: alreadyDone ? 'already_archived' : null
+      });
+    }
+  }
+
+  const hasAnyDir = dirPlans.some((d) => d.action === 'move' || d.action === 'skip' || d.action === 'noop');
 
   if (
     rootFiles.length === 0 &&
     alreadyArchived.length === 0 &&
-    !hasDossierToMove &&
-    !dossierAlreadyArchived
+    !hasAnyDir
   ) {
     if (jsonOut) return { ok: true, slug, moved: [], skipped: [], alreadyArchived: [], noop: true };
-    log(`No files matched "*-${slug}.{${ARCHIVED_EXTENSIONS.join(',')}}" in .aioson/context/ root and no features/${slug}/ dossier dir — nothing to archive.`);
+    log(`No files matched "*-${slug}.{${ARCHIVED_EXTENSIONS.join(',')}}" in .aioson/context/ root and no slug directories found — nothing to archive.`);
     return { ok: true, noop: true };
   }
 
@@ -305,11 +328,16 @@ async function runFeatureArchive({ args = [], options = {}, logger }) {
     : null;
   const summary = summarySource ? await extractSummary(summarySource) : null;
 
-  const dossierPlan = hasDossierToMove
-    ? (dossierAlreadyArchived ? { action: 'skip', reason: 'already_archived' } : { action: 'move' })
-    : (dossierAlreadyArchived ? { action: 'noop', reason: 'already_archived' } : null);
-
   if (dryRun) {
+    const dirs = dirPlans
+      .filter((d) => d.action)
+      .map((d) => ({
+        label: d.label,
+        source: path.relative(targetDir, d.sourceDir),
+        target: path.relative(targetDir, d.targetDir),
+        action: d.action,
+        reason: d.reason
+      }));
     const result = {
       ok: true,
       dryRun: true,
@@ -317,13 +345,7 @@ async function runFeatureArchive({ args = [], options = {}, logger }) {
       targetDir: path.relative(targetDir, archiveDir),
       move: toMove,
       skip: toSkip,
-      dossier: dossierPlan
-        ? {
-            source: path.relative(targetDir, dossierSourceDir),
-            target: path.relative(targetDir, dossierTargetDir),
-            ...dossierPlan
-          }
-        : null,
+      dirs,
       manifestEntry: {
         slug,
         completed,
@@ -340,10 +362,12 @@ async function runFeatureArchive({ args = [], options = {}, logger }) {
       log(`  would skip: ${toSkip.length} file(s)`);
       for (const s of toSkip) log(`    • ${s.name} (${s.reason})`);
     }
-    if (dossierPlan && dossierPlan.action === 'move') {
-      log(`  would move dossier dir: features/${slug}/ → ${path.relative(targetDir, dossierTargetDir)}/`);
-    } else if (dossierPlan && dossierPlan.action === 'skip') {
-      log(`  would skip dossier dir: already archived at ${path.relative(targetDir, dossierTargetDir)}/`);
+    for (const d of dirPlans) {
+      if (d.action === 'move') {
+        log(`  would move ${d.label} dir: ${path.relative(targetDir, d.sourceDir)}/ → ${path.relative(targetDir, d.targetDir)}/`);
+      } else if (d.action === 'skip') {
+        log(`  would skip ${d.label} dir: already archived at ${path.relative(targetDir, d.targetDir)}/`);
+      }
     }
     log(`  manifest entry: | ${slug} | ${completed} | ${toMove.length + alreadyArchived.length} | ${summary || '—'} |`);
     return result;
@@ -359,27 +383,29 @@ async function runFeatureArchive({ args = [], options = {}, logger }) {
     moved.push(name);
   }
 
-  let dossierResult = null;
-  if (dossierPlan && dossierPlan.action === 'move') {
-    await fs.rename(dossierSourceDir, dossierTargetDir);
-    dossierResult = {
-      action: 'moved',
-      source: path.relative(targetDir, dossierSourceDir),
-      target: path.relative(targetDir, dossierTargetDir)
-    };
-    try {
-      const parent = path.join(ctxDir, 'features');
-      const remaining = await fs.readdir(parent);
-      if (remaining.length === 0) await fs.rmdir(parent);
-    } catch {
-      // parent missing or non-empty — leave it
+  const dirResults = [];
+  for (const d of dirPlans) {
+    if (d.action === 'move') {
+      await fs.mkdir(path.dirname(d.targetDir), { recursive: true });
+      await fs.rename(d.sourceDir, d.targetDir);
+      dirResults.push({
+        label: d.label,
+        action: 'moved',
+        source: path.relative(targetDir, d.sourceDir),
+        target: path.relative(targetDir, d.targetDir)
+      });
+      try {
+        const remaining = await fs.readdir(d.sourceBase);
+        if (remaining.length === 0) await fs.rmdir(d.sourceBase);
+      } catch { /* parent missing or non-empty */ }
+    } else if (d.action === 'skip') {
+      dirResults.push({
+        label: d.label,
+        action: 'skipped',
+        reason: d.reason,
+        target: path.relative(targetDir, d.targetDir)
+      });
     }
-  } else if (dossierPlan && dossierPlan.action === 'skip') {
-    dossierResult = {
-      action: 'skipped',
-      reason: dossierPlan.reason,
-      target: path.relative(targetDir, dossierTargetDir)
-    };
   }
 
   const totalArchived = (await findArchivedFiles(archiveDir)).length;
@@ -399,7 +425,8 @@ async function runFeatureArchive({ args = [], options = {}, logger }) {
     moved,
     skipped: toSkip,
     totalArchived,
-    dossier: dossierResult,
+    dirs: dirResults.length > 0 ? dirResults : undefined,
+    dossier: dirResults.find((d) => d.label === 'dossier') || null,
     manifestEntry: entry
   };
 
@@ -412,10 +439,12 @@ async function runFeatureArchive({ args = [], options = {}, logger }) {
     log(`  skipped: ${toSkip.length} file(s) already in archive`);
     for (const s of toSkip) log(`    • ${s.name}`);
   }
-  if (dossierResult && dossierResult.action === 'moved') {
-    log(`  moved dossier dir: ${dossierResult.source}/ → ${dossierResult.target}/`);
-  } else if (dossierResult && dossierResult.action === 'skipped') {
-    log(`  skipped dossier dir: already archived at ${dossierResult.target}/`);
+  for (const d of dirResults) {
+    if (d.action === 'moved') {
+      log(`  moved ${d.label} dir: ${d.source}/ → ${d.target}/`);
+    } else if (d.action === 'skipped') {
+      log(`  skipped ${d.label} dir: already archived at ${d.target}/`);
+    }
   }
   log(`  manifest updated: .aioson/context/done/MANIFEST.md`);
   return result;
@@ -510,4 +539,92 @@ async function runRestore({ slug, ctxDir, archiveDir, manifestPath, dryRun, json
   return result;
 }
 
-module.exports = { runFeatureArchive };
+async function listDoneFeatures(featuresPath) {
+  const content = await readFileSafe(featuresPath);
+  if (!content) return [];
+  const results = [];
+  const lines = content.split(/\r?\n/);
+  for (const line of lines) {
+    const m = line.match(/^\|\s*([a-z][a-z0-9-]*)\s*\|\s*done\s*\|/i);
+    if (m) results.push(m[1].toLowerCase());
+  }
+  return results;
+}
+
+async function listArchivedSlugs(manifestPath) {
+  const content = await readFileSafe(manifestPath);
+  if (!content) return new Set();
+  const slugs = new Set();
+  const lines = content.split(/\r?\n/);
+  for (const line of lines) {
+    const m = line.match(/^\|\s*([a-z][a-z0-9-]+)\s*\|/i);
+    if (m && m[1] !== 'slug') slugs.add(m[1].toLowerCase());
+  }
+  return slugs;
+}
+
+async function runFeatureSweep({ args = [], options = {}, logger }) {
+  const targetDir = path.resolve(process.cwd(), args[0] || '.');
+  const dryRun = Boolean(options['dry-run'] || options.dryRun);
+  const jsonOut = Boolean(options.json);
+  const log = (msg) => { if (logger && !jsonOut) logger.log(msg); };
+
+  const ctxDir = contextDir(targetDir);
+  if (!(await dirExists(ctxDir))) {
+    if (jsonOut) return { ok: false, reason: 'no_context_dir' };
+    log('.aioson/context/ not found. Run aioson setup first.');
+    return { ok: false };
+  }
+
+  const featuresPath = path.join(ctxDir, 'features.md');
+  const manifestPath = path.join(ctxDir, 'done', 'MANIFEST.md');
+
+  const doneSlugs = await listDoneFeatures(featuresPath);
+  const archivedSlugs = await listArchivedSlugs(manifestPath);
+  const pending = doneSlugs.filter((s) => !archivedSlugs.has(s));
+
+  if (pending.length === 0) {
+    const result = { ok: true, pending: [], archived: [] };
+    if (jsonOut) return result;
+    log('All done features are already archived.');
+    return result;
+  }
+
+  if (dryRun) {
+    const result = { ok: true, dryRun: true, pending, archived: [] };
+    if (jsonOut) return result;
+    log(`[dry-run] ${pending.length} done feature(s) not yet archived:`);
+    for (const s of pending) log(`  • ${s}`);
+    return result;
+  }
+
+  const archived = [];
+  const failed = [];
+  for (const slug of pending) {
+    try {
+      const archiveResult = await runFeatureArchive({
+        args: [targetDir],
+        options: { feature: slug, json: true },
+        logger: null
+      });
+      if (archiveResult && archiveResult.ok) {
+        const movedCount = archiveResult.moved ? archiveResult.moved.length : 0;
+        archived.push({ slug, moved: movedCount });
+        log(`  ✓ ${slug} — ${movedCount} file(s) archived`);
+      } else {
+        failed.push({ slug, reason: archiveResult.reason || 'unknown' });
+        log(`  ✗ ${slug} — ${archiveResult.reason || 'unknown'}`);
+      }
+    } catch (err) {
+      failed.push({ slug, reason: err.message || String(err) });
+      log(`  ✗ ${slug} — ${err.message || err}`);
+    }
+  }
+
+  const result = { ok: true, pending, archived, failed: failed.length > 0 ? failed : undefined };
+  if (jsonOut) return result;
+  log(`\nSweep complete: ${archived.length} archived, ${failed.length} failed.`);
+  return result;
+}
+
+module.exports = { runFeatureArchive, runFeatureSweep };

package/src/commands/install.js

@@ -147,6 +147,11 @@ async function runInstall({ args, options, logger, t }) {
     logger.log(t('install.existing_project_scan_hint'));
   }
 
+  if (installProfile && Array.isArray(installProfile.tools) && installProfile.tools.includes('gemini')) {
+    logger.log('');
+    logger.log(t('install.gemini_deprecation_notice'));
+  }
+
   return {
     ok: true,
     targetDir,

package/src/doctor.js

@@ -241,6 +241,23 @@ async function runDoctor(targetDir) {
     });
   }
 
+  // Gemini CLI deprecation advisory (gemini-phaseout Phase 1 / v1.21.0).
+  // Emits ONLY when the project actually uses Gemini (.gemini/permissions.toml
+  // OR .gemini/GEMINI.md present) so greenfield projects stay silent (BR-GP-03).
+  const geminiInUse =
+    (await exists(path.join(targetDir, '.gemini/permissions.toml'))) ||
+    (await exists(path.join(targetDir, '.gemini/GEMINI.md')));
+  if (geminiInUse) {
+    checks.push({
+      id: 'harness:gemini_deprecation',
+      severity: 'warning',
+      key: 'doctor.gemini_deprecation',
+      params: {},
+      ok: false,
+      hintKey: 'doctor.gemini_deprecation_hint'
+    });
+  }
+
   const contextPath = path.join(targetDir, '.aioson/context/project.context.md');
   checks.push({
     id: 'context:project',

package/src/i18n/messages/en.js

@@ -327,6 +327,7 @@ module.exports = {
     files_skipped: 'Files skipped: {count}',
     dry_run_header: '⚠  DRY RUN — no files were written. Showing what install would do:',
     dry_run_done_at: 'DRY RUN: nothing was written to {targetDir}',
+    gemini_deprecation_notice: '[DEPRECATED] Gemini CLI free/personal tier will be discontinued on 2026-06-18. Consider Codex or OpenCode for new projects. Enterprise (Code Assist Standard/Enterprise) continues to work.',
     dry_run_files_copied: 'Files that would be copied: {count}',
     dry_run_files_skipped: 'Files that would be skipped: {count}',
     next_steps: 'Next steps:',
@@ -399,6 +400,9 @@ module.exports = {
     context_conversation_language_format: '`conversation_language` is not a valid BCP-47 tag',
     context_conversation_language_format_hint: 'Use values like en, en-US, pt-BR.',
     node_version: 'Node.js >= 18 (current: {version})',
+    gemini_deprecation: 'Gemini CLI in use - free tier ends 2026-06-18 (enterprise unaffected)',
+    gemini_deprecation_hint:
+      'Run `aioson permissions-generator --tool=codex` (or --tool=opencode) to migrate. Enterprise (Code Assist Standard/Enterprise) keeps working; pre-existing .gemini/permissions.toml is preserved.',
     gateway_claude_pointer: 'CLAUDE gateway references shared AIOSON files',
     gateway_claude_pointer_hint:
       'Ensure CLAUDE.md references .aioson/config.md and .aioson/agents/setup.md.',

package/src/i18n/messages/es.js

@@ -198,6 +198,7 @@ module.exports = {
     files_skipped: 'Archivos omitidos: {count}',
     dry_run_header: '⚠  DRY RUN — no se escribio ningun archivo. Mostrando lo que haria el install:',
     dry_run_done_at: 'DRY RUN: no se escribio nada en {targetDir}',
+    gemini_deprecation_notice: '[DEPRECATED] El tier gratuito/personal de Gemini CLI se descontinuara el 2026-06-18. Considera Codex u OpenCode para nuevos proyectos. Enterprise (Code Assist Standard/Enterprise) sigue funcionando.',
     dry_run_files_copied: 'Archivos que se copiarian (would be copied): {count}',
     dry_run_files_skipped: 'Archivos que se omitirian (would be skipped): {count}',
     next_steps: 'Siguientes pasos:',
@@ -278,6 +279,9 @@ module.exports = {
     context_conversation_language_format: '`conversation_language` no es una etiqueta BCP-47 valida',
     context_conversation_language_format_hint: 'Usa valores como en, en-US, pt-BR.',
     node_version: 'Node.js >= 18 (actual: {version})',
+    gemini_deprecation: 'Gemini CLI en uso - el tier gratuito termina el 2026-06-18 (enterprise no afectado)',
+    gemini_deprecation_hint:
+      'Ejecuta `aioson permissions-generator --tool=codex` (o --tool=opencode) para migrar. Enterprise (Code Assist Standard/Enterprise) sigue funcionando; el .gemini/permissions.toml preexistente se conserva.',
     gateway_claude_pointer: 'El gateway de CLAUDE referencia archivos compartidos de AIOSON',
     gateway_claude_pointer_hint:
       'Asegura que CLAUDE.md referencie .aioson/config.md y .aioson/agents/setup.md.',

package/src/i18n/messages/fr.js

@@ -198,6 +198,7 @@ module.exports = {
     files_skipped: 'Fichiers ignores : {count}',
     dry_run_header: '⚠  DRY RUN — aucun fichier ecrit. Apercu de ce que install ferait :',
     dry_run_done_at: 'DRY RUN : rien n a ete ecrit dans {targetDir}',
+    gemini_deprecation_notice: '[DEPRECATED] Le palier gratuit/personnel de Gemini CLI sera supprime le 2026-06-18. Envisagez Codex ou OpenCode pour les nouveaux projets. Enterprise (Code Assist Standard/Enterprise) continue de fonctionner.',
     dry_run_files_copied: 'Fichiers qui seraient copies (would be copied) : {count}',
     dry_run_files_skipped: 'Fichiers qui seraient ignores (would be skipped) : {count}',
     next_steps: 'Etapes suivantes :',
@@ -277,6 +278,9 @@ module.exports = {
     context_conversation_language_format: '`conversation_language` n est pas une balise BCP-47 valide',
     context_conversation_language_format_hint: 'Utilisez des valeurs comme en, en-US, pt-BR.',
     node_version: 'Node.js >= 18 (actuel : {version})',
+    gemini_deprecation: 'Gemini CLI utilise - le palier gratuit se termine le 2026-06-18 (enterprise non affecte)',
+    gemini_deprecation_hint:
+      'Lancez `aioson permissions-generator --tool=codex` (ou --tool=opencode) pour migrer. Enterprise (Code Assist Standard/Enterprise) continue de fonctionner; le .gemini/permissions.toml preexistant est conserve.',
     gateway_claude_pointer: 'La passerelle CLAUDE reference les fichiers partages AIOSON',
     gateway_claude_pointer_hint:
       'Assurez-vous que CLAUDE.md reference .aioson/config.md et .aioson/agents/setup.md.',

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

@@ -292,6 +292,7 @@ module.exports = {
     files_skipped: 'Arquivos ignorados: {count}',
     dry_run_header: '⚠  DRY RUN — nenhum arquivo foi escrito. Mostrando o que o install faria:',
     dry_run_done_at: 'DRY RUN: nada foi escrito em {targetDir}',
+    gemini_deprecation_notice: '[DEPRECATED] O tier free/pessoal do Gemini CLI sera descontinuado em 2026-06-18. Considere Codex ou OpenCode para novos projetos. Enterprise (Code Assist Standard/Enterprise) continua funcionando.',
     dry_run_files_copied: 'Arquivos que seriam copiados (would be copied): {count}',
     dry_run_files_skipped: 'Arquivos que seriam ignorados (would be skipped): {count}',
     next_steps: 'Proximos passos:',
@@ -372,6 +373,9 @@ module.exports = {
       '`conversation_language` nao e uma tag BCP-47 valida',
     context_conversation_language_format_hint: 'Use valores como en, en-US, pt-BR.',
     node_version: 'Node.js >= 18 (atual: {version})',
+    gemini_deprecation: 'Gemini CLI em uso - tier free encerra em 2026-06-18 (enterprise nao afetado)',
+    gemini_deprecation_hint:
+      'Rode `aioson permissions-generator --tool=codex` (ou --tool=opencode) para migrar. Enterprise (Code Assist Standard/Enterprise) continua funcionando; .gemini/permissions.toml pre-existente e preservado.',
     gateway_claude_pointer: 'Gateway do CLAUDE referencia arquivos compartilhados do AIOSON',
     gateway_claude_pointer_hint:
       'Garanta que CLAUDE.md referencie .aioson/config.md e .aioson/agents/setup.md.',

package/src/install-wizard.js

@@ -6,7 +6,7 @@ const { getCliVersionSync } = require('./version');
 const TOOLS = [
   { id: 'claude',    label: 'Claude Code',    desc: 'Slash commands, CLAUDE.md, .claude/' },
   { id: 'codex',    label: 'Codex (OpenAI)', desc: 'AGENTS.md protocol' },
-  { id: 'gemini',   label: 'Gemini CLI',     desc: 'GEMINI.md + .gemini/commands/' },
+  { id: 'gemini',   label: 'Gemini CLI',     desc: 'GEMINI.md + .gemini/commands/', deprecated: true },
   { id: 'opencode', label: 'OpenCode',       desc: 'OPENCODE.md protocol' }
 ];
 
@@ -112,7 +112,8 @@ function renderScreen1(cursor, selected, warn, stdout) {
     const tool    = TOOLS[i];
     const pointer = i === cursor ? '►' : ' ';
     const check   = selected.has(tool.id) ? '✓' : ' ';
-    stdout.write(`  ${pointer} [${check}] ${tool.label.padEnd(20)} ${tool.desc}\n`);
+    const deprNote = tool.deprecated ? '  ⚠ [DEPRECATED] free tier ends 2026-06-18' : '';
+    stdout.write(`  ${pointer} [${check}] ${tool.label.padEnd(20)} ${tool.desc}${deprNote}\n`);
   }
   if (warn) stdout.write('\n  ⚠  Select at least one tool to continue.\n');
   stdout.write('\n');

package/src/lib/tool-capabilities.js

@@ -5,11 +5,11 @@
 // "continue last conversation" is achieved by passing the right resume flag
 // at spawn time — AIOSON never has to track an internal session ID.
 //
-// Used by:
-//   - `aioson live:start --resume[=last|<id>]` to map to the correct argv
-//   - `aioson live:start --permission-mode=yolo` to map to the correct argv
-//   - `aioson tool:capabilities` to expose this map as JSON to UI clients
-//     (e.g. AIOSON Play) so they don't duplicate the lookup.
+// Used by:
+//   - `aioson live:start --resume[=last|<id>]` to map to the correct argv
+//   - `aioson live:start --permission-mode=yolo` to map to the correct argv
+//   - `aioson tool:capabilities` to expose this map as JSON to UI clients
+//     (e.g. AIOSON Play) so they don't duplicate the lookup.
 //
 // Keep entries minimal and source-of-truth here. Adding a new CLI = one entry.
 const TOOL_CAPS = {
@@ -18,50 +18,53 @@ const TOOL_CAPS = {
     binary: 'claude',
     supports_resume: true,
     resume_last: ['--continue'],
-    supports_session_id: true,
-    resume_session_id: ['--resume', '<id>'],
-    supports_session_picker: true,
-    session_picker: ['--resume'],
-    supports_yolo: true,
-    yolo_args: ['--dangerously-skip-permissions'],
-  },
-  codex: {
+    supports_session_id: true,
+    resume_session_id: ['--resume', '<id>'],
+    supports_session_picker: true,
+    session_picker: ['--resume'],
+    supports_yolo: true,
+    yolo_args: ['--dangerously-skip-permissions'],
+  },
+  codex: {
     install_command: 'npm install -g @openai/codex',
     binary: 'codex',
     supports_resume: true,
     resume_last: ['resume', '--last'],
-    supports_session_id: true,
-    resume_session_id: ['resume', '<id>'],
-    supports_session_picker: true,
-    session_picker: ['resume'],
-    supports_yolo: true,
-    yolo_args: ['--dangerously-bypass-approvals-and-sandbox'],
-  },
-  opencode: {
+    supports_session_id: true,
+    resume_session_id: ['resume', '<id>'],
+    supports_session_picker: true,
+    session_picker: ['resume'],
+    supports_yolo: true,
+    yolo_args: ['--dangerously-bypass-approvals-and-sandbox'],
+  },
+  opencode: {
     install_command: 'npm install -g opencode-ai',
     binary: 'opencode',
     supports_resume: true,
     resume_last: ['--continue'],
-    supports_session_id: true,
-    resume_session_id: ['--session', '<id>'],
-    supports_session_picker: false,
-    session_picker: null,
-    supports_yolo: false,
-    yolo_args: null,
-  },
-  gemini: {
+    supports_session_id: true,
+    resume_session_id: ['--session', '<id>'],
+    supports_session_picker: false,
+    session_picker: null,
+    supports_yolo: false,
+    yolo_args: null,
+  },
+  // DEPRECATED: Gemini CLI free/personal tier ends 2026-06-18. Enterprise
+  // (Code Assist Standard/Enterprise) unaffected. Hard removal in v1.22.
+  // See gemini-phaseout / CHANGELOG v1.21.x.
+  gemini: {
     install_command: 'npm install -g @google/gemini-cli',
     binary: 'gemini',
     supports_resume: false,
     resume_last: null,
-    supports_session_id: false,
-    resume_session_id: null,
-    supports_session_picker: false,
-    session_picker: null,
-    supports_yolo: false,
-    yolo_args: null,
-  },
-};
+    supports_session_id: false,
+    resume_session_id: null,
+    supports_session_picker: false,
+    session_picker: null,
+    supports_yolo: false,
+    yolo_args: null,
+  },
+};
 
 function getToolCapabilities(tool) {
   const key = String(tool || '').trim().toLowerCase();
@@ -80,7 +83,7 @@ function listSupportedTools() {
 //   - '' / undefined / null / false → no resume
 //   - any other string → treat as session id
 // Returns [] when the tool doesn't support resume or resumeOpt is falsy.
-function resolveResumeArgs(tool, resumeOpt) {
+function resolveResumeArgs(tool, resumeOpt) {
   if (resumeOpt === undefined || resumeOpt === null || resumeOpt === '' || resumeOpt === false) {
     return [];
   }
@@ -101,29 +104,29 @@ function resolveResumeArgs(tool, resumeOpt) {
   }
 
   return Array.isArray(caps.resume_last) ? [...caps.resume_last] : [];
-}
-
-function resolvePermissionModeArgs(tool, permissionMode) {
-  const mode = String(permissionMode || '').trim().toLowerCase();
-  if (!mode || mode === 'default') return [];
-  if (mode !== 'yolo') {
-    throw new Error(`permission_mode_unknown:${permissionMode}`);
-  }
-
-  const caps = getToolCapabilities(tool);
-  if (!caps) {
-    throw new Error(`tool_unknown:${tool}`);
-  }
-  if (!caps.supports_yolo || !Array.isArray(caps.yolo_args)) {
-    throw new Error(`permission_mode_unsupported:${tool}:yolo`);
-  }
-  return [...caps.yolo_args];
-}
-
-module.exports = {
-  TOOL_CAPS,
-  getToolCapabilities,
-  listSupportedTools,
-  resolveResumeArgs,
-  resolvePermissionModeArgs,
-};
+}
+
+function resolvePermissionModeArgs(tool, permissionMode) {
+  const mode = String(permissionMode || '').trim().toLowerCase();
+  if (!mode || mode === 'default') return [];
+  if (mode !== 'yolo') {
+    throw new Error(`permission_mode_unknown:${permissionMode}`);
+  }
+
+  const caps = getToolCapabilities(tool);
+  if (!caps) {
+    throw new Error(`tool_unknown:${tool}`);
+  }
+  if (!caps.supports_yolo || !Array.isArray(caps.yolo_args)) {
+    throw new Error(`permission_mode_unsupported:${tool}:yolo`);
+  }
+  return [...caps.yolo_args];
+}
+
+module.exports = {
+  TOOL_CAPS,
+  getToolCapabilities,
+  listSupportedTools,
+  resolveResumeArgs,
+  resolvePermissionModeArgs,
+};

package/src/permissions-generator.js

@@ -195,6 +195,9 @@ function tomlString(value) {
 function buildGeminiToml({ shellPatterns, aiosonCommands, denyShellPatterns = [], denyAiosonCommands = [] }, tool) {
   const lines = [];
   lines.push('# Generated by aioson permissions-generator. Do not edit by hand.');
+  lines.push('# WARNING: Gemini CLI free tier ends 2026-06-18. This file remains');
+  lines.push('# functional for enterprise users (Code Assist Standard/Enterprise).');
+  lines.push('# See AIOSON CHANGELOG v1.21.x for migration guidance.');
   lines.push('version = "1.1"');
   lines.push(`mode = ${tomlString(tool.mode || 'guarded')}`);
   lines.push(`requires_tty = ${Boolean(tool.requires_tty)}`);

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

@@ -228,6 +228,8 @@ Before the first code change, decide which dev docs must be loaded:
 
 Do not preload these docs if the current slice does not need them.
 
+Before touching code, if `aioson` is available, run `aioson feature:sweep . --dry-run --json` to detect done features not yet archived. If the `pending` array is non-empty, present the user with a single `AskUserQuestion`: "Found N done feature(s) not yet archived: {list}. Archive now?" with options "(Recomendado) Sim, arquivar agora" and "Não, seguir sem arquivar". If yes, run `aioson feature:sweep .` and report the result. This step is advisory — never block session start.
+
 ## Execution invariants
 
 These rules apply even if no extra dev doc was loaded:

package/template/.aioson/agents/deyvin.md

@@ -90,6 +90,7 @@ Run this after the immediate scope gate and before touching code:
 6. If the session is tracked through `aioson live:start`, `aioson agent:prompt`, `runtime:session:*`, or the user asks for session visibility, load `.aioson/docs/deyvin/runtime-handoffs.md`
 7. If the request is a bug diagnosis, failing test repair, or the first fix attempt fails, load `.aioson/docs/deyvin/debugging-escalation.md`
 8. Do not touch code until all required modules have been loaded
+9. If `aioson` is available, run `aioson feature:sweep . --dry-run --json` to detect done features not yet archived. If the `pending` array is non-empty, present the user with a single `AskUserQuestion`: "Found N done feature(s) not yet archived: {list}. Archive now?" with options "(Recomendado) Sim, arquivar agora" and "Não, seguir sem arquivar". If yes, run `aioson feature:sweep .` and report the result. This step is advisory — never block session start.
 
 ## Working kernel