@argenalimbaev/template-agent 1.0.0 → 1.0.1

package/README.md

@@ -14,7 +14,7 @@
 npx --yes @argenalimbaev/template-agent@1 setup
 ```
 
-Перезапустите coding-agent, если новый skill не появился сразу. После этого можно написать:
+После установки CLI покажет краткий success-screen и следующий шаг. Перезапустите coding-agent, если новый skill не появился сразу. Затем можно написать:
 
 > Создай CRM-проект `sales-crm` с готовым dashboard. API уже существует.
 
@@ -26,7 +26,7 @@ npx --yes @argenalimbaev/template-agent@1 setup
 npx --yes @argenalimbaev/template-agent@1 create
 ```
 
-CLI спросит ровно две вещи: шаблон из списка и имя проекта.
+CLI спросит ровно две вещи: шаблон из списка и имя проекта. В интерактивном терминале номера, подсказки и success-screen подсвечиваются; JSON и неинтерактивный вывод остаются plain text.
 
 Или без вопросов:
 
@@ -41,6 +41,26 @@ pnpm dlx @argenalimbaev/template-agent@1 create
 bunx @argenalimbaev/template-agent@1 create
 ```
 
+## Terminal UX
+
+В обычном терминале CLI показывает компактные экраны: выбор template с цветными номерами, статус установки global skill, создание проекта и конкретные команды запуска.
+
+```text
+╭─ ✦ Template Agent ────────────────╮
+│ ✓ Проект создан
+╰───────────────────────────────────╯
+
+Дальше:
+  cd './sales-crm'
+  pnpm install
+  pnpm dev
+```
+
+- `--json` всегда печатает только JSON без ANSI-кодов — для скриптов и агентов.
+- Ошибки в интерактивном терминале выделяются красным, а успех — зелёным.
+- `NO_COLOR=1` отключает цвета, не меняя команды и результат.
+- Вне TTY (CI, pipe) CLI не добавляет цветовые коды.
+
 ## Доступные starters
 
 | ID | Когда выбирать | Не содержит |

package/bin/template-agent.mjs

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { runCli } from '../src/cli.mjs';
+import { formatCliError, shouldUseColor } from '../src/terminal-ui.mjs';
 
 try {
   await runCli(process.argv.slice(2));
 } catch (error) {
-  console.error(`ERROR: ${error.message}`);
+  console.error(formatCliError(error.message, { color: shouldUseColor({ isTTY: process.stderr.isTTY, json: process.argv.includes('--json'), noColor: !!process.env.NO_COLOR }) }));
   process.exitCode = 1;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@argenalimbaev/template-agent",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "AI-aware, registry-driven frontend project template CLI.",
   "type": "module",
   "bin": {

package/scripts/create-project.mjs

@@ -105,7 +105,7 @@ export function createProject({ entry, target, hubRoot = root, brief, keepHistor
     if (existsSync(ignoreFile)) writeFileSync(ignoreFile, readFileSync(ignoreFile, 'utf8').trimEnd() + '\n\n# Generated skill forwarding files\n.agents/skills\n.claude/skills\n.codex/skills\n');
     const agentFile = join(checkout, 'AGENTS.md');
     writeFileSync(agentFile, '# Hub-generated project\n\nRead `docs/PROJECT_BRIEF.md` when present. Canonical skills live in `.ai/skills`; `.agents/skills`, `.claude/skills` and `.codex/skills` contain portable forwarding files, not symlinks. This overrides older link descriptions below. Any coding agent may read these Markdown files directly; no provider plugin or global installation is required.\n\n' + readFileSync(agentFile, 'utf8'));
-    const metadata = { template: entry.id, repository: entry.repository, ref: entry.ref, commit, profile: entry.profile, skills: entry.skills, generatorVersion: '1.0.0', adapterMode: 'portable-forwarders' };
+    const metadata = { template: entry.id, repository: entry.repository, ref: entry.ref, commit, profile: entry.profile, skills: entry.skills, generatorVersion: '1.0.1', adapterMode: 'portable-forwarders' };
     writeFileSync(join(checkout, '.template-provenance.json'), JSON.stringify(metadata, null, 2) + '\n');
     if (brief) {
       const docs = join(checkout, 'docs');

package/src/catalog.mjs

@@ -4,7 +4,7 @@ import { dirname, join } from 'node:path';
 import { validateRegistry } from '../scripts/registry.mjs';
 import { compareSemver } from './semver.mjs';
 
-export const CLI_VERSION = '1.0.0';
+export const CLI_VERSION = '1.0.1';
 export const CATALOG_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
 export const MAX_CATALOG_BYTES = 1024 * 1024;
 export const DEFAULT_RELEASE_API_URL = 'https://api.github.com/repos/arg3n41ck/frontend-template-hub/releases?per_page=100';

package/src/cli.mjs

@@ -9,6 +9,7 @@ import { recommend } from '../scripts/recommend-template.mjs';
 import { CLI_VERSION, defaultCacheDirectory, resolveCatalog } from './catalog.mjs';
 import { compareSemver } from './semver.mjs';
 import { detectClients, findDuplicateSkillNames, installSkill, skillTargets, uninstallSkill } from './skill-manager.mjs';
+import { formatCreatePreview, formatCreateSuccess, formatDoctor, formatProjectCheck, formatSkillSummary, formatTemplates, formatUpdate, shouldUseColor, terminalPalette } from './terminal-ui.mjs';
 
 const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 const skillSource = join(root, 'skills', 'arg3n41ck-frontend-project', 'SKILL.md');
@@ -74,10 +75,6 @@ function assertSourcePolicy(entry, allowThirdParty) {
   }
 }
 
-function formatTemplates(templates) {
-  return templates.map((entry, index) => `${index + 1}. ${entry.name} (${entry.id}) — ${entry.description}`).join('\n');
-}
-
 async function interactivePrompt() {
   const readline = createInterface({ input: process.stdin, output: process.stdout });
   return {
@@ -86,16 +83,19 @@ async function interactivePrompt() {
   };
 }
 
-async function chooseCreateArguments({ templates, target, template, prompt }) {
+async function chooseCreateArguments({ templates, target, template, prompt, color }) {
   let selectedId = template;
   if (!selectedId) {
-    const answer = await prompt.ask(`Choose a template:\n${formatTemplates(templates)}\n> `);
+    const answer = await prompt.ask(formatTemplates(templates, { color, interactive: true }));
     const selected = templates[Number(answer) - 1];
     if (!selected) throw new Error('Choose a template number from the list.');
     selectedId = selected.id;
   }
   let selectedTarget = target;
-  if (!selectedTarget) selectedTarget = validateInteractiveProjectName(await prompt.ask('Project name: '));
+  if (!selectedTarget) {
+    const ui = terminalPalette(color);
+    selectedTarget = validateInteractiveProjectName(await prompt.ask(`${ui.accent('Название проекта')}: `));
+  }
   return { template: selectedId, target: selectedTarget };
 }
 
@@ -124,6 +124,7 @@ export async function runCli(argv, dependencies = {}) {
   const output = dependencies.output || (value => console.log(value));
   const cwd = dependencies.cwd || process.cwd();
   const environment = dependencies.environment || {};
+  const color = dependencies.color ?? shouldUseColor({ isTTY: process.stdout.isTTY, json: !!parsed.options.json, noColor: !!process.env.NO_COLOR });
   if (parsed.options.help || parsed.command === 'help') {
     output(usage());
     return { status: 'help' };
@@ -142,7 +143,8 @@ export async function runCli(argv, dependencies = {}) {
       if (!parsed.options.dryRun) rmSync(cache, { recursive: true, force: true });
       response.cache = parsed.options.dryRun ? 'would-remove' : 'removed';
     }
-    print(response, { json: !!parsed.options.json, output });
+    if (parsed.options.json) print(response, { json: true, output });
+    else output(formatSkillSummary({ skills: result, action: parsed.command, dryRun: !!parsed.options.dryRun, color }));
     return response;
   }
   if (parsed.command === 'doctor') {
@@ -159,7 +161,8 @@ export async function runCli(argv, dependencies = {}) {
       duplicateSkillFiles: findDuplicateSkillNames(environment),
       ok: nodeOk && gitOk,
     };
-    print(result, { json: !!parsed.options.json, output });
+    if (parsed.options.json) print(result, { json: true, output });
+    else output(formatDoctor(result, color));
     return result;
   }
   if (parsed.command === 'update') {
@@ -167,14 +170,15 @@ export async function runCli(argv, dependencies = {}) {
     const clients = detectClients(environment);
     const skills = clients.length ? installSkill({ targets: skillTargets({ clients, ...environment }), source: skillSource, dryRun: !!parsed.options.dryRun }) : [];
     const result = { catalog: { source: catalog.source, stale: catalog.stale, warning: catalog.warning || null }, skills };
-    print(result, { json: !!parsed.options.json, output });
+    if (parsed.options.json) print(result, { json: true, output });
+    else output(formatUpdate(result, color));
     return result;
   }
   const catalog = await catalogForCommand({}, dependencies);
   const templates = availableTemplates(catalog.registry);
   if (parsed.command === 'list') {
     const result = { source: catalog.source, templates };
-    print(parsed.options.json ? result : formatTemplates(templates), { json: !!parsed.options.json, output });
+    print(parsed.options.json ? result : formatTemplates(templates, { color }), { json: !!parsed.options.json, output });
     return result;
   }
   if (parsed.command === 'recommend') {
@@ -197,7 +201,8 @@ export async function runCli(argv, dependencies = {}) {
       generated: { ref: provenance.ref, commit: provenance.commit },
       updateAvailable: !!current && (current.ref !== provenance.ref || current.commit !== provenance.commit),
     };
-    print(result, { json: !!parsed.options.json, output });
+    if (parsed.options.json) print(result, { json: true, output });
+    else output(formatProjectCheck(result, color));
     return result;
   }
   if (parsed.command !== 'create') throw new Error(`Unsupported command: ${parsed.command}`);
@@ -207,20 +212,23 @@ export async function runCli(argv, dependencies = {}) {
       throw new Error('create needs a project name and --template outside an interactive terminal.');
     }
     if (!parsed.options.template || !parsed.target) prompt = dependencies.prompt || await interactivePrompt();
-    const selected = await chooseCreateArguments({ templates, target: parsed.target, template: parsed.options.template, prompt });
+    const selected = await chooseCreateArguments({ templates, target: parsed.target, template: parsed.options.template, prompt, color });
     const entry = templates.find(item => item.id === selected.template);
     if (!entry) throw new Error('Unknown template ID. Run template-agent list.');
     assertSourcePolicy(entry, !!parsed.options.allowThirdParty);
     const target = isAbsolute(selected.target) ? selected.target : resolve(cwd, selected.target);
     if (parsed.options.dryRun) {
       const result = { target, template: entry.id, source: catalog.source, dryRun: true };
-      print(result, { json: true, output });
+      if (parsed.options.json) print(result, { json: true, output });
+      else output(formatCreatePreview({ target, entry, color }));
       return result;
     }
+    if (!parsed.options.json) output(terminalPalette(color).accent(`✦ Создаю ${entry.name}…`));
     const brief = parsed.options.briefFile ? readFileSync(resolve(cwd, parsed.options.briefFile), 'utf8') : undefined;
     const metadata = createProject({ entry, target, brief, keepHistory: !!parsed.options.keepTemplateHistory });
     const result = { target, source: catalog.source, metadata };
-    print(result, { json: true, output });
+    if (parsed.options.json) print(result, { json: true, output });
+    else output(formatCreateSuccess({ target, entry, color }));
     return result;
   } finally {
     prompt?.close?.();

package/src/terminal-ui.mjs

@@ -0,0 +1,117 @@
+export function shouldUseColor({ isTTY, json = false, noColor = false }) {
+  return !!isTTY && !json && !noColor;
+}
+
+export function terminalPalette(color) {
+  const paint = (code, value) => color ? `\x1b[${code}m${value}\x1b[0m` : value;
+  return {
+    accent: value => paint('96', value),
+    bold: value => paint('1', value),
+    success: value => paint('32', value),
+    warning: value => paint('33', value),
+    danger: value => paint('31', value),
+    muted: value => paint('2', value),
+  };
+}
+
+function panel(title, color) {
+  const ui = terminalPalette(color);
+  return [
+    ui.accent('╭─ ✦ Template Agent ────────────────╮'),
+    `${ui.accent('│')} ${ui.success('✓')} ${ui.bold(title)}`,
+    ui.accent('╰───────────────────────────────────╯'),
+  ].join('\n');
+}
+
+function shellQuote(value) {
+  return `'${String(value).replaceAll("'", "'\\''")}'`;
+}
+
+export function formatCliError(message, { color = false } = {}) {
+  return terminalPalette(color).danger(`ERROR: ${message}`);
+}
+
+export function formatTemplates(templates, { color = false, interactive = false } = {}) {
+  const ui = terminalPalette(color);
+  const lines = templates.flatMap((entry, index) => [
+    `${ui.warning(String(index + 1))}  ${ui.bold(entry.name)} ${ui.muted(`(${entry.id})`)}`,
+    `   ${ui.muted(entry.description)}`,
+  ]);
+  if (!interactive) return lines.join('\n');
+  return [
+    ui.accent('✦ Новый проект'),
+    ui.muted('Выбери template. Нужны только номер и название проекта.'),
+    '',
+    ...lines,
+    '',
+    `${ui.accent('Введите номер')}: `,
+  ].join('\n');
+}
+
+export function formatCreateSuccess({ target, entry, color = false }) {
+  const ui = terminalPalette(color);
+  return [
+    panel('Проект создан', color),
+    `${ui.muted('Template:')} ${ui.bold(entry.name)} ${ui.muted(`(${entry.id})`)}`,
+    `${ui.muted('Папка:')} ${target}`,
+    '',
+    ui.accent('Дальше:'),
+    `  cd ${shellQuote(target)}`,
+    '  pnpm install',
+    '  pnpm dev',
+  ].join('\n');
+}
+
+export function formatCreatePreview({ target, entry, color }) {
+  const ui = terminalPalette(color);
+  return [
+    panel('Проверка создания', color),
+    `${ui.muted('Template:')} ${ui.bold(entry.name)} ${ui.muted(`(${entry.id})`)}`,
+    `${ui.muted('Папка:')} ${target}`,
+    ui.warning('Файлы не созданы: включён --dry-run.'),
+  ].join('\n');
+}
+
+export function formatSkillSummary({ skills, action, dryRun, color }) {
+  const ui = terminalPalette(color);
+  const installed = skills.some(item => item.status === 'installed' || item.status === 'updated');
+  const title = dryRun
+    ? `Проверка: ${action}`
+    : action === 'setup'
+      ? installed ? 'AI-skill готов' : 'AI-skill уже актуален'
+      : 'AI-skill удалён';
+  const details = skills.map(item => `  ${ui.muted('•')} ${ui.bold(item.client)}: ${item.status}`).join('\n');
+  const next = action === 'setup'
+    ? ['','Перезапусти Codex или Claude Code, если skill не появился сразу.', 'Затем просто опиши новый проект — агент выберет подходящий template.']
+    : [];
+  return [panel(title, color), details, ...next].filter(Boolean).join('\n');
+}
+
+export function formatDoctor(result, color) {
+  const ui = terminalPalette(color);
+  const state = value => value ? ui.success('✓') : ui.danger('✗');
+  return [
+    panel(result.ok ? 'Среда готова' : 'Среда требует внимания', color),
+    `${state(result.node.supported)} Node.js ${result.node.version}`,
+    `${state(result.git.supported)} Git`,
+    `${ui.muted('Catalog:')} ${result.catalog.source}${result.catalog.stale ? ' (stale)' : ''}`,
+  ].join('\n');
+}
+
+export function formatUpdate(result, color) {
+  const ui = terminalPalette(color);
+  return [
+    panel('Catalog обновлён', color),
+    `${ui.muted('Источник:')} ${result.catalog.source}`,
+    result.skills.length ? `${ui.muted('Skills:')} ${result.skills.map(item => `${item.client} — ${item.status}`).join(', ')}` : ui.muted('Skills: поддерживаемые клиенты не найдены.'),
+  ].join('\n');
+}
+
+export function formatProjectCheck(result, color) {
+  const ui = terminalPalette(color);
+  return [
+    panel(result.updateAvailable ? 'Есть обновление template' : 'Template актуален', color),
+    `${ui.muted('Проект:')} ${result.project}`,
+    `${ui.muted('Template:')} ${result.template}`,
+  ].join('\n');
+}