@cleaver/breakcheck 0.2.5 → 0.3.0

package/README.md

@@ -116,6 +116,47 @@ css:.view-count do: rewrite_content regex:"\d{1,3}(,\d{3})* views" replace:"VIEW
 
 ## Command Reference
 
+### `init`
+
+Creates a version-1 `breakcheck.config.json` without overwriting an existing
+file. URL and rules are optional; `--interactive` prompts for omitted values
+when a terminal is available.
+
+```bash
+breakcheck init [--url <url>] [--storage-dir <directory>] [--rules <directory>]
+breakcheck init --interactive
+```
+
+### `new rule`
+
+Creates a new named ruleset directory containing a comments-only
+`rules.breakcheck` scaffold. The name must be a single path-safe segment, and
+an existing rules file is never overwritten.
+
+```bash
+breakcheck new rule my-rules
+breakcheck new rule dynamic --directory rules
+```
+
+The first command creates `./my-rules/rules.breakcheck`; the second creates
+`./rules/dynamic/rules.breakcheck`. Add active DSL rules to the file, then pass
+the generated directory to `compare --rules` or set it as `comparison.rulesDir`
+in project configuration.
+
+### `compile`
+
+Compiles a rules directory's `rules.breakcheck` DSL into the intermediate JSON
+format. JSON is written to stdout for inspection or shell redirection.
+
+```bash
+breakcheck compile ./my-rules
+breakcheck compile ./my-rules > rules.json
+```
+
+Relative directories resolve from the directory where Breakcheck is invoked.
+Selectors, regular expressions, modifiers, and named regions are validated
+before JSON is emitted.
+
 ### `snapshot`
 
 Crawls a website and saves its HTML content and structure to a named snapshot.
@@ -126,17 +167,21 @@ breakcheck snapshot [options]
 
 | Option                        | Description                                                           | Default                         |
 | :---------------------------- | :-------------------------------------------------------------------- | :------------------------------ |
-| `-u, --url <url>`             | **(Required)** The base URL to start crawling from.                   |                                 |
+| `-u, --url <url>`             | Base URL to start crawling from; may come from project config.        |                                 |
 | `-n, --name <name>`           | A unique name for the snapshot.                                       | `snapshot_YYYY-MM-DD_HH-mm-ssZ` |
 | `-d, --depth <number>`        | Maximum crawl depth.                                                  | `3`                             |
 | `-c, --concurrency <number>`  | Number of concurrent requests to make.                                | `5`                             |
 | `-i, --include <patterns...>` | Glob patterns for URLs to include.                                    |                                 |
 | `-e, --exclude <patterns...>` | Glob patterns for URLs to exclude.                                    |                                 |
+| `--no-include`                | Clear configured include patterns.                                    |                                 |
+| `--no-exclude`                | Clear configured exclude patterns.                                    |                                 |
 | `-t, --type <type>`           | The crawler to use (`cheerio` or `playwright`).                       | `cheerio`                       |
 | `--url-file <path>`           | Crawl exactly the root-relative paths in a file, or `-` for stdin.    |                                 |
 | `-w, --write-urls <path>`     | Generate a plain text file of all crawled URLs at the specified path. |                                 |
 | `--json-logs`                 | Output logs in JSON format (useful for automation).                   |                                 |
 | `--no-json-logs`              | Output logs in pretty format (default, user-friendly).                |                                 |
+| `--config <file>`             | Select a project configuration file.                                  | Nearest discovered file         |
+| `--no-config`                 | Disable project configuration discovery.                              |                                 |
 
 #### Exact URL manifests
 
@@ -177,8 +222,94 @@ breakcheck compare [options]
 | `-a, --after <name>`      | **(Required)** The name of the "after" snapshot.                                                                |                              |
 | `-o, --output <name>`     | A name for the comparison output directory.                                                                     | `compare_default`            |
 | `-r, --rules <directory>` | Directory containing `rules.breakcheck`; relative paths resolve from the directory where Breakcheck is invoked. | None (unfiltered comparison) |
+| `--no-rules`              | Clear a configured rules directory.                                                                             |                              |
 | `--json-logs`             | Output logs in JSON format (useful for automation).                                                             |                              |
 | `--no-json-logs`          | Output logs in pretty format (default, user-friendly).                                                          |                              |
+| `--config <file>`         | Select a project configuration file.                                                                            |                              |
+| `--no-config`             | Disable project configuration discovery.                                                                        |                              |
+
+Snapshot commands exit with status `1` when snapshot creation fails.
+Comparison commands exit with status `1` when the comparison fails or finds
+differences (`overallResult: "fail"`), which lets CI jobs stop on regressions.
+
+### `check`
+
+Runs a local site regression check using the version-2 `check` section in
+`breakcheck.config.json`. It optionally runs `check.prepare`, starts the
+configured server, waits for `baseUrl` plus `readyPath`, snapshots only the
+exact routes in `check.routesFile`, compares them to `check.baselineSnapshot`
+using `comparison.rulesDir`, saves a report, and shuts down the managed server.
+
+```bash
+breakcheck check
+breakcheck check --url http://127.0.0.1:4000
+breakcheck check --json
+```
+
+`--url` uses an already-running server and skips preparation and lifecycle
+commands. Configure foreground server commands such as `mix phx.server` with a
+`start` array; Breakcheck stops the process group on completion. For a daemon
+or environment manager, configure a paired `stop` command, such as
+`["ddev", "stop"]`. Commands run without a shell, from `server.cwd`, and
+inherit the current environment plus any `server.env` entries. Keep stop
+commands scoped to environments owned by the check.
+
+`--json` writes one JSON result to stdout for CI and agent integrations; build,
+server, and crawler output goes to stderr. Reports are written under
+`check.reportDir`, which defaults to `<storageDir>/reports`. Comparison details
+are also saved under `<storageDir>/comparisons`.
+
+Exit codes are `0` for no differences, `1` for page or route differences, and
+`2` for setup, readiness, crawl, or comparison failures.
+
+For a task-focused guide to using Breakcheck as feedback during coding-agent
+work, see [Agent guide](agent-guide.md).
+
+### `baseline update`
+
+Updates the configured baseline explicitly. `--route` replaces only the
+selected routes and preserves every other route in the baseline snapshot.
+`--all` replaces the routes listed in `check.routesFile`.
+
+```bash
+breakcheck baseline update --route /about /contact
+breakcheck baseline update --all
+breakcheck baseline update --route /about --url http://127.0.0.1:4000
+```
+
+The update is staged and committed only after all selected routes crawl
+successfully. A regular `check` never writes to the baseline.
+
+### `clean`
+
+Deletes stored snapshots or comparisons. Deletion is confirmed interactively
+unless `--force` is supplied.
+
+```
+breakcheck clean snapshot [options]
+breakcheck clean comparison [options]
+```
+
+| Option            | Description                                                          |
+| :---------------- | :------------------------------------------------------------------- |
+| `--name <name>`   | Delete one named snapshot or comparison.                             |
+| `--all`           | Delete all stored artifacts of the selected type.                    |
+| `--force`         | Skip confirmation; required when running without an interactive TTY. |
+| `--json-logs`     | Output logs in JSON format.                                          |
+| `--no-json-logs`  | Output logs in pretty format (default).                              |
+| `--config <file>` | Select a project configuration file.                                 |
+| `--no-config`     | Disable project configuration discovery.                             |
+
+`--name` and `--all` cannot be combined. If neither is provided in a terminal,
+Breakcheck prompts for a name. Snapshot cleanup never deletes comparisons.
+
+Examples:
+
+```bash
+breakcheck clean snapshot --name before
+breakcheck clean comparison --name filtered --force
+breakcheck clean snapshot --all --force
+```
 
 ### `view`
 
@@ -197,6 +328,8 @@ breakcheck view [comparison-name] [options]
 | `-p, --port <number>` | The port to run the view server on. When omitted, starts at 8080 and uses the next available port. | `8080` (next available) |
 | `--json-logs`         | Output logs in JSON format (useful for automation).                                                |                         |
 | `--no-json-logs`      | Output logs in pretty format (default, user-friendly).                                             |                         |
+| `--config <file>`     | Select a project configuration file.                                                               |                         |
+| `--no-config`         | Disable project configuration discovery.                                                           |                         |
 
 ### `list-snapshots`
 
@@ -208,6 +341,9 @@ Lists all snapshots that have been saved locally.
 breakcheck list-snapshots
 ```
 
+`list-snapshots` uses the discovered artifact store. Pass `--config <file>` or
+`--no-config` to select or disable configuration explicitly.
+
 The command outputs a table of available snapshots:
 
 ```

package/agent-guide.md

@@ -0,0 +1,107 @@
+# Using Breakcheck with coding agents
+
+This guide describes a small feedback loop for coding agents working on a
+website that has a Breakcheck baseline. It is reference material: load it when
+a task changes user-visible website behavior, routes, content, or layout rather
+than adding the whole guide to every agent session.
+
+## What the check does
+
+`breakcheck check` prepares and starts the configured local site when needed,
+crawls the exact routes in `check.routesFile`, compares them with the named
+`check.baselineSnapshot`, saves a report, and stops the managed server. A
+configured `comparison.rulesDir` can normalize known dynamic content. The
+regular check never modifies the baseline.
+
+## Consumer project setup
+
+Install Breakcheck as a development dependency:
+
+```bash
+npm install --save-dev @cleaver/breakcheck
+```
+
+Add a project script so the agent and developer use the same command:
+
+```json
+{
+  "scripts": {
+    "breakcheck:check": "breakcheck check --json"
+  }
+}
+```
+
+Configure a version-2 `breakcheck.config.json` with a `baseUrl`, `storageDir`,
+and `check` section. The check section names an exact route manifest and a
+baseline snapshot:
+
+```json
+{
+  "version": 2,
+  "baseUrl": "http://127.0.0.1:3000",
+  "storageDir": ".breakcheck",
+  "check": {
+    "routesFile": "./breakcheck-routes.txt",
+    "baselineSnapshot": "site-baseline"
+  }
+}
+```
+
+Add server `prepare` and `server.start` settings when Breakcheck should start
+the site itself. If the site is already running, pass `--url` to skip those
+lifecycle commands. Review configured commands before running the check; they
+execute with the project's environment.
+
+Create the initial named baseline from an approved, known-good site state, then
+commit that snapshot with the project. Keep generated check snapshots,
+comparisons, and reports out of version control while retaining the named
+baseline.
+
+For example, with the local site already running:
+
+```bash
+breakcheck snapshot \
+  --url http://127.0.0.1:3000 \
+  --url-file ./breakcheck-routes.txt \
+  --name site-baseline
+```
+
+## Minimal project instructions
+
+Keep the consumer repository's `AGENTS.md` focused on local decisions. For
+example:
+
+```markdown
+For changes to user-visible website behavior, run `npm run breakcheck:check`.
+Inspect the JSON report and comparison details when differences are found.
+Do not update the committed baseline or rules just to silence a difference;
+confirm that the change is expected before recording it.
+```
+
+The project's own instructions should identify its server start command, route
+manifest, and any task-specific acceptance criteria. Those details vary by
+consumer and should not be guessed from this package guide.
+
+## Agent feedback loop
+
+1. Read the task's expected behavior and identify which configured routes cover
+   it. The check only visits routes listed in `check.routesFile`.
+2. Make the code change and run the project's ordinary build and tests.
+3. Run `npm run breakcheck:check`. The command writes one JSON object to stdout;
+   build, server, and crawler output is written to stderr.
+4. Interpret the result:
+   - `status: "passed"` and exit code `0`: no route or page differences were
+     found.
+   - `status: "differences"` and exit code `1`: inspect `comparison` and its
+     `resultsPath`, then decide whether each difference matches the task.
+   - `status: "failed"` and exit code `2`: the check did not complete
+     successfully. Fix the setup or execution problem; do not report this as a
+     passing check.
+5. If a difference is expected, describe it in the task result. Update only the
+   accepted routes with `breakcheck baseline update --route <path> --json`,
+   then rerun the check. Use `--all` only when every configured route is meant
+   to change.
+
+Do not use a baseline update or a new ignore rule to make an unexplained
+difference disappear. If the expected result is unclear, report the difference
+and ask before changing the committed baseline.

package/dist/cli/commands/baseline.d.ts

@@ -0,0 +1,19 @@
+import { InteractiveCommand } from "interactive-commander";
+interface BaselineUpdateOptions {
+    all?: boolean;
+    route?: string[];
+    url?: string;
+    json?: boolean;
+    jsonLogs?: boolean;
+    noJsonLogs?: boolean;
+}
+export interface BaselineUpdateReport {
+    status: "updated" | "failed";
+    baselineSnapshotId?: string;
+    updatedRoutes: string[];
+    errors: string[];
+}
+export declare function executeBaselineUpdate(options: BaselineUpdateOptions, args?: readonly string[], cwd?: string): Promise<BaselineUpdateReport>;
+export declare const baselineUpdateCommand: InteractiveCommand;
+export declare const baselineCommand: InteractiveCommand;
+export {};

package/dist/cli/commands/baseline.js

@@ -0,0 +1,133 @@
+import { resolveUrlPaths, updateSnapshotRoutesFromConfig, } from "@cleaver/breakcheck-core";
+import { randomUUID } from "node:crypto";
+import { InteractiveCommand } from "interactive-commander";
+import { addConfigOptions, resolveCliProjectConfig } from "../config.js";
+import { parseUrlManifest, readUrlManifest } from "../url-manifest.js";
+import { withCheckEnvironment } from "../site-environment.js";
+import { configureLogger } from "../utils.js";
+function messageOf(error) {
+    if (error instanceof AggregateError) {
+        return [...error.errors].map(messageOf).join("; ");
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+function requireHttpUrl(value) {
+    if (value === undefined || value.trim().length === 0) {
+        throw new Error("A site URL is required. Set baseUrl in breakcheck.config.json or pass --url.");
+    }
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch (error) {
+        throw new Error("The site URL must be a valid HTTP(S) URL.", {
+            cause: error,
+        });
+    }
+    if ((parsed.protocol !== "http:" && parsed.protocol !== "https:") ||
+        !parsed.hostname) {
+        throw new Error("The site URL must be a valid HTTP(S) URL.");
+    }
+    return value;
+}
+async function readConfiguredRoutes(routesFile, baseUrl) {
+    const content = await readUrlManifest(routesFile);
+    const manifest = parseUrlManifest(content, baseUrl, routesFile);
+    if (manifest.issues.length > 0) {
+        throw new Error(manifest.issues
+            .map((issue) => issue.type === "entry"
+            ? `${issue.source}:${issue.line}: ${issue.message} (${issue.value})`
+            : `${issue.source}: ${issue.message}`)
+            .join("\n"));
+    }
+    return manifest.paths;
+}
+export async function executeBaselineUpdate(options, args = process.argv.slice(2), cwd = process.cwd()) {
+    const logger = configureLogger({
+        jsonLogs: options.jsonLogs,
+        noJsonLogs: options.noJsonLogs,
+        silent: options.json,
+    });
+    const result = {
+        status: "failed",
+        updatedRoutes: [],
+        errors: [],
+    };
+    try {
+        if (options.all && options.route !== undefined) {
+            throw new Error("Use either --all or --route, not both.");
+        }
+        if (!options.all &&
+            (options.route === undefined || options.route.length === 0)) {
+            throw new Error("Provide --route <path...> or --all.");
+        }
+        const project = await resolveCliProjectConfig(args, cwd);
+        const check = project.check;
+        if (!check) {
+            throw new Error("No check settings found. Add a version-2 check section to breakcheck.config.json.");
+        }
+        const baseUrl = requireHttpUrl(options.url ?? project.baseUrl);
+        let routes;
+        if (options.all) {
+            routes = await readConfiguredRoutes(check.routesFile, baseUrl);
+        }
+        else {
+            const resolution = resolveUrlPaths(baseUrl, options.route ?? []);
+            if (resolution.issues.length > 0) {
+                throw new Error(resolution.issues.map((issue) => issue.message).join("; "));
+            }
+            routes = resolution.paths;
+        }
+        const baselineSnapshotId = check.baselineSnapshot;
+        result.baselineSnapshotId = baselineSnapshotId;
+        const crawlSettings = {
+            baseUrl,
+            crawlerType: project.crawl.crawlerType ?? "cheerio",
+            maxDepth: project.crawl.maxDepth ?? 3,
+            maxConcurrency: project.crawl.maxConcurrency ?? 5,
+            includePatterns: [],
+            excludePatterns: [],
+        };
+        const snapshotConfig = {
+            baseUrl,
+            name: `baseline_update_${randomUUID().slice(0, 12)}`,
+            urlPaths: routes,
+            crawlSettings,
+        };
+        const update = await withCheckEnvironment(check, baseUrl, options.url !== undefined, (signal) => updateSnapshotRoutesFromConfig(snapshotConfig, baselineSnapshotId, {
+            storageDir: project.storageDir,
+            signal,
+        }));
+        result.status = "updated";
+        result.updatedRoutes = update.updatedRoutes;
+    }
+    catch (error) {
+        result.errors.push(messageOf(error));
+    }
+    if (options.json) {
+        process.stdout.write(`${JSON.stringify(result)}\n`);
+    }
+    else if (result.status === "updated") {
+        logger.info(`✅ Updated ${result.updatedRoutes.length} route(s) in baseline "${result.baselineSnapshotId}": ${result.updatedRoutes.join(", ")}`);
+    }
+    else {
+        logger.error("❌ Baseline update failed.");
+        result.errors.forEach((message) => logger.error(`  - ${message}`));
+    }
+    process.exitCode = result.status === "updated" ? 0 : 2;
+    return result;
+}
+export const baselineUpdateCommand = addConfigOptions(new InteractiveCommand("update")
+    .description("Update selected routes in the configured baseline snapshot")
+    .option("--route <path...>", "Update only these root-relative routes")
+    .option("--all", "Update every route in check.routesFile")
+    .option("-u, --url <url>", "Use an already-running site URL")
+    .option("--json", "Write a machine-readable result to stdout")
+    .option("--json-logs", "Output logs in JSON format")
+    .option("--no-json-logs", "Output logs in pretty format (default)")
+    .action(async (options) => {
+    await executeBaselineUpdate(options);
+}));
+export const baselineCommand = addConfigOptions(new InteractiveCommand("baseline").description("Manage the checked-in route baseline"));
+baselineCommand.addCommand(baselineUpdateCommand);
+//# sourceMappingURL=baseline.js.map

package/dist/cli/commands/baseline.js.map

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

package/dist/cli/commands/check.d.ts

@@ -0,0 +1,27 @@
+import { type CrawlError, type SiteCheckResult } from "@cleaver/breakcheck-core";
+import { InteractiveCommand } from "interactive-commander";
+interface CheckCommandOptions {
+    url?: string;
+    json?: boolean;
+    jsonLogs?: boolean;
+    noJsonLogs?: boolean;
+}
+export interface CheckReport {
+    schemaVersion: 1;
+    runId: string;
+    status: "passed" | "differences" | "failed";
+    exitCode: 0 | 1 | 2;
+    startedAt: string;
+    completedAt: string;
+    reportPath?: string;
+    baseUrl?: string;
+    baselineSnapshotId?: string;
+    snapshotId?: string;
+    routes: string[];
+    crawlErrors: CrawlError[];
+    errors: string[];
+    comparison?: SiteCheckResult["comparison"];
+}
+export declare function executeCheck(options: CheckCommandOptions, args?: readonly string[], cwd?: string): Promise<CheckReport>;
+export declare const checkCommand: InteractiveCommand;
+export {};