code-ai-installer 1.1.3 → 1.1.5

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
@@ -80,6 +83,11 @@ code-ai uninstall --target claude --apply
   - Google Antugravity: `GEMINI.md`
 - Agent files copied to target-specific agents directory.
 - Skill files copied to target-specific skills directory.
+- For `gpt-codex`, assets are installed to `agents/` and `.agents/` for native Codex discovery.
+- For `google-antugravity`, assets are installed in antugravity-friendly structure:
+  - agents: `.gemini/agents/<agent>/prompt.md` and `.gemini/agents/<agent>/config.json`
+  - skills: `.gemini/skills/<skill>.md` and `.gemini/skills/<skill>.py`
+- For `qwen-3.5`, installer also generates `.qwen/settings.json` with model/context defaults.
 - Markdown content is normalized per target (model-specific hint comments like `codex:` are transformed).
   - `codex reasoning` is mapped to target-native hints (`copilot reasoning`, `claude thinking`, `qwen reasoning_effort`, `gemini reasoning`).
 
@@ -94,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,6 +9,7 @@ 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)), "..");
 program
@@ -29,12 +30,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 +58,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 +100,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 +109,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,9 +195,26 @@ program
  * Runs interactive installer workflow when no subcommand is provided.
  */
 async function runInteractiveWizard() {
+    printBanner();
+    const languageAnswer = await prompts({
+        type: "select",
+        name: "language",
+        message: "Выбери язык шаблонов:",
+        choices: [
+            { title: "Русский (ru)", value: "ru" },
+            { title: "English (en)", value: "en" },
+        ],
+        initial: 0,
+    });
+    if (!languageAnswer.language) {
+        warn("Установка отменена.");
+        return;
+    }
+    const language = normalizeLanguage(languageAnswer.language);
     const sourceRoot = await resolveSourceRoot({
         cwd: process.cwd(),
         packageRoot,
+        language,
     });
     const catalog = await loadSourceCatalog(sourceRoot);
     const adapters = getPlatformAdapters();
@@ -358,6 +385,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/platforms/adapters.js

@@ -26,14 +26,14 @@ const targetLayouts = {
         orchestratorMirrorFile: "AGENTS.md",
         agentsDir: ".gemini/agents",
         skillsDir: ".gemini/skills",
-        notes: "Uses GEMINI.md convention and .gemini folder for role/skill docs.",
+        notes: "Uses GEMINI.md and antugravity-style layout with per-agent folders and script-oriented skills.",
     },
     "gpt-codex": {
         instructionFile: "CODEX.md",
         orchestratorMirrorFile: "AGENTS.md",
-        agentsDir: ".codex/agents",
-        skillsDir: ".codex/skills",
-        notes: "Uses CODEX.md and .codex folder for role/skill docs.",
+        agentsDir: "agents",
+        skillsDir: ".agents",
+        notes: "Uses AGENTS.md/agents/.agents layout compatible with Codex agent and skills discovery.",
     },
 };
 /**
@@ -100,6 +100,9 @@ function buildAdapter(id, label) {
  * @returns Planned operations list.
  */
 function planForLayout(layout, catalog, destinationDir, selectedAgents, selectedSkills, target) {
+    if (target === "google-antugravity") {
+        return planForGeminiLayout(layout, catalog, destinationDir, selectedAgents, selectedSkills, target);
+    }
     const operations = [];
     operations.push({
         sourcePath: catalog.orchestratorPath,
@@ -117,6 +120,14 @@ function planForLayout(layout, catalog, destinationDir, selectedAgents, selected
         generated: true,
         content: instructionContent,
     });
+    if (target === "qwen-3.5") {
+        operations.push({
+            sourcePath: "<generated>",
+            destinationPath: path.join(destinationDir, ".qwen", "settings.json"),
+            generated: true,
+            content: renderQwenSettings(),
+        });
+    }
     for (const agentName of selectedAgents) {
         const sourcePath = catalog.agentFiles[agentName];
         if (!sourcePath) {
@@ -149,6 +160,78 @@ function planForLayout(layout, catalog, destinationDir, selectedAgents, selected
     }
     return operations;
 }
+/**
+ * Plans google-antugravity specific layout with per-agent folders and script-first skills.
+ * @param layout Platform layout.
+ * @param catalog Source catalog.
+ * @param destinationDir Destination root.
+ * @param selectedAgents Selected agent names.
+ * @param selectedSkills Selected skill names.
+ * @param target Target id.
+ * @returns Planned operations list.
+ */
+function planForGeminiLayout(layout, catalog, destinationDir, selectedAgents, selectedSkills, target) {
+    const operations = [];
+    operations.push({
+        sourcePath: catalog.orchestratorPath,
+        destinationPath: path.join(destinationDir, layout.orchestratorMirrorFile),
+        generated: false,
+        transform: {
+            target,
+            assetType: "orchestrator",
+        },
+    });
+    const instructionContent = renderInstructionFile(target, selectedAgents, selectedSkills);
+    operations.push({
+        sourcePath: "<generated>",
+        destinationPath: path.join(destinationDir, layout.instructionFile),
+        generated: true,
+        content: instructionContent,
+    });
+    for (const agentName of selectedAgents) {
+        const sourcePath = catalog.agentFiles[agentName];
+        if (!sourcePath) {
+            continue;
+        }
+        operations.push({
+            sourcePath,
+            destinationPath: path.join(destinationDir, layout.agentsDir, agentName, "prompt.md"),
+            generated: false,
+            transform: {
+                target,
+                assetType: "agent",
+            },
+        });
+        operations.push({
+            sourcePath: "<generated>",
+            destinationPath: path.join(destinationDir, layout.agentsDir, agentName, "config.json"),
+            generated: true,
+            content: renderGeminiAgentConfig(agentName),
+        });
+    }
+    for (const skillName of selectedSkills) {
+        const sourcePath = catalog.skillFiles[skillName];
+        if (!sourcePath) {
+            continue;
+        }
+        operations.push({
+            sourcePath,
+            destinationPath: path.join(destinationDir, layout.skillsDir, `${skillName}.md`),
+            generated: false,
+            transform: {
+                target,
+                assetType: "skill",
+            },
+        });
+        operations.push({
+            sourcePath: "<generated>",
+            destinationPath: path.join(destinationDir, layout.skillsDir, `${skillName}.py`),
+            generated: true,
+            content: renderGeminiSkillStub(skillName),
+        });
+    }
+    return operations;
+}
 /**
  * Renders a platform-level instruction file with selected assets.
  * @param target Target id.
@@ -178,3 +261,39 @@ function renderInstructionFile(target, selectedAgents, selectedSkills) {
     lines.push("- Skills: see platform-specific skills directory.");
     return `${lines.join("\n")}\n`;
 }
+/**
+ * Renders default antugravity agent config file.
+ * @param agentName Agent identifier.
+ * @returns Config JSON.
+ */
+function renderGeminiAgentConfig(agentName) {
+    return `${JSON.stringify({
+        name: agentName,
+        model: "gemini-2.5-pro",
+        promptFile: "prompt.md",
+        reasoning: "medium",
+        temperature: 0.2,
+    }, null, 2)}\n`;
+}
+/**
+ * Renders python stub for gemini skill file.
+ * @param skillName Skill identifier.
+ * @returns Python source code.
+ */
+function renderGeminiSkillStub(skillName) {
+    return `\"\"\"Auto-generated skill stub for ${skillName}.\\nSee ${skillName}.md for behavior details.\"\"\"\\n\\n\\ndef run(input_text: str) -> str:\\n    \"\"\"Execute ${skillName} skill logic.\"\"\"\\n    return f\"${skillName}: {input_text}\"\\n`;
+}
+/**
+ * Renders default Qwen settings.json.
+ * @returns Qwen settings JSON.
+ */
+function renderQwenSettings() {
+    return `${JSON.stringify({
+        model: {
+            name: "qwen3-coder-plus",
+        },
+        context: {
+            fileName: ["QWEN.md", "AGENTS.md"],
+        },
+    }, null, 2)}\n`;
+}

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)