@qa-gentic/agents 1.1.2

package/src/cmd-skills.js

@@ -0,0 +1,124 @@
+/**
+ * cmd-skills.js — `qa-stlc skills`
+ *
+ * Copies skill markdown files into the correct directory for each coding agent:
+ *
+ *   claude    →  .claude/skills/  +  .claude/AGENT-BEHAVIOR.md
+ *   vscode    →  .github/copilot-instructions/
+ *   cursor    →  .cursor/rules/ (one file per skill)
+ *   windsurf  →  .windsurf/rules/
+ *   both      →  claude + vscode
+ *   print     →  stdout only
+ */
+"use strict";
+
+const path = require("path");
+const fs   = require("fs");
+
+const C = {
+  reset: "\x1b[0m", bold: "\x1b[1m",
+  green: "\x1b[32m", yellow: "\x1b[33m", dim: "\x1b[2m",
+};
+const ok   = (m) => console.log(`${C.green}✓${C.reset}  ${m}`);
+const info = (m) => console.log(`   ${C.dim}${m}${C.reset}`);
+const warn = (m) => console.log(`${C.yellow}⚠${C.reset}  ${m}`);
+
+// Resolve the skills bundled with this npm package
+const PKG_ROOT    = path.resolve(__dirname, "..");
+const SKILLS_DIR  = path.join(PKG_ROOT, "skills", "qa-stlc");
+const BEHAVIOR_MD = path.join(SKILLS_DIR, "AGENT-BEHAVIOR.md");
+
+/** Copy a file, creating parent dirs as needed. */
+function cp(src, dest) {
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+
+/** List all .md files in SKILLS_DIR (flat). */
+function skillFiles() {
+  return fs.readdirSync(SKILLS_DIR)
+    .filter((f) => f.endsWith(".md") && f !== "AGENT-BEHAVIOR.md")
+    .map((f) => path.join(SKILLS_DIR, f));
+}
+
+const CWD = process.cwd();
+
+function installClaude() {
+  const dest = path.join(CWD, ".claude", "skills");
+  for (const src of skillFiles()) {
+    cp(src, path.join(dest, path.basename(src)));
+  }
+  cp(BEHAVIOR_MD, path.join(CWD, ".claude", "AGENT-BEHAVIOR.md"));
+  ok(`Skills installed → .claude/skills/`);
+  info("AGENT-BEHAVIOR.md → .claude/AGENT-BEHAVIOR.md");
+  skillFiles().forEach((f) => info(path.basename(f)));
+  printPlaywrightHint();
+}
+
+function installVscode() {
+  const dest = path.join(CWD, ".github", "copilot-instructions");
+  for (const src of skillFiles()) {
+    cp(src, path.join(dest, path.basename(src)));
+  }
+  cp(BEHAVIOR_MD, path.join(dest, "AGENT-BEHAVIOR.md"));
+  ok(`Skills installed → .github/copilot-instructions/`);
+  info("Add to .github/copilot-instructions.md:");
+  info("  @.github/copilot-instructions/AGENT-BEHAVIOR.md");
+  printPlaywrightHint();
+}
+
+function installCursor() {
+  const dest = path.join(CWD, ".cursor", "rules");
+  for (const src of skillFiles()) {
+    cp(src, path.join(dest, path.basename(src)));
+  }
+  cp(BEHAVIOR_MD, path.join(dest, "AGENT-BEHAVIOR.md"));
+  ok(`Skills installed → .cursor/rules/`);
+  printPlaywrightHint();
+}
+
+function installWindsurf() {
+  const dest = path.join(CWD, ".windsurf", "rules");
+  for (const src of skillFiles()) {
+    cp(src, path.join(dest, path.basename(src)));
+  }
+  cp(BEHAVIOR_MD, path.join(dest, "AGENT-BEHAVIOR.md"));
+  ok(`Skills installed → .windsurf/rules/`);
+  printPlaywrightHint();
+}
+
+function printSkills() {
+  console.log("\nAvailable skills:\n");
+  skillFiles().forEach((f) => console.log(`  ${path.basename(f)}`));
+  console.log(`  AGENT-BEHAVIOR.md`);
+}
+
+function printPlaywrightHint() {
+  console.log(`
+  ${C.dim}Start Playwright MCP before running generation workflows:${C.reset}
+  npx @playwright/mcp@latest --port 8931
+`);
+}
+
+module.exports = async function skills(opts) {
+  const target = (opts.target || "claude").toLowerCase();
+
+  if (!fs.existsSync(SKILLS_DIR)) {
+    console.error(`Skills directory not found: ${SKILLS_DIR}`);
+    console.error("Try reinstalling: npm install -g @qa-stlc/agents");
+    process.exit(1);
+  }
+
+  switch (target) {
+    case "claude":  installClaude();  break;
+    case "vscode":  installVscode();  break;
+    case "cursor":  installCursor();  break;
+    case "windsurf": installWindsurf(); break;
+    case "both":    installClaude(); installVscode(); break;
+    case "print":   printSkills();   break;
+    default:
+      warn(`Unknown target: ${target}`);
+      warn("Valid targets: claude, vscode, cursor, windsurf, both, print");
+      process.exit(1);
+  }
+};

package/src/cmd-verify.js

@@ -0,0 +1,129 @@
+/**
+ * cmd-verify.js — `qa-stlc verify`
+ *
+ * Quick sanity checks:
+ *   1. Are the four Python MCP agents on PATH (or in .venv)?
+ *   2. Is Playwright MCP reachable on the expected port?
+ *   3. Is MSAL auth cache present?
+ */
+"use strict";
+
+const path   = require("path");
+const fs     = require("fs");
+const http   = require("http");
+const https  = require("https");
+const { spawnSync } = require("child_process");
+const os     = require("os");
+
+const C = {
+  reset: "\x1b[0m", bold: "\x1b[1m",
+  green: "\x1b[32m", yellow: "\x1b[33m", red: "\x1b[31m", dim: "\x1b[2m",
+};
+const ok   = (m) => console.log(`  ${C.green}✓${C.reset}  ${m}`);
+const fail = (m) => console.log(`  ${C.red}✗${C.reset}  ${m}`);
+const warn = (m) => console.log(`  ${C.yellow}⚠${C.reset}  ${m}`);
+const head = (m) => console.log(`\n${C.bold}${m}${C.reset}`);
+
+const CWD    = process.cwd();
+const IS_WIN = process.platform === "win32";
+const EXT    = IS_WIN ? ".exe" : "";
+
+const AGENT_NAMES = [
+  "qa-test-case-manager",
+  "qa-gherkin-generator",
+  "qa-playwright-generator",
+  "qa-helix-writer",
+];
+
+function findBinary(name) {
+  // .venv first
+  const venvBin = IS_WIN
+    ? path.join(CWD, ".venv", "Scripts", name + EXT)
+    : path.join(CWD, ".venv", "bin", name);
+  if (fs.existsSync(venvBin)) return venvBin;
+  // system PATH
+  const w = spawnSync(IS_WIN ? "where" : "which", [name], { encoding: "utf8" });
+  if (w.status === 0 && w.stdout.trim()) return w.stdout.trim().split("\n")[0].trim();
+  return null;
+}
+
+function checkPort(port) {
+  return new Promise((resolve) => {
+    const req = http.get(`http://localhost:${port}/`, (res) => {
+      res.destroy();
+      resolve(true);
+    });
+    req.setTimeout(2000, () => { req.destroy(); resolve(false); });
+    req.on("error", () => resolve(false));
+  });
+}
+
+module.exports = async function verify(opts) {
+  const playwrightPort = opts.playwrightPort || "8931";
+  let allOk = true;
+
+  // ── 1. Python agents ──────────────────────────────────────────────────────
+  head("Python MCP Agents");
+  for (const name of AGENT_NAMES) {
+    const bin = findBinary(name);
+    if (bin) {
+      ok(`${name}  ${C.dim}${bin}${C.reset}`);
+    } else {
+      fail(`${name}  — not found`);
+      allOk = false;
+    }
+  }
+  if (!allOk) {
+    console.log(`\n  ${C.yellow}Fix: pip install qa-gentic-agents${C.reset}`);
+  }
+
+  // ── 2. Playwright MCP ─────────────────────────────────────────────────────
+  head("Playwright MCP");
+  const pwReachable = await checkPort(playwrightPort);
+  if (pwReachable) {
+    ok(`Reachable on port ${playwrightPort}`);
+  } else {
+    warn(`Not reachable on port ${playwrightPort}  ${C.dim}(start it with: npx @playwright/mcp@latest --port ${playwrightPort})${C.reset}`);
+    // Don't fail — it's optional until generation time
+  }
+
+  // ── 3. MSAL token cache ───────────────────────────────────────────────────
+  head("Azure DevOps Auth (MSAL)");
+  const msalCache = path.join(os.homedir(), ".msal-cache", "msal-cache.json");
+  if (fs.existsSync(msalCache)) {
+    const stat = fs.statSync(msalCache);
+    ok(`Token cache found  ${C.dim}${msalCache}  (${Math.round(stat.size / 1024)} KB)${C.reset}`);
+  } else {
+    warn(`No MSAL cache at ${msalCache}`);
+    warn(`A browser will open the first time an agent calls Azure DevOps.`);
+    warn(`Set AZURE_CLIENT_ID + AZURE_CLIENT_SECRET + AZURE_TENANT_ID for CI/CD.`);
+  }
+
+  // ── 4. MCP config files ───────────────────────────────────────────────────
+  head("MCP Config");
+  const mcpJson   = path.join(CWD, ".mcp.json");
+  const vscodeMcp = path.join(CWD, ".vscode", "mcp.json");
+  if (fs.existsSync(mcpJson))   ok(`.mcp.json present`);
+  else                          warn(`.mcp.json missing  — run: qa-stlc mcp-config`);
+  if (fs.existsSync(vscodeMcp)) ok(`.vscode/mcp.json present`);
+  else                          warn(`.vscode/mcp.json missing  — run: qa-stlc mcp-config --vscode`);
+
+  // ── 5. Skills ─────────────────────────────────────────────────────────────
+  head("Skills");
+  const claudeSkills = path.join(CWD, ".claude", "skills");
+  const copilotSkills = path.join(CWD, ".github", "copilot-instructions");
+  if (fs.existsSync(claudeSkills)) {
+    const files = fs.readdirSync(claudeSkills).filter((f) => f.endsWith(".md"));
+    ok(`Claude Code skills (${files.length} files)  ${C.dim}${claudeSkills}${C.reset}`);
+  } else {
+    warn(`No Claude Code skills  — run: qa-stlc skills`);
+  }
+  if (fs.existsSync(copilotSkills)) {
+    const files = fs.readdirSync(copilotSkills).filter((f) => f.endsWith(".md"));
+    ok(`Copilot instructions (${files.length} files)  ${C.dim}${copilotSkills}${C.reset}`);
+  } else {
+    warn(`No Copilot instructions  — run: qa-stlc skills --target vscode`);
+  }
+
+  console.log();
+};