@cleaver/breakcheck 0.2.4 → 0.3.0

package/dist/cli/commands/list-snapshots.js.map

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

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

@@ -0,0 +1,9 @@
+import { InteractiveCommand } from "interactive-commander";
+import { type RuleScaffoldOptions, type RuleScaffoldResult } from "../rules.js";
+export interface NewRuleOptions extends RuleScaffoldOptions {
+    jsonLogs?: boolean;
+    noJsonLogs?: boolean;
+}
+export declare function runNewRule(name: string, options?: NewRuleOptions, cwd?: string): Promise<RuleScaffoldResult>;
+export declare const ruleCommand: InteractiveCommand;
+export declare const newCommand: InteractiveCommand;

package/dist/cli/commands/new.js

@@ -0,0 +1,27 @@
+import { InteractiveCommand } from "interactive-commander";
+import { createRuleScaffold, } from "../rules.js";
+import { configureLogger } from "../utils.js";
+export async function runNewRule(name, options = {}, cwd = process.cwd()) {
+    return createRuleScaffold(name, options, cwd);
+}
+export const ruleCommand = new InteractiveCommand("rule")
+    .description("Create a new ruleset scaffold")
+    .argument("<name>", "Name of the new ruleset directory")
+    .option("-d, --directory <parent>", "Parent directory for the new ruleset (relative to the current directory)")
+    .option("--json-logs", "Output logs in JSON format")
+    .option("--no-json-logs", "Output logs in pretty format (default)")
+    .action(async (name, options) => {
+    const logger = configureLogger(options);
+    try {
+        const result = await runNewRule(name, options);
+        logger.info(`✅ Created rules file: ${result.filePath}`);
+        logger.info(`Next: breakcheck compare --rules ${result.directory}`);
+    }
+    catch (error) {
+        logger.error({ err: error }, "❌ Error creating rules file");
+        process.exit(1);
+    }
+});
+export const newCommand = new InteractiveCommand("new").description("Create project files");
+newCommand.addCommand(ruleCommand);
+//# sourceMappingURL=new.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../../src/cli/commands/new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,OAAO,GAAmB,EAAE,EAC5B,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE;IAE3B,OAAO,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC;KACtD,WAAW,CAAC,+BAA+B,CAAC;KAC5C,QAAQ,CAAC,QAAQ,EAAE,mCAAmC,CAAC;KACvD,MAAM,CACL,0BAA0B,EAC1B,0EAA0E,CAC3E;KACA,MAAM,CAAC,aAAa,EAAE,4BAA4B,CAAC;KACnD,MAAM,CAAC,gBAAgB,EAAE,wCAAwC,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAAuB,EAAE,EAAE;IACtD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,yBAAyB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,oCAAoC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,6BAA6B,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,WAAW,CACjE,sBAAsB,CACvB,CAAC;AAEF,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC"}

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

@@ -1,2 +1,22 @@
+import type { SnapshotConfig } from "@cleaver/breakcheck-core";
 import { InteractiveCommand } from "interactive-commander";
+export interface SnapshotCommandOptions {
+    url?: string;
+    name?: string;
+    depth?: string;
+    concurrency?: string;
+    include?: string[] | false;
+    exclude?: string[] | false;
+    noInclude?: boolean;
+    noExclude?: boolean;
+    type?: string;
+    writeUrls?: string;
+    urlFile?: string;
+    jsonLogs?: boolean;
+    noJsonLogs?: boolean;
+}
+export declare function buildSnapshotInvocation(options: SnapshotCommandOptions, args?: readonly string[], cwd?: string): Promise<{
+    config: SnapshotConfig;
+    storageDir: string;
+}>;
 export declare const snapshotCommand: InteractiveCommand;

package/dist/cli/commands/snapshot.js

@@ -1,43 +1,134 @@
 import { createSnapshotFromConfig } from "@cleaver/breakcheck-core";
 import { InteractiveCommand } from "interactive-commander";
+import path from "node:path";
+import { addConfigOptions, hasCliOption, resolveCliProjectConfig, } from "../config.js";
+import { parseUrlManifest, readUrlManifest } from "../url-manifest.js";
 import { configureLogger } from "../utils.js";
-export const snapshotCommand = new InteractiveCommand("snapshot")
+const DEFAULT_CRAWLER_TYPE = "cheerio";
+const DEFAULT_MAX_DEPTH = 3;
+const DEFAULT_MAX_CONCURRENCY = 5;
+function parseInteger(value, fallback, field, minimum) {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < minimum) {
+        throw new Error(`${field} must be an integer greater than or equal to ${minimum}.`);
+    }
+    return parsed;
+}
+function requireHttpUrl(value) {
+    if (value === undefined) {
+        throw new Error("A base URL is required. Provide --url <url> or set baseUrl in breakcheck.config.json.");
+    }
+    // Preserve the existing API-level failure response for an explicitly empty
+    // CLI value while still making an omitted URL actionable at the CLI layer.
+    if (value.trim().length === 0)
+        return value;
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch (error) {
+        throw new Error("Base URL must be a valid HTTP(S) URL.", { cause: error });
+    }
+    if ((parsed.protocol !== "http:" && parsed.protocol !== "https:") ||
+        !parsed.hostname) {
+        throw new Error("Base URL must be a valid HTTP(S) URL.");
+    }
+    return value;
+}
+function resolveCrawlerType(value, configured) {
+    const crawlerType = value ?? configured ?? DEFAULT_CRAWLER_TYPE;
+    if (crawlerType !== "cheerio" && crawlerType !== "playwright") {
+        throw new Error('Crawler type must be either "cheerio" or "playwright".');
+    }
+    return crawlerType;
+}
+export async function buildSnapshotInvocation(options, args = process.argv.slice(2), cwd = process.cwd()) {
+    const projectConfig = await resolveCliProjectConfig(args, cwd);
+    const crawl = projectConfig.crawl;
+    const baseUrl = requireHttpUrl(options.url ?? projectConfig.baseUrl);
+    const positiveInclude = Array.isArray(options.include);
+    const positiveExclude = Array.isArray(options.exclude);
+    const noInclude = options.noInclude === true || options.include === false;
+    const noExclude = options.noExclude === true || options.exclude === false;
+    if (noInclude && (positiveInclude || hasCliOption(args, "--include"))) {
+        throw new Error("--include and --no-include cannot be used together.");
+    }
+    if (noExclude && (positiveExclude || hasCliOption(args, "--exclude"))) {
+        throw new Error("--exclude and --no-exclude cannot be used together.");
+    }
+    const includePatterns = noInclude
+        ? []
+        : Array.isArray(options.include)
+            ? options.include
+            : crawl.includePatterns;
+    const excludePatterns = noExclude
+        ? []
+        : Array.isArray(options.exclude)
+            ? options.exclude
+            : crawl.excludePatterns;
+    if (options.urlFile !== undefined &&
+        ((includePatterns?.length ?? 0) > 0 || (excludePatterns?.length ?? 0) > 0)) {
+        throw new Error("--include and --exclude cannot be used with --url-file because the manifest is exact; configured URL filters are active. Use --no-include and --no-exclude to clear them.");
+    }
+    const urlPaths = options.urlFile === undefined
+        ? undefined
+        : parseUrlManifest(await readUrlManifest(options.urlFile === "-"
+            ? options.urlFile
+            : path.resolve(cwd, options.urlFile)), baseUrl, options.urlFile === "-"
+            ? "stdin"
+            : path.resolve(cwd, options.urlFile));
+    if (urlPaths?.issues.length) {
+        throw new Error(formatManifestIssues(urlPaths.issues));
+    }
+    const maxDepth = parseInteger(options.depth, crawl.maxDepth ?? DEFAULT_MAX_DEPTH, "Depth", 0);
+    const maxConcurrency = parseInteger(options.concurrency, crawl.maxConcurrency ?? DEFAULT_MAX_CONCURRENCY, "Concurrency", 1);
+    const config = {
+        baseUrl,
+        name: options.name ??
+            `snapshot_${new Date()
+                .toISOString()
+                .replace(/[:.]/g, "-")
+                .replace(/T/, "_")
+                .replace(/Z$/, "Z")}`,
+        crawlSettings: {
+            baseUrl,
+            crawlerType: resolveCrawlerType(options.type, crawl.crawlerType),
+            maxDepth,
+            maxConcurrency,
+            includePatterns,
+            excludePatterns,
+        },
+        urlPaths: urlPaths?.paths,
+        urlListPath: options.writeUrls === undefined
+            ? undefined
+            : path.resolve(cwd, options.writeUrls),
+    };
+    return { config, storageDir: projectConfig.storageDir };
+}
+export const snapshotCommand = addConfigOptions(new InteractiveCommand("snapshot")
     .description("Create a snapshot of a website")
-    .requiredOption("-u, --url <url>", "Base URL to crawl")
+    .option("-u, --url <url>", "Base URL to crawl")
     .option("-n, --name <name>", "Name for the snapshot")
-    .option("-d, --depth <number>", "Maximum crawl depth", "3")
-    .option("-c, --concurrency <number>", "Number of concurrent requests", "5")
+    .option("-d, --depth <number>", "Maximum crawl depth")
+    .option("-c, --concurrency <number>", "Number of concurrent requests")
     .option("-i, --include <patterns...>", "URL patterns to include")
     .option("-e, --exclude <patterns...>", "URL patterns to exclude")
-    .option("-t, --type <type>", "Crawler type (cheerio or playwright)", "cheerio")
+    .option("--no-include", "Clear configured include patterns")
+    .option("--no-exclude", "Clear configured exclude patterns")
+    .option("-t, --type <type>", "Crawler type (cheerio or playwright)")
     .option("-w, --write-urls <path>", "Generate a URL list file at the specified path")
+    .option("--url-file <path>", "Read an exact root-relative URL manifest from a file, or '-' for stdin")
     .option("--json-logs", "Output logs in JSON format")
     .option("--no-json-logs", "Output logs in pretty format (default)")
     .action(async (options) => {
     // Configure logger based on options
     const logger = configureLogger(options);
     try {
-        // Map CLI options to SnapshotConfig
-        const config = {
-            baseUrl: options.url,
-            name: options.name ||
-                `snapshot_${new Date()
-                    .toISOString()
-                    .replace(/[:.]/g, "-")
-                    .replace(/T/, "_")
-                    .replace(/Z$/, "Z")}`,
-            crawlSettings: {
-                baseUrl: options.url,
-                crawlerType: options.type,
-                maxDepth: parseInt(options.depth, 10),
-                maxConcurrency: parseInt(options.concurrency, 10),
-                includePatterns: options.include,
-                excludePatterns: options.exclude,
-            },
-            urlListPath: options.writeUrls,
-        };
+        const invocation = await buildSnapshotInvocation(options);
         // Call API to create snapshot
-        const result = await createSnapshotFromConfig(config);
+        const result = await createSnapshotFromConfig(invocation.config, { storageDir: invocation.storageDir });
         // Display results
         if (result.status === "success") {
             logger.info(`✅ Snapshot created successfully: ${result.snapshotId}`);
@@ -58,11 +149,22 @@ export const snapshotCommand = new InteractiveCommand("snapshot")
             result.errors.forEach((error) => {
                 logger.error(`  - ${error.message}`);
             });
+            process.exitCode = 1;
         }
     }
     catch (error) {
         logger.error({ err: error }, "❌ Error creating snapshot");
         process.exit(1);
     }
-});
+}));
+function formatManifestIssues(issues) {
+    return issues
+        .map((issue) => {
+        if (issue.type === "entry") {
+            return `${issue.source}:${issue.line}: ${issue.message} (${issue.value})`;
+        }
+        return `${issue.source}: ${issue.message}`;
+    })
+        .join("\n");
+}
 //# sourceMappingURL=snapshot.js.map

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

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

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

@@ -1,3 +1,3 @@
 import { InteractiveCommand } from "interactive-commander";
-export declare function startViewServerWithPortSelection(comparisonName: string, requestedPort: number | undefined): Promise<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>>;
+export declare function startViewServerWithPortSelection(comparisonName: string, requestedPort: number | undefined, storageDir?: string): Promise<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>>;
 export declare const viewCommand: InteractiveCommand;

package/dist/cli/commands/view.js

@@ -1,5 +1,6 @@
 import { startViewServer } from "@cleaver/breakcheck-core";
 import { InteractiveCommand } from "interactive-commander";
+import { addConfigOptions, resolveCliProjectConfig } from "../config.js";
 import { configureLogger } from "../utils.js";
 const DEFAULT_VIEW_PORT = 8080;
 const MAX_VIEW_PORT = 65534;
@@ -12,11 +13,13 @@ function isPortInUseError(error) {
     }
     return error.code === "EADDRINUSE";
 }
-export async function startViewServerWithPortSelection(comparisonName, requestedPort) {
+export async function startViewServerWithPortSelection(comparisonName, requestedPort, storageDir) {
     let port = requestedPort ?? DEFAULT_VIEW_PORT;
     while (port <= MAX_VIEW_PORT) {
         try {
-            return await startViewServer(comparisonName, port);
+            return storageDir === undefined
+                ? await startViewServer(comparisonName, port)
+                : await startViewServer(comparisonName, port, { storageDir });
         }
         catch (error) {
             if (requestedPort !== undefined || !isPortInUseError(error)) {
@@ -27,7 +30,7 @@ export async function startViewServerWithPortSelection(comparisonName, requested
     }
     throw new Error(`No available port found between ${DEFAULT_VIEW_PORT} and ${MAX_VIEW_PORT}.`);
 }
-export const viewCommand = new InteractiveCommand("view")
+export const viewCommand = addConfigOptions(new InteractiveCommand("view")
     .description("View the results of a comparison")
     .argument("[comparison-name]", "Name of the comparison to view", "compare_default")
     .option("-p, --port <number>", "Port to run the view server on (defaults to 8080 and increments when occupied)")
@@ -37,14 +40,17 @@ export const viewCommand = new InteractiveCommand("view")
     // Configure logger based on options
     const logger = configureLogger(options);
     try {
+        const projectConfig = await resolveCliProjectConfig();
         logger.info(`🔍 Viewing comparison: ${comparisonName}`);
         const requestedPort = options.port === undefined ? undefined : parseInt(options.port, 10);
         if (requestedPort !== undefined &&
-            (isNaN(requestedPort) || requestedPort < 1024 || requestedPort > 65535)) {
+            (isNaN(requestedPort) ||
+                requestedPort < 1024 ||
+                requestedPort > 65535)) {
             logger.error("Port must be a number between 1024 and 65535");
             process.exit(1);
         }
-        const server = await startViewServerWithPortSelection(comparisonName, requestedPort);
+        const server = await startViewServerWithPortSelection(comparisonName, requestedPort, projectConfig.storageDir);
         logger.info("Press Ctrl+C to stop the server");
         await new Promise((resolve) => {
             const shutdown = () => {
@@ -63,5 +69,5 @@ export const viewCommand = new InteractiveCommand("view")
         logger.error({ err: error }, "❌ Error starting view server");
         process.exit(1);
     }
-});
+}));
 //# sourceMappingURL=view.js.map

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

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

package/dist/cli/config.d.ts

@@ -0,0 +1,14 @@
+import { type ProjectCrawlConfig, type ResolvedProjectConfig } from "@cleaver/breakcheck-core";
+import type { InteractiveCommand } from "interactive-commander";
+export interface ConfigSelection {
+    configPath?: string;
+    noConfig?: boolean;
+}
+export declare function hasCliFlag(args: readonly string[], flag: string): boolean;
+export declare function hasCliOption(args: readonly string[], option: string): boolean;
+/** Adds configuration-selection flags to a CLI command. */
+export declare function addConfigOptions<T extends InteractiveCommand>(command: T): T;
+/** Reads shared config flags regardless of whether they precede or follow a command. */
+export declare function parseConfigSelection(args?: readonly string[]): ConfigSelection;
+export declare function resolveCliProjectConfig(args?: readonly string[], cwd?: string): Promise<ResolvedProjectConfig>;
+export declare function mergeCrawlConfig(config: ResolvedProjectConfig, overrides: Partial<ProjectCrawlConfig>): ProjectCrawlConfig;

package/dist/cli/config.js

@@ -0,0 +1,58 @@
+import { resolveProjectConfig, } from "@cleaver/breakcheck-core";
+export function hasCliFlag(args, flag) {
+    return args.some((argument) => argument === flag);
+}
+export function hasCliOption(args, option) {
+    return args.some((argument) => argument === option || argument.startsWith(`${option}=`));
+}
+/** Adds configuration-selection flags to a CLI command. */
+export function addConfigOptions(command) {
+    command
+        .option("--config <file>", "Use this configuration file instead of discovering one")
+        .option("--no-config", "Disable project configuration discovery");
+    return command;
+}
+/** Reads shared config flags regardless of whether they precede or follow a command. */
+export function parseConfigSelection(args = process.argv.slice(2)) {
+    let configPath;
+    let noConfig = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === "--no-config") {
+            noConfig = true;
+            continue;
+        }
+        if (argument === "--config") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("-")) {
+                throw new Error("--config requires a file path.");
+            }
+            configPath = value;
+            index += 1;
+            continue;
+        }
+        if (argument.startsWith("--config=")) {
+            const value = argument.slice("--config=".length);
+            if (value.length === 0)
+                throw new Error("--config requires a file path.");
+            configPath = value;
+        }
+    }
+    if (configPath !== undefined && noConfig) {
+        throw new Error("--config and --no-config cannot be used together.");
+    }
+    return {
+        ...(configPath === undefined ? {} : { configPath }),
+        ...(noConfig ? { noConfig: true } : {}),
+    };
+}
+export async function resolveCliProjectConfig(args = process.argv.slice(2), cwd = process.cwd()) {
+    return resolveProjectConfig({ ...parseConfigSelection(args), cwd });
+}
+export function mergeCrawlConfig(config, overrides) {
+    return {
+        ...config.crawl,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAGrB,MAAM,0BAA0B,CAAC;AAQlC,MAAM,UAAU,UAAU,CAAC,IAAuB,EAAE,IAAY;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAuB,EAAE,MAAc;IAClE,OAAO,IAAI,CAAC,IAAI,CACd,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CACvE,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB,CAA+B,OAAU;IACvE,OAAO;SACJ,MAAM,CACL,iBAAiB,EACjB,wDAAwD,CACzD;SACA,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC,CAAC;IACpE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAClC,IAAI,GAAsB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE/C,IAAI,UAA8B,CAAC;IACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC/B,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,UAAU,GAAG,KAAK,CAAC;YACnB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC1E,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,IAAI,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;QACnD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAI,GAAsB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAC/C,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE;IAE3B,OAAO,oBAAoB,CAAC,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAA6B,EAC7B,SAAsC;IAEtC,OAAO;QACL,GAAG,MAAM,CAAC,KAAK;QACf,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/cli/rules.d.ts

@@ -0,0 +1,12 @@
+export declare const RULES_FILE_NAME = "rules.breakcheck";
+export interface RuleScaffoldOptions {
+    directory?: string;
+}
+export interface RuleScaffoldResult {
+    name: string;
+    directory: string;
+    filePath: string;
+}
+export declare function validateRuleName(name: string): string;
+export declare function renderRuleScaffold(name: string): string;
+export declare function createRuleScaffold(name: string, options?: RuleScaffoldOptions, cwd?: string): Promise<RuleScaffoldResult>;

package/dist/cli/rules.js

@@ -0,0 +1,110 @@
+import { lstat, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+export const RULES_FILE_NAME = "rules.breakcheck";
+const RULE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+function isNodeError(error) {
+    return (error instanceof Error && "code" in error && typeof error.code === "string");
+}
+function isWithinDirectory(root, candidate) {
+    const relative = path.relative(root, candidate);
+    return (relative === "" ||
+        (!relative.startsWith(`..${path.sep}`) &&
+            relative !== ".." &&
+            !path.isAbsolute(relative)));
+}
+async function assertDirectory(directory) {
+    const stats = await lstat(directory);
+    if (stats.isSymbolicLink()) {
+        throw new Error(`Cannot use symlinked rules directory: ${directory}`);
+    }
+    if (!stats.isDirectory()) {
+        throw new Error(`Rules destination is not a directory: ${directory}`);
+    }
+}
+async function ensureDirectoryTree(rootDirectory, destination) {
+    await assertDirectory(rootDirectory);
+    let current = rootDirectory;
+    const relative = path.relative(rootDirectory, destination);
+    for (const segment of relative.split(path.sep).filter(Boolean)) {
+        current = path.join(current, segment);
+        try {
+            await assertDirectory(current);
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "ENOENT")
+                throw error;
+            try {
+                await mkdir(current);
+            }
+            catch (mkdirError) {
+                if (!isNodeError(mkdirError) || mkdirError.code !== "EEXIST")
+                    throw mkdirError;
+                await assertDirectory(current);
+            }
+        }
+    }
+}
+function resolveParentDirectory(cwd, directory) {
+    const absoluteCwd = path.resolve(cwd);
+    if (directory !== undefined) {
+        if (directory.trim().length === 0) {
+            throw new Error("--directory must not be empty.");
+        }
+        if (path.isAbsolute(directory)) {
+            throw new Error("--directory must be relative to the current directory.");
+        }
+    }
+    const parent = path.resolve(absoluteCwd, directory ?? ".");
+    if (!isWithinDirectory(absoluteCwd, parent)) {
+        throw new Error("--directory must resolve inside the current working directory.");
+    }
+    return { cwd: absoluteCwd, parent };
+}
+export function validateRuleName(name) {
+    if (typeof name !== "string" || !RULE_NAME_PATTERN.test(name)) {
+        throw new Error("Rule name must be a single path-safe segment containing only letters, numbers, '.', '_' or '-'.");
+    }
+    return name;
+}
+export function renderRuleScaffold(name) {
+    return `-- Breakcheck Rules File
+-- Ruleset: ${name}
+--
+-- Add active rules below. Examples:
+-- css:.ad-container do: exclude
+-- css:[data-dynamic] do: remove_attr attr:"data-id"
+-- css:.timestamp do: rewrite_content regex:"\\d+" replace:"STATIC"
+`;
+}
+export async function createRuleScaffold(name, options = {}, cwd = process.cwd()) {
+    const validName = validateRuleName(name);
+    const resolved = resolveParentDirectory(cwd, options.directory);
+    const parentDirectory = resolved.parent;
+    const directory = path.join(parentDirectory, validName);
+    const filePath = path.join(directory, RULES_FILE_NAME);
+    await ensureDirectoryTree(resolved.cwd, directory);
+    try {
+        await lstat(filePath);
+        throw new Error(`Rules file already exists: ${filePath}`);
+    }
+    catch (error) {
+        if (!isNodeError(error) || error.code !== "ENOENT")
+            throw error;
+    }
+    try {
+        await writeFile(filePath, renderRuleScaffold(validName), {
+            encoding: "utf8",
+            flag: "wx",
+        });
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "EEXIST") {
+            throw new Error(`Rules file already exists: ${filePath}`, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+    return { name: validName, directory, filePath };
+}
+//# sourceMappingURL=rules.js.map

package/dist/cli/rules.js.map

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

package/dist/cli/site-environment.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedProjectCheckConfig } from "@cleaver/breakcheck-core";
+interface SignalEventSource {
+    on(signal: "SIGINT" | "SIGTERM", listener: () => void): unknown;
+    removeListener(signal: "SIGINT" | "SIGTERM", listener: () => void): unknown;
+}
+/** Runs configured preparation and server commands around a site operation. */
+export declare function withCheckEnvironment<T>(check: ResolvedProjectCheckConfig, baseUrl: string, useExistingServer: boolean, operation: (signal: AbortSignal) => Promise<T>, options?: {
+    signal?: AbortSignal;
+    signals?: SignalEventSource;
+    stopGracePeriodMs?: number;
+}): Promise<T>;
+export {};