@c3-oss/prosa 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -38,6 +38,11 @@ declare function initBundle(rootPath: string): Promise<Bundle>;
  * than the current code expects.
  */
 declare function openBundle(rootPath: string): Promise<Bundle>;
+/**
+ * Open an existing bundle or transparently initialize one if the store path is
+ * missing or has not been initialized yet.
+ */
+declare function openOrInitBundle(rootPath: string): Promise<Bundle>;
 declare function closeBundle(bundle: Bundle): void;
 
 declare function runMigrations(db: Db): {
@@ -84,7 +89,8 @@ declare function getText(bundle: Bundle, objectId: ObjectId): Promise<string>;
 declare function getJson<T = unknown>(bundle: Bundle, objectId: ObjectId): Promise<T>;
 declare function getObjectMeta(bundle: Bundle, objectId: ObjectId): ObjectMeta | null;
 
-type SourceTool = 'cursor' | 'codex' | 'claude' | 'gemini';
+declare const SOURCE_TOOLS: readonly ["cursor", "codex", "claude", "gemini"];
+type SourceTool = (typeof SOURCE_TOOLS)[number];
 type Confidence = 'high' | 'medium' | 'low';
 type MessageRole = 'system_prompt' | 'developer' | 'user' | 'assistant' | 'tool' | 'operational';
 type CanonicalToolType = 'shell' | 'read_file' | 'write_file' | 'edit_file' | 'search_file' | 'web_search' | 'mcp' | 'subagent' | 'patch' | 'other';
@@ -384,4 +390,4 @@ interface CompileResult {
 }
 declare function compileCursor(bundle: Bundle, root: string, options?: CompileOptions): Promise<CompileResult>;
 
-export { type Bundle, type BundleManifest, COMPILE_PROVIDERS, type CanonicalToolType, type CompileResult$2 as ClaudeCompileResult, type CompileResult$3 as CodexCompileResult, type CompileImportSummary, type CompileLogger, type CompileOptions, type CompileProviderConfig, type Confidence, type CompileResult as CursorCompileResult, type DuckDbQueryOptions, type DuckDbQueryResult, type EdgeType, type CompileResult$1 as GeminiCompileResult, type ImportBatch, type ImportCounts, type MessageRole, type ObjectId, type ObjectMeta, PARQUET_TABLES, PROSA_PARSER_VERSION, PROSA_SCHEMA_VERSION, type ParquetCompileSummary, type ParquetExportOptions, type ParquetExportResult, type ParquetTable, type ProviderCompileSummary, type RegisterResult, type SearchEngine, type SearchHit, type SearchIndexStatus, type SearchOptions, type SessionDetail, type SessionDetailEvent, type SessionListFilters, type SessionRow, type SessionRowFull, type SourceFileRow, type SourceTool, type TantivyCompileSummary, type ToolCallStatus, closeBundle, compileClaude, compileCodex, compileCursor, compileGemini, countSessions, currentSchemaVersion, defaultBundlePath, disableFts5Triggers, emptyCounts, enableFts5Triggers, exportBundleParquet, exportCompileParquet, exportSessionMarkdown, finishBatch, getBytes, getCompileProvider, getJson, getObjectMeta, getSearchIndexStatus, getSearchIndexStatuses, getSession, getText, initBundle, listSessions, markIndexesAfterImport, openBundle, putBytes, putJson, putText, queryDuckDbParquet, rebuildFts5Index, rebuildTantivyIndex, recordError, registerSourceFile, resolveCompilePath, runCompileImports, runMigrations, searchFullText, startBatch };
+export { type Bundle, type BundleManifest, COMPILE_PROVIDERS, type CanonicalToolType, type CompileResult$2 as ClaudeCompileResult, type CompileResult$3 as CodexCompileResult, type CompileImportSummary, type CompileLogger, type CompileOptions, type CompileProviderConfig, type Confidence, type CompileResult as CursorCompileResult, type DuckDbQueryOptions, type DuckDbQueryResult, type EdgeType, type CompileResult$1 as GeminiCompileResult, type ImportBatch, type ImportCounts, type MessageRole, type ObjectId, type ObjectMeta, PARQUET_TABLES, PROSA_PARSER_VERSION, PROSA_SCHEMA_VERSION, type ParquetCompileSummary, type ParquetExportOptions, type ParquetExportResult, type ParquetTable, type ProviderCompileSummary, type RegisterResult, type SearchEngine, type SearchHit, type SearchIndexStatus, type SearchOptions, type SessionDetail, type SessionDetailEvent, type SessionListFilters, type SessionRow, type SessionRowFull, type SourceFileRow, type SourceTool, type TantivyCompileSummary, type ToolCallStatus, closeBundle, compileClaude, compileCodex, compileCursor, compileGemini, countSessions, currentSchemaVersion, defaultBundlePath, disableFts5Triggers, emptyCounts, enableFts5Triggers, exportBundleParquet, exportCompileParquet, exportSessionMarkdown, finishBatch, getBytes, getCompileProvider, getJson, getObjectMeta, getSearchIndexStatus, getSearchIndexStatuses, getSession, getText, initBundle, listSessions, markIndexesAfterImport, openBundle, openOrInitBundle, putBytes, putJson, putText, queryDuckDbParquet, rebuildFts5Index, rebuildTantivyIndex, recordError, registerSourceFile, resolveCompilePath, runCompileImports, runMigrations, searchFullText, startBatch };

package/dist/index.js

@@ -534,6 +534,18 @@ async function openBundle(rootPath) {
   }
   return { path: resolved, db, manifest, paths };
 }
+async function openOrInitBundle(rootPath) {
+  const resolved = path.resolve(rootPath);
+  const paths = bundlePaths(resolved);
+  const dirStat = await stat(resolved).catch(() => null);
+  if (dirStat && !dirStat.isDirectory()) {
+    throw new Error(`bundle path not found or not a directory: ${resolved}`);
+  }
+  if (!dirStat || !await exists(paths.manifest)) {
+    return await initBundle(resolved);
+  }
+  return await openBundle(resolved);
+}
 function closeBundle(bundle) {
   closeDb(bundle.db);
 }
@@ -1006,6 +1018,11 @@ async function fileExists(filePath) {
   }
 }
 
+// src/core/limits.ts
+function clampLimit(value, opts) {
+  return Math.max(opts.min ?? 1, Math.min(opts.max, value ?? opts.fallback));
+}
+
 // src/services/sessions.ts
 function sessionFilterWhere(filters) {
   const conds = [];
@@ -1029,7 +1046,7 @@ function sessionFilterWhere(filters) {
 }
 function listSessions(bundle, filters = {}) {
   const { where, params } = sessionFilterWhere(filters);
-  const limit = Math.max(1, Math.min(1e3, filters.limit ?? 50));
+  const limit = clampLimit(filters.limit, { max: 1e3, fallback: 50 });
   const sql = `
     SELECT s.session_id,
            s.source_tool,
@@ -1105,6 +1122,9 @@ function getSession(bundle, sessionId2) {
 import { existsSync } from "fs";
 import { createRequire } from "module";
 
+// src/core/errors.ts
+var getErrorMessage = (err) => err instanceof Error ? err.message : String(err);
+
 // src/services/indexing.ts
 import { mkdir as mkdir3, rm, writeFile as writeFile4 } from "fs/promises";
 import path4 from "path";
@@ -1203,7 +1223,7 @@ function rebuildFts5Index(bundle) {
       status: "failed",
       sourceDocCount: countSearchDocs(bundle),
       indexedDocCount: countFts5Docs(bundle),
-      errorMessage: error instanceof Error ? error.message : String(error)
+      errorMessage: getErrorMessage(error)
     });
     throw error;
   }
@@ -1276,7 +1296,7 @@ async function rebuildTantivyIndex(bundle) {
       status: "failed",
       sourceDocCount: countSearchDocs(bundle),
       indexedDocCount: 0,
-      errorMessage: error instanceof Error ? error.message : String(error)
+      errorMessage: getErrorMessage(error)
     });
     throw error;
   }
@@ -1329,7 +1349,7 @@ function searchFullText(bundle, options) {
   if (options.engine === "tantivy") {
     return searchTantivy(bundle, options);
   }
-  const limit = Math.max(1, Math.min(500, options.limit ?? 50));
+  const limit = clampLimit(options.limit, { max: 500, fallback: 50 });
   const sql = `
     SELECT d.doc_id,
            d.entity_type,
@@ -1360,7 +1380,7 @@ function searchTantivy(bundle, options) {
       `tantivy index is ${status?.status ?? "missing"}; run \`prosa index tantivy\` first`
     );
   }
-  const limit = Math.max(1, Math.min(500, options.limit ?? 50));
+  const limit = clampLimit(options.limit, { max: 500, fallback: 50 });
   const queryText = options.query.trim();
   if (!queryText) return [];
   const tantivy = requireTantivy();
@@ -1394,9 +1414,7 @@ function requireTantivy() {
   try {
     return require2("@oxdev03/node-tantivy-binding");
   } catch (error) {
-    throw new Error(
-      `tantivy engine is unavailable: ${error instanceof Error ? error.message : String(error)}`
-    );
+    throw new Error(`tantivy engine is unavailable: ${getErrorMessage(error)}`);
   }
 }
 function getStoredText(doc, field) {
@@ -1518,7 +1536,7 @@ async function compileClaude(bundle, root, options = {}) {
         );
         await recordError(bundle, batch.batch_id, {
           kind: "claude_file_failed",
-          message: error instanceof Error ? error.message : String(error),
+          message: getErrorMessage(error),
           payload: { path: file.filePath }
         });
       }
@@ -2480,7 +2498,7 @@ async function compileCodex(bundle, root, options = {}) {
         );
         await recordError(bundle, batch.batch_id, {
           kind: "codex_file_failed",
-          message: error instanceof Error ? error.message : String(error),
+          message: getErrorMessage(error),
           payload: { path: filePath }
         });
       }
@@ -3633,7 +3651,7 @@ async function compileCursor(bundle, root, options = {}) {
         );
         await recordError(bundle, batch.batch_id, {
           kind: "cursor_store_failed",
-          message: error instanceof Error ? error.message : String(error),
+          message: getErrorMessage(error),
           payload: { path: store.filePath }
         });
       }
@@ -4356,7 +4374,7 @@ async function compileGemini(bundle, root, options = {}) {
         );
         await recordError(bundle, batch.batch_id, {
           kind: "gemini_file_failed",
-          message: error instanceof Error ? error.message : String(error),
+          message: getErrorMessage(error),
           payload: { path: file.filePath }
         });
       }
@@ -5139,7 +5157,7 @@ async function attachSqlite(connection, dbPath) {
     await connection.run(`ATTACH ${sqlString(dbPath)} AS prosa (TYPE sqlite)`);
   } catch (error) {
     throw new Error(
-      `DuckDB could not attach prosa.sqlite via the sqlite extension: ${error instanceof Error ? error.message : String(error)}`
+      `DuckDB could not attach prosa.sqlite via the sqlite extension: ${getErrorMessage(error)}`
     );
   }
 }
@@ -5170,7 +5188,7 @@ function sqlString(value) {
   return `'${value.replace(/'/g, "''")}'`;
 }
 function isMissingParquetError(error) {
-  const message = error instanceof Error ? error.message : String(error);
+  const message = getErrorMessage(error);
   return /No files found|does not exist|not found/i.test(message) && /\.parquet/i.test(message);
 }
 
@@ -5266,7 +5284,7 @@ async function runCompileImports(options) {
         tantivy = { indexedDocCount: status.indexed_doc_count };
         options.onTantivyComplete?.(tantivy);
       } catch (error) {
-        tantivyError = error instanceof Error ? error.message : String(error);
+        tantivyError = getErrorMessage(error);
         logger?.error({ err: error }, "tantivy rebuild failed; SQLite data is intact");
       }
     }
@@ -5437,6 +5455,7 @@ export {
   listSessions,
   markIndexesAfterImport,
   openBundle,
+  openOrInitBundle,
   putBytes,
   putJson,
   putText,