@cesarandreslopez/occ 0.7.0 → 0.8.1

package/README.md

@@ -340,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 |
@@ -472,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/index.d.ts

@@ -9,12 +9,14 @@ 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;
@@ -27,6 +29,7 @@ export interface OccCodeNamespace {
 export interface OccWorkspaceNamespace {
     analyze: typeof analyzeWorkspace;
     inspectDocuments: typeof inspectWorkspaceDocumentSet;
+    prepare: typeof prepareWorkspaceContext;
 }
 export interface OccDocNamespace {
     inspect: typeof inspectDocument;

package/dist/src/index.js

@@ -9,6 +9,7 @@ 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: {
@@ -23,6 +24,7 @@ export function createOcc() {
         workspace: {
             analyze: analyzeWorkspace,
             inspectDocuments: inspectWorkspaceDocumentSet,
+            prepare: prepareWorkspaceContext,
         },
         doc: {
             inspect: inspectDocument,

package/dist/src/index.js.map

@@ -1 +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;AA8CvE,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;SAC9C;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"}
+{"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,77 @@
+/**
+ * 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 { openSync, writeSync, closeSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { buildCodebaseIndex } from '../code/build.js';
+/**
+ * Write a CodebaseIndex to disk element-by-element via file descriptor,
+ * avoiding V8's ~512MB string length limit that JSON.stringify() hits
+ * on large codebases.
+ */
+function streamIndexToFile(index, filePath) {
+    const fd = openSync(filePath, 'w');
+    try {
+        writeSync(fd, '{"repoRoot":');
+        writeSync(fd, JSON.stringify(index.repoRoot));
+        writeSync(fd, ',"capabilities":');
+        writeSync(fd, JSON.stringify(index.capabilities));
+        writeSync(fd, ',"files":[');
+        for (let i = 0; i < index.files.length; i++) {
+            if (i > 0)
+                writeSync(fd, ',');
+            writeSync(fd, JSON.stringify(index.files[i]));
+        }
+        writeSync(fd, '],"nodes":[');
+        for (let i = 0; i < index.nodes.length; i++) {
+            if (i > 0)
+                writeSync(fd, ',');
+            writeSync(fd, JSON.stringify(index.nodes[i]));
+        }
+        writeSync(fd, '],"edges":[');
+        for (let i = 0; i < index.edges.length; i++) {
+            if (i > 0)
+                writeSync(fd, ',');
+            writeSync(fd, JSON.stringify(index.edges[i]));
+        }
+        writeSync(fd, ']}');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+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 });
+        });
+        // Stream index to temp file element-by-element to avoid V8's ~512MB
+        // string length limit on JSON.stringify for large codebases.
+        const resultPath = join(tmpdir(), `occ-prepare-${process.pid}-${Date.now()}.json`);
+        streamIndexToFile(index, resultPath);
+        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":"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"}

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,152 @@
+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 buf = readFileSync(msg.resultPath);
+                    const index = JSON.parse(buf);
+                    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,6 +1,6 @@
 {
   "name": "@cesarandreslopez/occ",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Office Cloc and Count — scc-style summary tables for office documents",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -100,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"
@@ -206,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"
       ],