@alwaysmeticulous/cli 2.331.3 → 2.332.0

package/dist/commands/onboard/validate-ci-yaml.js

@@ -0,0 +1,113 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4816c3ff-6f71-5b6b-9ef1-dfcb2f71135c")}catch(e){}}();
+
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.warnAboutInvalidCiYaml = exports.findInvalidCiYaml = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const chalk_1 = __importDefault(require("chalk"));
+const yaml_1 = require("yaml");
+const WORKFLOWS_DIR = (0, path_1.join)(".github", "workflows");
+const SINGLE_FILE_CANDIDATES = [
+    ".gitlab-ci.yml",
+    ".gitlab-ci.yaml",
+    "bitbucket-pipelines.yml",
+    "bitbucket-pipelines.yaml",
+];
+/**
+ * Parses the CI files that mention Meticulous and reports the ones a CI
+ * provider would reject. The install agent writes this YAML by hand, and a
+ * syntax slip there only shows up as a failed pipeline after the PR is open.
+ */
+const findInvalidCiYaml = (options) => {
+    const invalid = [];
+    for (const absolutePath of candidateCiFiles(options.projectRoot)) {
+        const contents = readMeticulousCiFile(absolutePath);
+        if (contents === null) {
+            continue;
+        }
+        const problem = firstParseError(contents);
+        if (problem !== null) {
+            invalid.push({
+                relativePath: (0, path_1.relative)(options.projectRoot, absolutePath),
+                problem,
+            });
+        }
+    }
+    return invalid;
+};
+exports.findInvalidCiYaml = findInvalidCiYaml;
+/**
+ * Prints a warning for CI files the agent left unparseable, so the user hears
+ * it here rather than from a red pipeline on the onboarding PR.
+ */
+const warnAboutInvalidCiYaml = (options) => {
+    const invalid = (0, exports.findInvalidCiYaml)(options);
+    if (invalid.length === 0) {
+        return;
+    }
+    console.log("");
+    console.log(chalk_1.default.yellow(invalid.length === 1
+        ? "A CI file mentioning Meticulous is not valid YAML:"
+        : "Some CI files mentioning Meticulous are not valid YAML:"));
+    for (const file of invalid) {
+        console.log(`  ${chalk_1.default.bold(file.relativePath)}: ${file.problem}`);
+    }
+    console.log(chalk_1.default.dim("  Fix these before merging — the pipeline will not run otherwise."));
+};
+exports.warnAboutInvalidCiYaml = warnAboutInvalidCiYaml;
+const candidateCiFiles = (projectRoot) => {
+    const files = SINGLE_FILE_CANDIDATES.map((name) => (0, path_1.join)(projectRoot, name));
+    const workflowsDir = (0, path_1.join)(projectRoot, WORKFLOWS_DIR);
+    let entries;
+    try {
+        entries = (0, fs_1.readdirSync)(workflowsDir);
+    }
+    catch {
+        return files;
+    }
+    for (const entry of entries) {
+        if (entry.endsWith(".yml") || entry.endsWith(".yaml")) {
+            files.push((0, path_1.join)(workflowsDir, entry));
+        }
+    }
+    return files;
+};
+/**
+ * Reads a candidate file, or returns null when it is missing, is not a regular
+ * file (we never follow links out of the repo), or has nothing to do with us.
+ */
+const readMeticulousCiFile = (absolutePath) => {
+    try {
+        if (!(0, fs_1.lstatSync)(absolutePath).isFile()) {
+            return null;
+        }
+        const contents = (0, fs_1.readFileSync)(absolutePath, "utf8");
+        return contents.toLowerCase().includes("meticulous") ? contents : null;
+    }
+    catch {
+        return null;
+    }
+};
+const firstParseError = (contents) => {
+    let errors;
+    try {
+        errors = (0, yaml_1.parseDocument)(contents).errors;
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+    const [first] = errors;
+    if (!first) {
+        return null;
+    }
+    // The parser's message already names the line and column, then quotes the
+    // offending source below it. Keep the sentence, drop the excerpt.
+    const [summary = first.message] = first.message.split("\n");
+    return summary.replace(/:$/, "");
+};
+//# sourceMappingURL=validate-ci-yaml.js.map
+//# debugId=4816c3ff-6f71-5b6b-9ef1-dfcb2f71135c

package/dist/commands/onboard/validate-ci-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-ci-yaml.js","sources":["../../../src/commands/onboard/validate-ci-yaml.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"4816c3ff-6f71-5b6b-9ef1-dfcb2f71135c"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwaysmeticulous/cli",
-  "version": "2.331.3",
+  "version": "2.332.0",
   "description": "The Meticulous CLI",
   "license": "ISC",
   "main": "dist/index.js",
@@ -23,20 +23,21 @@
     "parse-diff": "^0.11.1",
     "puppeteer-core": "24.42.0",
     "tar": "^7.5.22",
+    "yaml": "^2.9.0",
     "yargs": "^17.5.1",
-    "@alwaysmeticulous/client": "2.331.2",
-    "@alwaysmeticulous/api": "2.327.0",
-    "@alwaysmeticulous/common": "2.326.0",
-    "@alwaysmeticulous/debug-workspace": "2.331.2",
-    "@alwaysmeticulous/downloading-helpers": "2.331.2",
-    "@alwaysmeticulous/record": "2.327.0",
-    "@alwaysmeticulous/remote-replay-launcher": "2.331.2",
+    "@alwaysmeticulous/api": "2.332.0",
+    "@alwaysmeticulous/client": "2.332.0",
+    "@alwaysmeticulous/common": "2.332.0",
+    "@alwaysmeticulous/debug-workspace": "2.332.0",
+    "@alwaysmeticulous/downloading-helpers": "2.332.0",
+    "@alwaysmeticulous/record": "2.332.0",
+    "@alwaysmeticulous/remote-replay-launcher": "2.332.0",
     "@alwaysmeticulous/replay-debugger-ui": "2.283.1",
-    "@alwaysmeticulous/replay-orchestrator-launcher": "2.331.2",
-    "@alwaysmeticulous/sdk-bundles-api": "2.331.0",
-    "@alwaysmeticulous/sentry": "2.326.0",
-    "@alwaysmeticulous/session-filters": "2.327.0",
-    "@alwaysmeticulous/tunnels-client": "2.326.0"
+    "@alwaysmeticulous/replay-orchestrator-launcher": "2.332.0",
+    "@alwaysmeticulous/sdk-bundles-api": "2.332.0",
+    "@alwaysmeticulous/sentry": "2.332.0",
+    "@alwaysmeticulous/session-filters": "2.332.0",
+    "@alwaysmeticulous/tunnels-client": "2.332.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.5",

package/dist/commands/onboard/templates/agents/local-simulation-verification.md

@@ -1,96 +0,0 @@
----
-name: local-simulation-verification
-description: Produces local simulation testing instructions for the onboarding plan. Use after the reviewer has produced a codebase summary.
-tools: Read, Grep, Glob, Write
-model: sonnet
----
-
-You are a local simulation verification specialist for the Meticulous automated UI testing platform.
-
-Your job is to produce a self-contained "Verify Local Simulation" section that guides the
-customer through running their first local replay. Write the section to the output file path
-provided in the prompt.
-
-The reviewer's structured summary will be provided in the prompt that launches you.
-
-## Reference Docs
-
-Read the Meticulous doc source file in `.claude/docs/`:
-
-- `.claude/docs/how-to/troubleshoot-failed-simulations.ts` -- troubleshooting failed simulations
-
-## Background
-
-Local simulation is a critical verification step between installing the recorder and setting
-up CI. It confirms that:
-
-1. The recorder is installed correctly and sessions are being recorded.
-2. Sessions can be replayed against the customer's local dev/preview environment.
-3. Screenshots are captured correctly.
-
-The customer should not proceed to CI setup until local simulation works.
-
-## What to Investigate
-
-1. Read the reviewer's summary for the framework, package manager, and dev/start command.
-2. Check `package.json` scripts for:
-   - `dev` or `start` commands (for the dev server)
-   - `build` + `start` commands (for the production server)
-   - The port the app runs on (look for `PORT`, `-p`, `--port` in scripts)
-3. Check if the app requires environment variables to start (`.env.local`, `.env.example`).
-
-## What to Produce
-
-Write your markdown section to the output file path provided in the prompt. It should contain:
-
-````
-## Step <N>: Verify Local Simulation
-
-Local simulation replays a recorded session against your local development server. This
-verifies that the recorder is working and that sessions can be replayed successfully.
-
-### Prerequisites
-
-1. Start your development server:
-   ```bash
-   <dev command, e.g. npm run dev>
-   ```
-
-   Your app should be running at `http://localhost:<port>`.
-
-2. Record a session: Open your app in the browser, navigate through a few pages, and
-   interact with key features. After 30 seconds or so, check the [Meticulous dashboard
-   Sessions tab]({meticulousSessionsUrl}) to confirm the session was recorded. (Read the
-   `meticulousSessionsUrl` value from `.claude/onboard-context.json` and substitute it in.)
-
-3. Copy the session ID from the dashboard.
-
-### Run the Simulation
-
-```bash
-npx @alwaysmeticulous/cli simulate \
-  --sessionId "<SESSION_ID>" \
-  --appUrl "http://localhost:<port>"
-```
-
-### Success Criteria
-
-- The command completes without errors.
-- The simulation appears in the Meticulous dashboard.
-- Screenshots look correct (match what you see in the browser).
-
-### Troubleshooting
-
-<Common failure modes and how to fix them>
-````
-
-Guidelines:
-
-- Use the actual dev command and port from the customer's `package.json`.
-- If the app requires environment variables, note that they should be set before running.
-- Include common failure modes:
-  - **Auth redirects**: If the replay shows a login page, see the auth configuration step.
-  - **Blank page**: Use `--devTools` flag to open browser dev tools for debugging.
-  - **Network errors**: Check the Timeline tab in the Meticulous dashboard for failed requests.
-  - **Port conflicts**: Make sure the dev server is running and accessible.
-- Mention the `--devTools` and `--headful` flags for debugging.