@isaacriehm/cairn-core 0.1.0

package/dist/init/baseline-audit.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Phase 6.4 — baseline sensor sweep.
+ *
+ * Runs every sensor that can operate without an LLM call or an external
+ * command against a synthetic "every file added at SHA-zero" diff. Each
+ * finding is pre-Cairn debt, not a hard failure: the audit yaml is
+ * surfaced through `cairn attention` later.
+ */
+import { type ProjectGlobs, type SensorLanguage } from "../sensors/index.js";
+export interface BaselineAuditFinding {
+    sensor_id: string;
+    path: string;
+    line: number;
+    message: string;
+    severity: "hard" | "soft";
+}
+export interface BaselineAuditSensorRow {
+    sensor_id: string;
+    finding_count: number;
+    findings: BaselineAuditFinding[];
+    /** Set when the sensor's runnable implementation is missing — captured for transparency. */
+    unsupported?: boolean;
+}
+export interface BaselineAuditResult {
+    /** Absolute path to the audit yaml. */
+    auditPath: string;
+    /** Repo-relative path used in completion summary. */
+    auditRelPath: string;
+    /** ISO timestamp captured at write time. */
+    runAt: string;
+    /** One row per sensor that was attempted. */
+    sensors: BaselineAuditSensorRow[];
+    /** Sum of finding counts (severity:soft + hard). */
+    totalFindings: number;
+    /** Number of source files synthesized into the audit diff. */
+    filesScanned: number;
+    /** Sensor IDs that ran clean. */
+    cleanSensorIds: string[];
+    /** Sensor IDs that produced at least one finding. */
+    dirtySensorIds: string[];
+    /** Sensor IDs skipped (LLM/external/etc). */
+    skippedSensorIds: string[];
+}
+export interface RunBaselineAuditArgs {
+    repoRoot: string;
+    /** Globs the route-handler / dto sensors scope to — usually mapper output. */
+    projectGlobs: ProjectGlobs;
+    /** Languages active for this profile. Defaults derived from stack signatures. */
+    languages: SensorLanguage[];
+    /** Per-sensor progress callback. */
+    onSensorProgress?: (row: {
+        sensor_id: string;
+        finding_count: number;
+        skipped: boolean;
+        error: string | null;
+    }) => void;
+    /** Skip filesystem write — smokes only. */
+    dryRun?: boolean;
+}
+export declare function runBaselineAudit(args: RunBaselineAuditArgs): Promise<BaselineAuditResult>;
+/**
+ * Returns the path of the most recent baseline audit yaml, or null when the
+ * baseline directory is empty/missing. Used by the SessionStart onboarding
+ * injection to decide whether to fire.
+ */
+export declare function findLatestBaselineAudit(repoRoot: string): {
+    path: string;
+    runAt: string | null;
+} | null;
+/** Internal helper exposed for smoke cairn — language list from project. */
+export declare function defaultBaselineLanguages(stackKinds: string[] | undefined): SensorLanguage[];

package/dist/init/baseline-audit.js

@@ -0,0 +1,377 @@
+/**
+ * Phase 6.4 — baseline sensor sweep.
+ *
+ * Runs every sensor that can operate without an LLM call or an external
+ * command against a synthetic "every file added at SHA-zero" diff. Each
+ * finding is pre-Cairn debt, not a hard failure: the audit yaml is
+ * surfaced through `cairn attention` later.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { simpleGit } from "simple-git";
+import { stringify as stringifyYaml, parse as parseYaml } from "yaml";
+import { loadSensorRegistry, loadStubCatalog, runDtoNoFakeFields, runRouteHandlerNonEmpty, runStubCatalog, } from "../sensors/index.js";
+import { logger } from "../logger.js";
+const log = logger("init.baseline-audit");
+const MAX_FILE_BYTES = 1_000_000; // skip lock files / minified bundles
+const SOURCE_EXTS = new Set([
+    ".ts",
+    ".tsx",
+    ".cts",
+    ".mts",
+    ".js",
+    ".jsx",
+    ".cjs",
+    ".mjs",
+    ".py",
+    ".rb",
+    ".go",
+    ".rs",
+    ".sql",
+]);
+const SKIP_DIR_SEGMENTS = new Set([
+    "node_modules",
+    "dist",
+    "build",
+    "out",
+    ".next",
+    ".turbo",
+    ".cache",
+    "coverage",
+    ".cairn",
+    ".archive",
+    ".git",
+]);
+/** Sensors we never run during baseline — they need inputs init can't supply. */
+const BASELINE_SKIP_IDS = new Set([
+    "attestation-cross-check",
+    "generator-drift",
+    "decision-assertions",
+    "invariant-suite",
+    "reviewer-subagent",
+    "e2e-real-db",
+    "uat-headless-chrome",
+    "frontmatter-freshness",
+    "local-dirty-overlap",
+]);
+/* -------------------------------------------------------------------------- */
+/* Synthetic diff                                                             */
+/* -------------------------------------------------------------------------- */
+async function listRepoSourceFiles(repoRoot) {
+    // git ls-files honors .gitignore. --cached + untracked + recurse into submodules.
+    try {
+        const git = simpleGit({ baseDir: repoRoot });
+        const cached = await git.raw([
+            "ls-files",
+            "--cached",
+            "--recurse-submodules",
+        ]);
+        const others = await git.raw([
+            "ls-files",
+            "--others",
+            "--exclude-standard",
+        ]);
+        const combined = `${cached}\n${others}`;
+        return uniqueFilter(combined);
+    }
+    catch (err) {
+        log.warn({ err: err instanceof Error ? err.message : String(err) }, "git ls-files failed; baseline audit will scan an empty fileset");
+        return [];
+    }
+}
+function uniqueFilter(blob) {
+    const out = new Set();
+    for (const raw of blob.split("\n")) {
+        const path = raw.trim();
+        if (path.length === 0)
+            continue;
+        if (path.includes(".."))
+            continue;
+        if (path.split("/").some((seg) => SKIP_DIR_SEGMENTS.has(seg)))
+            continue;
+        if (!hasSourceExt(path))
+            continue;
+        out.add(path);
+    }
+    return Array.from(out);
+}
+function hasSourceExt(path) {
+    const dot = path.lastIndexOf(".");
+    if (dot === -1)
+        return false;
+    return SOURCE_EXTS.has(path.slice(dot).toLowerCase());
+}
+function buildSyntheticDiff(repoRoot, paths) {
+    const out = [];
+    for (const path of paths) {
+        const abs = join(repoRoot, path);
+        let st;
+        try {
+            st = statSync(abs);
+        }
+        catch {
+            continue;
+        }
+        if (!st.isFile())
+            continue;
+        if (st.size > MAX_FILE_BYTES)
+            continue;
+        let text;
+        try {
+            text = readFileSync(abs, "utf8");
+        }
+        catch {
+            continue;
+        }
+        out.push({ path, status: "added", afterContent: text });
+    }
+    return out;
+}
+function runOneBaselineSensor(args) {
+    try {
+        if (args.id === "stub-pattern-catalog") {
+            const catalog = loadStubCatalog(args.repoRoot);
+            return {
+                result: runStubCatalog({
+                    diff: args.diff,
+                    catalog,
+                    languages: args.languages,
+                }),
+                unsupported: false,
+                errorMessage: null,
+            };
+        }
+        if (args.id === "route-handler-non-empty") {
+            return {
+                result: runRouteHandlerNonEmpty({
+                    diff: args.diff,
+                    globs: args.projectGlobs.route_handler_globs,
+                }),
+                unsupported: false,
+                errorMessage: null,
+            };
+        }
+        if (args.id === "dto-no-fake-fields") {
+            return {
+                result: runDtoNoFakeFields({
+                    diff: args.diff,
+                    globs: args.projectGlobs.dto_globs,
+                }),
+                unsupported: false,
+                errorMessage: null,
+            };
+        }
+        return { result: null, unsupported: true, errorMessage: null };
+    }
+    catch (err) {
+        return {
+            result: null,
+            unsupported: false,
+            errorMessage: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Orchestrator                                                               */
+/* -------------------------------------------------------------------------- */
+export async function runBaselineAudit(args) {
+    const registry = safeLoadRegistry(args.repoRoot);
+    const disabled = new Set(registry?.disabled_per_project ?? []);
+    const sensorIds = (registry?.sensors ?? [])
+        .map((s) => s.id)
+        .filter((id) => id.length > 0)
+        .filter((id) => !disabled.has(id));
+    // Stable sort: registry order preserved.
+    const filePaths = await listRepoSourceFiles(args.repoRoot);
+    const diff = buildSyntheticDiff(args.repoRoot, filePaths);
+    const sensors = [];
+    const skippedSensorIds = [];
+    const cleanSensorIds = [];
+    const dirtySensorIds = [];
+    let total = 0;
+    for (const id of sensorIds) {
+        if (BASELINE_SKIP_IDS.has(id)) {
+            skippedSensorIds.push(id);
+            sensors.push({
+                sensor_id: id,
+                finding_count: 0,
+                findings: [],
+                unsupported: true,
+            });
+            args.onSensorProgress?.({
+                sensor_id: id,
+                finding_count: 0,
+                skipped: true,
+                error: null,
+            });
+            continue;
+        }
+        const outcome = runOneBaselineSensor({
+            id,
+            diff,
+            repoRoot: args.repoRoot,
+            languages: args.languages,
+            projectGlobs: args.projectGlobs,
+        });
+        if (outcome.unsupported || outcome.result === null) {
+            skippedSensorIds.push(id);
+            sensors.push({
+                sensor_id: id,
+                finding_count: 0,
+                findings: [],
+                unsupported: true,
+            });
+            args.onSensorProgress?.({
+                sensor_id: id,
+                finding_count: 0,
+                skipped: true,
+                error: outcome.errorMessage,
+            });
+            continue;
+        }
+        const row = {
+            sensor_id: id,
+            finding_count: outcome.result.findings.length,
+            findings: outcome.result.findings.map(toBaselineFinding),
+        };
+        sensors.push(row);
+        total += row.finding_count;
+        if (row.finding_count === 0)
+            cleanSensorIds.push(id);
+        else
+            dirtySensorIds.push(id);
+        args.onSensorProgress?.({
+            sensor_id: id,
+            finding_count: row.finding_count,
+            skipped: false,
+            error: null,
+        });
+    }
+    // Allow inferred languages to widen detection if caller passed an empty list
+    // (some adoption paths may fail to detect any). Detection per file kicks
+    // back in on the next baseline run, which is cheap.
+    if (args.languages.length === 0 && diff.length > 0) {
+        log.warn({ sample: diff[0]?.path }, "baseline audit ran with empty languages list; stub-pattern catalog matched nothing");
+    }
+    const runAt = new Date().toISOString();
+    const auditRelPath = `.cairn/baseline/sensor-audit-${runAt
+        .replace(/[:.]/g, "-")
+        .slice(0, 19)}.yaml`;
+    const auditPath = join(args.repoRoot, auditRelPath);
+    if (args.dryRun !== true) {
+        writeAudit(auditPath, {
+            run_at: runAt,
+            sensors: sensors.map((s) => ({
+                sensor_id: s.sensor_id,
+                finding_count: s.finding_count,
+                findings: s.findings,
+                ...(s.unsupported === true ? { unsupported: true } : {}),
+            })),
+            total_findings: total,
+            files_scanned: diff.length,
+        });
+    }
+    return {
+        auditPath,
+        auditRelPath,
+        runAt,
+        sensors,
+        totalFindings: total,
+        filesScanned: diff.length,
+        cleanSensorIds,
+        dirtySensorIds,
+        skippedSensorIds,
+    };
+}
+function safeLoadRegistry(repoRoot) {
+    try {
+        return loadSensorRegistry(repoRoot);
+    }
+    catch (err) {
+        log.warn({ err: err instanceof Error ? err.message : String(err) }, "loadSensorRegistry failed; baseline audit returns empty");
+        return null;
+    }
+}
+function toBaselineFinding(f) {
+    return {
+        sensor_id: f.sensor_id,
+        path: f.path ?? "",
+        line: f.line ?? 0,
+        message: f.message,
+        severity: f.severity,
+    };
+}
+function writeAudit(absPath, payload) {
+    const dir = dirname(absPath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(absPath, stringifyYaml(payload), "utf8");
+}
+/* -------------------------------------------------------------------------- */
+/* Helpers exported for first-session detection                               */
+/* -------------------------------------------------------------------------- */
+/**
+ * Returns the path of the most recent baseline audit yaml, or null when the
+ * baseline directory is empty/missing. Used by the SessionStart onboarding
+ * injection to decide whether to fire.
+ */
+export function findLatestBaselineAudit(repoRoot) {
+    const dir = join(repoRoot, ".cairn", "baseline");
+    if (!existsSync(dir))
+        return null;
+    let entries;
+    try {
+        entries = readdirSync(dir, { encoding: "utf8" });
+    }
+    catch {
+        return null;
+    }
+    const matching = entries
+        .filter((name) => /^sensor-audit-.*\.yaml$/.test(name))
+        .sort();
+    const latest = matching.at(-1);
+    if (latest === undefined)
+        return null;
+    const abs = join(dir, latest);
+    let runAt = null;
+    try {
+        const parsed = parseYaml(readFileSync(abs, "utf8"));
+        if (typeof parsed["run_at"] === "string")
+            runAt = parsed["run_at"];
+    }
+    catch {
+        runAt = null;
+    }
+    return { path: abs, runAt };
+}
+/** Internal helper exposed for smoke cairn — language list from project. */
+export function defaultBaselineLanguages(stackKinds) {
+    if (stackKinds === undefined || stackKinds.length === 0) {
+        return ["typescript", "javascript", "python", "go", "ruby", "rust", "sql"];
+    }
+    const out = new Set();
+    for (const kind of stackKinds) {
+        if (kind === "typescript") {
+            out.add("typescript");
+            out.add("javascript");
+        }
+        else if (kind === "python") {
+            out.add("python");
+        }
+        else if (kind === "ruby") {
+            out.add("ruby");
+        }
+        else if (kind === "go") {
+            out.add("go");
+        }
+        else if (kind === "rust") {
+            out.add("rust");
+        }
+    }
+    if (out.size === 0) {
+        return ["typescript", "javascript", "python", "go", "ruby", "rust", "sql"];
+    }
+    out.add("sql");
+    return Array.from(out);
+}
+//# sourceMappingURL=baseline-audit.js.map

package/dist/init/baseline-audit.js.map

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

package/dist/init/brand-setup.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Phase 5b — interactive brand setup.
+ *
+ * After seedCairnLayout writes the templates with `status: draft`, ask the
+ * operator 4 quick questions and flip the answered files to `status: current`.
+ *
+ * Skipped questions stay draft. Ctrl+C / EOF anywhere mid-flow exits gracefully
+ * (whatever was answered before the abort sticks; the rest stay draft).
+ *
+ * Uses node:readline/promises — no new deps.
+ */
+export interface BrandAnswers {
+    /** Q1 → product/positioning.md body. */
+    whatItDoes: string;
+    /** Q2 → product/personas.yaml first persona stub. */
+    mainUsers: string;
+    /** Q3 → brand/voice.md body. */
+    voice: string;
+    /** Q4 → appended to brand/voice.md as "avoid:" section. */
+    avoid: string;
+}
+export interface RunBrandSetupOptions {
+    projectName: string;
+    /** Skip the prompts entirely — used by smokes / scripted adoption. */
+    skip?: boolean;
+    /** Pre-canned answers — used by smokes to assert the apply path. */
+    scriptedAnswers?: Partial<BrandAnswers>;
+}
+/**
+ * Run the 4-question wizard. Returns whatever answers the operator provided
+ * (empty string for skipped questions). Always resolves; never throws on
+ * Ctrl+C / EOF — the partial answers up to the abort are returned.
+ */
+export declare function runBrandSetup(opts: RunBrandSetupOptions): Promise<BrandAnswers>;
+/**
+ * Apply answers to the seeded templates. Empty answers are no-ops; only
+ * answered files flip from `status: draft` to `status: current`.
+ *
+ * Returns the list of files that were actually rewritten.
+ */
+export declare function applyBrandAnswers(repoRoot: string, answers: BrandAnswers): {
+    updated: string[];
+    warnings: string[];
+};