@torus-engineering/tas-kit 1.13.0 → 2.1.0

package/lib/adapters/codex.js

@@ -1,157 +1,157 @@
-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 = 'codex';
-export const PLATFORM_LABEL = 'Codex';
-
-export async function install({ tasDir, target }) {
-  const codexDir = path.join(target, '.codex');
-  const skillsOut = path.join(codexDir, 'skills');
-  await fs.mkdir(skillsOut, { recursive: true });
-
-  // commands → skills
-  const commandsDir = path.join(tasDir, 'commands');
-  if (await exists(commandsDir)) {
-    const files = await listFilesRecursive(commandsDir, '.md');
-    for (const file of files) {
-      await commandToSkill(file, skillsOut);
-    }
-    console.log('  [ok] .codex/skills/ (commands)');
-  }
-
-  // agents → skills
-  const agentsDir = path.join(tasDir, 'agents');
-  if (await exists(agentsDir)) {
-    const files = await listFilesRecursive(agentsDir, '.md');
-    for (const file of files) {
-      await agentToSkill(file, skillsOut);
-    }
-    console.log('  [ok] .codex/skills/ (agents)');
-  }
-
-  // skills → skills (copy as-is, same format)
-  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())) {
-      const src = path.join(skillsSrc, d.name);
-      const dest = path.join(skillsOut, d.name);
-      await fs.cp(src, dest, { recursive: true });
-    }
-    console.log('  [ok] .codex/skills/ (skills)');
-  }
-
-  // rules → skills with references/
-  const rulesDir = path.join(tasDir, 'rules');
-  if (await exists(rulesDir)) {
-    await rulesToSkills(rulesDir, skillsOut);
-    console.log('  [ok] .codex/skills/ (rules)');
-  }
-
-  // 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) {
-  const content = await fs.readFile(file, 'utf8');
-  const name = extractCommandName(content) || path.basename(file, '.md');
-  const description = extractDescription(content, name);
-  const skillDir = path.join(skillsOut, name);
-  await fs.mkdir(skillDir, { recursive: true });
-  const skillMd = `---\nname: ${yamlValue(name)}\ndescription: ${yamlValue(description)}\n---\n\n${content}`;
-  await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
-}
-
-async function agentToSkill(file, skillsOut) {
-  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(skillsOut, name);
-  await fs.mkdir(skillDir, { recursive: true });
-  const skillMd = `---\nname: ${yamlValue(name)}\ndescription: ${yamlValue(description)}\n---\n\n${body}`;
-  await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
-}
-
-async function rulesToSkills(rulesDir, skillsOut) {
-  const stacks = await fs.readdir(rulesDir, { withFileTypes: true });
-  for (const entry of stacks) {
-    if (!entry.isDirectory() && !entry.name.endsWith('.md')) continue;
-
-    if (entry.isDirectory()) {
-      const stack = entry.name;
-      const stackDir = path.join(rulesDir, stack);
-      const files = await listFilesRecursive(stackDir, '.md');
-      if (files.length === 0) continue;
-
-      const skillName = `${stack}-rules`;
-      const skillDir = path.join(skillsOut, skillName);
-      const refsDir = path.join(skillDir, 'references');
-      await fs.mkdir(refsDir, { recursive: true });
-
-      const refList = [];
-      for (const f of files) {
-        const dest = path.join(refsDir, path.basename(f));
-        await fs.copyFile(f, dest);
-        refList.push(`- ${path.basename(f, '.md')}`);
-      }
-
-      const skillMd = [
-        `---`,
-        `name: ${yamlValue(skillName)}`,
-        `description: ${yamlValue(`${stack} coding standards, patterns and security rules`)}`,
-        `---`,
-        ``,
-        `# ${stack} Rules`,
-        ``,
-        `References (loaded on demand):`,
-        ...refList,
-      ].join('\n') + '\n';
-      await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
-    } else {
-      // top-level .md file (e.g. ado-integration.md)
-      const file = path.join(rulesDir, entry.name);
-      const content = await fs.readFile(file, 'utf8');
-      const name = path.basename(entry.name, '.md') + '-rules';
-      const skillDir = path.join(skillsOut, name);
-      const refsDir = path.join(skillDir, 'references');
-      await fs.mkdir(refsDir, { recursive: true });
-      await fs.copyFile(file, path.join(refsDir, entry.name));
-      const title = extractH1(content) || name;
-      const skillMd = `---\nname: ${yamlValue(name)}\ndescription: ${yamlValue(title)}\n---\n\n# ${title}\n\nSee references/${entry.name}\n`;
-      await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
-    }
-  }
-}
-
-async function generateReadme(skillsOut, codexDir) {
-  const skillDirs = await fs.readdir(skillsOut, { withFileTypes: true });
-  const skillLines = [];
-  for (const d of skillDirs.filter(e => e.isDirectory())) {
-    const skillFile = path.join(skillsOut, 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 — Codex`,
-    ``,
-    `## Available Skills`,
-    ``,
-    `Use \`/skills\` to list and invoke skills:`,
-    ``,
-    ...skillLines,
-    ``,
-  ].join('\n');
-
-  await fs.writeFile(path.join(codexDir, '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 = 'codex';
+export const PLATFORM_LABEL = 'Codex';
+
+export async function install({ tasDir, target }) {
+  const codexDir = path.join(target, '.codex');
+  const skillsOut = path.join(codexDir, 'skills');
+  await fs.mkdir(skillsOut, { recursive: true });
+
+  // commands → skills
+  const commandsDir = path.join(tasDir, 'commands');
+  if (await exists(commandsDir)) {
+    const files = await listFilesRecursive(commandsDir, '.md');
+    for (const file of files) {
+      await commandToSkill(file, skillsOut);
+    }
+    console.log('  [ok] .codex/skills/ (commands)');
+  }
+
+  // agents → skills
+  const agentsDir = path.join(tasDir, 'agents');
+  if (await exists(agentsDir)) {
+    const files = await listFilesRecursive(agentsDir, '.md');
+    for (const file of files) {
+      await agentToSkill(file, skillsOut);
+    }
+    console.log('  [ok] .codex/skills/ (agents)');
+  }
+
+  // skills → skills (copy as-is, same format)
+  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())) {
+      const src = path.join(skillsSrc, d.name);
+      const dest = path.join(skillsOut, d.name);
+      await fs.cp(src, dest, { recursive: true });
+    }
+    console.log('  [ok] .codex/skills/ (skills)');
+  }
+
+  // rules → skills with references/
+  const rulesDir = path.join(tasDir, 'rules');
+  if (await exists(rulesDir)) {
+    await rulesToSkills(rulesDir, skillsOut);
+    console.log('  [ok] .codex/skills/ (rules)');
+  }
+
+  // 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) {
+  const content = await fs.readFile(file, 'utf8');
+  const name = extractCommandName(content) || path.basename(file, '.md');
+  const description = extractDescription(content, name);
+  const skillDir = path.join(skillsOut, name);
+  await fs.mkdir(skillDir, { recursive: true });
+  const skillMd = `---\nname: ${yamlValue(name)}\ndescription: ${yamlValue(description)}\n---\n\n${content}`;
+  await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
+}
+
+async function agentToSkill(file, skillsOut) {
+  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(skillsOut, name);
+  await fs.mkdir(skillDir, { recursive: true });
+  const skillMd = `---\nname: ${yamlValue(name)}\ndescription: ${yamlValue(description)}\n---\n\n${body}`;
+  await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
+}
+
+async function rulesToSkills(rulesDir, skillsOut) {
+  const stacks = await fs.readdir(rulesDir, { withFileTypes: true });
+  for (const entry of stacks) {
+    if (!entry.isDirectory() && !entry.name.endsWith('.md')) continue;
+
+    if (entry.isDirectory()) {
+      const stack = entry.name;
+      const stackDir = path.join(rulesDir, stack);
+      const files = await listFilesRecursive(stackDir, '.md');
+      if (files.length === 0) continue;
+
+      const skillName = `${stack}-rules`;
+      const skillDir = path.join(skillsOut, skillName);
+      const refsDir = path.join(skillDir, 'references');
+      await fs.mkdir(refsDir, { recursive: true });
+
+      const refList = [];
+      for (const f of files) {
+        const dest = path.join(refsDir, path.basename(f));
+        await fs.copyFile(f, dest);
+        refList.push(`- ${path.basename(f, '.md')}`);
+      }
+
+      const skillMd = [
+        `---`,
+        `name: ${yamlValue(skillName)}`,
+        `description: ${yamlValue(`${stack} coding standards, patterns and security rules`)}`,
+        `---`,
+        ``,
+        `# ${stack} Rules`,
+        ``,
+        `References (loaded on demand):`,
+        ...refList,
+      ].join('\n') + '\n';
+      await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
+    } else {
+      // top-level .md file (e.g. ado-integration.md)
+      const file = path.join(rulesDir, entry.name);
+      const content = await fs.readFile(file, 'utf8');
+      const name = path.basename(entry.name, '.md') + '-rules';
+      const skillDir = path.join(skillsOut, name);
+      const refsDir = path.join(skillDir, 'references');
+      await fs.mkdir(refsDir, { recursive: true });
+      await fs.copyFile(file, path.join(refsDir, entry.name));
+      const title = extractH1(content) || name;
+      const skillMd = `---\nname: ${yamlValue(name)}\ndescription: ${yamlValue(title)}\n---\n\n# ${title}\n\nSee references/${entry.name}\n`;
+      await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillMd);
+    }
+  }
+}
+
+async function generateReadme(skillsOut, codexDir) {
+  const skillDirs = await fs.readdir(skillsOut, { withFileTypes: true });
+  const skillLines = [];
+  for (const d of skillDirs.filter(e => e.isDirectory())) {
+    const skillFile = path.join(skillsOut, 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 — Codex`,
+    ``,
+    `## Available Skills`,
+    ``,
+    `Use \`/skills\` to list and invoke skills:`,
+    ``,
+    ...skillLines,
+    ``,
+  ].join('\n');
+
+  await fs.writeFile(path.join(codexDir, 'README.md'), readme);
+}

package/lib/adapters/cursor.js

@@ -1,80 +1,80 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { copyDir, exists, listFilesRecursive, extractH1, yamlValue } from './utils.js';
-
-export const PLATFORM_ID = 'cursor';
-export const PLATFORM_LABEL = 'Cursor';
-
-const HOOKS_JSON = {
-  postToolUse: [
-    {
-      matcher: '^(Write|Edit|MultiEdit)$',
-      hooks: [
-        {
-          type: 'command',
-          command: 'node .tas/_platform/hooks/code-quality.js',
-          description: 'Auto format source files: prettier (TS/JS), ruff/black (Python), dotnet format (C#)',
-        },
-      ],
-    },
-  ],
-  agentLoopEnd: [
-    {
-      hooks: [
-        {
-          type: 'command',
-          command: 'node .tas/_platform/hooks/session-end.js',
-          description: 'Run test suite, check project-status.yaml updated, remind next steps',
-        },
-      ],
-    },
-  ],
-};
-
-export async function install({ tasDir, target }) {
-  const cursorDir = path.join(target, '.cursor');
-  await fs.mkdir(cursorDir, { recursive: true });
-
-  // commands — same format as Claude Code
-  await copyDir(path.join(tasDir, 'commands'), path.join(cursorDir, 'commands'));
-  console.log('  [ok] .cursor/commands/');
-
-  // agents — identical frontmatter format
-  await copyDir(path.join(tasDir, 'agents'), path.join(cursorDir, 'agents'));
-  console.log('  [ok] .cursor/agents/');
-
-  // skills — same open standard
-  const skillsSrc = path.join(tasDir, 'skills');
-  if (await exists(skillsSrc)) {
-    await copyDir(skillsSrc, path.join(cursorDir, 'skills'));
-    console.log('  [ok] .cursor/skills/');
-  }
-
-  // rules → .mdc files with frontmatter
-  const rulesDir = path.join(tasDir, 'rules');
-  const rulesOut = path.join(cursorDir, 'rules');
-  await fs.mkdir(rulesOut, { recursive: true });
-  await convertRulesToMdc(rulesDir, rulesOut);
-  console.log('  [ok] .cursor/rules/ (converted from .tas/rules/)');
-
-  // hooks.json
-  await fs.writeFile(
-    path.join(cursorDir, 'hooks.json'),
-    JSON.stringify(HOOKS_JSON, null, 2) + '\n'
-  );
-  console.log('  [ok] .cursor/hooks.json');
-}
-
-async function convertRulesToMdc(rulesDir, outDir) {
-  if (!(await exists(rulesDir))) return;
-  const files = await listFilesRecursive(rulesDir, '.md');
-  for (const file of files) {
-    const rel = path.relative(rulesDir, file);
-    // flatten: common/code-review.md → common-code-review.mdc
-    const flatName = rel.replace(/[\\/]/g, '-').replace(/\.md$/, '.mdc');
-    const content = await fs.readFile(file, 'utf8');
-    const title = extractH1(content) || path.basename(file, '.md');
-    const mdc = `---\ndescription: ${yamlValue(title)}\nalwaysApply: false\n---\n\n${content}`;
-    await fs.writeFile(path.join(outDir, flatName), mdc);
-  }
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { copyDir, exists, listFilesRecursive, extractH1, yamlValue } from './utils.js';
+
+export const PLATFORM_ID = 'cursor';
+export const PLATFORM_LABEL = 'Cursor';
+
+const HOOKS_JSON = {
+  postToolUse: [
+    {
+      matcher: '^(Write|Edit|MultiEdit)$',
+      hooks: [
+        {
+          type: 'command',
+          command: 'node .tas/_platform/hooks/code-quality.js',
+          description: 'Auto format source files: prettier (TS/JS), ruff/black (Python), dotnet format (C#)',
+        },
+      ],
+    },
+  ],
+  agentLoopEnd: [
+    {
+      hooks: [
+        {
+          type: 'command',
+          command: 'node .tas/_platform/hooks/session-end.js',
+          description: 'Run test suite, check project-status.yaml updated, remind next steps',
+        },
+      ],
+    },
+  ],
+};
+
+export async function install({ tasDir, target }) {
+  const cursorDir = path.join(target, '.cursor');
+  await fs.mkdir(cursorDir, { recursive: true });
+
+  // commands — same format as Claude Code
+  await copyDir(path.join(tasDir, 'commands'), path.join(cursorDir, 'commands'));
+  console.log('  [ok] .cursor/commands/');
+
+  // agents — identical frontmatter format
+  await copyDir(path.join(tasDir, 'agents'), path.join(cursorDir, 'agents'));
+  console.log('  [ok] .cursor/agents/');
+
+  // skills — same open standard
+  const skillsSrc = path.join(tasDir, 'skills');
+  if (await exists(skillsSrc)) {
+    await copyDir(skillsSrc, path.join(cursorDir, 'skills'));
+    console.log('  [ok] .cursor/skills/');
+  }
+
+  // rules → .mdc files with frontmatter
+  const rulesDir = path.join(tasDir, 'rules');
+  const rulesOut = path.join(cursorDir, 'rules');
+  await fs.mkdir(rulesOut, { recursive: true });
+  await convertRulesToMdc(rulesDir, rulesOut);
+  console.log('  [ok] .cursor/rules/ (converted from .tas/rules/)');
+
+  // hooks.json
+  await fs.writeFile(
+    path.join(cursorDir, 'hooks.json'),
+    JSON.stringify(HOOKS_JSON, null, 2) + '\n'
+  );
+  console.log('  [ok] .cursor/hooks.json');
+}
+
+async function convertRulesToMdc(rulesDir, outDir) {
+  if (!(await exists(rulesDir))) return;
+  const files = await listFilesRecursive(rulesDir, '.md');
+  for (const file of files) {
+    const rel = path.relative(rulesDir, file);
+    // flatten: common/code-review.md → common-code-review.mdc
+    const flatName = rel.replace(/[\\/]/g, '-').replace(/\.md$/, '.mdc');
+    const content = await fs.readFile(file, 'utf8');
+    const title = extractH1(content) || path.basename(file, '.md');
+    const mdc = `---\ndescription: ${yamlValue(title)}\nalwaysApply: false\n---\n\n${content}`;
+    await fs.writeFile(path.join(outDir, flatName), mdc);
+  }
+}

package/lib/adapters/index.js

@@ -1,20 +1,20 @@
-export { PLATFORM_ID as CLAUDE_CODE, install as installClaudeCode } from './claude-code.js';
-export { PLATFORM_ID as CURSOR, install as installCursor } from './cursor.js';
-export { PLATFORM_ID as CODEX, install as installCodex } from './codex.js';
-export { PLATFORM_ID as ANTIGRAVITY, install as installAntigravity } from './antigravity.js';
-
-import * as claudeCode from './claude-code.js';
-import * as cursor from './cursor.js';
-import * as codex from './codex.js';
-import * as antigravity from './antigravity.js';
-
-export const PLATFORMS = [
-  { id: claudeCode.PLATFORM_ID, label: claudeCode.PLATFORM_LABEL, install: claudeCode.install },
-  { id: cursor.PLATFORM_ID,     label: cursor.PLATFORM_LABEL,     install: cursor.install },
-  { id: codex.PLATFORM_ID,      label: codex.PLATFORM_LABEL,      install: codex.install },
-  { id: antigravity.PLATFORM_ID, label: antigravity.PLATFORM_LABEL, install: antigravity.install },
-];
-
-export function getPlatform(id) {
-  return PLATFORMS.find(p => p.id === id);
-}
+export { PLATFORM_ID as CLAUDE_CODE, install as installClaudeCode } from './claude-code.js';
+export { PLATFORM_ID as CURSOR, install as installCursor } from './cursor.js';
+export { PLATFORM_ID as CODEX, install as installCodex } from './codex.js';
+export { PLATFORM_ID as ANTIGRAVITY, install as installAntigravity } from './antigravity.js';
+
+import * as claudeCode from './claude-code.js';
+import * as cursor from './cursor.js';
+import * as codex from './codex.js';
+import * as antigravity from './antigravity.js';
+
+export const PLATFORMS = [
+  { id: claudeCode.PLATFORM_ID, label: claudeCode.PLATFORM_LABEL, install: claudeCode.install },
+  { id: cursor.PLATFORM_ID,     label: cursor.PLATFORM_LABEL,     install: cursor.install },
+  { id: codex.PLATFORM_ID,      label: codex.PLATFORM_LABEL,      install: codex.install },
+  { id: antigravity.PLATFORM_ID, label: antigravity.PLATFORM_LABEL, install: antigravity.install },
+];
+
+export function getPlatform(id) {
+  return PLATFORMS.find(p => p.id === id);
+}