@torus-engineering/tas-kit 1.12.0 → 1.13.0

package/.tas/README.md

@@ -1,6 +1,6 @@
 # TAS Kit
 
-**Torus Agentic SDLC Kit** — AI-assisted SDLC toolkit, designed following Spec-Driven Development philosophy and Context-Aware Architecture.
+Turbo AI-first toolkit for modern agentic SDLC teams.
 
 ---
 
@@ -33,8 +33,8 @@ All code starts from spec. Story.md is "context digest" that has absorbed all in
 - When coding: MUST start new session (don't reuse old session that loaded PRD/SAD to avoid Window Context bloat)
 
 ### Role-Based & Template-Driven
-- 3 actual roles at Torus: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
-- Separate templates for PRD, SAD, ADR, Epic, Feature, Story per Torus standards
+- 3 roles: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
+- Separate templates for PRD, SAD, ADR, Epic, Feature, Story per team standards
 - Flow configurable via `tas.yaml` file
 
 ### Azure DevOps Compatible

package/.tas/commands/tas-init.md

@@ -4,7 +4,7 @@ Initialize TAS kit for the current project.
 
 ## Actions
 1. Need context from root/tas.yaml. If not exists, copy from .tas/tas-example.yaml to root and ask user to fill required information.
-2. Create directory structure: .tas/templates/, docs/, docs/adr/, docs/epics/, docs/bugs/
+2. Create directory structure: .tas/templates/, docs/, docs/adr/, docs/epics/, docs/bugs/, docs/ref/
 3. Create root/project-status.yaml file with initial state (artifacts, epics, adrs all empty).
 4. Copy default templates to .tas/templates/ if not exist.
 5. If project type is brownfield and codebase_scan_on_init = true:

package/README.md

@@ -1,6 +1,6 @@
 # TAS Kit
 
-**Torus Agentic SDLC Kit** — AI-assisted SDLC toolkit, designed following Spec-Driven Development philosophy and Context-Aware Architecture.
+Turbo AI-first toolkit for modern agentic SDLC teams.
 
 ---
 
@@ -33,8 +33,8 @@ All code starts from spec. Story.md is "context digest" that has absorbed all in
 - When coding: MUST start new session (don't reuse old session that loaded PRD/SAD to avoid Window Context bloat)
 
 ### Role-Based & Template-Driven
-- 3 actual roles at Torus: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
-- Separate templates for PRD, SAD, ADR, Epic, Feature, Story per Torus standards
+- 3 roles: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
+- Separate templates for PRD, SAD, ADR, Epic, Feature, Story per team standards
 - Flow configurable via `tas.yaml` file
 
 ### Azure DevOps Compatible

package/bin/cli.js

@@ -6,7 +6,7 @@ const command = args[0];
 
 function printHelp() {
   console.log(`
-tas-kit — Torus Agentic SDLC Kit installer
+tas-kit — Turbo Agentic SDLC Kit installer
 
 Usage:
   npx @torus-engineering/tas-kit <command> [options]

package/lib/adapters/antigravity.js

@@ -55,9 +55,9 @@ export async function install({ tasDir, target }) {
     console.log('  [ok] .agents/rules/ (from .tas/rules/)');
   }
 
-  // lean AGENTS.md
-  await generateAgentsMd(agentsDir, target);
-  console.log('  [ok] AGENTS.md');
+  // platform index (not root AGENTS.md — that's the template/system prompt)
+  await generateReadme(agentsDir);
+  console.log('  [ok] .agents/README.md');
 }
 
 async function commandToWorkflow(file, agentsDir) {
@@ -95,7 +95,7 @@ async function convertRules(rulesDir, outDir) {
   }
 }
 
-async function generateAgentsMd(agentsDir, target) {
+async function generateReadme(agentsDir) {
   const workflowFiles = (await fs.readdir(agentsDir, { withFileTypes: true }))
     .filter(e => e.isFile() && e.name.endsWith('.md'))
     .map(e => `- \`/${e.name.replace('.md', '')}\``);
@@ -112,10 +112,8 @@ async function generateAgentsMd(agentsDir, target) {
     }
   }
 
-  const agentsMd = [
-    `# Project Instructions`,
-    ``,
-    `This project uses TAS Kit — Torus Agentic SDLC Kit.`,
+  const readme = [
+    `# TAS Kit — Antigravity`,
     ``,
     `## Workflows`,
     ``,
@@ -127,11 +125,7 @@ async function generateAgentsMd(agentsDir, target) {
     ``,
     ...skillLines,
     ``,
-    `## Project Configuration`,
-    ``,
-    `See \`tas.yaml\` for project settings and project instructions file for detailed conventions.`,
-    ``,
   ].join('\n');
 
-  await fs.writeFile(path.join(target, 'AGENTS.md'), agentsMd);
+  await fs.writeFile(path.join(agentsDir, 'README.md'), readme);
 }

package/lib/adapters/codex.js

@@ -52,9 +52,9 @@ export async function install({ tasDir, target }) {
     console.log('  [ok] .codex/skills/ (rules)');
   }
 
-  // lean AGENTS.md
-  await generateAgentsMd(skillsOut, target);
-  console.log('  [ok] AGENTS.md');
+  // platform index (not root AGENTS.md — that's the template/system prompt)
+  await generateReadme(skillsOut, codexDir);
+  console.log('  [ok] .codex/README.md');
 }
 
 async function commandToSkill(file, skillsOut) {
@@ -129,7 +129,7 @@ async function rulesToSkills(rulesDir, skillsOut) {
   }
 }
 
-async function generateAgentsMd(skillsOut, target) {
+async function generateReadme(skillsOut, codexDir) {
   const skillDirs = await fs.readdir(skillsOut, { withFileTypes: true });
   const skillLines = [];
   for (const d of skillDirs.filter(e => e.isDirectory())) {
@@ -142,22 +142,16 @@ async function generateAgentsMd(skillsOut, target) {
     }
   }
 
-  const agentsMd = [
-    `# Project Instructions`,
-    ``,
-    `This project uses TAS Kit — Torus Agentic SDLC Kit.`,
+  const readme = [
+    `# TAS Kit — Codex`,
     ``,
     `## Available Skills`,
     ``,
-    `Use \`/skills\` to list and invoke skills. Available skills:`,
+    `Use \`/skills\` to list and invoke skills:`,
     ``,
     ...skillLines,
     ``,
-    `## Project Configuration`,
-    ``,
-    `See \`tas.yaml\` for project settings and \`CLAUDE.md\` for detailed instructions.`,
-    ``,
   ].join('\n');
 
-  await fs.writeFile(path.join(target, 'AGENTS.md'), agentsMd);
+  await fs.writeFile(path.join(codexDir, 'README.md'), readme);
 }

package/lib/install.js

@@ -10,6 +10,25 @@ const TAS_SRC = path.join(PACKAGE_DIR, '.tas');
 const PLATFORMS_FILE = '.tas/platforms.json';
 const require = createRequire(import.meta.url);
 
+// ─── Logo ────────────────────────────────────────────────────────────────────
+
+function printLogo() {
+  const c = '\x1b[36m';
+  const d = '\x1b[90m';
+  const r = '\x1b[0m';
+  const art = [
+    `  ████████╗  █████╗ ███████╗   ██╗  ██╗ ██╗ ████████╗`,
+    `  ╚══██╔══╝ ██╔══██╗██╔════╝   ██║ ██╔╝ ██║ ╚══██╔══╝`,
+    `     ██║    ███████║███████╗   █████╔╝  ██║    ██║   `,
+    `     ██║    ██╔══██║╚════██║   ██╔═██╗  ██║    ██║   `,
+    `     ██║    ██║  ██║███████║   ██║  ██╗ ██║    ██║   `,
+    `     ╚═╝    ╚═╝  ╚═╝╚══════╝   ╚═╝  ╚═╝ ╚═╝    ╚═╝   `,
+  ].map(l => c + l + r).join('\n');
+  process.stdout.write('\n' + art + '\n' + d + '  Turbo Agentic SDLC Kit' + r + '\n\n');
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
 async function getDeletedFiles() {
   try {
     const manifest = require('./deleted-files.json');
@@ -57,30 +76,151 @@ async function copyDir(src, dest) {
   await fs.cp(src, dest, { recursive: true });
 }
 
+const TAS_ROOT_EXCLUDE = new Set([
+  'tas-example.yaml',
+  'project-status-example.yaml',
+  'platforms.json',
+  'agents',
+  'commands',
+  'skills',
+]);
+
+async function copyTasDir(src, dest) {
+  await fs.cp(src, dest, {
+    recursive: true,
+    filter: (srcPath) => !TAS_ROOT_EXCLUDE.has(path.relative(src, srcPath)),
+  });
+}
+
+async function chmodExecutables(target) {
+  const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
+  if (await exists(adoPy)) await fs.chmod(adoPy, 0o755);
+
+  const preCommit = path.join(target, '.tas', 'hooks', 'pre-commit');
+  if (await exists(preCommit)) await fs.chmod(preCommit, 0o755);
+
+  const hooksDir = path.join(target, '.tas', '_platform', 'hooks');
+  if (await exists(hooksDir)) {
+    const files = await fs.readdir(hooksDir);
+    for (const f of files) await fs.chmod(path.join(hooksDir, f), 0o755);
+  }
+}
+
 // ─── Platform selection ───────────────────────────────────────────────────────
 
-async function choosePlatforms({ yes, forced }) {
-  if (forced && forced.length > 0) return forced;
-  if (yes) return ['claude-code'];
+async function checkboxSelect(title, items, defaultIndexes = [0]) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return fallbackTextSelect(title, items, defaultIndexes);
+  }
+
+  const selected = new Set(defaultIndexes);
+  let cursor = defaultIndexes[0] ?? 0;
+  let renderedLines = 0;
+
+  const clearRendered = () => {
+    if (renderedLines > 0) {
+      process.stdout.write(`\x1b[${renderedLines}A\x1b[0J`);
+    }
+  };
+
+  const render = () => {
+    clearRendered();
+    const lines = [];
+    lines.push(`  ${title}`);
+    lines.push('');
+    for (let i = 0; i < items.length; i++) {
+      const mark = selected.has(i) ? '\x1b[32m◉\x1b[0m' : '○';
+      const arrow = cursor === i ? '\x1b[36m›\x1b[0m' : ' ';
+      const label = cursor === i ? `\x1b[36m${items[i].label}\x1b[0m` : items[i].label;
+      const note = items[i].note ? ` \x1b[90m${items[i].note}\x1b[0m` : '';
+      lines.push(`  ${arrow} ${mark} ${label}${note}`);
+    }
+    lines.push('');
+    lines.push('\x1b[90m  ↑↓ navigate   space select   enter confirm\x1b[0m');
+    renderedLines = lines.length;
+    process.stdout.write(lines.join('\n') + '\n');
+  };
+
+  return new Promise((resolve) => {
+    process.stdout.write('\x1b[?25l');
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    render();
+
+    const onKey = (key) => {
+      if (key === '\x03') {
+        finish(null);
+        process.exit(0);
+      } else if (key === '\x1b[A') {
+        cursor = (cursor - 1 + items.length) % items.length;
+        render();
+      } else if (key === '\x1b[B') {
+        cursor = (cursor + 1) % items.length;
+        render();
+      } else if (key === ' ') {
+        if (selected.has(cursor)) selected.delete(cursor);
+        else selected.add(cursor);
+        render();
+      } else if (key === '\r' || key === '\n') {
+        const ids = items.filter((_, i) => selected.has(i)).map(it => it.id);
+        finish(ids.length > 0 ? ids : [items[cursor].id]);
+      }
+    };
+
+    const finish = (result) => {
+      process.stdin.removeListener('data', onKey);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdout.write('\x1b[?25h');
+      clearRendered();
+      if (result) {
+        const labels = result.map(id => items.find(it => it.id === id)?.label || id).join(', ');
+        process.stdout.write(`  Platforms: \x1b[36m${labels}\x1b[0m\n\n`);
+        resolve(result);
+      }
+    };
+
+    process.stdin.on('data', onKey);
+  });
+}
 
-  console.log('\n  Agentic Coding Platform(s) to install:');
-  PLATFORMS.forEach((p, i) => {
-    const def = p.id === 'claude-code' ? ' (default)' : '';
-    console.log(`    [${i + 1}] ${p.label}${def}`);
+async function fallbackTextSelect(title, items, defaultIndexes) {
+  console.log(`\n  ${title}`);
+  items.forEach((item, i) => {
+    const def = defaultIndexes.includes(i) ? ' (default)' : '';
+    console.log(`    [${i + 1}] ${item.label}${def}`);
   });
   console.log('');
   console.log('  Enter numbers comma-separated for multiple platforms.');
-  const answer = await ask('  Choose [1/2/3/4] (default: 1): ', '1');
+  const nums = items.map((_, i) => i + 1).join('/');
+  const answer = await ask(`  Choose [${nums}] (default: 1): `, '1');
 
   const selected = [];
   for (const part of answer.split(',')) {
     const idx = parseInt(part.trim(), 10) - 1;
-    if (idx >= 0 && idx < PLATFORMS.length) {
-      const id = PLATFORMS[idx].id;
+    if (idx >= 0 && idx < items.length) {
+      const id = items[idx].id;
       if (!selected.includes(id)) selected.push(id);
     }
   }
-  return selected.length > 0 ? selected : ['claude-code'];
+  return selected.length > 0 ? selected : [items[defaultIndexes[0] ?? 0].id];
+}
+
+async function choosePlatforms({ yes, forced }) {
+  if (forced && forced.length > 0) return forced;
+  if (yes) return ['claude-code'];
+
+  return checkboxSelect(
+    'Agentic Coding Platform(s) to install:',
+    PLATFORMS.map(p => ({
+      id: p.id,
+      label: p.label,
+      note: p.id === 'claude-code' ? '(default)' : '',
+    })),
+    [0],
+  );
 }
 
 async function savePlatforms(target, platforms) {
@@ -240,6 +380,7 @@ async function installSecurityHook({ target, mode }) {
 // ─── Update ──────────────────────────────────────────────────────────────────
 
 export async function update({ directory, yes, securityHook, platforms: forcedPlatforms }) {
+  printLogo();
   const target = path.resolve(directory);
 
   const tasExists = await exists(path.join(target, '.tas'));
@@ -249,7 +390,7 @@ export async function update({ directory, yes, securityHook, platforms: forcedPl
     process.exit(1);
   }
 
-  console.log(`\nUpdating TAS Kit in: ${target}\n`);
+  console.log(`Updating TAS Kit in: ${target}\n`);
 
   const platforms = forcedPlatforms && forcedPlatforms.length > 0
     ? forcedPlatforms
@@ -270,7 +411,7 @@ export async function update({ directory, yes, securityHook, platforms: forcedPl
 
   const tasDest = path.join(target, '.tas');
   if (path.resolve(TAS_SRC) !== path.resolve(tasDest)) {
-    await copyDir(TAS_SRC, tasDest);
+    await copyTasDir(TAS_SRC, tasDest);
   }
   console.log('  [ok] .tas/ (updated)');
 
@@ -282,7 +423,7 @@ export async function update({ directory, yes, securityHook, platforms: forcedPl
     }
   }
 
-  await runPlatformAdapters(platforms, { tasDir: path.join(target, '.tas'), target });
+  await runPlatformAdapters(platforms, { tasDir: TAS_SRC, target });
 
   await savePlatforms(target, platforms);
 
@@ -294,7 +435,8 @@ export async function update({ directory, yes, securityHook, platforms: forcedPl
     await installSecurityHook({ target, mode: securityHook });
   }
 
-  console.log(`  [--] CLAUDE.md, tas.yaml, .env.example — not touched`);
+  const configFilename = platforms.includes('claude-code') ? 'CLAUDE.md' : 'AGENTS.md';
+  console.log(`  [--] ${configFilename}, tas.yaml, project-status.yaml, .env.example — not touched`);
   console.log(`
 TAS Kit updated successfully!
 
@@ -306,11 +448,12 @@ and manually merge changes into your CLAUDE.md and tas.yaml if needed.
 // ─── Install ─────────────────────────────────────────────────────────────────
 
 export async function install({ directory, yes, securityHook, platforms: forcedPlatforms }) {
+  printLogo();
   const target = path.resolve(directory);
 
   await fs.mkdir(target, { recursive: true });
 
-  console.log(`\nInstalling TAS Kit into: ${target}\n`);
+  console.log(`Installing TAS Kit into: ${target}\n`);
 
   const tasExists = await exists(path.join(target, '.tas'));
   if (tasExists && !yes) {
@@ -327,7 +470,7 @@ export async function install({ directory, yes, securityHook, platforms: forcedP
   // Copy .tas/ (skip if installing into the package itself)
   const tasDest = path.join(target, '.tas');
   if (path.resolve(TAS_SRC) !== path.resolve(tasDest)) {
-    await copyDir(TAS_SRC, tasDest);
+    await copyTasDir(TAS_SRC, tasDest);
     console.log('  [ok] .tas/');
   } else {
     console.log('  [--] .tas/ (source = destination, skipped)');
@@ -335,16 +478,18 @@ export async function install({ directory, yes, securityHook, platforms: forcedP
 
   // Platform selection
   const platforms = await choosePlatforms({ yes, forced: forcedPlatforms });
-  await runPlatformAdapters(platforms, { tasDir: path.join(target, '.tas'), target });
+  await runPlatformAdapters(platforms, { tasDir: TAS_SRC, target });
   await savePlatforms(target, platforms);
 
   // Project config files (first-time only)
-  const claudeMdTarget = path.join(target, 'CLAUDE.md');
-  if (!(await exists(claudeMdTarget))) {
-    await fs.copyFile(path.join(PACKAGE_DIR, '.tas', 'templates', 'AGENTS.md'), claudeMdTarget);
-    console.log('  [ok] CLAUDE.md (from .tas/templates/AGENTS.md)');
+  // Claude Code uses CLAUDE.md; all other platforms use AGENTS.md
+  const configFilename = platforms.includes('claude-code') ? 'CLAUDE.md' : 'AGENTS.md';
+  const configTarget = path.join(target, configFilename);
+  if (!(await exists(configTarget))) {
+    await fs.copyFile(path.join(PACKAGE_DIR, '.tas', 'templates', 'AGENTS.md'), configTarget);
+    console.log(`  [ok] ${configFilename} (from .tas/templates/AGENTS.md)`);
   } else {
-    console.log('  [--] CLAUDE.md already exists, skipped');
+    console.log(`  [--] ${configFilename} already exists, skipped`);
   }
 
   const envExampleTarget = path.join(target, '.env.example');
@@ -363,6 +508,17 @@ export async function install({ directory, yes, securityHook, platforms: forcedP
     console.log('  [--] tas.yaml already exists, skipped');
   }
 
+  const psYamlTarget = path.join(target, 'project-status.yaml');
+  if (!(await exists(psYamlTarget))) {
+    const psSrc = path.join(PACKAGE_DIR, '.tas', 'project-status-example.yaml');
+    if (await exists(psSrc)) {
+      await fs.copyFile(psSrc, psYamlTarget);
+      console.log('  [ok] project-status.yaml (from .tas/project-status-example.yaml)');
+    }
+  } else {
+    console.log('  [--] project-status.yaml already exists, skipped');
+  }
+
   if (process.platform !== 'win32') {
     await chmodExecutables(target);
   }
@@ -375,7 +531,7 @@ export async function install({ directory, yes, securityHook, platforms: forcedP
 TAS Kit installed successfully! (Platforms: ${platformLabels})
 
 Next steps:
-  1. Edit CLAUDE.md     — add your project's tech stack and conventions
+  1. Edit ${configFilename.padEnd(10)} — add your project's tech stack and conventions
   2. Edit tas.yaml      — set project name, team and ADO config
   3. Create .env        — add AZURE_DEVOPS_PAT (see .env.example)
   4. Open your IDE      — run /tas-init to initialize your project
@@ -385,19 +541,3 @@ Docs:
   .tas/hooks/README.md     — pre-commit security hook details
   `);
 }
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-
-async function chmodExecutables(target) {
-  const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
-  if (await exists(adoPy)) await fs.chmod(adoPy, 0o755);
-
-  const preCommit = path.join(target, '.tas', 'hooks', 'pre-commit');
-  if (await exists(preCommit)) await fs.chmod(preCommit, 0o755);
-
-  const hooksDir = path.join(target, '.tas', '_platform', 'hooks');
-  if (await exists(hooksDir)) {
-    const files = await fs.readdir(hooksDir);
-    for (const f of files) await fs.chmod(path.join(hooksDir, f), 0o755);
-  }
-}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@torus-engineering/tas-kit",
-  "version": "1.12.0",
-  "description": "Torus Agentic SDLC Kit — Collection of commands, skills, rules, hooks, agents and workflows for modern AI-First SDLC",
+  "version": "1.13.0",
+  "description": "Turbo AI-first toolkit for modern agentic SDLC teams.",
   "type": "module",
   "bin": {
     "tas-kit": "bin/cli.js"