@openuji/speculator 0.3.1 → 0.4.0

package/dist/pipeline/__tests__/single-as-workspace.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-as-workspace.test.js","sourceRoot":"","sources":["../../../src/pipeline/__tests__/single-as-workspace.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC9C,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC;YAC9B,KAAK,EAAE,UAAU;YACjB,YAAY;SACf,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/pipeline/__tests__/workspace-rules.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workspace Hierarchical Rules Tests
+ *
+ * NOTE: These tests are now obsolete as workspace validation has been moved
+ * to the standalone @openuji/speculator-lint package.
+ *
+ * The core pipeline no longer performs validation - it only parses, indexes, and resolves.
+ * See @openuji/speculator-lint package for workspace rule validation tests.
+ */
+export {};
+//# sourceMappingURL=workspace-rules.test.d.ts.map

package/dist/pipeline/__tests__/workspace-rules.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-rules.test.d.ts","sourceRoot":"","sources":["../../../src/pipeline/__tests__/workspace-rules.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/pipeline/__tests__/workspace-rules.test.js

@@ -0,0 +1,54 @@
+/**
+ * Workspace Hierarchical Rules Tests
+ *
+ * NOTE: These tests are now obsolete as workspace validation has been moved
+ * to the standalone @openuji/speculator-lint package.
+ *
+ * The core pipeline no longer performs validation - it only parses, indexes, and resolves.
+ * See @openuji/speculator-lint package for workspace rule validation tests.
+ */
+import { describe, it, expect } from 'vitest';
+import { SpeculatorPipeline } from '../runner.js';
+import { corePlugins } from '../../postprocess/index.js';
+import { MemoryFileProvider } from '#src/file-provider/memory';
+describe('Workspace Basic Functionality', () => {
+    it('should process workspace with multiple documents', async () => {
+        const fileProvider = new MemoryFileProvider();
+        fileProvider.setFile('/spec/high.html', `
+            <dfn id="dfn-concept">Concept A</dfn>
+        `);
+        fileProvider.setFile('/spec/low.html', `
+            <p>Some content</p>
+        `);
+        const pipeline = new SpeculatorPipeline(corePlugins);
+        const result = await pipeline.runWorkspace({
+            entries: [
+                { entry: '/spec/high.html' },
+                { entry: '/spec/low.html' }
+            ],
+            fileProvider
+        });
+        expect(result.workspace).toBeDefined();
+        expect(result.workspace?.documents.length).toBe(2);
+    });
+    it('should allow cross-document references', async () => {
+        const fileProvider = new MemoryFileProvider();
+        fileProvider.setFile('/spec/high.html', `
+            <dfn id="dfn-concept-a">Concept A</dfn>
+        `);
+        fileProvider.setFile('/spec/low.html', `
+            <p>Reference to <a data-link-type="dfn">Concept A</a></p>
+        `);
+        const pipeline = new SpeculatorPipeline(corePlugins);
+        const result = await pipeline.runWorkspace({
+            entries: [
+                { entry: '/spec/high.html' },
+                { entry: '/spec/low.html' }
+            ],
+            fileProvider
+        });
+        expect(result.workspace).toBeDefined();
+        expect(result.workspace?.documents.length).toBe(2);
+    });
+});
+//# sourceMappingURL=workspace-rules.test.js.map

package/dist/pipeline/__tests__/workspace-rules.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-rules.test.js","sourceRoot":"","sources":["../../../src/pipeline/__tests__/workspace-rules.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC9C,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE;;SAEvC,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,gBAAgB,EAAE;;SAEtC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC;YACvC,OAAO,EAAE;gBACL,EAAE,KAAK,EAAE,iBAAiB,EAAE;gBAC5B,EAAE,KAAK,EAAE,gBAAgB,EAAE;aAC9B;YACD,YAAY;SACf,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC9C,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE;;SAEvC,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,gBAAgB,EAAE;;SAEtC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC;YACvC,OAAO,EAAE;gBACL,EAAE,KAAK,EAAE,iBAAiB,EAAE;gBAC5B,EAAE,KAAK,EAAE,gBAAgB,EAAE;aAC9B;YACD,YAAY;SACf,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/pipeline/__tests__/workspace.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace.test.d.ts.map

package/dist/pipeline/__tests__/workspace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.test.d.ts","sourceRoot":"","sources":["../../../src/pipeline/__tests__/workspace.test.ts"],"names":[],"mappings":""}

package/dist/pipeline/__tests__/workspace.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect } from 'vitest';
+import { SpeculatorPipeline } from '../runner.js';
+import { MemoryFileProvider } from '#src/file-provider/memory';
+import { corePlugins } from '#src/postprocess/index.js';
+describe('Workspace processing', () => {
+    it('should resolve cross-document references between HTML documents', async () => {
+        const fileProvider = new MemoryFileProvider();
+        // Spec A defines a term
+        fileProvider.setFile('/spec-a.html', `
+            <section>
+                <h1>Spec A</h1>
+                <p>This defines <dfn id="term-a">Term A</dfn>.</p>
+            </section>
+        `);
+        // Spec B references that term
+        fileProvider.setFile('/spec-b.html', `
+            <section>
+                <h1>Spec B</h1>
+                <p>This references <a data-link-type="dfn">Term A</a>.</p>
+            </section>
+        `);
+        const pipeline = new SpeculatorPipeline(corePlugins);
+        const result = await pipeline.runWorkspace({
+            entries: [
+                { entry: '/spec-a.html' },
+                { entry: '/spec-b.html' }
+            ],
+            fileProvider
+        });
+        expect(result.workspace).toBeDefined();
+        expect(result.workspace?.type).toBe('workspace');
+        expect(result.workspace?.documents.length).toBe(2);
+        // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain
+        const docA = result.workspace?.documents.find(d => d.sourcePos?.file === '/spec-a.html');
+        // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain
+        const docB = result.workspace?.documents.find(d => d.sourcePos?.file === '/spec-b.html');
+        // Check if Term A was indexed in docA
+        expect(docA.indexes?.definitions?.length).toBeGreaterThan(0);
+        // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain
+        const termA = docA.indexes?.definitions?.find(d => d.term === 'term a'); // normalized
+        expect(termA).toBeDefined();
+        expect(termA.id).toBe('term-a');
+        // Check if Term A was resolved in docB
+        let resolved = false;
+        // Deep walk docB to find the reference
+        const findRef = (node) => {
+            if (typeof node === 'object' && node !== null && 'type' in node) {
+                if (node.type === 'reference' && 'targetTerm' in node && node.targetTerm === 'term a') {
+                    expect('targetId' in node ? node.targetId : undefined).toBe('term-a');
+                    resolved = true;
+                }
+                if ('children' in node && Array.isArray(node.children)) {
+                    node.children.forEach(findRef);
+                }
+            }
+        };
+        docB.children.forEach(findRef);
+        expect(resolved).toBe(true);
+    });
+});
+//# sourceMappingURL=workspace.test.js.map

package/dist/pipeline/__tests__/workspace.test.js.map

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

package/dist/pipeline/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Pipeline Entrypoint
+ *
+ * Single entrypoint for processing specifications with plugins.
+ */
+import type { SpeculateOptions, SpeculateResult } from './types.js';
+export type { Plugin, Phase, PostprocessPhase, SpeculateOptions, SpeculateResult, Workspace } from './types.js';
+export { SpeculatorPipeline } from './runner.js';
+export { PHASES, POSTPROCESS_PHASES } from './types.js';
+/**
+ * Process a specification with the given plugins.
+ *
+ * This is the main entrypoint for the speculator pipeline.
+ *
+ * @param options - Pipeline options including entry, config, and plugins
+ * @returns Result with document and diagnostics
+ *
+ * @example
+ * ```typescript
+ * import { speculate, coreMarkdownPlugin, coreHtmlPlugin } from 'speculator';
+ *
+ * const result = await speculate({
+ *   entry: './spec/index.md',
+ *   configPath: './spec/config.respec.json',
+ *   plugins: [coreMarkdownPlugin, coreHtmlPlugin],
+ * });
+ *
+ * if (!result.hasErrors) {
+ *   console.log(result.document);
+ * }
+ * ```
+ */
+export declare function speculate(options: SpeculateOptions): Promise<SpeculateResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEhH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAcnF"}

package/dist/pipeline/index.js

@@ -0,0 +1,45 @@
+/**
+ * Pipeline Entrypoint
+ *
+ * Single entrypoint for processing specifications with plugins.
+ */
+import { NodeFileProvider } from '#src/file-provider/node';
+import { SpeculatorPipeline } from './runner.js';
+export { SpeculatorPipeline } from './runner.js';
+export { PHASES, POSTPROCESS_PHASES } from './types.js';
+/**
+ * Process a specification with the given plugins.
+ *
+ * This is the main entrypoint for the speculator pipeline.
+ *
+ * @param options - Pipeline options including entry, config, and plugins
+ * @returns Result with document and diagnostics
+ *
+ * @example
+ * ```typescript
+ * import { speculate, coreMarkdownPlugin, coreHtmlPlugin } from 'speculator';
+ *
+ * const result = await speculate({
+ *   entry: './spec/index.md',
+ *   configPath: './spec/config.respec.json',
+ *   plugins: [coreMarkdownPlugin, coreHtmlPlugin],
+ * });
+ *
+ * if (!result.hasErrors) {
+ *   console.log(result.document);
+ * }
+ * ```
+ */
+export async function speculate(options) {
+    // Use provided file provider or default to Node
+    const fileProvider = options.fileProvider ?? new NodeFileProvider();
+    // Create pipeline with plugins
+    const pipeline = new SpeculatorPipeline(options.plugins);
+    // Run the pipeline
+    return pipeline.run({
+        entry: options.entry,
+        configPath: options.configPath,
+        fileProvider,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACrD,gDAAgD;IAChD,MAAM,YAAY,GAAiB,OAAO,CAAC,YAAY,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAElF,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAGzD,mBAAmB;IACnB,OAAO,QAAQ,CAAC,GAAG,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,YAAY;KACf,CAAC,CAAC;AACP,CAAC"}

package/dist/pipeline/runner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Pipeline Runner
+ *
+ * Orchestrates plugin execution across postprocess phases.
+ * Parsing is handled by parser modules registered via html/index and markdown/index.
+ */
+import type { FileProvider } from '#src/file-provider/types';
+import type { Plugin, SpeculateResult } from './types.js';
+/**
+ * Speculator Pipeline Runner
+ *
+ * Coordinates execution of plugins across pipeline phases.
+ * In a workspace-first architecture, all runs produce a Workspace AST.
+ */
+export declare class SpeculatorPipeline {
+    private plugins;
+    constructor(plugins?: Plugin[]);
+    /**
+     * Run the pipeline for a single document.
+     * Consolidates to runWorkspace internally.
+     */
+    run(options: {
+        entry: string;
+        configPath?: string;
+        fileProvider: FileProvider;
+    }): Promise<SpeculateResult>;
+    /**
+     * Run the complete pipeline for a workspace (one or more documents)
+     */
+    runWorkspace(options: {
+        entries: {
+            entry: string;
+            configPath?: string;
+        }[];
+        fileProvider: FileProvider;
+    }): Promise<SpeculateResult>;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/pipeline/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/pipeline/runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,OAAO,KAAK,EACR,MAAM,EAEN,eAAe,EAElB,MAAM,YAAY,CAAC;AAiCpB;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,OAAO,CAAW;gBAEd,OAAO,GAAE,MAAM,EAAO;IAIlC;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,YAAY,CAAC;KAC9B,GAAG,OAAO,CAAC,eAAe,CAAC;IAO5B;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE;QACxB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAClD,YAAY,EAAE,YAAY,CAAC;KAC9B,GAAG,OAAO,CAAC,eAAe,CAAC;CAmF/B"}

package/dist/pipeline/runner.js

@@ -0,0 +1,128 @@
+/**
+ * Pipeline Runner
+ *
+ * Orchestrates plugin execution across postprocess phases.
+ * Parsing is handled by parser modules registered via html/index and markdown/index.
+ */
+import { preprocess } from '#src/preprocess/pipeline';
+import { parseWithRegistry } from '#src/parse/pipeline';
+import { ParseHandlerRegistry } from '#src/parse/registry';
+import { coreHtmlParsers, coreMarkdownParsers } from '#src/parse/parsers';
+import { buildGlobalIndex, finalizeWorkspace } from './workspace-index.js';
+// Default order for plugins that don't specify
+const DEFAULT_ORDER = 100;
+/**
+ * Get plugin order for a specific phase
+ */
+function getPluginOrder(plugin, phase) {
+    return plugin.order?.[phase] ?? DEFAULT_ORDER;
+}
+/**
+ * Sort plugins by order for a given phase
+ */
+function sortPluginsForPhase(plugins, phase) {
+    return [...plugins].sort((a, b) => getPluginOrder(a, phase) - getPluginOrder(b, phase));
+}
+/**
+ * Register core parser modules to a registry
+ */
+function registerCoreParsers(registry) {
+    for (const parser of coreHtmlParsers) {
+        registry.registerHtmlParser(parser);
+    }
+    for (const parser of coreMarkdownParsers) {
+        registry.registerMarkdownParser(parser);
+    }
+}
+/**
+ * Speculator Pipeline Runner
+ *
+ * Coordinates execution of plugins across pipeline phases.
+ * In a workspace-first architecture, all runs produce a Workspace AST.
+ */
+export class SpeculatorPipeline {
+    plugins;
+    constructor(plugins = []) {
+        this.plugins = plugins;
+    }
+    /**
+     * Run the pipeline for a single document.
+     * Consolidates to runWorkspace internally.
+     */
+    async run(options) {
+        return this.runWorkspace({
+            entries: [{ entry: options.entry, configPath: options.configPath }],
+            fileProvider: options.fileProvider
+        });
+    }
+    /**
+     * Run the complete pipeline for a workspace (one or more documents)
+     */
+    async runWorkspace(options) {
+        const results = [];
+        // 1. Initial run: Preprocess + Parse
+        for (const entryConfig of options.entries) {
+            const preprocessResult = await preprocess({
+                entry: entryConfig.entry,
+                configPath: entryConfig.configPath,
+                fileProvider: options.fileProvider,
+            });
+            if (!preprocessResult.result)
+                continue;
+            const registry = new ParseHandlerRegistry();
+            registerCoreParsers(registry);
+            const parseResult = parseWithRegistry(preprocessResult.result, registry);
+            if (!parseResult.result)
+                continue;
+            results.push({ doc: parseResult.result.document, entry: entryConfig.entry });
+        }
+        if (results.length === 0) {
+            return {};
+        }
+        const runtimeWorkspace = {
+            documents: new Map(results.map(r => [r.entry, r.doc])),
+            documentLevels: new Map(results.map((r, i) => [r.entry, i])),
+            globalIndex: { definitions: new Map(), bibliography: new Map() }
+        };
+        // 2. TRANSFORM phase
+        const transformPlugins = sortPluginsForPhase(this.plugins.filter(p => p.transform), 'transform');
+        for (const res of results) {
+            const level = runtimeWorkspace.documentLevels.get(res.entry) ?? 0;
+            for (const plugin of transformPlugins) {
+                await plugin.transform({ document: res.doc, level, workspace: runtimeWorkspace });
+            }
+        }
+        // 3. INDEX phase
+        const indexPlugins = sortPluginsForPhase(this.plugins.filter(p => p.index), 'index');
+        for (const res of results) {
+            const level = runtimeWorkspace.documentLevels.get(res.entry) ?? 0;
+            for (const plugin of indexPlugins) {
+                await plugin.index({ document: res.doc, level, workspace: runtimeWorkspace });
+            }
+        }
+        // 4. AGGREGATE Global Index
+        runtimeWorkspace.globalIndex = buildGlobalIndex(runtimeWorkspace.documents, runtimeWorkspace.documentLevels);
+        // 5. RESOLVE phase
+        const resolvePlugins = sortPluginsForPhase(this.plugins.filter(p => p.resolve), 'resolve');
+        for (const res of results) {
+            const level = runtimeWorkspace.documentLevels.get(res.entry) ?? 0;
+            for (const plugin of resolvePlugins) {
+                await plugin.resolve({ document: res.doc, level, workspace: runtimeWorkspace });
+            }
+        }
+        // 6. COMPUTE phase
+        const computePlugins = sortPluginsForPhase(this.plugins.filter(p => p.compute), 'compute');
+        for (const res of results) {
+            const level = runtimeWorkspace.documentLevels.get(res.entry) ?? 0;
+            for (const plugin of computePlugins) {
+                await plugin.compute({ document: res.doc, level, workspace: runtimeWorkspace });
+            }
+        }
+        // Finalize: Convert runtime workspace to AST
+        const workspaceAST = finalizeWorkspace(runtimeWorkspace);
+        return {
+            workspace: workspaceAST
+        };
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/pipeline/runner.js.map

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

package/dist/pipeline/types.d.ts

@@ -0,0 +1,106 @@
+import type { Workspace, Document, IndexDefinitionEntry, IndexBiblioEntry, Indexes1 as GlobalIndexAST } from '#src/types/ast.generated';
+export type { Workspace, Document, IndexDefinitionEntry, IndexBiblioEntry, GlobalIndexAST };
+/**
+ * Aggregated index for runtime lookups during postprocess phases.
+
+ * Uses Maps for O(1) term resolution.
+ */
+export interface RuntimeGlobalIndex {
+    /** Map of normalized term -> definitions */
+    definitions: Map<string, IndexDefinitionEntry[]>;
+    /** Map of key -> bibliography entry */
+    bibliography: Map<string, IndexBiblioEntry>;
+}
+/**
+ * Runtime workspace container used during pipeline execution.
+ */
+export interface RuntimeWorkspace {
+    /** Documents in the workspace, keyed by their canonical entry path */
+    documents: Map<string, Document>;
+    /** Map of document entry path -> level (0 is highest) */
+    documentLevels: Map<string, number>;
+    /** Aggregated index for cross-document resolution */
+    globalIndex: RuntimeGlobalIndex;
+}
+/**
+ * Postprocess pipeline phases in execution order.
+ *
+ * Note: Parsing is a separate stage before postprocess, not a plugin phase.
+ */
+export type PostprocessPhase = 'transform' | 'resolve' | 'index' | 'compute';
+/**
+ * Ordered list of postprocess phases for iteration
+ */
+export declare const POSTPROCESS_PHASES: PostprocessPhase[];
+/**
+ * @deprecated Use PostprocessPhase instead
+ */
+export type Phase = PostprocessPhase;
+/**
+ * @deprecated Use POSTPROCESS_PHASES instead
+ */
+export declare const PHASES: Phase[];
+export interface TransformContext {
+    readonly document: Document;
+    readonly level: number;
+    readonly workspace?: RuntimeWorkspace;
+}
+export interface IndexContext {
+    readonly document: Document;
+    readonly level: number;
+    readonly workspace?: RuntimeWorkspace;
+}
+export interface ResolveContext {
+    readonly document: Document;
+    readonly level: number;
+    readonly workspace?: RuntimeWorkspace;
+}
+export interface ComputeContext {
+    readonly document: Document;
+    readonly level: number;
+    readonly workspace?: RuntimeWorkspace;
+}
+/**
+ * Postprocess plugin interface.
+ *
+ * Plugins register hooks for postprocess phases only.
+ * Parsing is handled separately by parser modules in src/parse/.
+ */
+export interface Plugin {
+    /** Unique plugin name */
+    name: string;
+    /**
+     * Optional ordering per phase.
+     * Lower numbers run first. Default is 100.
+     */
+    order?: Partial<Record<PostprocessPhase, number>>;
+    /** Transform phase hook */
+    transform?(ctx: TransformContext): Promise<void>;
+    /** Index phase hook (runs before resolve to build indexes) */
+    index?(ctx: IndexContext): Promise<void>;
+    /** Resolve phase hook (uses indexes) */
+    resolve?(ctx: ResolveContext): Promise<void>;
+    /** Compute phase hook */
+    compute?(ctx: ComputeContext): Promise<void>;
+}
+/**
+ * Options for the speculate() entrypoint
+ */
+export interface SpeculateOptions {
+    /** Path to entry file (format.md or format.html) */
+    entry: string;
+    /** Optional path to config file (e.g., config.respec.json) */
+    configPath?: string;
+    /** Plugins to execute during postprocess phases */
+    plugins: Plugin[];
+    /** File provider for reading files (defaults to NodeFileProvider) */
+    fileProvider?: import('#src/file-provider/types').FileProvider;
+}
+/**
+ * Result from speculate()
+ */
+export interface SpeculateResult {
+    /** The root Workspace AST */
+    workspace?: Workspace;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/types.d.ts.map

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

package/dist/pipeline/types.js

@@ -0,0 +1,9 @@
+/**
+ * Ordered list of postprocess phases for iteration
+ */
+export const POSTPROCESS_PHASES = ['transform', 'index', 'resolve', 'compute'];
+/**
+ * @deprecated Use POSTPROCESS_PHASES instead
+ */
+export const PHASES = POSTPROCESS_PHASES;
+//# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAkDA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAuB,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAOnG;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAY,kBAAkB,CAAC"}

package/dist/pipeline/workspace-index.d.ts

@@ -0,0 +1,11 @@
+import type { Document, RuntimeGlobalIndex, RuntimeWorkspace, Workspace } from './types.js';
+/**
+ * Build a global index from a collection of documents.
+ */
+export declare function buildGlobalIndex(documents: Map<string, Document>, _documentLevels: Map<string, number>): RuntimeGlobalIndex;
+/**
+ * Convert a RuntimeWorkspace into a Workspace AST.
+ * This flattens the maps into arrays as defined by the schema.
+ */
+export declare function finalizeWorkspace(runtime: RuntimeWorkspace): Workspace;
+//# sourceMappingURL=workspace-index.d.ts.map

package/dist/pipeline/workspace-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-index.d.ts","sourceRoot":"","sources":["../../src/pipeline/workspace-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,QAAQ,EAGR,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EAEZ,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAChC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,kBAAkB,CAqCpB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAiBtE"}

package/dist/pipeline/workspace-index.js

@@ -0,0 +1,57 @@
+import { normalizeTerm } from '#src/parse/normalize';
+/**
+ * Build a global index from a collection of documents.
+ */
+export function buildGlobalIndex(documents, _documentLevels) {
+    const definitions = new Map();
+    const bibliography = new Map();
+    for (const [, doc] of documents) {
+        // Aggregate definitions
+        if (doc.indexes?.definitions) {
+            for (const entry of doc.indexes.definitions) {
+                const linkTexts = entry.linkTexts || [entry.term];
+                // Add primary term and all aliases to definitions lookup
+                const termsToProcess = new Set([entry.term, ...linkTexts]);
+                for (const term of termsToProcess) {
+                    const key = normalizeTerm(term);
+                    const existing = definitions.get(key) || [];
+                    // Add entry to definitions
+                    existing.push(entry);
+                    definitions.set(key, existing);
+                }
+            }
+        }
+        // Aggregate bibliography
+        if (doc.indexes?.bibliography) {
+            for (const entry of doc.indexes.bibliography) {
+                if (!bibliography.has(entry.key)) {
+                    bibliography.set(entry.key, entry);
+                }
+            }
+        }
+    }
+    return {
+        definitions,
+        bibliography,
+    };
+}
+/**
+ * Convert a RuntimeWorkspace into a Workspace AST.
+ * This flattens the maps into arrays as defined by the schema.
+ */
+export function finalizeWorkspace(runtime) {
+    const globalIndex = {
+        // Flat array of all unique definition entries
+        // Note: Multiple terms might point to the same entry object. 
+        // We collect the unique objects.
+        definitions: Array.from(new Set(Array.from(runtime.globalIndex.definitions.values()).flat())),
+        bibliography: Array.from(runtime.globalIndex.bibliography.values())
+    };
+    return {
+        type: 'workspace',
+        schemaVersion: '1.1.0',
+        documents: Array.from(runtime.documents.values()),
+        globalIndex
+    };
+}
+//# sourceMappingURL=workspace-index.js.map

package/dist/pipeline/workspace-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-index.js","sourceRoot":"","sources":["../../src/pipeline/workspace-index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,SAAgC,EAChC,eAAoC;IAEpC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC9D,MAAM,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEzD,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;QAC9B,wBAAwB;QACxB,IAAI,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAElD,yDAAyD;gBACzD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;gBAC3D,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;oBAChC,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;oBAChC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;oBAE5C,2BAA2B;oBAC3B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrB,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBACnC,CAAC;YACL,CAAC;QACL,CAAC;QAED,yBAAyB;QACzB,IAAI,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;YAC5B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/B,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO;QACH,WAAW;QACX,YAAY;KACf,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACvD,MAAM,WAAW,GAAmB;QAChC,8CAA8C;QAC9C,8DAA8D;QAC9D,iCAAiC;QACjC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAC9D,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;KACtE,CAAC;IAEF,OAAO;QACH,IAAI,EAAE,WAAW;QACjB,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACjD,WAAW;KACd,CAAC;AACN,CAAC"}

package/dist/plugins/__tests__/citation-transform.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Citation Transform Tests
+ *
+ * Tests for bracket citation scanning in transform phase.
+ */
+export {};
+//# sourceMappingURL=citation-transform.test.d.ts.map

package/dist/plugins/__tests__/citation-transform.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-transform.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/__tests__/citation-transform.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}