@qa-gentic/stlc-agents 1.0.28 → 1.0.29

package/bin/postinstall.js

@@ -85,10 +85,20 @@ if (!python) {
   if (pip.status === 0) {
     ok("qa-gentic-stlc-agents installed.");
   } else {
-    // Only surface pip output on failure
-    if (pip.stdout) process.stderr.write(pip.stdout);
-    if (pip.stderr) process.stderr.write(pip.stderr);
-    warn("pip install failed. Run manually: pip install qa-gentic-stlc-agents");
+    // Route pip's output through _write (/dev/tty) — process.stderr is swallowed
+    // by npm 7+ for global lifecycle scripts, so direct stderr writes vanish.
+    const combined = `${pip.stdout || ""}${pip.stderr || ""}`;
+    combined.split("\n").filter(Boolean).forEach((l) => console.log(d(l)));
+    warn("pip install failed.");
+    if (/externally-managed-environment/i.test(combined)) {
+      console.log("");
+      console.log(`${b("This Python is PEP 668-locked")} ${d("(Homebrew, Debian, Ubuntu).")} Install with one of:`);
+      console.log(`  ${C.cyan}brew install pipx && pipx install qa-gentic-stlc-agents${C.reset}   ${d("# isolated, commands on PATH")}`);
+      console.log(`  ${C.cyan}python3 -m pip install --user --break-system-packages qa-gentic-stlc-agents${C.reset}`);
+      console.log(`  ${C.cyan}python3 -m venv .venv && source .venv/bin/activate && pip install qa-gentic-stlc-agents${C.reset}`);
+    } else {
+      warn("Run manually: pip install qa-gentic-stlc-agents");
+    }
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qa-gentic/stlc-agents",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "description": "QA STLC Agents — six MCP servers + skills for AI-powered test case, Gherkin, self-healing Playwright generation, Helix-QA file writing, and existing-framework migration against Azure DevOps and Jira Cloud. Includes an 8-strategy LocatorHealer with a live HealingDashboard (write-back-to-source) and a one-shot `stlc-migrate` CLI that converts an existing Playwright project into a fully agent-ready Helix-QA tree. Works with Claude Code, GitHub Copilot, Cursor, Windsurf.",
   "keywords": [
     "playwright",
@@ -56,7 +56,6 @@
     "postinstall": "node ./bin/postinstall.js"
   },
   "_comment": "Diff to apply to package.json — add the cost command to qa-stlc.js",
-
   "diff": {
     "bin/qa-stlc.js": {
       "add_require": "const cmdCost = require('../src/cli/cmd-cost');",
@@ -68,6 +67,7 @@
   },
   "full_command_to_add_to_qa-stlc.js": "// ── cost ─────────────────────────────────────────────────────────────────\nprogram\n  .command('cost')\n  .description(\n    'Show token usage and cost for the current or past pipeline sessions.\\n' +\n    'Reads logs from ~/.qa-stlc/cost-*.jsonl written by the MCP servers.\\n' +\n    'Each MCP tool call logs tokens, cost, and latency automatically.'\n  )\n  .option('--all', 'Show all sessions (not just the last one)')\n  .option('--session <id>', 'Show a specific session by its ID')\n  .option('--json', 'Emit raw JSON instead of a formatted table')\n  .action(cmdCost);",
   "dependencies": {
+    "@qa-gentic/stlc-agents": "^1.0.28",
     "commander": "^12.0.0",
     "which": "^4.0.0"
   },