@qa-gentic/stlc-agents 1.0.8 → 1.0.9

package/README.md

@@ -35,10 +35,19 @@ A sixth server — **Playwright MCP** (`http://localhost:8931/mcp`) — drives a
 
 ```bash
 # 1. Install the CLI + npm package globally
+#    You will be prompted to choose your integration: ado / jira / both
+#    The choice is saved to ~/.qa-stlc/integration and reused by all subsequent commands.
 npm install -g @qa-gentic/stlc-agents
 ```
 
-The postinstall script automatically runs `pip install qa-gentic-stlc-agents` and prints next-step instructions. It does **not** prompt for input — all interactive setup is done in the next step.
+> **Note:** On most systems, the installer will prompt you to select your integration (ADO, Jira, or both) and then automatically run `qa-stlc init` and offer to scaffold a new project. If you do **not** see the prompt (for example, if npm skips postinstall for an already-installed package, or in some non-interactive environments), simply run:
+>
+> ```bash
+> qa-stlc init
+> qa-stlc scaffold
+> ```
+> 
+> This will perform the same setup steps as the postinstall script.
 
 ```bash
 # 2. Bootstrap your project (installs Python agents, copies skills, writes MCP config)

package/bin/postinstall.js

@@ -92,4 +92,8 @@ ${b("Next steps")} — run these inside your project root:
      ${C.cyan}npx @playwright/mcp@latest --port 8931${C.reset}
 
 ${d("Docs: https://github.com/qa-gentic/stlc-agents")}
+
+${d("  Tip: npm sometimes suppresses postinstall output for global packages.")}
+${d("       If you missed these instructions, run  qa-stlc  in your project.")}
+${d("       Or reinstall with: npm install -g --foreground-scripts @qa-gentic/stlc-agents")}
 `);

package/bin/qa-stlc.js

@@ -101,9 +101,43 @@ Quick Start (run once in your project root):
   $ npx @playwright/mcp@latest --port 8931
 `);
 
-program.parse(process.argv);
-
-// Show help if no command given
+// Show next-step instructions if invoked with no command.
+// This is the reliable fallback when npm suppresses postinstall output.
 if (!process.argv.slice(2).length) {
-  program.outputHelp();
-}
+  const C = {
+    reset: "\x1b[0m", bold: "\x1b[1m",
+    green: "\x1b[32m", cyan: "\x1b[36m", dim: "\x1b[2m",
+  };
+  const b = (s) => `${C.bold}${s}${C.reset}`;
+  const d = (s) => `${C.dim}${s}${C.reset}`;
+  console.log(`
+${b("QA STLC Agents")} v${pkg.version}
+
+${b("Next steps")} — run these inside your project root:
+
+  ${b("1.")} Choose your integration and bootstrap:
+
+     ${C.cyan}qa-stlc init --vscode --integration ado${C.reset}   ${d("# VS Code / GitHub Copilot — Azure DevOps")}
+     ${C.cyan}qa-stlc init --vscode --integration jira${C.reset}  ${d("# VS Code / GitHub Copilot — Jira Cloud")}
+     ${C.cyan}qa-stlc init --vscode --integration both${C.reset}  ${d("# VS Code / GitHub Copilot — ADO + Jira")}
+     ${C.cyan}qa-stlc init --integration ado${C.reset}            ${d("# Claude Code — Azure DevOps")}
+
+     ${d("Installs skills, writes MCP config, sets your integration.")}
+     ${d("Run once; re-run any time to change integration.")}
+
+  ${b("2.")} Scaffold a new Playwright + Cucumber + TypeScript QA project:
+
+     ${C.cyan}qa-stlc scaffold --name my-qa-project${C.reset}
+
+  ${b("3.")} Start the Playwright browser server (keep running in a separate terminal):
+
+     ${C.cyan}npx @playwright/mcp@latest --port 8931${C.reset}
+
+  Run ${b("qa-stlc --help")} for the full command reference.
+
+${d("Docs: https://github.com/qa-gentic/stlc-agents")}
+`);
+  process.exit(0);
+}
+
+program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qa-gentic/stlc-agents",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "QA STLC Agents — five MCP servers + skills for AI-powered test case, Gherkin, Playwright generation, and Helix-QA file writing against Azure DevOps and Jira Cloud. Full pipeline for both: fetch → test cases → Gherkin → Playwright → Helix-QA. Works with Claude Code, GitHub Copilot, Cursor, Windsurf.",
   "keywords": [
     "playwright",