@isaacriehm/cairn-core 0.1.0

package/dist/init/visual.js.map

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

package/dist/init/walker.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Repo walker — produces a structural inventory the init mapper consumes.
+ *
+ * Walks the adopted project's working tree at adoption time, respecting
+ * `.gitignore` (via `git ls-files --cached --others --exclude-standard`
+ * when a git repo is present) and a hardcoded set of vendored / generated
+ * directory names.
+ *
+ * Two-pass priority walk:
+ *   • Pass 1 — high-signal source trees (any path with a segment in
+ *     HIGH_SIGNAL_DIRS: src, lib, app, pages, components, services,
+ *     controllers, routes, models, schemas, domain). No depth limit so
+ *     deeply nested src/auth/services/guards/*.ts is reachable. Cap 500.
+ *   • Pass 2 — everything else, depth ≤ 6. Cap 200. (Shallow config /
+ *     manifests / top-level docs.)
+ *   • Overall belt-and-suspenders cap: 3000. If exceeded, Pass 2 truncates
+ *     before Pass 1.
+ *
+ * No prompts, no LLM calls, no side effects beyond reading files. Output is
+ * a `RepoSummary` of:
+ *   - top-level entries
+ *   - file-count breakdowns by extension and by top-level dir
+ *   - manifest previews (package.json / pyproject.toml / Gemfile / go.mod /
+ *     Cargo.toml / mix.exs / deno.json / etc., first 80 lines each)
+ *   - notable files (README, schema.prisma, openapi.{json,yaml}, Dockerfile,
+ *     compose, AGENTS.md, etc.)
+ *   - notable directories whose name matches common framework conventions
+ *     (controllers, routes, handlers, services, models, migrations, schema,
+ *     apps, packages, ...)
+ *   - framework signals scraped out of manifest deps
+ *
+ * The mapper turns this into the `<slug>:` extension block (route_handler_globs,
+ * dto_globs, generator_source_globs, high_stakes_globs, off_limits_globs,
+ * pilot_module, key_modules, proposed_sensors, domain_summary).
+ */
+export interface ManifestPreview {
+    path: string;
+    preview: string;
+}
+export interface RepoSummary {
+    repo_root: string;
+    total_files: number;
+    total_dirs: number;
+    truncated_at_file_cap: boolean;
+    truncated_at_depth_cap: boolean;
+    used_git_ls_files: boolean;
+    top_level: string[];
+    package_manifests: ManifestPreview[];
+    by_extension: Record<string, number>;
+    by_top_dir: Record<string, number>;
+    notable_files: string[];
+    notable_dir_paths: string[];
+    framework_signals: string[];
+}
+export interface BuildRepoSummaryOptions {
+    repoRoot: string;
+    /**
+     * Hard cap on Pass-1 (high-signal-dir) file count. Default 500.
+     */
+    pass1Cap?: number;
+    /**
+     * Hard cap on Pass-2 (other) file count. Default 200.
+     */
+    pass2Cap?: number;
+    /**
+     * Max directory depth for Pass 2 (paths NOT under a high-signal dir).
+     * Pass 1 has no depth limit. Default 6.
+     */
+    pass2DepthCap?: number;
+    /**
+     * Backwards-compat alias for `pass2DepthCap`. Older callers (smokes, the
+     * `cairn scope rebuild` command) used `depthCap` against the legacy
+     * single-pass walker. Treated as `pass2DepthCap` so they keep working.
+     */
+    depthCap?: number;
+    /**
+     * Belt-and-suspenders total cap. Default 3000. If exceeded, Pass 2 is
+     * truncated first.
+     */
+    fileCap?: number;
+}
+export declare function buildRepoSummary(opts: BuildRepoSummaryOptions): RepoSummary;

package/dist/init/walker.js

@@ -0,0 +1,585 @@
+/**
+ * Repo walker — produces a structural inventory the init mapper consumes.
+ *
+ * Walks the adopted project's working tree at adoption time, respecting
+ * `.gitignore` (via `git ls-files --cached --others --exclude-standard`
+ * when a git repo is present) and a hardcoded set of vendored / generated
+ * directory names.
+ *
+ * Two-pass priority walk:
+ *   • Pass 1 — high-signal source trees (any path with a segment in
+ *     HIGH_SIGNAL_DIRS: src, lib, app, pages, components, services,
+ *     controllers, routes, models, schemas, domain). No depth limit so
+ *     deeply nested src/auth/services/guards/*.ts is reachable. Cap 500.
+ *   • Pass 2 — everything else, depth ≤ 6. Cap 200. (Shallow config /
+ *     manifests / top-level docs.)
+ *   • Overall belt-and-suspenders cap: 3000. If exceeded, Pass 2 truncates
+ *     before Pass 1.
+ *
+ * No prompts, no LLM calls, no side effects beyond reading files. Output is
+ * a `RepoSummary` of:
+ *   - top-level entries
+ *   - file-count breakdowns by extension and by top-level dir
+ *   - manifest previews (package.json / pyproject.toml / Gemfile / go.mod /
+ *     Cargo.toml / mix.exs / deno.json / etc., first 80 lines each)
+ *   - notable files (README, schema.prisma, openapi.{json,yaml}, Dockerfile,
+ *     compose, AGENTS.md, etc.)
+ *   - notable directories whose name matches common framework conventions
+ *     (controllers, routes, handlers, services, models, migrations, schema,
+ *     apps, packages, ...)
+ *   - framework signals scraped out of manifest deps
+ *
+ * The mapper turns this into the `<slug>:` extension block (route_handler_globs,
+ * dto_globs, generator_source_globs, high_stakes_globs, off_limits_globs,
+ * pilot_module, key_modules, proposed_sensors, domain_summary).
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { extname, join } from "node:path";
+const DEFAULT_OFF_LIMITS_DIRS = new Set([
+    ".git",
+    "node_modules",
+    "dist",
+    "build",
+    "target",
+    "out",
+    "__pycache__",
+    "vendor",
+    ".venv",
+    ".direnv",
+    ".cache",
+    "coverage",
+    ".next",
+    ".turbo",
+    ".nuxt",
+    ".svelte-kit",
+    ".astro",
+    ".parcel-cache",
+    ".vercel",
+    ".netlify",
+    ".pytest_cache",
+    ".mypy_cache",
+    ".ruff_cache",
+    ".tox",
+    ".gradle",
+    ".idea",
+    ".vscode",
+    ".cairn",
+    ".archive",
+]);
+/**
+ * Per-pass + total caps. Per-pass caps keep the mapper prompt focused; the
+ * 3000 total is a forward-looking safety net (the per-pass sum is well below
+ * it but kept so future cap raises don't bypass a single bound).
+ */
+const HIGH_SIGNAL_DIRS = new Set([
+    "src",
+    "lib",
+    "app",
+    "pages",
+    "components",
+    "services",
+    "controllers",
+    "routes",
+    "models",
+    "schemas",
+    "domain",
+]);
+const DEFAULT_PASS1_CAP = 500;
+const DEFAULT_PASS2_CAP = 200;
+const DEFAULT_PASS2_DEPTH_CAP = 6;
+const DEFAULT_TOTAL_CAP = 3000;
+/** Legacy single-pass depth cap, retained for the fallback walker only. */
+const DEFAULT_DEPTH_CAP = 10;
+const MANIFEST_PREVIEW_LINES = 80;
+const MANIFEST_FILES = new Set([
+    "package.json",
+    "pyproject.toml",
+    "requirements.txt",
+    "Pipfile",
+    "Gemfile",
+    "go.mod",
+    "Cargo.toml",
+    "mix.exs",
+    "pom.xml",
+    "build.gradle",
+    "build.gradle.kts",
+    "composer.json",
+    "deno.json",
+    "deno.jsonc",
+    "Package.swift",
+]);
+const NOTABLE_FILE_PATTERNS = [
+    /^README(?:\.[a-z]+)?$/i,
+    /^ARCHITECTURE\.[a-z]+$/i,
+    /^DESIGN\.[a-z]+$/i,
+    /^AGENTS?\.md$/i,
+    /^CLAUDE\.md$/i,
+    /^schema\.prisma$/i,
+    /^openapi\.(?:json|yaml|yml)$/i,
+    /^docker-compose(?:\.[a-z0-9_-]+)?\.ya?ml$/i,
+    /^compose\.ya?ml$/i,
+    /^Dockerfile(?:\..+)?$/i,
+    /^drizzle\.config\.(?:ts|js|mts|mjs)$/i,
+    /^prisma\.config\.(?:ts|js)$/i,
+    /^next\.config\.(?:ts|js|mjs)$/i,
+    /^nest-cli\.json$/i,
+    /^astro\.config\.(?:ts|js|mjs)$/i,
+    /^remix\.config\.(?:ts|js|mjs)$/i,
+    /^tsconfig\.json$/i,
+    /^tsconfig\.base\.json$/i,
+    /^pnpm-workspace\.ya?ml$/i,
+    /^turbo\.json$/i,
+    /^nx\.json$/i,
+    /^manage\.py$/i,
+    /^alembic\.ini$/i,
+    /^Procfile$/i,
+];
+const NOTABLE_DIR_NAMES = new Set([
+    "migrations",
+    "schemas",
+    "schema",
+    "controllers",
+    "routes",
+    "handlers",
+    "services",
+    "models",
+    "domain",
+    "core",
+    "apps",
+    "packages",
+    "src",
+    "lib",
+    "api",
+    "web",
+    "mobile",
+    "frontend",
+    "backend",
+    "server",
+    "client",
+    "auth",
+    "billing",
+    "payments",
+    "integrations",
+    "telephony",
+    "events",
+    "dto",
+    "dtos",
+    "guards",
+    "middlewares",
+    "middleware",
+    "queues",
+    "workers",
+]);
+export function buildRepoSummary(opts) {
+    const root = opts.repoRoot;
+    const pass1Cap = opts.pass1Cap ?? DEFAULT_PASS1_CAP;
+    const pass2Cap = opts.pass2Cap ?? DEFAULT_PASS2_CAP;
+    // pass2DepthCap explicit > legacy depthCap > default 6
+    const pass2DepthCap = opts.pass2DepthCap ?? opts.depthCap ?? DEFAULT_PASS2_DEPTH_CAP;
+    const fileCap = opts.fileCap ?? DEFAULT_TOTAL_CAP;
+    const { paths, dirs, truncatedFile, truncatedDepth, usedGit } = listFiles({
+        root,
+        pass1Cap,
+        pass2Cap,
+        pass2DepthCap,
+        fileCap,
+    });
+    return summarize({
+        root,
+        paths,
+        dirs,
+        truncatedFile,
+        truncatedDepth,
+        usedGit,
+    });
+}
+function listFiles(args) {
+    const fromGit = tryGitLsFiles(args.root);
+    if (fromGit !== null) {
+        return filterGitListing({ ...args, fromGit });
+    }
+    return walkFilesystem(args);
+}
+function isHighSignalPath(rel) {
+    for (const seg of rel.split("/")) {
+        if (HIGH_SIGNAL_DIRS.has(seg))
+            return true;
+    }
+    return false;
+}
+function addAncestors(dirs, rel) {
+    const segs = rel.split("/");
+    for (let i = 1; i <= segs.length - 1; i++) {
+        dirs.add(segs.slice(0, i).join("/"));
+    }
+}
+function tryGitLsFiles(root) {
+    if (!existsSync(join(root, ".git")))
+        return null;
+    // We need TWO listings unioned because git ls-files cannot combine
+    // `--recurse-submodules` with `--others` (git rejects it as "unsupported
+    // mode"). Without --recurse-submodules, submodule contents (initialized or
+    // not) never enumerate — `core/`, `platform/`, `site/` show as bare
+    // gitlink entries and the mapper sees none of their source.
+    //   1) `--cached --recurse-submodules` → tracked files including submodule contents
+    //   2) `--others --exclude-standard`    → untracked-but-not-ignored files at parent
+    const tracked = runGitLsFiles(root, [
+        "--cached",
+        "--recurse-submodules",
+    ]);
+    if (tracked === null)
+        return null;
+    const untracked = runGitLsFiles(root, ["--others", "--exclude-standard"]);
+    if (untracked === null)
+        return tracked;
+    // Dedup — `--cached` and `--others` are disjoint by definition, but
+    // submodule paths may appear in tracked as the bare gitlink in some git
+    // versions; a Set keeps us safe.
+    const set = new Set();
+    for (const p of tracked)
+        set.add(p);
+    for (const p of untracked)
+        set.add(p);
+    return [...set];
+}
+function runGitLsFiles(root, extraArgs) {
+    try {
+        const out = execFileSync("git", ["-C", root, "ls-files", ...extraArgs, "-z"], { encoding: "buffer", maxBuffer: 100 * 1024 * 1024 });
+        return out
+            .toString("utf8")
+            .split("\0")
+            .filter((s) => s.length > 0);
+    }
+    catch {
+        return null;
+    }
+}
+function filterGitListing(args) {
+    const dirs = new Set();
+    const pass1 = [];
+    const pass2 = [];
+    let pass1Hit = false;
+    let pass2Hit = false;
+    // Single sweep — partition each path into pass1 (high-signal) or pass2.
+    for (const rel of args.fromGit) {
+        const segs = rel.split("/");
+        if (segs.some((s) => DEFAULT_OFF_LIMITS_DIRS.has(s)))
+            continue;
+        if (isHighSignalPath(rel)) {
+            if (pass1.length >= args.pass1Cap) {
+                pass1Hit = true;
+                continue;
+            }
+            pass1.push(rel);
+            addAncestors(dirs, rel);
+        }
+        else {
+            if (segs.length - 1 > args.pass2DepthCap)
+                continue;
+            if (pass2.length >= args.pass2Cap) {
+                pass2Hit = true;
+                continue;
+            }
+            pass2.push(rel);
+            addAncestors(dirs, rel);
+        }
+    }
+    const { combined, totalHit } = applyTotalCap(pass1, pass2, args.fileCap);
+    return {
+        paths: combined,
+        dirs,
+        truncatedFile: pass1Hit || pass2Hit || totalHit,
+        truncatedDepth: false,
+        usedGit: true,
+    };
+}
+function walkFilesystem(args) {
+    const dirs = new Set();
+    const pass1 = [];
+    const pass2 = [];
+    let pass1Hit = false;
+    let pass2Hit = false;
+    let truncatedDepth = false;
+    const stack = [
+        { abs: args.root, rel: "", depth: 0, underHigh: false },
+    ];
+    while (stack.length > 0) {
+        const cur = stack.pop();
+        if (cur === undefined)
+            break;
+        let entries;
+        try {
+            entries = readdirSync(cur.abs);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            if (DEFAULT_OFF_LIMITS_DIRS.has(name))
+                continue;
+            const abs = join(cur.abs, name);
+            const rel = cur.rel === "" ? name : `${cur.rel}/${name}`;
+            let s;
+            try {
+                s = statSync(abs);
+            }
+            catch {
+                continue;
+            }
+            if (s.isDirectory()) {
+                const childUnderHigh = cur.underHigh || HIGH_SIGNAL_DIRS.has(name);
+                // Pass-2 depth cap: only enforced for non-high-signal subtrees.
+                if (!childUnderHigh && cur.depth + 1 > args.pass2DepthCap) {
+                    truncatedDepth = true;
+                    continue;
+                }
+                // Defensive belt: hard cap depth even under high-signal subtrees so
+                // a runaway symlink loop or pathological tree can't OOM us.
+                if (cur.depth + 1 > DEFAULT_DEPTH_CAP * 4) {
+                    truncatedDepth = true;
+                    continue;
+                }
+                dirs.add(rel);
+                stack.push({
+                    abs,
+                    rel,
+                    depth: cur.depth + 1,
+                    underHigh: childUnderHigh,
+                });
+            }
+            else if (s.isFile()) {
+                if (cur.underHigh) {
+                    if (pass1.length >= args.pass1Cap) {
+                        pass1Hit = true;
+                        continue;
+                    }
+                    pass1.push(rel);
+                }
+                else {
+                    if (pass2.length >= args.pass2Cap) {
+                        pass2Hit = true;
+                        continue;
+                    }
+                    pass2.push(rel);
+                }
+            }
+        }
+    }
+    const { combined, totalHit } = applyTotalCap(pass1, pass2, args.fileCap);
+    return {
+        paths: combined,
+        dirs,
+        truncatedFile: pass1Hit || pass2Hit || totalHit,
+        truncatedDepth,
+        usedGit: false,
+    };
+}
+function applyTotalCap(pass1, pass2, totalCap) {
+    const combined = [...pass1, ...pass2];
+    if (combined.length <= totalCap)
+        return { combined, totalHit: false };
+    // Drop Pass 2 first.
+    const room = Math.max(0, totalCap - pass1.length);
+    return {
+        combined: pass1.slice(0, totalCap).concat(pass2.slice(0, room)),
+        totalHit: true,
+    };
+}
+function summarize(args) {
+    const byExt = {};
+    const byTopDir = {};
+    const manifests = [];
+    const notableFiles = [];
+    const topLevel = new Set();
+    for (const rel of args.paths) {
+        const segs = rel.split("/");
+        const top = segs[0];
+        if (top !== undefined)
+            topLevel.add(top);
+        if (segs.length > 1 && top !== undefined) {
+            byTopDir[top] = (byTopDir[top] ?? 0) + 1;
+        }
+        const ext = extname(rel).toLowerCase();
+        if (ext.length > 0)
+            byExt[ext] = (byExt[ext] ?? 0) + 1;
+        const fileName = segs[segs.length - 1] ?? "";
+        if (MANIFEST_FILES.has(fileName)) {
+            manifests.push({
+                path: rel,
+                preview: readPreview(join(args.root, rel), MANIFEST_PREVIEW_LINES),
+            });
+        }
+        if (NOTABLE_FILE_PATTERNS.some((p) => p.test(fileName))) {
+            notableFiles.push(rel);
+        }
+    }
+    const notableDirs = collectNotableDirs(args.dirs);
+    const frameworkSignals = detectFrameworkSignals(manifests);
+    return {
+        repo_root: args.root,
+        total_files: args.paths.length,
+        total_dirs: args.dirs.size,
+        truncated_at_file_cap: args.truncatedFile,
+        truncated_at_depth_cap: args.truncatedDepth,
+        used_git_ls_files: args.usedGit,
+        top_level: [...topLevel].sort(),
+        package_manifests: manifests,
+        by_extension: topN(byExt, 25),
+        by_top_dir: topN(byTopDir, 30),
+        notable_files: notableFiles.sort(),
+        notable_dir_paths: notableDirs.sort(),
+        framework_signals: frameworkSignals.sort(),
+    };
+}
+function collectNotableDirs(dirs) {
+    const out = [];
+    for (const dir of dirs) {
+        const segs = dir.split("/");
+        const last = (segs[segs.length - 1] ?? "").toLowerCase();
+        if (NOTABLE_DIR_NAMES.has(last))
+            out.push(dir);
+    }
+    return out;
+}
+function readPreview(path, maxLines) {
+    try {
+        const text = readFileSync(path, "utf8");
+        return text.split("\n").slice(0, maxLines).join("\n");
+    }
+    catch {
+        return "";
+    }
+}
+function topN(m, n) {
+    const sorted = Object.entries(m)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, n);
+    const out = {};
+    for (const [k, v] of sorted)
+        out[k] = v;
+    return out;
+}
+const TS_FRAMEWORKS = [
+    "next",
+    "@nestjs/core",
+    "@nestjs/common",
+    "express",
+    "fastify",
+    "hono",
+    "@trpc/server",
+    "drizzle-orm",
+    "@prisma/client",
+    "kysely",
+    "@apollo/server",
+    "apollo-server",
+    "react",
+    "vue",
+    "svelte",
+    "vite",
+    "astro",
+    "remix",
+    "@sveltejs/kit",
+    "nuxt",
+    "@tanstack/router",
+    "@tanstack/react-router",
+    "tailwindcss",
+    "react-native",
+    "expo",
+    "electron",
+    "stripe",
+    "discord.js",
+    "zod",
+    "graphql",
+    "@effect/platform",
+];
+const PY_FRAMEWORKS = [
+    "fastapi",
+    "django",
+    "flask",
+    "starlette",
+    "pydantic",
+    "sqlalchemy",
+    "alembic",
+    "celery",
+    "pytest",
+    "ruff",
+    "mypy",
+    "uvicorn",
+    "tortoise-orm",
+];
+const RB_FRAMEWORKS = [
+    "rails",
+    "sinatra",
+    "sidekiq",
+    "rspec",
+    "rubocop",
+    "hanami",
+    "grape",
+];
+const GO_FRAMEWORKS = [
+    "gin-gonic/gin",
+    "go-chi/chi",
+    "labstack/echo",
+    "gofiber/fiber",
+    "gorm.io/gorm",
+    "sqlc-dev/sqlc",
+    "uber-go/zap",
+    "google/wire",
+];
+const RUST_FRAMEWORKS = [
+    "axum",
+    "actix-web",
+    "rocket",
+    "warp",
+    "tower",
+    "sqlx",
+    "diesel",
+    "sea-orm",
+    "tokio",
+];
+function detectFrameworkSignals(manifests) {
+    const signals = new Set();
+    for (const m of manifests) {
+        const fileName = m.path.split("/").pop() ?? "";
+        const text = m.preview;
+        if (fileName === "package.json") {
+            for (const f of TS_FRAMEWORKS) {
+                if (new RegExp(`"${escapeReg(f)}"\\s*:`, "i").test(text))
+                    signals.add(f);
+            }
+        }
+        else if (fileName === "pyproject.toml" ||
+            fileName === "requirements.txt" ||
+            fileName === "Pipfile") {
+            for (const f of PY_FRAMEWORKS) {
+                if (new RegExp(`\\b${escapeReg(f)}\\b`, "i").test(text))
+                    signals.add(f);
+            }
+        }
+        else if (fileName === "Gemfile") {
+            for (const f of RB_FRAMEWORKS) {
+                if (new RegExp(`gem\\s+["']${escapeReg(f)}["']`, "i").test(text)) {
+                    signals.add(f);
+                }
+            }
+        }
+        else if (fileName === "go.mod") {
+            for (const f of GO_FRAMEWORKS) {
+                if (text.includes(f))
+                    signals.add(f);
+            }
+        }
+        else if (fileName === "Cargo.toml") {
+            for (const f of RUST_FRAMEWORKS) {
+                if (new RegExp(`\\b${escapeReg(f)}\\s*=`, "i").test(text))
+                    signals.add(f);
+            }
+        }
+    }
+    return [...signals];
+}
+function escapeReg(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=walker.js.map