code-ai-installer 1.1.4 → 1.1.6

package/README.md

@@ -47,12 +47,15 @@ code-ai targets
 
 # list available agents and skills from current repository
 code-ai list
+code-ai list --lang en
 
 # health checks
 code-ai doctor --target claude
+code-ai doctor --target claude --lang en
 
 # dry-run install (default)
 code-ai install --target claude --agents conductor,reviewer --skills board,security_review
+code-ai install --target claude --lang en --agents conductor,reviewer --skills board,security_review
 
 # install into a newly created folder under current directory
 code-ai install --target gpt-codex --create-dir my-new-project --agents all --skills all --apply
@@ -99,3 +102,4 @@ code-ai uninstall --target claude --apply
 - Target aliases are accepted: `copilot`, `codex`, `claude`, `qwen`, `google`, `antigravity`.
 - If your AI tool requires a custom location, pass `--destination <path>`.
 - Source templates are resolved automatically: current directory first, bundled package templates second.
+- Template language is selectable via `--lang ru|en` (default: `ru`).

package/dist/banner.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Prints CODE-AI startup banner with green gradient.
+ */
+export declare function printBanner(): void;

package/dist/banner.js

@@ -0,0 +1,35 @@
+import chalk from "chalk";
+const CODE_AI_ASCII = [
+    "  ██████╗ ██████╗ ██████╗ ███████╗      █████╗ ██╗",
+    " ██╔════╝██╔═══██╗██╔══██╗██╔════╝     ██╔══██╗██║",
+    " ██║     ██║   ██║██║  ██║█████╗       ███████║██║",
+    " ██║     ██║   ██║██║  ██║██╔══╝       ██╔══██║██║",
+    " ╚██████╗╚██████╔╝██████╔╝███████╗     ██║  ██║██║",
+    "  ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝     ╚═╝  ╚═╝╚═╝",
+];
+/**
+ * Prints CODE-AI startup banner with green gradient.
+ */
+export function printBanner() {
+    const width = Math.max(...CODE_AI_ASCII.map((line) => line.length));
+    const start = { r: 64, g: 224, b: 128 };
+    const end = { r: 16, g: 120, b: 72 };
+    for (let row = 0; row < CODE_AI_ASCII.length; row += 1) {
+        const line = CODE_AI_ASCII[row];
+        let out = "";
+        for (let i = 0; i < line.length; i += 1) {
+            const ch = line[i];
+            if (ch === " ") {
+                out += ch;
+                continue;
+            }
+            const t = width <= 1 ? 0 : i / (width - 1);
+            const r = Math.round(start.r + (end.r - start.r) * t);
+            const g = Math.round(start.g + (end.g - start.g) * t);
+            const b = Math.round(start.b + (end.b - start.b) * t);
+            out += chalk.rgb(r, g, b)(ch);
+        }
+        process.stdout.write(`${out}\n`);
+    }
+    process.stdout.write(`${chalk.green("Code-AI installer wizard")}\n\n`);
+}

package/dist/index.js

@@ -9,8 +9,55 @@ import { runInstall, runUninstall } from "./installer.js";
 import { error, info, success, warn } from "./logger.js";
 import { getPlatformAdapters } from "./platforms/adapters.js";
 import { resolveSourceRoot } from "./sourceResolver.js";
+import { printBanner } from "./banner.js";
 const program = new Command();
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const WIZARD_TEXT = {
+    en: {
+        cancelled: "Installation cancelled.",
+        selectTemplateLanguage: "Select template language:",
+        languageRu: "Russian (ru)",
+        languageEn: "English (en)",
+        selectAiTarget: "Select AI target:",
+        installWhere: "Where should files be installed?",
+        currentFolder: "Current folder",
+        newFolder: "New folder",
+        newFolderName: "New folder name:",
+        newFolderNameRequired: "Please provide folder name",
+        selectAgents: "Select agents:",
+        selectSkills: "Select skills:",
+        selectHint: "space: toggle, enter: submit",
+        overwritePrompt: "Overwrite existing files?",
+        applyPrompt: "Run installation now?",
+        strictHintsPrompt: "Enforce strict target-hint adaptation?",
+        runDoctor: "Running doctor before install...",
+        doctorFailed: "Doctor checks failed. Fix issues and run again.",
+        dryRunMode: "Preview mode selected (no file writes).",
+        previewCompleted: "Preview completed.",
+    },
+    ru: {
+        cancelled: "Установка отменена.",
+        selectTemplateLanguage: "Выбери язык шаблонов:",
+        languageRu: "Русский (ru)",
+        languageEn: "English (en)",
+        selectAiTarget: "Выбери AI для установки:",
+        installWhere: "Куда устанавливать?",
+        currentFolder: "Текущая папка",
+        newFolder: "Новая папка",
+        newFolderName: "Название новой папки:",
+        newFolderNameRequired: "Укажи название папки",
+        selectAgents: "Выбери агентов:",
+        selectSkills: "Выбери skills:",
+        selectHint: "space: выбрать, enter: подтвердить",
+        overwritePrompt: "Перезаписывать существующие файлы?",
+        applyPrompt: "Сразу выполнить установку?",
+        strictHintsPrompt: "Требовать явные target-hints в agent/skill файлах?",
+        runDoctor: "Запускаю doctor перед установкой...",
+        doctorFailed: "Doctor не пройден. Исправь ошибки и запусти снова.",
+        dryRunMode: "Выбран preview-режим без записи файлов.",
+        previewCompleted: "Preview completed.",
+    },
+};
 program
     .name("code-ai")
     .description("Install code-ai agents and skills for AI coding assistants")
@@ -29,12 +76,15 @@ program
     .command("list")
     .description("List available bundled agents and skills")
     .option("--project-dir <path>", "Optional custom source root path")
+    .option("--lang <lang>", "Template language: ru | en", "ru")
     .action(async (options) => {
     try {
+        const language = normalizeLanguage(options.lang);
         const projectDir = await resolveSourceRoot({
             projectDirOption: options.projectDir,
             cwd: process.cwd(),
             packageRoot,
+            language,
         });
         const catalog = await loadSourceCatalog(projectDir);
         const agents = listAgentNames(catalog);
@@ -54,13 +104,16 @@ program
     .requiredOption("--target <id>", "Target AI id")
     .option("--project-dir <path>", "Optional custom source root path")
     .option("--destination <path>", "Destination root (default: current directory)")
+    .option("--lang <lang>", "Template language: ru | en", "ru")
     .action(async (options) => {
     try {
         const target = normalizeTarget(options.target);
+        const language = normalizeLanguage(options.lang);
         const projectDir = await resolveSourceRoot({
             projectDirOption: options.projectDir,
             cwd: process.cwd(),
             packageRoot,
+            language,
         });
         const destinationDir = path.resolve(options.destination ?? process.cwd());
         const report = await runDoctor(projectDir, destinationDir, target);
@@ -93,6 +146,7 @@ program
     .option("--project-dir <path>", "Optional custom source root path")
     .option("--destination <path>", "Destination root (default: current directory)")
     .option("--create-dir <name>", "Create child folder in current directory and install there")
+    .option("--lang <lang>", "Template language: ru | en", "ru")
     .option("--agents <list>", "Comma list of agents or 'all'", "all")
     .option("--skills <list>", "Comma list of skills or 'all'", "all")
     .option("--overwrite", "Overwrite existing files", false)
@@ -101,10 +155,12 @@ program
     .action(async (options) => {
     try {
         const target = normalizeTarget(options.target);
+        const language = normalizeLanguage(options.lang);
         const projectDir = await resolveSourceRoot({
             projectDirOption: options.projectDir,
             cwd: process.cwd(),
             packageRoot,
+            language,
         });
         const baseDestination = path.resolve(options.destination ?? process.cwd());
         const destinationDir = options.createDir ? path.join(baseDestination, options.createDir) : baseDestination;
@@ -185,16 +241,35 @@ program
  * Runs interactive installer workflow when no subcommand is provided.
  */
 async function runInteractiveWizard() {
+    printBanner();
+    const bootstrapText = WIZARD_TEXT.en;
+    const languageAnswer = await prompts({
+        type: "select",
+        name: "language",
+        message: bootstrapText.selectTemplateLanguage,
+        choices: [
+            { title: bootstrapText.languageEn, value: "en" },
+            { title: bootstrapText.languageRu, value: "ru" },
+        ],
+        initial: 0,
+    });
+    if (!languageAnswer.language) {
+        warn(bootstrapText.cancelled);
+        return;
+    }
+    const language = normalizeLanguage(languageAnswer.language);
+    const text = WIZARD_TEXT[language];
     const sourceRoot = await resolveSourceRoot({
         cwd: process.cwd(),
         packageRoot,
+        language,
     });
     const catalog = await loadSourceCatalog(sourceRoot);
     const adapters = getPlatformAdapters();
     const targetAnswer = await prompts({
         type: "select",
         name: "target",
-        message: "Выбери AI для установки:",
+        message: text.selectAiTarget,
         choices: adapters.map((adapter) => ({
             title: `${adapter.label} (${adapter.id})`,
             value: adapter.id,
@@ -202,20 +277,20 @@ async function runInteractiveWizard() {
         })),
     });
     if (!targetAnswer.target) {
-        warn("Установка отменена.");
+        warn(text.cancelled);
         return;
     }
     const destinationModeAnswer = await prompts({
         type: "select",
         name: "mode",
-        message: "Куда устанавливать?",
+        message: text.installWhere,
         choices: [
-            { title: "Текущая папка", value: "current" },
-            { title: "Новая папка", value: "new" },
+            { title: text.currentFolder, value: "current" },
+            { title: text.newFolder, value: "new" },
         ],
     });
     if (!destinationModeAnswer.mode) {
-        warn("Установка отменена.");
+        warn(text.cancelled);
         return;
     }
     let destinationDir = process.cwd();
@@ -223,11 +298,11 @@ async function runInteractiveWizard() {
         const newFolderAnswer = await prompts({
             type: "text",
             name: "folderName",
-            message: "Название новой папки:",
-            validate: (value) => (value.trim().length === 0 ? "Укажи название папки" : true),
+            message: text.newFolderName,
+            validate: (value) => (value.trim().length === 0 ? text.newFolderNameRequired : true),
         });
         if (!newFolderAnswer.folderName) {
-            warn("Установка отменена.");
+            warn(text.cancelled);
             return;
         }
         destinationDir = path.join(process.cwd(), String(newFolderAnswer.folderName).trim());
@@ -237,32 +312,32 @@ async function runInteractiveWizard() {
     const agentsAnswer = await prompts({
         type: "multiselect",
         name: "selectedAgents",
-        message: "Выбери агентов:",
+        message: text.selectAgents,
         choices: agents.map((agentName) => ({ title: agentName, value: agentName, selected: true })),
         min: 1,
-        hint: "space: выбрать, enter: подтвердить",
+        hint: text.selectHint,
     });
     if (!agentsAnswer.selectedAgents || agentsAnswer.selectedAgents.length === 0) {
-        warn("Установка отменена.");
+        warn(text.cancelled);
         return;
     }
     const skillsAnswer = await prompts({
         type: "multiselect",
         name: "selectedSkills",
-        message: "Выбери skills:",
+        message: text.selectSkills,
         choices: skills.map((skillName) => ({ title: skillName, value: skillName, selected: true })),
         min: 1,
-        hint: "space: выбрать, enter: подтвердить",
+        hint: text.selectHint,
     });
     if (!skillsAnswer.selectedSkills || skillsAnswer.selectedSkills.length === 0) {
-        warn("Установка отменена.");
+        warn(text.cancelled);
         return;
     }
     const optionsAnswer = await prompts([
         {
             type: "toggle",
             name: "overwrite",
-            message: "Перезаписывать существующие файлы?",
+            message: text.overwritePrompt,
             initial: false,
             active: "yes",
             inactive: "no",
@@ -270,7 +345,7 @@ async function runInteractiveWizard() {
         {
             type: "toggle",
             name: "apply",
-            message: "Сразу выполнить установку?",
+            message: text.applyPrompt,
             initial: true,
             active: "yes",
             inactive: "no",
@@ -278,14 +353,14 @@ async function runInteractiveWizard() {
         {
             type: "toggle",
             name: "strictHints",
-            message: "Требовать явные target-hints в agent/skill файлах?",
+            message: text.strictHintsPrompt,
             initial: false,
             active: "yes",
             inactive: "no",
         },
     ]);
     const target = targetAnswer.target;
-    info("Запускаю doctor перед установкой...");
+    info(text.runDoctor);
     const doctor = await runDoctor(sourceRoot, destinationDir, target);
     for (const line of doctor.info) {
         info(line);
@@ -297,12 +372,12 @@ async function runInteractiveWizard() {
         error(line);
     }
     if (doctor.errors.length > 0) {
-        throw new Error("Doctor не пройден. Исправь ошибки и запусти снова.");
+        throw new Error(text.doctorFailed);
     }
     const dryRun = !Boolean(optionsAnswer.apply);
     const overwriteMode = optionsAnswer.overwrite ? "overwrite" : "skip";
     if (dryRun) {
-        warn("Выбран preview-режим без записи файлов.");
+        warn(text.dryRunMode);
     }
     const { state, result } = await runInstall({
         target,
@@ -320,7 +395,7 @@ async function runInteractiveWizard() {
     info(`Files planned: ${result.plannedFiles.length}`);
     if (dryRun) {
         info(`Files would write: ${result.writtenFiles.length}`);
-        success("Preview completed.");
+        success(text.previewCompleted);
     }
     else {
         info(`Files written: ${result.writtenFiles.length}`);
@@ -358,6 +433,18 @@ function normalizeTarget(rawTarget) {
     }
     return normalized;
 }
+/**
+ * Normalizes template language code.
+ * @param rawLanguage Raw language value.
+ * @returns Normalized template language.
+ */
+function normalizeLanguage(rawLanguage) {
+    const value = rawLanguage.trim().toLowerCase();
+    if (value === "ru" || value === "en") {
+        return value;
+    }
+    throw new Error(`Unsupported language '${rawLanguage}'. Use 'ru' or 'en'.`);
+}
 if (process.argv.length <= 2) {
     runInteractiveWizard().catch((err) => {
         error(err.message);

package/dist/sourceResolver.d.ts

@@ -1,3 +1,4 @@
+import type { TemplateLanguage } from "./types.js";
 /**
  * Resolves source root with agent templates.
  * @param args Resolution arguments.
@@ -7,4 +8,5 @@ export declare function resolveSourceRoot(args: {
     projectDirOption?: string;
     cwd: string;
     packageRoot: string;
+    language: TemplateLanguage;
 }): Promise<string>;

package/dist/sourceResolver.js

@@ -13,13 +13,23 @@ export async function resolveSourceRoot(args) {
         }
         throw new Error(`Invalid --project-dir: ${explicitPath}. Required: AGENTS.md, agents/, and .agents/.`);
     }
+    const bundledPath = getBundledPath(args.packageRoot, args.language);
     const cwdPath = path.resolve(args.cwd);
-    if (await isValidSourceRoot(cwdPath)) {
-        return cwdPath;
+    if (args.language === "en") {
+        if (await isValidSourceRoot(bundledPath)) {
+            return bundledPath;
+        }
+        if (await isValidSourceRoot(cwdPath)) {
+            return cwdPath;
+        }
     }
-    const bundledPath = path.resolve(args.packageRoot);
-    if (await isValidSourceRoot(bundledPath)) {
-        return bundledPath;
+    else {
+        if (await isValidSourceRoot(cwdPath)) {
+            return cwdPath;
+        }
+        if (await isValidSourceRoot(bundledPath)) {
+            return bundledPath;
+        }
     }
     throw new Error(`Could not find source templates in current directory or bundled package. Checked: ${cwdPath} and ${bundledPath}`);
 }
@@ -34,3 +44,15 @@ async function isValidSourceRoot(rootDir) {
     const dotAgentsDir = path.join(rootDir, ".agents");
     return (await fs.pathExists(orchestratorPath)) && (await fs.pathExists(agentsDir)) && (await fs.pathExists(dotAgentsDir));
 }
+/**
+ * Returns bundled templates root for selected language.
+ * @param packageRoot Installed package root.
+ * @param language Template language.
+ * @returns Absolute bundled source path.
+ */
+function getBundledPath(packageRoot, language) {
+    if (language === "en") {
+        return path.resolve(packageRoot, "locales", "en");
+    }
+    return path.resolve(packageRoot);
+}

package/dist/types.d.ts

@@ -2,6 +2,7 @@
  * Supported AI target identifiers.
  */
 export type TargetId = "vscode-copilot" | "claude" | "qwen-3.5" | "google-antugravity" | "gpt-codex";
+export type TemplateLanguage = "ru" | "en";
 /**
  * Defines one source file and destination path copy action.
  */

package/locales/en/.agents/a11y_baseline/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: a11y_baseline
+description: Minimum baseline accessibility for web UI: keyboard navigation, focus management, form labels, ARIA for interactive components, error messages.
+---
+
+#Skill: A11y Baseline (minimum)
+
+## Goal
+Set minimum accessibility requirements that can be tested and implemented in the MVP.
+
+## Exit
+List of a11y requirements for the project + notes on key components.
+
+## Minimum Requirements (MVP)
+1) **Keyboard navigation**
+- All interactive elements are accessible from the keyboard
+- Tab order is logical
+- No trick traps
+
+2) **Focus states**
+- Visible focus for all interactive elements
+- In modals: focus moves inside and returns back when closed
+
+3) **Forms**
+- Each field has a label (visible or aria-label)
+- Errors are assigned to a field (the error description is read by assistive technologies)
+- Required fields are marked and clear
+
+4) **ARIA (where needed)**
+- Dialog: role="dialog" + aria-modal
+- Tabs, dropdowns, comboboxes - correct roles/attributes (if we use custom ones)
+
+5) **Error messaging**
+- Errors are clear, without “unknown error”
+- There are actions: retry/close/fix
+
+## Receipt for tester
+- You can go through key flows without a mouse
+- In modal, focus does not leak
+- Forms announce label/errors
+- Custom components have ARIA and work with assistive technologies

package/locales/en/.agents/adr_log/SKILL.md

@@ -0,0 +1,69 @@
+---
+name:adr_log
+description: Record key architectural decisions (ADR) with trade-offs: Pros/Cons/Alternatives/Decision, status and date.
+---
+
+#Skill: ADR Log
+
+## Goal
+Don’t lose track of “why we did this” and simplify review/support.
+
+## When to use
+- For every non-trivial choice: database, auth, cache, module structure, API format, error strategy, queues, search, deployment, integrations, etc.
+
+## ADR format (required)
+# ADR-XXX: <Name>
+
+## Context
+<why is this necessary, what are the limitations, what hurts>
+
+##Decision
+<what you chose and how exactly>
+
+## Consequences
+### Positive
+- ...
+###Negative
+- ...
+
+## Alternatives Considered
+- **A**: ...
+- **B**: ...
+
+##Status
+Proposed / Accepted / Deprecated
+
+##Date
+YYYY-MM-DD
+
+## Requirements (strict)
+- For each ADR there must be explicit Pros/Cons/Alternatives and rationale of choice.
+- If the decision affects security/data/cost, be sure to describe the consequences.
+- ADR should be short and specific: without water, but with key arguments.
+
+## Example (short)
+# ADR-001: Selecting the main database
+
+##Context
+You need to store users/sessions/orders. Transactions and complex queries are needed. Expected growth to 100K users.
+
+##Decision
+We use PostgreSQL as the main database.
+
+## Consequences
+### Positive
+- ACID transactions
+- Rich queries and indexing
+###Negative
+- Possible need for scaling during growth
+- Operational costs for administration
+
+## Alternatives Considered
+- **MongoDB**: weaker in transactional/complex join scenarios
+- **DynamoDB**: vendor lock-in, more difficult to test locally
+
+##Status
+Accepted
+
+##Date
+2025-01-15

package/locales/en/.agents/api_contract_compliance_review/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: api_contract_compliance_review
+description: Checking the compliance of the API implementation with contracts: schemes, error codes, validation, authorization, idempotency, pagination.
+---
+
+# Skill: API Contract Compliance Review
+
+## Check
+- Endpoints correspond to API Contracts (method/path/request/response)
+- Errors: status + error_code + safe message
+- Border Validation (422 or accepted policy)
+- 401 vs 403 correct
+- Pagination/filters/sorting are implemented if UX is required
+- Idempotency for risky operations (if it was in the contract/ADR)
+
+## Exit
+- Inconsistencies for each endpoint
+- Recommendations (pointwise)

package/locales/en/.agents/api_contracts/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: api_contracts
+description: API contracts for UX flows: endpoints, schemas, errors, validation, authorization, perf/scalability considerations, idempotency and integration patterns.
+---
+
+# Skill: API Contracts
+
+## Goal
+Make the API predictable, safe and efficient for the client and tests.
+
+## Inputs
+- UX Spec (screens/actions/states)
+- PRD (acceptance criteria)
+- Roles/permissions
+
+## Exit
+### General rules
+- Unified error format (error_code, message, details)
+- 401 vs 403 distinguish
+- Validation at boundaries
+- Pagination/filters/sorting - if the UI requires
+- Idempotency for create/risk operations (where needed)
+- Versioning (if the public API is expected to grow)
+
+### For each endpoint
+- Method + Path
+- AuthN/AuthZ: required? roles?
+- Request schema (types + restrictions)
+- Response schema
+- Errors:
+  - status
+  - error_code
+  - safe message
+- Perf/scalability notes:
+  - limits, pagination, batch, round-trips minimization
+
+### Integrations
+- Webhooks/external APIs: retry/backoff, signature/verification, idempotency
+- Async if justified (event-driven)
+
+## Trade-offs
+If there are controversial areas (for example, CQRS/async), record them as ADR.

package/locales/en/.agents/architecture_compliance_review/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: architecture_compliance_review
+description: Checking code compliance with architecture/ADR: module boundaries, layers, dependencies, conventions, red flags.
+---
+
+#Skill: Architecture Compliance Review
+
+## Check
+- Compliance with modular boundaries (controller/service/repo or similar)
+- Direction of dependencies (UI does not pull data directly, etc.)
+- Lack of red flags: Big Ball of Mud, God Object, Tight Coupling, Magic
+- New “solutions” are issued ADR (if they affect the database/cache/auth/contracts/integrations)
+
+## Exit
+- Findings (P0/P1/P2)
+- Recommendations for refactoring (pointwise)
+- Is ADR required? (yes/no what to describe)