@c3-oss/prosa 0.3.1 → 0.5.0

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): {
@@ -46,7 +51,7 @@ declare function runMigrations(db: Db): {
 declare function currentSchemaVersion(db: Db): number;
 
 declare const PROSA_PARSER_VERSION = "0.1.0";
-declare const PROSA_SCHEMA_VERSION = 2;
+declare const PROSA_SCHEMA_VERSION = 4;
 
 type Compression = 'zstd' | 'none';
 
@@ -233,6 +238,8 @@ interface SearchIndexStatus {
     indexed_doc_count: number;
     updated_at: string;
     error_message: string | null;
+    last_indexed_rowid: number | null;
+    schema_fingerprint: string | null;
 }
 declare function enableFts5Triggers(bundle: Bundle): void;
 declare function disableFts5Triggers(bundle: Bundle): void;
@@ -240,10 +247,17 @@ declare function getSearchIndexStatuses(bundle: Bundle): SearchIndexStatus[];
 declare function getSearchIndexStatus(bundle: Bundle, engine: SearchEngine): SearchIndexStatus | null;
 declare function markIndexesAfterImport(bundle: Bundle, options: {
     changed: boolean;
-    fts5Deferred: boolean;
 }): void;
 declare function rebuildFts5Index(bundle: Bundle): SearchIndexStatus;
-declare function rebuildTantivyIndex(bundle: Bundle): Promise<SearchIndexStatus>;
+interface RebuildTantivyOptions {
+    /**
+     * Force a full re-index even when an incremental run would be valid.
+     * Surfaced by the `--overwrite` flag on `prosa index tantivy` and on
+     * `prosa compile`.
+     */
+    overwrite?: boolean;
+}
+declare function rebuildTantivyIndex(bundle: Bundle, options?: RebuildTantivyOptions): Promise<SearchIndexStatus>;
 
 interface SearchHit {
     doc_id: string;
@@ -306,6 +320,7 @@ interface CompileImportSummary {
     importedAny: boolean;
     tantivy: TantivyCompileSummary | null;
     tantivyError: string | null;
+    fts5Error: string | null;
 }
 interface ParquetCompileSummary {
     outDir: string;
@@ -320,8 +335,14 @@ declare function resolveCompilePath(p: string): string;
 declare function runCompileImports(options: {
     bundle: Bundle;
     providers: CompileProviderConfig[];
-    deferIndex: boolean;
     sessionsPath?: string;
+    /**
+     * Force a full rebuild of derived indexes after import. Tantivy is the
+     * only sidecar with an incremental path today, so this currently flips
+     * Tantivy to a from-scratch rebuild; FTS5 and Parquet are always
+     * full-rewrite. Surfaced by `prosa compile … --overwrite`.
+     */
+    overwrite?: boolean;
     logger?: CompileLogger;
     onProviderComplete?: (summary: ProviderCompileSummary) => void;
     onTantivyComplete?: (summary: TantivyCompileSummary) => void;
@@ -331,15 +352,10 @@ declare function exportCompileParquet(options: {
     logger?: CompileLogger;
 }): Promise<ParquetCompileSummary>;
 
-/**
- * Render a session into Markdown. Big tool outputs aren't dumped inline:
- * we show a preview line plus a `[object: blake3:…]` reference, leaving the
- * raw bytes in the CAS for downstream tools.
- */
-declare function exportSessionMarkdown(bundle: Bundle, sessionId: string): Promise<string>;
-
 declare const PARQUET_TABLES: readonly ["objects", "source_files", "import_batches", "raw_records", "import_errors", "uncertainties", "projects", "sessions", "turns", "events", "messages", "content_blocks", "tool_calls", "tool_results", "artifacts", "edges", "search_docs"];
+declare const ANALYTICS_VIEWS: readonly ["session_facts", "tool_usage_facts", "error_facts", "model_usage", "project_activity"];
 type ParquetTable = (typeof PARQUET_TABLES)[number];
+type AnalyticsView = (typeof ANALYTICS_VIEWS)[number];
 interface ParquetExportOptions {
     bundlePath: string;
     outDir?: string;
@@ -361,6 +377,71 @@ interface DuckDbQueryResult {
 declare function exportBundleParquet(options: ParquetExportOptions): Promise<ParquetExportResult>;
 declare function queryDuckDbParquet(options: DuckDbQueryOptions): Promise<DuckDbQueryResult>;
 
+declare const ANALYTICS_REPORTS: readonly ["sessions", "tools", "errors", "models", "projects"];
+type AnalyticsReport = (typeof ANALYTICS_REPORTS)[number];
+type AnalyticsDialect = 'sqlite' | 'duckdb';
+interface AnalyticsReportFilters {
+    source?: string;
+    since?: string;
+    until?: string;
+    limit?: number;
+    toolName?: string;
+    canonicalType?: string;
+    errorsOnly?: boolean;
+    category?: string;
+    model?: string;
+    project?: string;
+    sessionId?: string;
+    sourcePathSubstring?: string;
+}
+interface AnalyticsReportOptions {
+    parquetDir: string;
+    report: AnalyticsReport;
+    filters?: AnalyticsReportFilters;
+}
+interface AnalyticsBundleReportOptions {
+    bundle: Bundle;
+    report: AnalyticsReport;
+    filters?: AnalyticsReportFilters;
+}
+declare function runAnalyticsReport(options: AnalyticsReportOptions): Promise<DuckDbQueryResult>;
+declare function runAnalyticsReportFromBundle(options: AnalyticsBundleReportOptions): DuckDbQueryResult;
+
+type ToolCallEntity = 'tool_call' | 'artifact';
+interface ToolCallEvidence {
+    entity_type: ToolCallEntity;
+    session_id: string | null;
+    tool_call_id: string | null;
+    artifact_id: string | null;
+    tool_name: string | null;
+    canonical_tool_type: string | null;
+    command: string | null;
+    path: string | null;
+    status: string | null;
+    timestamp_start: string | null;
+    is_error: 0 | 1 | null;
+    exit_code: number | null;
+    preview: string | null;
+}
+interface ToolCallFilters {
+    sessionId?: string;
+    toolName?: string;
+    canonicalType?: string;
+    pathSubstring?: string;
+    errorsOnly?: boolean;
+    sinceIso?: string;
+    untilIso?: string;
+    limit?: number;
+}
+declare function listToolCalls(bundle: Bundle, filters?: ToolCallFilters): ToolCallEvidence[];
+
+/**
+ * Render a session into Markdown. Big tool outputs aren't dumped inline:
+ * we show a preview line plus a `[object: blake3:…]` reference, leaving the
+ * raw bytes in the CAS for downstream tools.
+ */
+declare function exportSessionMarkdown(bundle: Bundle, sessionId: string): Promise<string>;
+
 interface CompileResult$3 {
     batch: ImportBatch;
     counts: ImportCounts;
@@ -385,4 +466,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 { ANALYTICS_REPORTS, ANALYTICS_VIEWS, type AnalyticsBundleReportOptions, type AnalyticsDialect, type AnalyticsReport, type AnalyticsReportFilters, type AnalyticsReportOptions, type AnalyticsView, 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 ToolCallEntity, type ToolCallEvidence, type ToolCallFilters, 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, listToolCalls, markIndexesAfterImport, openBundle, openOrInitBundle, putBytes, putJson, putText, queryDuckDbParquet, rebuildFts5Index, rebuildTantivyIndex, recordError, registerSourceFile, resolveCompilePath, runAnalyticsReport, runAnalyticsReportFromBundle, runCompileImports, runMigrations, searchFullText, startBatch };