aios-lite 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.4] - Unreleased
+### Added
+- New command:
+  - `aios-lite test:smoke [workspace-path] [--lang=en|pt-BR] [--keep]`
+- New smoke test suite: `tests/smoke.test.js`.
+
+### Changed
+- `doctor` now supports safe remediation mode:
+  - `aios-lite doctor --fix`
+  - `aios-lite doctor --fix --dry-run`
+- `setup:context` and setup templates now default `aios_lite_version` to `0.1.4`.
+
 ## [0.1.3] - 2026-03-01
 ### Added
 - Localized agent prompt packs:

package/README.md

@@ -15,13 +15,14 @@ npx aios-lite install
 - `aios-lite install [path]`
 - `aios-lite update [path]`
 - `aios-lite info [path]`
-- `aios-lite doctor [path]`
+- `aios-lite doctor [path] [--fix] [--dry-run]`
 - `aios-lite i18n:add <locale>`
 - `aios-lite setup:context [path]`
 - `aios-lite agents`
 - `aios-lite agent:prompt <agent> [--tool=codex|claude|gemini|opencode]`
 - `aios-lite context:validate [path]`
 - `aios-lite locale:apply [path] [--lang=en|pt-BR]`
+- `aios-lite test:smoke [workspace-path] [--lang=en|pt-BR] [--keep]`
 
 ## Agent usage helper
 If your AI CLI does not show a visual agent picker, use:
@@ -30,6 +31,8 @@ If your AI CLI does not show a visual agent picker, use:
 aios-lite agents
 aios-lite agent:prompt setup --tool=codex
 aios-lite locale:apply --lang=pt-BR
+aios-lite doctor --fix
+aios-lite test:smoke --lang=pt-BR
 ```
 
 ## i18n

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-lite",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Lightweight AI agent framework for software projects.",
   "keywords": [
     "ai",

package/src/cli.js

@@ -12,6 +12,7 @@ const { runAgentsList, runAgentPrompt } = require('./commands/agents');
 const { runContextValidate } = require('./commands/context-validate');
 const { runSetupContext } = require('./commands/setup-context');
 const { runLocaleApply } = require('./commands/locale-apply');
+const { runSmokeTest } = require('./commands/smoke');
 
 function printHelp(t) {
   console.log(`${t('cli.title')}\n`);
@@ -27,6 +28,7 @@ function printHelp(t) {
   console.log(`  ${t('cli.help_context_validate')}`);
   console.log(`  ${t('cli.help_setup_context')}`);
   console.log(`  ${t('cli.help_locale_apply')}`);
+  console.log(`  ${t('cli.help_test_smoke')}`);
 }
 
 async function main() {
@@ -90,6 +92,10 @@ async function main() {
       await runLocaleApply({ args, options, logger, t });
       return;
     }
+    if (command === 'test:smoke' || command === 'test-smoke') {
+      await runSmokeTest({ args, options, logger, t });
+      return;
+    }
 
     logger.error(`${t('cli.unknown_command', { command })}\n`);
     printHelp(t);

package/src/commands/doctor.js

@@ -1,12 +1,9 @@
 'use strict';
 
 const path = require('node:path');
-const { runDoctor } = require('../doctor');
-
-async function runDoctorCommand({ args, logger, t }) {
-  const targetDir = path.resolve(process.cwd(), args[0] || '.');
-  const report = await runDoctor(targetDir);
+const { runDoctor, applyDoctorFixes } = require('../doctor');
 
+function printDoctorChecks(report, logger, t) {
   for (const check of report.checks) {
     const icon = check.ok ? t('doctor.ok') : t('doctor.fail');
     logger.log(`[${icon}] ${t(check.key, check.params)}`);
@@ -14,6 +11,49 @@ async function runDoctorCommand({ args, logger, t }) {
       logger.log(`  ${t('doctor.hint_prefix', { hint: t(check.hintKey) })}`);
     }
   }
+}
+
+function printFixAction(action, logger, t, dryRun) {
+  logger.log(`- ${t(`doctor.fix_action_${action.id}`)}`);
+  if (action.skipped) {
+    logger.log(`  ${t('doctor.fix_not_applicable')}`);
+    return;
+  }
+  logger.log(`  ${t('doctor.fix_target_count', { count: action.missingCount || action.count || 0 })}`);
+  logger.log(
+    `  ${t(dryRun ? 'doctor.fix_planned_count' : 'doctor.fix_applied_count', {
+      count: action.count || 0
+    })}`
+  );
+  if (action.locale) {
+    logger.log(`  ${t('doctor.fix_locale', { locale: action.locale })}`);
+  }
+}
+
+async function runDoctorCommand({ args, options = {}, logger, t }) {
+  const targetDir = path.resolve(process.cwd(), args[0] || '.');
+  const fix = Boolean(options.fix);
+  const dryRun = Boolean(options['dry-run']);
+
+  let report = await runDoctor(targetDir);
+
+  if (fix) {
+    logger.log(dryRun ? t('doctor.fix_start_dry_run') : t('doctor.fix_start'));
+    const fixResult = await applyDoctorFixes(targetDir, report, { dryRun });
+    for (const action of fixResult.actions) {
+      printFixAction(action, logger, t, dryRun);
+    }
+
+    logger.log(
+      dryRun
+        ? t('doctor.fix_summary_dry_run', { count: fixResult.changedCount })
+        : t('doctor.fix_summary', { count: fixResult.changedCount })
+    );
+    logger.log('');
+    report = await runDoctor(targetDir);
+  }
+
+  printDoctorChecks(report, logger, t);
 
   if (!report.ok) {
     logger.log(`\n${t('doctor.diagnosis_fail', { count: report.failedCount })}`);

package/src/commands/setup-context.js

@@ -53,7 +53,7 @@ async function runSetupContext({ args, options, logger, t }) {
     email: resolveOption(options, 'email', ''),
     payments: resolveOption(options, 'payments', ''),
     installCommands: resolveOption(options, 'install-commands', ''),
-    aiosLiteVersion: resolveOption(options, 'aios-lite-version', '0.1.3')
+    aiosLiteVersion: resolveOption(options, 'aios-lite-version', '0.1.4')
   };
 
   let userTypesCount = Number(options['user-types'] || 1);

package/src/commands/smoke.js

@@ -0,0 +1,151 @@
+'use strict';
+
+const fs = require('node:fs/promises');
+const os = require('node:os');
+const path = require('node:path');
+const { ensureDir } = require('../utils');
+const { runInstall } = require('./install');
+const { runSetupContext } = require('./setup-context');
+const { runLocaleApply } = require('./locale-apply');
+const { runAgentsList, runAgentPrompt } = require('./agents');
+const { runContextValidate } = require('./context-validate');
+const { runDoctor } = require('../doctor');
+const { runUpdate } = require('./update');
+
+function createQuietLogger() {
+  return {
+    log() {},
+    error() {}
+  };
+}
+
+function assertStep(condition, message) {
+  if (!condition) {
+    throw new Error(message);
+  }
+}
+
+async function runSmokeTest({ args, options, logger, t }) {
+  const language = String(options.language || options.lang || 'en');
+  const keep = Boolean(options.keep);
+  const baseDir = path.resolve(process.cwd(), args[0] || os.tmpdir());
+  await ensureDir(baseDir);
+
+  const workspaceRoot = await fs.mkdtemp(path.join(baseDir, 'aios-lite-smoke-'));
+  const projectDir = path.join(workspaceRoot, 'demo');
+  await ensureDir(projectDir);
+
+  const steps = [];
+  const quietLogger = createQuietLogger();
+
+  try {
+    logger.log(t('smoke.start', { projectDir }));
+
+    const installResult = await runInstall({
+      args: [projectDir],
+      options: {},
+      logger: quietLogger,
+      t
+    });
+    assertStep(installResult.copied.length > 0, 'install copied zero files');
+    steps.push('install');
+    logger.log(t('smoke.step_ok', { step: 'install' }));
+
+    const setupResult = await runSetupContext({
+      args: [projectDir],
+      options: {
+        defaults: true,
+        'project-name': 'demo',
+        'project-type': 'web_app',
+        profile: 'developer',
+        framework: 'Node',
+        'framework-installed': true,
+        language
+      },
+      logger: quietLogger,
+      t
+    });
+    assertStep(Boolean(setupResult.filePath), 'setup:context did not write context file');
+    steps.push('setup:context');
+    logger.log(t('smoke.step_ok', { step: 'setup:context' }));
+
+    const localeResult = await runLocaleApply({
+      args: [projectDir],
+      options: { lang: language },
+      logger: quietLogger,
+      t
+    });
+    assertStep(localeResult.copied.length > 0, 'locale:apply copied zero files');
+    steps.push('locale:apply');
+    logger.log(t('smoke.step_ok', { step: 'locale:apply' }));
+
+    const agentsResult = await runAgentsList({
+      args: [projectDir],
+      options: { lang: language },
+      logger: quietLogger,
+      t
+    });
+    assertStep(agentsResult.count >= 7, 'agents command returned unexpected agent count');
+    steps.push('agents');
+    logger.log(t('smoke.step_ok', { step: 'agents' }));
+
+    const promptResult = await runAgentPrompt({
+      args: ['setup', projectDir],
+      options: { tool: 'codex', lang: language },
+      logger: quietLogger,
+      t
+    });
+    assertStep(
+      promptResult.prompt.includes('.aios-lite'),
+      'agent:prompt did not include expected path information'
+    );
+    steps.push('agent:prompt');
+    logger.log(t('smoke.step_ok', { step: 'agent:prompt' }));
+
+    const contextResult = await runContextValidate({
+      args: [projectDir],
+      options: {},
+      logger: quietLogger,
+      t
+    });
+    assertStep(contextResult.ok, 'context:validate failed');
+    steps.push('context:validate');
+    logger.log(t('smoke.step_ok', { step: 'context:validate' }));
+
+    const doctorResult = await runDoctor(projectDir);
+    assertStep(doctorResult.ok, 'doctor check failed');
+    steps.push('doctor');
+    logger.log(t('smoke.step_ok', { step: 'doctor' }));
+
+    await runUpdate({
+      args: [projectDir],
+      options: {},
+      logger: quietLogger,
+      t
+    });
+    steps.push('update');
+    logger.log(t('smoke.step_ok', { step: 'update' }));
+
+    logger.log(t('smoke.completed'));
+    logger.log(t('smoke.steps_count', { count: steps.length }));
+
+    return {
+      ok: true,
+      steps,
+      workspaceRoot,
+      projectDir,
+      kept: keep
+    };
+  } finally {
+    if (!keep) {
+      await fs.rm(workspaceRoot, { recursive: true, force: true });
+      logger.log(t('smoke.workspace_removed', { path: workspaceRoot }));
+    } else {
+      logger.log(t('smoke.workspace_kept', { path: workspaceRoot }));
+    }
+  }
+}
+
+module.exports = {
+  runSmokeTest
+};

package/src/doctor.js

@@ -2,8 +2,10 @@
 
 const path = require('node:path');
 const { REQUIRED_FILES } = require('./constants');
+const { installTemplate } = require('./installer');
 const { exists } = require('./utils');
 const { validateProjectContextFile } = require('./context');
+const { applyAgentLocale, resolveAgentLocale } = require('./locales');
 
 function parseMajor(version) {
   const cleaned = String(version || '').replace(/^v/, '');
@@ -72,7 +74,73 @@ async function runDoctor(targetDir) {
   };
 }
 
+async function applyDoctorFixes(targetDir, report, options = {}) {
+  const dryRun = Boolean(options.dryRun);
+  const actions = [];
+  let changedCount = 0;
+
+  const missingRequiredFiles = report.checks
+    .filter((check) => !check.ok && check.id.startsWith('file:'))
+    .map((check) => check.params.rel);
+
+  if (missingRequiredFiles.length > 0) {
+    const installResult = await installTemplate(targetDir, {
+      overwrite: false,
+      dryRun,
+      mode: 'install'
+    });
+    const copiedRequired = installResult.copied.filter((rel) => missingRequiredFiles.includes(rel));
+    if (copiedRequired.length > 0) changedCount += copiedRequired.length;
+    actions.push({
+      id: 'required_files',
+      applied: copiedRequired.length > 0,
+      count: copiedRequired.length,
+      missingCount: missingRequiredFiles.length
+    });
+  } else {
+    actions.push({
+      id: 'required_files',
+      applied: false,
+      skipped: true,
+      count: 0,
+      missingCount: 0
+    });
+  }
+
+  if (
+    report.contextValidation &&
+    report.contextValidation.parsed &&
+    report.contextValidation.valid &&
+    report.contextValidation.data &&
+    report.contextValidation.data.conversation_language
+  ) {
+    const locale = resolveAgentLocale(report.contextValidation.data.conversation_language);
+    const localeResult = await applyAgentLocale(targetDir, locale, { dryRun });
+    if (localeResult.copied.length > 0) changedCount += localeResult.copied.length;
+    actions.push({
+      id: 'locale_sync',
+      applied: localeResult.copied.length > 0,
+      count: localeResult.copied.length,
+      locale: localeResult.locale
+    });
+  } else {
+    actions.push({
+      id: 'locale_sync',
+      applied: false,
+      skipped: true,
+      count: 0
+    });
+  }
+
+  return {
+    dryRun,
+    actions,
+    changedCount
+  };
+}
+
 module.exports = {
   runDoctor,
-  parseMajor
+  parseMajor,
+  applyDoctorFixes
 };

package/src/i18n/messages/en.js

@@ -8,13 +8,14 @@ module.exports = {
     help_install: 'aios-lite install [path] [--force] [--dry-run] [--locale=en]',
     help_update: 'aios-lite update [path] [--dry-run] [--locale=en]',
     help_info: 'aios-lite info [path] [--locale=en]',
-    help_doctor: 'aios-lite doctor [path] [--locale=en]',
+    help_doctor: 'aios-lite doctor [path] [--fix] [--dry-run] [--locale=en]',
     help_i18n_add: 'aios-lite i18n:add <locale> [--force] [--dry-run] [--locale=en]',
     help_agents: 'aios-lite agents [path] [--lang=en|pt-BR] [--locale=en]',
     help_agent_prompt: 'aios-lite agent:prompt <agent> [path] [--tool=codex|claude|gemini|opencode] [--lang=en|pt-BR] [--locale=en]',
     help_context_validate: 'aios-lite context:validate [path] [--locale=en]',
     help_setup_context: 'aios-lite setup:context [path] [--defaults] [--project-name=...] [--language=en] [--locale=en]',
     help_locale_apply: 'aios-lite locale:apply [path] [--lang=en|pt-BR] [--dry-run] [--locale=en]',
+    help_test_smoke: 'aios-lite test:smoke [workspace-path] [--lang=en|pt-BR] [--keep] [--locale=en]',
     unknown_command: 'Unknown command: {command}',
     error_prefix: 'Error: {message}'
   },
@@ -76,7 +77,18 @@ module.exports = {
     context_profile_value_hint: 'Use developer, beginner, or team exactly.',
     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})'
+    node_version: 'Node.js >= 18 (current: {version})',
+    fix_start: 'Safe fix mode enabled.',
+    fix_start_dry_run: 'Safe fix mode enabled (dry-run).',
+    fix_action_required_files: 'Restore missing managed files from template',
+    fix_action_locale_sync: 'Synchronize active agent prompts with context language',
+    fix_not_applicable: 'Not applicable for current state.',
+    fix_target_count: 'Targets identified: {count}',
+    fix_applied_count: 'Changes applied: {count}',
+    fix_planned_count: 'Changes planned: {count}',
+    fix_locale: 'Resolved locale: {locale}',
+    fix_summary: 'Safe fix changes applied: {count}',
+    fix_summary_dry_run: '[dry-run] Safe fix changes planned: {count}'
   },
   i18n_add: {
     usage_error: 'Usage: aios-lite i18n:add <locale> [--force] [--dry-run] [--locale=en]',
@@ -133,5 +145,13 @@ module.exports = {
     dry_run_applied: '[dry-run] Locale pack would be applied: {locale}',
     copied_count: 'Files copied: {count}',
     missing_count: 'Missing locale files: {count}'
+  },
+  smoke: {
+    start: 'Running smoke test in: {projectDir}',
+    step_ok: 'OK: {step}',
+    completed: 'Smoke test completed successfully.',
+    steps_count: 'Validated steps: {count}',
+    workspace_kept: 'Workspace kept: {path}',
+    workspace_removed: 'Workspace removed: {path}'
   }
 };

package/template/.aios-lite/agents/setup.md

@@ -37,7 +37,7 @@ framework: "Laravel|Rails|Django|Next.js|Nuxt|Node|..."
 framework_installed: true
 classification: "MICRO|SMALL|MEDIUM"
 conversation_language: "en"
-aios_lite_version: "0.1.3"
+aios_lite_version: "0.1.4"
 generated_at: "ISO-8601"
 ---
 

package/template/.aios-lite/locales/en/agents/setup.md

@@ -37,7 +37,7 @@ framework: "Laravel|Rails|Django|Next.js|Nuxt|Node|..."
 framework_installed: true
 classification: "MICRO|SMALL|MEDIUM"
 conversation_language: "en"
-aios_lite_version: "0.1.3"
+aios_lite_version: "0.1.4"
 generated_at: "ISO-8601"
 ---