aios-lite 0.1.3 → 0.1.7

package/CHANGELOG.md

@@ -2,6 +2,61 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.7] - Unreleased
+### Added
+- JSON output mode (`--json`) for:
+  - `aios-lite info`
+  - `aios-lite doctor`
+  - `aios-lite context:validate`
+  - `aios-lite test:smoke`
+- New JSON output test suite: `tests/json-output.test.js`.
+
+### Changed
+- CLI now returns structured JSON errors for unknown commands and runtime failures when `--json` is enabled.
+- `setup:context` and setup templates now default `aios_lite_version` to `0.1.7`.
+
+## [0.1.6] - 2026-03-01
+### Added
+- `test:smoke` now supports chain-specific Web3 profiles:
+  - `--web3=ethereum`
+  - `--web3=solana`
+  - `--web3=cardano`
+- Web3 smoke workflow now verifies:
+  - framework detection per chain profile
+  - `project.context.md` dApp/Web3 frontmatter consistency.
+
+### Changed
+- CLI help and docs updated for `test:smoke --web3`.
+- `setup:context` and setup templates now default `aios_lite_version` to `0.1.6`.
+
+## [0.1.5] - 2026-03-01
+### Added
+- Web3 framework detection:
+  - Ethereum: `Hardhat`, `Foundry`, `Truffle`
+  - Solana: `Anchor`, `Solana Web3`
+  - Cardano: `Cardano` (Aiken/Cardano SDK signals)
+- New Web3 skill templates:
+  - static: `web3-ethereum-patterns`, `web3-solana-patterns`, `web3-cardano-patterns`, `web3-security-checklist`, `node-typescript-patterns`
+  - dynamic: `ethereum-docs`, `solana-docs`, `cardano-docs`
+- New documentation page: `docs/en/web3.md`.
+
+### Changed
+- `project_type` now accepts `dapp`.
+- `setup:context` now supports Web3 context fields (`web3_enabled`, `web3_networks`, `contract_framework`, `wallet_provider`, `indexer`, `rpc_provider`).
+- `setup:context` and setup templates now default `aios_lite_version` to `0.1.5`.
+
+## [0.1.4] - 2026-03-01
+### 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] [--json]`
 - `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 context:validate [path] [--json]`
 - `aios-lite locale:apply [path] [--lang=en|pt-BR]`
+- `aios-lite test:smoke [workspace-path] [--lang=en|pt-BR] [--web3=ethereum|solana|cardano] [--keep] [--json]`
 
 ## Agent usage helper
 If your AI CLI does not show a visual agent picker, use:
@@ -30,8 +31,18 @@ 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
+aios-lite test:smoke --web3=ethereum
 ```
 
+## JSON output for CI
+Use `--json` on selected commands:
+- `aios-lite info --json`
+- `aios-lite doctor --json`
+- `aios-lite context:validate --json`
+- `aios-lite test:smoke --json`
+
 ## i18n
 CLI localization is supported with:
 - `--locale=<code>`
@@ -51,8 +62,23 @@ aios-lite i18n:add fr
 - Gemini CLI (`.gemini/GEMINI.md`)
 - OpenCode (`OPENCODE.md`)
 
+## Web3 support
+- `project_type=dapp` is supported in context validation and setup.
+- Framework detection now includes:
+  - Ethereum: `Hardhat`, `Foundry`, `Truffle`
+  - Solana: `Anchor`, `Solana Web3`
+  - Cardano: `Cardano` (Aiken/Cardano SDK signals)
+- `setup:context` supports Web3 fields:
+  - `--web3-enabled=true|false`
+  - `--web3-networks=ethereum,solana`
+  - `--contract-framework=Hardhat`
+  - `--wallet-provider=wagmi`
+  - `--indexer=The Graph`
+  - `--rpc-provider=Alchemy`
+
 ## Docs
 - i18n guide: `docs/en/i18n.md`
+- web3 guide: `docs/en/web3.md`
 - release guide: `docs/en/release.md`
 - release flow: `docs/en/release-flow.md`
 - release notes template: `docs/en/release-notes-template.md`

package/docs/en/web3.md

@@ -0,0 +1,54 @@
+# Web3 Support
+
+AIOS Lite includes lightweight Web3 support for small and medium teams using JavaScript/TypeScript workflows.
+
+## Supported framework detection
+- Ethereum: `Hardhat`, `Foundry`, `Truffle`
+- Solana: `Anchor`, `Solana Web3`
+- Cardano: `Cardano` (Aiken and Cardano SDK dependency signals)
+
+## Context contract for dApps
+`project_type` accepts `dapp`, and setup can include:
+- `web3_enabled`
+- `web3_networks`
+- `contract_framework`
+- `wallet_provider`
+- `indexer`
+- `rpc_provider`
+
+## Setup examples
+```bash
+# Interactive
+aios-lite setup:context
+
+# Defaults with explicit Web3 options
+aios-lite setup:context . \
+  --defaults \
+  --project-type=dapp \
+  --framework=Hardhat \
+  --web3-enabled=true \
+  --web3-networks=ethereum \
+  --contract-framework=Hardhat \
+  --wallet-provider=wagmi \
+  --indexer="The Graph" \
+  --rpc-provider=Alchemy
+```
+
+## Web3 smoke checks
+```bash
+aios-lite test:smoke --web3=ethereum
+aios-lite test:smoke --web3=solana
+aios-lite test:smoke --web3=cardano
+```
+
+## Skills bundled in templates
+- Static:
+  - `web3-ethereum-patterns.md`
+  - `web3-solana-patterns.md`
+  - `web3-cardano-patterns.md`
+  - `web3-security-checklist.md`
+  - `node-typescript-patterns.md`
+- Dynamic:
+  - `ethereum-docs.md`
+  - `solana-docs.md`
+  - `cardano-docs.md`

package/package.json

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

package/src/cli.js

@@ -12,6 +12,19 @@ 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');
+
+const JSON_SUPPORTED_COMMANDS = new Set([
+  'info',
+  'doctor',
+  'context:validate',
+  'context-validate',
+  'test:smoke',
+  'test-smoke',
+  'version',
+  '--version',
+  '-v'
+]);
 
 function printHelp(t) {
   console.log(`${t('cli.title')}\n`);
@@ -27,11 +40,30 @@ 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')}`);
+}
+
+function commandSupportsJson(command) {
+  return JSON_SUPPORTED_COMMANDS.has(command);
+}
+
+async function writeJson(payload) {
+  const text = `${JSON.stringify(payload, null, 2)}\n`;
+  await new Promise((resolve, reject) => {
+    process.stdout.write(text, (error) => {
+      if (error) {
+        reject(error);
+        return;
+      }
+      resolve();
+    });
+  });
 }
 
 async function main() {
   const { command, args, options } = parseArgv(process.argv);
   const locale = normalizeLocale(options.locale || process.env.AIOS_LITE_LOCALE || 'en');
+  const jsonMode = Boolean(options.json);
   const { t } = createTranslator(locale);
   const logger = console;
 
@@ -41,61 +73,78 @@ async function main() {
   }
 
   if (command === '--version' || command === '-v' || command === 'version' || options.version) {
-    await runInfo({ args: ['.'], options: {}, logger, t });
+    const result = await runInfo({ args: ['.'], options, logger, t });
+    if (jsonMode) {
+      await writeJson(result);
+    }
     return;
   }
 
   try {
+    let result = null;
+
     if (command === 'init') {
-      await runInit({ args, options, logger, t });
-      return;
-    }
-    if (command === 'install') {
-      await runInstall({ args, options, logger, t });
-      return;
-    }
-    if (command === 'update') {
-      await runUpdate({ args, options, logger, t });
-      return;
-    }
-    if (command === 'info') {
-      await runInfo({ args, options, logger, t });
-      return;
-    }
-    if (command === 'doctor') {
-      await runDoctorCommand({ args, options, logger, t });
-      return;
-    }
-    if (command === 'i18n:add' || command === 'i18n-add') {
-      await runI18nAdd({ args, options, logger, t });
-      return;
-    }
-    if (command === 'agents') {
-      await runAgentsList({ args, options, logger, t });
-      return;
-    }
-    if (command === 'agent:prompt' || command === 'agent-prompt') {
-      await runAgentPrompt({ args, options, logger, t });
-      return;
-    }
-    if (command === 'context:validate' || command === 'context-validate') {
-      await runContextValidate({ args, options, logger, t });
-      return;
-    }
-    if (command === 'setup:context' || command === 'setup-context') {
-      await runSetupContext({ args, options, logger, t });
-      return;
-    }
-    if (command === 'locale:apply' || command === 'locale-apply') {
-      await runLocaleApply({ args, options, logger, t });
+      result = await runInit({ args, options, logger, t });
+    } else if (command === 'install') {
+      result = await runInstall({ args, options, logger, t });
+    } else if (command === 'update') {
+      result = await runUpdate({ args, options, logger, t });
+    } else if (command === 'info') {
+      result = await runInfo({ args, options, logger, t });
+    } else if (command === 'doctor') {
+      result = await runDoctorCommand({ args, options, logger, t });
+    } else if (command === 'i18n:add' || command === 'i18n-add') {
+      result = await runI18nAdd({ args, options, logger, t });
+    } else if (command === 'agents') {
+      result = await runAgentsList({ args, options, logger, t });
+    } else if (command === 'agent:prompt' || command === 'agent-prompt') {
+      result = await runAgentPrompt({ args, options, logger, t });
+    } else if (command === 'context:validate' || command === 'context-validate') {
+      result = await runContextValidate({ args, options, logger, t });
+    } else if (command === 'setup:context' || command === 'setup-context') {
+      result = await runSetupContext({ args, options, logger, t });
+    } else if (command === 'locale:apply' || command === 'locale-apply') {
+      result = await runLocaleApply({ args, options, logger, t });
+    } else if (command === 'test:smoke' || command === 'test-smoke') {
+      result = await runSmokeTest({ args, options, logger, t });
+    } else {
+      const message = t('cli.unknown_command', { command });
+      if (jsonMode) {
+        await writeJson({
+          ok: false,
+          error: {
+            code: 'unknown_command',
+            message,
+            command
+          }
+        });
+      } else {
+        logger.error(`${message}\n`);
+        printHelp(t);
+      }
+      process.exitCode = 1;
       return;
     }
 
-    logger.error(`${t('cli.unknown_command', { command })}\n`);
-    printHelp(t);
-    process.exitCode = 1;
+    if (jsonMode && commandSupportsJson(command)) {
+      await writeJson(result || { ok: true });
+      if (result && Object.prototype.hasOwnProperty.call(result, 'ok') && !result.ok) {
+        process.exitCode = 1;
+      }
+    }
   } catch (error) {
-    logger.error(t('cli.error_prefix', { message: error.message }));
+    if (jsonMode) {
+      await writeJson({
+        ok: false,
+        error: {
+          code: 'command_error',
+          message: error.message,
+          command
+        }
+      });
+    } else {
+      logger.error(t('cli.error_prefix', { message: error.message }));
+    }
     process.exitCode = 1;
   }
 }

package/src/commands/context-validate.js

@@ -3,51 +3,79 @@
 const path = require('node:path');
 const { validateProjectContextFile } = require('../context');
 
-async function runContextValidate({ args, logger, t }) {
+async function runContextValidate({ args, options = {}, logger, t }) {
   const targetDir = path.resolve(process.cwd(), args[0] || '.');
+  const jsonMode = Boolean(options.json);
   const result = await validateProjectContextFile(targetDir);
 
+  const base = {
+    targetDir
+  };
+
   if (!result.exists) {
-    logger.log(t('context_validate.missing_file', { path: result.filePath }));
-    logger.log(t('context_validate.hint_setup'));
-    return {
+    const output = {
       ok: false,
+      reason: 'missing_file',
+      ...base,
       ...result
     };
+    if (jsonMode) {
+      return output;
+    }
+    logger.log(t('context_validate.missing_file', { path: result.filePath }));
+    logger.log(t('context_validate.hint_setup'));
+    return output;
   }
 
   if (!result.parsed) {
+    const output = {
+      ok: false,
+      reason: 'invalid_frontmatter',
+      ...base,
+      ...result
+    };
+    if (jsonMode) {
+      return output;
+    }
     logger.log(t('context_validate.invalid_frontmatter'));
     logger.log(t('context_validate.file_path', { path: result.filePath }));
     logger.log(t('context_validate.parse_reason', { reason: result.parseError || 'unknown' }));
     logger.log(t('context_validate.hint_fix_frontmatter'));
-    return {
-      ok: false,
-      ...result
-    };
+    return output;
   }
 
   if (!result.valid) {
+    const output = {
+      ok: false,
+      reason: 'invalid_fields',
+      ...base,
+      ...result
+    };
+    if (jsonMode) {
+      return output;
+    }
     logger.log(t('context_validate.invalid_fields'));
     logger.log(t('context_validate.file_path', { path: result.filePath }));
     for (const issue of result.issues) {
       logger.log(`- ${t(issue.key, issue.params || {})}`);
     }
-    return {
-      ok: false,
-      ...result
-    };
+    return output;
   }
 
-  logger.log(t('context_validate.valid'));
-  logger.log(t('context_validate.file_path', { path: result.filePath }));
-  return {
+  const output = {
     ok: true,
+    reason: 'valid',
+    ...base,
     ...result
   };
+  if (jsonMode) {
+    return output;
+  }
+  logger.log(t('context_validate.valid'));
+  logger.log(t('context_validate.file_path', { path: result.filePath }));
+  return output;
 }
 
 module.exports = {
   runContextValidate
 };
-

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,75 @@ 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']);
+  const jsonMode = Boolean(options.json);
+
+  let report = await runDoctor(targetDir);
+  let fixResult = null;
+
+  if (fix) {
+    if (!jsonMode) {
+      logger.log(dryRun ? t('doctor.fix_start_dry_run') : t('doctor.fix_start'));
+    }
+    fixResult = await applyDoctorFixes(targetDir, report, { dryRun });
+    if (!jsonMode) {
+      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);
+  }
+
+  const output = {
+    ok: report.ok,
+    targetDir,
+    fix: {
+      enabled: fix,
+      dryRun,
+      ...(fixResult
+        ? {
+            changedCount: fixResult.changedCount,
+            actions: fixResult.actions
+          }
+        : {})
+    },
+    report
+  };
+
+  if (jsonMode) {
+    return output;
+  }
+
+  printDoctorChecks(report, logger, t);
 
   if (!report.ok) {
     logger.log(`\n${t('doctor.diagnosis_fail', { count: report.failedCount })}`);
@@ -21,7 +87,7 @@ async function runDoctorCommand({ args, logger, t }) {
     logger.log(`\n${t('doctor.diagnosis_ok')}`);
   }
 
-  return report;
+  return output;
 }
 
 module.exports = {

package/src/commands/info.js

@@ -5,14 +5,27 @@ const path = require('node:path');
 const { detectFramework } = require('../detector');
 const { detectExistingInstall } = require('../installer');
 
-async function runInfo({ args, logger, t }) {
+async function runInfo({ args, options = {}, logger, t }) {
   const targetDir = path.resolve(process.cwd(), args[0] || '.');
+  const jsonMode = Boolean(options.json);
   const pkgPath = path.join(__dirname, '../../package.json');
   const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf8'));
 
   const installed = await detectExistingInstall(targetDir);
   const detection = await detectFramework(targetDir);
 
+  const result = {
+    ok: true,
+    version: pkg.version,
+    targetDir,
+    installed,
+    detection
+  };
+
+  if (jsonMode) {
+    return result;
+  }
+
   logger.log(t('info.cli_version', { version: pkg.version }));
   logger.log(t('info.directory', { targetDir }));
   logger.log(t('info.installed_here', { value: installed ? t('info.yes') : t('info.no') }));
@@ -21,11 +34,7 @@ async function runInfo({ args, logger, t }) {
     logger.log(t('info.evidence', { evidence: detection.evidence }));
   }
 
-  return {
-    version: pkg.version,
-    installed,
-    detection
-  };
+  return result;
 }
 
 module.exports = {