@jaimevalasek/aioson 1.20.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.20.0",
+  "version": "1.21.0",
   "description": "AI operating framework for hyper-personalized software.",
   "keywords": [
     "ai",

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)}`);