code-ai-installer 1.1.4 → 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
@@ -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,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/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)

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

@@ -0,0 +1,92 @@
+---
+name: architecture_doc
+description: Architectural document on PRD+UX: modules, flows, data, integrations, errors, testability, bottlenecks, growth plan and implementation plan.
+---
+
+# Skill: Architecture Document
+
+## Goal
+Make the architecture implementable, testable, and ready for growth.
+
+## Inputs
+-PRD
+- UX Spec (flows/screens/states)
+- Stack/deployment restrictions
+- (if available) Current State Analysis
+
+## Output (structure)
+
+## 1) Overview
+- What are we building (1 paragraph)
+- Context and limitations
+- Assumptions
+
+## 2) System Context
+- Actors
+- External integrations
+- System boundaries
+
+## 3) High-level Architecture Diagram (text)
+- FE → BE → DB/Cache/External
+- Basic outlines of data and responsibilities
+
+## 4) Modules / Components
+For each component/module:
+- responsibility
+- public interfaces
+- dependencies
+- testing boundaries (unit vs integration)
+- consistency rules (patterns/conventions)
+
+## 5) Flow Mapping (from UX Spec)
+- Flow → endpoints → services → repos → entities
+- Where and why loading/empty/error states occur
+- Error strategy on the UI (what to show to the user)
+
+## 6) Integration Patterns
+- Synchronous calls (HTTP)
+- Asynchronous operations (events/queues) - if justified
+- Idempotency for risky operations
+
+## 7) Error Handling Strategy
+- Unified error format (machine-readable code)
+- 401/403/404/409/422/5xx policy
+- Secure messages (no leaks)
+
+## 8) Testing Strategy
+- Boundaries of unit tests
+- Integration tests (API/DB/integration contracts)
+- A set of “must-have” scenarios for PRD/UX
+- (optional) e2e / visual checks - if the design requires
+
+## 9) Scalability Bottlenecks (anticipation)
+- potential bottlenecks (DB hot spots, N+1, stateful sessions, heavy endpoints)
+- measures: indexes, caching, background tasks, CDN, sharding (if ever needed)
+
+## 10) Growth Plan
+Describe the thresholds and what changes:
+- 10K users: The current architecture is sufficient, but you need to monitor metrics and optimize database queries.
+- 100K users: Implementation of Redis clustering and use of CDN for static resources
+- 1M users: Transition to microservice architecture, dividing databases into reading and writing (Read/Write splitting)
+- 10M users: Event-driven architecture, distributed caching, multi-region deployment
+
+## 11) Implementation Plan
+- Epics/subsystems
+- Vertical slices MVP (minimum 1–3)
+- Dependencies and order
+
+## Quality (checklist)
+- Any UX flow can be traced through modules/API/data
+- Module boundaries reduce cohesion
+- Testability is built in
+- Observability/deployment is not forgotten
+
+## Red Flags
+- Big Ball of Mud: Lack of clear architecture
+- Golden Hammer: Use the same solution for any task
+- Premature Optimization: Optimization at too early stages
+- Not Invented Here: Refusal of ready-made solutions
+- Analysis Paralysis: Too much planning with little implementation
+- Magic: Strange, undocumented behavior
+- Tight Coupling: Too much dependence of components on each other
+- God Object: One class or component that does everything

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

@@ -0,0 +1,43 @@
+---
+name: board
+description: Project Board management: creating tasks with ID, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every message from the conductor.
+---
+
+# Skill: Project Board (conductor's checklist)
+
+## Goal
+Provide transparent progress control: who is doing what, what is being blocked, what’s next.
+
+## When to use
+- Immediately after kickoff
+- After every response from any agent
+- When new requirements/bugs/comments appear
+
+## ID Rules
+- Prefixes: `PM-xx`, `UX-xx`, `ARCH-xx`, `DEV-xx`, `REV-xx`, `TEST-xx`
+- Numbering: 01, 02, 03…
+- One task = one verifiable result (artifact/verification).
+
+## Statuses
+- `☐` not started
+- `⏳` at work
+- `☑` ready (there is an artifact + check)
+- `⚠️` blocked (required: reason + withdrawal owner)
+
+## Algorithm
+1) Create a primary Project Board: 1–3 tasks per role for the next iteration.
+2) Update statuses at every step:
+   - if the agent started - `⏳`
+   - if you submitted an artifact and it is accepted - `☑`
+   - if input/solution is needed - `⚠️`
+3) With `⚠️` add the line “Blocker” to the report and the specific next step.
+4) In each conductor’s message, display the Project Board as the first block.
+
+## Board template (copy as is)
+###Project Board
+- [ ] (PM-01) ... — Owner: PM — Status: ☐/⏳/☑/⚠️
+- [ ] (UX-01) ... — Owner: UX — Status: ☐/⏳/☑/⚠️
+- [ ] (ARCH-01) ... — Owner: ARCH — Status: ☐/⏳/☑/⚠️
+- [ ] (DEV-01) ... — Owner: DEV — Status: ☐/⏳/☑/⚠️
+- [ ] (REV-01) ... — Owner: REV — Status: ☐/⏳/☑/⚠️
+- [ ] (TEST-01) ... — Owner: TEST — Status: ☐/⏳/☑/⚠️

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

@@ -0,0 +1,68 @@
+---
+name: cloud_infrastructure_security
+description: Security review of cloud/infra/CI/CD: IAM, secrets manager, network, logging/monitoring, supply chain, CDN/WAF, backup/DR.
+---
+
+#Skill: Cloud & Infrastructure Security
+
+## When to activate
+- Deploy to AWS/Vercel/Railway/Cloudflare, etc.
+- IAM policies/roles
+- CI/CD pipelines
+- IaC (Terraform/CloudFormation)
+- Secrets management in the cloud
+- CDN/WAF/edge security
+- Backup/Recovery/DR
+
+## Cloud Security Checklist
+1) IAM & Access Control
+- least privilege, no wildcard
+- MFA for privileged accounts
+- no root usage in prod
+- regular access review
+
+2) Secrets Management
+- platform secrets manager
+- rotation for DB credentials (if applicable)
+- audit of access to secrets
+- prohibition of leaks in logs/errors
+
+3) Network Security
+- DB is not public
+- SSH/RDP only via VPN/bastion
+- security groups/NACL least privilege
+- flow logs (if available)
+
+4) Logging & Monitoring
+- audit of admin actions
+- log retention (for example 90+ days if necessary)
+- alerts for anomalies/failed auth
+
+5) CI/CD Pipeline Security
+- OIDC instead of long-lived credentials
+- secret scanning
+- dependency audit
+- image scanning (if containers)
+- branch protection / required reviews
+
+6) CDN/WAF (Cloudflare and analogues)
+- WAF managed rules (OWASP)
+- rate limiting/bot protection
+- security headers
+- strict TLS
+
+7) Backup & Disaster Recovery
+- automated backups + retention
+- PITR (if necessary)
+- periodic recovery testing
+- documented RPO/RTO
+
+## Pre-Deployment Checklist (short)
+IAM / Secrets / Network / Logging / Monitoring / CI/CD / WAF / Encryption / Backups / Runbooks / Incident plan
+
+## Exit
+- Findings P0/P1/P2 + specific fixes/settings
+- What to add to CI and what checks are required
+
+## See also
+- Examples and anti-examples: $review_reference_snippets

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

@@ -0,0 +1,47 @@
+---
+name: code_review_checklist
+description: Universal review checklist: code quality, readability, testability, security, contracts, DoD.
+---
+
+# Skill: Code Review Checklist
+
+## Goal
+Quickly evaluate PR for completeness and compliance with standards.
+
+## Checklist
+### Code Quality
+- [ ] Clear names, small functions/modules
+- [ ] No duplication without reason
+- [ ] No “magic” (unobvious side effects)
+- [ ] Boundaries of layers/modules are respected
+
+### Architecture
+- [ ] Corresponds to Architecture Doc / ADR
+- [ ] No Tight Coupling / God Object / Big Ball of Mud
+- [ ] New solutions are recorded by ADR if necessary
+
+### API & Data
+- [ ] Contracts are met (schemas, codes, errors)
+- [ ] Validation at the border
+- [ ] Data/migration model is consistent
+
+###Tests
+- [ ] Unit + Integration tests added/updated
+- [ ] Covered happy + edge + error paths
+- [ ] No flakes/dependencies of tests on each other
+
+###Security
+- [ ] AuthZ on the server
+- [ ] No secrets in code/logs
+- [ ] Safe errors (no stack/SQL/PII)
+- [ ] Dependency hygiene
+
+### Observability & Ops
+- [ ] request_id/trace_id correlation (if applicable)
+- [ ] Logs are structured, without PII/secrets
+- [ ] Startup/check instructions present
+
+## Exit
+- PASS: ...
+- MISSING: ...
+- Findings P0/P1/P2