@isaacriehm/cairn-state 0.22.5

package/dist/home.js

@@ -0,0 +1,168 @@
+/**
+ * Cairn state-home resolver — the single source of truth for *where* a repo's
+ * Cairn state lives. Committed mode (the default) returns `<repoRoot>/.cairn`,
+ * byte-for-byte today's behavior. Ghost mode returns an out-of-repo directory
+ * under `~/.cairn/state/<repo-id>/`, so nothing Cairn-shaped ever lands in the
+ * client tree.
+ *
+ * This is pure indirection: every `paths.ts` helper (and every other call site
+ * that used to hardcode `join(repoRoot, ".cairn", …)`) builds on `cairnHome`
+ * here. Centralizing the state location is a standalone win independent of
+ * ghost — it makes the location relocatable, testable, and a single seam.
+ *
+ * The resolver chicken-and-egg (the ghost flag normally lives in the config
+ * file, but in ghost that file is *inside* the out-of-repo home) is broken by a
+ * global registry outside any client repo: `~/.cairn/registry.yaml`.
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+/** Expand a leading `~` to the operator's home directory. */
+function expandTilde(p) {
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/"))
+        return join(homedir(), p.slice(2));
+    return p;
+}
+/**
+ * Global Cairn state home — `~/.cairn/state/`. Hardcoded (the operator hates
+ * env vars). Per-repo ghost state lives at `<stateHome>/<repo-id>/`, mirroring
+ * the in-repo `.cairn/` layout (`ground/`, `config.yaml`, `git-hooks/`, …) but
+ * physically outside every client repo tree.
+ */
+export function stateHome() {
+    return join(homedir(), ".cairn", "state");
+}
+/** `~/.cairn/state/<repoId>` — the out-of-repo home for one ghost repo. */
+export function ghostStateDir(repoId) {
+    return join(stateHome(), repoId);
+}
+/** `~/.cairn/registry.yaml` — the global repo→mode map, outside any repo. */
+export function registryPath() {
+    return join(homedir(), ".cairn", "registry.yaml");
+}
+/* -------------------------------------------------------------------------- */
+/* Resolution — memoized per process; registry-absent is the fast committed   */
+/* path (one existsSync, no git shell).                                       */
+/* -------------------------------------------------------------------------- */
+const homeCache = new Map();
+const ghostCache = new Map();
+/**
+ * Drop the memoized resolution for a repo (or all repos). Call after mutating
+ * the registry — e.g. `cairn init --ghost` registers a repo, then seed must
+ * resolve to the *new* out-of-repo home rather than a stale committed cache.
+ */
+export function invalidateCairnHomeCache(repoRoot) {
+    if (repoRoot) {
+        homeCache.delete(repoRoot);
+        ghostCache.delete(repoRoot);
+    }
+    else {
+        homeCache.clear();
+        ghostCache.clear();
+    }
+}
+/** Read `~/.cairn/registry.yaml`; null when absent/broken (→ committed). */
+export function readRegistry() {
+    const p = registryPath();
+    if (!existsSync(p))
+        return null;
+    try {
+        const doc = parseYaml(readFileSync(p, "utf8"));
+        return typeof doc === "object" && doc !== null ? doc : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The repo's root-commit SHA, or null (no git / no commits yet). */
+function rootCommit(repoRoot) {
+    try {
+        const out = execFileSync("git", ["-C", repoRoot, "rev-list", "--max-parents=0", "HEAD"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+        return out.trim().split(/\s+/)[0] || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The ghost registry entry for this repo, or null when committed. Prefers the
+ * move-stable root-commit identity (so moving/renaming the checkout doesn't
+ * orphan state), falling back to an absolute-path match for pre-first-commit
+ * repos.
+ */
+function ghostEntry(repoRoot) {
+    const reg = readRegistry();
+    if (!reg?.repos)
+        return null;
+    const ghosts = Object.values(reg.repos).filter((e) => e?.mode === "ghost");
+    if (ghosts.length === 0)
+        return null;
+    const rc = rootCommit(repoRoot);
+    if (rc) {
+        const byCommit = ghosts.find((e) => e.root_commit === rc);
+        if (byCommit)
+            return byCommit;
+    }
+    return ghosts.find((e) => e.last_path === repoRoot) ?? null;
+}
+/**
+ * Resolve the Cairn state home for a repo — the base every path helper builds
+ * on. Committed: `<repoRoot>/.cairn`. Ghost: the out-of-repo `state_dir`.
+ */
+export function cairnHome(repoRoot) {
+    const cached = homeCache.get(repoRoot);
+    if (cached !== undefined)
+        return cached;
+    const entry = ghostEntry(repoRoot);
+    const home = entry ? expandTilde(entry.state_dir) : join(repoRoot, ".cairn");
+    homeCache.set(repoRoot, home);
+    ghostCache.set(repoRoot, entry !== null);
+    return home;
+}
+/** True when this repo is registered ghost. Registry lookup, memoized. */
+export function isGhost(repoRoot) {
+    const cached = ghostCache.get(repoRoot);
+    if (cached !== undefined)
+        return cached;
+    cairnHome(repoRoot); // populates both caches
+    return ghostCache.get(repoRoot) ?? false;
+}
+/**
+ * `join(cairnHome(repoRoot), ...segments)` — the workhorse builder that
+ * replaces every `join(repoRoot, ".cairn", …)` outside `paths.ts`.
+ */
+export function cairnDir(repoRoot, ...segments) {
+    return join(cairnHome(repoRoot), ...segments);
+}
+/* -------------------------------------------------------------------------- */
+/* Registration — written once at adoption (cairn init --ghost / cairn-adopt) */
+/* -------------------------------------------------------------------------- */
+/**
+ * Register a repo as ghost in the global registry, keyed on its root-commit
+ * SHA (abs-path key fallback for pre-first-commit repos), and return the
+ * resolved out-of-repo state dir. Invalidates the resolver cache so subsequent
+ * `cairnHome` calls relocate immediately.
+ */
+export function registerGhostRepo(repoRoot) {
+    const rc = rootCommit(repoRoot);
+    const repoId = rc ?? repoRoot.replace(/[^A-Za-z0-9._-]/g, "_");
+    const entry = {
+        mode: "ghost",
+        state_dir: ghostStateDir(repoId),
+        last_path: repoRoot,
+        ...(rc ? { root_commit: rc } : {}),
+    };
+    const reg = readRegistry() ?? {};
+    reg.repos = reg.repos ?? {};
+    reg.repos[repoId] = entry;
+    const p = registryPath();
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, stringifyYaml(reg), "utf8");
+    invalidateCairnHomeCache(repoRoot);
+    return entry;
+}
+//# sourceMappingURL=home.js.map

package/dist/home.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+export * from "./schemas.js";
+export * from "./home.js";
+export * from "./paths.js";
+export * from "./ledgers.js";
+export * from "./archive.js";
+export * from "./anchor-map.js";
+export * from "./sot-bindings.js";
+export * from "./scope-index.js";
+export * from "./frontmatter.js";
+export * from "./text.js";
+export * from "./slug.js";
+export * from "./cache.js";
+export * from "./fs.js";
+export * from "./logger.js";
+export * from "./glob.js";
+export * from "./walk.js";
+export * from "./topic-index.js";
+export * from "./rejected.js";
+export * from "./quality-grades.js";
+export * from "./languages.js";
+export * from "./components.js";
+export * from "./component-registry.js";
+export * from "./config.js";
+export * from "./manifest.js";
+export * from "./file-candidates-map.js";
+export * from "./drift.js";
+export * from "./alignment-pending.js";
+export * from "./sot-cache.js";
+export * from "./missions.js";

package/dist/index.js

@@ -0,0 +1,30 @@
+export * from "./schemas.js";
+export * from "./home.js";
+export * from "./paths.js";
+export * from "./ledgers.js";
+export * from "./archive.js";
+export * from "./anchor-map.js";
+export * from "./sot-bindings.js";
+export * from "./scope-index.js";
+export * from "./frontmatter.js";
+export * from "./text.js";
+export * from "./slug.js";
+export * from "./cache.js";
+export * from "./fs.js";
+export * from "./logger.js";
+export * from "./glob.js";
+export * from "./walk.js";
+export * from "./topic-index.js";
+export * from "./rejected.js";
+export * from "./quality-grades.js";
+export * from "./languages.js";
+export * from "./components.js";
+export * from "./component-registry.js";
+export * from "./config.js";
+export * from "./manifest.js";
+export * from "./file-candidates-map.js";
+export * from "./drift.js";
+export * from "./alignment-pending.js";
+export * from "./sot-cache.js";
+export * from "./missions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/languages.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Language profile table — the single source of truth for every per-language
+ * mechanical fact Cairn needs: which extensions belong to a language, what
+ * comment forms a `@cairn` registry header may live in, how to pull the
+ * top-level exported/public symbols out of a source file, whether a file
+ * "looks like a reusable UI unit", and which style/class attributes its
+ * markup uses.
+ *
+ * Why a data table and not branching code: Cairn runs INSIDE an LLM coding
+ * agent, so semantic classification ("is this a component?", "what category?")
+ * is the model's job (see `detect-components.ts`). The *mechanical* facts —
+ * comment syntax, extension→language, export grammar — are pure lookup data
+ * that should be easy to extend by adding a row, never a crash or a silent
+ * JS/React default when a language is missing.
+ *
+ * This table is consumed by:
+ *   - the component store (collection + audit) — export extraction, header
+ *     comment-form parsing, unit-shape + style-attr detection;
+ *   - the source-comment SoT walker — extension→`CommentLang` bucket;
+ *   - the Layer-A stub-pattern sensor — extension→sensor language tag.
+ *
+ * A miss (extension not in the table) means "unknown": the file is skipped by
+ * language-scoped features, never coerced into TypeScript.
+ */
+import type { CommentLang } from "./schemas.js";
+/** The comment syntaxes a registry header / essay comment can appear in. */
+export type CommentForm = "block" | "line" | "hash" | "html" | "dash" | "docstring";
+/**
+ * Sensor/stub-pattern language tag — an OPEN string equal to a language
+ * profile `id`. The registry IS the single source: any profile id (plus the
+ * stub-pattern catalog's special `"all"`) is a valid tag, so a new language
+ * becomes filterable just by living in the table. Common ids: typescript,
+ * javascript, python, ruby, go, rust, sql.
+ */
+export type SensorLang = string;
+export interface LanguageProfile {
+    /** Canonical language id — "typescript", "vue", "swift", "kotlin", … */
+    id: string;
+    /** Extensions owned by this profile (lowercase, dot-prefixed). */
+    extensions: readonly string[];
+    /** Coarser bucket the source-comment walker groups by. */
+    commentLang: CommentLang;
+    /** Comment forms a `@cairn` header may be written in. */
+    commentForms: readonly CommentForm[];
+    /**
+     * Every top-level exported / public symbol name (order-preserving,
+     * de-duplicated). `basename` lets single-file-unit languages (Vue, Svelte,
+     * Astro, Razor) report the file stem as their export.
+     */
+    exportSymbols(source: string, basename: string): string[];
+    /**
+     * Whether the file looks like a reusable UI unit (component / widget /
+     * view) for THIS language — PascalCase React component, Vue/Svelte SFC,
+     * SwiftUI `View` struct, Flutter `Widget`, Compose `@Composable`, etc.
+     * Backend / non-UI languages return false.
+     */
+    isUnitShaped(source: string, basename: string): boolean;
+    /** Class/style attribute regexes for the inline-rebuild audit. */
+    styleAttrs: readonly RegExp[];
+}
+export declare const LANGUAGE_PROFILES: readonly LanguageProfile[];
+/** Profile for a bare extension (`.tsx`), case-insensitive. Null when unknown. */
+export declare function profileForExtension(ext: string): LanguageProfile | null;
+/** Profile for a file path. Null when the extension isn't in the table. */
+export declare function profileForFile(path: string): LanguageProfile | null;
+/** Profile by canonical language id (`"vue"`). Null when unknown. */
+export declare function profileForId(id: string): LanguageProfile | null;
+/**
+ * Type-declaration keywords for a file's language (`struct`/`class`/`type`/…),
+ * or `[]` when the language has no nominal types or the extension is unknown.
+ * Single source for the audit's name-collision scan.
+ */
+export declare function typeDeclKeywordsForFile(path: string): readonly string[];
+/**
+ * Extensions where reusable UI units live, across web + native frameworks.
+ * Used as the component-store default when a config omits `extensions`, so an
+ * absent signal scans every UI file type rather than silently assuming React
+ * `.tsx`/`.jsx`. (Excludes `.ts`/`.js` — those hold logic, not components.)
+ */
+export declare const UI_EXTENSIONS: readonly string[];
+/**
+ * Whether `s` names a known language — a profile id. The open sensor-language
+ * registry: the stub-pattern catalog validates yaml `languages:` tags against
+ * this (plus its own `"all"`), so a typo is still rejected but any table
+ * language is accepted.
+ */
+export declare function isSensorLang(s: unknown): boolean;
+/** Every extension the table knows about. */
+export declare function knownExtensions(): string[];
+/**
+ * The source-comment `CommentLang` bucket for a file, or `"unknown"` when the
+ * extension isn't in the table. Single source for the source-comment walker.
+ */
+export declare function commentLangForFile(path: string): CommentLang;
+/**
+ * The sensor language tag for a file — the profile `id`, or `undefined` when
+ * the extension isn't in the table. Single source for the Layer-A
+ * stub-pattern catalog (a tag with no patterns simply matches nothing).
+ */
+export declare function sensorLangForFile(path: string): SensorLang | undefined;
+/**
+ * Every top-level exported / public name in a source file, using the
+ * language profile for `basename`'s extension. Order-preserving, de-duplicated.
+ * Unknown extension → empty (caller treats as "no detectable exports").
+ */
+export declare function extractExportNames(source: string, basename: string): string[];
+/**
+ * Best-effort single exported name — the likely `@cairn` value, used as the
+ * annotator's hint and for display. Prefers a PascalCase declaration (the
+ * unit convention) over hooks / SCREAMING_CASE constants. Null when nothing
+ * is exported.
+ */
+export declare function extractExportName(source: string, basename: string): string | null;