@qa-gentic/stlc-agents 1.0.8 → 1.0.10

package/README.md

@@ -4,8 +4,8 @@
 
 Works with **GitHub Copilot** (VS Code Agent mode), **Claude Code**, **Cursor**, and **Windsurf**.
 
-[![npm version](https://img.shields.io/npm/v/@qa-gentic/stlc-agents)](https://www.npmjs.com/package/@qa-gentic/stlc-agents)
-[![PyPI version](https://img.shields.io/pypi/v/qa-gentic-stlc-agents)](https://pypi.org/project/qa-gentic-stlc-agents/)
+![npm version](https://img.shields.io/badge/npm-v1.0.10-blue)
+![PyPI version](https://img.shields.io/badge/pypi-v1.0.10-blue)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 [![Python >=3.10](https://img.shields.io/badge/python-%3E%3D3.10-blue)](https://python.org)
@@ -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

@@ -2,26 +2,41 @@
 /**
  * postinstall.js — Auto-install Python MCP servers after npm install -g
  *
- * npm 7+ runs lifecycle scripts with stdout suppressed by default (background
- * mode).  To guarantee output is always visible we write exclusively to
- * stderr, which npm forwards to the terminal even in background mode.
+ * npm 7+ captures all stdout/stderr from lifecycle scripts for global installs,
+ * so normal process.stdout / process.stderr writes are swallowed.
+ *
+ * Fix: write directly to /dev/tty (Unix) which bypasses npm's pipe entirely.
+ * Falls back to process.stderr (visible for local installs / Windows CI).
  *
  * Interactive prompts (readline / TTY) require --foreground-scripts and are
- * therefore NOT used here.  The user is instructed to run `qa-stlc init`
- * in their project after install — that command IS interactive.
+ * therefore NOT used here.  The user is instructed to run `qa-stlc` in their
+ * project after install — that command IS interactive.
  */
 "use strict";
 
-// ── Route ALL output to stderr so it shows without --foreground-scripts ──────
-const _write = (msg) => process.stderr.write(msg + "\n");
+// ── Open /dev/tty so writes go straight to the user's terminal ───────────────
+// npm 7+ suppresses all stdout/stderr for global lifecycle scripts; /dev/tty
+// bypasses that pipe entirely.  Fall back to stderr on Windows / non-TTY CI.
+const fs   = require("fs");
+let _tty = null;
+try {
+  _tty = fs.openSync("/dev/tty", "w");
+} catch (_) { /* Windows or no TTY — use stderr fallback */ }
+
+const _write = (msg) => {
+  const line = msg + "\n";
+  if (_tty !== null) {
+    try { fs.writeSync(_tty, line); return; } catch (_) {}
+  }
+  process.stderr.write(line);
+};
 console.log   = _write;
 console.info  = _write;
 console.warn  = _write;
 console.error = _write;
 
 const { spawnSync } = require("child_process");
-const os  = require("os");
-const fs  = require("fs");
+const os   = require("os");
 const path = require("path");
 const pkg = require("../package.json");
 
@@ -92,4 +107,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.10",
   "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",