@kogu/context-check 0.1.0

package/dist/parser/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/parser/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACjE,CAAC;QACF,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAAyC;IAEzC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAE1D,IAAI,QAAQ,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1E,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,IAAI,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACtD,IAAI,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/snapshot/diff.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Diff calculation (Spec §30) — Snapshot/Diff v1.
+ *
+ * Compares two snapshots (or a snapshot against current state) and reports:
+ *  - per-file artifact changes (added / removed / modified)
+ *  - total context token delta
+ *  - analysis finding changes (added / resolved / changed)
+ *
+ * The value proposition is that a ContextCheck diff answers "the context layer
+ * changed, and as a result which analysis findings appeared / disappeared?"
+ * — NOT causal claims about model performance (Spec §28, Rule 28).
+ */
+import type { Finding, FindingType } from "../types/finding.js";
+import type { Snapshot, SnapshotEntry } from "./manager.js";
+export interface FileDiff {
+    path: string;
+    beforeTokens: number;
+    afterTokens: number;
+    delta: number;
+    status: "added" | "removed" | "changed" | "unchanged";
+}
+export type FindingChangeStatus = "added" | "removed" | "changed" | "unchanged";
+export interface FindingChange {
+    id: string;
+    type: FindingType;
+    status: FindingChangeStatus;
+    title: string;
+    filePaths: string[];
+}
+export interface FindingChangesSummary {
+    added: number;
+    removed: number;
+    changed: number;
+    unchanged: number;
+}
+export interface SnapshotDiff {
+    beforeTokens: number;
+    afterTokens: number;
+    delta: number;
+    files: FileDiff[];
+    addedFiles: string[];
+    removedFiles: string[];
+    findings: FindingChange[];
+    findingChanges: FindingChangesSummary;
+}
+/**
+ * Computes a diff between an older and a newer artifact set, plus analysis
+ * finding changes when finding arrays are supplied. Findings are optional so
+ * diffs against legacy snapshots (no stored findings) still work.
+ */
+export declare function diffSnapshots(before: SnapshotEntry[], after: SnapshotEntry[], beforeFindings?: readonly Finding[], afterFindings?: readonly Finding[]): SnapshotDiff;
+/**
+ * Finds finding changes between two artifact sets. Findings come from the
+ * stored snapshots (which now persist analysis findings alongside artifacts).
+ * Backward compatible: treats missing findings as an empty list.
+ *
+ * Finding identity: `id` (deterministic by type+paths+title).
+ */
+export declare function findFindingChanges(before: readonly Finding[], after: readonly Finding[]): FindingChange[];
+/** Formats a token count with thousands separators for display. */
+export declare function formatTokens(tokens: number): string;
+export declare function diffBetweenSnapshots(before: Snapshot, after: Snapshot): SnapshotDiff;

package/dist/snapshot/diff.js

@@ -0,0 +1,146 @@
+/**
+ * Diff calculation (Spec §30) — Snapshot/Diff v1.
+ *
+ * Compares two snapshots (or a snapshot against current state) and reports:
+ *  - per-file artifact changes (added / removed / modified)
+ *  - total context token delta
+ *  - analysis finding changes (added / resolved / changed)
+ *
+ * The value proposition is that a ContextCheck diff answers "the context layer
+ * changed, and as a result which analysis findings appeared / disappeared?"
+ * — NOT causal claims about model performance (Spec §28, Rule 28).
+ */
+function toTokenMap(artifacts) {
+    const map = {};
+    for (const a of artifacts)
+        map[a.path] = a;
+    return map;
+}
+/**
+ * Computes a diff between an older and a newer artifact set, plus analysis
+ * finding changes when finding arrays are supplied. Findings are optional so
+ * diffs against legacy snapshots (no stored findings) still work.
+ */
+export function diffSnapshots(before, after, beforeFindings, afterFindings) {
+    const beforeMap = toTokenMap(before);
+    const afterMap = toTokenMap(after);
+    const allPaths = [
+        ...new Set([...Object.keys(beforeMap), ...Object.keys(afterMap)]),
+    ].sort();
+    const files = [];
+    for (const path of allPaths) {
+        const b = beforeMap[path];
+        const a = afterMap[path];
+        const beforeTokens = b?.metadata.estimatedTokens ?? 0;
+        const afterTokens = a?.metadata.estimatedTokens ?? 0;
+        let status;
+        if (!b && a)
+            status = "added";
+        else if (b && !a)
+            status = "removed";
+        else if (beforeTokens !== afterTokens)
+            status = "changed";
+        else
+            status = "unchanged";
+        files.push({
+            path,
+            beforeTokens,
+            afterTokens,
+            delta: afterTokens - beforeTokens,
+            status,
+        });
+    }
+    const beforeTokens = sumTokens(before);
+    const afterTokens = sumTokens(after);
+    const findingChanges = findFindingChanges(beforeFindings ?? [], afterFindings ?? []);
+    return {
+        beforeTokens,
+        afterTokens,
+        delta: afterTokens - beforeTokens,
+        files,
+        addedFiles: files.filter((f) => f.status === "added").map((f) => f.path),
+        removedFiles: files
+            .filter((f) => f.status === "removed")
+            .map((f) => f.path),
+        findings: findingChanges,
+        findingChanges: summarizeFindingChanges(findingChanges),
+    };
+}
+function sumTokens(artifacts) {
+    return artifacts.reduce((s, a) => s + a.metadata.estimatedTokens, 0);
+}
+/**
+ * Finds finding changes between two artifact sets. Findings come from the
+ * stored snapshots (which now persist analysis findings alongside artifacts).
+ * Backward compatible: treats missing findings as an empty list.
+ *
+ * Finding identity: `id` (deterministic by type+paths+title).
+ */
+export function findFindingChanges(before, after) {
+    const beforeById = new Map(before.map((f) => [f.id, f]));
+    const afterById = new Map(after.map((f) => [f.id, f]));
+    const ids = new Set([...beforeById.keys(), ...afterById.keys()]);
+    const changes = [];
+    for (const id of ids) {
+        const b = beforeById.get(id);
+        const a = afterById.get(id);
+        if (a && !b)
+            changes.push(toChange(a, "added"));
+        else if (b && !a)
+            changes.push(toChange(b, "removed"));
+        else if (a)
+            changes.push(toChange(a, "unchanged"));
+    }
+    // Pair an added and a removed finding that share the same logical identity
+    // (type + file paths) but different id (title/text changed) as "changed".
+    const key = (c) => `${c.type}::${[...c.filePaths].sort().join(",")}`;
+    const byKey = new Map();
+    for (const c of changes) {
+        const k = key(c);
+        const list = byKey.get(k) ?? [];
+        list.push(c);
+        byKey.set(k, list);
+    }
+    for (const group of byKey.values()) {
+        const added = group.filter((c) => c.status === "added");
+        const removed = group.filter((c) => c.status === "removed");
+        while (added.length > 0 && removed.length > 0) {
+            const a = added.shift();
+            const r = removed.shift();
+            const idx = changes.indexOf(r);
+            if (idx !== -1)
+                changes.splice(idx, 1);
+            a.status = "changed";
+        }
+    }
+    return changes.sort((x, y) => x.status.localeCompare(y.status));
+}
+function toChange(f, status) {
+    return {
+        id: f.id,
+        type: f.type,
+        status,
+        title: f.title,
+        filePaths: f.filePaths,
+    };
+}
+function summarizeFindingChanges(changes) {
+    const summary = {
+        added: 0,
+        removed: 0,
+        changed: 0,
+        unchanged: 0,
+    };
+    for (const c of changes)
+        summary[c.status] += 1;
+    return summary;
+}
+/** Formats a token count with thousands separators for display. */
+export function formatTokens(tokens) {
+    return Math.round(tokens).toLocaleString("en-US");
+}
+// Convenience: full snapshot-level diff.
+export function diffBetweenSnapshots(before, after) {
+    return diffSnapshots(before.artifacts, after.artifacts, before.findings ?? [], after.findings ?? []);
+}
+//# sourceMappingURL=diff.js.map

package/dist/snapshot/diff.js.map

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

package/dist/snapshot/manager.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Snapshot storage (Spec §29, §30).
+ *
+ * A snapshot is a privacy-safe record of the AI configuration discovered in a
+ * repo at a point in time. It stores only path/type/scope/metadata — never raw
+ * content — so snapshots are safe to persist locally and share.
+ *
+ * Snapshots are stored as JSON files under `.contextcheck/snapshots/`.
+ */
+import type { ConfigurationArtifact } from "../types/configuration.js";
+import type { Finding } from "../types/finding.js";
+export declare const SNAPSHOT_DIR = ".contextcheck/snapshots";
+export declare const SNAPSHOT_EXTENSION = ".json";
+export interface SnapshotEntry {
+    id: string;
+    type: ConfigurationArtifact["type"];
+    path: string;
+    scope?: ConfigurationArtifact["scope"];
+    metadata: ConfigurationArtifact["metadata"];
+}
+export declare const SNAPSHOT_VERSION = 1;
+export interface Snapshot {
+    /** Schema version. Introduced in v2; legacy snapshots lack it -> treated as 1. */
+    version?: number;
+    id: string;
+    createdAt: string;
+    configurationFiles: number;
+    skills: number;
+    estimatedTokens: number;
+    artifacts: SnapshotEntry[];
+    /** Analysis findings at snapshot time. Optional for backward compatibility. */
+    findings?: Finding[];
+}
+/** Builds a snapshot from a discovery result + findings (content excluded). */
+export declare function buildSnapshot(artifacts: ConfigurationArtifact[], findings?: Finding[]): Snapshot;
+/** Stable filename-friendly id derived from the creation timestamp. */
+export declare function snapshotId(createdAt: string): string;
+/** Resolves the snapshots directory for a repo root. */
+export declare function snapshotsDir(rootPath: string): string;
+/** Persists a snapshot to `.contextcheck/snapshots/<id>.json`. */
+export declare function saveSnapshot(rootPath: string, snapshot: Snapshot): Promise<string>;
+/** Loads a single snapshot by file path. Throws if invalid. */
+export declare function loadSnapshotFile(filePath: string): Promise<Snapshot>;
+/** Lists snapshot file paths, newest last. Returns [] when none exist. */
+export declare function listSnapshotFiles(rootPath: string): Promise<string[]>;
+/** Returns the most recently created snapshot file path, if any. */
+export declare function latestSnapshotFile(rootPath: string): Promise<string | null>;
+/**
+ * Resolves a snapshot reference (exact id, unique id prefix, or a direct file
+ * path) to a snapshot file path. Returns null when no snapshot matches.
+ */
+export declare function resolveSnapshotRef(rootPath: string, ref: string): Promise<string | null>;
+/** Loads metadata for every snapshot, newest last. */
+export declare function listSnapshots(rootPath: string): Promise<Snapshot[]>;

package/dist/snapshot/manager.js

@@ -0,0 +1,131 @@
+/**
+ * Snapshot storage (Spec §29, §30).
+ *
+ * A snapshot is a privacy-safe record of the AI configuration discovered in a
+ * repo at a point in time. It stores only path/type/scope/metadata — never raw
+ * content — so snapshots are safe to persist locally and share.
+ *
+ * Snapshots are stored as JSON files under `.contextcheck/snapshots/`.
+ */
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { toArtifactJson } from "../output/json.js";
+export const SNAPSHOT_DIR = ".contextcheck/snapshots";
+export const SNAPSHOT_EXTENSION = ".json";
+export const SNAPSHOT_VERSION = 1;
+/** Builds a snapshot from a discovery result + findings (content excluded). */
+export function buildSnapshot(artifacts, findings = []) {
+    const entries = artifacts.map((a) => toArtifactJson(a));
+    const createdAt = new Date().toISOString();
+    return {
+        version: SNAPSHOT_VERSION,
+        id: snapshotId(createdAt),
+        createdAt,
+        configurationFiles: artifacts.length,
+        skills: artifacts.filter((a) => a.type === "skill").length,
+        estimatedTokens: artifacts.reduce((sum, a) => sum + a.metadata.estimatedTokens, 0),
+        artifacts: entries,
+        findings,
+    };
+}
+/** Stable filename-friendly id derived from the creation timestamp. */
+export function snapshotId(createdAt) {
+    const base = createdAt.replace(/[:.]/g, "-");
+    return `snap_${createHash("sha1").update(createdAt).digest("hex").slice(0, 6)}_${base}`;
+}
+/** Resolves the snapshots directory for a repo root. */
+export function snapshotsDir(rootPath) {
+    return join(rootPath, SNAPSHOT_DIR);
+}
+/** Persists a snapshot to `.contextcheck/snapshots/<id>.json`. */
+export async function saveSnapshot(rootPath, snapshot) {
+    const dir = snapshotsDir(rootPath);
+    await mkdir(dir, { recursive: true });
+    const file = join(dir, `${snapshot.id}${SNAPSHOT_EXTENSION}`);
+    await writeFile(file, JSON.stringify(snapshot, null, 2), "utf8");
+    return file;
+}
+/** Loads a single snapshot by file path. Throws if invalid. */
+export async function loadSnapshotFile(filePath) {
+    const text = await readFile(filePath, "utf8");
+    const parsed = JSON.parse(text);
+    if (!parsed.id || !Array.isArray(parsed.artifacts)) {
+        throw new Error(`Invalid snapshot: ${filePath}`);
+    }
+    return parsed;
+}
+/**
+ * Extracts the sortable timestamp portion from a snapshot filename. Ids are
+ * `snap_<hash>_<timestamp>`; the hash sorts before the timestamp, so sorting
+ * by full filename is NOT chronological. The trailing ISO-like timestamp is.
+ */
+function snapshotTimestampKey(filename) {
+    const idx = filename.lastIndexOf("_");
+    return idx === -1 ? filename : filename.slice(idx + 1);
+}
+/** Lists snapshot file paths, newest last. Returns [] when none exist. */
+export async function listSnapshotFiles(rootPath) {
+    const dir = snapshotsDir(rootPath);
+    let names;
+    try {
+        names = await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    return names
+        .filter((n) => n.endsWith(SNAPSHOT_EXTENSION))
+        .sort((a, b) => snapshotTimestampKey(a).localeCompare(snapshotTimestampKey(b)))
+        .map((n) => join(dir, n));
+}
+/** Returns the most recently created snapshot file path, if any. */
+export async function latestSnapshotFile(rootPath) {
+    const files = await listSnapshotFiles(rootPath);
+    if (files.length === 0)
+        return null;
+    // Sorted newest last by embedded timestamp.
+    return files[files.length - 1] ?? null;
+}
+/**
+ * Resolves a snapshot reference (exact id, unique id prefix, or a direct file
+ * path) to a snapshot file path. Returns null when no snapshot matches.
+ */
+export async function resolveSnapshotRef(rootPath, ref) {
+    // Direct file path (backward compatible with `diff <file>`).
+    const asPath = join(rootPath, SNAPSHOT_DIR, ref);
+    const files = await listSnapshotFiles(rootPath);
+    const exact = files.find((f) => basenameOf(f) === ref || f === ref || f === asPath);
+    if (exact)
+        return exact;
+    // Unique id prefix match. Match against the full id AND the short hash part.
+    const matches = files.filter((f) => {
+        const base = basenameOf(f).replace(SNAPSHOT_EXTENSION, "");
+        const short = base.split("_")[1] ?? "";
+        return (base === ref ||
+            base.startsWith(ref) ||
+            short === ref ||
+            short.startsWith(ref));
+    });
+    return matches.length === 1 ? matches[0] : null;
+}
+function basenameOf(filePath) {
+    const idx = Math.max(filePath.lastIndexOf("/"), filePath.lastIndexOf("\\"));
+    return idx === -1 ? filePath : filePath.slice(idx + 1);
+}
+/** Loads metadata for every snapshot, newest last. */
+export async function listSnapshots(rootPath) {
+    const files = await listSnapshotFiles(rootPath);
+    const snaps = [];
+    for (const file of files) {
+        try {
+            snaps.push(await loadSnapshotFile(file));
+        }
+        catch {
+            // Skip unreadable/corrupt snapshot rather than failing the whole list.
+        }
+    }
+    // Already newest-last; ensure by createdAt too.
+    return snaps.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+}
+//# sourceMappingURL=manager.js.map

package/dist/snapshot/manager.js.map

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

package/dist/tokens/estimator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Token estimation (Spec §21).
+ *
+ * Goal is NOT exact model billing; it is a stable, deterministic estimate so
+ * users can reason about how much context their configuration occupies.
+ *
+ * Minimal implementation: `estimatedTokens = characterCount / 4`. A
+ * provider-specific tokenizer adapter may replace this later without changing
+ * the public contract.
+ */
+/** Estimates the number of tokens in `text`. Always >= 0. */
+export declare function estimateTokens(text: string): number;

package/dist/tokens/estimator.js

@@ -0,0 +1,16 @@
+/**
+ * Token estimation (Spec §21).
+ *
+ * Goal is NOT exact model billing; it is a stable, deterministic estimate so
+ * users can reason about how much context their configuration occupies.
+ *
+ * Minimal implementation: `estimatedTokens = characterCount / 4`. A
+ * provider-specific tokenizer adapter may replace this later without changing
+ * the public contract.
+ */
+const CHARS_PER_TOKEN = 4;
+/** Estimates the number of tokens in `text`. Always >= 0. */
+export function estimateTokens(text) {
+    return Math.round(text.length / CHARS_PER_TOKEN);
+}
+//# sourceMappingURL=estimator.js.map

package/dist/tokens/estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimator.js","sourceRoot":"","sources":["../../src/tokens/estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;AACnD,CAAC"}

package/dist/types/configuration.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Normalized configuration model (Spec §16).
+ *
+ * Platform-specific files (CLAUDE.md, AGENTS.md, SKILL.md, .cursorrules,
+ * .cursor/rules/**) are normalized into this common shape so that analyzers
+ * and renderers never need to know which tool produced them.
+ */
+/**
+ * The kind of configuration artifact. Determines how the analyzer treats it
+ * and how the renderer labels it in output.
+ */
+export type ConfigurationType = "rule" | "skill" | "instruction" | "agent-config" | "unknown";
+/**
+ * Declares when/where a configuration applies. Populated from glob patterns
+ * and platform-specific "always apply" flags.
+ */
+export interface ConfigurationScope {
+    /** Glob patterns this configuration targets (e.g. `components/**\/*.tsx`). */
+    patterns?: string[];
+    /** Whether the configuration always applies regardless of path. */
+    alwaysApply?: boolean;
+}
+/** Lightweight metrics computed during parsing/normalization. */
+export interface ArtifactMetadata {
+    /** Exact byte size on disk. */
+    sizeBytes: number;
+    /** Token estimate (`chars / 4`). Filled by the token estimator (Phase 3). */
+    estimatedTokens: number;
+    /** Number of lines in the file. */
+    lineCount: number;
+}
+/**
+ * Internal representation of a discovered configuration file.
+ *
+ * NOTE: this is the full model including raw `content`. Never serialize this
+ * directly to JSON/CI output — use a privacy-safe DTO instead (Spec §33).
+ */
+export interface ConfigurationArtifact {
+    id: string;
+    type: ConfigurationType;
+    /** Path relative to the repository root. */
+    path: string;
+    /** Raw file content. Used only in-memory by analyzers. */
+    content: string;
+    scope?: ConfigurationScope;
+    metadata: ArtifactMetadata;
+}

package/dist/types/configuration.js

@@ -0,0 +1,9 @@
+/**
+ * Normalized configuration model (Spec §16).
+ *
+ * Platform-specific files (CLAUDE.md, AGENTS.md, SKILL.md, .cursorrules,
+ * .cursor/rules/**) are normalized into this common shape so that analyzers
+ * and renderers never need to know which tool produced them.
+ */
+export {};
+//# sourceMappingURL=configuration.js.map

package/dist/types/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/types/configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types/finding.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Finding model (Spec §12, §10).
+ *
+ * `type`, `label`, `severity` and `confidence` are distinct concepts:
+ * - type: the technical reason a finding was produced
+ * - label: the category shown to the user in the CLI
+ * - severity: how important the finding is
+ * - confidence: how reliable the detection method is
+ *
+ * The type -> label -> severity -> confidence mapping in the spec is
+ * NORMATIVE (Rule 17). Analyzers must not invent new values (Rule 27).
+ */
+/** Technical cause of the finding. */
+export type FindingType = "duplicate" | "repetition" | "large-file" | "scoped-no-match" | "high-stakes" | "context-overhead";
+/** Category shown in the CLI. */
+export type FindingLabel = "INFO" | "CONTEXT" | "REVIEW" | "CAUTION";
+/** Importance level. `warning` exists for future expansion only. */
+export type FindingSeverity = "info" | "notice" | "warning";
+/** Reliability of the detection method. */
+export type FindingConfidence = "high" | "medium" | "low";
+export interface Finding {
+    id: string;
+    type: FindingType;
+    label: FindingLabel;
+    severity: FindingSeverity;
+    confidence: FindingConfidence;
+    /** All files involved. Cross-file findings must list every path here. */
+    filePaths: string[];
+    title: string;
+    description: string;
+    recommendation?: string;
+}

package/dist/types/finding.js

@@ -0,0 +1,14 @@
+/**
+ * Finding model (Spec §12, §10).
+ *
+ * `type`, `label`, `severity` and `confidence` are distinct concepts:
+ * - type: the technical reason a finding was produced
+ * - label: the category shown to the user in the CLI
+ * - severity: how important the finding is
+ * - confidence: how reliable the detection method is
+ *
+ * The type -> label -> severity -> confidence mapping in the spec is
+ * NORMATIVE (Rule 17). Analyzers must not invent new values (Rule 27).
+ */
+export {};
+//# sourceMappingURL=finding.js.map

package/dist/types/finding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.js","sourceRoot":"","sources":["../../src/types/finding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/types/report.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Report model (Spec §12).
+ *
+ * Findings live at the report level, NOT inside individual artifacts
+ * (Rule 16). A configuration artifact only represents the configuration;
+ * it never embeds findings about itself.
+ */
+import type { ConfigurationArtifact } from "./configuration.js";
+import type { Finding } from "./finding.js";
+export interface AnalysisSummary {
+    configurationFiles: number;
+    skills: number;
+    estimatedTokens: number;
+    potentialContextOverhead: number;
+}
+export interface AnalysisReport {
+    summary: AnalysisSummary;
+    artifacts: ConfigurationArtifact[];
+    findings: Finding[];
+}

package/dist/types/report.js

@@ -0,0 +1,9 @@
+/**
+ * Report model (Spec §12).
+ *
+ * Findings live at the report level, NOT inside individual artifacts
+ * (Rule 16). A configuration artifact only represents the configuration;
+ * it never embeds findings about itself.
+ */
+export {};
+//# sourceMappingURL=report.js.map

package/dist/types/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/types/report.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}