@torus-engineering/tas-kit 1.13.0 → 2.1.0

package/.tas/_platform/claude-code/settings.json

@@ -1,46 +1,58 @@
-{
-  "permissions": {
-    "allow": [
-      "Read:*",
-      "Write:*",
-      "Edit:*",
-      "Bash:git:*",
-      "Bash:python:*",
-      "Bash:python3:*",
-      "Bash:dotnet:*",
-      "Bash:npm:*",
-      "Bash:node:*",
-      "Bash:az:*"
-    ],
-    "deny": [
-      "Bash:sudo:*",
-      "Read:**/.env",
-      "Read:**/*.env"
-    ]
-  },
-  "hooks": {
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .claude/hooks/code-quality.js",
-            "description": "Auto format source files: prettier (TS/JS), ruff/black (Python), dotnet format (C#)"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .claude/hooks/session-end.js",
-            "description": "Run test suite, check project-status.yaml updated, remind next steps"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "mcpServers": {
+    "puppeteer": {
+      "command": "npx",
+      "args": ["-y", "@anthropic-ai/mcp-server-puppeteer"],
+      "description": "Browser automation for build-verify loop (screenshots, console scan, API check)"
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp"],
+      "description": "Alternative browser automation — prefer over puppeteer if already installed"
+    }
+  },
+  "permissions": {
+    "allow": [
+      "Read:*",
+      "Write:*",
+      "Edit:*",
+      "Bash:git:*",
+      "Bash:python:*",
+      "Bash:python3:*",
+      "Bash:dotnet:*",
+      "Bash:npm:*",
+      "Bash:node:*",
+      "Bash:az:*"
+    ],
+    "deny": [
+      "Bash:sudo:*",
+      "Read:**/.env",
+      "Read:**/*.env"
+    ]
+  },
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/code-quality.js",
+            "description": "Auto format source files: prettier (TS/JS), ruff/black (Python), dotnet format (C#)"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/session-end.js",
+            "description": "Run test suite, check project-status.yaml updated, remind next steps"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.tas/_platform/hooks/code-quality.js

@@ -1,127 +1,127 @@
-#!/usr/bin/env node
-/**
- * PostToolUse Hook: Auto format/lint source files after Write/Edit/MultiEdit
- *
- * Detects file extension and runs the appropriate formatter using project-local tools:
- *   .ts/.tsx/.js/.jsx  → prettier (via npx/yarn)
- *   .py                → ruff format (preferred) or black
- *   .cs                → dotnet format --include <file>
- *
- * Uses project-local binaries only — never installs packages globally.
- * Silently skips if the tool is not installed in the project.
- *
- * Hook input (stdin): JSON with tool_input.file_path
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-// --- Read hook input ---
-let input;
-try {
-  const raw = fs.readFileSync(0, 'utf8');
-  input = JSON.parse(raw);
-} catch {
-  process.exit(0);
-}
-
-const filePath = (input.tool_input || {}).file_path || '';
-if (!filePath) process.exit(0);
-
-const ext = path.extname(filePath).toLowerCase();
-const fileName = path.basename(filePath);
-
-// Skip non-source files (markdown, yaml, json config, etc.)
-const SOURCE_EXTS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.py', '.cs']);
-if (!SOURCE_EXTS.has(ext)) process.exit(0);
-
-// --- Helper: run command, return true on success ---
-function run(cmd, cwd) {
-  try {
-    execSync(cmd, { cwd, stdio: 'pipe' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-// --- Helper: find repo root (where package.json / pyproject.toml / *.sln lives) ---
-function findRoot(startDir, markers) {
-  let dir = path.resolve(startDir);
-  for (let i = 0; i < 10; i++) {
-    if (markers.some(m => fs.existsSync(path.join(dir, m)))) return dir;
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return null;
-}
-
-// ─── TypeScript / JavaScript ─────────────────────────────────────────────────
-if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(ext)) {
-  const root = findRoot(path.dirname(filePath), ['package.json']);
-  if (!root) process.exit(0);
-
-  const pkg = path.join(root, 'package.json');
-  let hasScript = false;
-  try {
-    const pkgJson = JSON.parse(fs.readFileSync(pkg, 'utf8'));
-    hasScript = !!(pkgJson.scripts && pkgJson.scripts.format);
-  } catch { /* ignore */ }
-
-  // Prefer project format script → npx prettier → yarn prettier
-  const formatted =
-    (hasScript && run(`npm run format -- --write "${filePath}"`, root)) ||
-    run(`npx --no-install prettier --write "${filePath}"`, root) ||
-    run(`yarn prettier --write "${filePath}"`, root);
-
-  if (formatted) {
-    console.log(`[Format] ${fileName}`);
-  }
-}
-
-// ─── Python ──────────────────────────────────────────────────────────────────
-else if (ext === '.py') {
-  const root = findRoot(path.dirname(filePath), ['pyproject.toml', 'setup.py', 'setup.cfg', 'requirements.txt']);
-  const cwd = root || path.dirname(filePath);
-
-  const formatted =
-    run(`ruff format "${filePath}"`, cwd) ||
-    run(`python -m ruff format "${filePath}"`, cwd) ||
-    run(`black "${filePath}"`, cwd) ||
-    run(`python -m black "${filePath}"`, cwd);
-
-  if (formatted) {
-    console.log(`[Format] ${fileName}`);
-  }
-}
-
-// ─── C# ──────────────────────────────────────────────────────────────────────
-else if (ext === '.cs') {
-  // Find nearest .csproj
-  function findCsproj(startDir) {
-    let dir = path.resolve(startDir);
-    for (let i = 0; i < 8; i++) {
-      const files = fs.readdirSync(dir).filter(f => f.endsWith('.csproj'));
-      if (files.length > 0) return { cwd: dir, proj: path.join(dir, files[0]) };
-      const parent = path.dirname(dir);
-      if (parent === dir) break;
-      dir = parent;
-    }
-    return null;
-  }
-
-  const result = findCsproj(path.dirname(filePath));
-  if (!result) process.exit(0);
-
-  const formatted = run(
-    `dotnet format "${result.proj}" --include "${filePath}" --no-restore`,
-    result.cwd
-  );
-  if (formatted) {
-    console.log(`[Format] ${fileName}`);
-  }
-}
+#!/usr/bin/env node
+/**
+ * PostToolUse Hook: Auto format/lint source files after Write/Edit/MultiEdit
+ *
+ * Detects file extension and runs the appropriate formatter using project-local tools:
+ *   .ts/.tsx/.js/.jsx  → prettier (via npx/yarn)
+ *   .py                → ruff format (preferred) or black
+ *   .cs                → dotnet format --include <file>
+ *
+ * Uses project-local binaries only — never installs packages globally.
+ * Silently skips if the tool is not installed in the project.
+ *
+ * Hook input (stdin): JSON with tool_input.file_path
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// --- Read hook input ---
+let input;
+try {
+  const raw = fs.readFileSync(0, 'utf8');
+  input = JSON.parse(raw);
+} catch {
+  process.exit(0);
+}
+
+const filePath = (input.tool_input || {}).file_path || '';
+if (!filePath) process.exit(0);
+
+const ext = path.extname(filePath).toLowerCase();
+const fileName = path.basename(filePath);
+
+// Skip non-source files (markdown, yaml, json config, etc.)
+const SOURCE_EXTS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.py', '.cs']);
+if (!SOURCE_EXTS.has(ext)) process.exit(0);
+
+// --- Helper: run command, return true on success ---
+function run(cmd, cwd) {
+  try {
+    execSync(cmd, { cwd, stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// --- Helper: find repo root (where package.json / pyproject.toml / *.sln lives) ---
+function findRoot(startDir, markers) {
+  let dir = path.resolve(startDir);
+  for (let i = 0; i < 10; i++) {
+    if (markers.some(m => fs.existsSync(path.join(dir, m)))) return dir;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+// ─── TypeScript / JavaScript ─────────────────────────────────────────────────
+if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(ext)) {
+  const root = findRoot(path.dirname(filePath), ['package.json']);
+  if (!root) process.exit(0);
+
+  const pkg = path.join(root, 'package.json');
+  let hasScript = false;
+  try {
+    const pkgJson = JSON.parse(fs.readFileSync(pkg, 'utf8'));
+    hasScript = !!(pkgJson.scripts && pkgJson.scripts.format);
+  } catch { /* ignore */ }
+
+  // Prefer project format script → npx prettier → yarn prettier
+  const formatted =
+    (hasScript && run(`npm run format -- --write "${filePath}"`, root)) ||
+    run(`npx --no-install prettier --write "${filePath}"`, root) ||
+    run(`yarn prettier --write "${filePath}"`, root);
+
+  if (formatted) {
+    console.log(`[Format] ${fileName}`);
+  }
+}
+
+// ─── Python ──────────────────────────────────────────────────────────────────
+else if (ext === '.py') {
+  const root = findRoot(path.dirname(filePath), ['pyproject.toml', 'setup.py', 'setup.cfg', 'requirements.txt']);
+  const cwd = root || path.dirname(filePath);
+
+  const formatted =
+    run(`ruff format "${filePath}"`, cwd) ||
+    run(`python -m ruff format "${filePath}"`, cwd) ||
+    run(`black "${filePath}"`, cwd) ||
+    run(`python -m black "${filePath}"`, cwd);
+
+  if (formatted) {
+    console.log(`[Format] ${fileName}`);
+  }
+}
+
+// ─── C# ──────────────────────────────────────────────────────────────────────
+else if (ext === '.cs') {
+  // Find nearest .csproj
+  function findCsproj(startDir) {
+    let dir = path.resolve(startDir);
+    for (let i = 0; i < 8; i++) {
+      const files = fs.readdirSync(dir).filter(f => f.endsWith('.csproj'));
+      if (files.length > 0) return { cwd: dir, proj: path.join(dir, files[0]) };
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+    return null;
+  }
+
+  const result = findCsproj(path.dirname(filePath));
+  if (!result) process.exit(0);
+
+  const formatted = run(
+    `dotnet format "${result.proj}" --include "${filePath}" --no-restore`,
+    result.cwd
+  );
+  if (formatted) {
+    console.log(`[Format] ${fileName}`);
+  }
+}

package/.tas/_platform/hooks/session-end.js

@@ -1,111 +1,111 @@
-#!/usr/bin/env node
-/**
- * Stop Hook: End-of-session verification
- *
- * Runs when Claude Code session ends. Performs:
- *   1. Auto-detects test runner and runs the test suite
- *   2. Checks if project-status.yaml was updated today
- *   3. Prints a summary of pass/fail checks
- *
- * Designed to be non-blocking — all failures are reported as warnings,
- * not hard errors, so the session can still end cleanly.
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-const checks = [];
-
-// --- Helper: run command, return { ok, output } ---
-function run(cmd, cwd) {
-  try {
-    const output = execSync(cmd, { cwd, stdio: 'pipe', timeout: 60_000 }).toString();
-    return { ok: true, output };
-  } catch (err) {
-    return { ok: false, output: (err.stderr || err.stdout || err.message || '').toString() };
-  }
-}
-
-// --- Find repo root (cwd of the session) ---
-const cwd = process.cwd();
-
-// ─── 1. Run test suite ────────────────────────────────────────────────────────
-let testRan = false;
-
-// Node.js / npm
-if (fs.existsSync(path.join(cwd, 'package.json'))) {
-  let hasTestScript = false;
-  try {
-    const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'));
-    hasTestScript = !!(pkg.scripts && pkg.scripts.test &&
-      pkg.scripts.test !== 'echo "Error: no test specified" && exit 1');
-  } catch { /* ignore */ }
-
-  if (hasTestScript) {
-    const result = run('npm test', cwd);
-    checks.push(result.ok
-      ? '✓ Tests passed (npm test)'
-      : '✗ Tests FAILED (npm test) — fix before committing'
-    );
-    testRan = true;
-  }
-}
-
-// .NET
-if (!testRan) {
-  function findDotnetFiles(startDir, maxDepth = 3) {
-    const results = [];
-    function walk(dir, depth) {
-      if (depth > maxDepth) return;
-      try {
-        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-          if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
-            walk(path.join(dir, entry.name), depth + 1);
-          } else if (entry.name.endsWith('.csproj') || entry.name.endsWith('.sln')) {
-            results.push(entry.name);
-          }
-        }
-      } catch { /* ignore */ }
-    }
-    walk(startDir, 0);
-    return results;
-  }
-
-  const csprojFiles = findDotnetFiles(cwd);
-
-  if (csprojFiles.length > 0) {
-    const result = run('dotnet test --no-build --logger "console;verbosity=minimal" 2>&1', cwd);
-    checks.push(result.ok
-      ? '✓ Tests passed (dotnet test)'
-      : '✗ Tests FAILED (dotnet test) — fix before committing'
-    );
-    testRan = true;
-  }
-}
-
-// Python (pytest)
-if (!testRan) {
-  const hasPytest =
-    fs.existsSync(path.join(cwd, 'pytest.ini')) ||
-    fs.existsSync(path.join(cwd, 'pyproject.toml')) ||
-    fs.existsSync(path.join(cwd, 'setup.cfg'));
-
-  if (hasPytest) {
-    const result = run('python -m pytest -q --tb=no 2>&1', cwd);
-    checks.push(result.ok
-      ? '✓ Tests passed (pytest)'
-      : '✗ Tests FAILED (pytest) — fix before committing'
-    );
-    testRan = true;
-  }
-}
-
-// ─── Output ──────────────────────────────────────────────────────────────────
-if (checks.length > 0) {
-  console.log('\n[TAS] Session end checks:');
-  checks.forEach(c => console.log('  ' + c));
-  console.log('');
-}
+#!/usr/bin/env node
+/**
+ * Stop Hook: End-of-session verification
+ *
+ * Runs when Claude Code session ends. Performs:
+ *   1. Auto-detects test runner and runs the test suite
+ *   2. Checks if project-status.yaml was updated today
+ *   3. Prints a summary of pass/fail checks
+ *
+ * Designed to be non-blocking — all failures are reported as warnings,
+ * not hard errors, so the session can still end cleanly.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const checks = [];
+
+// --- Helper: run command, return { ok, output } ---
+function run(cmd, cwd) {
+  try {
+    const output = execSync(cmd, { cwd, stdio: 'pipe', timeout: 60_000 }).toString();
+    return { ok: true, output };
+  } catch (err) {
+    return { ok: false, output: (err.stderr || err.stdout || err.message || '').toString() };
+  }
+}
+
+// --- Find repo root (cwd of the session) ---
+const cwd = process.cwd();
+
+// ─── 1. Run test suite ────────────────────────────────────────────────────────
+let testRan = false;
+
+// Node.js / npm
+if (fs.existsSync(path.join(cwd, 'package.json'))) {
+  let hasTestScript = false;
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'));
+    hasTestScript = !!(pkg.scripts && pkg.scripts.test &&
+      pkg.scripts.test !== 'echo "Error: no test specified" && exit 1');
+  } catch { /* ignore */ }
+
+  if (hasTestScript) {
+    const result = run('npm test', cwd);
+    checks.push(result.ok
+      ? '✓ Tests passed (npm test)'
+      : '✗ Tests FAILED (npm test) — fix before committing'
+    );
+    testRan = true;
+  }
+}
+
+// .NET
+if (!testRan) {
+  function findDotnetFiles(startDir, maxDepth = 3) {
+    const results = [];
+    function walk(dir, depth) {
+      if (depth > maxDepth) return;
+      try {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+          if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+            walk(path.join(dir, entry.name), depth + 1);
+          } else if (entry.name.endsWith('.csproj') || entry.name.endsWith('.sln')) {
+            results.push(entry.name);
+          }
+        }
+      } catch { /* ignore */ }
+    }
+    walk(startDir, 0);
+    return results;
+  }
+
+  const csprojFiles = findDotnetFiles(cwd);
+
+  if (csprojFiles.length > 0) {
+    const result = run('dotnet test --no-build --logger "console;verbosity=minimal" 2>&1', cwd);
+    checks.push(result.ok
+      ? '✓ Tests passed (dotnet test)'
+      : '✗ Tests FAILED (dotnet test) — fix before committing'
+    );
+    testRan = true;
+  }
+}
+
+// Python (pytest)
+if (!testRan) {
+  const hasPytest =
+    fs.existsSync(path.join(cwd, 'pytest.ini')) ||
+    fs.existsSync(path.join(cwd, 'pyproject.toml')) ||
+    fs.existsSync(path.join(cwd, 'setup.cfg'));
+
+  if (hasPytest) {
+    const result = run('python -m pytest -q --tb=no 2>&1', cwd);
+    checks.push(result.ok
+      ? '✓ Tests passed (pytest)'
+      : '✗ Tests FAILED (pytest) — fix before committing'
+    );
+    testRan = true;
+  }
+}
+
+// ─── Output ──────────────────────────────────────────────────────────────────
+if (checks.length > 0) {
+  console.log('\n[TAS] Session end checks:');
+  checks.forEach(c => console.log('  ' + c));
+  console.log('');
+}