@azrico/azcli 1.2.5 → 1.2.7

package/README.md

@@ -29,15 +29,15 @@ With Yarn available on PATH, the equivalent commands are `yarn install --immutab
 | `package finalize` | Generate publishable manifests in `dist/`, `build/`, or `temp/`. |
 | `package publish` | Publish the prepared packages. |
 | `package go` | Prepare, build, finalize, then publish; stop on the first failure. |
-| `yarni`, `yarnb`, `yarnt` | Run Yarn install, build, or test. |
 | `transcripts <claude\|codex>` | Export sessions to Markdown with an `index.json`. |
 | `optimize-transcripts <claude\|codex>` | Prepare a transcript snapshot and run the selected analysis agent. |
 | `verify-changes` | Run the checks from `.azcli/verify.json` that match files changed since the base ref. Reports `passed`, `failed`, or `not-run`; exits 1 on failure (`--strict` also on not-run). `--profile`, `--base`, `--json`. |
 | `worktree start <path>` | Install the worktree's locked dependencies, pick a free port above the configured default, run the dev server detached, and wait for it to answer or exit. Reports URL, pid, compile result, and log file (inside the git dir). Fails at once if the process exits; `--timeout` bounds the wait. `--page`, `--port`, `--skip-install`. |
 | `worktree status <path>` | Branch tips and dirty files of the worktree and the target, ahead/behind counts, whether the branch is merged, and dependency manifests changed on each side. |
 | `worktree sync <path> --direction in|out|both` | Merge the target into the worktree branch (`in`) and/or the branch into the target (`out`). Refuses dirty trees; on conflict stops with the merge in progress and writes base/ours/theirs copies under the git dir, flagging whitespace-only conflicts. Never resolves conflicts; exits 1 on conflict. |
+| `browser-check [directory]` | Start the selected project's dev server, wait for readiness, and run its browser-test script with the server origin in `BASE_URL`. `--tags`, `--headed`, `--url`, `--json`. |
 
-Worktree commands read `.azcli/worktree.json` from the worktree, else from `--project`; run `azcli worktree start --help` for the format. All three accept `--target` and `--json`.
+Worktree commands read `.azcli/worktree.json` from the worktree, else from `--project`; run `azcli worktree start --help` for the format. All three accept `--target` and `--json`.
 
 Project commands accept `--path` to select a working directory. Build, update, clean, and publish accept `--type`, direct flags such as `--python`, and exclusions such as `--nopython` or `--no-python`. Use `--quiet` to suppress progress. Errors go to stderr and cause a nonzero exit status.
 
@@ -45,6 +45,49 @@ External tools must already be available on PATH. Commands run with explicit arg
 
 Production Composer installation (`up --prod` and WordPress builds) preserves the lockfile and installs with `--no-dev`. Normal Composer updates retain the existing dependency-refresh behavior. Python build/publish expands distribution files explicitly.
 
+## Browser checks
+
+```sh
+azcli browser-check ./worktrees/order --tags "@shipping and not @save"
+azcli browser-check --path ./web --url http://localhost:3001 --tags "@shipping" --headed
+```
+
+The directory defaults to the current directory and does not need to be a Git repository. All browser-check configuration lives in `.azcli/browser.json`. Without `--url`, startup installs locked project dependencies, picks a free port above the configured default, and waits for the server. Exited, timed-out, or failed-compilation servers stop the browser checks before the test command runs. Started servers remain running after success or test failure; the command prints their URL, pid, and log location. Logs are written to `.azcli/logs/browser/` in the selected directory; add `.azcli/logs/` to that project's `.gitignore`. `--skip-install`, `--port`, `--page`, and `--timeout` control startup.
+
+Use `--url` for an already-running server; this skips installation and startup. Its availability is checked by the project's tests. The server's **origin** (scheme, host, and port, without the page path) is passed as `BASE_URL`. `--headed` sets `HEADED=1`; project browser hooks must read that variable to show the browser.
+
+By default, browser checks run `yarn test:browser` in the selected directory. Configure the test command and server together in `.azcli/browser.json` (this example assumes the application's start script reads `PORT`):
+
+```json
+{
+  "command": "yarn",
+  "args": ["test:browser"],
+  "baseUrlEnv": "BASE_URL",
+  "report": "cucumber-report.html",
+  "install": {
+    "command": "yarn",
+    "args": ["install", "--immutable"]
+  },
+  "dev": {
+    "command": "yarn",
+    "args": ["start"],
+    "defaultPort": 3000,
+    "portEnv": "PORT",
+    "readyPath": "/",
+    "timeoutSeconds": 120,
+    "pages": { "order": "/order" }
+  }
+}
+```
+
+`command` is required when the file exists; `args` defaults to an empty array. Optional `cwd` selects a directory inside the selected project. `report` is relative to that test working directory and must stay inside it. `baseUrlEnv` defaults to `BASE_URL`. Config is read from the selected directory, falling back to `--project`; fallback configuration still runs against the selected directory. Tags are appended as `--tags <expression>` without shell parsing. For npm scripts, use `"command": "npm", "args": ["run", "test:browser", "--"]`.
+
+`dev` is required for startup; without a config or `dev`, supply `--url`. `install` is optional and defaults to `yarn install --immutable` at the selected directory. Both accept `command`, `args`, and optional `cwd` relative to that directory. `dev.defaultPort` defaults to 3000; startup picks the first free port above it unless `--port` is supplied. `dev.portEnv` defaults to `PORT`, and `{port}` in dev arguments is replaced with the selected port. `dev.readyPath` defaults to `/`, `timeoutSeconds` to 120, and `binDirs` to `["node_modules/.bin"]`. `--page` selects a named path from `dev.pages`; it affects the reported server URL, while `BASE_URL` remains the origin. Optional `compiledPattern` and `failedPattern` customize regexes matched against the dev log. Worktree configuration is never read by browser-check.
+
+The target application owns its `.feature` files, Cucumber step definitions, authentication, fixtures, and cleanup. For example, its `package.json` can define `"test:browser": "cucumber-js"`. Its browser hook should create a Playwright context with `baseURL: process.env.BASE_URL` and launch with `headless: process.env.HEADED !== '1'`. Configure Cucumber's HTML formatter to write the same file named by `report`; azcli reports its path when that file exists after a successful run. Test failures propagate to exit code 1. `--quiet` suppresses progress and subprocess output; `--json` returns server details and captured test output on success, while failures use the normal CLI error handler.
+
+`@cucumber/cucumber` (12.x, compatible with Node.js 20) and `@playwright/test` are optional dependencies of azcli. Other commands do not import them, so they work when optional dependencies are omitted. Browser binaries are a separate setup step (`yarn playwright install chromium` in the application). The application's test script and step definitions must have their own resolvable Cucumber/Playwright dependencies, usually declared as its dev dependencies; installing azcli globally does not expose its optional packages to another project's module resolution. No packages or browser binaries are installed automatically by browser-check beyond its configured dependency install.
+
 ## Transcript options
 
 Use `--project <text>` repeatedly to filter projects, `--since-days 0` to include all dates, and `--last N` to select the newest N matched sessions across projects. `--list` lists without exporting. Rendering supports `--user-only`, `--no-include-tools`, `--no-include-thinking`, and `--include-subagents`.
@@ -58,7 +101,7 @@ src/
   cli/                         entry point, registration, shared CLI options
   core/                        subprocesses, files, JSON guards, logging, project detection
   features/
-    build/ clean/ update/ publish/ package/ yarn/
+    build/ clean/ update/ publish/ package/
     transcripts/               extraction, rendering, types, JSONL readers
       sources/                 Claude and Codex adapters
     optimize-transcripts/      snapshots, redaction, prompts, agent execution

package/dist/cli/create-cli.js

@@ -14,8 +14,8 @@ const command_6 = __importDefault(require("../features/transcripts/command"));
 const command_7 = __importDefault(require("../features/optimize-transcripts/command"));
 const command_8 = __importDefault(require("../features/verify-changes/command"));
 const command_9 = __importDefault(require("../features/worktree/command"));
-const commands_1 = require("../features/yarn/commands");
-const commands = [command_1.default, command_2.default, command_3.default, command_4.default, command_5.default, command_6.default, command_7.default, command_8.default, command_9.default, commands_1.installCommand, commands_1.buildCommand, commands_1.testCommand];
+const command_10 = __importDefault(require("../features/browser-check/command"));
+const commands = [command_1.default, command_2.default, command_3.default, command_4.default, command_5.default, command_6.default, command_7.default, command_8.default, command_9.default, command_10.default];
 function getHelpCommand(command) {
     const registered = commands.some((module) => [module.command].flat().some((name) => name?.split(' ')[0] === command));
     return `azcli${registered ? ` ${command}` : ''} --help`;

package/dist/cli/create-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-cli.js","sourceRoot":"","sources":["../../src/cli/create-cli.ts"],"names":[],"mappings":";;;;;;AAAA,wDAAgC;AAChC,wEAA8C;AAC9C,wEAA8C;AAC9C,yEAAgD;AAChD,0EAAkD;AAClD,0EAAmD;AACnD,8EAA0D;AAC1D,uFAAgE;AAChE,iFAA+D;AAC/D,2EAAoD;AACpD,wDAAsF;AAEtF,MAAM,QAAQ,GAAG,CAAC,iBAAK,EAAE,iBAAK,EAAE,iBAAM,EAAE,iBAAO,EAAE,iBAAQ,EAAE,iBAAW,EAAE,iBAAQ,EAAE,iBAAa,EAAE,iBAAQ,EAAE,yBAAc,EAAE,uBAAY,EAAE,sBAAW,CAAC,CAAC;AAEtJ,SAAgB,cAAc,CAAC,OAAoC;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IACtH,OAAO,QAAQ,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;AACzD,CAAC;AAHD,wCAGC;AAED,SAAgB,SAAS,CAAC,IAAc;IACvC,OAAO,IAAA,eAAK,EAAC,IAAI,CAAC;SAChB,UAAU,CAAC,OAAO,CAAC;SACnB,KAAK,CAAC,+BAA+B,CAAC;SACtC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,yCAAyC,EAAE,CAAC;SAC5G,OAAO,CAAM,QAAQ,CAAC;SACtB,aAAa,CAAC,CAAC,CAAC;SAChB,MAAM,EAAE;SACR,IAAI,EAAE;SACN,WAAW,CAAC,KAAK,CAAC;SAClB,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAXD,8BAWC"}
+{"version":3,"file":"create-cli.js","sourceRoot":"","sources":["../../src/cli/create-cli.ts"],"names":[],"mappings":";;;;;;AAAA,wDAAgC;AAChC,wEAA8C;AAC9C,wEAA8C;AAC9C,yEAAgD;AAChD,0EAAkD;AAClD,0EAAmD;AACnD,8EAA0D;AAC1D,uFAAgE;AAChE,iFAA+D;AAC/D,2EAAoD;AACpD,iFAA6D;AAE7D,MAAM,QAAQ,GAAG,CAAC,iBAAK,EAAE,iBAAK,EAAE,iBAAM,EAAE,iBAAO,EAAE,iBAAQ,EAAE,iBAAW,EAAE,iBAAQ,EAAE,iBAAa,EAAE,iBAAQ,EAAE,kBAAY,CAAC,CAAC;AAEzH,SAAgB,cAAc,CAAC,OAAoC;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IACtH,OAAO,QAAQ,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;AACzD,CAAC;AAHD,wCAGC;AAED,SAAgB,SAAS,CAAC,IAAc;IACvC,OAAO,IAAA,eAAK,EAAC,IAAI,CAAC;SAChB,UAAU,CAAC,OAAO,CAAC;SACnB,KAAK,CAAC,+BAA+B,CAAC;SACtC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,yCAAyC,EAAE,CAAC;SAC5G,OAAO,CAAM,QAAQ,CAAC;SACtB,aAAa,CAAC,CAAC,CAAC;SAChB,MAAM,EAAE;SACR,IAAI,EAAE;SACN,WAAW,CAAC,KAAK,CAAC;SAClB,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAXD,8BAWC"}

package/dist/core/dev-server-config.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDevConfig = exports.parseCommandConfig = void 0;
+const json_1 = require("./json");
+function stringArray(value, label) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string'))
+        throw new Error(`${label} must be an array of strings`);
+    return value;
+}
+function parseCommandConfig(value, label) {
+    if (!(0, json_1.isRecord)(value))
+        throw new Error(`${label} must be an object`);
+    const command = (0, json_1.asString)(value.command);
+    if (!command)
+        throw new Error(`${label} needs a "command"`);
+    return { command, args: value.args === undefined ? [] : stringArray(value.args, `${label} "args"`), cwd: (0, json_1.asString)(value.cwd) };
+}
+exports.parseCommandConfig = parseCommandConfig;
+function positive(value, label, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value <= 0)
+        throw new Error(`${label} must be a positive integer`);
+    return value;
+}
+function parseDevConfig(value) {
+    const base = parseCommandConfig(value, '"dev"');
+    const dev = value;
+    const pages = {};
+    if (dev.pages !== undefined) {
+        if (!(0, json_1.isRecord)(dev.pages))
+            throw new Error('"dev" "pages" must be an object');
+        for (const [name, page] of Object.entries(dev.pages)) {
+            if (typeof page !== 'string')
+                throw new Error(`"dev" page "${name}" must be a string`);
+            pages[name] = page;
+        }
+    }
+    return {
+        ...base,
+        portEnv: (0, json_1.asString)(dev.portEnv) ?? 'PORT',
+        defaultPort: positive(dev.defaultPort, '"dev" "defaultPort"', 3000),
+        readyPath: (0, json_1.asString)(dev.readyPath) ?? '/',
+        pages,
+        timeoutSeconds: positive(dev.timeoutSeconds, '"dev" "timeoutSeconds"', 120),
+        binDirs: dev.binDirs === undefined ? ['node_modules/.bin'] : stringArray(dev.binDirs, '"dev" "binDirs"'),
+        compiledPattern: (0, json_1.asString)(dev.compiledPattern) ?? 'Compiled (successfully|with warnings)',
+        failedPattern: (0, json_1.asString)(dev.failedPattern) ?? 'Failed to compile|Module not found|error TS\\d+',
+    };
+}
+exports.parseDevConfig = parseDevConfig;
+//# sourceMappingURL=dev-server-config.js.map

package/dist/core/dev-server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server-config.js","sourceRoot":"","sources":["../../src/core/dev-server-config.ts"],"names":[],"mappings":"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"}

package/dist/core/dev-server.js

@@ -0,0 +1,153 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatStart = exports.startDevServer = exports.pickPort = exports.isPortFree = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_http_1 = __importDefault(require("node:http"));
+const node_net_1 = __importDefault(require("node:net"));
+const node_path_1 = __importDefault(require("node:path"));
+const files_1 = require("./files");
+const logger_1 = require("./logger");
+const process_1 = require("./process");
+const pollMs = 500;
+const compileGraceMs = 3000;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function isPortFree(port) {
+    return new Promise((resolve) => {
+        const server = node_net_1.default.createServer();
+        server.once('error', () => resolve(false));
+        server.listen(port, () => server.close(() => resolve(true)));
+    });
+}
+exports.isPortFree = isPortFree;
+/** An explicitly requested port must be free; otherwise take the first free port above the default one. */
+async function pickPort(defaultPort, requested) {
+    if (requested !== undefined) {
+        if (!(await isPortFree(requested)))
+            throw new Error(`Port ${requested} is already in use`);
+        return requested;
+    }
+    for (let port = defaultPort + 1; port < defaultPort + 101; port++)
+        if (await isPortFree(port))
+            return port;
+    throw new Error(`No free port found above ${defaultPort}`);
+}
+exports.pickPort = pickPort;
+function probe(url) {
+    return new Promise((resolve) => {
+        const request = node_http_1.default.get(url, { timeout: 2000 }, (response) => {
+            response.resume();
+            resolve(true);
+        });
+        request.once('timeout', () => request.destroy());
+        request.once('error', () => resolve(false));
+    });
+}
+function killTree(pid) {
+    try {
+        if (process.platform === 'win32')
+            (0, node_child_process_1.spawnSync)('taskkill', ['/pid', String(pid), '/t', '/f'], { windowsHide: true });
+        else
+            process.kill(-pid, 'SIGTERM');
+    }
+    catch {
+        // The process is already gone.
+    }
+}
+function compileState(log, dev) {
+    if (new RegExp(dev.failedPattern, 'i').test(log))
+        return 'failed';
+    return new RegExp(dev.compiledPattern, 'i').test(log) ? 'ok' : 'unknown';
+}
+function launchEnvironment(root, cwd, dev, port) {
+    const env = { ...process.env, [dev.portEnv]: String(port) };
+    const key = Object.keys(env).find((name) => name.toUpperCase() === 'PATH') ?? 'PATH';
+    const directories = dev.binDirs.flatMap((dir) => [(0, files_1.resolveInside)(root, dir), (0, files_1.resolveInside)(cwd, dir)]);
+    env[key] = [...directories, env[key] ?? ''].join(node_path_1.default.delimiter);
+    return env;
+}
+async function startDevServer(options, config, run = process_1.runCommand) {
+    const root = node_path_1.default.resolve(options.path);
+    if (!node_fs_1.default.existsSync(root))
+        throw new Error(`Project not found: ${root}`);
+    const dev = config.dev;
+    if (!dev)
+        throw new Error('Missing dev server configuration.');
+    let pagePath = dev.readyPath;
+    if (options.page) {
+        if (!(options.page in dev.pages))
+            throw new Error(`Unknown page "${options.page}". Configured pages: ${Object.keys(dev.pages).join(', ') || 'none'}`);
+        pagePath = dev.pages[options.page];
+    }
+    if (!options.skipInstall) {
+        const install = config.install;
+        await run(install.command, install.args, { cwd: install.cwd ? (0, files_1.resolveInside)(root, install.cwd) : root, quiet: options.quiet });
+    }
+    const port = await pickPort(dev.defaultPort, options.port);
+    const cwd = dev.cwd ? (0, files_1.resolveInside)(root, dev.cwd) : root;
+    const launch = (0, process_1.resolveCommand)(dev.command, dev.args.map((arg) => arg.replaceAll('{port}', String(port))), cwd, launchEnvironment(root, cwd, dev, port));
+    const logDirectory = await options.logDirectory();
+    node_fs_1.default.mkdirSync(logDirectory, { recursive: true });
+    const log = node_path_1.default.join(logDirectory, `dev-${port}.log`);
+    const report = (fields) => ({
+        url: `http://localhost:${port}${pagePath}`, port, log, ...fields,
+    });
+    const fd = node_fs_1.default.openSync(log, 'w');
+    let exit;
+    const child = (0, node_child_process_1.spawn)(launch.command, launch.args, {
+        cwd,
+        env: launchEnvironment(root, cwd, dev, port),
+        detached: true,
+        stdio: ['ignore', fd, fd],
+        windowsHide: true,
+    });
+    node_fs_1.default.closeSync(fd);
+    child.once('error', (error) => { exit = `could not start ${dev.command}: ${error.message}`; });
+    child.once('exit', (code, signal) => { exit = signal ? `terminated by ${signal}` : `exit code ${code}`; });
+    const readLog = () => node_fs_1.default.readFileSync(log, 'utf8');
+    const tail = () => readLog().split(/\r?\n/).filter(Boolean).slice(-20).join('\n');
+    const fail = (state, error) => {
+        if (state === 'timeout' && child.pid)
+            killTree(child.pid);
+        return report({ state, compile: compileState(readLog(), dev), pid: child.pid, error, logTail: tail() });
+    };
+    const timeoutMs = (options.timeout ?? dev.timeoutSeconds) * 1000;
+    const started = Date.now();
+    const readyUrl = `http://localhost:${port}${dev.readyPath}`;
+    if (!options.quiet)
+        (0, logger_1.showMessage)(`Waiting for ${readyUrl} (up to ${timeoutMs / 1000}s)`);
+    while (!exit) {
+        if (await probe(readyUrl))
+            break;
+        if (Date.now() - started > timeoutMs)
+            return fail('timeout', `no response from ${readyUrl} within ${timeoutMs / 1000}s`);
+        await sleep(pollMs);
+    }
+    if (exit)
+        return fail('exited', `dev server stopped: ${exit}`);
+    const graceEnd = Date.now() + compileGraceMs;
+    while (compileState(readLog(), dev) === 'unknown' && Date.now() < graceEnd && !exit)
+        await sleep(200);
+    if (exit)
+        return fail('exited', `dev server stopped: ${exit}`);
+    child.unref();
+    return report({ state: 'running', compile: compileState(readLog(), dev), pid: child.pid });
+}
+exports.startDevServer = startDevServer;
+function formatStart(report) {
+    const output = [
+        `state:   ${report.state}${report.error ? ` (${report.error})` : ''}`,
+        `url:     ${report.url}`,
+        `pid:     ${report.pid ?? 'none'}`,
+        `compile: ${report.compile}`,
+        `log:     ${report.log}`,
+    ];
+    if (report.logTail)
+        output.push('last log lines:', report.logTail);
+    return output.join('\n');
+}
+exports.formatStart = formatStart;
+//# sourceMappingURL=dev-server.js.map

package/dist/core/dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../../src/core/dev-server.ts"],"names":[],"mappings":"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"}

package/dist/features/browser-check/check.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browserCheck = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const files_1 = require("../../core/files");
+const logger_1 = require("../../core/logger");
+const process_1 = require("../../core/process");
+const dev_server_1 = require("../../core/dev-server");
+const config_1 = require("./config");
+async function browserCheck(options, run = process_1.runCommand, start = dev_server_1.startDevServer) {
+    if (options.path && options.directory)
+        throw new Error('Use either the directory argument or --path, not both.');
+    const root = node_path_1.default.resolve(options.path ?? options.directory ?? process.cwd());
+    const config = (0, config_1.loadConfig)(root, node_path_1.default.resolve(options.project ?? '.'));
+    const cwd = config.cwd && config.cwd !== '.' ? (0, files_1.resolveInside)(root, config.cwd) : root;
+    const report = config.report ? (0, files_1.resolveInside)(cwd, config.report) : undefined;
+    const quiet = options.quiet || options.json;
+    let url = options.url;
+    let server;
+    if (url !== undefined) {
+        try {
+            const parsed = new URL(url);
+            if (!['http:', 'https:'].includes(parsed.protocol))
+                throw new Error('Unsupported protocol');
+            url = parsed.origin;
+        }
+        catch {
+            throw new Error('--url must be an absolute HTTP or HTTPS URL.');
+        }
+    }
+    else {
+        if (!config.dev)
+            throw new Error(`Missing "dev" in ${config_1.configFile}. Configure it or use --url for an existing server.`);
+        server = await start({
+            path: root, port: options.port,
+            page: options.page, timeout: options.timeout, skipInstall: options.skipInstall, quiet,
+            logDirectory: () => (0, files_1.resolveInside)(root, '.azcli/logs/browser'),
+        }, config, run);
+        if (server.state !== 'running' || server.compile === 'failed')
+            throw new Error(`Browser checks were not run: server startup failed.\n${(0, dev_server_1.formatStart)(server)}`);
+        url = new URL(server.url).origin;
+    }
+    if (!quiet) {
+        if (server)
+            (0, logger_1.showMessage)((0, dev_server_1.formatStart)(server), 'text', false);
+        (0, logger_1.showMessage)(`Browser checks: ${url}`);
+        if (report)
+            (0, logger_1.showMessage)(`Report destination: ${report}`);
+    }
+    const env = { ...process.env };
+    // Windows environment variable names are case-insensitive.
+    for (const key of Object.keys(env))
+        if (key.toUpperCase() === config.baseUrlEnv.toUpperCase())
+            delete env[key];
+    env[config.baseUrlEnv] = url;
+    if (options.headed)
+        env.HEADED = '1';
+    const result = await run(config.command, [...config.args, ...(options.tags ? ['--tags', options.tags] : [])], { cwd, env, quiet });
+    return { url, server, report: report && node_fs_1.default.existsSync(report) ? report : undefined, ...result };
+}
+exports.browserCheck = browserCheck;
+//# sourceMappingURL=check.js.map

package/dist/features/browser-check/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/features/browser-check/check.ts"],"names":[],"mappings":"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"}

package/dist/features/browser-check/command.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_1 = require("../../core/logger");
+const check_1 = require("./check");
+const config_1 = require("./config");
+const command = {
+    command: 'browser-check [directory]',
+    describe: 'Start a project server and run its Cucumber browser checks',
+    builder: (cli) => cli
+        .positional('directory', { type: 'string', describe: 'Project directory (default: current directory)' })
+        .option('path', { type: 'string', describe: 'Project directory instead of the positional argument' })
+        .option('project', { type: 'string', describe: 'Fallback directory for .azcli/browser.json' })
+        .option('url', { type: 'string', describe: 'Use this HTTP(S) server instead of installing and starting one' })
+        .option('tags', { type: 'string', describe: 'Cucumber tag expression, e.g. "@shipping and not @save"' })
+        .option('headed', { type: 'boolean', describe: 'Set HEADED=1 for project browser hooks' })
+        .option('port', { type: 'number', describe: 'Server port (default: first free port above the configured default)' })
+        .option('page', { type: 'string', describe: 'Page name from dev.pages in .azcli/browser.json' })
+        .option('timeout', { type: 'number', describe: 'Seconds to wait for server readiness' })
+        .option('skip-install', { type: 'boolean', describe: 'Skip installing project dependencies before startup' })
+        .option('json', { type: 'boolean', describe: 'Print the result, server details, and test output as JSON' })
+        .check((args) => {
+        if (args.port !== undefined && (!Number.isInteger(args.port) || args.port < 1 || args.port > 65535))
+            throw new Error('--port must be an integer between 1 and 65535.');
+        if (args.timeout !== undefined && (!Number.isFinite(args.timeout) || args.timeout <= 0))
+            throw new Error('--timeout must be a positive number.');
+        return true;
+    })
+        .epilog(config_1.configHelp),
+    handler: async (args) => {
+        const result = await (0, check_1.browserCheck)(args);
+        if (args.json)
+            console.log(JSON.stringify(result, null, 2));
+        else if (!args.quiet)
+            (0, logger_1.showMessage)(`Browser checks passed${result.report ? `. Report: ${result.report}` : ''}`);
+    },
+};
+exports.default = command;
+//# sourceMappingURL=command.js.map

package/dist/features/browser-check/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/features/browser-check/command.ts"],"names":[],"mappings":";;AACA,8CAAgD;AAChD,mCAA4D;AAC5D,qCAAsC;AAEtC,MAAM,OAAO,GAA2C;IACvD,OAAO,EAAE,2BAA2B;IACpC,QAAQ,EAAE,4DAA4D;IACtE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;SACnB,UAAU,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,gDAAgD,EAAE,CAAC;SACvG,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,sDAAsD,EAAE,CAAC;SACpG,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,4CAA4C,EAAE,CAAC;SAC7F,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,gEAAgE,EAAE,CAAC;SAC7G,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,yDAAyD,EAAE,CAAC;SACvG,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,wCAAwC,EAAE,CAAC;SACzF,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,qEAAqE,EAAE,CAAC;SACnH,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,iDAAiD,EAAE,CAAC;SAC/F,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,sCAAsC,EAAE,CAAC;SACvF,MAAM,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,qDAAqD,EAAE,CAAC;SAC5G,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,2DAA2D,EAAE,CAAC;SAC1G,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACvK,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACjJ,OAAO,IAAI,CAAC;IACb,CAAC,CAAC;SACD,MAAM,CAAC,mBAAU,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAY,EAAC,IAAI,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;aACvD,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,IAAA,oBAAW,EAAC,wBAAwB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChH,CAAC;CACD,CAAC;AACF,kBAAe,OAAO,CAAC"}

package/dist/features/browser-check/config.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = exports.parseConfig = exports.configHelp = exports.configFile = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const json_1 = require("../../core/json");
+const dev_server_config_1 = require("../../core/dev-server-config");
+exports.configFile = node_path_1.default.join('.azcli', 'browser.json');
+exports.configHelp = `Setup in the target web project:
+  1. yarn/npm add --dev "@cucumber/cucumber@^12" "@playwright/test"
+     yarn/npm playwright install chromium
+  2. Add package.json script: "test:browser": "cucumber-js".
+  3. Add .feature files, matching step definitions, and Playwright hooks.
+     Configure cucumber.cjs paths/require to load them. Hooks should use
+     baseURL: process.env.BASE_URL and headless: process.env.HEADED !== '1'.
+  4. Configure dev in .azcli/browser.json (example below),
+     or use --url for an already-running server.
+
+Examples:
+  azcli browser-check . --tags "@shipping" --headed
+  azcli browser-check . --url http://localhost:3001 --tags "@shipping"
+
+Config: .azcli/browser.json, read from the selected directory, else --project.
+Without a config, use --url; runs yarn test:browser with BASE_URL set to the server origin.
+Example:
+{
+  "command": "yarn",
+  "args": ["test:browser"],
+  "baseUrlEnv": "BASE_URL",
+  "report": "cucumber-report.html",
+  "dev": { "command": "yarn", "args": ["start"], "defaultPort": 3000 }
+}
+The dev command must honor PORT (or use {port} in args). dev is required unless
+--url is supplied. dev accepts cwd, portEnv, readyPath, timeoutSeconds, pages,
+binDirs, compiledPattern, and failedPattern. --page selects from dev.pages.
+Optional install: { "command": "yarn", "args": ["install", "--immutable"] }.
+This is also the default install command; --skip-install skips it.
+Optional cwd is relative to the selected directory; report is relative to cwd.
+Both must stay inside those directories. --tags is appended as a literal argument.
+Cucumber must generate the report, e.g. format: ["html:cucumber-report.html"].
+Server logs are written to .azcli/logs/browser/ in the selected directory.
+Started servers remain running after the checks; their pid and log are reported.`;
+function parseConfig(value) {
+    if (!(0, json_1.isRecord)(value))
+        throw new Error(`${exports.configFile} must contain a JSON object`);
+    if (typeof value.command !== 'string' || !value.command.trim())
+        throw new Error(`${exports.configFile} needs a "command"`);
+    if (value.args !== undefined &&
+        (!Array.isArray(value.args) || value.args.some((arg) => typeof arg !== 'string')))
+        throw new Error(`${exports.configFile} "args" must be an array of strings`);
+    for (const key of ['cwd', 'report']) {
+        const field = value[key];
+        if (field !== undefined && (typeof field !== 'string' || !field.trim()))
+            throw new Error(`${exports.configFile} "${key}" must be a nonempty string`);
+    }
+    const baseUrlEnv = value.baseUrlEnv ?? 'BASE_URL';
+    if (typeof baseUrlEnv !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(baseUrlEnv))
+        throw new Error(`${exports.configFile} "baseUrlEnv" must be an environment variable name`);
+    return {
+        command: value.command,
+        args: value.args === undefined ? [] : value.args,
+        cwd: value.cwd,
+        baseUrlEnv,
+        report: value.report,
+        install: value.install === undefined ? { command: 'yarn', args: ['install', '--immutable'] } : (0, dev_server_config_1.parseCommandConfig)(value.install, '"install"'),
+        dev: value.dev === undefined ? undefined : (0, dev_server_config_1.parseDevConfig)(value.dev),
+    };
+}
+exports.parseConfig = parseConfig;
+function loadConfig(...roots) {
+    for (const root of roots) {
+        const file = node_path_1.default.join(root, exports.configFile);
+        if (!node_fs_1.default.existsSync(file))
+            continue;
+        try {
+            return parseConfig(JSON.parse(node_fs_1.default.readFileSync(file, 'utf8')));
+        }
+        catch (error) {
+            throw new Error(`Could not read ${file}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return parseConfig({ command: 'yarn', args: ['test:browser'] });
+}
+exports.loadConfig = loadConfig;
+//# sourceMappingURL=config.js.map

package/dist/features/browser-check/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/features/browser-check/config.ts"],"names":[],"mappings":"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"}

package/dist/features/worktree/config.js

@@ -7,6 +7,7 @@ exports.loadConfig = exports.parseConfig = exports.configHelp = exports.configFi
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const json_1 = require("../../core/json");
+const dev_server_config_1 = require("../../core/dev-server-config");
 exports.configFile = node_path_1.default.join('.azcli', 'worktree.json');
 exports.configHelp = `Config file: .azcli/worktree.json (JSON), read from the worktree, else the project. Example:
 
@@ -39,58 +40,15 @@ Fields:
                   the worktree root and to cwd. Default ["node_modules/.bin"].
   compiledPattern, failedPattern
                   optional. Regexes matched against the dev log.`;
-function stringArray(value, label) {
-    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string'))
-        throw new Error(`${label} must be an array of strings`);
-    return value;
-}
-function commandConfig(value, label) {
-    if (!(0, json_1.isRecord)(value))
-        throw new Error(`${label} must be an object`);
-    const command = (0, json_1.asString)(value.command);
-    if (!command)
-        throw new Error(`${label} needs a "command"`);
-    return { command, args: value.args === undefined ? [] : stringArray(value.args, `${label} "args"`), cwd: (0, json_1.asString)(value.cwd) };
-}
-function positive(value, label, fallback) {
-    if (value === undefined)
-        return fallback;
-    if (typeof value !== 'number' || !Number.isInteger(value) || value <= 0)
-        throw new Error(`${label} must be a positive integer`);
-    return value;
-}
 function parseConfig(value) {
     if (!(0, json_1.isRecord)(value))
         throw new Error(`${exports.configFile} must contain a JSON object`);
     const config = {
         target: (0, json_1.asString)(value.target),
-        install: value.install === undefined ? { command: 'yarn', args: ['install', '--immutable'] } : commandConfig(value.install, '"install"'),
+        install: value.install === undefined ? { command: 'yarn', args: ['install', '--immutable'] } : (0, dev_server_config_1.parseCommandConfig)(value.install, '"install"'),
     };
-    if (value.dev !== undefined) {
-        const base = commandConfig(value.dev, '"dev"');
-        const dev = value.dev;
-        const pages = {};
-        if (dev.pages !== undefined) {
-            if (!(0, json_1.isRecord)(dev.pages))
-                throw new Error('"dev" "pages" must be an object');
-            for (const [name, page] of Object.entries(dev.pages)) {
-                if (typeof page !== 'string')
-                    throw new Error(`"dev" page "${name}" must be a string`);
-                pages[name] = page;
-            }
-        }
-        config.dev = {
-            ...base,
-            portEnv: (0, json_1.asString)(dev.portEnv) ?? 'PORT',
-            defaultPort: positive(dev.defaultPort, '"dev" "defaultPort"', 3000),
-            readyPath: (0, json_1.asString)(dev.readyPath) ?? '/',
-            pages,
-            timeoutSeconds: positive(dev.timeoutSeconds, '"dev" "timeoutSeconds"', 120),
-            binDirs: dev.binDirs === undefined ? ['node_modules/.bin'] : stringArray(dev.binDirs, '"dev" "binDirs"'),
-            compiledPattern: (0, json_1.asString)(dev.compiledPattern) ?? 'Compiled (successfully|with warnings)',
-            failedPattern: (0, json_1.asString)(dev.failedPattern) ?? 'Failed to compile|Module not found|error TS\\d+',
-        };
-    }
+    if (value.dev !== undefined)
+        config.dev = (0, dev_server_config_1.parseDevConfig)(value.dev);
     return config;
 }
 exports.parseConfig = parseConfig;

package/dist/features/worktree/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/features/worktree/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/features/worktree/config.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAC7B,0CAAqD;AACrD,oEAAgG;AAEnF,QAAA,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AAKlD,QAAA,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iEA8BuC,CAAC;AAElE,SAAgB,WAAW,CAAC,KAAc;IACzC,IAAI,CAAC,IAAA,eAAQ,EAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,kBAAU,6BAA6B,CAAC,CAAC;IAClF,MAAM,MAAM,GAAmB;QAC9B,MAAM,EAAE,IAAA,eAAQ,EAAC,KAAK,CAAC,MAAM,CAAC;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAA,sCAAkB,EAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC;KAC7I,CAAC;IACF,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,GAAG,IAAA,kCAAc,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AACf,CAAC;AARD,kCAQC;AAED,uGAAuG;AACvG,SAAgB,UAAU,CAAC,GAAG,KAAe;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACzB,MAAM,IAAI,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAU,CAAC,CAAC;QACzC,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,IAAI,MAAe,CAAC;QACpB,IAAI;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;SACnD;QAAC,OAAO,KAAK,EAAE;YACf,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACrG;QACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;KAC3B;IACD,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAbD,gCAaC"}

package/dist/features/worktree/start.js

@@ -3,154 +3,29 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatStart = exports.startWorktree = exports.pickPort = exports.isPortFree = void 0;
-const node_child_process_1 = require("node:child_process");
+exports.startWorktree = exports.pickPort = exports.isPortFree = exports.formatStart = void 0;
 const node_fs_1 = __importDefault(require("node:fs"));
-const node_http_1 = __importDefault(require("node:http"));
-const node_net_1 = __importDefault(require("node:net"));
 const node_path_1 = __importDefault(require("node:path"));
-const files_1 = require("../../core/files");
-const logger_1 = require("../../core/logger");
+const dev_server_1 = require("../../core/dev-server");
 const process_1 = require("../../core/process");
 const config_1 = require("./config");
 const git_1 = require("./git");
-const pollMs = 500;
-const compileGraceMs = 3000;
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-function isPortFree(port) {
-    return new Promise((resolve) => {
-        const server = node_net_1.default.createServer();
-        server.once('error', () => resolve(false));
-        server.listen(port, () => server.close(() => resolve(true)));
-    });
-}
-exports.isPortFree = isPortFree;
-/** An explicitly requested port must be free; otherwise take the first free port above the default one. */
-async function pickPort(defaultPort, requested) {
-    if (requested !== undefined) {
-        if (!(await isPortFree(requested)))
-            throw new Error(`Port ${requested} is already in use`);
-        return requested;
-    }
-    for (let port = defaultPort + 1; port < defaultPort + 101; port++)
-        if (await isPortFree(port))
-            return port;
-    throw new Error(`No free port found above ${defaultPort}`);
-}
-exports.pickPort = pickPort;
-function probe(url) {
-    return new Promise((resolve) => {
-        const request = node_http_1.default.get(url, { timeout: 2000 }, (response) => {
-            response.resume();
-            resolve(true);
-        });
-        request.once('timeout', () => request.destroy());
-        request.once('error', () => resolve(false));
-    });
-}
-function killTree(pid) {
-    try {
-        if (process.platform === 'win32')
-            (0, node_child_process_1.spawnSync)('taskkill', ['/pid', String(pid), '/t', '/f'], { windowsHide: true });
-        else
-            process.kill(-pid, 'SIGTERM');
-    }
-    catch {
-        // The process is already gone.
-    }
-}
-function compileState(log, dev) {
-    if (new RegExp(dev.failedPattern, 'i').test(log))
-        return 'failed';
-    return new RegExp(dev.compiledPattern, 'i').test(log) ? 'ok' : 'unknown';
-}
-function launchEnvironment(root, cwd, dev, port) {
-    const env = { ...process.env, [dev.portEnv]: String(port) };
-    const key = Object.keys(env).find((name) => name.toUpperCase() === 'PATH') ?? 'PATH';
-    const directories = dev.binDirs.flatMap((dir) => [(0, files_1.resolveInside)(root, dir), (0, files_1.resolveInside)(cwd, dir)]);
-    env[key] = [...directories, env[key] ?? ''].join(node_path_1.default.delimiter);
-    return env;
-}
+var dev_server_2 = require("../../core/dev-server");
+Object.defineProperty(exports, "formatStart", { enumerable: true, get: function () { return dev_server_2.formatStart; } });
+Object.defineProperty(exports, "isPortFree", { enumerable: true, get: function () { return dev_server_2.isPortFree; } });
+Object.defineProperty(exports, "pickPort", { enumerable: true, get: function () { return dev_server_2.pickPort; } });
 async function startWorktree(options, run = process_1.runCommand) {
     const root = node_path_1.default.resolve(options.path);
     if (!node_fs_1.default.existsSync(root))
         throw new Error(`Worktree not found: ${root}`);
     const config = (0, config_1.loadConfig)(root, node_path_1.default.resolve(options.project ?? '.'));
-    const dev = config.dev;
-    if (!dev)
+    if (!config.dev)
         throw new Error('Missing "dev" in .azcli/worktree.json.');
-    let pagePath = dev.readyPath;
-    if (options.page) {
-        if (!(options.page in dev.pages))
-            throw new Error(`Unknown page "${options.page}". Configured pages: ${Object.keys(dev.pages).join(', ') || 'none'}`);
-        pagePath = dev.pages[options.page];
-    }
-    if (!options.skipInstall) {
-        const install = config.install;
-        await run(install.command, install.args, { cwd: install.cwd ? (0, files_1.resolveInside)(root, install.cwd) : root, quiet: options.quiet });
-    }
-    const port = await pickPort(dev.defaultPort, options.port);
-    const cwd = dev.cwd ? (0, files_1.resolveInside)(root, dev.cwd) : root;
-    const launch = (0, process_1.resolveCommand)(dev.command, dev.args.map((arg) => arg.replaceAll('{port}', String(port))), cwd, launchEnvironment(root, cwd, dev, port));
-    const logDirectory = node_path_1.default.join(await (0, git_1.gitDir)(run, root), 'azcli');
-    node_fs_1.default.mkdirSync(logDirectory, { recursive: true });
-    const log = node_path_1.default.join(logDirectory, `dev-${port}.log`);
-    const report = (fields) => ({
-        url: `http://localhost:${port}${pagePath}`, port, log, ...fields,
-    });
-    const fd = node_fs_1.default.openSync(log, 'w');
-    let exit;
-    const child = (0, node_child_process_1.spawn)(launch.command, launch.args, {
-        cwd,
-        env: launchEnvironment(root, cwd, dev, port),
-        detached: true,
-        stdio: ['ignore', fd, fd],
-        windowsHide: true,
-    });
-    node_fs_1.default.closeSync(fd);
-    child.once('error', (error) => { exit = `could not start ${dev.command}: ${error.message}`; });
-    child.once('exit', (code, signal) => { exit = signal ? `terminated by ${signal}` : `exit code ${code}`; });
-    const readLog = () => node_fs_1.default.readFileSync(log, 'utf8');
-    const tail = () => readLog().split(/\r?\n/).filter(Boolean).slice(-20).join('\n');
-    const fail = (state, error) => {
-        if (state === 'timeout' && child.pid)
-            killTree(child.pid);
-        return report({ state, compile: compileState(readLog(), dev), pid: child.pid, error, logTail: tail() });
-    };
-    const timeoutMs = (options.timeout ?? dev.timeoutSeconds) * 1000;
-    const started = Date.now();
-    const readyUrl = `http://localhost:${port}${dev.readyPath}`;
-    if (!options.quiet)
-        (0, logger_1.showMessage)(`Waiting for ${readyUrl} (up to ${timeoutMs / 1000}s)`);
-    while (!exit) {
-        if (await probe(readyUrl))
-            break;
-        if (Date.now() - started > timeoutMs)
-            return fail('timeout', `no response from ${readyUrl} within ${timeoutMs / 1000}s`);
-        await sleep(pollMs);
-    }
-    if (exit)
-        return fail('exited', `dev server stopped: ${exit}`);
-    const graceEnd = Date.now() + compileGraceMs;
-    while (compileState(readLog(), dev) === 'unknown' && Date.now() < graceEnd && !exit)
-        await sleep(200);
-    if (exit)
-        return fail('exited', `dev server stopped: ${exit}`);
-    child.unref();
-    return report({ state: 'running', compile: compileState(readLog(), dev), pid: child.pid });
+    return (0, dev_server_1.startDevServer)({
+        ...options,
+        path: root,
+        logDirectory: async () => node_path_1.default.join(await (0, git_1.gitDir)(run, root), 'azcli'),
+    }, config, run);
 }
 exports.startWorktree = startWorktree;
-function formatStart(report) {
-    const output = [
-        `state:   ${report.state}${report.error ? ` (${report.error})` : ''}`,
-        `url:     ${report.url}`,
-        `pid:     ${report.pid ?? 'none'}`,
-        `compile: ${report.compile}`,
-        `log:     ${report.log}`,
-    ];
-    if (report.logTail)
-        output.push('last log lines:', report.logTail);
-    return output.join('\n');
-}
-exports.formatStart = formatStart;
 //# sourceMappingURL=start.js.map

package/dist/features/worktree/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/features/worktree/start.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/features/worktree/start.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAC7B,sDAA2F;AAC3F,gDAA+D;AAC/D,qCAAsC;AACtC,+BAA+B;AAE/B,oDAAuF;AAAjE,yGAAA,WAAW,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,sGAAA,QAAQ,OAAA;AAGhD,KAAK,UAAU,aAAa,CAAC,OAAqB,EAAE,MAAqB,oBAAU;IACzF,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAI,EAAE,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC3E,OAAO,IAAA,2BAAc,EAAC;QACrB,GAAG,OAAO;QACV,IAAI,EAAE,IAAI;QACV,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,mBAAI,CAAC,IAAI,CAAC,MAAM,IAAA,YAAM,EAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC;KACrE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AACjB,CAAC;AAVD,sCAUC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@azrico/azcli",
-	"version": "1.2.5",
+	"version": "1.2.7",
 	"description": "Project build, publishing, dependency, and AI transcript helpers",
 	"type": "commonjs",
 	"main": "dist/cli/index.js",
@@ -35,6 +35,10 @@
 		"yargs": "^17.5.1",
 		"zip-lib": "^0.7.3"
 	},
+	"optionalDependencies": {
+		"@cucumber/cucumber": "^12.9.0",
+		"@playwright/test": "^1.64.1"
+	},
 	"packageManager": "yarn@4.6.0",
 	"engines": {
 		"node": ">=20"

package/dist/features/yarn/commands.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.testCommand = exports.buildCommand = exports.installCommand = void 0;
-const process_1 = require("../../core/process");
-function yarnCommand(command, describe, args) {
-    return {
-        command,
-        describe,
-        builder: (cli) => cli.option('path', { type: 'string', describe: 'Project directory' }),
-        handler: async (options) => {
-            await (0, process_1.runCommand)('yarn', args, { cwd: options.path, quiet: options.quiet });
-        },
-    };
-}
-exports.installCommand = yarnCommand('yarni', 'Install Yarn dependencies', ['install']);
-exports.buildCommand = yarnCommand('yarnb', 'Run the Yarn build', ['run', 'build']);
-exports.testCommand = yarnCommand('yarnt', 'Run the Yarn tests', ['run', 'test']);
-//# sourceMappingURL=commands.js.map

package/dist/features/yarn/commands.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/features/yarn/commands.ts"],"names":[],"mappings":";;;AACA,gDAAgD;AAGhD,SAAS,WAAW,CAAC,OAAe,EAAE,QAAgB,EAAE,IAAc;IACrE,OAAO;QACN,OAAO;QACP,QAAQ;QACR,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;QACvF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1B,MAAM,IAAA,oBAAU,EAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7E,CAAC;KACD,CAAC;AACH,CAAC;AAEY,QAAA,cAAc,GAAG,WAAW,CAAC,OAAO,EAAE,2BAA2B,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAChF,QAAA,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,oBAAoB,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5E,QAAA,WAAW,GAAG,WAAW,CAAC,OAAO,EAAE,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC"}