knodin 0.5.0 → 0.6.0

package/dist/bin/cli.js

@@ -5,7 +5,7 @@
  *   knodin explain <symbol> [minimal]   edit-ready source + direct call paths + blast radius
  *   knodin review [base]      risk-scored context with explicit git diff scopes
  *   knodin map                subsystems + confidence-tagged edges
- *   knodin wiki [--force]     write .reckon/wiki/ (index.md + per-community pages)
+ *   knodin wiki [--force]     write .knodin/wiki/ (index.md + per-community pages)
  *   knodin serve              run the MCP server on stdio
  *
  * The same engine backs both the CLI and the MCP server, so any assistant and
@@ -313,7 +313,7 @@ function createProgressWorkerRenderer(workerName, startMessage) {
         : [workerPath];
     const worker = spawn(process.execPath, workerArgs, {
         stdio: ["pipe", "ignore", "inherit"],
-        env: { ...process.env, RECKON_FORCE_PROGRESS_TTY: "1" },
+        env: { ...process.env, KNODIN_FORCE_PROGRESS_TTY: "1" },
     });
     let failed = false;
     const closed = new Promise((resolve) => {
@@ -788,7 +788,7 @@ async function main() {
                 output = await checkTrustedUpdate(options);
             }
             finally {
-                if (process.env.RECKON_UPDATE_BACKGROUND === "1")
+                if (process.env.KNODIN_UPDATE_BACKGROUND === "1")
                     releaseScheduledUpdateCheck();
             }
         }
@@ -812,7 +812,7 @@ async function main() {
             const background = spawn(executable, [...arguments_, "update", "check", "--json"], {
                 detached: true,
                 stdio: "ignore",
-                env: { ...process.env, RECKON_UPDATE_BACKGROUND: "1" },
+                env: { ...process.env, KNODIN_UPDATE_BACKGROUND: "1" },
             });
             background.unref();
         }
@@ -1130,7 +1130,7 @@ async function main() {
             const scope = explicitScope(rawRest);
             if (!scope)
                 throw new Error("knodin configure: missing --scope");
-            if (!fs.existsSync(path.join(repo, ".reckon", "db.sqlite"))) {
+            if (!fs.existsSync(path.join(repo, ".knodin", "db.sqlite"))) {
                 throw new Error("knodin configure changes agent integration only; this repository is not initialized. Run `knodin init` first.");
             }
             const agents = scope === "team" ? [] : integrationAgents(repo);

package/dist/src/agent-integration.js

@@ -7,11 +7,8 @@ export function parseInitScope(value) {
     throw new Error("knodin: --scope must be personal, team, or cli-only");
 }
 const MCP_NAME = "knodin";
-const LEGACY_MCP_NAME = "reckon-graph";
 const TOML_START = "# knodin:start";
 const TOML_END = "# knodin:end";
-const LEGACY_TOML_START = "# reckon-graph:start";
-const LEGACY_TOML_END = "# reckon-graph:end";
 const TOML_BLOCK = `${TOML_START}
 [mcp_servers."${MCP_NAME}"]
 command = "knodin"
@@ -70,16 +67,6 @@ export function configurePersonalAgents(options) {
     for (const agent of options.detected) {
         if (agent !== "claude")
             continue;
-        const removeLegacy = {
-            executable: "claude",
-            args: ["mcp", "remove", LEGACY_MCP_NAME, "--scope", "local"],
-        };
-        try {
-            run(removeLegacy);
-        }
-        catch {
-            // A missing legacy registration is already the desired state.
-        }
         const command = options.remove
             ? {
                 executable: "claude",
@@ -143,7 +130,6 @@ function updateJsonMcp(filePath, remove) {
     const servers = typeof existing === "object" && existing !== null && !Array.isArray(existing)
         ? { ...existing }
         : {};
-    delete servers[LEGACY_MCP_NAME];
     if (remove)
         delete servers[MCP_NAME];
     else
@@ -176,7 +162,7 @@ function updateTomlMcp(filePath, remove) {
             ? `${content.slice(0, start)}${content.slice(end + endMarker.length)}`.trim()
             : content.trim();
     }
-    const without = removeManagedBlock(removeManagedBlock(existing, LEGACY_TOML_START, LEGACY_TOML_END), TOML_START, TOML_END);
+    const without = removeManagedBlock(existing, TOML_START, TOML_END);
     const next = remove ? without : [without, TOML_BLOCK].filter(Boolean).join("\n\n");
     if (!next) {
         fs.rmSync(filePath, { force: true });

package/dist/src/artifact-refresh.js

@@ -75,7 +75,7 @@ export function refreshExternalGraphArtifacts(repoPath, event, runtime = default
 }
 /** Persist an audit record locally; no source content or tool output is retained. */
 export function writeArtifactRefreshRecord(repoPath, result) {
-    const knodinDir = path.join(path.resolve(repoPath), ".reckon");
+    const knodinDir = path.join(path.resolve(repoPath), ".knodin");
     fs.mkdirSync(knodinDir, { recursive: true });
     fs.appendFileSync(path.join(knodinDir, "artifact-refresh.jsonl"), `${JSON.stringify({ at: new Date().toISOString(), ...result })}\n`, "utf8");
 }

package/dist/src/competitive-sandbox.js

@@ -65,8 +65,8 @@ export function createCompetitiveSandbox(sourceRepository, sourceFixture, compet
         GIT_CONFIG_GLOBAL: path.join(config, "gitconfig"),
         GIT_CONFIG_NOSYSTEM: "1",
         PATH: `${binaries}${path.delimiter}${process.env.PATH ?? ""}`,
-        RECKON_BENCHMARK_SOURCE_REPOSITORY: sourceRepository,
-        ...(realBun ? { RECKON_BENCHMARK_REAL_BUN: realBun } : {}),
+        KNODIN_BENCHMARK_SOURCE_REPOSITORY: sourceRepository,
+        ...(realBun ? { KNODIN_BENCHMARK_REAL_BUN: realBun } : {}),
     };
     try {
         if (realBun) {
@@ -74,9 +74,9 @@ export function createCompetitiveSandbox(sourceRepository, sourceFixture, compet
             fs.writeFileSync(bunShim, `#!/bin/sh
 if [ "$1" = "src/server.ts" ]; then
   shift
-  exec node --import tsx "$RECKON_BENCHMARK_SOURCE_REPOSITORY/src/server.ts" "$@"
+  exec node --import tsx "$KNODIN_BENCHMARK_SOURCE_REPOSITORY/src/server.ts" "$@"
 fi
-exec "$RECKON_BENCHMARK_REAL_BUN" "$@"
+exec "$KNODIN_BENCHMARK_REAL_BUN" "$@"
 `, { mode: 0o755 });
         }
         runGit(["clone", "--quiet", "--shared", "--no-checkout", sourceRepository, repository], root, environment);

package/dist/src/context-export.js

@@ -3,7 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { RE2 } from "re2-wasm";
 import { measurePerfPhaseSync } from "./engine/perf.js";
-const DEFAULT_EXCLUDES = [".git/**", ".reckon/**", "node_modules/**", "dist/**", "build/**"];
+const DEFAULT_EXCLUDES = [".git/**", ".knodin/**", "node_modules/**", "dist/**", "build/**"];
 const GLOB_CACHE_LIMIT = 256;
 const globCache = new Map();
 function normalizeRelative(value) {

package/dist/src/docs-sections.js

@@ -39,12 +39,12 @@ The \`query\` operation lets you ask precise, structured questions about your co
 
 Federation is knodin's internal query-composition mechanism, not the primary
 user-facing model. Use \`knodin repos\` for operational checkout management and
-\`knodin system\` with commit-ready \`reckon.yaml\` stable identities for
+\`knodin system\` with commit-ready \`knodin.yaml\` stable identities for
 cooperating components. Sibling directory placement and shared search matches
 never establish system membership.
 
-Legacy \`.reckon/federation.json\` remains a compatibility input and is not
-silently discarded. Migrate it to \`reckon.yaml\` plus personal XDG checkout
+Legacy \`.knodin/federation.json\` remains a compatibility input and is not
+silently discarded. Migrate it to \`knodin.yaml\` plus personal XDG checkout
 paths. The \`federated_repos\` query remains available for inspecting the
 engine's currently composed repository paths; it does not prove those
 repositories form one system.`,
@@ -82,7 +82,7 @@ Go, Rust, PHP, Ruby, Kotlin, Swift, Perl, PowerShell, Bash, and MuleSoft/RAML ar
 
 Run \`knodin status\` (or MCP \`operation: "status"\`) to inspect the local schema/model/version, file and symbol coverage, orphaned or missing records, and the last successful reconciliation. Its repair steps are actionable. Run \`knodin repair\` (or MCP \`operation: "repair"\`) to rebuild only missing/damaged rows and verify health; healthy indexed files are not deleted or rebuilt.
 
-The MCP \`telemetry\` operation reads process-local metadata-only measurements: actual response bytes and \`gpt-tokenizer@3.4.0:o200k_base\` tokens, executed baselines where available, negative or positive savings, latency, RSS, schema cost, truncation, and detail mode. It never contains source or file paths and does not change existing operation response shapes. Telemetry is not persisted by default. Set MCP \`persistTelemetry: true\` to append metadata-only JSONL to the repo-root \`.reckon-telemetry.jsonl\`; knodin never sends it over the network. Use \`telemetryAction: "report"\` or \`knodin telemetry report\` for a static repository-local HTML report.
+The MCP \`telemetry\` operation reads process-local metadata-only measurements: actual response bytes and \`gpt-tokenizer@3.4.0:o200k_base\` tokens, executed baselines where available, negative or positive savings, latency, RSS, schema cost, truncation, and detail mode. It never contains source or file paths and does not change existing operation response shapes. Telemetry is not persisted by default. Set MCP \`persistTelemetry: true\` to append metadata-only JSONL to the repo-root \`.knodin-telemetry.jsonl\`; knodin never sends it over the network. Use \`telemetryAction: "report"\` or \`knodin telemetry report\` for a static repository-local HTML report.
 
 Common issues and how to resolve them when using knodin:
 
@@ -100,7 +100,7 @@ The \`prs\` triage operation requires the official GitHub CLI (\`gh\`) to be ins
 
 ### Legacy federation configuration
 If legacy federation configuration fails, validate
-\`.reckon/federation.json\`, then migrate stable identities to \`reckon.yaml\`
+\`.knodin/federation.json\`, then migrate stable identities to \`knodin.yaml\`
 and local paths to XDG configuration. Do not infer membership from siblings.`,
 };
 const DOC_TOPIC_FILES = {

package/dist/src/engine/ann-hnsw.js

@@ -11,7 +11,7 @@
  * The durable lesson, now a hard gate: no approximate search path may engage BY
  * DEFAULT without a measured >=95% top-10 recall vs the exact scan on a real
  * corpus, with the method stated. This module is therefore OPT-IN ONLY, behind
- * `RECKON_ANN=1`; `search()`'s default remains the exact scan at every corpus
+ * `KNODIN_ANN=1`; `search()`'s default remains the exact scan at every corpus
  * size. See scripts/ann-bench.ts for the recall/latency harness.
  *
  * MEASURED, GATE NOT CLEARED (so it stays opt-in). scripts/ann-bench.ts on
@@ -25,7 +25,7 @@
  * 88.0% top-10 is far better than R11(a)'s LSH (43.3% top-10, AND slower) — the
  * three queries LSH scored 0% on ("session token", "webhook handler", "metrics
  * collection") here score 80/80/90% top-10 — but it misses the hard 95% floor,
- * so the exact scan REMAINS the default. Recall is tunable via RECKON_ANN_EF (a
+ * so the exact scan REMAINS the default. Recall is tunable via KNODIN_ANN_EF (a
  * larger ef trades latency for recall); default-engagement would require a fresh
  * measurement clearing 95% at the corpus size where the path engages. Given the
  * exact scan is 38ms at 18.6k and extrapolates sub-second to ~250k symbols,
@@ -257,11 +257,11 @@ export function buildHnswIndex(rows, params = {}) {
  * at a corpus size where the path would actually engage (see module header).
  */
 export function annEnabled() {
-    return process.env.RECKON_ANN === "1";
+    return process.env.KNODIN_ANN === "1";
 }
-/** efSearch beam width, overridable via RECKON_ANN_EF (a benchmark knob). */
+/** efSearch beam width, overridable via KNODIN_ANN_EF (a benchmark knob). */
 export function annEfSearch() {
-    const raw = process.env.RECKON_ANN_EF;
+    const raw = process.env.KNODIN_ANN_EF;
     if (raw) {
         const n = Number.parseInt(raw, 10);
         if (Number.isFinite(n) && n > 0)

package/dist/src/engine/embeddings.js

@@ -24,7 +24,7 @@ const DEFAULT_MODEL_REMOTE_HOST = "https://huggingface.co/";
  */
 export function getModelCacheDirectory(options = {}) {
     const environment = options.env ?? process.env;
-    const override = environment.RECKON_MODEL_CACHE?.trim();
+    const override = environment.KNODIN_MODEL_CACHE?.trim();
     if (override)
         return path.resolve(override);
     const platform = options.platform ?? process.platform;
@@ -42,16 +42,16 @@ export function getModelCacheDirectory(options = {}) {
  * point at an approved mirror without changing where model files are cached.
  */
 export function getModelRemoteHost(environment = process.env) {
-    const configured = environment.RECKON_MODEL_HOST?.trim() || DEFAULT_MODEL_REMOTE_HOST;
+    const configured = environment.KNODIN_MODEL_HOST?.trim() || DEFAULT_MODEL_REMOTE_HOST;
     let parsed;
     try {
         parsed = new URL(configured);
     }
     catch {
-        throw new Error(`RECKON_MODEL_HOST must be an absolute HTTP(S) URL: ${configured}`);
+        throw new Error(`KNODIN_MODEL_HOST must be an absolute HTTP(S) URL: ${configured}`);
     }
     if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
-        throw new Error(`RECKON_MODEL_HOST must use HTTP(S): ${configured}`);
+        throw new Error(`KNODIN_MODEL_HOST must use HTTP(S): ${configured}`);
     }
     parsed.hash = "";
     parsed.search = "";

package/dist/src/engine/index.js

@@ -796,7 +796,7 @@ const FLOW_MAX_ENTRIES = 200;
 const flowsCache = new Map();
 const fileToFlowLookupCache = new Map();
 const FILE_TO_FLOW_LOOKUP_CACHE_LIMIT = 8;
-// R18: opt-in ANN (RECKON_ANN=1). An in-memory HNSW index over a repo's
+// R18: opt-in ANN (KNODIN_ANN=1). An in-memory HNSW index over a repo's
 // embeddings, built lazily on first ANN query and cached per repo + invalidated
 // by indexGeneration exactly like mapCache/flowsCache — so a reindex rebuilds it
 // and close() drops it. Holds NO stored state (no schema bump, nothing to
@@ -4814,7 +4814,7 @@ export function parseSimpleNameFromUniqueId(uniqueId) {
 export async function indexDbtManifestFile(content, _absolutePath, relativePath, repoPath, db) {
     try {
         const manifest = JSON.parse(content);
-        const dbtDir = path.join(repoPath, ".reckon/dbt");
+        const dbtDir = path.join(repoPath, ".knodin/dbt");
         await fs.promises.mkdir(dbtDir, { recursive: true });
         const assets = [];
         // 1. Process nodes (models, seeds, tests)
@@ -4951,9 +4951,9 @@ export async function indexDbtManifestFile(content, _absolutePath, relativePath,
         db.run("BEGIN TRANSACTION;");
         try {
             // Clear out any previous records associated with this dbt manifest or virtual paths
-            deleteSymbolsMatchingPath(db, ".reckon/dbt/%");
-            db.run("DELETE FROM \"references\" WHERE callerFile LIKE '.reckon/dbt/%'");
-            db.run("DELETE FROM dependencies WHERE fromFile LIKE '.reckon/dbt/%'");
+            deleteSymbolsMatchingPath(db, ".knodin/dbt/%");
+            db.run("DELETE FROM \"references\" WHERE callerFile LIKE '.knodin/dbt/%'");
+            db.run("DELETE FROM dependencies WHERE fromFile LIKE '.knodin/dbt/%'");
             deleteSymbolsForFile(db, relativePath);
             db.run('DELETE FROM "references" WHERE callerFile = ?', [relativePath]);
             db.run("DELETE FROM dependencies WHERE fromFile = ?", [relativePath]);
@@ -4971,7 +4971,7 @@ export async function indexDbtManifestFile(content, _absolutePath, relativePath,
 			`);
             for (const asset of assets) {
                 const safeId = asset.unique_id.replace(/[/\\]/g, "_");
-                const virtualFilePath = `.reckon/dbt/${safeId}.sql`;
+                const virtualFilePath = `.knodin/dbt/${safeId}.sql`;
                 const absVirtualPath = path.join(repoPath, virtualFilePath);
                 let code = asset.sqlCode;
                 if (!code) {
@@ -4990,7 +4990,7 @@ export async function indexDbtManifestFile(content, _absolutePath, relativePath,
                 for (const depId of asset.depends_on_nodes) {
                     const depAsset = assetMap.get(depId);
                     const safeDepId = depId.replace(/[/\\]/g, "_");
-                    const depVirtualFilePath = `.reckon/dbt/${safeDepId}.sql`;
+                    const depVirtualFilePath = `.knodin/dbt/${safeDepId}.sql`;
                     insertDep.run(virtualFilePath, depVirtualFilePath, "dbt-lineage");
                     const depSimpleName = depAsset ? depAsset.name : parseSimpleNameFromUniqueId(depId);
                     insertRef.run(asset.name, virtualFilePath, depSimpleName, depVirtualFilePath, 1, 1);
@@ -5247,7 +5247,7 @@ const MAX_EMBEDDING_BATCH_SIZE = 32;
 // every symbol without turning source preparation into an unbounded memory sink.
 const EMBEDDING_SOURCE_CACHE_MAX_BYTES = 64 * 1024 * 1024;
 function embeddingBatchSize() {
-    const raw = process.env.RECKON_EMBEDDING_BATCH_SIZE;
+    const raw = process.env.KNODIN_EMBEDDING_BATCH_SIZE;
     if (raw === undefined)
         return DEFAULT_EMBEDDING_BATCH_SIZE;
     const parsed = Number(raw);
@@ -5829,11 +5829,11 @@ const WATCHED_FRESHNESS_LEASE_MS = 60_000;
 const FRESHNESS_FALLBACK_FILE_BOUND = 50000;
 /**
  * The non-git fallback's file bound, overridable with
- * `RECKON_FRESHNESS_FILE_BOUND` for repos where even a stat sweep of the
+ * `KNODIN_FRESHNESS_FILE_BOUND` for repos where even a stat sweep of the
  * indexed set is too much to pay per query.
  */
 function freshnessFallbackBound() {
-    const raw = process.env.RECKON_FRESHNESS_FILE_BOUND;
+    const raw = process.env.KNODIN_FRESHNESS_FILE_BOUND;
     if (raw !== undefined) {
         const parsed = Number.parseInt(raw, 10);
         if (Number.isFinite(parsed) && parsed >= 0)
@@ -6336,9 +6336,9 @@ async function getOrInitDb(repoPath, options = {}) {
                 dbPath = ":memory:";
             }
             else {
-                const knodinDir = path.join(normalizedPath, ".reckon");
+                const knodinDir = path.join(normalizedPath, ".knodin");
                 await fs.promises.mkdir(knodinDir, { recursive: true });
-                // Ensure .reckon is in .gitignore
+                // Ensure .knodin is in .gitignore
                 try {
                     const gitignorePath = path.join(normalizedPath, ".gitignore");
                     let gitignoreContent = "";
@@ -6346,11 +6346,11 @@ async function getOrInitDb(repoPath, options = {}) {
                         gitignoreContent = await fs.promises.readFile(gitignorePath, "utf-8");
                     }
                     const lines = gitignoreContent.split("\n").map((l) => l.trim());
-                    if (!lines.includes(".reckon") &&
-                        !lines.includes(".reckon/") &&
-                        !lines.includes("/.reckon")) {
+                    if (!lines.includes(".knodin") &&
+                        !lines.includes(".knodin/") &&
+                        !lines.includes("/.knodin")) {
                         const prefix = gitignoreContent.length > 0 && !gitignoreContent.endsWith("\n") ? "\n" : "";
-                        await fs.promises.appendFile(gitignorePath, `${prefix}\n# knodin\n.reckon\n`);
+                        await fs.promises.appendFile(gitignorePath, `${prefix}\n# knodin\n.knodin\n`);
                     }
                 }
                 catch (e) {
@@ -6401,7 +6401,7 @@ async function getOrInitDb(repoPath, options = {}) {
             // an unknown response shape, preserving C9's precision-first rule. v21
             // adds source-only LWR/Experience Bundle topology and must revisit its
             // newly indexable JSON files.
-            const RECKON_SCHEMA_VERSION = 21;
+            const KNODIN_SCHEMA_VERSION = 21;
             // Highest version whose upgrade needs the stored data REBUILT. Versions
             // above it migrate in place, so an upgrade costs a DELETE rather than a
             // full re-index + re-embed (~40 min of CPU on an 18k-symbol corpus).
@@ -6411,7 +6411,7 @@ async function getOrInitDb(repoPath, options = {}) {
             const needsMcpBackfill = storedVersion < 17;
             // v13 -> v14 purges embeddings orphaned while the FK cascade was inert.
             // Runs after the CREATE TABLEs below, since the table must exist.
-            const needsOrphanPurge = storedVersion < RECKON_SCHEMA_VERSION;
+            const needsOrphanPurge = storedVersion < KNODIN_SCHEMA_VERSION;
             if (storedVersion < LAST_REBUILD_SCHEMA_VERSION) {
                 db.run("DROP TRIGGER IF EXISTS after_symbol_insert;");
                 db.run("DROP TRIGGER IF EXISTS after_symbol_delete;");
@@ -6426,8 +6426,8 @@ async function getOrInitDb(repoPath, options = {}) {
                 db.run("DROP TABLE IF EXISTS mcp_tools;");
                 db.run("DROP TABLE IF EXISTS api_contracts;");
             }
-            if (storedVersion < RECKON_SCHEMA_VERSION) {
-                db.run(`PRAGMA user_version = ${RECKON_SCHEMA_VERSION};`);
+            if (storedVersion < KNODIN_SCHEMA_VERSION) {
+                db.run(`PRAGMA user_version = ${KNODIN_SCHEMA_VERSION};`);
             }
             db.run(`
 				CREATE TABLE IF NOT EXISTS symbols (
@@ -6712,15 +6712,15 @@ async function getFederatedRepos(repoPath) {
     const repos = [resolvedRepoPath];
     // Federation is EXPLICIT by default: a repo is treated as standalone unless it
     // is told otherwise, so results never silently depend on what else happens to
-    // live next to it. Two opt-in signals, read from `.reckon/federation.json`
+    // live next to it. Two opt-in signals, read from `.knodin/federation.json`
     // ({ "repos"?: string[], "autoDiscover"?: boolean }):
     //   • repos        — sibling paths (relative to this repo) to federate to.
     //   • autoDiscover — scan the parent directory for already-indexed siblings.
-    // autoDiscover can also be forced with RECKON_AUTO_FEDERATE=1. Without either
+    // autoDiscover can also be forced with KNODIN_AUTO_FEDERATE=1. Without either
     // signal, knodin federates to exactly the repos listed in `repos` (possibly
     // none) and nothing else.
-    let autoDiscover = process.env.RECKON_AUTO_FEDERATE === "1" || process.env.RECKON_AUTO_FEDERATE === "true";
-    const configPath = path.join(resolvedRepoPath, ".reckon/federation.json");
+    let autoDiscover = process.env.KNODIN_AUTO_FEDERATE === "1" || process.env.KNODIN_AUTO_FEDERATE === "true";
+    const configPath = path.join(resolvedRepoPath, ".knodin/federation.json");
     if (fs.existsSync(configPath)) {
         try {
             const parsed = JSON.parse(fs.readFileSync(configPath, "utf-8"));
@@ -6744,7 +6744,7 @@ async function getFederatedRepos(repoPath) {
         return repos;
     }
     // Auto-discovery (opt-in): siblings in the parent directory that knodin has
-    // already indexed (i.e. have a .reckon/db.sqlite). Under test the DB is
+    // already indexed (i.e. have a .knodin/db.sqlite). Under test the DB is
     // in-memory, so no repo has that on-disk marker; it would only ever match
     // repos a *production* run indexed elsewhere on the machine, so test
     // federation is driven purely by in-process `dbInstances` — skip the disk
@@ -6761,7 +6761,7 @@ async function getFederatedRepos(repoPath) {
                 if (siblingPath === resolvedRepoPath)
                     continue;
                 const isAlreadyIndexed = dbInstances.has(path.resolve(siblingPath)) ||
-                    (!isTest && fs.existsSync(path.join(siblingPath, ".reckon", "db.sqlite")));
+                    (!isTest && fs.existsSync(path.join(siblingPath, ".knodin", "db.sqlite")));
                 if (isAlreadyIndexed) {
                     repos.push(siblingPath);
                 }
@@ -8643,7 +8643,7 @@ function renderCommunityPage(community, map) {
     lines.push("");
     return lines.join("\n");
 }
-/** Renders `.reckon/wiki/index.md`: repo path, community table, one link per page. */
+/** Renders `.knodin/wiki/index.md`: repo path, community table, one link per page. */
 function renderWikiIndex(resolvedRepoPath, map, slugs) {
     const lines = [];
     lines.push("# knodin Wiki", "");
@@ -8681,14 +8681,14 @@ function writeWikiPageIfChanged(dirPath, relFile, content, force, written, skipp
     written.push(relFile);
 }
 /**
- * Generates the graph wiki (R5): `.reckon/wiki/index.md` + one page per
+ * Generates the graph wiki (R5): `.knodin/wiki/index.md` + one page per
  * `map()` community. Reuses `engine.map(, "standard")` for community/hub/bridge/edge
  * data — no community-detection logic is duplicated here.
  */
 async function writeWiki(engine, repoPath, force) {
     const resolvedRepoPath = path.resolve(repoPath);
     const map = await engine.map(repoPath, "standard");
-    const wikiDir = path.join(resolvedRepoPath, ".reckon", "wiki");
+    const wikiDir = path.join(resolvedRepoPath, ".knodin", "wiki");
     fs.mkdirSync(wikiDir, { recursive: true });
     // Slugify community names into unique page filenames (lowercase, hyphenated).
     const slugs = new Map();
@@ -9651,7 +9651,7 @@ export function createEngine() {
             // repair and timestamp drift before reporting it. Reuse an active DB in
             // long-lived processes, or open the existing local DB read-only.
             const activeDb = dbInstances.get(resolved);
-            const diskDbPath = path.join(resolved, ".reckon", "db.sqlite");
+            const diskDbPath = path.join(resolved, ".knodin", "db.sqlite");
             const db = activeDb ??
                 (fs.existsSync(diskDbPath) ? new Database(diskDbPath, { readonly: true }) : null);
             const verifiedAt = new Date().toISOString();
@@ -10057,7 +10057,7 @@ export function createEngine() {
                 // Repair partial current-schema databases before normal initialization,
                 // whose reconciliation queries require these columns. ALTER preserves all
                 // healthy index_state rows; the reconciler then refreshes their snapshots.
-                const diskDbPath = path.join(resolved, ".reckon", "db.sqlite");
+                const diskDbPath = path.join(resolved, ".knodin", "db.sqlite");
                 if (fs.existsSync(diskDbPath)) {
                     const activeDb = dbInstances.get(resolved);
                     const schemaDb = activeDb ?? new Database(diskDbPath);
@@ -10551,7 +10551,7 @@ export function createEngine() {
                 // full-corpus graph. Keep the opt-in ANN path for unfiltered searches;
                 // filtered requests use the exact default over only eligible rows.
                 if (ann.annEnabled() && !hasFilters) {
-                    // R18 OPT-IN ANN PATH (RECKON_ANN=1). Build/reuse an in-memory HNSW for
+                    // R18 OPT-IN ANN PATH (KNODIN_ANN=1). Build/reuse an in-memory HNSW for
                     // this repo and query it instead of computing cosine over every row. The
                     // exact scan below stays the DEFAULT at every corpus size; this path only
                     // engages behind the env flag, until a measured >=95% top-10 recall gate
@@ -12933,7 +12933,7 @@ export function createEngine() {
             for (const rel of wouldChange) {
                 const abs = path.resolve(resolvedRepoPath, rel);
                 const content = newContents.get(rel);
-                const tmp = path.join(path.dirname(abs), `.${path.basename(abs)}.reckon-rename-${process.pid}-${Date.now()}.tmp`);
+                const tmp = path.join(path.dirname(abs), `.${path.basename(abs)}.knodin-rename-${process.pid}-${Date.now()}.tmp`);
                 fs.writeFileSync(tmp, content, "utf-8");
                 fs.renameSync(tmp, abs);
             }

package/dist/src/engine/prune.js

@@ -2,7 +2,7 @@ import path from "node:path";
 /**
  * Single source of truth for "which directories does knodin ignore" (R14).
  *
- * Before this module, the same intent — skip node_modules, .git, .reckon,
+ * Before this module, the same intent — skip node_modules, .git, .knodin,
  * build output, caches, VCS internals — was encoded THREE separate times:
  *   1. src/__tests__/setup.ts's `PRUNE_DIRS` regex (glob-shim exclude filter)
  *   2. the indexer's own directory filter (`EXCLUDED_DIR_SEGMENTS` / `isIndexablePath`)
@@ -25,7 +25,7 @@ import path from "node:path";
 export const PRUNE_DIR_NAMES = new Set([
     "node_modules",
     ".git",
-    ".reckon",
+    ".knodin",
     // Local state maintained by other code-intelligence tools. It is neither
     // repository source nor stable project configuration, and indexing it makes
     // a healthy checkout look perpetually stale as those tools update databases

package/dist/src/engine/symbol-delete.js

@@ -45,7 +45,7 @@ export function deleteSymbolsForFile(db, filePath) {
 /**
  * Delete every symbol whose file path matches a LIKE pattern, plus its
  * embeddings. Used by the dbt path, whose symbols live under synthetic
- * `.reckon/dbt/%` paths rather than one real file.
+ * `.knodin/dbt/%` paths rather than one real file.
  */
 export function deleteSymbolsMatchingPath(db, likePattern) {
     db.run("DELETE FROM symbol_embeddings WHERE symbolId IN (SELECT id FROM symbols WHERE filePath LIKE ?)", [likePattern]);

package/dist/src/index-activity.js

@@ -2,7 +2,7 @@ import child_process from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 function activityPath(repo) {
-    return path.join(path.resolve(repo), ".reckon", "index-activity.json");
+    return path.join(path.resolve(repo), ".knodin", "index-activity.json");
 }
 const ACTIVITY_CLOCK_SKEW_MS = 2_000;
 const MAX_ACTIVITY_AGE_MS = 7 * 24 * 60 * 60 * 1_000;

package/dist/src/init-progress-worker.js

@@ -2,7 +2,7 @@
 import { clearLine as clearTerminalLine, moveCursor as moveTerminalCursor, cursorTo as moveTerminalCursorTo, } from "node:readline";
 import ora from "ora";
 import { formatProgress, normalizeTerminalDimension, } from "./init-progress.js";
-const terminalEnabled = process.stderr.isTTY === true || process.env.RECKON_FORCE_PROGRESS_TTY === "1";
+const terminalEnabled = process.stderr.isTTY === true || process.env.KNODIN_FORCE_PROGRESS_TTY === "1";
 // Ora divides rendered text width by `stream.columns`. Some pseudo-terminals
 // report zero columns, which turns its clear loop into an infinite loop. Keep
 // the real terminal methods while guaranteeing finite viewport dimensions.