@nanonets/graft 0.1.0

package/dist/context/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/context/check.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,WAAW,CAsE9E;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAyBxD"}

package/dist/context/check.js

@@ -0,0 +1,127 @@
+/**
+ * `check` — is the committed `.context/` graph still in sync with the code?
+ *
+ * Pure I/O + hashing: no LLM, no network, milliseconds. It re-hashes the source
+ * files the manifest recorded and compares. Meant to run in CI: exit 0 when the
+ * graph is fresh, 1 when it has drifted (so a PR that changed code but not the
+ * graph fails until `graft init` is re-run and committed).
+ *
+ * Drift categories:
+ *   content     a recorded source file's bytes changed
+ *   removed     a recorded source file no longer exists
+ *   coverage    a code file exists that no node was built from (new/uningested)
+ *   index       a node's frontmatter disagrees with the manifest (hand-edited)
+ */
+import { readFileSync } from "node:fs";
+import { relative, resolve } from "node:path";
+import { walkDir } from "../ingest/fs.js";
+import { contentHash } from "../util/id.js";
+import { CODE_EXTENSIONS } from "./build.js";
+import { contextDirFor, readManifest, readNodes } from "./node-file.js";
+export function checkContext(dir, opts = {}) {
+    const root = resolve(dir);
+    const outDir = contextDirFor(root, opts.contextDir);
+    const exts = opts.extensions ?? CODE_EXTENSIONS;
+    const result = {
+        ok: false,
+        missing: false,
+        contentDrift: [],
+        removed: [],
+        coverage: [],
+        indexDrift: [],
+    };
+    const manifest = readManifest(outDir);
+    if (!manifest) {
+        result.missing = true;
+        return result;
+    }
+    // Current code files on disk (same rules `init` used).
+    const current = new Map(); // rel → hash
+    for (const file of walkDir(root)) {
+        if (file.startsWith(outDir))
+            continue;
+        if (!exts.some((e) => file.toLowerCase().endsWith(e)))
+            continue;
+        try {
+            current.set(relative(root, file), contentHash(readFileSync(file, "utf8")));
+        }
+        catch {
+            // Unreadable now → treat as removed below (it won't be in `current`).
+        }
+    }
+    // Compare the manifest's recorded files against what's on disk.
+    const recorded = new Set();
+    for (const ref of manifest.files) {
+        recorded.add(ref.path);
+        const now = current.get(ref.path);
+        if (now === undefined) {
+            result.removed.push(ref.path);
+        }
+        else if (now !== ref.hash) {
+            result.contentDrift.push({ path: ref.path, from: short(ref.hash), to: short(now) });
+        }
+    }
+    for (const path of current.keys()) {
+        if (!recorded.has(path))
+            result.coverage.push(path);
+    }
+    // Node frontmatter must agree with the manifest roster (catches hand edits).
+    const manifestNodes = new Map(manifest.nodes.map((n) => [n.slug, n]));
+    const onDisk = readNodes(outDir);
+    const seen = new Set();
+    for (const node of onDisk) {
+        seen.add(node.slug);
+        const m = manifestNodes.get(node.slug);
+        if (!m) {
+            result.indexDrift.push(`${node.slug}: node file not in manifest`);
+        }
+        else if (m.sourcesDigest !== node.sourcesDigest) {
+            result.indexDrift.push(`${node.slug}: frontmatter digest ≠ manifest`);
+        }
+    }
+    for (const slug of manifestNodes.keys()) {
+        if (!seen.has(slug))
+            result.indexDrift.push(`${slug}: in manifest but node file missing`);
+    }
+    result.ok =
+        result.contentDrift.length === 0 &&
+            result.removed.length === 0 &&
+            result.coverage.length === 0 &&
+            result.indexDrift.length === 0;
+    return result;
+}
+/** Render a check result as a human-readable report. */
+export function formatCheckReport(r) {
+    if (r.missing) {
+        return "graft check: NO GRAPH\n\nNo .context/manifest.json found. Run `graft init` first.";
+    }
+    if (r.ok)
+        return "graft check: OK — the graph is in sync with the code.";
+    const lines = ["graft check: STALE", ""];
+    if (r.contentDrift.length) {
+        lines.push(`changed (${r.contentDrift.length}):`);
+        for (const c of r.contentDrift)
+            lines.push(`  ~ ${c.path}  (${c.from} → ${c.to})`);
+    }
+    if (r.removed.length) {
+        lines.push(`removed (${r.removed.length}):`);
+        for (const p of r.removed)
+            lines.push(`  - ${p}`);
+    }
+    if (r.coverage.length) {
+        lines.push(`not in graph (${r.coverage.length}):`);
+        for (const p of r.coverage)
+            lines.push(`  + ${p}`);
+    }
+    if (r.indexDrift.length) {
+        lines.push(`index mismatch (${r.indexDrift.length}):`);
+        for (const s of r.indexDrift)
+            lines.push(`  ! ${s}`);
+    }
+    lines.push("", "Run `graft init` to regenerate, then commit .context/.");
+    return lines.join("\n");
+}
+function short(hash) {
+    return hash.slice(0, 8);
+}
+//# sourceMappingURL=check.js.map

package/dist/context/check.js.map

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

package/dist/context/node-file.d.ts

@@ -0,0 +1,80 @@
+/** A source file a node was derived from, with its content hash at generation time. */
+export interface SourceRef {
+    path: string;
+    hash: string;
+}
+/** A directed edge to another node (by slug). */
+export interface NodeLink {
+    to: string;
+    relation: string;
+    description?: string;
+}
+/** A single node in the graph — one markdown file. */
+export interface ContextNode {
+    name: string;
+    slug: string;
+    /** Coarse category from extraction: system | service | api | concept | … */
+    type: string;
+    /** Prose description that becomes the node body. */
+    summary: string;
+    /** Source files that produced this node (empty only for hand-authored nodes). */
+    sources: SourceRef[];
+    /** sha256 over the sorted `path:hash` lines of {@link sources}. */
+    sourcesDigest: string;
+    /** Outbound edges. */
+    links: NodeLink[];
+    /** Free-form region below the generated block, preserved across re-runs. */
+    human: string;
+}
+/** The generated index written alongside the node files. */
+export interface Manifest {
+    version: number;
+    /** Human label for the model that built the graph, e.g. "openrouter:openai/gpt-4o-mini". */
+    model: string;
+    /** sha256 over every source file's `path:hash` — the whole-graph fingerprint. */
+    repoDigest: string;
+    /** Every source file `init` processed, with its hash. The staleness ground-truth. */
+    files: SourceRef[];
+    /** Node roster (a subset of each node's frontmatter, for fast reads). */
+    nodes: Array<{
+        slug: string;
+        name: string;
+        type: string;
+        sources: string[];
+        sourcesDigest: string;
+    }>;
+}
+export declare const MANIFEST_VERSION = 1;
+/** Gitignored cache dir (per-file summaries + extractions), never committed. */
+export declare const CACHE_DIR = ".cache";
+/** Turn a display name into a stable, filesystem- and link-safe slug. */
+export declare function slugify(name: string): string;
+/** sha256 over the sorted `path:hash` lines of a set of sources. */
+export declare function digestSources(sources: SourceRef[]): string;
+/** Absolute path of the `.context/` directory for a repo root. */
+export declare function contextDirFor(root: string, override?: string): string;
+/** Serialize a node to its full markdown file contents. */
+export declare function renderNodeFile(node: ContextNode): string;
+/**
+ * Write a node file, preserving any existing human region. Returns the file
+ * path written.
+ */
+export declare function writeNode(dir: string, node: ContextNode): string;
+/** A node file parsed back off disk (frontmatter only; body is not needed for `check`). */
+export interface ParsedNode {
+    slug: string;
+    name: string;
+    type: string;
+    sources: SourceRef[];
+    sourcesDigest: string;
+    links: NodeLink[];
+}
+/** Read and parse every `.md` node file in a context dir (skips the manifest). */
+export declare function readNodes(dir: string): ParsedNode[];
+/** List the node files present (slug → filename), for pruning deleted nodes. */
+export declare function existingNodeSlugs(dir: string): Set<string>;
+/** Delete a node file by slug. */
+export declare function deleteNode(dir: string, slug: string): void;
+export declare function writeManifest(dir: string, manifest: Manifest): void;
+export declare function readManifest(dir: string): Manifest | undefined;
+//# sourceMappingURL=node-file.d.ts.map

package/dist/context/node-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-file.d.ts","sourceRoot":"","sources":["../../src/context/node-file.ts"],"names":[],"mappings":"AA4BA,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iDAAiD;AACjD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtG;AAED,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAIlC,gFAAgF;AAChF,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAM1D;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrE;AAsBD,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAexD;AAaD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAWhE;AAED,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAgBnD;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAO1D;AAED,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG1D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGnE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ9D"}

package/dist/context/node-file.js

@@ -0,0 +1,165 @@
+/**
+ * The on-disk format of the context graph: a folder of plain markdown files
+ * under `.context/`, one per node. The files ARE the graph — the frontmatter
+ * carries the machine-readable node (identity, source provenance, edges) and
+ * the body is human/agent-readable prose. There is no database.
+ *
+ * Layout of a node file:
+ *
+ *   ---                         ← YAML frontmatter (canonical, machine-owned)
+ *   name / slug / type
+ *   sources: [{path, hash}]     ← provenance + the staleness key
+ *   sources_digest
+ *   links: [{to, relation}]     ← edges (canonical form)
+ *   ---
+ *   <!-- context:generated:start -->
+ *   ## Summary … ## Related …   ← regenerated on every `init`
+ *   <!-- context:generated:end -->
+ *   ## Notes …                  ← anything a human writes is preserved verbatim
+ *
+ * `.context/manifest.json` is a generated index over all nodes plus the full
+ * file→hash map `init` saw, so `check` can detect drift in O(files) without an
+ * LLM and without re-reading every node body.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import matter from "gray-matter";
+import { contentHash, normalizeName } from "../util/id.js";
+export const MANIFEST_VERSION = 1;
+const GEN_START = "<!-- context:generated:start -->";
+const GEN_END = "<!-- context:generated:end -->";
+const MANIFEST_FILE = "manifest.json";
+/** Gitignored cache dir (per-file summaries + extractions), never committed. */
+export const CACHE_DIR = ".cache";
+/** Turn a display name into a stable, filesystem- and link-safe slug. */
+export function slugify(name) {
+    const base = normalizeName(name)
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return base || "node";
+}
+/** sha256 over the sorted `path:hash` lines of a set of sources. */
+export function digestSources(sources) {
+    const lines = sources
+        .map((s) => `${s.path}:${s.hash}`)
+        .sort()
+        .join("\n");
+    return contentHash(lines);
+}
+/** Absolute path of the `.context/` directory for a repo root. */
+export function contextDirFor(root, override) {
+    if (override)
+        return override;
+    return join(root, ".context");
+}
+/** Render the generated body (Summary + Related) for a node. */
+function renderGenerated(node) {
+    const lines = [`## Summary`, ``, node.summary.trim() || "_(no summary)_", ``];
+    if (node.links.length > 0) {
+        lines.push(`## Related`, ``);
+        for (const link of [...node.links].sort((a, b) => a.to.localeCompare(b.to))) {
+            const rel = link.relation.replace(/_/g, " ");
+            const tail = link.description ? ` — ${link.description}` : "";
+            lines.push(`- ${rel} [[${link.to}]]${tail}`);
+        }
+        lines.push(``);
+    }
+    return lines.join("\n");
+}
+/** Default human region for a brand-new node (preserved verbatim afterwards). */
+function defaultHuman() {
+    return `\n## Notes\n\n_Anything written below the generated block is preserved when the graph is regenerated._\n`;
+}
+/** Serialize a node to its full markdown file contents. */
+export function renderNodeFile(node) {
+    const data = {
+        name: node.name,
+        slug: node.slug,
+        type: node.type,
+        sources: node.sources.map((s) => ({ path: s.path, hash: s.hash })),
+        sources_digest: node.sourcesDigest,
+        links: node.links.map((l) => l.description ? { to: l.to, relation: l.relation, description: l.description } : { to: l.to, relation: l.relation }),
+        generator: { version: MANIFEST_VERSION },
+    };
+    const body = `${GEN_START}\n${renderGenerated(node)}${GEN_END}\n${node.human}`;
+    // gray-matter appends a trailing newline; keep output stable across runs.
+    return matter.stringify(body, data);
+}
+/**
+ * Extract the human region (everything after the generated-end marker) from an
+ * existing node file so it survives regeneration. If the markers are missing
+ * (a hand-deleted or foreign file), returns a fresh default region.
+ */
+function preserveHuman(existingContent) {
+    const idx = existingContent.indexOf(GEN_END);
+    if (idx === -1)
+        return defaultHuman();
+    return existingContent.slice(idx + GEN_END.length).replace(/^\n/, "");
+}
+/**
+ * Write a node file, preserving any existing human region. Returns the file
+ * path written.
+ */
+export function writeNode(dir, node) {
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, `${node.slug}.md`);
+    if (existsSync(path)) {
+        const parsed = matter(readFileSync(path, "utf8"));
+        node = { ...node, human: preserveHuman(parsed.content) };
+    }
+    else {
+        node = { ...node, human: node.human || defaultHuman() };
+    }
+    writeFileSync(path, renderNodeFile(node));
+    return path;
+}
+/** Read and parse every `.md` node file in a context dir (skips the manifest). */
+export function readNodes(dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(dir)) {
+        if (!entry.endsWith(".md"))
+            continue;
+        const fm = matter(readFileSync(join(dir, entry), "utf8")).data;
+        out.push({
+            slug: String(fm.slug ?? entry.replace(/\.md$/, "")),
+            name: String(fm.name ?? ""),
+            type: String(fm.type ?? ""),
+            sources: Array.isArray(fm.sources) ? fm.sources : [],
+            sourcesDigest: String(fm.sources_digest ?? ""),
+            links: Array.isArray(fm.links) ? fm.links : [],
+        });
+    }
+    return out;
+}
+/** List the node files present (slug → filename), for pruning deleted nodes. */
+export function existingNodeSlugs(dir) {
+    if (!existsSync(dir))
+        return new Set();
+    return new Set(readdirSync(dir)
+        .filter((e) => e.endsWith(".md"))
+        .map((e) => e.replace(/\.md$/, "")));
+}
+/** Delete a node file by slug. */
+export function deleteNode(dir, slug) {
+    const path = join(dir, `${slug}.md`);
+    if (existsSync(path))
+        rmSync(path);
+}
+export function writeManifest(dir, manifest) {
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, MANIFEST_FILE), JSON.stringify(manifest, null, 2) + "\n");
+}
+export function readManifest(dir) {
+    const path = join(dir, MANIFEST_FILE);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=node-file.js.map

package/dist/context/node-file.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The Context Graph Engine.
+ *
+ * Two operations, no database:
+ *   - {@link Graft.init}  build `.context/` from a code repo.
+ *   - {@link Graft.check} report whether `.context/` is still in
+ *     sync with the code (for CI).
+ *
+ * The graph is a folder of linked markdown files committed to the repo; git is
+ * the sync. This class wires the OpenRouter LLM providers into the build/check
+ * pipelines; an API key is required for any LLM-backed operation.
+ */
+import { type EngineConfig } from "./ai/providers.js";
+import { CODE_EXTENSIONS, type BuildProgress, type BuildResult } from "./context/build.js";
+import { type CheckResult } from "./context/check.js";
+import { type GraphBuildOptions, type GraphBuildResult } from "./graph/build.js";
+import { type GraphCheckResult } from "./graph/check.js";
+export { CODE_EXTENSIONS };
+export type { BuildResult, BuildProgress, CheckResult, GraphBuildResult, GraphCheckResult };
+export interface InitOptions {
+    /** Code extensions to include. Default: {@link CODE_EXTENSIONS}. */
+    extensions?: string[];
+    /** Progress callback for long builds. */
+    onProgress?: (info: BuildProgress) => void;
+}
+export interface CheckRunOptions {
+    extensions?: string[];
+}
+export interface GraphRunOptions {
+    /** Run the Tier-2 LLM meaning pass (summary + crux). Absent → Tier-1 only. */
+    llm?: boolean;
+    onProgress?: GraphBuildOptions["onProgress"];
+}
+export declare class Graft {
+    private cfg;
+    constructor(config?: EngineConfig);
+    /** Build the `.context/` graph from the repo at `dir`. */
+    init(dir: string, opts?: InitOptions): Promise<BuildResult>;
+    /** Report whether the committed `.context/` markdown graph is in sync with the code. */
+    check(dir: string, opts?: CheckRunOptions): CheckResult;
+    /** Report whether the committed `graph.json` is in sync with the code (Tier-1 diff). */
+    checkGraph(dir: string): GraphCheckResult;
+    /**
+     * Build `.context/graph.json` — a per-symbol code graph from tree-sitter.
+     * Tier-1 (structure) always runs; the Tier-2 meaning layer runs only when
+     * `opts.llm` is set. Either way the prior meaning layer is preserved.
+     */
+    graph(dir: string, opts?: GraphRunOptions): Promise<GraphBuildResult>;
+    /** The OpenRouter API key, or a clear error telling the user how to set it. */
+    private requireKey;
+    private synthesizer;
+    /** Per-node crux summarizer for the code graph's Tier-2 pass. */
+    private cruxSummarizer;
+    private summarizer;
+    /** Human label for the active model, recorded in the manifest. */
+    private modelLabel;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAiB,KAAK,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAI1F,OAAO,EAAgB,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAc,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;AAE5F,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;CAC9C;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,GAAG,CAAiB;gBAEhB,MAAM,GAAE,YAAiB;IAIrC,0DAA0D;IACpD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAWrE,wFAAwF;IACxF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,WAAW;IAI3D,wFAAwF;IACxF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;IAIzC;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQzE,+EAA+E;IAC/E,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,WAAW;IAKnB,iEAAiE;IACjE,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,UAAU;IAKlB,kEAAkE;IAClE,OAAO,CAAC,UAAU;CAInB"}

package/dist/engine.js

@@ -0,0 +1,87 @@
+/**
+ * The Context Graph Engine.
+ *
+ * Two operations, no database:
+ *   - {@link Graft.init}  build `.context/` from a code repo.
+ *   - {@link Graft.check} report whether `.context/` is still in
+ *     sync with the code (for CI).
+ *
+ * The graph is a folder of linked markdown files committed to the repo; git is
+ * the sync. This class wires the OpenRouter LLM providers into the build/check
+ * pipelines; an API key is required for any LLM-backed operation.
+ */
+import { resolveConfig } from "./ai/providers.js";
+import { OpenRouterSynthesizer } from "./ai/synthesize.js";
+import { OpenRouterSummarizer } from "./ai/summarize.js";
+import { OpenRouterCruxSummarizer } from "./ai/crux.js";
+import { buildContext, CODE_EXTENSIONS } from "./context/build.js";
+import { checkContext } from "./context/check.js";
+import { buildGraph } from "./graph/build.js";
+import { checkGraph } from "./graph/check.js";
+export { CODE_EXTENSIONS };
+export class Graft {
+    cfg;
+    constructor(config = {}) {
+        this.cfg = resolveConfig(config);
+    }
+    /** Build the `.context/` graph from the repo at `dir`. */
+    async init(dir, opts = {}) {
+        return buildContext(dir, {
+            contextDir: this.cfg.contextDir,
+            extensions: opts.extensions,
+            model: this.modelLabel(),
+            summarizer: this.summarizer(),
+            synthesizer: this.synthesizer(),
+            onProgress: opts.onProgress,
+        });
+    }
+    /** Report whether the committed `.context/` markdown graph is in sync with the code. */
+    check(dir, opts = {}) {
+        return checkContext(dir, { contextDir: this.cfg.contextDir, extensions: opts.extensions });
+    }
+    /** Report whether the committed `graph.json` is in sync with the code (Tier-1 diff). */
+    checkGraph(dir) {
+        return checkGraph(dir, { contextDir: this.cfg.contextDir });
+    }
+    /**
+     * Build `.context/graph.json` — a per-symbol code graph from tree-sitter.
+     * Tier-1 (structure) always runs; the Tier-2 meaning layer runs only when
+     * `opts.llm` is set. Either way the prior meaning layer is preserved.
+     */
+    graph(dir, opts = {}) {
+        return buildGraph(dir, {
+            contextDir: this.cfg.contextDir,
+            summarizer: opts.llm ? this.cruxSummarizer() : undefined,
+            onProgress: opts.onProgress,
+        });
+    }
+    /** The OpenRouter API key, or a clear error telling the user how to set it. */
+    requireKey() {
+        if (!this.cfg.openrouterApiKey) {
+            throw new Error("No OpenRouter API key. Set OPENROUTER_API_KEY (get one at https://openrouter.ai/keys) " +
+                "to build or summarize the graph.");
+        }
+        return this.cfg.openrouterApiKey;
+    }
+    synthesizer() {
+        if (this.cfg.synthesizer)
+            return this.cfg.synthesizer;
+        return new OpenRouterSynthesizer(this.requireKey(), this.cfg.openrouterModel, this.cfg.openrouterBaseUrl);
+    }
+    /** Per-node crux summarizer for the code graph's Tier-2 pass. */
+    cruxSummarizer() {
+        return new OpenRouterCruxSummarizer(this.requireKey(), this.cfg.openrouterModel, this.cfg.openrouterBaseUrl);
+    }
+    summarizer() {
+        if (this.cfg.summarizer)
+            return this.cfg.summarizer;
+        return new OpenRouterSummarizer(this.requireKey(), this.cfg.openrouterModel, this.cfg.openrouterBaseUrl);
+    }
+    /** Human label for the active model, recorded in the manifest. */
+    modelLabel() {
+        if (this.cfg.synthesizer || this.cfg.summarizer)
+            return "custom";
+        return `openrouter:${this.cfg.openrouterModel}`;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/graph/build.d.ts

@@ -0,0 +1,33 @@
+import { type EnrichStats } from "./enrich.js";
+import { GRAPH_FILE } from "./write.js";
+import type { Kind, Relation } from "./types.js";
+import type { CruxSummarizer } from "../ai/crux.js";
+export interface GraphBuildOptions {
+    /** Override the output dir (default: `<root>/.context`). */
+    contextDir?: string;
+    /** Run the Tier-2 LLM meaning pass. Absent → Tier-1 only (cache is still preserved). */
+    summarizer?: CruxSummarizer;
+    onProgress?: (info: {
+        phase: "parse" | "enrich";
+        index: number;
+        total: number;
+        file: string;
+    }) => void;
+}
+export interface GraphBuildResult {
+    contextDir: string;
+    graphPath: string;
+    files: number;
+    nodes: number;
+    edges: number;
+    byKind: Record<Kind, number>;
+    byRelation: Record<Relation, number>;
+    languages: string[];
+    meaning: EnrichStats;
+    errors: string[];
+}
+/** The source files a graph build parses: supported languages, minus the output dir. */
+export declare function listSourceFiles(root: string, outDir: string): string[];
+export declare function buildGraph(dir: string, opts?: GraphBuildOptions): Promise<GraphBuildResult>;
+export { GRAPH_FILE };
+//# sourceMappingURL=build.d.ts.map

package/dist/graph/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/graph/build.ts"],"names":[],"mappings":"AAeA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAyB,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAW,IAAI,EAAU,QAAQ,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtE;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA4E3B;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}