vigiles 2.0.0

package/dist/generate-types.js

@@ -0,0 +1,381 @@
+"use strict";
+/**
+ * vigiles generate-types — emit .d.ts with type unions from actual project state.
+ *
+ * Scans linter configs, package.json, and filesystem to generate TypeScript
+ * types that the compiler uses to PROVE references are valid at authoring time.
+ *
+ * Generated types:
+ *   - EslintRule / StylelintRule / RuffRule / ... — enabled rules per linter
+ *   - NpmScript — scripts from package.json
+ *   - ProjectFile — files in the project (scoped to src/ by default)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTypes = generateTypes;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_child_process_1 = require("node:child_process");
+const glob_1 = require("glob");
+// ---------------------------------------------------------------------------
+// Linter config detection
+// ---------------------------------------------------------------------------
+function fileContainsSection(filePath, section) {
+    if (!(0, node_fs_1.existsSync)(filePath))
+        return false;
+    try {
+        return (0, node_fs_1.readFileSync)(filePath, "utf-8").includes(section);
+    }
+    catch {
+        return false;
+    }
+}
+function hasRuffConfig(basePath) {
+    return ((0, node_fs_1.existsSync)((0, node_path_1.resolve)(basePath, "ruff.toml")) ||
+        (0, node_fs_1.existsSync)((0, node_path_1.resolve)(basePath, ".ruff.toml")) ||
+        fileContainsSection((0, node_path_1.resolve)(basePath, "pyproject.toml"), "[tool.ruff"));
+}
+function hasPylintConfig(basePath) {
+    return ((0, node_fs_1.existsSync)((0, node_path_1.resolve)(basePath, ".pylintrc")) ||
+        (0, node_fs_1.existsSync)((0, node_path_1.resolve)(basePath, "pylintrc")) ||
+        fileContainsSection((0, node_path_1.resolve)(basePath, "pyproject.toml"), "[tool.pylint") ||
+        fileContainsSection((0, node_path_1.resolve)(basePath, "setup.cfg"), "[pylint"));
+}
+function hasRubocopConfig(basePath) {
+    return (0, node_fs_1.existsSync)((0, node_path_1.resolve)(basePath, ".rubocop.yml"));
+}
+function discoverEslintRules(basePath) {
+    try {
+        const script = `
+      const { loadESLint } = require("eslint");
+      (async () => {
+        try {
+          const ESLint = await loadESLint();
+          const eslint = new ESLint({ cwd: ${JSON.stringify(basePath)} });
+          const config = await eslint.calculateConfigForFile("dummy.js");
+          const enabled = Object.entries(config.rules || {})
+            .filter(([, v]) => {
+              const sev = Array.isArray(v) ? v[0] : v;
+              return sev !== 0 && sev !== "off";
+            })
+            .map(([k]) => k);
+          console.log(JSON.stringify(enabled));
+        } catch(e) {
+          console.log("[]");
+        }
+      })();
+    `;
+        const output = (0, node_child_process_1.execSync)(`node -e '${script.replace(/'/g, "'\\''")}'`, {
+            encoding: "utf-8",
+            cwd: basePath,
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 15000,
+        });
+        const rules = JSON.parse(output.trim() || "[]");
+        if (rules.length === 0)
+            return null;
+        return { linter: "eslint", rules, via: "flat config" };
+    }
+    catch {
+        return null;
+    }
+}
+function discoverStylelintRules(basePath) {
+    try {
+        const script = `
+      const stylelint = require("stylelint");
+      (async () => {
+        try {
+          const linter = stylelint.createLinter({});
+          const result = await linter.getConfigForFile(${JSON.stringify((0, node_path_1.resolve)(basePath, "dummy.css"))});
+          const enabled = Object.entries(result.config.rules || {})
+            .filter(([, v]) => v !== null && !(Array.isArray(v) && v[0] === null))
+            .map(([k]) => k);
+          console.log(JSON.stringify(enabled));
+        } catch(e) {
+          console.log("[]");
+        }
+      })();
+    `;
+        const output = (0, node_child_process_1.execSync)(`node -e '${script.replace(/'/g, "'\\''")}'`, {
+            encoding: "utf-8",
+            cwd: basePath,
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 15000,
+        });
+        const rules = JSON.parse(output.trim() || "[]");
+        if (rules.length === 0)
+            return null;
+        return { linter: "stylelint", rules, via: "config" };
+    }
+    catch {
+        return null;
+    }
+}
+function discoverRuffRules(basePath) {
+    try {
+        if (!hasRuffConfig(basePath))
+            return null;
+        (0, node_child_process_1.execSync)("which ruff", { stdio: "ignore" });
+        const dummyPath = (0, node_path_1.resolve)(basePath, "dummy.py");
+        const output = (0, node_child_process_1.execSync)(`ruff check --show-settings ${dummyPath}`, {
+            encoding: "utf-8",
+            cwd: basePath,
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 10000,
+        });
+        const enabledMatch = output.match(/linter\.rules\.enabled\s*=\s*\[([\s\S]*?)\]/);
+        const rules = [];
+        if (enabledMatch?.[1]) {
+            const codeRe = /\(([A-Z]+\d*)\)/g;
+            let m;
+            while ((m = codeRe.exec(enabledMatch[1])) !== null) {
+                rules.push(m[1]);
+            }
+        }
+        if (rules.length === 0)
+            return null;
+        return { linter: "ruff", rules, via: "CLI" };
+    }
+    catch {
+        return null;
+    }
+}
+function discoverPylintRules(basePath) {
+    try {
+        if (!hasPylintConfig(basePath))
+            return null;
+        (0, node_child_process_1.execSync)("which pylint", { stdio: "ignore" });
+        const output = (0, node_child_process_1.execSync)("pylint --list-msgs-enabled", {
+            encoding: "utf-8",
+            cwd: basePath,
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 15000,
+        });
+        const disabledIdx = output.indexOf("Disabled messages:");
+        const enabledSection = disabledIdx >= 0 ? output.substring(0, disabledIdx) : output;
+        // Extract rule IDs like (C0114), (W0611) etc.
+        const rules = [];
+        const idRe = /\(([A-Z]\d{4})\)/g;
+        let m;
+        while ((m = idRe.exec(enabledSection)) !== null) {
+            rules.push(m[1]);
+        }
+        // Also extract symbolic names like "missing-module-docstring"
+        const nameRe = /^(\w[\w-]+)\s*\(/gm;
+        while ((m = nameRe.exec(enabledSection)) !== null) {
+            rules.push(m[1]);
+        }
+        if (rules.length === 0)
+            return null;
+        return { linter: "pylint", rules, via: "CLI" };
+    }
+    catch {
+        return null;
+    }
+}
+function discoverRubocopRules(basePath) {
+    try {
+        if (!hasRubocopConfig(basePath))
+            return null;
+        (0, node_child_process_1.execSync)("which rubocop", { stdio: "ignore" });
+        const output = (0, node_child_process_1.execSync)("rubocop --list-target-files --show-cops 2>/dev/null | head -500", {
+            encoding: "utf-8",
+            cwd: basePath,
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 15000,
+            shell: "/bin/sh",
+        });
+        const rules = [];
+        const copRe = /^(\w+\/\w+):/gm;
+        let m;
+        while ((m = copRe.exec(output)) !== null) {
+            rules.push(m[1]);
+        }
+        if (rules.length === 0)
+            return null;
+        return { linter: "rubocop", rules, via: "CLI" };
+    }
+    catch {
+        return null;
+    }
+}
+function discoverClippyRules(basePath) {
+    try {
+        const cargoPath = (0, node_path_1.resolve)(basePath, "Cargo.toml");
+        if (!(0, node_fs_1.existsSync)(cargoPath))
+            return null;
+        (0, node_child_process_1.execSync)("which cargo", { stdio: "ignore" });
+        // Clippy doesn't have a good "list enabled lints" command.
+        // We read Cargo.toml [lints.clippy] section for explicit config,
+        // and include default warn/deny lints from clippy -W clippy::all
+        const content = (0, node_fs_1.readFileSync)(cargoPath, "utf-8");
+        const sectionMatch = content.match(/\[lints\.clippy\]([\s\S]*?)(?=\n\[|$)/);
+        const rules = [];
+        if (sectionMatch?.[1]) {
+            const ruleRe = /^(\w[\w-]+)\s*=\s*"(\w+)"/gm;
+            let m;
+            while ((m = ruleRe.exec(sectionMatch[1])) !== null) {
+                if (m[2] !== "allow") {
+                    rules.push(m[1]);
+                }
+            }
+        }
+        if (rules.length === 0)
+            return null;
+        return { linter: "clippy", rules, via: "Cargo.toml" };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// NPM script discovery
+// ---------------------------------------------------------------------------
+function discoverNpmScripts(basePath) {
+    const pkgPath = (0, node_path_1.resolve)(basePath, "package.json");
+    if (!(0, node_fs_1.existsSync)(pkgPath))
+        return [];
+    try {
+        const pkg = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, "utf-8"));
+        return Object.keys(pkg.scripts ?? {});
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Project file discovery
+// ---------------------------------------------------------------------------
+function discoverProjectFiles(basePath, globs = ["src/**/*"]) {
+    const files = [];
+    for (const pattern of globs) {
+        const matches = (0, glob_1.globSync)(pattern, {
+            cwd: basePath,
+            ignore: ["node_modules/**", "dist/**", ".git/**"],
+            nodir: true,
+        });
+        files.push(...matches);
+    }
+    return [...new Set(files)].sort();
+}
+// ---------------------------------------------------------------------------
+// Type generation
+// ---------------------------------------------------------------------------
+function escapeForUnion(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function formatUnion(items, indent = "  ") {
+    if (items.length === 0)
+        return "never";
+    if (items.length <= 3) {
+        return items.map((i) => `"${escapeForUnion(i)}"`).join(" | ");
+    }
+    return ("\n" + items.map((i) => `${indent}| "${escapeForUnion(i)}"`).join("\n"));
+}
+/**
+ * Generate .d.ts content with type unions from actual project state.
+ *
+ * Scans all available linters, package.json scripts, and project files.
+ */
+function generateTypes(options = {}) {
+    const basePath = options.basePath ?? process.cwd();
+    const fileGlobs = options.fileGlobs ?? ["src/**/*"];
+    // Discover everything
+    const linters = [];
+    const eslint = discoverEslintRules(basePath);
+    if (eslint)
+        linters.push(eslint);
+    const stylelint = discoverStylelintRules(basePath);
+    if (stylelint)
+        linters.push(stylelint);
+    const ruff = discoverRuffRules(basePath);
+    if (ruff)
+        linters.push(ruff);
+    const pylint = discoverPylintRules(basePath);
+    if (pylint)
+        linters.push(pylint);
+    const rubocop = discoverRubocopRules(basePath);
+    if (rubocop)
+        linters.push(rubocop);
+    const clippy = discoverClippyRules(basePath);
+    if (clippy)
+        linters.push(clippy);
+    const scripts = discoverNpmScripts(basePath);
+    const files = discoverProjectFiles(basePath, fileGlobs);
+    // Generate .d.ts
+    const sections = [];
+    sections.push(`/**`);
+    sections.push(` * Auto-generated by \`vigiles generate-types\`.`);
+    sections.push(` * DO NOT EDIT — re-run \`vigiles generate-types\` to update.`);
+    sections.push(` */`);
+    sections.push(``);
+    // ---------------------------------------------------------------------------
+    // vigiles/generated — standalone types for direct import
+    // ---------------------------------------------------------------------------
+    sections.push(`declare module "vigiles/generated" {`);
+    // Linter rules
+    for (const { linter, rules, via } of linters) {
+        const typeName = linter.charAt(0).toUpperCase() +
+            linter.slice(1).replace(/-([a-z])/g, (_, c) => c.toUpperCase()) +
+            "Rule";
+        sections.push(``);
+        sections.push(`  /** ${String(rules.length)} enabled ${linter} rules (via ${via}). */`);
+        sections.push(`  export type ${typeName} = ${formatUnion(rules, "    ")};`);
+    }
+    // Combined linter rule type
+    if (linters.length > 0) {
+        const allNames = linters.map((l) => l.linter.charAt(0).toUpperCase() +
+            l.linter
+                .slice(1)
+                .replace(/-([a-z])/g, (_, c) => c.toUpperCase()) +
+            "Rule");
+        sections.push(``);
+        sections.push(`  /** All enabled linter rules across all detected linters. */`);
+        sections.push(`  export type LinterRule = ${allNames.join(" | ")};`);
+    }
+    // NPM scripts
+    if (scripts.length > 0) {
+        sections.push(``);
+        sections.push(`  /** ${String(scripts.length)} npm scripts from package.json. */`);
+        sections.push(`  export type NpmScript = ${formatUnion(scripts, "    ")};`);
+    }
+    // Project files
+    if (files.length > 0) {
+        sections.push(``);
+        sections.push(`  /** ${String(files.length)} project files. */`);
+        sections.push(`  export type ProjectFile = ${formatUnion(files, "    ")};`);
+    }
+    sections.push(`}`);
+    // ---------------------------------------------------------------------------
+    // vigiles/spec augmentation — populates KnownLinterRules, KnownProjectFiles,
+    // KnownNpmScripts interfaces so enforce(), file(), cmd() narrow automatically.
+    // ---------------------------------------------------------------------------
+    sections.push(``);
+    sections.push(`declare module "vigiles/spec" {`);
+    if (linters.length > 0) {
+        sections.push(`  interface KnownLinterRules {`);
+        for (const { linter, rules } of linters) {
+            sections.push(`    "${escapeForUnion(linter)}": ${formatUnion(rules, "      ")};`);
+        }
+        sections.push(`  }`);
+    }
+    if (files.length > 0) {
+        sections.push(`  interface KnownProjectFiles {`);
+        sections.push(`    files: ${formatUnion(files, "      ")};`);
+        sections.push(`  }`);
+    }
+    if (scripts.length > 0) {
+        sections.push(`  interface KnownNpmScripts {`);
+        sections.push(`    scripts: ${formatUnion(scripts, "      ")};`);
+        sections.push(`  }`);
+    }
+    sections.push(`}`);
+    sections.push(``);
+    return {
+        dts: sections.join("\n"),
+        linters,
+        scripts,
+        files,
+    };
+}
+//# sourceMappingURL=generate-types.js.map

package/dist/generate-types.js.map

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

package/dist/inline.d.ts

@@ -0,0 +1,58 @@
+/**
+ * vigiles — Inline rule mode for gradual adoption.
+ *
+ * Parses `<!-- vigiles:enforce <linter>/<rule> "<why>" -->` HTML comments
+ * out of any markdown file, so a project can adopt vigiles one rule at a
+ * time without committing to a .spec.ts compile step. Every inline rule
+ * goes through the same `checkLinterRule` verification as rules declared
+ * in a .spec.ts — typos get closest-match suggestions, disabled rules are
+ * flagged, etc.
+ *
+ * Only `enforce` is supported inline. `guidance` would be a tautology: if
+ * you're editing the markdown, the prose around the comment already is
+ * the guidance — there's nothing extra for a tool to render.
+ *
+ * A file is in "inline mode" iff it contains at least one vigiles:enforce
+ * comment. Spec mode (`.md.spec.ts` sibling) takes precedence if both
+ * exist; the spec compiler emits a fresh file that may overwrite the
+ * inline markup, so users should pick one per file.
+ */
+export interface InlineRule {
+    /** Linter rule reference, e.g. "eslint/no-console". */
+    linterRule: string;
+    /** Why this rule is enforced (human-readable, shown in agent context). */
+    why: string;
+    /** 1-based line number of the comment in the source file. */
+    line: number;
+}
+export interface InlineParseResult {
+    rules: InlineRule[];
+    /** Lines that look like vigiles: markers but failed to parse. */
+    errors: {
+        line: number;
+        message: string;
+        raw: string;
+    }[];
+}
+/**
+ * Parse inline vigiles rules out of a markdown file's contents.
+ * Does not touch the filesystem and does not verify the rules against
+ * any linter — callers can feed the returned rules into
+ * `checkLinterRule` themselves.
+ *
+ * Lines inside fenced code blocks (``` ... ``` or ~~~ ... ~~~) are
+ * skipped so illustrative examples in docs don't get treated as live
+ * rules.
+ */
+export declare function parseInlineRules(content: string): InlineParseResult;
+/**
+ * True if the content contains at least one parseable vigiles:enforce
+ * rule (ignoring fenced code blocks and malformed markers). Used by
+ * `require-spec` validation to treat inline mode as spec-equivalent.
+ *
+ * Deliberately delegates to `parseInlineRules` so a loose prefix regex
+ * can't satisfy require-spec with a malformed marker that produces no
+ * real enforceable rule.
+ */
+export declare function hasInlineRules(content: string): boolean;
+//# sourceMappingURL=inline.d.ts.map

package/dist/inline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../src/inline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,iEAAiE;IACjE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1D;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAuFnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/inline.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * vigiles — Inline rule mode for gradual adoption.
+ *
+ * Parses `<!-- vigiles:enforce <linter>/<rule> "<why>" -->` HTML comments
+ * out of any markdown file, so a project can adopt vigiles one rule at a
+ * time without committing to a .spec.ts compile step. Every inline rule
+ * goes through the same `checkLinterRule` verification as rules declared
+ * in a .spec.ts — typos get closest-match suggestions, disabled rules are
+ * flagged, etc.
+ *
+ * Only `enforce` is supported inline. `guidance` would be a tautology: if
+ * you're editing the markdown, the prose around the comment already is
+ * the guidance — there's nothing extra for a tool to render.
+ *
+ * A file is in "inline mode" iff it contains at least one vigiles:enforce
+ * comment. Spec mode (`.md.spec.ts` sibling) takes precedence if both
+ * exist; the spec compiler emits a fresh file that may overwrite the
+ * inline markup, so users should pick one per file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseInlineRules = parseInlineRules;
+exports.hasInlineRules = hasInlineRules;
+/**
+ * Match `<!-- vigiles:enforce <linter>/<rule> "<why>" -->`. The linter
+ * reference allows the same characters as the TS-side `SAFE_RULE_NAME_RE`
+ * plus `@` for scoped plugin names (e.g. `@typescript-eslint/...`).
+ * The `why` is a simple quoted string — if someone wants newlines or
+ * embedded quotes, they can move to spec mode.
+ */
+const ENFORCE_RE = /<!--\s*vigiles:enforce\s+([@A-Za-z0-9_/:.-]+)\s+"([^"\n]*)"\s*-->/;
+/**
+ * Detects any `<!-- vigiles:<kind> -->` comment (valid or not) so we can
+ * surface errors for typos and reserved-but-unrecognized kinds. Uses a
+ * non-greedy match for the tail so a `-` inside the kind doesn't short-
+ * circuit the pattern.
+ */
+const MARKER_RE = /<!--\s*vigiles:([A-Za-z_-]+)[^]*?-->/;
+/**
+ * Parse inline vigiles rules out of a markdown file's contents.
+ * Does not touch the filesystem and does not verify the rules against
+ * any linter — callers can feed the returned rules into
+ * `checkLinterRule` themselves.
+ *
+ * Lines inside fenced code blocks (``` ... ``` or ~~~ ... ~~~) are
+ * skipped so illustrative examples in docs don't get treated as live
+ * rules.
+ */
+function parseInlineRules(content) {
+    const rules = [];
+    const errors = [];
+    const lines = content.split("\n");
+    let fenceChar = null;
+    let fenceLen = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Track fenced code blocks. CommonMark allows ``` or ~~~ fences
+        // with 3+ characters; the closing fence must use the same char and
+        // have length >= the opening fence's length. Info-string tokens
+        // after the opener are allowed.
+        const fenceMatch = /^(\s{0,3})(`{3,}|~{3,})(.*)$/.exec(line);
+        if (fenceMatch) {
+            const marker = fenceMatch[2];
+            const ch = marker[0];
+            const len = marker.length;
+            if (fenceChar === null) {
+                fenceChar = ch;
+                fenceLen = len;
+                continue;
+            }
+            else if (ch === fenceChar && len >= fenceLen) {
+                // Closing fence — trailing info-string is not allowed per
+                // CommonMark; only treat it as a close if the rest of the
+                // line is whitespace.
+                if (fenceMatch[3].trim() === "") {
+                    fenceChar = null;
+                    fenceLen = 0;
+                    continue;
+                }
+            }
+        }
+        if (fenceChar !== null) {
+            // Inside a code block — ignore any vigiles markers on this line.
+            continue;
+        }
+        // Strip inline code spans (backtick-wrapped text) so illustrative
+        // markers in prose like `<!-- vigiles:enforce ... -->` don't get
+        // parsed. CommonMark opens with N backticks and closes with exactly
+        // N, so the backreference handles matching-length spans.
+        const scannable = line.replace(/(`+)[\s\S]*?\1/g, (m) => " ".repeat(m.length));
+        const enforceMatch = ENFORCE_RE.exec(scannable);
+        if (enforceMatch) {
+            rules.push({
+                linterRule: enforceMatch[1],
+                why: enforceMatch[2],
+                line: i + 1,
+            });
+            continue;
+        }
+        // Skip the compiled-file hash header (`<!-- vigiles:sha256:... -->`)
+        // entirely — it's not a rule marker and should not be reported.
+        if (/<!--\s*vigiles:sha\d+:/.test(scannable))
+            continue;
+        const markerMatch = MARKER_RE.exec(scannable);
+        if (markerMatch) {
+            // Looks like a vigiles marker but didn't parse as enforce —
+            // surface it so users catch typos like "vigile:enforce" or
+            // unquoted why.
+            const kind = markerMatch[1];
+            if (kind === "enforce") {
+                errors.push({
+                    line: i + 1,
+                    message: 'Malformed vigiles:enforce — expected `<!-- vigiles:enforce <linter>/<rule> "<why>" -->`',
+                    raw: line.trim(),
+                });
+            }
+            else if (kind !== "disable" && kind !== "ignore") {
+                // `vigiles:disable ...` / `vigiles:ignore ...` are reserved for
+                // future disable-comment support; don't complain about them.
+                errors.push({
+                    line: i + 1,
+                    message: `Unknown vigiles marker "${kind}". Only \`vigiles:enforce\` is supported.`,
+                    raw: line.trim(),
+                });
+            }
+        }
+    }
+    return { rules, errors };
+}
+/**
+ * True if the content contains at least one parseable vigiles:enforce
+ * rule (ignoring fenced code blocks and malformed markers). Used by
+ * `require-spec` validation to treat inline mode as spec-equivalent.
+ *
+ * Deliberately delegates to `parseInlineRules` so a loose prefix regex
+ * can't satisfy require-spec with a malformed marker that produces no
+ * real enforceable rule.
+ */
+function hasInlineRules(content) {
+    return parseInlineRules(content).rules.length > 0;
+}
+//# sourceMappingURL=inline.js.map

package/dist/inline.js.map

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

package/dist/inline.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for the inline-rule parser.
+ */
+export {};
+//# sourceMappingURL=inline.test.d.ts.map

package/dist/inline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.test.d.ts","sourceRoot":"","sources":["../src/inline.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}