@torus-engineering/tas-kit 1.7.0 → 1.8.0

package/lib/install.js

@@ -1,176 +1,213 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import readline from 'node:readline';
-import { fileURLToPath } from 'node:url';
-
-const PACKAGE_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
-
-async function confirm(question) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(`${question} [y/N] `, (answer) => {
-      rl.close();
-      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
-    });
-  });
-}
-
-async function exists(p) {
-  return fs.access(p).then(() => true).catch(() => false);
-}
-
-async function copyDir(src, dest) {
-  await fs.cp(src, dest, { recursive: true });
-}
-
-export async function update({ directory, yes }) {
-  const target = path.resolve(directory);
-
-  // Must already have .claude/ or .tas/ — otherwise suggest install
-  const claudeExists = await exists(path.join(target, '.claude'));
-  const tasExists = await exists(path.join(target, '.tas'));
-  if (!claudeExists && !tasExists) {
-    console.error(`  ERROR: No TAS Kit found in: ${target}`);
-    console.error(`  Run "install" first to set up TAS Kit.`);
-    process.exit(1);
-  }
-
-  console.log(`\nUpdating TAS Kit in: ${target}\n`);
-
-  if (!yes) {
-    console.warn(`  This will overwrite .claude/ and .tas/ with the latest kit files.`);
-    console.warn(`  Your CLAUDE.md, tas.yaml, and .env.example will NOT be touched.\n`);
-    const ok = await confirm('Continue?');
-    if (!ok) {
-      console.log('Update cancelled.');
-      process.exit(0);
-    }
-    console.log();
-  }
-
-  // Overwrite .claude/
-  await copyDir(
-    path.join(PACKAGE_DIR, '.claude'),
-    path.join(target, '.claude')
-  );
-  console.log('  [ok] .claude/ (updated)');
-
-  // Overwrite .tas/
-  await copyDir(
-    path.join(PACKAGE_DIR, '.tas'),
-    path.join(target, '.tas')
-  );
-  console.log('  [ok] .tas/ (updated)');
-
-  // Set executable bit on tas-ado.py (Unix/macOS)
-  if (process.platform !== 'win32') {
-    const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
-    if (await exists(adoPy)) {
-      await fs.chmod(adoPy, 0o755);
-    }
-  }
-
-  console.log(`  [--] CLAUDE.md, tas.yaml, .env.example — not touched`);
-
-  console.log(`
-TAS Kit updated successfully!
-
-If this version added new settings or templates, check the changelog
-and manually merge changes into your CLAUDE.md and tas.yaml if needed.
-  `);
-}
-
-export async function install({ directory, yes }) {
-  const target = path.resolve(directory);
-
-  // Ensure target directory exists
-  await fs.mkdir(target, { recursive: true });
-
-  console.log(`\nInstalling TAS Kit into: ${target}\n`);
-
-  // Warn if .claude/ or .tas/ already exist
-  const claudeExists = await exists(path.join(target, '.claude'));
-  const tasExists = await exists(path.join(target, '.tas'));
-
-  if ((claudeExists || tasExists) && !yes) {
-    const existing = [claudeExists && '.claude/', tasExists && '.tas/'].filter(Boolean).join(', ');
-    console.warn(`  WARNING: ${existing} already exist in target directory.`);
-    console.warn(`  Existing files with the same names will be overwritten.\n`);
-    const ok = await confirm('Continue?');
-    if (!ok) {
-      console.log('Installation cancelled.');
-      process.exit(0);
-    }
-    console.log();
-  }
-
-  // Copy .claude/
-  await copyDir(
-    path.join(PACKAGE_DIR, '.claude'),
-    path.join(target, '.claude')
-  );
-  console.log('  [ok] .claude/');
-
-  // Copy .tas/
-  await copyDir(
-    path.join(PACKAGE_DIR, '.tas'),
-    path.join(target, '.tas')
-  );
-  console.log('  [ok] .tas/');
-
-  // Copy CLAUDE-Example.md as CLAUDE.md (only if absent)
-  const claudeMdTarget = path.join(target, 'CLAUDE.md');
-  if (!(await exists(claudeMdTarget))) {
-    await fs.copyFile(
-      path.join(PACKAGE_DIR, 'CLAUDE-Example.md'),
-      claudeMdTarget
-    );
-    console.log('  [ok] CLAUDE.md (from CLAUDE-Example.md)');
-  } else {
-    console.log('  [--] CLAUDE.md already exists, skipped');
-  }
-
-  // Copy .env.example (only if absent)
-  const envExampleTarget = path.join(target, '.env.example');
-  if (!(await exists(envExampleTarget))) {
-    await fs.copyFile(
-      path.join(PACKAGE_DIR, '.env.example'),
-      envExampleTarget
-    );
-    console.log('  [ok] .env.example');
-  } else {
-    console.log('  [--] .env.example already exists, skipped');
-  }
-
-  // Copy tas-example.yaml as tas.yaml (only if absent)
-  const tasYamlTarget = path.join(target, 'tas.yaml');
-  if (!(await exists(tasYamlTarget))) {
-    await fs.copyFile(
-      path.join(PACKAGE_DIR, '.tas', 'tas-example.yaml'),
-      tasYamlTarget
-    );
-    console.log('  [ok] tas.yaml (from .tas/tas-example.yaml)');
-  } else {
-    console.log('  [--] tas.yaml already exists, skipped');
-  }
-
-  // Set executable bit on tas-ado.py (Unix/macOS)
-  if (process.platform !== 'win32') {
-    const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
-    if (await exists(adoPy)) {
-      await fs.chmod(adoPy, 0o755);
-    }
-  }
-
-  console.log(`
-TAS Kit installed successfully!
-
-Next steps:
-  1. Edit CLAUDE.md     — 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 Claude Code   — run /tas-init to initialize your project
-
-Docs: .tas/README.md
-  `);
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+
+const PACKAGE_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
+const require = createRequire(import.meta.url);
+
+async function getDeletedFiles() {
+  try {
+    const manifest = require('./deleted-files.json');
+    return Object.values(manifest).flat();
+  } catch {
+    return [];
+  }
+}
+
+async function removeDeletedFiles(target, deletedFiles) {
+  const removed = [];
+  const skipped = [];
+  for (const relPath of deletedFiles) {
+    const fullPath = path.join(target, relPath);
+    try {
+      await fs.rm(fullPath, { force: false });
+      removed.push(relPath);
+    } catch {
+      skipped.push(relPath);
+    }
+  }
+  return { removed, skipped };
+}
+
+async function confirm(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(`${question} [y/N] `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+async function exists(p) {
+  return fs.access(p).then(() => true).catch(() => false);
+}
+
+async function copyDir(src, dest) {
+  await fs.cp(src, dest, { recursive: true });
+}
+
+export async function update({ directory, yes }) {
+  const target = path.resolve(directory);
+
+  // Must already have .claude/ or .tas/ — otherwise suggest install
+  const claudeExists = await exists(path.join(target, '.claude'));
+  const tasExists = await exists(path.join(target, '.tas'));
+  if (!claudeExists && !tasExists) {
+    console.error(`  ERROR: No TAS Kit found in: ${target}`);
+    console.error(`  Run "install" first to set up TAS Kit.`);
+    process.exit(1);
+  }
+
+  console.log(`\nUpdating TAS Kit in: ${target}\n`);
+
+  if (!yes) {
+    console.warn(`  This will overwrite .claude/ and .tas/ with the latest kit files.`);
+    console.warn(`  Your CLAUDE.md, tas.yaml, and .env.example will NOT be touched.\n`);
+    const ok = await confirm('Continue?');
+    if (!ok) {
+      console.log('Update cancelled.');
+      process.exit(0);
+    }
+    console.log();
+  }
+
+  // Overwrite .claude/
+  await copyDir(
+    path.join(PACKAGE_DIR, '.claude'),
+    path.join(target, '.claude')
+  );
+  console.log('  [ok] .claude/ (updated)');
+
+  // Overwrite .tas/
+  await copyDir(
+    path.join(PACKAGE_DIR, '.tas'),
+    path.join(target, '.tas')
+  );
+  console.log('  [ok] .tas/ (updated)');
+
+  // Remove files deleted from the kit in previous versions
+  const deletedFiles = await getDeletedFiles();
+  if (deletedFiles.length > 0) {
+    const { removed } = await removeDeletedFiles(target, deletedFiles);
+    if (removed.length > 0) {
+      for (const f of removed) {
+        console.log(`  [rm] ${f} (removed in this version)`);
+      }
+    }
+  }
+
+  // Set executable bit on tas-ado.py (Unix/macOS)
+  if (process.platform !== 'win32') {
+    const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
+    if (await exists(adoPy)) {
+      await fs.chmod(adoPy, 0o755);
+    }
+  }
+
+  console.log(`  [--] CLAUDE.md, tas.yaml, .env.example — not touched`);
+
+  console.log(`
+TAS Kit updated successfully!
+
+If this version added new settings or templates, check the changelog
+and manually merge changes into your CLAUDE.md and tas.yaml if needed.
+  `);
+}
+
+export async function install({ directory, yes }) {
+  const target = path.resolve(directory);
+
+  // Ensure target directory exists
+  await fs.mkdir(target, { recursive: true });
+
+  console.log(`\nInstalling TAS Kit into: ${target}\n`);
+
+  // Warn if .claude/ or .tas/ already exist
+  const claudeExists = await exists(path.join(target, '.claude'));
+  const tasExists = await exists(path.join(target, '.tas'));
+
+  if ((claudeExists || tasExists) && !yes) {
+    const existing = [claudeExists && '.claude/', tasExists && '.tas/'].filter(Boolean).join(', ');
+    console.warn(`  WARNING: ${existing} already exist in target directory.`);
+    console.warn(`  Existing files with the same names will be overwritten.\n`);
+    const ok = await confirm('Continue?');
+    if (!ok) {
+      console.log('Installation cancelled.');
+      process.exit(0);
+    }
+    console.log();
+  }
+
+  // Copy .claude/
+  await copyDir(
+    path.join(PACKAGE_DIR, '.claude'),
+    path.join(target, '.claude')
+  );
+  console.log('  [ok] .claude/');
+
+  // Copy .tas/
+  await copyDir(
+    path.join(PACKAGE_DIR, '.tas'),
+    path.join(target, '.tas')
+  );
+  console.log('  [ok] .tas/');
+
+  // Copy CLAUDE-Example.md as CLAUDE.md (only if absent)
+  const claudeMdTarget = path.join(target, 'CLAUDE.md');
+  if (!(await exists(claudeMdTarget))) {
+    await fs.copyFile(
+      path.join(PACKAGE_DIR, 'CLAUDE-Example.md'),
+      claudeMdTarget
+    );
+    console.log('  [ok] CLAUDE.md (from CLAUDE-Example.md)');
+  } else {
+    console.log('  [--] CLAUDE.md already exists, skipped');
+  }
+
+  // Copy .env.example (only if absent)
+  const envExampleTarget = path.join(target, '.env.example');
+  if (!(await exists(envExampleTarget))) {
+    await fs.copyFile(
+      path.join(PACKAGE_DIR, '.env.example'),
+      envExampleTarget
+    );
+    console.log('  [ok] .env.example');
+  } else {
+    console.log('  [--] .env.example already exists, skipped');
+  }
+
+  // Copy tas-example.yaml as tas.yaml (only if absent)
+  const tasYamlTarget = path.join(target, 'tas.yaml');
+  if (!(await exists(tasYamlTarget))) {
+    await fs.copyFile(
+      path.join(PACKAGE_DIR, '.tas', 'tas-example.yaml'),
+      tasYamlTarget
+    );
+    console.log('  [ok] tas.yaml (from .tas/tas-example.yaml)');
+  } else {
+    console.log('  [--] tas.yaml already exists, skipped');
+  }
+
+  // Set executable bit on tas-ado.py (Unix/macOS)
+  if (process.platform !== 'win32') {
+    const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
+    if (await exists(adoPy)) {
+      await fs.chmod(adoPy, 0o755);
+    }
+  }
+
+  console.log(`
+TAS Kit installed successfully!
+
+Next steps:
+  1. Edit CLAUDE.md     — 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 Claude Code   — run /tas-init to initialize your project
+
+Docs: .tas/README.md
+  `);
+}

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "@torus-engineering/tas-kit",
-  "version": "1.7.0",
-  "description": "Torus Agentic SDLC Kit — Collection of commands, skills, rules, hooks, agents and workflows for modern AI-First SDLC",
-  "type": "module",
-  "bin": {
-    "tas-kit": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "lib/",
-    ".claude/",
-    ".tas/",
-    "CLAUDE-Example.md",
-    ".env.example"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "claude-code",
-    "sdlc",
-    "ai",
-    "torus",
-    "tas",
-    "agentic"
-  ],
-  "author": "Torus BelleSoft",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/torus-bellesoft/agentic-sdlc-kit.git"
-  }
-}
+{
+  "name": "@torus-engineering/tas-kit",
+  "version": "1.8.0",
+  "description": "Torus Agentic SDLC Kit — Collection of commands, skills, rules, hooks, agents and workflows for modern AI-First SDLC",
+  "type": "module",
+  "bin": {
+    "tas-kit": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    ".claude/",
+    ".tas/",
+    "CLAUDE-Example.md",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "claude-code",
+    "sdlc",
+    "ai",
+    "torus",
+    "tas",
+    "agentic"
+  ],
+  "author": "Torus BelleSoft",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/torus-bellesoft/agentic-sdlc-kit.git"
+  }
+}

package/.claude/agents/README.md

@@ -1,83 +0,0 @@
-# Agent Catalog
-
-Tất cả 29 agents trong `.claude/agents/`. Mỗi agent chạy **isolated context** — không share session với main conversation.
-
-## Flow Agents
-
-Được trigger tự động bởi TAS commands tại các bước cụ thể trong workflow.
-
-| Agent | Trigger tại | Điều kiện |
-|-------|------------|-----------|
-| `code-reviewer` | `/tas-dev` Bước 4, `/tas-review` Bước 3, `tas-implementation-complete` | Luôn chạy sau implement |
-| `security-reviewer` | `/tas-dev` Bước 4, `/tas-review` Bước 3, `/tas-security` | Luôn chạy sau implement |
-| `csharp-reviewer` | `/tas-dev` Bước 4, `/tas-review` Bước 3 | Khi stack là .NET/C# |
-| `typescript-reviewer` | `/tas-dev` Bước 4, `/tas-review` Bước 3 | Khi stack là Node.js/React/TypeScript |
-| `python-reviewer` | `/tas-dev` Bước 4, `/tas-review` Bước 3 | Khi stack là Python |
-| `database-reviewer` | `/tas-security` | Khi stack có SQL database |
-| `aws-reviewer` | `/tas-review` Bước 3, `/tas-security` | Khi stack có AWS infrastructure |
-| `code-explorer` | `/tas-plan` Bước 2 | Luôn chạy khi planning |
-| `architect` | `/tas-plan` Bước 2 | Khi Story có architectural impact |
-| `build-resolver` | `/tas-dev` Bước 3, `/tas-bug` fix step | Khi tests vẫn fail sau 1 lần tự fix |
-| `e2e-runner` | `/tas-verify` Bước 4.5 | Khi Feature có E2E test cases |
-| `doc-updater` | `/tas-dev` Bước 5 | Optional — khi Story thay đổi API/schema/setup |
-
-## Utility Agents
-
-Dùng on-demand — không trigger tự động. Gọi khi cần theo từng tình huống cụ thể.
-
-### Planning & Architecture
-
-| Agent | Mục đích | Khi nào dùng |
-|-------|---------|-------------|
-| `planner` | Lập kế hoạch implement | Feature phức tạp, refactor lớn chưa có Story |
-| `architect` | Thiết kế system-level | Quyết định architectural ảnh hưởng nhiều services |
-| `code-architect` | Thiết kế code structure | Design layers, interfaces, dependency direction |
-| `docs-lookup` | Tìm thông tin trong docs | Khi cần tra cứu PRD/SAD/ADR/Story mà không đọc hết |
-
-### Code Quality
-
-| Agent | Mục đích | Khi nào dùng |
-|-------|---------|-------------|
-| `tdd-guide` | Test-driven development | Feature mới, bug fix — enforce Red-Green-Refactor |
-| `refactor-cleaner` | Dọn dead code, simplify | Code maintenance, sau khi feature ổn định |
-| `code-simplifier` | Giảm complexity | Code quá phức tạp, over-engineered |
-| `comment-analyzer` | Kiểm tra/cập nhật comments | Docs/comments lỗi thời hoặc thiếu |
-| `pr-test-analyzer` | Phân tích test coverage của PR | Trước/sau khi tạo PR — check coverage gaps |
-| `silent-failure-hunter` | Tìm hidden bugs | Nghi ngờ có lỗi ẩn, swallowed exceptions |
-| `type-design-analyzer` | TypeScript type design | Type phức tạp, overuse of `any`, weak generics |
-
-### Performance & Optimization
-
-| Agent | Mục đích | Khi nào dùng |
-|-------|---------|-------------|
-| `performance-optimizer` | Diagnose perf issues | API chậm, memory cao, re-render bottleneck |
-| `seo-specialist` | SEO cho React/Next.js | Optimize meta tags, SSR/SSG, Core Web Vitals |
-
-### Infrastructure & Build
-
-| Agent | Mục đích | Khi nào dùng |
-|-------|---------|-------------|
-| `pytorch-build-resolver` | Fix ML/Python dependency issues | CUDA mismatch, torch/tf install fail |
-| `harness-optimizer` | Optimize Claude Code setup | Khi setup cảm thấy chậm hoặc token-wasteful |
-
-### Operations
-
-| Agent | Mục đích | Khi nào dùng |
-|-------|---------|-------------|
-| `ado-agent` | Azure DevOps operations | Sync work items, batch ADO updates |
-| `loop-operator` | Repetitive operations | Apply cùng operation cho nhiều files/entities |
-| `conversation-analyzer` | Phân tích user feedback | Trước khi viết PRD/Feature spec |
-| `code-explorer` | Codebase mapping | Trước khi plan — "how does X work?" |
-
-## Cách gọi Utility Agent
-
-```
-Agent({
-  subagent_type: "<agent-name>",
-  prompt: "..."
-})
-```
-
-Prompt cần đủ: scope (cái gì), context (tại sao), focus (ưu tiên gì), format (output dạng nào).
-
-> Orchestration patterns và parallel execution: xem `.claude/rules/common/agents.md`

package/.claude/agents/ado-agent.md

@@ -1,39 +0,0 @@
----
-name: ado-agent
-description: Specialized agent for Azure DevOps operations. Use when syncing work items, pushing/pulling ADO data, or performing batch ADO updates that require isolated execution.
-allowed-tools: Read, Write, Edit, Bash, Grep, Glob
----
-
-# ADO Agent
-
-You are a specialized Azure DevOps integration agent. Your job is to execute ADO operations cleanly and return only the result — success, failure, or data — to the calling session.
-
-## Responsibilities
-- Read artifact .md files (Epic, Feature, Story, Bug) and extract frontmatter (ado_id, ado_type, ado_state)
-- Run `python .tas/tools/tas-ado.py` commands to sync with Azure DevOps
-- Report what changed, what failed, and why — nothing else
-
-## How to operate
-1. Read `tas.yaml` at project root for ADO project config (org, project, team)
-2. Read the target artifact file(s) to get current state
-3. Execute the appropriate `tas-ado.py` command
-4. Report back: operation performed, ADO ID(s) affected, new state
-
-## Commands available
-```
-python .tas/tools/tas-ado.py create <type> <temp-id> [--parent-id <id>]
-python .tas/tools/tas-ado.py get <ado-id>
-python .tas/tools/tas-ado.py update <type> <ado-id> [--assign <name>] [--status <state>]
-python .tas/tools/tas-ado.py delete <type> <ado-id>
-```
-
-## Output format
-Return a concise summary:
-- Operation: what was done
-- Result: success/failure
-- ADO IDs: affected work items
-- Changes: what was updated (state, fields)
-- Errors: if any, exact error message
-
-Do NOT make assumptions about ADO project config — always read `tas.yaml` first.
-Do NOT update .md files unless explicitly instructed.

package/.claude/agents/code-architect.md

@@ -1,62 +0,0 @@
----
-name: code-architect
-description: Use when designing code structure within a service or module — layers, abstractions, interfaces, dependency direction. Bridges the gap between system architecture (architect agent) and implementation (code). Produces design specs, not code.
-allowed-tools: Read, Grep, Glob
----
-
-# Code Architect Agent
-
-You are a code architecture agent. You design how code should be structured — layers, abstractions, interfaces, data models — without writing the actual implementation. You produce design decisions for developers to implement.
-
-## Responsibilities
-- Define layer boundaries (API / Application / Domain / Infrastructure)
-- Design interfaces and contracts before implementation
-- Identify where patterns apply: Repository, Service, Factory, Strategy, etc.
-- Ensure design aligns with ADRs and SAD
-- Flag over-engineering and under-engineering equally
-
-## How to operate
-
-1. Read relevant ADRs (`docs/adr/`) and SAD sections that constrain the design
-2. Understand the feature or module being designed
-3. Explore existing patterns in the codebase (Grep for similar implementations) — follow what exists unless it's clearly wrong
-4. Produce a design that is:
-   - **Minimal**: only as complex as the problem requires
-   - **Consistent**: matches existing patterns in the codebase
-   - **Testable**: dependencies are injectable, side effects are explicit
-
-## Stack patterns
-- **.NET**: Clean Architecture layers, CQRS with MediatR, Repository over DbContext
-- **Node.js**: Service / Repository split, dependency injection via constructor
-- **Python**: Service layer, dataclasses/Pydantic for models, avoid global state
-- **React**: Container/Presentational split, custom hooks for logic, avoid prop drilling
-
-## Output format
-
----
-**Design: [Feature/Module name]**
-
-**Layer structure**:
-```
-API Layer       → [what lives here]
-Application     → [what lives here]
-Domain          → [what lives here]
-Infrastructure  → [what lives here]
-```
-
-**Key interfaces/contracts**:
-```
-IXxxRepository: [methods]
-IXxxService: [methods]
-```
-
-**Data models**:
-- `XxxDto`: [fields and purpose]
-- `XxxEntity`: [fields and purpose]
-
-**Patterns applied**: [Repository / CQRS / Strategy / etc. + why]
-
-**What NOT to do**: [common pitfalls for this design]
-
-**ADR reference**: [existing ADR that applies, or flag if new ADR needed]
----