create-healix 1.1.5 → 1.2.0

package/README.md

@@ -0,0 +1,34 @@
+# create-healix
+
+Scaffold a [Healix](https://www.npmjs.com/package/wdio-healix-service) test-automation project in one command — a ready-to-run WebdriverIO setup wired for AI-assisted authoring and **self-healing, standalone** test suites.
+
+```bash
+npx create-healix my-app
+cd my-app
+```
+
+## What you get
+- **WebdriverIO + Healix service** preconfigured (`wdio.web.conf.ts`).
+- **`.mcp.json`** registering the [`healix-mcp`](https://www.npmjs.com/package/healix-mcp) server, so an AI agent (Claude Code, Cursor, Windsurf, …) can drive the live browser, observe the real DOM, and author specs/page objects for you.
+- **Two-file page-object model** + an example spec/POM to copy.
+- **Allure reporting** and a `reports/screenshots/` directory wired out of the box.
+- **`CLAUDE.md`** + a SessionStart hook so the agent always loads the framework guide.
+
+## Options
+| Flag | Effect |
+|------|--------|
+| `--yes`, `-y` | Accept all defaults |
+| `--platforms=web,android,ios` | Target platforms (default `web`) |
+| `--app-url=<url>` | Default app URL for the example spec |
+| `--mcp=cursor\|claude\|windsurf` | Which MCP client to configure |
+| `--skip-install` | Don't run `npm install` |
+
+## Run it
+```bash
+npm run session:web   # opens a live browser + the Healix API for the agent to drive
+npm test              # runs the suite standalone — no AI, no MCP
+```
+
+The deliverable is a normal WDIO suite: it runs in CI with `npx wdio run` and **no AI in the loop**.
+
+See [`wdio-healix-service`](https://www.npmjs.com/package/wdio-healix-service) (the framework) and [`healix-mcp`](https://www.npmjs.com/package/healix-mcp) (the agent server).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-healix",
-  "version": "1.1.5",
+  "version": "1.2.0",
   "description": "Scaffold a healix WDIO project with MCP integration ready out of the box",
   "type": "module",
   "bin": {

package/src/templates.js

@@ -1,7 +1,7 @@
 // Template generators for create-healix scaffold output.
 // Each function returns the file content as a string with all known fixes applied.
 
-const HEALIX_SERVICE_VERSION = '^0.2.0';
+const HEALIX_SERVICE_VERSION = '^0.3.0';
 
 export function tsconfigJson() {
   return JSON.stringify(
@@ -55,6 +55,7 @@ export function packageJson(projectName) {
         '@wdio/local-runner': '^9',
         '@wdio/mocha-framework': '^9',
         '@wdio/spec-reporter': '^9',
+        '@wdio/allure-reporter': '^9',
         'cross-env': '^7',
         'ts-node': '^10',
         typescript: '^5',
@@ -77,10 +78,14 @@ export function wdioWebConf(apiPort = 4000) {
   framework: 'mocha',
   mochaOpts: {
     ui: 'bdd',
-    timeout: 300000,
+    // Interactive/agent sessions are held open inside ONE long-lived mocha test; WDIO
+    // (@wdio/utils) would otherwise kill it at this timeout (default 5 min) and force a
+    // mid-run restart. Lift it for agent mode with a large FINITE value — NEVER 0, which
+    // in WDIO yields a negative (instant-firing) timeout, the opposite of mocha's "disable".
+    timeout: (process.env.HEALIX_AGENT === '1' || process.env.HEALIX_INTERACTIVE === 'true') ? 86400000 : 300000,
   },
 
-  reporters: ['spec'],
+  reporters: ['spec', ['allure', { outputDir: 'allure-results' }]],
 
   suites: {
     smoke:   ['./test/specs/smoke/**/*.spec.ts'],
@@ -116,7 +121,7 @@ export function wdioWebConf(apiPort = 4000) {
     },
   }]],
 
-  waitforTimeout: 10000,
+  waitforTimeout: 5000,
   connectionRetryTimeout: 120000,
   connectionRetryCount: 3,
 
@@ -144,32 +149,31 @@ export function mcpJson(port = 4000) {
 // The re-hydration reminder text — single source, shared by the hook script and
 // kept short so it re-anchors without becoming noise.
 const REHYDRATE_REMINDER =
-  'HEALIX RE-HYDRATION: a context compaction just occurred. Before ANY healix_* ' +
-  'automation step, re-run healix_guide to reload the framework model + workflow — ' +
-  'do not operate from memory of it. Drive the live browser only through healix_* ' +
-  'tools; every selector is observed, never guessed.';
+  'HEALIX PROJECT: drive the live browser ONLY through the healix_* MCP tools — ' +
+  'every selector is observed live, never guessed, and specs/POMs are authored via ' +
+  'the scaffold tools. If the Healix guide is not currently in your context, run ' +
+  'healix_guide before any scaffold/heal/run step — do not operate from memory of it.';
 
-// Tiny script the compact hook runs. Living in a FILE (not an inline `node -e`)
-// avoids cross-shell quoting hell — the hook command is just `node <path>`.
+// Tiny script the hook runs. Living in a FILE (not an inline `node -e`) avoids
+// cross-shell quoting hell — the hook command is just `node <path>`.
 export function claudeRehydrateScript() {
-  return `// Printed into the agent's context by the SessionStart(compact) hook.\n` +
+  return `// Printed into the agent's context by the SessionStart hook (startup + after compaction).\n` +
     `console.log(${JSON.stringify(REHYDRATE_REMINDER)});\n`;
 }
 
-// Claude Code SessionStart hook that fires AFTER a context compaction/summary and
-// re-injects the healix re-hydration reminder. Compaction drops tool results (where
-// the full healix_guide lives), so without this the agent can "forget" the workflow.
-// The hook's stdout is added to the agent's context on resume — deterministic, no
-// reliance on the model noticing the guide is gone. matcher "compact" = only after a
-// compaction (not every startup), so it is silent during normal work. The command is
-// a bare `node <relative path>` (no nested quotes) so it works in cmd, PowerShell, sh.
+// Claude Code-format SessionStart hook (host-agnostic: read by any host that
+// supports the .claude/settings.json convention — Claude Code, Spryv, …). No
+// matcher = fires on every SessionStart: it SEEDS the workflow at startup and
+// RE-HYDRATES after a context compaction (when tool results, where the full
+// healix_guide lives, get dropped). The hook's stdout is injected into the
+// agent's context — deterministic, no reliance on the model noticing the guide is
+// gone. The command is a bare `node <relative path>` so it works in cmd/PowerShell/sh.
 export function claudeSettings() {
   return JSON.stringify(
     {
       hooks: {
         SessionStart: [
           {
-            matcher: 'compact',
             hooks: [
               { type: 'command', command: 'node .claude/healix-rehydrate.mjs' },
             ],