@torus-engineering/tas-kit 1.13.0 → 2.1.0

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');
+    }
+  }
+}