@cesarandreslopez/occ 0.6.3 → 0.8.0

package/README.md

@@ -277,6 +277,38 @@ session.chunk({ maxChunkWords: 200 });
 await session.refresh(); // rebuild index when files change
 ```
 
+For persistent caching across sessions with automatic freshness checks:
+
+```ts
+import { openCodeIndexStore } from '@cesarandreslopez/occ/code/store';
+
+const store = openCodeIndexStore({
+  repoRoot: './my-repo',
+  cacheDir: '.occ-cache',
+});
+
+// First call builds + caches; subsequent calls load from cache
+const session = await store.getSession({ strategy: 'prefer-cache' });
+session.findByName('UserService');
+
+// Check freshness via file manifests before returning cache
+await store.getSession({ strategy: 'ensure-fresh' });
+
+// Force a full rebuild
+await store.refresh();
+```
+
+Or use the unified facade for all OCC APIs from a single import:
+
+```ts
+import { createOcc } from '@cesarandreslopez/occ';
+
+const occ = createOcc();
+const session = await occ.code.createSession({ repoRoot: './my-repo' });
+const analysis = await occ.workspace.analyze('./my-project', { includeCode: true });
+const doc = await occ.doc.inspect('report.docx', {});
+```
+
 For workspace-level analysis:
 
 ```ts
@@ -297,7 +329,8 @@ Available subpath exports:
 | `@cesarandreslopez/occ/code/discover` | `discoverCodeFiles` — file discovery |
 | `@cesarandreslopez/occ/code/chunk` | `chunkCodebase`, `chunkFromIndex` — semantic code chunking |
 | `@cesarandreslopez/occ/code/session` | `createCodeQuerySession` — stateful code query session |
-| `@cesarandreslopez/occ/code/cache` | Index caching utilities |
+| `@cesarandreslopez/occ/code/store` | `openCodeIndexStore` — persistent index store with cache strategies |
+| `@cesarandreslopez/occ/code/cache` | Index caching utilities (legacy — prefer `./code/store`) |
 | `@cesarandreslopez/occ/doc/inspect` | `inspectDocument` — document metadata and content extraction |
 | `@cesarandreslopez/occ/doc/types` | Document inspection types |
 | `@cesarandreslopez/occ/doc/discover` | Document file discovery |
@@ -307,6 +340,8 @@ Available subpath exports:
 | `@cesarandreslopez/occ/workspace/analyze` | `analyzeWorkspace` — workspace-level analysis |
 | `@cesarandreslopez/occ/workspace/documents` | `inspectWorkspaceDocumentSet` — document summaries and cross-references |
 | `@cesarandreslopez/occ/workspace/types` | Workspace analysis types |
+| `@cesarandreslopez/occ/workspace/prepare` | `prepareWorkspaceContext` — combined code indexing + document inspection |
+| `@cesarandreslopez/occ/workspace/prepare-types` | Workspace preparation types (`WorkspacePrepareOptions`, `WorkspacePreparedContext`, etc.) |
 | `@cesarandreslopez/occ/markdown/convert` | `documentToMarkdown` — document-to-markdown conversion |
 | `@cesarandreslopez/occ/structure/extract` | `extractFromMarkdown` — heading tree extraction |
 | `@cesarandreslopez/occ/structure/types` | Structure types and helpers |
@@ -439,6 +474,25 @@ occ workspace documents --max-files 20 --include-markdown --format json
 
 `occ workspace analyze` returns a `schemaVersion: 1` JSON envelope containing code metrics (via scc), document aggregates, heading structures, skipped files, and errors. `occ workspace documents` returns per-document summaries with cross-references (filename mentions, hyperlinks, citations) and unresolved mentions detected across the document set.
 
+For combined code indexing and document inspection with progress tracking:
+
+```ts
+import { prepareWorkspaceContext } from '@cesarandreslopez/occ/workspace/prepare';
+
+const context = await prepareWorkspaceContext('./my-project', {
+  includeCode: true,
+  includeDocuments: true,
+  executionMode: 'auto', // 'auto' | 'inline' | 'subprocess'
+}, (event) => {
+  console.log(`[${event.scope}] ${event.stage}: ${event.completed}/${event.total}`);
+});
+
+// context.code?.index  — full CodebaseIndex
+// context.documents    — WorkspaceDocumentSet with cross-references
+// context.elapsedMs    — total wall time
+// context.errors       — collected errors from both phases
+```
+
 ## Documentation
 
 Full documentation is available at [cesarandreslopez.github.io/occ](https://cesarandreslopez.github.io/occ/), including:

package/dist/src/code/session.d.ts

@@ -24,3 +24,4 @@ export interface CodeQuerySession {
     chunk(options?: CodeSessionChunkOptions): CodeChunk[];
 }
 export declare function createCodeQuerySession(options: BuildCodebaseOptions, onProgress?: OnProgress): Promise<CodeQuerySession>;
+export declare function createCodeQuerySessionFromIndex(options: BuildCodebaseOptions, index: CodebaseIndex): CodeQuerySession;

package/dist/src/code/session.js

@@ -56,4 +56,7 @@ export async function createCodeQuerySession(options, onProgress) {
     const index = await buildCodebaseIndex(options, onProgress);
     return new InMemoryCodeQuerySession(options, index);
 }
+export function createCodeQuerySessionFromIndex(options, index) {
+    return new InMemoryCodeQuerySession(options, index);
+}
 //# sourceMappingURL=session.js.map

package/dist/src/code/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/code/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,GAGZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAA6B,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAmC5D,MAAM,wBAAwB;IAET;IACT;IAFV,YACmB,YAAkC,EAC3C,KAAoB;QADX,iBAAY,GAAZ,YAAY,CAAsB;QAC3C,UAAK,GAAL,KAAK,CAAe;IAC3B,CAAC;IAEJ,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAuB;QACnC,IAAI,CAAC,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,IAAmB,EAAE,IAAa,EAAE,KAAK,GAAG,EAAE;QACrE,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,aAAa,CAAC,OAAe,EAAE,IAAmB,EAAE,KAAK,GAAG,EAAE;QAC5D,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,IAAkB,EAAE,KAAK,GAAG,EAAE;QACvC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,WAAW,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE;QAClC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,OAA4B;QACrD,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,YAAY,CAAC,YAAoB,EAAE,IAAa;QAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,cAAc,CAAC,YAAoB,EAAE,IAAa;QAChD,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,gBAAgB,CACd,QAAgB,EAChB,MAAc,EACd,KAAK,GAAG,CAAC,EACT,QAAiB,EACjB,MAAe;QAEf,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjF,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,SAAiB,EAAE,IAAa;QAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,qBAAqB,CAAC,UAAkB;QACtC,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,OAAiC;QACrC,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA6B,EAC7B,UAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC5D,OAAO,IAAI,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/code/session.ts"],"names":[],"mappings":"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"}

package/dist/src/code/store.d.ts

@@ -0,0 +1,37 @@
+import { type CodeQuerySession } from './session.js';
+import type { CodebaseIndex } from './types.js';
+import type { OnProgress } from '../progress-event.js';
+export type StoreStrategy = 'prefer-cache' | 'ensure-fresh' | 'rebuild';
+export interface CodeIndexStoreOptions {
+    repoRoot: string;
+    cacheDir: string;
+    excludeDir?: string[];
+    noGitignore?: boolean;
+}
+export interface StoreSessionOptions {
+    strategy?: StoreStrategy;
+    signal?: AbortSignal;
+    onProgress?: OnProgress;
+}
+export interface StoreMetadata {
+    schemaVersion: number;
+    occVersion: string;
+    repoRoot: string;
+    builtAt: string;
+    fileCount: number;
+    nodeCount: number;
+    edgeCount: number;
+    loadSource: 'cache' | 'build';
+    buildOptionFingerprint: string;
+}
+export interface CodeIndexStore {
+    getSession(options?: StoreSessionOptions): Promise<CodeQuerySession>;
+    refresh(options?: {
+        signal?: AbortSignal;
+        onProgress?: OnProgress;
+    }): Promise<CodeQuerySession>;
+    exportIndex(options?: StoreSessionOptions): Promise<CodebaseIndex>;
+    clear(): Promise<void>;
+    getMetadata(): StoreMetadata | null;
+}
+export declare function openCodeIndexStore(options: CodeIndexStoreOptions): CodeIndexStore;

package/dist/src/code/store.js

@@ -0,0 +1,283 @@
+import { readFile, writeFile, mkdir, rm, stat } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildCodebaseIndex } from './build.js';
+import { createCodeQuerySessionFromIndex } from './session.js';
+import { discoverCodeFiles } from './discover.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SCHEMA_VERSION = 1;
+// Resolve version from package.json — works from both src/ (dev) and dist/src/ (built)
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+let _occVersion;
+async function getOccVersion() {
+    if (_occVersion)
+        return _occVersion;
+    for (const rel of ['../..', '../../..']) {
+        try {
+            const raw = await readFile(path.resolve(__dirname, rel, 'package.json'), 'utf8');
+            const pkg = JSON.parse(raw);
+            if (pkg.version) {
+                _occVersion = pkg.version;
+                return _occVersion;
+            }
+        }
+        catch { /* try next */ }
+    }
+    _occVersion = '0.0.0';
+    return _occVersion;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function buildOptionFingerprint(opts) {
+    const material = JSON.stringify({
+        excludeDir: (opts.excludeDir ?? []).slice().sort(),
+        noGitignore: opts.noGitignore ?? false,
+    });
+    return createHash('sha256').update(material).digest('hex').slice(0, 16);
+}
+function indexPath(cacheDir) {
+    return path.join(cacheDir, 'index.json');
+}
+function metaPath(cacheDir) {
+    return path.join(cacheDir, 'meta.json');
+}
+function manifestPath(cacheDir) {
+    return path.join(cacheDir, 'manifest.json');
+}
+function checkAbort(signal) {
+    if (signal?.aborted) {
+        throw new DOMException('The operation was aborted.', 'AbortError');
+    }
+}
+// ---------------------------------------------------------------------------
+// Cache I/O
+// ---------------------------------------------------------------------------
+async function loadCachedIndex(cacheDir) {
+    try {
+        const raw = await readFile(indexPath(cacheDir), 'utf8');
+        if (!raw)
+            return undefined;
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function loadCacheMeta(cacheDir) {
+    try {
+        const raw = await readFile(metaPath(cacheDir), 'utf8');
+        if (!raw)
+            return undefined;
+        const parsed = JSON.parse(raw);
+        if (parsed.schemaVersion !== SCHEMA_VERSION)
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function loadManifest(cacheDir) {
+    try {
+        const raw = await readFile(manifestPath(cacheDir), 'utf8');
+        if (!raw)
+            return undefined;
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function persistCache(cacheDir, index, buildOpts, onProgress) {
+    await mkdir(cacheDir, { recursive: true });
+    onProgress?.({ phase: 'serialize', total: 3, completed: 0, detail: 'writing cache' });
+    // Strip file content/lines from cached index to reduce size
+    const slimFiles = index.files.map(f => ({ ...f, content: '', lines: [] }));
+    const slimIndex = { ...index, files: slimFiles };
+    await writeFile(indexPath(cacheDir), JSON.stringify(slimIndex), 'utf8');
+    onProgress?.({ phase: 'serialize', total: 3, completed: 1, detail: 'index written' });
+    // Build and write manifest (stat calls in parallel)
+    const repoRoot = path.resolve(buildOpts.repoRoot);
+    const statResults = await Promise.all(index.files.map(async (file) => {
+        try {
+            const fileStat = await stat(path.join(repoRoot, file.relativePath));
+            return { relativePath: file.relativePath, size: fileStat.size, mtimeMs: fileStat.mtimeMs };
+        }
+        catch {
+            return null; // File may have been deleted between build and persist
+        }
+    }));
+    const manifest = statResults.filter((e) => e !== null);
+    await writeFile(manifestPath(cacheDir), JSON.stringify(manifest), 'utf8');
+    onProgress?.({ phase: 'serialize', total: 3, completed: 2, detail: 'manifest written' });
+    // Write metadata
+    const occVersion = await getOccVersion();
+    const meta = {
+        schemaVersion: SCHEMA_VERSION,
+        occVersion,
+        repoRoot: repoRoot,
+        builtAt: new Date().toISOString(),
+        fileCount: index.files.length,
+        nodeCount: index.nodes.length,
+        edgeCount: index.edges.length,
+        buildOptionFingerprint: buildOptionFingerprint(buildOpts),
+    };
+    await writeFile(metaPath(cacheDir), JSON.stringify(meta, null, 2), 'utf8');
+    onProgress?.({ phase: 'serialize', total: 3, completed: 3, detail: 'metadata written' });
+    return meta;
+}
+// ---------------------------------------------------------------------------
+// Manifest freshness check
+// ---------------------------------------------------------------------------
+async function isManifestFresh(manifest, repoRoot, buildOpts) {
+    // Discover current files to detect additions/deletions
+    const currentFiles = await discoverCodeFiles(repoRoot, {
+        excludeDir: buildOpts.excludeDir,
+        noGitignore: buildOpts.noGitignore,
+    });
+    const currentRelPaths = new Set(currentFiles.map(f => path.relative(repoRoot, f)));
+    const manifestRelPaths = new Set(manifest.map(e => e.relativePath));
+    // Check for added or deleted files
+    if (currentRelPaths.size !== manifestRelPaths.size)
+        return false;
+    for (const rel of currentRelPaths) {
+        if (!manifestRelPaths.has(rel))
+            return false;
+    }
+    // Check size and mtime for each file
+    for (const entry of manifest) {
+        try {
+            const fileStat = await stat(path.join(repoRoot, entry.relativePath));
+            if (fileStat.size !== entry.size || fileStat.mtimeMs !== entry.mtimeMs) {
+                return false;
+            }
+        }
+        catch {
+            return false; // File disappeared
+        }
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Store implementation
+// ---------------------------------------------------------------------------
+export function openCodeIndexStore(options) {
+    const repoRoot = path.resolve(options.repoRoot);
+    const { cacheDir } = options;
+    const fingerprint = buildOptionFingerprint(options);
+    const buildOpts = {
+        repoRoot,
+        excludeDir: options.excludeDir,
+        noGitignore: options.noGitignore,
+    };
+    let currentSession = null;
+    let currentMeta = null;
+    async function buildAndPersist(signal, onProgress) {
+        checkAbort(signal);
+        const index = await buildCodebaseIndex(buildOpts, onProgress);
+        checkAbort(signal);
+        const cacheMeta = await persistCache(cacheDir, index, options, onProgress);
+        const session = createCodeQuerySessionFromIndex(buildOpts, index);
+        const meta = {
+            ...cacheMeta,
+            loadSource: 'build',
+        };
+        return { session, meta };
+    }
+    async function loadFromCache(onProgress) {
+        onProgress?.({ phase: 'cache-check', total: 1, completed: 0, detail: 'checking cache' });
+        const cacheMeta = await loadCacheMeta(cacheDir);
+        if (!cacheMeta)
+            return undefined;
+        if (cacheMeta.buildOptionFingerprint !== fingerprint)
+            return undefined;
+        if (cacheMeta.occVersion !== await getOccVersion())
+            return undefined;
+        onProgress?.({ phase: 'deserialize', total: 1, completed: 0, detail: 'loading index' });
+        const cachedIndex = await loadCachedIndex(cacheDir);
+        if (!cachedIndex)
+            return undefined;
+        onProgress?.({ phase: 'deserialize', total: 1, completed: 1, detail: 'index loaded' });
+        const session = createCodeQuerySessionFromIndex(buildOpts, cachedIndex);
+        const meta = {
+            ...cacheMeta,
+            loadSource: 'cache',
+        };
+        return { session, meta };
+    }
+    return {
+        async getSession(opts) {
+            const strategy = opts?.strategy ?? 'prefer-cache';
+            const { signal, onProgress } = opts ?? {};
+            checkAbort(signal);
+            if (strategy === 'rebuild') {
+                const result = await buildAndPersist(signal, onProgress);
+                currentSession = result.session;
+                currentMeta = result.meta;
+                return result.session;
+            }
+            if (strategy === 'prefer-cache') {
+                const cached = await loadFromCache(onProgress);
+                if (cached) {
+                    currentSession = cached.session;
+                    currentMeta = cached.meta;
+                    return cached.session;
+                }
+                // Cache miss — build
+                const result = await buildAndPersist(signal, onProgress);
+                currentSession = result.session;
+                currentMeta = result.meta;
+                return result.session;
+            }
+            // ensure-fresh
+            const manifest = await loadManifest(cacheDir);
+            if (manifest) {
+                onProgress?.({ phase: 'cache-check', total: 1, completed: 0, detail: 'checking freshness' });
+                const fresh = await isManifestFresh(manifest, repoRoot, options);
+                if (fresh) {
+                    const cached = await loadFromCache(onProgress);
+                    if (cached) {
+                        currentSession = cached.session;
+                        currentMeta = cached.meta;
+                        return cached.session;
+                    }
+                }
+            }
+            // Stale or no cache — rebuild
+            const result = await buildAndPersist(signal, onProgress);
+            currentSession = result.session;
+            currentMeta = result.meta;
+            return result.session;
+        },
+        async refresh(opts) {
+            const result = await buildAndPersist(opts?.signal, opts?.onProgress);
+            currentSession = result.session;
+            currentMeta = result.meta;
+            return result.session;
+        },
+        async exportIndex(opts) {
+            if (currentSession)
+                return currentSession.getIndex();
+            const session = await this.getSession(opts);
+            return session.getIndex();
+        },
+        async clear() {
+            currentSession = null;
+            currentMeta = null;
+            try {
+                await rm(cacheDir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore if already missing
+            }
+        },
+        getMetadata() {
+            return currentMeta;
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/src/code/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/code/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAA6B,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAyB,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAuDlD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,uFAAuF;AACvF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,IAAI,WAA+B,CAAC;AACpC,KAAK,UAAU,aAAa;IAC1B,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;YACjF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;YACpD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAAC,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;gBAAC,OAAO,WAAW,CAAC;YAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC;IACD,WAAW,GAAG,OAAO,CAAC;IACtB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,sBAAsB,CAAC,IAA2B;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,UAAU,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE;QAClD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,KAAK;KACvC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,MAAoB;IACtC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;QAC5C,IAAI,MAAM,CAAC,aAAa,KAAK,cAAc;YAAE,OAAO,SAAS,CAAC;QAC9D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,QAAgB,EAChB,KAAoB,EACpB,SAAgC,EAChC,UAAuB;IAEvB,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAEtF,4DAA4D;IAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACjD,MAAM,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IACxE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAEtF,oDAAoD;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAiC,EAAE;QAC5D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;YACpE,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC7F,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,CAAC,uDAAuD;QACtE,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IACF,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC3E,MAAM,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1E,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAEzF,iBAAiB;IACjB,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;IACzC,MAAM,IAAI,GAAc;QACtB,aAAa,EAAE,cAAc;QAC7B,UAAU;QACV,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACjC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QAC7B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QAC7B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QAC7B,sBAAsB,EAAE,sBAAsB,CAAC,SAAS,CAAC;KAC1D,CAAC;IACF,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3E,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAEzF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,KAAK,UAAU,eAAe,CAC5B,QAAyB,EACzB,QAAgB,EAChB,SAAgC;IAEhC,uDAAuD;IACvD,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE;QACrD,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,WAAW,EAAE,SAAS,CAAC,WAAW;KACnC,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAClD,CAAC;IACF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IAEpE,mCAAmC;IACnC,IAAI,eAAe,CAAC,IAAI,KAAK,gBAAgB,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACjE,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC/C,CAAC;IAED,qCAAqC;IACrC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;YACrE,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,CAAC,mBAAmB;QACnC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,UAAU,kBAAkB,CAAC,OAA8B;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAyB;QACtC,QAAQ;QACR,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;IAEF,IAAI,cAAc,GAA4B,IAAI,CAAC;IACnD,IAAI,WAAW,GAAyB,IAAI,CAAC;IAE7C,KAAK,UAAU,eAAe,CAC5B,MAAoB,EACpB,UAAuB;QAEvB,UAAU,CAAC,MAAM,CAAC,CAAC;QAEnB,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAE9D,UAAU,CAAC,MAAM,CAAC,CAAC;QAEnB,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,+BAA+B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,IAAI,GAAkB;YAC1B,GAAG,SAAS;YACZ,UAAU,EAAE,OAAO;SACpB,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,UAAU,aAAa,CAC1B,UAAuB;QAEvB,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAEzF,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,IAAI,SAAS,CAAC,sBAAsB,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QACvE,IAAI,SAAS,CAAC,UAAU,KAAK,MAAM,aAAa,EAAE;YAAE,OAAO,SAAS,CAAC;QAErE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QAExF,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW;YAAE,OAAO,SAAS,CAAC;QAEnC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAEvF,MAAM,OAAO,GAAG,+BAA+B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxE,MAAM,IAAI,GAAkB;YAC1B,GAAG,SAAS;YACZ,UAAU,EAAE,OAAO;SACpB,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,IAA0B;YACzC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,cAAc,CAAC;YAClD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;YAE1C,UAAU,CAAC,MAAM,CAAC,CAAC;YAEnB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBACzD,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;gBAChC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;gBAC1B,OAAO,MAAM,CAAC,OAAO,CAAC;YACxB,CAAC;YAED,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;gBAC/C,IAAI,MAAM,EAAE,CAAC;oBACX,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;oBAChC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;oBAC1B,OAAO,MAAM,CAAC,OAAO,CAAC;gBACxB,CAAC;gBACD,qBAAqB;gBACrB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBACzD,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;gBAChC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;gBAC1B,OAAO,MAAM,CAAC,OAAO,CAAC;YACxB,CAAC;YAED,eAAe;YACf,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,QAAQ,EAAE,CAAC;gBACb,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;gBAC7F,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACjE,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;oBAC/C,IAAI,MAAM,EAAE,CAAC;wBACX,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;wBAChC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;wBAC1B,OAAO,MAAM,CAAC,OAAO,CAAC;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,8BAA8B;YAC9B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACzD,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;YAChC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;YAC1B,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,IAAwD;YACpE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YACrE,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;YAChC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;YAC1B,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,IAA0B;YAC1C,IAAI,cAAc;gBAAE,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC;YACrD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC;QAED,KAAK,CAAC,KAAK;YACT,cAAc,GAAG,IAAI,CAAC;YACtB,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,WAAW;YACT,OAAO,WAAW,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,51 @@
+import { buildCodebaseIndex } from './code/build.js';
+import { createCodeQuerySession, createCodeQuerySessionFromIndex } from './code/session.js';
+import { openCodeIndexStore } from './code/store.js';
+import { chunkCodebase, chunkFromIndex } from './code/chunk.js';
+import { discoverCodeFiles } from './code/discover.js';
+import { inspectDocument } from './doc/inspect.js';
+import { discoverDocuments } from './doc/discover.js';
+import { inspectWorkbook } from './sheet/inspect.js';
+import { inspectPresentation } from './slide/inspect.js';
+import { analyzeWorkspace } from './workspace/analyze.js';
+import { inspectWorkspaceDocumentSet } from './workspace/documents.js';
+import { prepareWorkspaceContext } from './workspace/prepare.js';
+export type { CodebaseIndex, CodeNode, CodeEdge, CodeNodeType, CodeEdgeType } from './code/types.js';
+export type { CodeQuerySession, CodeSessionChunkOptions } from './code/session.js';
+export type { CodeIndexStore, CodeIndexStoreOptions, StoreStrategy, StoreMetadata, StoreSessionOptions } from './code/store.js';
+export type { CodeChunk } from './code/chunk.js';
+export type { BuildCodebaseOptions } from './code/build.js';
+export type { OnProgress, ProgressEvent } from './progress-event.js';
+export type { WorkspacePrepareOptions, WorkspacePreparedContext, WorkspacePreparationProgressEvent, OnPrepareProgress } from './workspace/prepare-types.js';
+export interface OccCodeNamespace {
+    buildIndex: typeof buildCodebaseIndex;
+    createSession: typeof createCodeQuerySession;
+    createSessionFromIndex: typeof createCodeQuerySessionFromIndex;
+    openStore: typeof openCodeIndexStore;
+    discover: typeof discoverCodeFiles;
+    chunk: typeof chunkCodebase;
+    chunkFromIndex: typeof chunkFromIndex;
+}
+export interface OccWorkspaceNamespace {
+    analyze: typeof analyzeWorkspace;
+    inspectDocuments: typeof inspectWorkspaceDocumentSet;
+    prepare: typeof prepareWorkspaceContext;
+}
+export interface OccDocNamespace {
+    inspect: typeof inspectDocument;
+    discover: typeof discoverDocuments;
+}
+export interface OccSheetNamespace {
+    inspect: typeof inspectWorkbook;
+}
+export interface OccSlideNamespace {
+    inspect: typeof inspectPresentation;
+}
+export interface OccNamespace {
+    code: OccCodeNamespace;
+    workspace: OccWorkspaceNamespace;
+    doc: OccDocNamespace;
+    sheet: OccSheetNamespace;
+    slide: OccSlideNamespace;
+}
+export declare function createOcc(): OccNamespace;

package/dist/src/index.js

@@ -0,0 +1,41 @@
+import { buildCodebaseIndex } from './code/build.js';
+import { createCodeQuerySession, createCodeQuerySessionFromIndex, } from './code/session.js';
+import { openCodeIndexStore } from './code/store.js';
+import { chunkCodebase, chunkFromIndex } from './code/chunk.js';
+import { discoverCodeFiles } from './code/discover.js';
+import { inspectDocument } from './doc/inspect.js';
+import { discoverDocuments } from './doc/discover.js';
+import { inspectWorkbook } from './sheet/inspect.js';
+import { inspectPresentation } from './slide/inspect.js';
+import { analyzeWorkspace } from './workspace/analyze.js';
+import { inspectWorkspaceDocumentSet } from './workspace/documents.js';
+import { prepareWorkspaceContext } from './workspace/prepare.js';
+export function createOcc() {
+    return {
+        code: {
+            buildIndex: buildCodebaseIndex,
+            createSession: createCodeQuerySession,
+            createSessionFromIndex: createCodeQuerySessionFromIndex,
+            openStore: openCodeIndexStore,
+            discover: discoverCodeFiles,
+            chunk: chunkCodebase,
+            chunkFromIndex: chunkFromIndex,
+        },
+        workspace: {
+            analyze: analyzeWorkspace,
+            inspectDocuments: inspectWorkspaceDocumentSet,
+            prepare: prepareWorkspaceContext,
+        },
+        doc: {
+            inspect: inspectDocument,
+            discover: discoverDocuments,
+        },
+        sheet: {
+            inspect: inspectWorkbook,
+        },
+        slide: {
+            inspect: inspectPresentation,
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAgDjE,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,IAAI,EAAE;YACJ,UAAU,EAAE,kBAAkB;YAC9B,aAAa,EAAE,sBAAsB;YACrC,sBAAsB,EAAE,+BAA+B;YACvD,SAAS,EAAE,kBAAkB;YAC7B,QAAQ,EAAE,iBAAiB;YAC3B,KAAK,EAAE,aAAa;YACpB,cAAc,EAAE,cAAc;SAC/B;QACD,SAAS,EAAE;YACT,OAAO,EAAE,gBAAgB;YACzB,gBAAgB,EAAE,2BAA2B;YAC7C,OAAO,EAAE,uBAAuB;SACjC;QACD,GAAG,EAAE;YACH,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,iBAAiB;SAC5B;QACD,KAAK,EAAE;YACL,OAAO,EAAE,eAAe;SACzB;QACD,KAAK,EAAE;YACL,OAAO,EAAE,mBAAmB;SAC7B;KACF,CAAC;AACJ,CAAC"}

package/dist/src/workspace/documents.d.ts

@@ -1,3 +1,4 @@
+import type { OnProgress } from '../progress-event.js';
 import type { WorkspaceDocumentSet } from './types.js';
 export interface InspectWorkspaceDocumentSetOptions {
     excludeDir?: string[];
@@ -7,4 +8,4 @@ export interface InspectWorkspaceDocumentSetOptions {
     maxReferenceFiles?: number;
     includeMarkdown?: boolean;
 }
-export declare function inspectWorkspaceDocumentSet(rootDir: string, options?: InspectWorkspaceDocumentSetOptions): Promise<WorkspaceDocumentSet>;
+export declare function inspectWorkspaceDocumentSet(rootDir: string, options?: InspectWorkspaceDocumentSetOptions, onProgress?: OnProgress): Promise<WorkspaceDocumentSet>;

package/dist/src/workspace/documents.js

@@ -5,7 +5,7 @@ import { documentToMarkdown } from '../markdown/convert.js';
 import { detectCrossReferences } from '../doc/references.js';
 import { inspectDocumentSummary } from '../doc/batch.js';
 const DOCUMENT_FORMATS = new Set(['docx', 'pdf', 'pptx', 'xlsx', 'odt', 'ods', 'odp']);
-export async function inspectWorkspaceDocumentSet(rootDir, options = {}) {
+export async function inspectWorkspaceDocumentSet(rootDir, options = {}, onProgress) {
     const resolvedRoot = path.resolve(rootDir);
     const excludeDir = options.excludeDir ?? ['node_modules', '.git', 'dist', 'vendor', 'build', 'coverage', 'target'];
     const discovery = await findFiles([resolvedRoot], {
@@ -22,7 +22,20 @@ export async function inspectWorkspaceDocumentSet(rootDir, options = {}) {
     const discovered = discovery.files
         .filter((file) => DOCUMENT_FORMATS.has(getExtension(file.path)))
         .slice(0, maxFiles);
-    for (const file of discovered) {
+    onProgress?.({ phase: 'discover', total: discovered.length, completed: discovered.length, detail: discovered.length > 0 ? `${discovered.length} documents found` : 'No documents found' });
+    if (discovered.length === 0) {
+        return {
+            schemaVersion: 1,
+            rootDir: resolvedRoot,
+            documents: [],
+            crossReferences: [],
+            unresolvedMentions: [],
+            skipped: discovery.skipped,
+            errors: [],
+        };
+    }
+    for (let i = 0; i < discovered.length; i++) {
+        const file = discovered[i];
         const relativePath = path.relative(resolvedRoot, file.path).split(path.sep).join('/');
         const format = getExtension(file.path);
         const result = await inspectDocumentSummary(file.path, relativePath, format, { includeMarkdown });
@@ -36,9 +49,12 @@ export async function inspectWorkspaceDocumentSet(rootDir, options = {}) {
                 message: result.error,
             });
         }
+        onProgress?.({ phase: 'inspect', total: discovered.length, completed: i + 1, detail: relativePath });
     }
     const docsWithContent = [];
-    for (const doc of documents.slice(0, maxReferenceFiles)) {
+    const refSlice = documents.slice(0, maxReferenceFiles);
+    for (let i = 0; i < refSlice.length; i++) {
+        const doc = refSlice[i];
         try {
             const content = doc.markdownContent ?? markdownByPath.get(doc.filePath) ?? await documentToMarkdown(doc.filePath);
             if (content)
@@ -51,10 +67,12 @@ export async function inspectWorkspaceDocumentSet(rootDir, options = {}) {
                 message: error.message,
             });
         }
+        onProgress?.({ phase: 'references', total: refSlice.length, completed: i + 1, detail: path.relative(resolvedRoot, doc.filePath).split(path.sep).join('/') });
     }
     const references = docsWithContent.length >= 2
         ? detectCrossReferences(docsWithContent)
         : { references: [], unresolvedMentions: [] };
+    onProgress?.({ phase: 'cross-references', total: 1, completed: 1, detail: `${references.references.length} cross-references detected` });
     return {
         schemaVersion: 1,
         rootDir: resolvedRoot,

package/dist/src/workspace/documents.js.map

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

package/dist/src/workspace/prepare-runner.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Internal subprocess entry point for workspace preparation.
+ * Spawned via fork() by prepare.ts — not a public API.
+ *
+ * IPC protocol:
+ *   Parent → Child:  { type: 'start', options: BuildCodebaseOptions }
+ *   Child → Parent:  { type: 'progress', event: ProgressEvent }
+ *   Child → Parent:  { type: 'complete', resultPath: string }
+ *   Child → Parent:  { type: 'error', message: string }
+ */
+export {};

package/dist/src/workspace/prepare-runner.js

@@ -0,0 +1,40 @@
+/**
+ * Internal subprocess entry point for workspace preparation.
+ * Spawned via fork() by prepare.ts — not a public API.
+ *
+ * IPC protocol:
+ *   Parent → Child:  { type: 'start', options: BuildCodebaseOptions }
+ *   Child → Parent:  { type: 'progress', event: ProgressEvent }
+ *   Child → Parent:  { type: 'complete', resultPath: string }
+ *   Child → Parent:  { type: 'error', message: string }
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { buildCodebaseIndex } from '../code/build.js';
+function send(msg) {
+    if (process.send) {
+        process.send(msg);
+    }
+}
+process.on('message', async (msg) => {
+    if (msg.type !== 'start')
+        return;
+    try {
+        const index = await buildCodebaseIndex(msg.options, (event) => {
+            send({ type: 'progress', event });
+        });
+        // Write index to temp file to avoid IPC size limits (~50MB+ indexes)
+        const resultPath = join(tmpdir(), `occ-prepare-${process.pid}-${Date.now()}.json`);
+        writeFileSync(resultPath, JSON.stringify(index));
+        send({ type: 'complete', resultPath });
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        send({ type: 'error', message: error.message });
+    }
+    if (process.connected) {
+        process.disconnect?.();
+    }
+});
+//# sourceMappingURL=prepare-runner.js.map

package/dist/src/workspace/prepare-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-runner.js","sourceRoot":"","sources":["../../../src/workspace/prepare-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAStD,SAAS,IAAI,CAAC,GAA6C;IACzD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAiB,EAAE,EAAE;IAChD,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO;IAEjC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,KAAoB,EAAE,EAAE;YAC3E,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,qEAAqE;QACrE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACnF,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;IACzB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/src/workspace/prepare-types.d.ts

@@ -0,0 +1,50 @@
+import type { CodebaseIndex } from '../code/types.js';
+import type { WorkspaceDocumentSet } from './types.js';
+export interface WorkspacePrepareOptions {
+    /** Include code indexing via buildCodebaseIndex. Default: true. */
+    includeCode?: boolean;
+    /** Include document inspection via inspectWorkspaceDocumentSet. Default: true. */
+    includeDocuments?: boolean;
+    /** Directories to exclude from both code and document discovery. */
+    excludeDir?: string[];
+    /** Disable .gitignore respect. */
+    noGitignore?: boolean;
+    /** Maximum document file size in MB. */
+    largeFileLimitMb?: number;
+    /** Maximum number of document files to inspect. */
+    maxFiles?: number;
+    /** Maximum number of documents to load for cross-reference detection. */
+    maxReferenceFiles?: number;
+    /** Include raw markdown content in document summaries. */
+    includeMarkdown?: boolean;
+    /**
+     * Execution mode for code indexing.
+     * - `'auto'` (default): subprocess when code indexing is enabled, inline for docs-only.
+     * - `'inline'`: run code indexing in the current process.
+     * - `'subprocess'`: always fork a child process for code indexing.
+     */
+    executionMode?: 'auto' | 'inline' | 'subprocess';
+}
+export interface WorkspacePreparedContext {
+    rootDir: string;
+    code: {
+        index: CodebaseIndex;
+        fileCount: number;
+        nodeCount: number;
+        edgeCount: number;
+    } | null;
+    documents: WorkspaceDocumentSet | null;
+    elapsedMs: number;
+    errors: string[];
+}
+export interface WorkspacePreparationProgressEvent {
+    /** Which subsystem is reporting: 'prepare' for overall, 'code' for indexing, 'documents' for inspection. */
+    scope: 'prepare' | 'code' | 'documents';
+    /** Current stage within the scope (e.g. 'discover', 'parse', 'index', 'inspect', 'references'). */
+    stage: string;
+    completed: number;
+    total: number;
+    detail?: string;
+    stats?: Record<string, number>;
+}
+export type OnPrepareProgress = (event: WorkspacePreparationProgressEvent) => void;

package/dist/src/workspace/prepare-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prepare-types.js.map

package/dist/src/workspace/prepare-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-types.js","sourceRoot":"","sources":["../../../src/workspace/prepare-types.ts"],"names":[],"mappings":""}

package/dist/src/workspace/prepare.d.ts

@@ -0,0 +1,2 @@
+import type { WorkspacePrepareOptions, WorkspacePreparedContext, OnPrepareProgress } from './prepare-types.js';
+export declare function prepareWorkspaceContext(rootDir: string, options?: WorkspacePrepareOptions, onProgress?: OnPrepareProgress): Promise<WorkspacePreparedContext>;

package/dist/src/workspace/prepare.js

@@ -0,0 +1,151 @@
+import path from 'node:path';
+import { fork } from 'node:child_process';
+import { readFileSync, unlinkSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { buildCodebaseIndex } from '../code/build.js';
+import { inspectWorkspaceDocumentSet } from './documents.js';
+function resolveExecutionMode(options) {
+    const mode = options.executionMode ?? 'auto';
+    if (mode === 'inline')
+        return 'inline';
+    if (mode === 'subprocess')
+        return 'subprocess';
+    // auto: subprocess when code indexing is enabled
+    return (options.includeCode !== false) ? 'subprocess' : 'inline';
+}
+function mapCodeProgress(event, onProgress) {
+    onProgress({
+        scope: 'code',
+        stage: event.phase,
+        completed: event.completed,
+        total: event.total,
+        detail: event.detail,
+    });
+}
+async function buildCodeInline(rootDir, options, onProgress) {
+    return buildCodebaseIndex({
+        repoRoot: rootDir,
+        excludeDir: options.excludeDir,
+        noGitignore: options.noGitignore,
+    }, onProgress ? (event) => mapCodeProgress(event, onProgress) : undefined);
+}
+async function buildCodeSubprocess(rootDir, options, onProgress) {
+    const runnerPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), 'prepare-runner.js');
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const child = fork(runnerPath, [], { stdio: ['ignore', 'ignore', 'pipe', 'ipc'] });
+        let stderr = '';
+        child.stderr?.on('data', (d) => {
+            stderr += d.toString();
+        });
+        child.on('message', (msg) => {
+            if (msg.type === 'progress' && msg.event && onProgress) {
+                mapCodeProgress(msg.event, onProgress);
+            }
+            else if (msg.type === 'complete' && msg.resultPath) {
+                settled = true;
+                try {
+                    const index = JSON.parse(readFileSync(msg.resultPath, 'utf-8'));
+                    unlinkSync(msg.resultPath);
+                    resolve(index);
+                }
+                catch (err) {
+                    reject(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+            else if (msg.type === 'error') {
+                settled = true;
+                reject(new Error(msg.message ?? 'Subprocess failed'));
+            }
+        });
+        child.on('error', (err) => {
+            settled = true;
+            reject(err);
+        });
+        child.on('close', (code) => {
+            if (settled)
+                return;
+            if (code !== 0) {
+                reject(new Error(`Prepare runner exited with code ${code}: ${stderr.trim()}`));
+            }
+            else {
+                reject(new Error('Prepare runner exited without sending a result'));
+            }
+        });
+        child.send({
+            type: 'start',
+            options: {
+                repoRoot: rootDir,
+                excludeDir: options.excludeDir,
+                noGitignore: options.noGitignore,
+            },
+        });
+    });
+}
+export async function prepareWorkspaceContext(rootDir, options = {}, onProgress) {
+    const resolvedRoot = path.resolve(rootDir);
+    const startedAt = Date.now();
+    const errors = [];
+    const includeCode = options.includeCode !== false;
+    const includeDocuments = options.includeDocuments !== false;
+    onProgress?.({ scope: 'prepare', stage: 'start', completed: 0, total: 1, detail: 'Starting workspace preparation' });
+    // Phase 1: Code indexing
+    let codeResult = null;
+    if (includeCode) {
+        try {
+            const mode = resolveExecutionMode(options);
+            const buildFn = mode === 'subprocess' ? buildCodeSubprocess : buildCodeInline;
+            const index = await buildFn(resolvedRoot, options, onProgress);
+            codeResult = {
+                index,
+                fileCount: index.files.length,
+                nodeCount: index.nodes.length,
+                edgeCount: index.edges.length,
+            };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            errors.push(`Code indexing failed: ${error.message}`);
+        }
+    }
+    // Phase 2: Document inspection
+    let documentsResult = null;
+    if (includeDocuments) {
+        try {
+            const docSet = await inspectWorkspaceDocumentSet(resolvedRoot, {
+                excludeDir: options.excludeDir,
+                noGitignore: options.noGitignore,
+                largeFileLimitMb: options.largeFileLimitMb,
+                maxFiles: options.maxFiles,
+                maxReferenceFiles: options.maxReferenceFiles,
+                includeMarkdown: options.includeMarkdown,
+            }, onProgress ? (event) => {
+                onProgress({
+                    scope: 'documents',
+                    stage: event.phase,
+                    completed: event.completed,
+                    total: event.total,
+                    detail: event.detail,
+                });
+            } : undefined);
+            documentsResult = docSet;
+            for (const err of docSet.errors) {
+                errors.push(`Document error${err.path ? ` (${err.path})` : ''}: ${err.message}`);
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            errors.push(`Document inspection failed: ${error.message}`);
+        }
+    }
+    const elapsedMs = Date.now() - startedAt;
+    onProgress?.({ scope: 'prepare', stage: 'complete', completed: 1, total: 1, detail: `Completed in ${elapsedMs}ms` });
+    return {
+        rootDir: resolvedRoot,
+        code: codeResult,
+        documents: documentsResult,
+        elapsedMs,
+        errors,
+    };
+}
+//# sourceMappingURL=prepare.js.map

package/dist/src/workspace/prepare.js.map

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

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@cesarandreslopez/occ",
-  "version": "0.6.3",
+  "version": "0.8.0",
   "description": "Office Cloc and Count — scc-style summary tables for office documents",
   "type": "module",
-  "main": "./dist/bin/occ.js",
-  "types": "./dist/bin/occ.d.ts",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "bin": {
     "occ": "./dist/bin/occ.js"
   },
@@ -37,8 +37,8 @@
   ],
   "exports": {
     ".": {
-      "types": "./dist/bin/occ.d.ts",
-      "default": "./dist/bin/occ.js"
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
     },
     "./code/build": {
       "types": "./dist/src/code/build.d.ts",
@@ -68,6 +68,10 @@
       "types": "./dist/src/code/cache.d.ts",
       "default": "./dist/src/code/cache.js"
     },
+    "./code/store": {
+      "types": "./dist/src/code/store.d.ts",
+      "default": "./dist/src/code/store.js"
+    },
     "./doc/inspect": {
       "types": "./dist/src/doc/inspect.d.ts",
       "default": "./dist/src/doc/inspect.js"
@@ -96,6 +100,14 @@
       "types": "./dist/src/workspace/types.d.ts",
       "default": "./dist/src/workspace/types.js"
     },
+    "./workspace/prepare": {
+      "types": "./dist/src/workspace/prepare.d.ts",
+      "default": "./dist/src/workspace/prepare.js"
+    },
+    "./workspace/prepare-types": {
+      "types": "./dist/src/workspace/prepare-types.d.ts",
+      "default": "./dist/src/workspace/prepare-types.js"
+    },
     "./markdown/convert": {
       "types": "./dist/src/markdown/convert.d.ts",
       "default": "./dist/src/markdown/convert.js"
@@ -172,6 +184,9 @@
       "code/cache": [
         "dist/src/code/cache.d.ts"
       ],
+      "code/store": [
+        "dist/src/code/store.d.ts"
+      ],
       "doc/inspect": [
         "dist/src/doc/inspect.d.ts"
       ],
@@ -199,6 +214,12 @@
       "workspace/types": [
         "dist/src/workspace/types.d.ts"
       ],
+      "workspace/prepare": [
+        "dist/src/workspace/prepare.d.ts"
+      ],
+      "workspace/prepare-types": [
+        "dist/src/workspace/prepare-types.d.ts"
+      ],
       "markdown/convert": [
         "dist/src/markdown/convert.d.ts"
       ],