@vsem/ai 0.1.2 → 0.1.3

package/README.md

@@ -14,18 +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] [--yes]
+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 confirmation prompt.
+- `--yes` / `-y` — skip the interactive wizard and confirmation prompt, accepting all defaults.
 
-In an interactive terminal, the CLI shows a banner and an install confirmation
-prompt before touching disk; press Enter to proceed or `n` to cancel. In
-non-interactive contexts (CI, pipes) it detects the lack of a TTY and
-proceeds automatically, same as passing `--yes`.
+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,7 +17,7 @@
 //   user's own project state. Pass --force to overwrite scaffold files too.
 //
 // Usage:
-//   npx @vsem/ai@latest [target-dir] [--branch <name>] [--force] [--yes]
+//   npx @vsem/ai@latest [target-dir] [--branch <name>] [--lang <language>] [--force] [--yes]
 
 const fs = require('fs');
 const path = require('path');
@@ -26,6 +26,7 @@ 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');
@@ -81,12 +82,24 @@ function renderButton(label) {
     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.
-function confirmInstall(info, opts) {
+// 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('');
 
@@ -100,10 +113,8 @@ function confirmInstall(info, opts) {
     console.log(renderButton('Установить') + '\n');
     console.log(dim('Enter — установить, n — отменить'));
 
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     return new Promise((resolve) => {
         rl.question('> ', (answer) => {
-            rl.close();
             console.log('');
             resolve(!/^n(o)?$/i.test(answer.trim()));
         });
@@ -111,7 +122,7 @@ function confirmInstall(info, opts) {
 }
 
 function parseArgs(argv) {
-    const opts = { target: null, branch: null, force: false, yes: 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') {
@@ -122,6 +133,10 @@ function parseArgs(argv) {
             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;
         }
@@ -183,6 +198,18 @@ function tryGit(args, cwd) {
     }
 }
 
+// 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/.`);
@@ -190,30 +217,51 @@ async function main() {
     }
 
     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);
     }
 
-    printBanner();
-    const proceed = await confirmInstall({ target, branch, isRerun }, args);
+    const proceed = await confirmInstall({ target, branch, language, isRerun }, args, rl);
+    if (rl) rl.close();
+
     if (!proceed) {
         console.log(yellow('[cancelled] Ничего не изменено.'));
         return;
     }
 
-    fs.mkdirSync(target, { recursive: true });
-
-    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);
@@ -239,6 +287,11 @@ async function main() {
         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() : '';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vsem/ai",
-  "version": "0.1.2",
+  "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.