@torus-engineering/tas-kit 1.14.0 → 2.1.0

package/bin/cli.js

@@ -1,91 +1,91 @@
 #!/usr/bin/env node
-import { install, update } from '../lib/install.js';
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-function printHelp() {
-  console.log(`
-tas-kit — Turbo Agentic SDLC Kit installer
-
-Usage:
-  npx @torus-engineering/tas-kit <command> [options]
-
-Commands:
-  install   Copy TAS Kit files into a project (first-time setup)
-  update    Overwrite .tas/ and platform directories with the latest kit version
-            (preserves CLAUDE.md, tas.yaml, .env.example)
-
-Options:
-  --directory <path>          Target directory (default: current working directory)
-  --yes, -y                   Skip confirmation prompts
-  --platform <id,...>         Platform(s) to install: claude-code, cursor, codex, antigravity
-                              Comma-separated for multiple (default: interactive prompt)
-  --security-hook <mode>      Pre-commit hook mode: husky | native | none
-  --help, -h                  Show this help message
-
-Platforms:
-  claude-code    Claude Code CLI (default)
-  cursor         Cursor IDE
-  codex          OpenAI Codex CLI
-  antigravity    Google Antigravity IDE
-
-Examples:
-  npx @torus-engineering/tas-kit install
-  npx @torus-engineering/tas-kit install --platform claude-code,cursor
-  npx @torus-engineering/tas-kit install --platform codex --yes
-  npx @torus-engineering/tas-kit install --yes --security-hook=husky
-  npx @torus-engineering/tas-kit update
-  npx @torus-engineering/tas-kit update --platform cursor
-  `.trim());
-}
-
-if (!command || command === '--help' || command === '-h') {
-  printHelp();
-  process.exit(0);
-}
-
-if (command !== 'install' && command !== 'update') {
-  console.error(`Unknown command: "${command}"\n`);
-  printHelp();
-  process.exit(1);
-}
-
-const VALID_PLATFORMS = ['claude-code', 'cursor', 'codex', 'antigravity'];
-const opts = { directory: process.cwd(), yes: false, securityHook: null, platforms: [] };
-
-for (let i = 1; i < args.length; i++) {
-  const a = args[i];
-  if ((a === '--directory' || a === '-d') && args[i + 1]) {
-    opts.directory = args[++i];
-  } else if (a === '--yes' || a === '-y') {
-    opts.yes = true;
-  } else if (a.startsWith('--security-hook=')) {
-    opts.securityHook = a.slice('--security-hook='.length).toLowerCase();
-  } else if (a === '--security-hook' && args[i + 1]) {
-    opts.securityHook = args[++i].toLowerCase();
-  } else if (a.startsWith('--platform=')) {
-    opts.platforms = a.slice('--platform='.length).split(',').map(s => s.trim().toLowerCase());
-  } else if (a === '--platform' && args[i + 1]) {
-    opts.platforms = args[++i].split(',').map(s => s.trim().toLowerCase());
-  }
-}
-
-if (opts.securityHook && !['husky', 'native', 'none'].includes(opts.securityHook)) {
-  console.error(`Invalid --security-hook value: "${opts.securityHook}"`);
-  console.error(`Expected one of: husky, native, none`);
-  process.exit(1);
-}
-
-const invalidPlatforms = opts.platforms.filter(p => !VALID_PLATFORMS.includes(p));
-if (invalidPlatforms.length > 0) {
-  console.error(`Invalid platform(s): ${invalidPlatforms.join(', ')}`);
-  console.error(`Valid platforms: ${VALID_PLATFORMS.join(', ')}`);
-  process.exit(1);
-}
-
-const runner = command === 'update' ? update : install;
-runner(opts).catch((err) => {
-  console.error(`\n${command === 'update' ? 'Update' : 'Install'} failed:`, err.message);
-  process.exit(1);
-});
+import { install, update } from '../lib/install.js';
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+function printHelp() {
+  console.log(`
+tas-kit — Turbo Agentic SDLC Kit installer
+
+Usage:
+  npx @torus-engineering/tas-kit <command> [options]
+
+Commands:
+  install   Copy TAS Kit files into a project (first-time setup)
+  update    Overwrite .tas/ and platform directories with the latest kit version
+            (preserves CLAUDE.md, tas.yaml, .env.example)
+
+Options:
+  --directory <path>          Target directory (default: current working directory)
+  --yes, -y                   Skip confirmation prompts
+  --platform <id,...>         Platform(s) to install: claude-code, cursor, codex, antigravity
+                              Comma-separated for multiple (default: interactive prompt)
+  --security-hook <mode>      Pre-commit hook mode: husky | native | none
+  --help, -h                  Show this help message
+
+Platforms:
+  claude-code    Claude Code CLI (default)
+  cursor         Cursor IDE
+  codex          OpenAI Codex CLI
+  antigravity    Google Antigravity IDE
+
+Examples:
+  npx @torus-engineering/tas-kit install
+  npx @torus-engineering/tas-kit install --platform claude-code,cursor
+  npx @torus-engineering/tas-kit install --platform codex --yes
+  npx @torus-engineering/tas-kit install --yes --security-hook=husky
+  npx @torus-engineering/tas-kit update
+  npx @torus-engineering/tas-kit update --platform cursor
+  `.trim());
+}
+
+if (!command || command === '--help' || command === '-h') {
+  printHelp();
+  process.exit(0);
+}
+
+if (command !== 'install' && command !== 'update') {
+  console.error(`Unknown command: "${command}"\n`);
+  printHelp();
+  process.exit(1);
+}
+
+const VALID_PLATFORMS = ['claude-code', 'cursor', 'codex', 'antigravity'];
+const opts = { directory: process.cwd(), yes: false, securityHook: null, platforms: [] };
+
+for (let i = 1; i < args.length; i++) {
+  const a = args[i];
+  if ((a === '--directory' || a === '-d') && args[i + 1]) {
+    opts.directory = args[++i];
+  } else if (a === '--yes' || a === '-y') {
+    opts.yes = true;
+  } else if (a.startsWith('--security-hook=')) {
+    opts.securityHook = a.slice('--security-hook='.length).toLowerCase();
+  } else if (a === '--security-hook' && args[i + 1]) {
+    opts.securityHook = args[++i].toLowerCase();
+  } else if (a.startsWith('--platform=')) {
+    opts.platforms = a.slice('--platform='.length).split(',').map(s => s.trim().toLowerCase());
+  } else if (a === '--platform' && args[i + 1]) {
+    opts.platforms = args[++i].split(',').map(s => s.trim().toLowerCase());
+  }
+}
+
+if (opts.securityHook && !['husky', 'native', 'none'].includes(opts.securityHook)) {
+  console.error(`Invalid --security-hook value: "${opts.securityHook}"`);
+  console.error(`Expected one of: husky, native, none`);
+  process.exit(1);
+}
+
+const invalidPlatforms = opts.platforms.filter(p => !VALID_PLATFORMS.includes(p));
+if (invalidPlatforms.length > 0) {
+  console.error(`Invalid platform(s): ${invalidPlatforms.join(', ')}`);
+  console.error(`Valid platforms: ${VALID_PLATFORMS.join(', ')}`);
+  process.exit(1);
+}
+
+const runner = command === 'update' ? update : install;
+runner(opts).catch((err) => {
+  console.error(`\n${command === 'update' ? 'Update' : 'Install'} failed:`, err.message);
+  process.exit(1);
+});

package/lib/adapters/antigravity.js

@@ -1,131 +1,131 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import {
-  exists, listFilesRecursive,
-  parseFrontmatter, extractDescription, extractCommandName, extractH1, yamlValue,
-} from './utils.js';
-
-export const PLATFORM_ID = 'antigravity';
-export const PLATFORM_LABEL = 'Antigravity';
-
-export async function install({ tasDir, target }) {
-  const agentsDir = path.join(target, '.agents');
-  await fs.mkdir(agentsDir, { recursive: true });
-  await fs.mkdir(path.join(agentsDir, 'rules'), { recursive: true });
-  await fs.mkdir(path.join(agentsDir, 'skills'), { recursive: true });
-
-  // commands → .agents/<name>.md (Antigravity workflows)
-  const commandsDir = path.join(tasDir, 'commands');
-  if (await exists(commandsDir)) {
-    const files = await listFilesRecursive(commandsDir, '.md');
-    for (const file of files) {
-      await commandToWorkflow(file, agentsDir);
-    }
-    console.log('  [ok] .agents/ (workflows from commands)');
-  }
-
-  // agents → .agents/skills/<name>/SKILL.md
-  const agentsSrc = path.join(tasDir, 'agents');
-  if (await exists(agentsSrc)) {
-    const files = await listFilesRecursive(agentsSrc, '.md');
-    for (const file of files) {
-      await agentToSkill(file, path.join(agentsDir, 'skills'));
-    }
-    console.log('  [ok] .agents/skills/ (agents)');
-  }
-
-  // kit skills → .agents/skills/ (copy as-is, same open standard)
-  const skillsSrc = path.join(tasDir, 'skills');
-  if (await exists(skillsSrc)) {
-    const skillDirs = await fs.readdir(skillsSrc, { withFileTypes: true });
-    for (const d of skillDirs.filter(e => e.isDirectory())) {
-      await fs.cp(
-        path.join(skillsSrc, d.name),
-        path.join(agentsDir, 'skills', d.name),
-        { recursive: true }
-      );
-    }
-    console.log('  [ok] .agents/skills/ (skills)');
-  }
-
-  // rules → .agents/rules/<stack>-<topic>.md
-  const rulesDir = path.join(tasDir, 'rules');
-  if (await exists(rulesDir)) {
-    await convertRules(rulesDir, path.join(agentsDir, 'rules'));
-    console.log('  [ok] .agents/rules/ (from .tas/rules/)');
-  }
-
-  // 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) {
-  const content = await fs.readFile(file, 'utf8');
-  const name = extractCommandName(content) || path.basename(file, '.md');
-  // Antigravity workflows: same .md format, stored in .agents/<name>.md
-  await fs.writeFile(path.join(agentsDir, `${name}.md`), content);
-}
-
-async function agentToSkill(file, skillsDir) {
-  const content = await fs.readFile(file, 'utf8');
-  const { frontmatter, body } = parseFrontmatter(content);
-  const name = frontmatter.name || path.basename(file, '.md');
-  const description = frontmatter.description || extractDescription(body, name);
-  const skillDir = path.join(skillsDir, name);
-  await fs.mkdir(skillDir, { recursive: true });
-  // Antigravity SKILL.md: same open standard, drop allowed-tools (platform manages tool access)
-  const skillMd = `---\nname: ${yamlValue(name)}\ndescription: ${yamlValue(description)}\n---\n\n${body}`;
-  await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
-}
-
-async function convertRules(rulesDir, outDir) {
-  const entries = await fs.readdir(rulesDir, { withFileTypes: true });
-  for (const entry of entries) {
-    if (entry.isDirectory()) {
-      const stack = entry.name;
-      const files = await listFilesRecursive(path.join(rulesDir, stack), '.md');
-      for (const f of files) {
-        const topic = path.basename(f, '.md');
-        await fs.copyFile(f, path.join(outDir, `${stack}-${topic}.md`));
-      }
-    } else if (entry.name.endsWith('.md')) {
-      await fs.copyFile(path.join(rulesDir, entry.name), path.join(outDir, entry.name));
-    }
-  }
-}
-
-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', '')}\``);
-
-  const skillDirs = await fs.readdir(path.join(agentsDir, 'skills'), { withFileTypes: true });
-  const skillLines = [];
-  for (const d of skillDirs.filter(e => e.isDirectory())) {
-    const skillFile = path.join(agentsDir, 'skills', d.name, 'SKILL.md');
-    if (!(await exists(skillFile))) continue;
-    const content = await fs.readFile(skillFile, 'utf8');
-    const { frontmatter } = parseFrontmatter(content);
-    if (frontmatter.name) {
-      skillLines.push(`- **${frontmatter.name}**: ${frontmatter.description || ''}`);
-    }
-  }
-
-  const readme = [
-    `# TAS Kit — Antigravity`,
-    ``,
-    `## Workflows`,
-    ``,
-    `Invoke via \`/workflow-name\` in chat:`,
-    ``,
-    ...workflowFiles,
-    ``,
-    `## Skills`,
-    ``,
-    ...skillLines,
-    ``,
-  ].join('\n');
-
-  await fs.writeFile(path.join(agentsDir, 'README.md'), readme);
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import {
+  exists, listFilesRecursive,
+  parseFrontmatter, extractDescription, extractCommandName, extractH1, yamlValue,
+} from './utils.js';
+
+export const PLATFORM_ID = 'antigravity';
+export const PLATFORM_LABEL = 'Antigravity';
+
+export async function install({ tasDir, target }) {
+  const agentsDir = path.join(target, '.agents');
+  await fs.mkdir(agentsDir, { recursive: true });
+  await fs.mkdir(path.join(agentsDir, 'rules'), { recursive: true });
+  await fs.mkdir(path.join(agentsDir, 'skills'), { recursive: true });
+
+  // commands → .agents/<name>.md (Antigravity workflows)
+  const commandsDir = path.join(tasDir, 'commands');
+  if (await exists(commandsDir)) {
+    const files = await listFilesRecursive(commandsDir, '.md');
+    for (const file of files) {
+      await commandToWorkflow(file, agentsDir);
+    }
+    console.log('  [ok] .agents/ (workflows from commands)');
+  }
+
+  // agents → .agents/skills/<name>/SKILL.md
+  const agentsSrc = path.join(tasDir, 'agents');
+  if (await exists(agentsSrc)) {
+    const files = await listFilesRecursive(agentsSrc, '.md');
+    for (const file of files) {
+      await agentToSkill(file, path.join(agentsDir, 'skills'));
+    }
+    console.log('  [ok] .agents/skills/ (agents)');
+  }
+
+  // kit skills → .agents/skills/ (copy as-is, same open standard)
+  const skillsSrc = path.join(tasDir, 'skills');
+  if (await exists(skillsSrc)) {
+    const skillDirs = await fs.readdir(skillsSrc, { withFileTypes: true });
+    for (const d of skillDirs.filter(e => e.isDirectory())) {
+      await fs.cp(
+        path.join(skillsSrc, d.name),
+        path.join(agentsDir, 'skills', d.name),
+        { recursive: true }
+      );
+    }
+    console.log('  [ok] .agents/skills/ (skills)');
+  }
+
+  // rules → .agents/rules/<stack>-<topic>.md
+  const rulesDir = path.join(tasDir, 'rules');
+  if (await exists(rulesDir)) {
+    await convertRules(rulesDir, path.join(agentsDir, 'rules'));
+    console.log('  [ok] .agents/rules/ (from .tas/rules/)');
+  }
+
+  // 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) {
+  const content = await fs.readFile(file, 'utf8');
+  const name = extractCommandName(content) || path.basename(file, '.md');
+  // Antigravity workflows: same .md format, stored in .agents/<name>.md
+  await fs.writeFile(path.join(agentsDir, `${name}.md`), content);
+}
+
+async function agentToSkill(file, skillsDir) {
+  const content = await fs.readFile(file, 'utf8');
+  const { frontmatter, body } = parseFrontmatter(content);
+  const name = frontmatter.name || path.basename(file, '.md');
+  const description = frontmatter.description || extractDescription(body, name);
+  const skillDir = path.join(skillsDir, name);
+  await fs.mkdir(skillDir, { recursive: true });
+  // Antigravity SKILL.md: same open standard, drop allowed-tools (platform manages tool access)
+  const skillMd = `---\nname: ${yamlValue(name)}\ndescription: ${yamlValue(description)}\n---\n\n${body}`;
+  await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
+}
+
+async function convertRules(rulesDir, outDir) {
+  const entries = await fs.readdir(rulesDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      const stack = entry.name;
+      const files = await listFilesRecursive(path.join(rulesDir, stack), '.md');
+      for (const f of files) {
+        const topic = path.basename(f, '.md');
+        await fs.copyFile(f, path.join(outDir, `${stack}-${topic}.md`));
+      }
+    } else if (entry.name.endsWith('.md')) {
+      await fs.copyFile(path.join(rulesDir, entry.name), path.join(outDir, entry.name));
+    }
+  }
+}
+
+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', '')}\``);
+
+  const skillDirs = await fs.readdir(path.join(agentsDir, 'skills'), { withFileTypes: true });
+  const skillLines = [];
+  for (const d of skillDirs.filter(e => e.isDirectory())) {
+    const skillFile = path.join(agentsDir, 'skills', d.name, 'SKILL.md');
+    if (!(await exists(skillFile))) continue;
+    const content = await fs.readFile(skillFile, 'utf8');
+    const { frontmatter } = parseFrontmatter(content);
+    if (frontmatter.name) {
+      skillLines.push(`- **${frontmatter.name}**: ${frontmatter.description || ''}`);
+    }
+  }
+
+  const readme = [
+    `# TAS Kit — Antigravity`,
+    ``,
+    `## Workflows`,
+    ``,
+    `Invoke via \`/workflow-name\` in chat:`,
+    ``,
+    ...workflowFiles,
+    ``,
+    `## Skills`,
+    ``,
+    ...skillLines,
+    ``,
+  ].join('\n');
+
+  await fs.writeFile(path.join(agentsDir, 'README.md'), readme);
+}

package/lib/adapters/claude-code.js

@@ -1,35 +1,71 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { copyDir, exists } from './utils.js';
-
-export const PLATFORM_ID = 'claude-code';
-export const PLATFORM_LABEL = 'Claude Code';
-
-export async function install({ tasDir, target }) {
-  const claudeDir = path.join(target, '.claude');
-  await fs.mkdir(claudeDir, { recursive: true });
-
-  await copyDir(path.join(tasDir, 'commands'), path.join(claudeDir, 'commands'));
-  console.log('  [ok] .claude/commands/');
-
-  await copyDir(path.join(tasDir, 'agents'), path.join(claudeDir, 'agents'));
-  console.log('  [ok] .claude/agents/');
-
-  const skillsSrc = path.join(tasDir, 'skills');
-  if (await exists(skillsSrc)) {
-    await copyDir(skillsSrc, path.join(claudeDir, 'skills'));
-    console.log('  [ok] .claude/skills/');
-  }
-
-  const hooksSrc = path.join(tasDir, '_platform', 'hooks');
-  if (await exists(hooksSrc)) {
-    await copyDir(hooksSrc, path.join(claudeDir, 'hooks'));
-    console.log('  [ok] .claude/hooks/');
-  }
-
-  const settingsSrc = path.join(tasDir, '_platform', 'claude-code', 'settings.json');
-  if (await exists(settingsSrc)) {
-    await fs.copyFile(settingsSrc, path.join(claudeDir, 'settings.json'));
-    console.log('  [ok] .claude/settings.json');
-  }
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { copyDir, exists } from './utils.js';
+
+export const PLATFORM_ID = 'claude-code';
+export const PLATFORM_LABEL = 'Claude Code';
+
+/**
+ * Merge template settings into existing settings without overwriting user values.
+ * - Objects (mcpServers, hooks.*): add template keys absent in existing
+ * - Arrays (permissions.allow/deny): union — add template entries absent in existing
+ * - Scalars: existing wins
+ */
+function mergeSettings(existing, template) {
+  const result = structuredClone(existing);
+
+  for (const [key, tval] of Object.entries(template)) {
+    if (!(key in result)) {
+      result[key] = structuredClone(tval);
+      continue;
+    }
+    const eval_ = result[key];
+    if (Array.isArray(tval) && Array.isArray(eval_)) {
+      const set = new Set(eval_);
+      for (const item of tval) if (!set.has(item)) eval_.push(item);
+    } else if (tval && typeof tval === 'object' && !Array.isArray(tval)) {
+      result[key] = mergeSettings(eval_, tval);
+    }
+    // scalar: existing wins — no action
+  }
+
+  return result;
+}
+
+export async function install({ tasDir, target }) {
+  const claudeDir = path.join(target, '.claude');
+  await fs.mkdir(claudeDir, { recursive: true });
+
+  await copyDir(path.join(tasDir, 'commands'), path.join(claudeDir, 'commands'));
+  console.log('  [ok] .claude/commands/');
+
+  await copyDir(path.join(tasDir, 'agents'), path.join(claudeDir, 'agents'));
+  console.log('  [ok] .claude/agents/');
+
+  const skillsSrc = path.join(tasDir, 'skills');
+  if (await exists(skillsSrc)) {
+    await copyDir(skillsSrc, path.join(claudeDir, 'skills'));
+    console.log('  [ok] .claude/skills/');
+  }
+
+  const hooksSrc = path.join(tasDir, '_platform', 'hooks');
+  if (await exists(hooksSrc)) {
+    await copyDir(hooksSrc, path.join(claudeDir, 'hooks'));
+    console.log('  [ok] .claude/hooks/');
+  }
+
+  const settingsSrc = path.join(tasDir, '_platform', 'claude-code', 'settings.json');
+  const settingsDest = path.join(claudeDir, 'settings.json');
+  if (await exists(settingsSrc)) {
+    const template = JSON.parse(await fs.readFile(settingsSrc, 'utf8'));
+    if (await exists(settingsDest)) {
+      const existing = JSON.parse(await fs.readFile(settingsDest, 'utf8'));
+      const merged = mergeSettings(existing, template);
+      await fs.writeFile(settingsDest, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+      console.log('  [merged] .claude/settings.json (existing preserved, new keys added)');
+    } else {
+      await fs.writeFile(settingsDest, JSON.stringify(template, null, 2) + '\n', 'utf8');
+      console.log('  [ok] .claude/settings.json');
+    }
+  }
+}