@vsem/ai 0.1.1 → 0.1.3

package/README.md

@@ -14,12 +14,26 @@ npx @vsem/ai@latest
 Runs against the current directory by default. Optional arguments:
 
 ```bash
-npx @vsem/ai@latest [target-dir] [--branch <name>] [--force]
+npx @vsem/ai@latest [target-dir] [--branch <name>] [--lang <language>] [--force] [--yes]
 ```
 
 - `target-dir` — install into this directory instead of the current one (created if missing).
 - `--branch <name>` — personal branch name (default: your `git config --global user.name`, or `dev`).
+- `--lang <language>` — language the assistant should use to talk to you and to reason, written into `CLAUDE.md` (default: Russian).
 - `--force` — also overwrite project-owned files (`.ai/project.md`, `.ai/plan.md`, task/decision/incident indexes), resetting them to placeholders. Without this flag, reruns only update framework-owned files (`.ai/rules/`, `.ai/roles/`, `CLAUDE.md`) and never touch your own project state.
+- `--yes` / `-y` — skip the interactive wizard and confirmation prompt, accepting all defaults.
+
+In an interactive terminal, the CLI shows a banner and asks for whatever
+wasn't already given on the command line (target folder, language, branch),
+then shows an install confirmation "button" before touching disk — press
+Enter to proceed or `n` to cancel. Any value passed as a flag skips its
+question. In non-interactive contexts (CI, pipes) it detects the lack of a
+TTY and proceeds automatically with defaults, same as passing `--yes`.
+
+The generated workspace's local git repo also gets `core.autocrlf` disabled,
+so `git add`/`commit` don't print `LF will be replaced by CRLF` warnings for
+this project's text files on Windows. This only affects that one repo, not
+your global git config.
 
 ## Updating an existing workspace
 

package/bin/cli.js

@@ -17,28 +17,126 @@
 //   user's own project state. Pass --force to overwrite scaffold files too.
 //
 // Usage:
-//   npx @vsem/ai@latest [target-dir] [--branch <name>] [--force]
+//   npx @vsem/ai@latest [target-dir] [--branch <name>] [--lang <language>] [--force] [--yes]
 
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 const { execFileSync } = require('child_process');
 
+const PACKAGE_JSON = require('../package.json');
 const FRAMEWORK_VERSION = '0.1.0';
+const DEFAULT_LANGUAGE = 'Русский';
 const PACKAGE_DIR = path.join(__dirname, '..');
 const TEMPLATES_DIR = path.join(PACKAGE_DIR, 'templates');
 const SYSTEM_DIR = path.join(TEMPLATES_DIR, 'system');
 const SCAFFOLD_DIR = path.join(TEMPLATES_DIR, 'scaffold');
 
+// --- terminal styling -------------------------------------------------
+
+const supportsColor = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+
+function style(codes, text) {
+    if (!supportsColor) return text;
+    return `\x1b[${codes}m${text}\x1b[0m`;
+}
+
+const cyan = (s) => style('36', s);
+const cyanBold = (s) => style('1;36', s);
+const dim = (s) => style('2', s);
+const green = (s) => style('32', s);
+const yellow = (s) => style('33', s);
+const button = (s) => style('1;30;46', s); // bold black text on cyan background
+
+// 5-row pixel font, just enough to spell VSEM.
+const GLYPHS = {
+    V: ['█   █', '█   █', '█   █', ' █ █ ', '  █  '],
+    S: [' ████', '█    ', ' ███ ', '    █', '████ '],
+    E: ['█████', '█    ', '████ ', '█    ', '█████'],
+    M: ['█   █', '██ ██', '█ █ █', '█   █', '█   █'],
+};
+
+function renderLogo(word) {
+    const rows = [];
+    for (let row = 0; row < 5; row++) {
+        rows.push(word.split('').map((ch) => GLYPHS[ch][row]).join('  '));
+    }
+    return rows.map(cyanBold).join('\n');
+}
+
+function printBanner() {
+    console.log('');
+    console.log(renderLogo('VSEM'));
+    console.log('');
+    console.log(cyan('vsem-framework') + dim(` · CLI v${PACKAGE_JSON.version} · шаблон v${FRAMEWORK_VERSION}`));
+    console.log(dim('Разворачивает рабочее пространство для AI-агента: .ai/ (роли, правила,'));
+    console.log(dim('задачи, решения, инциденты), CLAUDE.md и личную git-ветку — в этой папке.'));
+    console.log('');
+}
+
+function renderButton(label) {
+    const padded = `  ${label}  `;
+    const top = '┌' + '─'.repeat(padded.length) + '┐';
+    const mid = '│' + button(padded) + '│';
+    const bottom = '└' + '─'.repeat(padded.length) + '┘';
+    return `${top}\n${mid}\n${bottom}`;
+}
+
+// Asks a question with a default value shown in the prompt; Enter accepts it.
+function ask(rl, question, defaultValue) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            const trimmed = answer.trim();
+            resolve(trimmed || defaultValue);
+        });
+    });
+}
+
+// Shows an install "button" and waits for confirmation. Auto-confirms when
+// stdin isn't a TTY (CI, pipes) or when --yes was passed, so scripted/non-
+// interactive runs never hang. `rl` must be provided whenever this runs
+// interactively (i.e. whenever opts.yes is false and stdin is a TTY).
+function confirmInstall(info, opts, rl) {
+    console.log(`  ${dim('Папка:')}  ${info.target}`);
+    console.log(`  ${dim('Ветка:')}  ${info.branch}`);
+    console.log(`  ${dim('Язык:')}   ${info.language}`);
+    console.log(`  ${dim('Режим:')}  ${info.isRerun ? 'обновление существующего пространства' : 'новая установка'}`);
+    console.log('');
+
+    if (opts.yes || !process.stdin.isTTY) {
+        console.log(renderButton('Установить') + '\n');
+        console.log(dim(opts.yes ? 'Подтверждение пропущено (--yes).' : 'Неинтерактивный режим — продолжаю автоматически.'));
+        console.log('');
+        return Promise.resolve(true);
+    }
+
+    console.log(renderButton('Установить') + '\n');
+    console.log(dim('Enter — установить, n — отменить'));
+
+    return new Promise((resolve) => {
+        rl.question('> ', (answer) => {
+            console.log('');
+            resolve(!/^n(o)?$/i.test(answer.trim()));
+        });
+    });
+}
+
 function parseArgs(argv) {
-    const opts = { target: null, branch: null, force: false };
+    const opts = { target: null, branch: null, lang: null, force: false, yes: false };
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
         if (a === '--force') {
             opts.force = true;
+        } else if (a === '--yes' || a === '-y') {
+            opts.yes = true;
         } else if (a === '--branch') {
             opts.branch = argv[++i] || null;
         } else if (a.startsWith('--branch=')) {
             opts.branch = a.slice('--branch='.length);
+        } else if (a === '--lang') {
+            opts.lang = argv[++i] || null;
+        } else if (a.startsWith('--lang=')) {
+            opts.lang = a.slice('--lang='.length);
         } else if (!a.startsWith('-') && opts.target === null) {
             opts.target = a;
         }
@@ -100,30 +198,70 @@ function tryGit(args, cwd) {
     }
 }
 
-function main() {
+// Personal-branch name suggested from the user's global git identity, falling
+// back to 'dev'. `cwd` must already exist (global config doesn't care where
+// it's read from, but a missing directory would make the git spawn itself fail).
+function suggestBranch(cwd) {
+    const cfg = tryGit(['config', '--global', 'user.name'], cwd);
+    if (cfg.ok && cfg.out.trim()) {
+        const slug = cfg.out.trim().toLowerCase().replace(/\s+/g, '-').replace(/^-+|-+$/g, '');
+        if (slug) return slug;
+    }
+    return 'dev';
+}
+
+async function main() {
     if (!fs.existsSync(SYSTEM_DIR)) {
         console.error(`Templates not found at ${SYSTEM_DIR}. This script must ship together with templates/.`);
         process.exit(1);
     }
 
     const args = parseArgs(process.argv.slice(2));
-    const target = path.resolve(args.target || process.cwd());
+    printBanner();
+
+    // Only prompt when nothing overrides it and we can actually read an answer.
+    // Any explicit flag (--branch, --lang, positional target dir) skips its
+    // corresponding question. --yes or a non-TTY stdin (CI, pipes) skips the
+    // whole wizard so scripted runs never hang.
+    const interactive = !args.yes && process.stdin.isTTY;
+    const rl = interactive ? readline.createInterface({ input: process.stdin, output: process.stdout }) : null;
+
+    let targetInput = args.target;
+    if (interactive && !targetInput) {
+        targetInput = await ask(rl, `${dim("Папка")} (путь; '.' — текущая, название/путь — новая) [.]: `, '.');
+    }
 
+    const target = path.resolve(targetInput || '.');
     fs.mkdirSync(target, { recursive: true });
     const aiDir = path.join(target, '.ai');
     const workspaceName = path.basename(target);
     const isRerun = fs.existsSync(aiDir);
 
+    let language = args.lang;
     let branch = args.branch;
-    if (!branch) {
-        const cfg = tryGit(['config', '--global', 'user.name'], target);
-        if (cfg.ok && cfg.out.trim()) {
-            branch = cfg.out.trim().toLowerCase().replace(/\s+/g, '-').replace(/^-+|-+$/g, '');
+
+    if (interactive) {
+        if (!language) {
+            language = await ask(rl, `${dim('Язык общения и рассуждений ассистента')} [${DEFAULT_LANGUAGE}]: `, DEFAULT_LANGUAGE);
+        }
+        if (!branch) {
+            const suggested = suggestBranch(target);
+            branch = await ask(rl, `${dim('Ветка')} [${suggested}]: `, suggested);
         }
-        if (!branch) branch = 'dev';
+    } else {
+        if (!language) language = DEFAULT_LANGUAGE;
+        if (!branch) branch = suggestBranch(target);
+    }
+
+    const proceed = await confirmInstall({ target, branch, language, isRerun }, args, rl);
+    if (rl) rl.close();
+
+    if (!proceed) {
+        console.log(yellow('[cancelled] Ничего не изменено.'));
+        return;
     }
 
-    const vars = { WORKSPACE_NAME: workspaceName, FRAMEWORK_VERSION: FRAMEWORK_VERSION };
+    const vars = { WORKSPACE_NAME: workspaceName, FRAMEWORK_VERSION: FRAMEWORK_VERSION, LANGUAGE: language };
 
     copyTemplateTree(SYSTEM_DIR, target, vars, true);
     copyTemplateTree(SCAFFOLD_DIR, target, vars, args.force);
@@ -133,22 +271,27 @@ function main() {
     }
 
     if (isRerun) {
-        console.log(`[ok] Workspace synced at ${target} (system files updated; scaffold files kept unless --force)`);
+        console.log(green(`[ok] Workspace synced at ${target} (system files updated; scaffold files kept unless --force)`));
     } else {
-        console.log(`[ok] Workspace structure created at ${target}`);
+        console.log(green(`[ok] Workspace structure created at ${target}`));
     }
 
     const gitCheck = tryGit(['--version'], target);
     if (!gitCheck.ok) {
-        console.log('[warn] git not found in PATH - skipping git init.');
+        console.log(yellow('[warn] git not found in PATH - skipping git init.'));
         return;
     }
 
     if (!fs.existsSync(path.join(target, '.git'))) {
         tryGit(['init', '-q'], target);
-        console.log('[ok] git init');
+        console.log(green('[ok] git init'));
     }
 
+    // Local-only override: stops git from silently converting LF<->CRLF (and
+    // printing a warning per file) on Windows checkouts, regardless of the
+    // user's global core.autocrlf. This workspace's text files are always LF.
+    tryGit(['config', 'core.autocrlf', 'false'], target);
+
     const currentBranchResult = tryGit(['branch', '--show-current'], target);
     const currentBranch = currentBranchResult.ok ? currentBranchResult.out.trim() : '';
 
@@ -159,7 +302,7 @@ function main() {
         } else {
             tryGit(['checkout', '-q', '-b', branch], target);
         }
-        console.log(`[ok] branch '${branch}' is active`);
+        console.log(green(`[ok] branch '${branch}' is active`));
     }
 
     tryGit(['add', '-A'], target);
@@ -169,13 +312,16 @@ function main() {
         const msg = isRerun ? 'chore: sync vsem-framework system files' : 'chore: bootstrap vsem-framework workspace';
         const commitResult = tryGit(['commit', '-q', '-m', msg], target);
         if (commitResult.ok) {
-            console.log(`[ok] commit created: ${msg}`);
+            console.log(green(`[ok] commit created: ${msg}`));
         } else {
-            console.log('[warn] git commit failed (is git config user.name/user.email set?) - changes are staged but not committed.');
+            console.log(yellow('[warn] git commit failed (is git config user.name/user.email set?) - changes are staged but not committed.'));
         }
     } else {
-        console.log('[skip] nothing to commit (already up to date)');
+        console.log(dim('[skip] nothing to commit (already up to date)'));
     }
 }
 
-main();
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vsem/ai",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Install or sync a vsem-framework workspace (.ai/ structure, roles, rules) via npx.",
   "bin": {
     "vsem-ai": "bin/cli.js"

package/templates/system/CLAUDE.md.tmpl

@@ -4,5 +4,8 @@ This project is managed by vsem-framework.
 Work according to the rules and structure in `.ai/`.
 Start with `.ai/rules/core.md` and `.ai/project.md`.
 
+Communicate with the user, and think, in **{{LANGUAGE}}**, unless they ask you
+to switch.
+
 **Hard rule:** never modify the top-level structure of `.ai/` (create/delete/rename
 top-level folders inside it) without explicit human confirmation.