rulebookguard 0.9.0 → 0.11.0

package/README.md

@@ -40,11 +40,15 @@ docs/rules/clients/R-CLI-001.md   ── anchors ──▶  src/clients/**/*.ts
 
 Requires Node.js 22 or later.
 
+rulebookguard does not need to be a dependency of your project. Nothing in your code imports it, so you can run it with `npx`, pinning the version so that every machine and CI run the same one:
+
 ```sh
-npx rulebookguard lint
+npx rulebookguard@0.11.0 lint
 ```
 
-Or add it to a project:
+Each release locks its own dependencies for npm and `npx`, so a pinned version keeps running the same code. Other package managers, such as `pnpm dlx`, ignore that lock and resolve the dependency ranges. Your `package.json` and lockfile stay untouched.
+
+If you prefer to keep the version in your lockfile, and renovate it with the rest of your dependencies, add it as a dev dependency instead:
 
 ```sh
 npm install --save-dev rulebookguard
@@ -52,10 +56,10 @@ npm install --save-dev rulebookguard
 
 A first rule in four steps:
 
-1. Set up the rulebook: `npx rulebookguard init clients --ci` writes `rulebookguard.config.yaml`, the `clients` context and a CI workflow (see [Configuration](#configuration) to adjust `testGlobs`).
-2. Scaffold a rule: `npx rulebookguard new clients` creates `docs/rules/clients/R-CLI-001.md` as `proposed`.
+1. Set up the rulebook: `npx rulebookguard@0.11.0 init clients --ci` writes `rulebookguard.config.yaml`, the `clients` context and a CI workflow (see [Configuration](#configuration) to adjust `testGlobs`).
+2. Scaffold a rule: `npx rulebookguard@0.11.0 new clients` creates `docs/rules/clients/R-CLI-001.md` as `proposed`.
 3. Write the rule, add its `anchors`, set `status: active`, and wrap the test that proves it with `@rule R-CLI-001` and `@endrule R-CLI-001`.
-4. Run `npx rulebookguard lint`, and add it to CI with the [CI recipe](#ci-recipe).
+4. Run `npx rulebookguard@0.11.0 lint`, and add it to CI with the [CI recipe](#ci-recipe).
 
 ## Configuration
 
@@ -239,6 +243,7 @@ func validateDocument(country, number string) error {
 | [`show <id>`](#show-id-l2)                                            | the full rule (L2)                                           |
 | [`search <text>`](#search-text---context-c---json)                    | rules holding every word of a text                           |
 | [`for <path>`](#for-path)                                             | the active rules anchored to a file                          |
+| [`for --changed <ref>`](#for---changed-ref)                           | the active rules anchored to the files changed since a ref   |
 | [`impact <id>`](#impact-id)                                           | the files and tests a rule touches                           |
 | [`new <context>`](#new-context---prefix-p)                            | scaffolds the next rule of a context                         |
 | [`lint`](#lint---base-ref---json)                                     | checks the whole catalog, and optionally changes since a ref |
@@ -326,6 +331,23 @@ R-CLI-001 (clients): A client document number is unique per country. (lines 12-3
 
 When the file holds `@implements` regions of a rule, its line ends with their line ranges; `--json` rows carry them as `regions: [{ line, endLine }]` (or `[]`). Exits 1 when the path is outside the rulebook root.
 
+### `for --changed <ref>`
+
+Active rules anchored to the files changed since a git ref, each with those files. This is what a reviewer needs to know about a pull request: which rules it touches, even when no rule file changed.
+
+```sh
+$ rulebookguard for --changed origin/main
+R-BIL-001 (billing): Every new client gets a zero-balance account.
+  src/clients/create.ts
+R-CLI-001 (clients): A client document number is unique per country.
+  src/clients/create.ts
+  src/clients/update.ts
+```
+
+It looks at the difference between the ref and the working tree, including deleted files and untracked ones that are not ignored, as `lint --base` does. A renamed file counts under both paths, so a file moved away from its anchors still reports their rules. On a branch that is behind the ref, the files changed on the ref since the branch point count too, so in CI compare against the base of the pull request on the merge commit, which is what a pull request checkout gives you.
+
+`--json` prints `{ base, files, rules }`, where `files` lists every changed file and each rule carries its own `files`. Prints `No active rules anchored to the files changed since <ref>.` when there are none. Exits 1 for an unknown ref or outside a git work tree, and 2 when given both a path and `--changed`.
+
 ### `impact <id>`
 
 Files matched by a rule's anchors and the tests tagging it.
@@ -464,7 +486,7 @@ Run it again after changing rules, for example in CI or before committing: it ov
 
 ### `export agents-md [--out <dir>]`
 
-Keeps an index of the active rules in `AGENTS.md`, at the rulebook root or in `--out`. `AGENTS.md` has no path scoping and is always read, so it holds each rule's id, anchors (or `no anchors`), summary and rule file, not the full text. The index lives between `<!-- rulebookguard:start -->` and `<!-- rulebookguard:end -->`: the rest of the file is kept, the block is appended the first time and replaced after that, and it is removed when no rule is active. Anything other than one start marker followed by one end marker, or neither, fails with exit code 1 and leaves the file untouched.
+Keeps an index of the active rules in `AGENTS.md`, at the rulebook root or in `--out`. `AGENTS.md` has no path scoping and is always read, so it holds each rule's id, anchors (or `no anchors`), summary and rule file, not the full text. The index lives between `<!-- rulebookguard:start -->` and `<!-- rulebookguard:end -->`: the rest of the file is kept, the block is appended the first time and replaced after that, and it is removed when no rule is active, along with the file if nothing else is left (printing `removed AGENTS.md`). Anything other than one start marker followed by one end marker, or neither, fails with exit code 1 and leaves the file untouched.
 
 ### `hook`
 
@@ -506,7 +528,7 @@ The rulebook is found from `--project` (default: the current directory). A comma
 > npm install --save-dev rulebookguard @rulebookguard/site
 > ```
 
-Without it, the site commands fail, exit 1, with `The site commands need the @rulebookguard/site package. Install it next to rulebookguard: npm install --save-dev @rulebookguard/site`. One-off, without installing: `npx -p rulebookguard -p @rulebookguard/site rulebookguard site:run`.
+Without it, the site commands fail, exit 1, with `The site commands need the @rulebookguard/site package. Install it next to rulebookguard: npm install --save-dev @rulebookguard/site`. One-off, without installing: `npx -p rulebookguard@0.11.0 -p @rulebookguard/site@0.11.0 rulebookguard site:run`.
 
 Builds a read-only static site of the rulebook with [Astro Starlight](https://starlight.astro.build) into `--out` (default `site`, relative to the current directory) and prints that path. Open it from disk or publish it as is, for example on GitHub Pages; pass `--base` when it is served from a sub-path (`--base /rules`).
 
@@ -559,11 +581,11 @@ jobs:
       - uses: actions/setup-node@v6
         with:
           node-version: 22
-      - run: npx --yes rulebookguard@0.9.0 lint --base origin/${{ github.base_ref }}
+      - run: npx --yes rulebookguard@0.11.0 lint --base origin/${{ github.base_ref }}
 ```
 
 > [!TIP]
-> Pin the version, or add rulebookguard as a dev dependency and run it from the lockfile, so a new release never changes CI results by itself.
+> Keep the version pinned, or add rulebookguard as a dev dependency and run it from the lockfile, so a new release never changes CI results by itself.
 
 ## Claude Code plugin
 

package/dist/{anchors-DQwbqb7w.mjs → anchors-jf2bKfyg.mjs}

@@ -1,4 +1,4 @@
-import { v as createGlobMatcher, x as toRepoPath } from "./lint-CaJnNLmU.mjs";
+import { S as toRepoPath, y as createGlobMatcher } from "./lint-BPdk6XxH.mjs";
 // src/catalog/anchors.ts
 function rulesForPath(rules, path) {
 	const target = toRepoPath(path);

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { B as formatIssue, F as CONFIG_FILE_NAME, O as isRuleId, R as messages, a as CliError, c as openCatalog, d as writeLines, f as scanImplementations, g as loadCatalog, h as findRulebookRoot, j as CONTEXT_FILE_NAME, l as shownPath, m as scanTestTags, o as findRule, r as lintCommand, s as gitFallbackWarning, u as writeJson, x as toRepoPath, y as expandGlobs, z as FormatError } from "./lint-CaJnNLmU.mjs";
-import { t as rulesForPath } from "./anchors-DQwbqb7w.mjs";
+import { B as FormatError, I as CONFIG_FILE_NAME, M as CONTEXT_FILE_NAME, S as toRepoPath, V as formatIssue, _ as loadCatalog, b as expandGlobs, c as gitFallbackWarning, d as writeJson, f as writeLines, g as findRulebookRoot, h as scanTestTags, i as lintCommand, k as isRuleId, l as openCatalog, o as CliError, p as scanImplementations, s as findRule, t as changedFiles, u as shownPath, z as messages } from "./lint-BPdk6XxH.mjs";
+import { t as rulesForPath } from "./anchors-jf2bKfyg.mjs";
 import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { parseArgs } from "node:util";
@@ -115,9 +115,18 @@ async function writeAgentsMd(catalog, io, rules, dir) {
 	if (rules.length === 0 && !hasBlock) return [text.noActiveRules];
 	const before = hasBlock ? existing.slice(0, start) : existing;
 	const after = hasBlock ? existing.slice(end + 26) : "";
+	if (rules.length === 0) {
+		const rest = withoutBlock(before, after);
+		if (rest === "") {
+			await rm(file);
+			return [text.noActiveRules, text.removedExport(shown)];
+		}
+		await writeFile(file, rest);
+		return [text.noActiveRules, shown];
+	}
 	await mkdir(dir, { recursive: true });
-	await writeFile(file, rules.length === 0 ? withoutBlock(before, after) : withBlock(before, after, agentsBlock(rules, text), hasBlock));
-	return rules.length === 0 ? [text.noActiveRules, shown] : [shown];
+	await writeFile(file, withBlock(before, after, agentsBlock(rules, text), hasBlock));
+	return [shown];
 }
 function withBlock(before, after, block, hasBlock) {
 	if (hasBlock) return `${before}${block}${after}`;
@@ -325,6 +334,33 @@ async function forCommand(catalog, io, input, json) {
 	}
 	writeLines(io, rules.map((rule) => `${rule.id} (${rule.context}): ${rule.summary}${rule.regions.length === 0 ? "" : ` (${text.lines(formatSpans(rule.regions))})`}`));
 }
+async function forChangedCommand(catalog, io, base, json) {
+	const text = messages(catalog.config.language);
+	const { files } = await changedFiles(catalog.root, base, text, "for --changed", { bothRenamePaths: true });
+	const touched = /* @__PURE__ */ new Map();
+	for (const file of files) for (const rule of rulesForPath(catalog.rules, file)) touched.set(rule.id, [...touched.get(rule.id) ?? [], file]);
+	const rules = sortById(catalog.rules.filter((rule) => rule.status === "active")).flatMap((rule) => {
+		const ruleFiles = touched.get(rule.id);
+		return ruleFiles === void 0 ? [] : [{
+			...toSummary(rule),
+			file: rule.file,
+			files: ruleFiles
+		}];
+	});
+	if (json) {
+		writeJson(io, {
+			base,
+			files,
+			rules
+		});
+		return;
+	}
+	if (rules.length === 0) {
+		writeLines(io, [text.noActiveRulesForChanged(base)]);
+		return;
+	}
+	writeLines(io, rules.flatMap((rule) => [`${rule.id} (${rule.context}): ${rule.summary}`, ...indent(rule.files, text.none)]));
+}
 async function regionsIn(root, path) {
 	const found = (await scanImplementations(root, [path])).regions;
 	return (id) => (found.get(id) ?? []).map(({ line, endLine }) => ({
@@ -459,7 +495,7 @@ function render(path, rules, regions, text) {
 	return parts.join("\n\n");
 }
 // package.json
-var version = "0.9.0";
+var version = "0.11.0";
 // src/commands/new.ts
 const MAX_NUMBER = 999;
 const CONTEXT_NAME = /^[a-z0-9][a-z0-9_-]*$/;
@@ -738,6 +774,8 @@ Commands:
   search <text> [--context <c>] [--json]             rules whose id, summary, entities or text hold every
                                                      word of <text>, ignoring case
   for <path> [--json]                                active rules anchored to a path
+  for --changed <ref> [--json]                       active rules anchored to the files changed since <ref>,
+                                                     each with those files
   impact <id> [--json]                               files matched by a rule's anchors and tests tagging it
   new <context> [--prefix <P>]                       scaffold the next free rule id as a proposed rule;
                                                      creates the context first when it does not exist,
@@ -809,9 +847,13 @@ const COMMANDS = {
 		}
 	},
 	for: {
-		usage: "rulebookguard for <path> [--json]",
+		usage: "rulebookguard for <path>|--changed <ref> [--json]",
 		argument: "path",
-		options: JSON_OPTION
+		argumentUnless: "changed",
+		options: {
+			...JSON_OPTION,
+			changed: { type: "string" }
+		}
 	},
 	impact: {
 		usage: "rulebookguard impact <id> [--json]",
@@ -893,7 +935,7 @@ async function dispatch(argv, io) {
 		return 0;
 	}
 	if (name === "site" || name === "site:generate" || name === "site:run") {
-		const { siteCommand } = await import("./site-BTCwdt_H.mjs");
+		const { siteCommand } = await import("./site-B7g8lbjx.mjs");
 		await siteCommand(io, {
 			out: values.out,
 			base: values.base,
@@ -937,7 +979,8 @@ async function dispatch(argv, io) {
 			});
 			break;
 		case "for":
-			await forCommand(catalog, io, argument, json);
+			if (values.changed === void 0) await forCommand(catalog, io, argument, json);
+			else await forChangedCommand(catalog, io, values.changed, json);
 			break;
 		case "impact":
 			await impactCommand(catalog, io, argument, json);
@@ -971,7 +1014,8 @@ function parse(spec, args) {
 	} catch (error) {
 		throw new CliError(`${error.message}\nUsage: ${spec.usage}`, 2);
 	}
-	const expected = spec.argument === void 0 ? 0 : 1;
+	const replaced = spec.argumentUnless !== void 0 && parsed.values[spec.argumentUnless] !== void 0;
+	const expected = spec.argument === void 0 || replaced ? 0 : 1;
 	if (parsed.positionals.length < expected) throw new CliError(`Missing argument <${spec.argument}>. Usage: ${spec.usage}`, 2);
 	if (parsed.positionals.length > expected) throw new CliError(`Unexpected argument "${parsed.positionals[expected]}". Usage: ${spec.usage}`, 2);
 	return {

package/dist/index.d.mts

@@ -179,6 +179,14 @@ interface ForJson {
     regions: LineSpanJson[];
   })[];
 }
+interface ForChangedJson {
+  base: string;
+  files: string[];
+  rules: (RuleSummaryJson & {
+    file: string;
+    files: string[];
+  })[];
+}
 interface LineSpanJson {
   line: number;
   endLine: number;
@@ -212,4 +220,4 @@ interface LintOptions {
 export declare function lintCatalog(catalog: Catalog, scan?: TagScan, onGitFallback?: GitFallbackListener): Promise<LintFinding[]>;
 export declare function pendingImplementation(catalog: Catalog, scan: TagScan, base: string, changed: string[], lines: Map<string, LineSpan[]>): LintFinding[];
 export declare function formatFinding(finding: LintFinding): string;
-export type { Catalog, CatalogIssue, CatalogIssueCode, ContextDoc, ContextFrontmatter, ContextsJson, ForJson, FormatIssue, Frontmatter, GitFallbackListener, ImpactJson, ImplementationScan, ImplementsTagProblemCode, LintFinding, LintJson, LintOptions, LintSeverity, ListJson, ParseOptions, RegionIndex, RegionKind, RuleDoc, RuleFrontmatter, RuleLanguage, RuleRegion, RuleRegions, RuleStatus, RuleSummaryJson, RuleTag, RuleTagProblem, RuleTagProblemCode, RulebookConfig, ShowJson, TagIndex, TagLocation, TagProblem, TagRegion, TagScan };
+export type { Catalog, CatalogIssue, CatalogIssueCode, ContextDoc, ContextFrontmatter, ContextsJson, ForChangedJson, ForJson, FormatIssue, Frontmatter, GitFallbackListener, ImpactJson, ImplementationScan, ImplementsTagProblemCode, LintFinding, LintJson, LintOptions, LintSeverity, ListJson, ParseOptions, RegionIndex, RegionKind, RuleDoc, RuleFrontmatter, RuleLanguage, RuleRegion, RuleRegions, RuleStatus, RuleSummaryJson, RuleTag, RuleTagProblem, RuleTagProblemCode, RulebookConfig, ShowJson, TagIndex, TagLocation, TagProblem, TagRegion, TagScan };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { A as parseRule, B as formatIssue, C as IMPLEMENTS_MARKER_PATTERN, D as findRuleTags, E as findRuleRegions, F as CONFIG_FILE_NAME, I as loadConfig, L as parseConfig, M as loadContext, N as parseContext, O as isRuleId, P as splitFrontmatter, T as RULE_TAG_PATTERN, _ as relativeToRoot, b as listRepoFiles, f as scanImplementations, g as loadCatalog, h as findRulebookRoot, i as pendingImplementation, j as CONTEXT_FILE_NAME, k as loadRule, m as scanTestTags, n as lintCatalog, p as scanTestRegions, t as formatFinding, v as createGlobMatcher, w as RULE_MARKER_PATTERN, x as toRepoPath, y as expandGlobs, z as FormatError } from "./lint-CaJnNLmU.mjs";
-import { t as rulesForPath } from "./anchors-DQwbqb7w.mjs";
+import { A as loadRule, B as FormatError, D as findRuleRegions, E as RULE_TAG_PATTERN, F as splitFrontmatter, I as CONFIG_FILE_NAME, L as loadConfig, M as CONTEXT_FILE_NAME, N as loadContext, O as findRuleTags, P as parseContext, R as parseConfig, S as toRepoPath, T as RULE_MARKER_PATTERN, V as formatIssue, _ as loadCatalog, a as pendingImplementation, b as expandGlobs, g as findRulebookRoot, h as scanTestTags, j as parseRule, k as isRuleId, m as scanTestRegions, n as formatFinding, p as scanImplementations, r as lintCatalog, v as relativeToRoot, w as IMPLEMENTS_MARKER_PATTERN, x as listRepoFiles, y as createGlobMatcher } from "./lint-BPdk6XxH.mjs";
+import { t as rulesForPath } from "./anchors-jf2bKfyg.mjs";
 export { CONFIG_FILE_NAME, CONTEXT_FILE_NAME, FormatError, IMPLEMENTS_MARKER_PATTERN, RULE_MARKER_PATTERN, RULE_TAG_PATTERN, createGlobMatcher, expandGlobs, findRuleRegions, findRuleTags, findRulebookRoot, formatFinding, formatIssue, isRuleId, lintCatalog, listRepoFiles, loadCatalog, loadConfig, loadContext, loadRule, parseConfig, parseContext, parseRule, pendingImplementation, relativeToRoot, rulesForPath, scanImplementations, scanTestRegions, scanTestTags, splitFrontmatter, toRepoPath };

package/dist/{lint-CaJnNLmU.mjs → lint-BPdk6XxH.mjs}

@@ -187,6 +187,7 @@ const MESSAGES = {
 		noContexts: "No contexts found. Create one with \"rulebookguard new <context>\".",
 		noRules: "No rules found.",
 		noActiveRulesFor: (path) => `No active rules anchored to ${path}.`,
+		noActiveRulesForChanged: (ref) => `No active rules anchored to the files changed since ${ref}.`,
 		lines: (spans) => `lines ${spans}`,
 		filesMatched: (count) => `Files matched by anchors (${count}):`,
 		testsTagging: (id, count) => `Tests tagging ${id} (${count}):`,
@@ -259,7 +260,7 @@ const MESSAGES = {
 		contextOverBudgetHint: "split the context into smaller ones, or raise contextBudget in rulebookguard.config.yaml",
 		pendingImplementationHint: (id) => `update or add a test inside an "@rule ${id}" … "@endrule ${id}" region that covers the changed rule`,
 		lintSummary: (errors, warnings) => `${errors} ${errors === 1 ? "error" : "errors"}, ${warnings} ${warnings === 1 ? "warning" : "warnings"}`,
-		needsWorkTree: (root) => `lint --base needs a git work tree, but ${root} is not inside one.`,
+		needsWorkTree: (command, root) => `${command} needs a git work tree, but ${root} is not inside one.`,
 		unknownRef: (ref) => `Unknown git ref "${ref}".`,
 		cannotListChanged: (ref, reason) => `Cannot list the files changed since "${ref}": ${reason}`
 	},
@@ -294,6 +295,7 @@ const MESSAGES = {
 		noContexts: "No se encontraron contextos. Crea uno con \"rulebookguard new <contexto>\".",
 		noRules: "No se encontraron reglas.",
 		noActiveRulesFor: (path) => `No hay reglas activas ancladas a ${path}.`,
+		noActiveRulesForChanged: (ref) => `No hay reglas activas ancladas a los archivos cambiados desde ${ref}.`,
 		lines: (spans) => `líneas ${spans}`,
 		filesMatched: (count) => `Archivos que cubren los anchors (${count}):`,
 		testsTagging: (id, count) => `Tests que etiquetan ${id} (${count}):`,
@@ -366,7 +368,7 @@ const MESSAGES = {
 		contextOverBudgetHint: "divide el contexto en otros más chicos o sube contextBudget en rulebookguard.config.yaml",
 		pendingImplementationHint: (id) => `actualiza o agrega un test dentro de una región "@rule ${id}" … "@endrule ${id}" que cubra el cambio de la regla`,
 		lintSummary: (errors, warnings) => `${errors} ${errors === 1 ? "error" : "errores"}, ${warnings} ${warnings === 1 ? "aviso" : "avisos"}`,
-		needsWorkTree: (root) => `lint --base necesita un work tree de git, pero ${root} no está en uno.`,
+		needsWorkTree: (command, root) => `${command} necesita un work tree de git, pero ${root} no está en uno.`,
 		unknownRef: (ref) => `La referencia de git "${ref}" no existe.`,
 		cannotListChanged: (ref, reason) => `No se pudieron listar los archivos cambiados desde "${ref}": ${reason}`
 	}
@@ -613,10 +615,11 @@ async function isCommitRef(cwd, ref) {
 		return false;
 	}
 }
-async function changedSince(cwd, ref) {
+async function changedSince(cwd, ref, { bothRenamePaths = false } = {}) {
 	const changed = await gitPaths(cwd, "diff", [
 		"--name-only",
 		"--relative",
+		...bothRenamePaths ? ["--no-renames"] : [],
 		ref,
 		"--"
 	]);
@@ -1001,7 +1004,7 @@ function writeLines(io, lines) {
 }
 function shownPath(cwd, file) {
 	const fromCwd = relative(cwd, file);
-	return fromCwd.startsWith("..") || isAbsolute(fromCwd) ? file : fromCwd;
+	return fromCwd.startsWith("..") || isAbsolute(fromCwd) ? file : toRepoPath(fromCwd);
 }
 function gitFallbackWarning(io, language) {
 	const text = messages(language);
@@ -1035,7 +1038,7 @@ async function lintCommand(io, options) {
 		}, messages("en"))), options.json, messages("en"));
 	}
 	const text = messages(catalog.config.language);
-	const changed = options.base === void 0 ? void 0 : await changedFiles(catalog.root, options.base, text);
+	const changed = options.base === void 0 ? void 0 : await changedFiles(catalog.root, options.base, text, "lint --base");
 	const warn = gitFallbackWarning(io, catalog.config.language);
 	const scan = await scanTestRegions(catalog.root, catalog.config.testGlobs, warn);
 	const findings = await lintCatalog(catalog, scan, warn);
@@ -1201,11 +1204,11 @@ async function testLineChanges(catalog, scan, base, changed, text) {
 	}
 	return lines;
 }
-async function changedFiles(root, base, text) {
-	if (!await isInsideWorkTree(root)) throw new CliError(text.needsWorkTree(root));
+async function changedFiles(root, base, text, command, options) {
+	if (!await isInsideWorkTree(root)) throw new CliError(text.needsWorkTree(command, root));
 	if (!await isCommitRef(root, base)) throw new CliError(text.unknownRef(base));
 	try {
-		return await changedSince(root, base);
+		return await changedSince(root, base, options);
 	} catch (error) {
 		throw new CliError(text.cannotListChanged(base, gitFailureReason(error)));
 	}
@@ -1229,4 +1232,4 @@ function sortFindings(findings) {
 function compare(a, b) {
 	return a < b ? -1 : a > b ? 1 : 0;
 }
-export { parseRule as A, formatIssue as B, IMPLEMENTS_MARKER_PATTERN as C, findRuleTags as D, findRuleRegions as E, CONFIG_FILE_NAME as F, loadConfig as I, parseConfig as L, loadContext as M, parseContext as N, isRuleId as O, splitFrontmatter as P, messages as R, runGit as S, RULE_TAG_PATTERN as T, relativeToRoot as _, CliError as a, listRepoFiles as b, openCatalog as c, writeLines as d, scanImplementations as f, loadCatalog as g, findRulebookRoot as h, pendingImplementation as i, CONTEXT_FILE_NAME as j, loadRule as k, shownPath as l, scanTestTags as m, lintCatalog as n, findRule as o, scanTestRegions as p, lintCommand as r, gitFallbackWarning as s, formatFinding as t, writeJson as u, createGlobMatcher as v, RULE_MARKER_PATTERN as w, toRepoPath as x, expandGlobs as y, FormatError as z };
+export { loadRule as A, FormatError as B, runGit as C, findRuleRegions as D, RULE_TAG_PATTERN as E, splitFrontmatter as F, CONFIG_FILE_NAME as I, loadConfig as L, CONTEXT_FILE_NAME as M, loadContext as N, findRuleTags as O, parseContext as P, parseConfig as R, toRepoPath as S, RULE_MARKER_PATTERN as T, formatIssue as V, loadCatalog as _, pendingImplementation as a, expandGlobs as b, gitFallbackWarning as c, writeJson as d, writeLines as f, findRulebookRoot as g, scanTestTags as h, lintCommand as i, parseRule as j, isRuleId as k, openCatalog as l, scanTestRegions as m, formatFinding as n, CliError as o, scanImplementations as p, lintCatalog as r, findRule as s, changedFiles as t, shownPath as u, relativeToRoot as v, IMPLEMENTS_MARKER_PATTERN as w, listRepoFiles as x, createGlobMatcher as y, messages as z };

package/dist/{site-BTCwdt_H.mjs → site-B7g8lbjx.mjs}

@@ -1,4 +1,4 @@
-import { S as runGit, a as CliError, c as openCatalog, d as writeLines, n as lintCatalog, p as scanTestRegions, s as gitFallbackWarning, y as expandGlobs } from "./lint-CaJnNLmU.mjs";
+import { C as runGit, S as toRepoPath, b as expandGlobs, c as gitFallbackWarning, f as writeLines, l as openCatalog, m as scanTestRegions, o as CliError, r as lintCatalog } from "./lint-BPdk6XxH.mjs";
 import { createRequire } from "node:module";
 import { readFile, readdir, stat, writeFile } from "node:fs/promises";
 import { dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
@@ -417,7 +417,7 @@ async function siteCommand(io, options, until = untilInterrupted()) {
 	const catalog = await openCatalog(io);
 	const out = resolve(io.cwd, options.out ?? "site");
 	const fromCwd = relative(io.cwd, out);
-	const shown = fromCwd === "" ? "." : fromCwd.startsWith("..") || isAbsolute(fromCwd) ? out : fromCwd;
+	const shown = fromCwd === "" ? "." : fromCwd.startsWith("..") || isAbsolute(fromCwd) ? out : toRepoPath(fromCwd);
 	await assertReplaceable(out, shown);
 	const site = await importSitePackage([catalog.root, dirname(fileURLToPath(import.meta.url))]);
 	const language = catalog.config.language ?? "en";

package/npm-shrinkwrap.json

@@ -0,0 +1,148 @@
+{
+  "name": "rulebookguard",
+  "version": "0.11.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "rulebookguard",
+      "version": "0.11.0",
+      "license": "MIT",
+      "dependencies": {
+        "@modelcontextprotocol/server": "2.3.1",
+        "ajv": "8.20.0",
+        "picomatch": "4.0.7",
+        "yaml": "2.9.1",
+        "zod": "4.6.7"
+      },
+      "bin": {
+        "rulebookguard": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=22"
+      },
+      "peerDependencies": {
+        "@rulebookguard/site": "^0.11.0"
+      },
+      "peerDependenciesMeta": {
+        "@rulebookguard/site": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@modelcontextprotocol/core": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/core/-/core-2.3.1.tgz",
+      "integrity": "sha512-laVmIhPGpWi7rG9q+0UigblRN0Hws/Yjlb6qLFtVqryXVLkc4h+yN8z731POD2LnAGQlFe7/tXhUm7Bi0YB91g==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "zod": "^4.2.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/@modelcontextprotocol/server": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/server/-/server-2.3.1.tgz",
+      "integrity": "sha512-e59MfWuSssj6DoQ96JCTqdW1AXT5/XtnTl0WWd6MU1Ka434fFUGGosCLJbGNySDhHGvxQWoRWK137FXYFkYNWw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@modelcontextprotocol/core": "2.3.1",
+        "zod": "^4.2.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.9",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.9.tgz",
+      "integrity": "sha512-hS/0Wt3Ya043oKXs0sIxrMpKQITXhMLIrVAKKXi4gozGC9v7YRWVnXIZzjNPTO02M9BdxLCWqK1yRXgNziVyJQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.7",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz",
+      "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/yaml": {
+      "version": "2.9.1",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.1.tgz",
+      "integrity": "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==",
+      "license": "ISC",
+      "bin": {
+        "yaml": "bin.mjs"
+      },
+      "engines": {
+        "node": ">= 14.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/eemeli"
+      }
+    },
+    "node_modules/zod": {
+      "version": "4.6.7",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz",
+      "integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulebookguard",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Keep business rules as the single source of truth, bound to code and tests.",
   "homepage": "https://github.com/JuanCJR/rulebookguard#readme",
   "bugs": {
@@ -16,7 +16,8 @@
   },
   "files": [
     "dist",
-    "schemas"
+    "schemas",
+    "npm-shrinkwrap.json"
   ],
   "type": "module",
   "exports": {
@@ -36,14 +37,14 @@
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "2.3.1",
-    "@rulebookguard/site": "0.9.0",
+    "@rulebookguard/site": "0.11.0",
     "@types/node": "^20.19.43",
     "@types/picomatch": "^4.0.3",
     "typescript": "^7.0.2",
     "vite-plus": "^1.4.0"
   },
   "peerDependencies": {
-    "@rulebookguard/site": "^0.9.0"
+    "@rulebookguard/site": "^0.11.0"
   },
   "peerDependenciesMeta": {
     "@rulebookguard/site": {