@vsem/ai 0.1.0 → 0.1.2

package/README.md

@@ -14,15 +14,46 @@ 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>] [--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`).
 - `--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.
+
+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`.
 
 ## Updating an existing workspace
 
 Rerun `npx @vsem/ai@latest` (without `--force`) inside an already-bootstrapped
 workspace to pick up new roles or rule changes published in later versions — your
 `project.md`, `plan.md`, and tasks are left untouched.
+
+## Releasing (CI/CD)
+
+- `.github/workflows/ci.yml` — runs on every push/PR to `main`: validates
+  `package.json`, dry-run `npm pack`, and a smoke test of `bin/cli.js` against a
+  scratch directory.
+- `.github/workflows/release.yml` — on a pushed tag matching `v*.*.*`, calls the
+  reusable workflow in [vsem-org/.github](https://github.com/vsem-org/.github)
+  to run `npm publish` via **npm Trusted Publishing (OIDC)** — no long-lived
+  `NPM_TOKEN` secret involved. Configured once on npmjs.com (package Settings ->
+  Trusted Publisher -> GitHub Actions):
+  - Organization or user: `vsem-org`
+  - Repository: `-core--ai`
+  - Workflow filename: `release.yml` (the *calling* workflow, not the reusable
+    one in `vsem-org/.github` — npm validates the caller)
+  - Allowed actions: direct `npm publish` enabled
+
+To ship a new version:
+
+```bash
+npm version patch   # or minor / major - bumps package.json, commits, tags
+git push --follow-tags
+```
+
+CI publishes automatically once the tag lands.

package/bin/cli.js

@@ -17,24 +17,107 @@
 //   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>] [--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 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}`;
+}
+
+// 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) {
+    console.log(`  ${dim('Папка:')}  ${info.target}`);
+    console.log(`  ${dim('Ветка:')}  ${info.branch}`);
+    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 — отменить'));
+
+    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()));
+        });
+    });
+}
+
 function parseArgs(argv) {
-    const opts = { target: null, branch: null, force: false };
+    const opts = { target: null, branch: 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=')) {
@@ -100,7 +183,7 @@ function tryGit(args, cwd) {
     }
 }
 
-function main() {
+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);
@@ -108,8 +191,6 @@ function main() {
 
     const args = parseArgs(process.argv.slice(2));
     const target = path.resolve(args.target || process.cwd());
-
-    fs.mkdirSync(target, { recursive: true });
     const aiDir = path.join(target, '.ai');
     const workspaceName = path.basename(target);
     const isRerun = fs.existsSync(aiDir);
@@ -123,6 +204,15 @@ function main() {
         if (!branch) branch = 'dev';
     }
 
+    printBanner();
+    const proceed = await confirmInstall({ target, branch, isRerun }, args);
+    if (!proceed) {
+        console.log(yellow('[cancelled] Ничего не изменено.'));
+        return;
+    }
+
+    fs.mkdirSync(target, { recursive: true });
+
     const vars = { WORKSPACE_NAME: workspaceName, FRAMEWORK_VERSION: FRAMEWORK_VERSION };
 
     copyTemplateTree(SYSTEM_DIR, target, vars, true);
@@ -133,20 +223,20 @@ 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'));
     }
 
     const currentBranchResult = tryGit(['branch', '--show-current'], target);
@@ -159,7 +249,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);
@@ -167,11 +257,18 @@ function main() {
 
     if (!noChanges) {
         const msg = isRerun ? 'chore: sync vsem-framework system files' : 'chore: bootstrap vsem-framework workspace';
-        tryGit(['commit', '-q', '-m', msg], target);
-        console.log(`[ok] commit created: ${msg}`);
+        const commitResult = tryGit(['commit', '-q', '-m', msg], target);
+        if (commitResult.ok) {
+            console.log(green(`[ok] commit created: ${msg}`));
+        } else {
+            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.0",
+  "version": "0.1.2",
   "description": "Install or sync a vsem-framework workspace (.ai/ structure, roles, rules) via npx.",
   "bin": {
     "vsem-ai": "bin/cli.js"