@torus-engineering/tas-kit 1.10.0 → 1.12.0

package/lib/adapters/codex.js

@@ -0,0 +1,163 @@
+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)');
+  }
+
+  // lean AGENTS.md
+  await generateAgentsMd(skillsOut, target);
+  console.log('  [ok] AGENTS.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 generateAgentsMd(skillsOut, target) {
+  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 agentsMd = [
+    `# Project Instructions`,
+    ``,
+    `This project uses TAS Kit — Torus Agentic SDLC Kit.`,
+    ``,
+    `## Available Skills`,
+    ``,
+    `Use \`/skills\` to list and invoke skills. Available 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);
+}

package/lib/adapters/cursor.js

@@ -0,0 +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);
+  }
+}

package/lib/adapters/index.js

@@ -0,0 +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);
+}

package/lib/adapters/utils.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+export async function exists(p) {
+  return fs.access(p).then(() => true).catch(() => false);
+}
+
+export async function copyDir(src, dest) {
+  await fs.cp(src, dest, { recursive: true });
+}
+
+export async function listFilesRecursive(dir, ext = '') {
+  const results = [];
+  async function walk(current) {
+    const entries = await fs.readdir(current, { withFileTypes: true });
+    for (const e of entries) {
+      const full = path.join(current, e.name);
+      if (e.isDirectory()) await walk(full);
+      else if (!ext || e.name.endsWith(ext)) results.push(full);
+    }
+  }
+  await walk(dir);
+  return results;
+}
+
+export function parseFrontmatter(content) {
+  if (!content.startsWith('---')) return { frontmatter: {}, body: content };
+  const end = content.indexOf('\n---', 3);
+  if (end === -1) return { frontmatter: {}, body: content };
+  const yaml = content.slice(4, end);
+  const body = content.slice(end + 4).trimStart();
+  const frontmatter = {};
+  for (const line of yaml.split('\n')) {
+    const colon = line.indexOf(':');
+    if (colon > 0) {
+      const key = line.slice(0, colon).trim();
+      let val = line.slice(colon + 1).trim();
+      // handle multiline: only single-line values here
+      val = val.replace(/^["']|["']$/g, '');
+      frontmatter[key] = val;
+    }
+  }
+  return { frontmatter, body };
+}
+
+// Extract description: first non-empty, non-heading line after the H1
+export function extractDescription(content, fallback = '') {
+  const lines = content.split('\n');
+  let pastH1 = false;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!pastH1) {
+      if (trimmed.startsWith('# ')) pastH1 = true;
+      continue;
+    }
+    if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('|') && !trimmed.startsWith('-')) {
+      return trimmed.replace(/^Role:\s*/i, '').replace(/\*\*/g, '').slice(0, 150);
+    }
+  }
+  return fallback;
+}
+
+// Extract H1 title from markdown
+export function extractH1(content) {
+  const match = content.match(/^#\s+(.+)$/m);
+  return match ? match[1].trim() : '';
+}
+
+// Extract command name from first line: "# /tas-dev $ARGUMENTS" → "tas-dev"
+export function extractCommandName(content) {
+  const match = content.match(/^#\s+\/(\S+)/);
+  return match ? match[1] : '';
+}
+
+// Escape a string for use in YAML frontmatter value (single-line)
+export function yamlValue(str) {
+  if (/[:#\[\]{},|>&*!'"\\]/.test(str) || str.includes('\n')) {
+    return `"${str.replace(/"/g, '\\"')}"`;
+  }
+  return str;
+}

package/lib/deleted-files.json

@@ -32,5 +32,104 @@
   ],
   "1.9.0": [
     ".claude/commands/tas-api-test.md"
+  ],
+  "1.12.0": [
+    ".claude/rules/.gitkeep",
+    ".claude/rules/common/code-review.md",
+    ".claude/rules/common/hooks.md",
+    ".claude/rules/common/patterns.md",
+    ".claude/rules/common/post-review-agent.md",
+    ".claude/rules/common/project-status.md",
+    ".claude/rules/common/security.md",
+    ".claude/rules/common/stack-detection.md",
+    ".claude/rules/common/testing.md",
+    ".claude/rules/common/token-logging.md",
+    ".claude/rules/csharp/api-testing.md",
+    ".claude/rules/csharp/coding-style.md",
+    ".claude/rules/csharp/hooks.md",
+    ".claude/rules/csharp/patterns.md",
+    ".claude/rules/csharp/security.md",
+    ".claude/rules/csharp/testing.md",
+    ".claude/rules/python/coding-style.md",
+    ".claude/rules/python/hooks.md",
+    ".claude/rules/python/patterns.md",
+    ".claude/rules/python/security.md",
+    ".claude/rules/python/testing.md",
+    ".claude/rules/typescript/coding-style.md",
+    ".claude/rules/typescript/hooks.md",
+    ".claude/rules/typescript/patterns.md",
+    ".claude/rules/typescript/security.md",
+    ".claude/rules/typescript/testing.md",
+    ".claude/rules/web/coding-style.md",
+    ".claude/rules/web/design-quality.md",
+    ".claude/rules/web/hooks.md",
+    ".claude/rules/web/patterns.md",
+    ".claude/rules/web/performance.md",
+    ".claude/rules/web/security.md",
+    ".claude/rules/web/testing.md",
+    ".tas/rules/common/post-review-agent.md",
+    ".claude/skills/ado-integration/SKILL.md",
+    ".claude/skills/ai-regression-testing/SKILL.md",
+    ".claude/skills/api-design/SKILL.md",
+    ".claude/skills/architecture-decision-records/SKILL.md",
+    ".claude/skills/benchmark/SKILL.md",
+    ".claude/skills/browser-qa/SKILL.md",
+    ".claude/skills/canary-watch/SKILL.md",
+    ".claude/skills/js-backend-patterns/SKILL.md",
+    ".claude/skills/tas-conventions/SKILL.md",
+    ".claude/skills/tas-implementation-complete/SKILL.md",
+    ".claude/skills/tas-tdd/SKILL.md",
+    ".claude/skills/token-logger/SKILL.md",
+    ".claude/agents/planner.md",
+    ".claude/agents/tdd-guide.md",
+    ".claude/agents/code-reviewer.md",
+    ".claude/agents/e2e-runner.md",
+    ".claude/commands/tas-verify.md",
+    ".tas/checklists/code-review.md",
+    ".tas/checklists/security.md",
+    ".tas/checklists/story-done.md",
+    ".claude/agents/architect.md",
+    ".claude/agents/aws-reviewer.md",
+    ".claude/agents/build-resolver.md",
+    ".claude/agents/code-explorer.md",
+    ".claude/agents/csharp-reviewer.md",
+    ".claude/agents/database-reviewer.md",
+    ".claude/agents/doc-updater.md",
+    ".claude/agents/python-reviewer.md",
+    ".claude/agents/security-reviewer.md",
+    ".claude/agents/typescript-reviewer.md",
+    ".claude/commands/ado-create.md",
+    ".claude/commands/ado-delete.md",
+    ".claude/commands/ado-get.md",
+    ".claude/commands/ado-status.md",
+    ".claude/commands/ado-update.md",
+    ".claude/commands/tas-adr.md",
+    ".claude/commands/tas-apitest-plan.md",
+    ".claude/commands/tas-apitest.md",
+    ".claude/commands/tas-brainstorm.md",
+    ".claude/commands/tas-bug.md",
+    ".claude/commands/tas-design.md",
+    ".claude/commands/tas-dev.md",
+    ".claude/commands/tas-e2e-mobile.md",
+    ".claude/commands/tas-e2e-web.md",
+    ".claude/commands/tas-e2e.md",
+    ".claude/commands/tas-epic.md",
+    ".claude/commands/tas-feature.md",
+    ".claude/commands/tas-fix.md",
+    ".claude/commands/tas-functest-mobile.md",
+    ".claude/commands/tas-functest-web.md",
+    ".claude/commands/tas-functest.md",
+    ".claude/commands/tas-init.md",
+    ".claude/commands/tas-plan.md",
+    ".claude/commands/tas-prd.md",
+    ".claude/commands/tas-review.md",
+    ".claude/commands/tas-sad.md",
+    ".claude/commands/tas-security.md",
+    ".claude/commands/tas-spec.md",
+    ".claude/commands/tas-status.md",
+    ".claude/commands/tas-story.md",
+    ".claude/hooks/code-quality.js",
+    ".claude/hooks/session-end.js",
+    ".claude/settings.json"
   ]
 }