@opensip-cli/graph 0.1.0

package/dist/cli/shard-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shard-worker.d.ts","sourceRoot":"","sources":["../../src/cli/shard-worker.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAcH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB7F"}

package/dist/cli/shard-worker.js

@@ -0,0 +1,98 @@
+// @fitness-ignore-file no-direct-stdout-in-tool-engine -- subprocess IPC protocol: the worker serializes its ShardBuildResult to stdout and the parent (shard runner) reads stdout to EOF. This is not run output through the render seam; it is the wire format between two CLI processes.
+// @fitness-ignore-file only-documented-toolcli-seams -- same rationale as above: this stdout write is the worker↔parent IPC wire, not user-facing run output through a ToolCliContext seam.
+/**
+ * `graph-shard-worker <specPath>` — the per-shard build subprocess.
+ *
+ * One worker process builds ONE shard: it reads a {@link ShardWorkerSpec}
+ * JSON file, runs parse → walk → resolve over the shard's explicit file
+ * set (requesting cross-boundary descriptors), and writes a serializable
+ * {@link ShardBuildResult} JSON to stdout. The parent (the shard runner)
+ * spawns N of these under a concurrency cap and merges their fragments.
+ *
+ * This is an internal command, not a user-facing one — the shard runner
+ * invokes `node <cliScript> graph-shard-worker <specPath>`. It exists as a
+ * subcommand so the worker runs inside the bootstrapped CLI scope (the
+ * language-adapter registry is populated), letting `pickAdapter` resolve
+ * the adapter exactly as the main build does.
+ *
+ * The boundary is JSON only: no `ts.Node` / `ts.Program` ever crosses it.
+ */
+import { readFileSync } from 'node:fs';
+import { logger } from '@opensip-cli/core';
+import { computeFilesFingerprint } from '../cache/invalidate.js';
+import { pickAdapter } from '../lang-adapter/registry.js';
+import { spanRunStage } from './graph-tracer.js';
+import { buildAndResolveCatalog } from './orchestrate/catalog-builder.js';
+/**
+ * Build one shard and emit its `ShardBuildResult` as JSON on stdout.
+ * Exits non-zero (via setExitCode) on failure so the parent can attribute
+ * the error to this shard.
+ */
+export async function executeShardWorker(specPath, cli) {
+    let shardId = '<unknown>';
+    try {
+        const spec = JSON.parse(readFileSync(specPath, 'utf8'));
+        shardId = spec.shard.id;
+        const result = await buildShard(spec);
+        // Single write of the whole JSON document — the parent reads stdout to EOF.
+        process.stdout.write(JSON.stringify(result));
+        cli.setExitCode(0);
+    }
+    catch (error) {
+        logger.error({
+            evt: 'graph.shard.worker.error',
+            module: 'graph:shard-worker',
+            shardId,
+            err: error instanceof Error ? error.message : String(error),
+        });
+        process.stderr.write(`graph-shard-worker [${shardId}]: ${error instanceof Error ? error.message : String(error)}\n`);
+        cli.setExitCode(1);
+    }
+}
+async function buildShard(spec) {
+    const { shard, projectRoot, resolutionMode } = spec;
+    const adapter = pickAdapter(shard.rootDir, spec.language);
+    // Anchor compiler options to the shard's own config, but compute
+    // occurrence filePaths against the COMMON project root so fragments
+    // align across shards when merged. For the synthetic `:root` shard,
+    // `shard.configPathAbs` is the ROOT tsconfig — so root scripts and other
+    // files under no package tsconfig parse/resolve against the root compiler
+    // options (Phase 1). The discovery here is consulted ONLY for those compiler
+    // options: the file set is `shard.files` (the canonical partition the runner
+    // pre-enumerated), NOT the tsconfig's own include/exclude glob — so test
+    // files now assigned to a package shard parse even though that package's
+    // tsconfig would have excluded them (tsc compiles `rootNames` verbatim).
+    const discovered = adapter.discoverFiles({
+        cwd: shard.rootDir,
+        configPathOverride: shard.configPathAbs,
+    });
+    const discovery = {
+        projectDirAbs: projectRoot,
+        files: shard.files,
+        configPathAbs: shard.configPathAbs ?? discovered.configPathAbs,
+        compilerOptions: discovered.compilerOptions,
+    };
+    // Emit per-stage spans tagged with this shard's id. They nest under the
+    // parent build's sharded span via the TRACEPARENT the runner propagates into
+    // this worker's env (extracted at the CLI boundary by initTelemetry). No live
+    // view here — the worker is headless — so no progress/monitor plumbing.
+    const built = await buildAndResolveCatalog({
+        runStage: spanRunStage({ 'opensip_cli.graph.shard_id': shard.id }),
+        adapter,
+        discovery,
+        resolutionMode,
+        emitBoundaryCalls: true,
+        // Stamp this fragment's cacheKey with `mode=sharded` so it matches what
+        // `planShardWork` compares against (loadValidShardFragment) and never
+        // collides with a single-program (exact) catalog row.
+        engineMode: 'sharded',
+    });
+    return {
+        shardId: shard.id,
+        fragment: built.catalog,
+        fingerprint: computeFilesFingerprint(shard.files),
+        boundaryCalls: built.boundaryCalls ?? [],
+        parseErrors: built.parseErrors,
+    };
+}
+//# sourceMappingURL=shard-worker.js.map

package/dist/cli/shard-worker.js.map

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

package/dist/cli/symbol-index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `opensip graph symbol-index --out <path>` — emit a symbol-index
+ * JSON artifact suitable for agent consumption (e.g., feeding into a
+ * coding LLM's context, or piping into another tool).
+ *
+ * Schema:
+ *   {
+ *     "version": "1.0",
+ *     "tool": "graph",
+ *     "generatedAt": "<ISO timestamp>",
+ *     "symbols": {
+ *       "<simpleName>": [
+ *         { "qualifiedName", "filePath", "line", "column",
+ *           "kind", "visibility", "bodyHash" },
+ *         ...
+ *       ]
+ *     },
+ *     "fileSymbols": {
+ *       "<filePath>": ["<simpleName>", ...]
+ *     }
+ *   }
+ *
+ * Bidirectional like codeindex (name→file and file→names), but enriched
+ * with kind/visibility/bodyHash since we already have that data.
+ */
+import type { Catalog } from '../types.js';
+import type { ToolCliContext } from '@opensip-cli/core';
+export interface SymbolIndexCommandOptions {
+    readonly cwd: string;
+    readonly out: string;
+}
+interface SymbolEntry {
+    readonly qualifiedName: string;
+    readonly filePath: string;
+    readonly line: number;
+    readonly column: number;
+    readonly kind: string;
+    readonly visibility: string;
+    readonly bodyHash: string;
+}
+interface SymbolIndexArtifact {
+    readonly version: '1.0';
+    readonly tool: 'graph';
+    readonly generatedAt: string;
+    readonly symbols: Record<string, readonly SymbolEntry[]>;
+    readonly fileSymbols: Record<string, readonly string[]>;
+}
+export declare function executeSymbolIndex(opts: SymbolIndexCommandOptions, cli: ToolCliContext): void;
+export declare function buildArtifact(catalog: Catalog): SymbolIndexArtifact;
+export {};
+//# sourceMappingURL=symbol-index.d.ts.map

package/dist/cli/symbol-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-index.d.ts","sourceRoot":"","sources":["../../src/cli/symbol-index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAUH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CACzD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CA+C7F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAgBnE"}

package/dist/cli/symbol-index.js

@@ -0,0 +1,120 @@
+// @fitness-ignore-file no-direct-stdout-in-tool-engine -- auxiliary subcommand status line: `graph symbol-index` writes its artifact to a file and prints a one-line "wrote N symbols to <path>" confirmation. This is not the signal-envelope run output (ADR-0011), which routes through the composition root.
+// @fitness-ignore-file only-documented-toolcli-seams -- same rationale as above: this is the one-line "wrote N symbols to <path>" status confirmation after a file write, not user-facing run output through a ToolCliContext seam.
+/**
+ * `opensip graph symbol-index --out <path>` — emit a symbol-index
+ * JSON artifact suitable for agent consumption (e.g., feeding into a
+ * coding LLM's context, or piping into another tool).
+ *
+ * Schema:
+ *   {
+ *     "version": "1.0",
+ *     "tool": "graph",
+ *     "generatedAt": "<ISO timestamp>",
+ *     "symbols": {
+ *       "<simpleName>": [
+ *         { "qualifiedName", "filePath", "line", "column",
+ *           "kind", "visibility", "bodyHash" },
+ *         ...
+ *       ]
+ *     },
+ *     "fileSymbols": {
+ *       "<filePath>": ["<simpleName>", ...]
+ *     }
+ *   }
+ *
+ * Bidirectional like codeindex (name→file and file→names), but enriched
+ * with kind/visibility/bodyHash since we already have that data.
+ */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { ConfigurationError, logger } from '@opensip-cli/core';
+import { CatalogRepo } from '../persistence/catalog-repo.js';
+export function executeSymbolIndex(opts, cli) {
+    logger.info({ evt: 'graph.cli.symbol-index.start', module: 'graph:cli' });
+    try {
+        const datastore = cli.scope.datastore();
+        if (!datastore) {
+            throw new ConfigurationError('graph symbol-index requires a DataStore on ToolCliContext.');
+        }
+        const catalog = new CatalogRepo(datastore).loadFullCatalog();
+        if (!catalog) {
+            throw new ConfigurationError('No graph catalog found. Run `opensip graph` first to build the catalog.');
+        }
+        const artifact = buildArtifact(catalog);
+        const outPath = resolve(opts.cwd, opts.out);
+        // Create the parent dir before writing so a nested --out
+        // (e.g. reports/symbolindex.json) doesn't throw ENOENT — matches
+        // the sibling writers (sarif-export, baseline-export, catalog-json).
+        mkdirSync(dirname(outPath), { recursive: true });
+        writeFileSync(outPath, `${JSON.stringify(artifact, null, 2)}\n`, 'utf8');
+        const symbolCount = Object.values(artifact.symbols).reduce((n, arr) => n + arr.length, 0);
+        const fileCount = Object.keys(artifact.fileSymbols).length;
+        process.stdout.write(`wrote ${String(symbolCount)} symbol(s) across ${String(fileCount)} file(s) to ${outPath}\n`);
+        cli.setExitCode(EXIT_CODES.SUCCESS);
+        logger.info({
+            evt: 'graph.cli.symbol-index.complete',
+            module: 'graph:cli',
+            symbols: symbolCount,
+            files: fileCount,
+        });
+    }
+    catch (error) {
+        logger.error({
+            evt: 'graph.cli.symbol-index.error',
+            module: 'graph:cli',
+            err: error instanceof Error ? error.message : String(error),
+        });
+        cli.setExitCode(error instanceof ConfigurationError
+            ? EXIT_CODES.CONFIGURATION_ERROR
+            : EXIT_CODES.RUNTIME_ERROR);
+        process.stderr.write(`graph symbol-index: ${error instanceof Error ? error.message : String(error)}\n`);
+    }
+}
+export function buildArtifact(catalog) {
+    const symbols = {};
+    const fileSymbols = {};
+    for (const name of Object.keys(catalog.functions)) {
+        const bucket = catalog.functions[name];
+        if (!bucket)
+            continue;
+        const entries = collectEntriesForName(bucket, name, fileSymbols);
+        if (entries.length > 0)
+            symbols[name] = entries;
+    }
+    return {
+        version: '1.0',
+        tool: 'graph',
+        generatedAt: new Date().toISOString(),
+        symbols,
+        fileSymbols,
+    };
+}
+function collectEntriesForName(bucket, name, fileSymbols) {
+    const entries = [];
+    for (const occ of bucket) {
+        if (occ.kind === 'module-init')
+            continue;
+        entries.push({
+            qualifiedName: occ.qualifiedName,
+            filePath: occ.filePath,
+            line: occ.line,
+            column: occ.column,
+            kind: occ.kind,
+            visibility: occ.visibility,
+            bodyHash: occ.bodyHash,
+        });
+        addNameToFileBucket(fileSymbols, occ.filePath, name);
+    }
+    return entries;
+}
+function addNameToFileBucket(fileSymbols, filePath, name) {
+    let bucket = fileSymbols[filePath];
+    if (!bucket) {
+        bucket = [];
+        fileSymbols[filePath] = bucket;
+    }
+    if (!bucket.includes(name))
+        bucket.push(name);
+}
+//# sourceMappingURL=symbol-index.js.map

package/dist/cli/symbol-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-index.js","sourceRoot":"","sources":["../../src/cli/symbol-index.ts"],"names":[],"mappings":"AAAA,iTAAiT;AACjT,oOAAoO;AACpO;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AA6B7D,MAAM,UAAU,kBAAkB,CAAC,IAA+B,EAAE,GAAmB;IACrF,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,8BAA8B,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,EAA2B,CAAC;QACjE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,4DAA4D,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,eAAe,EAAE,CAAC;QAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,kBAAkB,CAC1B,yEAAyE,CAC1E,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5C,yDAAyD;QACzD,iEAAiE;QACjE,qEAAqE;QACrE,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,aAAa,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1F,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;QAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,SAAS,MAAM,CAAC,WAAW,CAAC,qBAAqB,MAAM,CAAC,SAAS,CAAC,eAAe,OAAO,IAAI,CAC7F,CAAC;QACF,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC;YACV,GAAG,EAAE,iCAAiC;YACtC,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC;YACX,GAAG,EAAE,8BAA8B;YACnC,MAAM,EAAE,WAAW;YACnB,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC5D,CAAC,CAAC;QACH,GAAG,CAAC,WAAW,CACb,KAAK,YAAY,kBAAkB;YACjC,CAAC,CAAC,UAAU,CAAC,mBAAmB;YAChC,CAAC,CAAC,UAAU,CAAC,aAAa,CAC7B,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,OAAO,GAAkC,EAAE,CAAC;IAClD,MAAM,WAAW,GAA6B,EAAE,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IAClD,CAAC;IACD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAQG,EACH,IAAY,EACZ,WAAqC;IAErC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa;YAAE,SAAS;QACzC,OAAO,CAAC,IAAI,CAAC;YACX,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC;QACH,mBAAmB,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAqC,EACrC,QAAgB,EAChB,IAAY;IAEZ,IAAI,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,EAAE,CAAC;QACZ,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/cli/workspace-report.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Render helpers for `graph --workspace` output — both the human
+ * terminal report and the JSON shape. Extracted from `cli/graph.ts`
+ * to keep the dispatcher file under the file-length-limit fitness
+ * check.
+ */
+import type { WorkspaceUnitRunResult } from './workspace-runner.js';
+import type { ToolCliContext } from '@opensip-cli/core';
+/**
+ * Compose the human-readable workspace report as plain lines (no Ink twin),
+ * for the render seam.
+ */
+export declare function workspaceReportLines(perUnit: readonly WorkspaceUnitRunResult[], durationMs: number): readonly string[];
+/**
+ * Render the human-readable workspace report through the seam (Ink on TTY,
+ * plain text in pipes/CI) rather than writing to stdout directly.
+ */
+export declare function writeWorkspaceReport(perUnit: readonly WorkspaceUnitRunResult[], durationMs: number, cli: ToolCliContext): Promise<void>;
+/**
+ * Build the JSON document object for `graph --workspace --json`. Returns the
+ * plain object so the dispatcher can route it through the CLI's `emitJson`
+ * seam (ADR-0011: tools emit, the composition root owns the stdout IO),
+ * instead of writing to `process.stdout` directly.
+ */
+export declare function buildWorkspaceJsonDocument(perUnit: readonly WorkspaceUnitRunResult[], durationMs: number): Record<string, unknown>;
+/**
+ * Render the JSON document for `graph --workspace --json` as a string.
+ * Retained for unit-test ergonomics; the dispatcher emits the object via
+ * `cli.emitJson` (which applies the same `JSON.stringify(_, null, 2)`).
+ */
+export declare function renderWorkspaceJson(perUnit: readonly WorkspaceUnitRunResult[], durationMs: number): string;
+//# sourceMappingURL=workspace-report.d.ts.map

package/dist/cli/workspace-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-report.d.ts","sourceRoot":"","sources":["../../src/cli/workspace-report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,sBAAsB,EAAE,EAC1C,UAAU,EAAE,MAAM,GACjB,SAAS,MAAM,EAAE,CAanB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,SAAS,sBAAsB,EAAE,EAC1C,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,sBAAsB,EAAE,EAC1C,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,sBAAsB,EAAE,EAC1C,UAAU,EAAE,MAAM,GACjB,MAAM,CAER"}

package/dist/cli/workspace-report.js

@@ -0,0 +1,107 @@
+/**
+ * Render helpers for `graph --workspace` output — both the human
+ * terminal report and the JSON shape. Extracted from `cli/graph.ts`
+ * to keep the dispatcher file under the file-length-limit fitness
+ * check.
+ */
+const FINDINGS_PREVIEW = 10;
+/**
+ * Compose the human-readable workspace report as plain lines (no Ink twin),
+ * for the render seam.
+ */
+export function workspaceReportLines(perUnit, durationMs) {
+    const totalFindings = perUnit.reduce((n, r) => n + r.signals.length, 0);
+    return [
+        'opensip graph --workspace',
+        '',
+        `== Units (${String(perUnit.length)}) ==`,
+        ...renderWorkspaceStatusLines(perUnit),
+        '',
+        '== Findings ==',
+        ...renderWorkspaceFindingsLines(perUnit),
+        '== Summary ==',
+        `${String(totalFindings)} total finding(s) across ${String(perUnit.length)} unit(s) in ${String(durationMs)} ms.`,
+    ];
+}
+/**
+ * Render the human-readable workspace report through the seam (Ink on TTY,
+ * plain text in pipes/CI) rather than writing to stdout directly.
+ */
+export async function writeWorkspaceReport(perUnit, durationMs, cli) {
+    await cli.render({ type: 'graph-status', lines: workspaceReportLines(perUnit, durationMs) });
+}
+/**
+ * Build the JSON document object for `graph --workspace --json`. Returns the
+ * plain object so the dispatcher can route it through the CLI's `emitJson`
+ * seam (ADR-0011: tools emit, the composition root owns the stdout IO),
+ * instead of writing to `process.stdout` directly.
+ */
+export function buildWorkspaceJsonDocument(perUnit, durationMs) {
+    return {
+        version: '1.0',
+        tool: 'graph',
+        command: 'graph',
+        mode: 'workspace',
+        // Workspace-specific artifact timestamp (for the --workspace JSON/report document).
+        // This is *not* the StoredSession row: the parent handler RETURNS the single
+        // aggregate session contribution for the whole --workspace invocation and the
+        // host run plane persists it (children are carrier --json and do not write
+        // sessions). This keeps user-facing workspace docs with their own clocks while
+        // the durable history row is host-stamped from the RunTimer.
+        timestamp: new Date().toISOString(),
+        durationMs,
+        units: perUnit.map((r) => ({
+            unitId: r.unitId,
+            rootDir: r.rootDir,
+            displayPath: r.displayPath,
+            exitCode: r.exitCode,
+            signals: r.signals,
+        })),
+        totalFindings: perUnit.reduce((n, r) => n + r.signals.length, 0),
+    };
+}
+/**
+ * Render the JSON document for `graph --workspace --json` as a string.
+ * Retained for unit-test ergonomics; the dispatcher emits the object via
+ * `cli.emitJson` (which applies the same `JSON.stringify(_, null, 2)`).
+ */
+export function renderWorkspaceJson(perUnit, durationMs) {
+    return JSON.stringify(buildWorkspaceJsonDocument(perUnit, durationMs), null, 2);
+}
+function renderWorkspaceStatusLines(perUnit) {
+    const out = [];
+    for (const r of perUnit) {
+        const status = r.exitCode === 0 ? 'ok' : `FAILED (exit ${String(r.exitCode)})`;
+        const display = unitDisplay(r);
+        out.push(`  ${display}: ${String(r.signals.length)} finding(s) — ${status}`);
+        if (r.exitCode !== 0 && r.stderr.length > 0) {
+            const stderrPreview = r.stderr.split('\n').slice(0, 3).join('\n    ');
+            out.push(`    stderr: ${stderrPreview}`);
+        }
+    }
+    return out;
+}
+function renderWorkspaceFindingsLines(perUnit) {
+    const out = [];
+    for (const r of perUnit) {
+        if (r.signals.length === 0)
+            continue;
+        out.push(`[${unitDisplay(r)}]`, ...renderUnitFindingPreview(r), '');
+    }
+    return out;
+}
+function renderUnitFindingPreview(r) {
+    const preview = r.signals.slice(0, FINDINGS_PREVIEW);
+    const lines = preview.map((s) => {
+        const loc = typeof s.line === 'number' ? `:${String(s.line)}` : '';
+        return `  ${s.filePath}${loc} — ${s.message}`;
+    });
+    if (r.signals.length > preview.length) {
+        lines.push(`  ... ${String(r.signals.length - preview.length)} more (use --json for full list)`);
+    }
+    return lines;
+}
+function unitDisplay(r) {
+    return r.displayPath.length > 0 ? r.displayPath : r.rootDir;
+}
+//# sourceMappingURL=workspace-report.js.map

package/dist/cli/workspace-report.js.map

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

package/dist/cli/workspace-runner.d.ts

@@ -0,0 +1,104 @@
+/**
+ * `graph --workspace` parallel runner.
+ *
+ * Fans a graph run out across every workspace unit detected by the
+ * language adapters' `discoverWorkspaceUnits` hook by spawning one
+ * child process per unit, each running `graph <rootDir> --json`. Each
+ * child has its own Node heap, so the per-unit memory ceiling that
+ * Phase 6 already provides scales naturally:
+ * N units × ~per-unit-budget ≈ total budget. Concurrency is capped at
+ * `os.cpus().length - 1` (or a caller override) so we don't
+ * oversubscribe.
+ *
+ * Polyglot per spec D8b: callers compose units from multiple adapters
+ * via `discoverPolyglotUnits` and pass the flattened list. The runner
+ * itself is language-agnostic — it only sees opaque `WorkspaceUnit`s.
+ */
+import { type LanguageAdapter, type Signal, type WorkspaceUnit } from '@opensip-cli/core';
+import type { ResolutionMode } from '../types.js';
+/**
+ * Per-unit result from a `graph --workspace` fan-out — one entry per
+ * child process spawned by `runWorkspaceUnitsInParallel`.
+ */
+export interface WorkspaceUnitRunResult {
+    /** Human-readable unit id (e.g. `core`, `cli`, `crate-foo`). */
+    readonly unitId: string;
+    /** Absolute root dir the child was spawned against. */
+    readonly rootDir: string;
+    /**
+     * Project-relative path for display. Empty string if `rootDir` isn't
+     * under `cwd`.
+     */
+    readonly displayPath: string;
+    /**
+     * The child run's signals, parsed from its `--json` {@link SignalEnvelope}
+     * stdout (ADR-0011). These carry OpenSIP-mapped `ruleId`/`source` (the
+     * child applies Option A); the parent reverse-maps to engine slugs only
+     * where the dashboard session payload needs them.
+     */
+    readonly signals: readonly Signal[];
+    readonly exitCode: number;
+    readonly stderr: string;
+}
+/**
+ * Inputs to `runWorkspaceUnitsInParallel`. `units` is the flattened
+ * polyglot list typically produced by `discoverPolyglotUnits`.
+ */
+export interface RunWorkspaceUnitsInput {
+    readonly cwd: string;
+    readonly units: readonly WorkspaceUnit[];
+    /**
+     * Path to the CLI entry script — typically `process.argv[1]` from
+     * the parent. Children invoke `node <cliScript> graph <rootDir>
+     * --json`.
+     */
+    readonly cliScript: string;
+    /** Override concurrency for tests. Default: cpus()-1, min 1. */
+    readonly concurrency?: number;
+    /** Forwarded to children if true. */
+    readonly noCache?: boolean;
+    /**
+     * Edge resolution tier. Forwarded to each child as `--resolution
+     * <mode>` so a `--workspace --resolution fast` run is fast per unit,
+     * not silently exact. Omitted/`'exact'` ⇒ children use their default.
+     */
+    readonly resolution?: ResolutionMode;
+    /**
+     * Optional adapter id. Forwarded to each child as `--language <id>` so
+     * workspace fan-out preserves the parent's explicit adapter selection.
+     */
+    readonly language?: string;
+    /**
+     * `--recipe <name>`: forwarded to each child as `--recipe <name>` so a
+     * `--workspace --recipe <name>` run selects the same rule subset per
+     * unit. Children re-resolve the recipe in their own scope (resolved
+     * `Rule` objects can't cross the process boundary). Omitted ⇒ children
+     * use the default recipe.
+     */
+    readonly recipe?: string;
+}
+/**
+ * Aggregate output from `runWorkspaceUnitsInParallel` — per-unit
+ * results plus a single boolean indicating whether any child failed.
+ */
+export interface RunWorkspaceUnitsOutput {
+    readonly perUnit: readonly WorkspaceUnitRunResult[];
+    readonly anyChildFailed: boolean;
+}
+/**
+ * Aggregate WorkspaceUnits across all adapters that implement the
+ * discovery hook. Per spec D8b: in a polyglot repo (e.g. TS frontend +
+ * Cargo backend) both adapters contribute units to one combined fan-
+ * out. Adapters without the hook contribute zero units (D5).
+ *
+ * Returns units sorted by `rootDir` for deterministic fan-out order.
+ */
+export declare function discoverPolyglotUnits(rootDir: string, adapters: readonly LanguageAdapter[]): Promise<readonly WorkspaceUnit[]>;
+/**
+ * Spawn one child process per WorkspaceUnit, run `graph <rootDir>
+ * --json` in each, and aggregate the parsed findings. Concurrency is
+ * capped (default `cpus()-1`). Always resolves; child failures are
+ * surfaced via `anyChildFailed`.
+ */
+export declare function runWorkspaceUnitsInParallel(input: RunWorkspaceUnitsInput): Promise<RunWorkspaceUnitsOutput>;
+//# sourceMappingURL=workspace-runner.d.ts.map

package/dist/cli/workspace-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-runner.d.ts","sourceRoot":"","sources":["../../src/cli/workspace-runner.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,eAAe,EAAE,GACnC,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CASnC;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CA0ClC"}