@mozole/cli 1.0.0

package/dist/commands/stats.js.map

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

package/dist/commands/verify.d.ts

@@ -0,0 +1,5 @@
+import type { Output } from "../output.js";
+export declare function verifyCommand(cwd: string, output?: Output, options?: {
+    force?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/commands/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAgB,EACxB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,MAAM,CAAC,CAgDjB"}

package/dist/commands/verify.js

@@ -0,0 +1,53 @@
+import { findProjectRoot, readConfig } from "../config/project.js";
+import { projectFingerprint } from "../governor/fingerprint.js";
+import { readGovernorState, writeGovernorState } from "../governor/state.js";
+import { updateTelemetry } from "../telemetry/store.js";
+import { runVerification } from "../verify/runner.js";
+export async function verifyCommand(cwd, output = console, options = {}) {
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    process.once("SIGINT", abort);
+    process.once("SIGTERM", abort);
+    try {
+        const root = await findProjectRoot(cwd);
+        const config = await readConfig(root);
+        const fingerprint = await projectFingerprint(root, config, "verification");
+        const state = await readGovernorState(root);
+        if (config.governor.enabled &&
+            !options.force &&
+            state.verification?.fingerprint === fingerprint) {
+            const message = "VERIFY CURRENT\n\nNo relevant changes since the last successful verification.";
+            output.log(message);
+            if (config.telemetry.enabled)
+                await updateTelemetry(root, (telemetry) => {
+                    telemetry.verification.avoidedRuns++;
+                    telemetry.governor.modelFacingDiagnosticChars += message.length;
+                });
+            return 0;
+        }
+        const result = await runVerification(root, config, controller.signal);
+        (result.passed ? output.log : output.error)(result.output);
+        if (result.passed) {
+            state.verification = {
+                fingerprint: await projectFingerprint(root, config, "verification"),
+                passedAt: new Date().toISOString(),
+                checks: result.results.map((check) => check.name),
+            };
+            await writeGovernorState(root, state);
+        }
+        else if (state.verification?.fingerprint === fingerprint) {
+            delete state.verification;
+            await writeGovernorState(root, state);
+        }
+        return result.passed ? 0 : 1;
+    }
+    catch (error) {
+        output.error(`VERIFY FAIL\n\n${error instanceof Error ? error.message : String(error)}`);
+        return controller.signal.aborted ? 130 : 2;
+    }
+    finally {
+        process.removeListener("SIGINT", abort);
+        process.removeListener("SIGTERM", abort);
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/commands/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,MAAM,GAAW,OAAO,EACxB,OAAO,GAAwB,EAAE;IAEjC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5C,IACE,MAAM,CAAC,QAAQ,CAAC,OAAO;YACvB,CAAC,OAAO,CAAC,KAAK;YACd,KAAK,CAAC,YAAY,EAAE,WAAW,KAAK,WAAW,EAC/C,CAAC;YACD,MAAM,OAAO,GACX,+EAA+E,CAAC;YAClF,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpB,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO;gBAC1B,MAAM,eAAe,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE;oBACxC,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;oBACrC,SAAS,CAAC,QAAQ,CAAC,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;gBAClE,CAAC,CAAC,CAAC;YACL,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACtE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,YAAY,GAAG;gBACnB,WAAW,EAAE,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC;gBACnE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAClD,CAAC;YACF,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,KAAK,CAAC,YAAY,EAAE,WAAW,KAAK,WAAW,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC,YAAY,CAAC;YAC1B,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CACV,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3E,CAAC;QACF,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/config/project.d.ts

@@ -0,0 +1,43 @@
+export interface Viewport {
+    width: number;
+    height: number;
+}
+export interface MozoleConfig {
+    schemaVersion: number;
+    name: string;
+    framework: "react-router";
+    routes: string[];
+    qa: {
+        viewports: Viewport[];
+        server: {
+            command: string;
+            args: string[];
+            readinessPath: string;
+            preferredPort: number;
+        };
+    };
+    cce: {
+        enabled: boolean;
+        initialized: boolean;
+        command: string;
+    };
+    governor: {
+        enabled: boolean;
+        mode: "warn";
+        hooks: {
+            codex: boolean;
+            claude: boolean;
+        };
+    };
+    telemetry: {
+        enabled: boolean;
+    };
+    verifiers: Array<{
+        name: string;
+        command: string;
+        args: string[];
+    }>;
+}
+export declare function readConfig(projectRoot: string): Promise<MozoleConfig>;
+export declare function findProjectRoot(start?: string): Promise<string>;
+//# sourceMappingURL=project.d.ts.map

package/dist/config/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/config/project.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE;QACF,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;YAChB,IAAI,EAAE,MAAM,EAAE,CAAC;YACf,aAAa,EAAE,MAAM,CAAC;YACtB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,CAAC;IACF,GAAG,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,OAAO,CAAA;SAAE,CAAC;KAC5C,CAAC;IACF,SAAS,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoD3E;AAED,wBAAsB,eAAe,CAAC,KAAK,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAc5E"}

package/dist/config/project.js

@@ -0,0 +1,57 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+export async function readConfig(projectRoot) {
+    const contents = await readFile(path.join(projectRoot, ".mozole", "project.json"), "utf8");
+    const value = JSON.parse(contents);
+    value.governor ??= {
+        enabled: true,
+        mode: "warn",
+        hooks: { codex: true, claude: true },
+    };
+    if (value.schemaVersion !== 1 ||
+        typeof value.name !== "string" ||
+        value.framework !== "react-router" ||
+        !Array.isArray(value.routes) ||
+        !value.routes.every((route) => typeof route === "string" && route.startsWith("/")) ||
+        !Array.isArray(value.qa?.viewports) ||
+        !value.qa.viewports.every((viewport) => Number.isInteger(viewport.width) &&
+            viewport.width > 0 &&
+            Number.isInteger(viewport.height) &&
+            viewport.height > 0) ||
+        typeof value.qa.server?.command !== "string" ||
+        !Array.isArray(value.qa.server.args) ||
+        !value.qa.server.args.every((argument) => typeof argument === "string") ||
+        typeof value.qa.server.readinessPath !== "string" ||
+        !value.qa.server.readinessPath.startsWith("/") ||
+        !Number.isInteger(value.qa.server.preferredPort) ||
+        !Array.isArray(value.verifiers) ||
+        !value.verifiers.every((verifier) => typeof verifier.name === "string" &&
+            typeof verifier.command === "string" &&
+            Array.isArray(verifier.args) &&
+            verifier.args.every((argument) => typeof argument === "string")) ||
+        typeof value.cce?.enabled !== "boolean" ||
+        typeof value.cce.initialized !== "boolean" ||
+        typeof value.governor.enabled !== "boolean" ||
+        value.governor.mode !== "warn" ||
+        typeof value.governor.hooks?.codex !== "boolean" ||
+        typeof value.governor.hooks.claude !== "boolean" ||
+        typeof value.telemetry?.enabled !== "boolean") {
+        throw new Error("Unsupported or invalid .mozole/project.json");
+    }
+    return value;
+}
+export async function findProjectRoot(start = process.cwd()) {
+    let current = path.resolve(start);
+    while (true) {
+        try {
+            await readFile(path.join(current, ".mozole", "project.json"));
+            return current;
+        }
+        catch { }
+        const parent = path.dirname(current);
+        if (parent === current)
+            throw new Error("No Mozole project found. Run `mozole new` or `mozole adopt`.");
+        current = parent;
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/config/project.js.map

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

package/dist/context/cce.d.ts

@@ -0,0 +1,8 @@
+import { type RunResult } from "../platform/process.js";
+export declare function cceCommand(resolve?: (command: string) => Promise<string | undefined>): Promise<{
+    command: string;
+    prefix: string[];
+} | undefined>;
+export declare function initializeCce(root: string, signal?: AbortSignal): Promise<RunResult | undefined>;
+export declare function queryCce(root: string, args: string[]): Promise<RunResult | undefined>;
+//# sourceMappingURL=cce.d.ts.map

package/dist/context/cce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cce.d.ts","sourceRoot":"","sources":["../../src/context/cce.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAO,MAAM,wBAAwB,CAAC;AAG7D,wBAAsB,UAAU,CAC9B,OAAO,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAqB,GAC5E,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAAC,CAc5D;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CA+ChC;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAQhC"}

package/dist/context/cce.js

@@ -0,0 +1,72 @@
+import { readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveExecutable } from "../platform/executable.js";
+import { run } from "../platform/process.js";
+import { TOOLCHAIN } from "../version.js";
+export async function cceCommand(resolve = resolveExecutable) {
+    const cce = await resolve("cce");
+    if (cce)
+        return { command: cce, prefix: [] };
+    const uvx = await resolve("uvx");
+    if (uvx)
+        return {
+            command: uvx,
+            prefix: [
+                "--from",
+                `${TOOLCHAIN.cce.package}==${TOOLCHAIN.cce.version}`,
+                "cce",
+            ],
+        };
+    return undefined;
+}
+export async function initializeCce(root, signal) {
+    const executable = await cceCommand();
+    if (!executable)
+        return undefined;
+    const instructionPaths = [
+        path.join(root, "AGENTS.md"),
+        path.join(root, "CLAUDE.md"),
+    ];
+    const instructions = await Promise.all(instructionPaths.map(async (file) => {
+        try {
+            return await readFile(file, "utf8");
+        }
+        catch {
+            return undefined;
+        }
+    }));
+    let result;
+    try {
+        result = await run(executable.command, [...executable.prefix, "init", "--agent", "all"], {
+            cwd: root,
+            timeoutMs: 300_000,
+            signal,
+            logFile: path.join(root, ".mozole", "logs", "cce-init.log"),
+        });
+    }
+    finally {
+        await Promise.all(instructionPaths.map((file, index) => {
+            const contents = instructions[index];
+            return contents === undefined
+                ? rm(file, { force: true })
+                : writeFile(file, contents, "utf8");
+        }));
+    }
+    if (result.exitCode === 0) {
+        const configPath = path.join(root, ".mozole", "project.json");
+        const config = JSON.parse(await readFile(configPath, "utf8"));
+        config.cce.initialized = true;
+        await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    }
+    return result;
+}
+export async function queryCce(root, args) {
+    const executable = await cceCommand();
+    return executable
+        ? run(executable.command, [...executable.prefix, ...args], {
+            cwd: root,
+            timeoutMs: 30_000,
+        })
+        : undefined;
+}
+//# sourceMappingURL=cce.js.map

package/dist/context/cce.js.map

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

package/dist/governor/fingerprint.d.ts

@@ -0,0 +1,7 @@
+import path from "node:path";
+import type { MozoleConfig } from "../config/project.js";
+export type FingerprintProfile = "verification" | "qa" | "visual";
+export declare function normalizeFingerprintPath(root: string, file: string, paths?: typeof path.win32): string;
+export declare function projectFingerprint(root: string, config: MozoleConfig, profile: FingerprintProfile): Promise<string>;
+export declare function fileFingerprint(file: string): Promise<string>;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/governor/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/governor/fingerprint.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,IAAI,GAAG,QAAQ,CAAC;AAkBlE,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAO,IAAI,CAAC,KAAY,GAC9B,MAAM,CAIR;AAmED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE"}

package/dist/governor/fingerprint.js

@@ -0,0 +1,109 @@
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+const ignoredDirectories = new Set([
+    ".cce",
+    ".git",
+    ".react-router",
+    "build",
+    "coverage",
+    "dist",
+    "node_modules",
+]);
+const ignoredMozoleDirectories = new Set(["backups", "logs", "qa", "state"]);
+const documentation = /(^|\/)(AGENTS|CLAUDE|README)\.(?:md|mdx)$|(^|\/)docs\//i;
+const qaIrrelevant = /(^|\/)(tests?|__tests__)\/|\.(test|spec)\.[cm]?[jt]sx?$|(^|\/)(biome|vitest)(\.config)?\./i;
+const relevantExtension = /\.(?:[cm]?[jt]sx?|mdx|css|scss|sass|less|html|json|ya?ml|toml|txt|xml|webmanifest|svg|png|jpe?g|gif|webp|avif|ico|woff2?|php)$/i;
+export function normalizeFingerprintPath(root, file, paths = path) {
+    return paths
+        .relative(paths.resolve(root), paths.resolve(file))
+        .replaceAll("\\", "/");
+}
+function includeFile(relative, profile) {
+    if (!relative || relative.startsWith("../") || documentation.test(relative))
+        return false;
+    if (relative.startsWith(".mozole/"))
+        return false;
+    if (relative === ".mozole/telemetry.json")
+        return false;
+    if (profile !== "verification" && qaIrrelevant.test(relative))
+        return false;
+    if ([
+        "package.json",
+        "package-lock.json",
+        "npm-shrinkwrap.json",
+        "react-router.config.ts",
+        "vite.config.ts",
+        "tsconfig.json",
+    ].includes(relative))
+        return true;
+    if (relative.startsWith("public/") || /(^|\/)\.env(?:\.|$)/.test(relative))
+        return true;
+    return relevantExtension.test(relative);
+}
+async function filesBelow(root, directory = root) {
+    const found = [];
+    const entries = await readdir(directory, { withFileTypes: true });
+    entries.sort((left, right) => left.name.localeCompare(right.name));
+    for (const entry of entries) {
+        const absolute = path.join(directory, entry.name);
+        const relative = normalizeFingerprintPath(root, absolute);
+        if (entry.isSymbolicLink())
+            continue;
+        if (entry.isDirectory()) {
+            if (ignoredDirectories.has(entry.name))
+                continue;
+            if (relative.startsWith(".mozole/") &&
+                ignoredMozoleDirectories.has(entry.name))
+                continue;
+            found.push(...(await filesBelow(root, absolute)));
+        }
+        else if (entry.isFile()) {
+            found.push(absolute);
+        }
+    }
+    return found;
+}
+function stable(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stable).join(",")}]`;
+    if (value && typeof value === "object")
+        return `{${Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, item]) => `${JSON.stringify(key)}:${stable(item)}`)
+            .join(",")}}`;
+    return JSON.stringify(value);
+}
+function configInputs(config, profile) {
+    if (profile === "verification")
+        return { verifiers: config.verifiers };
+    return {
+        routes: config.routes,
+        viewports: config.qa.viewports,
+        server: config.qa.server,
+        mode: profile,
+    };
+}
+export async function projectFingerprint(root, config, profile) {
+    const hash = createHash("sha256");
+    hash.update(`mozole:${profile}:v1\0${process.platform}\0${process.arch}\0${process.version}\0${stable(configInputs(config, profile))}\0`);
+    for (const absolute of await filesBelow(root)) {
+        const relative = normalizeFingerprintPath(root, absolute);
+        if (!includeFile(relative, profile))
+            continue;
+        hash.update(relative);
+        hash.update("\0");
+        for await (const chunk of createReadStream(absolute))
+            hash.update(chunk);
+        hash.update("\0");
+    }
+    return hash.digest("hex");
+}
+export async function fileFingerprint(file) {
+    const hash = createHash("sha256");
+    for await (const chunk of createReadStream(file))
+        hash.update(chunk);
+    return hash.digest("hex");
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/governor/fingerprint.js.map

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

package/dist/governor/hook.d.ts

@@ -0,0 +1,10 @@
+interface HookInput {
+    cwd?: unknown;
+    hook_event_name?: unknown;
+    tool_name?: unknown;
+    tool_input?: unknown;
+}
+export declare function evaluateGovernorHook(input: HookInput): Promise<Record<string, unknown> | undefined>;
+export declare function governorHookCommand(): Promise<number>;
+export {};
+//# sourceMappingURL=hook.d.ts.map

package/dist/governor/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/governor/hook.ts"],"names":[],"mappings":"AAYA,UAAU,SAAS;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA+BD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAyF9C;AASD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAW3D"}

package/dist/governor/hook.js

@@ -0,0 +1,127 @@
+import { createHash } from "node:crypto";
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { findProjectRoot, readConfig } from "../config/project.js";
+import { updateTelemetry } from "../telemetry/store.js";
+import { fileFingerprint, normalizeFingerprintPath, projectFingerprint, } from "./fingerprint.js";
+import { readGovernorState, writeGovernorState } from "./state.js";
+function object(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+function hookMessage(message) {
+    return {
+        hookSpecificOutput: {
+            hookEventName: "PreToolUse",
+            additionalContext: message,
+        },
+    };
+}
+async function telemetryWarning(root, enabled, kind, chars) {
+    if (!enabled)
+        return;
+    await updateTelemetry(root, (telemetry) => {
+        if (kind === "read")
+            telemetry.governor.repeatedReadWarnings++;
+        else
+            telemetry.governor.repeatedWorkWarnings++;
+        telemetry.governor.modelFacingDiagnosticChars += chars;
+    });
+}
+export async function evaluateGovernorHook(input) {
+    const cwd = typeof input.cwd === "string" ? input.cwd : process.cwd();
+    const root = await findProjectRoot(cwd);
+    const config = await readConfig(root);
+    if (!config.governor.enabled || config.governor.mode !== "warn")
+        return;
+    const toolName = typeof input.tool_name === "string" ? input.tool_name : "";
+    const toolInput = object(input.tool_input);
+    const candidate = [
+        toolInput.file_path,
+        toolInput.path,
+        toolInput.filename,
+    ].find((item) => typeof item === "string");
+    if (candidate && /read|file/i.test(toolName)) {
+        const absolute = path.resolve(cwd, candidate);
+        if (absolute !== root &&
+            !absolute.startsWith(`${path.resolve(root)}${path.sep}`))
+            return;
+        await access(absolute);
+        const content = await fileFingerprint(absolute);
+        const region = `${String(toolInput.offset ?? "")}\0${String(toolInput.limit ?? "")}`;
+        const key = `${normalizeFingerprintPath(root, absolute)}\0${region}`;
+        const state = await readGovernorState(root);
+        const previous = state.reads[key];
+        const current = {
+            content,
+            seenAt: new Date().toISOString(),
+            warned: previous?.content === content ? Boolean(previous.warned) : false,
+        };
+        state.reads[key] = current;
+        const keys = Object.keys(state.reads);
+        for (const stale of keys.slice(0, Math.max(0, keys.length - 100)))
+            delete state.reads[stale];
+        if (previous?.content === content && !previous.warned) {
+            current.warned = true;
+            await writeGovernorState(root, state);
+            const message = `CONTEXT GUARD\n\n${normalizeFingerprintPath(root, absolute)} was already inspected and has not changed. Prefer CCE, git diff, or a changed-region read.`;
+            await telemetryWarning(root, config.telemetry.enabled, "read", message.length);
+            return hookMessage(message);
+        }
+        await writeGovernorState(root, state);
+        return;
+    }
+    const command = typeof toolInput.command === "string" ? toolInput.command : undefined;
+    if (!command || !/bash|exec|shell/i.test(toolName))
+        return;
+    const commandHash = createHash("sha256").update(command).digest("hex");
+    const fingerprint = await projectFingerprint(root, config, "verification");
+    const state = await readGovernorState(root);
+    const previous = state.commands.find((item) => item.command === commandHash && item.fingerprint === fingerprint);
+    if (!previous) {
+        state.commands.push({
+            command: commandHash,
+            fingerprint,
+            seenAt: new Date().toISOString(),
+        });
+        state.commands = state.commands.slice(-50);
+        await writeGovernorState(root, state);
+        return;
+    }
+    if (previous.warned)
+        return;
+    previous.warned = true;
+    previous.seenAt = new Date().toISOString();
+    await writeGovernorState(root, state);
+    const qaFingerprint = await projectFingerprint(root, config, "qa");
+    const complete = state.verification?.fingerprint === fingerprint &&
+        Object.values(state.qa).some((evidence) => evidence.fingerprint === qaFingerprint);
+    const message = complete
+        ? "RUNAWAY GUARD\n\nThis command repeats existing evidence after verification and QA passed. Address a specific unresolved issue or stop."
+        : "EXECUTION GUARD\n\nThis identical command already ran without a relevant project mutation.";
+    await telemetryWarning(root, config.telemetry.enabled, "work", message.length);
+    return hookMessage(message);
+}
+async function stdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    return Buffer.concat(chunks).toString("utf8");
+}
+export async function governorHookCommand() {
+    try {
+        const raw = await stdin();
+        if (!raw.trim())
+            return 0;
+        const result = await evaluateGovernorHook(JSON.parse(raw));
+        if (result)
+            process.stdout.write(JSON.stringify(result));
+        return 0;
+    }
+    catch {
+        // Hooks are advisory and must never break legitimate agent work.
+        return 0;
+    }
+}
+//# sourceMappingURL=hook.js.map

package/dist/governor/hook.js.map

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

package/dist/governor/state.d.ts

@@ -0,0 +1,35 @@
+export interface EvidenceState {
+    fingerprint: string;
+    passedAt: string;
+    checks?: string[];
+    routes?: string[];
+    viewports?: string[];
+    artifacts?: Array<{
+        path: string;
+        sha256: string;
+    }>;
+}
+export interface GovernorState {
+    schemaVersion: 1;
+    verification?: EvidenceState;
+    qa: Record<string, EvidenceState>;
+    reads: Record<string, {
+        content: string;
+        seenAt: string;
+        warned?: boolean;
+    }>;
+    commands: Array<{
+        command: string;
+        fingerprint: string;
+        seenAt: string;
+        warned?: boolean;
+    }>;
+}
+export declare const emptyGovernorState: () => GovernorState;
+export declare function readGovernorState(root: string): Promise<GovernorState>;
+export declare function writeGovernorState(root: string, value: GovernorState): Promise<void>;
+export declare function qaStateKey(mode: {
+    interactive: boolean;
+    visual: boolean;
+}): string;
+//# sourceMappingURL=state.d.ts.map

package/dist/governor/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/governor/state.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AACD,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,CAAC,CAAC;IACjB,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7E,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,kBAAkB,QAAO,aAKpC,CAAC;AASH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA8B5E;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,MAAM,CAIT"}