From 3f56644a055fb053d8acfb3787ac3d420dc3dd2a Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Mon, 23 Feb 2026 20:53:06 -0700
Subject: [PATCH] fix(cli): graceful error for cycles, export, embed when no
 graph.db exists

Use openReadonlyOrFail() instead of raw Database() constructor in the
export and cycles command handlers. Add fs.existsSync() guard in
buildEmbeddings(). Also export ./package.json in the exports map.

Closes #77
Closes #78

Impact: 1 functions changed, 1 affected
---
 package.json    | 3 ++-
 src/cli.js      | 7 +++----
 src/embedder.js | 8 ++++++++
 3 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/package.json b/package.json
index 53e378a1..67c32e07 100644
--- a/package.json
+++ b/package.json
@@ -7,7 +7,8 @@
   "exports": {
     ".": {
       "import": "./src/index.js"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "bin": {
     "codegraph": "./src/cli.js"
diff --git a/src/cli.js b/src/cli.js
index b5a48221..ccf8fbc4 100644
--- a/src/cli.js
+++ b/src/cli.js
@@ -2,12 +2,11 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
-import Database from 'better-sqlite3';
 import { Command } from 'commander';
 import { buildGraph } from './builder.js';
 import { loadConfig } from './config.js';
 import { findCycles, formatCycles } from './cycles.js';
-import { findDbPath } from './db.js';
+import { openReadonlyOrFail } from './db.js';
 import { buildEmbeddings, EMBEDDING_STRATEGIES, MODELS, search } from './embedder.js';
 import { exportDOT, exportJSON, exportMermaid } from './export.js';
 import { setVerbose } from './logger.js';
@@ -275,7 +274,7 @@ program
   .option('--min-confidence <score>', 'Minimum edge confidence threshold (default: 0.5)', '0.5')
   .option('-o, --output <file>', 'Write to file instead of stdout')
   .action((opts) => {
-    const db = new Database(findDbPath(opts.db), { readonly: true });
+    const db = openReadonlyOrFail(opts.db);
     const exportOpts = {
       fileLevel: !opts.functions,
       noTests: resolveNoTests(opts),
@@ -314,7 +313,7 @@ program
   .option('--include-tests', 'Include test/spec files (overrides excludeTests config)')
   .option('-j, --json', 'Output as JSON')
   .action((opts) => {
-    const db = new Database(findDbPath(opts.db), { readonly: true });
+    const db = openReadonlyOrFail(opts.db);
     const cycles = findCycles(db, { fileLevel: !opts.functions, noTests: resolveNoTests(opts) });
     db.close();
 
diff --git a/src/embedder.js b/src/embedder.js
index 67eb39e5..20882e9b 100644
--- a/src/embedder.js
+++ b/src/embedder.js
@@ -324,6 +324,14 @@ export async function buildEmbeddings(rootDir, modelKey, customDbPath, options =
   const strategy = options.strategy || 'structured';
   const dbPath = customDbPath || findDbPath(null);
 
+  if (!fs.existsSync(dbPath)) {
+    console.error(
+      `No codegraph database found at ${dbPath}.\n` +
+        `Run "codegraph build" first to analyze your codebase.`,
+    );
+    process.exit(1);
+  }
+
   const db = new Database(dbPath);
   initEmbeddingsSchema(db);