@kogu/context-check 0.1.0

package/dist/output/terminal.js

@@ -0,0 +1,163 @@
+/**
+ * Terminal renderer (Spec §9, §28).
+ *
+ * Human-readable, non-fake-precision output (Spec §4.5). Findings are grouped
+ * and summarized; `verbose` expands each finding with explanation. Command
+ * output must never say "wasted tokens", "unused" or imply causal impact.
+ */
+/** Wraps the normative label in brackets, e.g. INFO -> [INFO]. */
+function label(finding) {
+    return `[${finding.label}]`;
+}
+/** Formats a full report for the terminal. */
+export function renderReport(report, verbose = false) {
+    const lines = [];
+    lines.push("context-check");
+    lines.push("");
+    lines.push("AI CONFIGURATION REPORT");
+    lines.push("");
+    const s = report.summary;
+    lines.push(`Configuration files       ${s.configurationFiles}`);
+    lines.push(`Skills                    ${s.skills}`);
+    lines.push(`Estimated context     ${formatTokens(s.estimatedTokens)} tokens`);
+    lines.push("");
+    lines.push("Potential Context Overhead");
+    lines.push(`~${formatTokens(s.potentialContextOverhead)} tokens`);
+    lines.push("");
+    lines.push("FINDINGS");
+    if (report.findings.length === 0) {
+        lines.push("");
+        lines.push("No findings to report.");
+    }
+    else {
+        for (const finding of report.findings) {
+            lines.push("");
+            lines.push(`${label(finding)} ${finding.title}`);
+            if (verbose) {
+                lines.push(finding.description);
+                if (finding.recommendation)
+                    lines.push(finding.recommendation);
+            }
+        }
+    }
+    lines.push("");
+    if (!verbose) {
+        lines.push("Run `context-check analyze --verbose` for details.");
+    }
+    return lines.join("\n");
+}
+/** Formats a token count with thousands separators, e.g. 14820 -> "14,820". */
+export function formatTokens(tokens) {
+    return Math.round(tokens).toLocaleString("en-US");
+}
+/**
+ * Compact human renderer — answers "how many, how big, what needs attention"
+ * at a glance. Pure presentation: it renders the same `AnalysisReport` the
+ * terminal renderer uses, adding no analysis behavior.
+ */
+export function renderCompactReport(report) {
+    const s = report.summary;
+    const lines = [];
+    lines.push("ContextCheck");
+    lines.push("");
+    lines.push(`${s.configurationFiles} configuration files`);
+    lines.push(`~${formatTokens(s.estimatedTokens)} estimated tokens`);
+    lines.push("");
+    lines.push(`${report.findings.length} ${plural(report.findings.length, "finding")}`);
+    if (report.findings.length > 0) {
+        lines.push("");
+        for (const finding of report.findings) {
+            lines.push(`${label(finding)} ${finding.title}`);
+            for (const path of finding.filePaths) {
+                lines.push(`  ${path}`);
+            }
+            const detail = compactDetail(finding);
+            if (detail)
+                lines.push(`  ${detail}`);
+        }
+    }
+    else {
+        lines.push("");
+        lines.push("No findings to report.");
+    }
+    lines.push("");
+    lines.push(`Summary: ${s.configurationFiles} files · ${formatTokens(s.estimatedTokens)} tokens · ` +
+        `${report.findings.length} ${plural(report.findings.length, "finding")}`);
+    return lines.join("\n");
+}
+/** Simple singula/plural helper for output. */
+function plural(n, word) {
+    return n === 1 ? word : `${word}s`;
+}
+/** Short one-line detail per finding for compact output. */
+function compactDetail(finding) {
+    switch (finding.type) {
+        case "large-file": {
+            const m = finding.description.match(/~([\d,]+) tokens/);
+            return m ? `~${m[1]} tokens` : "large";
+        }
+        case "scoped-no-match":
+            return "no matching file changes in Git history window";
+        case "high-stakes":
+            return "review manually before modifying or removing";
+        case "duplicate":
+            return "identical content across files";
+        case "repetition":
+            return "section repeated across files";
+        case "context-overhead":
+            return "potential redundant context";
+        default:
+            return "";
+    }
+}
+/** Renders a snapshot diff in the Snapshot/Diff v1 format. */
+export function renderDiff(diff, beforeLabel = "previous", afterLabel = "current") {
+    const lines = [];
+    lines.push("ContextCheck Diff");
+    lines.push("");
+    lines.push(`Snapshot: ${beforeLabel} → ${afterLabel}`);
+    lines.push("");
+    lines.push("Artifacts");
+    const changedFiles = diff.files.filter((f) => f.status !== "unchanged");
+    if (changedFiles.length === 0) {
+        lines.push("  (no configuration file changes)");
+    }
+    else {
+        for (const file of changedFiles) {
+            const mark = file.status === "added" ? "+" : file.status === "removed" ? "-" : "~";
+            lines.push(`  ${mark} ${file.path}`);
+            if (file.status === "changed") {
+                lines.push(`     ${formatTokens(file.beforeTokens)} → ${formatTokens(file.afterTokens)} tokens`);
+            }
+        }
+    }
+    lines.push("");
+    lines.push("Context");
+    lines.push(`  Previous  ~${formatTokens(diff.beforeTokens)} tokens`);
+    lines.push(`  Current   ~${formatTokens(diff.afterTokens)} tokens`);
+    const deltaSign = diff.delta >= 0 ? "+" : "-";
+    lines.push(`  Change    ${deltaSign}${formatTokens(Math.abs(diff.delta))} tokens`);
+    lines.push("");
+    lines.push("Findings");
+    if (diff.findingChanges.unchanged === 0 && diff.findings.length === 0) {
+        lines.push("  (no findings recorded)");
+    }
+    else {
+        if (diff.findingChanges.changed > 0)
+            lines.push(`  ~ ${diff.findingChanges.changed} changed`);
+        if (diff.findingChanges.added > 0)
+            lines.push(`  + ${diff.findingChanges.added} new`);
+        if (diff.findingChanges.removed > 0)
+            lines.push(`  - ${diff.findingChanges.removed} resolved`);
+        if (diff.findingChanges.unchanged > 0)
+            lines.push(`  = ${diff.findingChanges.unchanged} unchanged`);
+    }
+    lines.push("");
+    const added = changedFiles.filter((f) => f.status === "added").length;
+    const changed = changedFiles.filter((f) => f.status === "changed").length;
+    const removed = changedFiles.filter((f) => f.status === "removed").length;
+    lines.push(`Summary`);
+    lines.push(`  ${added} added · ${changed} modified · ${removed} removed`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=terminal.js.map

package/dist/output/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/output/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,kEAAkE;AAClE,SAAS,KAAK,CAAC,OAAgB;IAC7B,OAAO,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC;AAC9B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,MAAsB,EAAE,OAAO,GAAG,KAAK;IAClE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,yBAAyB,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEvB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBAChC,IAAI,OAAO,CAAC,cAAc;oBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IACzB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,kBAAkB,sBAAsB,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CACzE,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACjD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC1B,CAAC;YACD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,YAAY,CAAC,CAAC,kBAAkB,YAAY,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY;QACrF,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAC3E,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+CAA+C;AAC/C,SAAS,MAAM,CAAC,CAAS,EAAE,IAAY;IACrC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AACrC,CAAC;AAED,4DAA4D;AAC5D,SAAS,aAAa,CAAC,OAAgB;IACrC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACxD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QACzC,CAAC;QACD,KAAK,iBAAiB;YACpB,OAAO,gDAAgD,CAAC;QAC1D,KAAK,aAAa;YAChB,OAAO,8CAA8C,CAAC;QACxD,KAAK,WAAW;YACd,OAAO,gCAAgC,CAAC;QAC1C,KAAK,YAAY;YACf,OAAO,+BAA+B,CAAC;QACzC,KAAK,kBAAkB;YACrB,OAAO,6BAA6B,CAAC;QACvC;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CACxB,IAAkB,EAClB,WAAW,GAAG,UAAU,EACxB,UAAU,GAAG,SAAS;IAEtB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,aAAa,WAAW,MAAM,UAAU,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IACxE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,MAAM,IAAI,GACR,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CACR,QAAQ,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CACrF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,gBAAgB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,gBAAgB,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9C,KAAK,CAAC,IAAI,CACR,eAAe,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CACvE,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,IAAI,IAAI,CAAC,cAAc,CAAC,SAAS,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,UAAU,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,GAAG,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,MAAM,CAAC,CAAC;QACrD,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,WAAW,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,cAAc,CAAC,SAAS,GAAG,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,YAAY,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACtE,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC1E,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,YAAY,OAAO,eAAe,OAAO,UAAU,CAAC,CAAC;IAE1E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/parser/frontmatter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * YAML frontmatter extraction (Spec §17).
+ *
+ * Frontmatter is an optional `---`-delimited block at the very start of a
+ * file. It is stripped from the body before analysis (Rule 22) and parsed
+ * into an object so adapter/analyzer logic can read keys such as `globs`,
+ * `alwaysApply` and `description`.
+ *
+ * The parser never mutates content and tolerates malformed YAML: on a parse
+ * error it returns the raw body so the analyzer can still produce partial
+ * results (Spec §34).
+ */
+export interface FrontmatterResult {
+    /** Parsed YAML object, or undefined when there is no valid frontmatter. */
+    data?: Record<string, unknown>;
+    /** Document body with the frontmatter block removed (CRLF normalized). */
+    body: string;
+    /** True when a `---` block was present but failed to parse. */
+    invalid?: boolean;
+}
+/**
+ * Extracts and parses the leading YAML frontmatter block, returning the data
+ * and the remaining body. Uses a line-based scan so empty frontmatter blocks
+ * and mixed EOL styles are handled consistently.
+ */
+export declare function extractFrontmatter(content: string): FrontmatterResult;

package/dist/parser/frontmatter.js

@@ -0,0 +1,63 @@
+/**
+ * YAML frontmatter extraction (Spec §17).
+ *
+ * Frontmatter is an optional `---`-delimited block at the very start of a
+ * file. It is stripped from the body before analysis (Rule 22) and parsed
+ * into an object so adapter/analyzer logic can read keys such as `globs`,
+ * `alwaysApply` and `description`.
+ *
+ * The parser never mutates content and tolerates malformed YAML: on a parse
+ * error it returns the raw body so the analyzer can still produce partial
+ * results (Spec §34).
+ */
+import { parse as parseYaml } from "yaml";
+const DELIMITER = "---";
+/**
+ * Extracts and parses the leading YAML frontmatter block, returning the data
+ * and the remaining body. Uses a line-based scan so empty frontmatter blocks
+ * and mixed EOL styles are handled consistently.
+ */
+export function extractFrontmatter(content) {
+    const lines = content.split(/\r\n|[\r\n]/);
+    if (lines.length === 0)
+        return { body: content };
+    if (lines[0]?.trim() !== DELIMITER) {
+        return { body: content };
+    }
+    // Find the closing delimiter line. Scan from line 1 onward; the body starts
+    // after it. If none is found, treat frontmatter as absent (partial result).
+    let closeIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i]?.trim() === DELIMITER) {
+            closeIndex = i;
+            break;
+        }
+    }
+    if (closeIndex === -1) {
+        return { body: content, invalid: true };
+    }
+    const rawBlock = lines.slice(1, closeIndex).join("\n").trim();
+    const body = lines
+        .slice(closeIndex + 1)
+        .join("\n")
+        .replace(/\r\n?/g, "\n");
+    if (rawBlock.length === 0) {
+        return { body, data: {} };
+    }
+    try {
+        const parsed = parseYaml(rawBlock);
+        if (parsed == null) {
+            return { body, data: {} };
+        }
+        return { body, data: isRecord(parsed) ? parsed : {} };
+    }
+    catch {
+        // Malformed YAML: keep the body so analysis can continue (Spec §34).
+        return { body, invalid: true };
+    }
+}
+/** Whether every key we care about should be treated as an object. */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/parser/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/parser/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAW1C,MAAM,SAAS,GAAG,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAEjD,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACnC,UAAU,GAAG,CAAC,CAAC;YACf,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAK;SACf,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;SACrB,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE3B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/parser/markdown.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Markdown section extraction (Spec §18).
+ *
+ * Splits markdown content into sections keyed by heading. A section is
+ * `heading + content` accumulated from a heading down to (but excluding) the
+ * next heading of the same or higher level. Repetition detection compares
+ * heading + normalized content.
+ *
+ * Parsing never mutates content. Malformed/heading-less text still produces a
+ * usable single-block result so analysis continues (Spec §34).
+ */
+export interface MarkdownSection {
+    /** The heading text (without the leading `#` markers). */
+    heading: string;
+    /** Heading level, e.g. 1 for `#`, 2 for `##`. */
+    level: number;
+    /** Raw section content between this heading and the next heading. */
+    content: string;
+}
+/** Extracts sections from a markdown body. */
+export declare function extractMarkdownSections(body: string): MarkdownSection[];
+/** Text before the first heading, if any (e.g. a preamble). */
+export declare function extractPreamble(body: string): string;

package/dist/parser/markdown.js

@@ -0,0 +1,63 @@
+/**
+ * Markdown section extraction (Spec §18).
+ *
+ * Splits markdown content into sections keyed by heading. A section is
+ * `heading + content` accumulated from a heading down to (but excluding) the
+ * next heading of the same or higher level. Repetition detection compares
+ * heading + normalized content.
+ *
+ * Parsing never mutates content. Malformed/heading-less text still produces a
+ * usable single-block result so analysis continues (Spec §34).
+ */
+const HEADING_RE = /^(#{1,6})\s+(.+)$/;
+/** Extracts sections from a markdown body. */
+export function extractMarkdownSections(body) {
+    const rawLines = body.split(/\r\n|[\r\n]/);
+    const sections = [];
+    let currentHeading = null;
+    let currentLevel = 0;
+    let currentHeadingLine = -1;
+    for (let i = 0; i < rawLines.length; i++) {
+        const line = rawLines[i] ?? "";
+        const match = line.match(HEADING_RE);
+        if (match) {
+            // Close the previous section before opening a new one.
+            if (currentHeading !== null) {
+                sections.push({
+                    heading: currentHeading,
+                    level: currentLevel,
+                    content: rawLines
+                        .slice(currentHeadingLine + 1, i)
+                        .join("\n")
+                        .trim(),
+                });
+            }
+            currentHeading = (match[2] ?? "").trim();
+            currentLevel = (match[1] ?? "").length;
+            currentHeadingLine = i;
+            continue;
+        }
+    }
+    // Close the trailing section.
+    if (currentHeading !== null) {
+        sections.push({
+            heading: currentHeading,
+            level: currentLevel,
+            content: rawLines
+                .slice(currentHeadingLine + 1)
+                .join("\n")
+                .trim(),
+        });
+    }
+    return sections;
+}
+/** Text before the first heading, if any (e.g. a preamble). */
+export function extractPreamble(body) {
+    const rawLines = body.split(/\r\n|[\r\n]/);
+    let end = 0;
+    while (end < rawLines.length && !rawLines[end]?.match(HEADING_RE)) {
+        end++;
+    }
+    return rawLines.slice(0, end).join("\n").trim();
+}
+//# sourceMappingURL=markdown.js.map

package/dist/parser/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/parser/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,8CAA8C;AAC9C,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAsB,EAAE,CAAC;IAEvC,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAErC,IAAI,KAAK,EAAE,CAAC;YACV,uDAAuD;YACvD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,cAAc;oBACvB,KAAK,EAAE,YAAY;oBACnB,OAAO,EAAE,QAAQ;yBACd,KAAK,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC,CAAC;yBAChC,IAAI,CAAC,IAAI,CAAC;yBACV,IAAI,EAAE;iBACV,CAAC,CAAC;YACL,CAAC;YAED,cAAc,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,YAAY,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACvC,kBAAkB,GAAG,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,QAAQ;iBACd,KAAK,CAAC,kBAAkB,GAAG,CAAC,CAAC;iBAC7B,IAAI,CAAC,IAAI,CAAC;iBACV,IAAI,EAAE;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,GAAG,EAAE,CAAC;IACR,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/parser/normalize.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Body normalization shared by duplicate/repetition detection (Spec §18, §19).
+ *
+ * Comparison is deterministic and text-based. Normalization:
+ * - lowercase
+ * - line-ending normalization (CRLF -> LF)
+ * - whitespace collapse
+ * - markdown formatting normalization (trim lines, drop trailing spaces)
+ *
+ * The MVP does NOT use semantic similarity (Rule 13).
+ */
+/** Strips YAML frontmatter and returns only the document body. */
+export declare function stripFrontmatter(content: string): string;
+/**
+ * Normalizes text for comparison: lowercase, LF line endings, collapsed
+ * whitespace, trailing-space-trimmed lines.
+ */
+export declare function normalizeForComparison(text: string): string;
+/** Computes a stable fingerprint (normalized body) for duplicate detection. */
+export declare function normalizeBody(content: string): string;

package/dist/parser/normalize.js

@@ -0,0 +1,35 @@
+/**
+ * Body normalization shared by duplicate/repetition detection (Spec §18, §19).
+ *
+ * Comparison is deterministic and text-based. Normalization:
+ * - lowercase
+ * - line-ending normalization (CRLF -> LF)
+ * - whitespace collapse
+ * - markdown formatting normalization (trim lines, drop trailing spaces)
+ *
+ * The MVP does NOT use semantic similarity (Rule 13).
+ */
+import { extractFrontmatter } from "./frontmatter.js";
+/** Strips YAML frontmatter and returns only the document body. */
+export function stripFrontmatter(content) {
+    return extractFrontmatter(content).body;
+}
+/**
+ * Normalizes text for comparison: lowercase, LF line endings, collapsed
+ * whitespace, trailing-space-trimmed lines.
+ */
+export function normalizeForComparison(text) {
+    return text
+        .replace(/\r\n?/g, "\n")
+        .toLowerCase()
+        .split("\n")
+        .map((line) => line.replace(/\s+/g, " ").trim())
+        .join("\n")
+        .trim();
+}
+/** Computes a stable fingerprint (normalized body) for duplicate detection. */
+export function normalizeBody(content) {
+    const body = stripFrontmatter(content);
+    return normalizeForComparison(body);
+}
+//# sourceMappingURL=normalize.js.map

package/dist/parser/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/parser/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,WAAW,EAAE;SACb,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;SAC/C,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/parser/parse.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Parsing orchestration (Spec §16, §17).
+ *
+ * Combines frontmatter, scope, markdown and plain-text parsers to produce a
+ * single normalized view of a configuration file's content.
+ *
+ * The parser never mutates source content. Malformed input degrades to a
+ * partial result so the analyzer can continue (Spec §34).
+ */
+import type { ConfigurationScope } from "../types/configuration.js";
+import { type MarkdownSection } from "./markdown.js";
+import { type TextBlock } from "./plain-text.js";
+export interface ParsedConfiguration {
+    /** Parsed frontmatter data (undefined when none/invalid). */
+    data?: Record<string, unknown>;
+    /** Document body with frontmatter removed. */
+    body: string;
+    /** Normalized scope derived from frontmatter. */
+    scope?: ConfigurationScope;
+    /** Markdown sections (empty for heading-less files). */
+    sections: MarkdownSection[];
+    /** Plain-text blocks (empty for markdown files with headings). */
+    blocks: TextBlock[];
+    /** True when frontmatter was present but malformed. */
+    invalidFrontmatter: boolean;
+}
+/**
+ * Builds a normalized view of content.
+ *
+ * - Files authored in markdown (instruction, skill, .mdc rules) are split into
+ *   sections by headings; the plain-text block chunker is used as a fallback
+ *   when there are no headings (Rule 21).
+ */
+export declare function parseConfiguration(content: string): ParsedConfiguration;

package/dist/parser/parse.js

@@ -0,0 +1,35 @@
+/**
+ * Parsing orchestration (Spec §16, §17).
+ *
+ * Combines frontmatter, scope, markdown and plain-text parsers to produce a
+ * single normalized view of a configuration file's content.
+ *
+ * The parser never mutates source content. Malformed input degrades to a
+ * partial result so the analyzer can continue (Spec §34).
+ */
+import { extractFrontmatter } from "./frontmatter.js";
+import { extractMarkdownSections } from "./markdown.js";
+import { chunkPlainText } from "./plain-text.js";
+import { parseScope } from "./scope.js";
+/**
+ * Builds a normalized view of content.
+ *
+ * - Files authored in markdown (instruction, skill, .mdc rules) are split into
+ *   sections by headings; the plain-text block chunker is used as a fallback
+ *   when there are no headings (Rule 21).
+ */
+export function parseConfiguration(content) {
+    const { data, body, invalid } = extractFrontmatter(content);
+    const scope = parseScope(data);
+    const sections = extractMarkdownSections(body);
+    const hasHeadings = sections.length > 0;
+    return {
+        data,
+        body,
+        scope,
+        sections,
+        blocks: hasHeadings ? [] : chunkPlainText(body),
+        invalidFrontmatter: invalid === true,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parser/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/parser/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAwB,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiBxC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAExC,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,QAAQ;QACR,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC;QAC/C,kBAAkB,EAAE,OAAO,KAAK,IAAI;KACrC,CAAC;AACJ,CAAC"}

package/dist/parser/plain-text.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Plain-text block chunking (Spec §18 "Plain-text fallback").
+ *
+ * For files without markdown headings (e.g. `.cursorrules`), fall back to
+ * paragraph/block-based chunking:
+ *   1. split on blank lines into paragraphs/blocks
+ *   2. ignore very short blocks
+ *   3. normalize whitespace
+ *   4. compare normalized blocks
+ *
+ * The MVP does NOT use semantic similarity: only exact normalized text blocks
+ * are considered repetition candidates (Rule 21).
+ */
+/** Blocks shorter than this many characters are ignored as noise. */
+export declare const MIN_BLOCK_CHARS = 8;
+export interface TextBlock {
+    /** Whitespace-normalized text used for comparison. */
+    normalized: string;
+    /** The block's raw text. */
+    raw: string;
+    /** Starting line index (0-based) in the original content. */
+    startLine: number;
+}
+/** Normalizes a block: collapse whitespace and trim. */
+export declare function normalizeBlock(text: string): string;
+/**
+ * Splits plain text into blocks separated by one or more blank lines.
+ * Empty and very short blocks are dropped per Spec §18 step 2.
+ */
+export declare function chunkPlainText(text: string): TextBlock[];

package/dist/parser/plain-text.js

@@ -0,0 +1,52 @@
+/**
+ * Plain-text block chunking (Spec §18 "Plain-text fallback").
+ *
+ * For files without markdown headings (e.g. `.cursorrules`), fall back to
+ * paragraph/block-based chunking:
+ *   1. split on blank lines into paragraphs/blocks
+ *   2. ignore very short blocks
+ *   3. normalize whitespace
+ *   4. compare normalized blocks
+ *
+ * The MVP does NOT use semantic similarity: only exact normalized text blocks
+ * are considered repetition candidates (Rule 21).
+ */
+/** Blocks shorter than this many characters are ignored as noise. */
+export const MIN_BLOCK_CHARS = 8;
+/** Normalizes a block: collapse whitespace and trim. */
+export function normalizeBlock(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+/**
+ * Splits plain text into blocks separated by one or more blank lines.
+ * Empty and very short blocks are dropped per Spec §18 step 2.
+ */
+export function chunkPlainText(text) {
+    const lines = text.split(/\r\n|[\r\n]/);
+    const blocks = [];
+    let buffer = [];
+    let bufferStart = 0;
+    function flush() {
+        if (buffer.length === 0)
+            return;
+        const raw = buffer.join("\n").trim();
+        const normalized = normalizeBlock(raw);
+        if (normalized.trim().length >= MIN_BLOCK_CHARS) {
+            blocks.push({ normalized, raw, startLine: bufferStart });
+        }
+        buffer = [];
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const isBlank = (lines[i] ?? "").trim().length === 0;
+        if (isBlank) {
+            flush();
+            continue;
+        }
+        if (buffer.length === 0)
+            bufferStart = i;
+        buffer.push(lines[i] ?? "");
+    }
+    flush();
+    return blocks;
+}
+//# sourceMappingURL=plain-text.js.map

package/dist/parser/plain-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-text.js","sourceRoot":"","sources":["../../src/parser/plain-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAWjC,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACxC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,IAAI,MAAM,GAAa,EAAE,CAAC;IAC1B,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,SAAS,KAAK;QACZ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;QACrD,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,WAAW,GAAG,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,EAAE,CAAC;IACR,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/parser/scope.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Scope normalization (Spec §16, §17).
+ *
+ * Reads a parsed frontmatter object and produces a `ConfigurationScope`:
+ * - `patterns`: from `globs` (an array of strings, or a single string)
+ * - `alwaysApply`: a boolean flag
+ *
+ * Unknown/malformed values are ignored rather than guessed; the analyzer
+ * still treats the artifact as unscoped rather than inventing precision.
+ */
+import type { ConfigurationScope } from "../types/configuration.js";
+/** Normalizes `globs` from YAML into a string array. */
+export declare function parsePatterns(value: unknown): string[] | undefined;
+/** Normalizes `alwaysApply` from YAML into a boolean. */
+export declare function parseAlwaysApply(value: unknown): boolean | undefined;
+/**
+ * Builds a `ConfigurationScope` from parsed frontmatter data. Returns
+ * undefined when no usable scope information is present.
+ */
+export declare function parseScope(data: Record<string, unknown> | undefined): ConfigurationScope | undefined;

package/dist/parser/scope.js

@@ -0,0 +1,44 @@
+/**
+ * Scope normalization (Spec §16, §17).
+ *
+ * Reads a parsed frontmatter object and produces a `ConfigurationScope`:
+ * - `patterns`: from `globs` (an array of strings, or a single string)
+ * - `alwaysApply`: a boolean flag
+ *
+ * Unknown/malformed values are ignored rather than guessed; the analyzer
+ * still treats the artifact as unscoped rather than inventing precision.
+ */
+/** Normalizes `globs` from YAML into a string array. */
+export function parsePatterns(value) {
+    if (typeof value === "string" && value.trim().length > 0) {
+        return [value.trim()];
+    }
+    if (Array.isArray(value)) {
+        const patterns = value.filter((v) => typeof v === "string" && v.trim().length > 0);
+        return patterns.length > 0 ? patterns : undefined;
+    }
+    return undefined;
+}
+/** Normalizes `alwaysApply` from YAML into a boolean. */
+export function parseAlwaysApply(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+/**
+ * Builds a `ConfigurationScope` from parsed frontmatter data. Returns
+ * undefined when no usable scope information is present.
+ */
+export function parseScope(data) {
+    if (!data)
+        return undefined;
+    const patterns = parsePatterns(data["globs"]);
+    const alwaysApply = parseAlwaysApply(data["alwaysApply"]);
+    if (patterns === undefined && alwaysApply === undefined)
+        return undefined;
+    const scope = {};
+    if (patterns !== undefined)
+        scope.patterns = patterns;
+    if (alwaysApply !== undefined)
+        scope.alwaysApply = alwaysApply;
+    return scope;
+}
+//# sourceMappingURL=scope.js.map