@opensip-cli/graph 0.1.4 → 0.1.6

package/dist/cli/graph-sharded-engine.d.ts

@@ -0,0 +1,77 @@
+import { type LiveGraphOutput } from './graph-report.js';
+import type { GraphCommandOptions } from './graph-options.js';
+import type { Shard } from './orchestrate/shard-model.js';
+import type { GraphProgressCallback, RunGraphResult } from './orchestrate.js';
+import type { GraphProfileRunRecorder } from './profile.js';
+import type { GraphConfig, ResolutionMode, Rule } from '../types.js';
+import type { ToolCliContext } from '@opensip-cli/core';
+import type { DataStore } from '@opensip-cli/datastore';
+/**
+ * Resolve a path to absolute (a relative input resolves against `base`, not
+ * necessarily `process.cwd()`), then realpath it so exact and sharded engines see
+ * one canonical run root. Falls back to the absolute path when realpath fails.
+ */
+export declare function realpathOrSelf(input: string, base: string): string;
+/** Shard resolution plus optional synthetic-partition timing. */
+export interface ShardResolution {
+    readonly shards: Shard[];
+    readonly partition?: {
+        readonly durationMs: number;
+        readonly detail: string;
+    };
+}
+/**
+ * Engine-selection policy (ADR-0033, superseding ADR-0032/0031). The sharded
+ * engine is the default when the project can actually shard; exact is selected
+ * for `--exact`, positional runs, or non-shardable projects.
+ */
+export declare function resolveEngineShards(opts: GraphCommandOptions, cli: ToolCliContext, positionalPaths: readonly string[]): Promise<ShardResolution>;
+/** Human-readable explanation for the graph engine observability event. */
+export declare function engineSelectionReason(opts: GraphCommandOptions, positionalPaths: readonly string[], sharded: boolean): string;
+/**
+ * Resolve a project's shard set the same way a production `graph` run does,
+ * exposed for the real-repo equivalence guardrail.
+ */
+export declare function resolveShardsForCwd(cwd: string, cliScript: string, cli: ToolCliContext): Promise<readonly Shard[]>;
+/** Inputs the sharded build path threads from `executeGraph`. */
+export interface ShardedBuildContext {
+    readonly opts: GraphCommandOptions;
+    readonly shards: readonly Shard[];
+    readonly projectRoot: string;
+    readonly cli: ToolCliContext;
+    readonly config: GraphConfig;
+    readonly rules: readonly Rule[];
+    readonly onProgress?: GraphProgressCallback;
+}
+/**
+ * Run a sharded build and record its wall-clock stage in the optional graph
+ * profile. The build result is unchanged; this helper only centralizes timing
+ * so the main command handler does not own sharded profiling mechanics.
+ */
+export declare function runProfiledShardedBuild(profileRun: GraphProfileRunRecorder | undefined, ctx: ShardedBuildContext): Promise<RunGraphResult>;
+/**
+ * Serializable live-build request handed from the interactive runner to the
+ * graph engine. Mirrors the subset of GraphCommandOptions the live view needs.
+ */
+export interface GraphLiveBuildArgs {
+    readonly cwd: string;
+    readonly noCache?: boolean;
+    readonly resolution?: ResolutionMode;
+    readonly exact?: boolean;
+    readonly config?: GraphConfig;
+    readonly rules?: readonly Rule[];
+    readonly cliScript?: string;
+}
+/**
+ * Resolve the live runner's build engine with the same shardability policy the
+ * static `graph` command uses. The live UI consumes the returned shard list to
+ * choose exact vs. sharded worker execution.
+ */
+export declare function resolveLiveEngineShards(args: GraphLiveBuildArgs, cli: ToolCliContext): Promise<Shard[]>;
+/**
+ * Execute a sharded graph build for the interactive/live runner and reduce the
+ * result to the serializable `LiveGraphOutput` shape consumed by Ink and worker
+ * transports.
+ */
+export declare function runShardedLiveBuild(args: GraphLiveBuildArgs, shards: readonly Shard[], datastore: DataStore | undefined, onProgress: GraphProgressCallback): Promise<LiveGraphOutput>;
+//# sourceMappingURL=graph-sharded-engine.d.ts.map

package/dist/cli/graph-sharded-engine.d.ts.map

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

package/dist/cli/graph-sharded-engine.js

@@ -0,0 +1,229 @@
+import { realpathSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { pickAdapter } from '../lang-adapter/registry.js';
+import { CatalogRepo } from '../persistence/catalog-repo.js';
+import { currentRules } from '../rules/registry.js';
+import { DASHBOARD_FEATURE_COLUMNS } from './graph-feature-columns.js';
+import { buildLiveGraphOutput } from './graph-report.js';
+import { resolveCanonicalFileSet } from './orchestrate/canonical-file-set.js';
+import { detectMonorepoLayout, partitionFlatRepo, selectStrategyForLayout, } from './orchestrate/flat-monorepo-strategy.js';
+import { partitionFilesIntoShards } from './orchestrate/partition-files.js';
+import { loadGraphConfig, runShardedGraph } from './orchestrate.js';
+import { resolveAdaptersForRun } from './resolve-adapters.js';
+import { discoverPolyglotUnits } from './workspace-runner.js';
+/**
+ * Resolve a path to absolute (a relative input resolves against `base`, not
+ * necessarily `process.cwd()`), then realpath it so exact and sharded engines see
+ * one canonical run root. Falls back to the absolute path when realpath fails.
+ */
+export function realpathOrSelf(input, base) {
+    const absolute = resolve(base, input);
+    try {
+        return realpathSync(absolute);
+    }
+    catch {
+        /* v8 ignore next */
+        return absolute;
+    }
+}
+/**
+ * Engine-selection policy (ADR-0033, superseding ADR-0032/0031). The sharded
+ * engine is the default when the project can actually shard; exact is selected
+ * for `--exact`, positional runs, or non-shardable projects.
+ */
+export async function resolveEngineShards(opts, cli, positionalPaths) {
+    if (opts.exact === true)
+        return { shards: [] };
+    if (positionalPaths.length > 0)
+        return { shards: [] };
+    return resolveShards(opts, cli);
+}
+/** Human-readable explanation for the graph engine observability event. */
+export function engineSelectionReason(opts, positionalPaths, sharded) {
+    if (sharded)
+        return 'sharded-default';
+    if (opts.exact === true)
+        return 'exact-opt-out';
+    if (positionalPaths.length > 0)
+        return 'exact-positional-paths';
+    return 'exact-not-shardable';
+}
+async function resolveShards(opts, cli) {
+    const cliScript = opts.cliScript ?? process.argv[1];
+    if (typeof cliScript !== 'string' || cliScript.length === 0)
+        return { shards: [] };
+    let units;
+    try {
+        units = await discoverPolyglotUnits(opts.cwd, resolveAdaptersForRun(opts, cli));
+    }
+    catch {
+        /* v8 ignore next */
+        return resolveSyntheticFlatShards(opts);
+    }
+    if (units.length <= 1)
+        return resolveSyntheticFlatShards(opts);
+    const adapter = pickAdapter(opts.cwd);
+    let rootDiscovery;
+    try {
+        rootDiscovery = adapter.discoverFiles({ cwd: opts.cwd });
+    }
+    catch {
+        /* v8 ignore next */
+        return resolveSyntheticFlatShards(opts);
+    }
+    const canonicalFiles = resolveCanonicalFileSet(rootDiscovery.files);
+    const shards = partitionFilesIntoShards({
+        canonicalFiles,
+        units: units.map((u) => ({
+            id: u.id,
+            rootDir: u.rootDir,
+            ...(u.configPath === undefined ? {} : { configPathAbs: u.configPath }),
+        })),
+        projectRoot: rootDiscovery.projectDirAbs,
+        rootConfigPathAbs: rootDiscovery.configPathAbs,
+    });
+    if (shards.length > 1)
+        return { shards };
+    return resolveSyntheticFlatShards(opts);
+}
+/**
+ * Resolve a project's shard set the same way a production `graph` run does,
+ * exposed for the real-repo equivalence guardrail.
+ */
+export async function resolveShardsForCwd(cwd, cliScript, cli) {
+    const resolution = await resolveShards({ cwd, cliScript, noCache: true }, cli);
+    return resolution.shards;
+}
+function resolveSyntheticFlatShards(opts) {
+    if (typeof opts.language === 'string' && opts.language.length > 0)
+        return { shards: [] };
+    const adapter = pickAdapter(opts.cwd);
+    if (adapter.id !== 'typescript')
+        return { shards: [] };
+    let discovery;
+    try {
+        discovery = adapter.discoverFiles({ cwd: opts.cwd });
+    }
+    catch {
+        return { shards: [] };
+    }
+    const canonicalFiles = resolveCanonicalFileSet(discovery.files);
+    const partitionStart = Date.now();
+    const layout = detectMonorepoLayout({
+        repoRoot: discovery.projectDirAbs,
+        files: canonicalFiles,
+    });
+    const selection = selectStrategyForLayout(layout);
+    if (layout.kind !== 'flat-large' || selection.mode !== 'synthetic-partition') {
+        return { shards: [] };
+    }
+    const graphConfig = loadGraphConfig(opts.cwd);
+    const strategy = graphConfig.partitionStrategy ?? selection.partitionStrategy ?? 'hybrid';
+    const partitions = partitionFlatRepo({
+        files: layout.files,
+        repoRoot: discovery.projectDirAbs,
+        strategy,
+    });
+    const shards = partitions
+        .filter((p) => p.files.length > 0)
+        .map((p) => ({
+        id: `partition:${p.id}`,
+        rootDir: discovery.projectDirAbs,
+        files: p.files,
+        configPathAbs: discovery.configPathAbs,
+    }));
+    if (shards.length <= 1)
+        return { shards: [] };
+    return {
+        shards,
+        partition: {
+            durationMs: Date.now() - partitionStart,
+            detail: `${strategy}: ${String(shards.length)} partition(s)`,
+        },
+    };
+}
+async function runShardedBuild(ctx) {
+    const { opts, shards, projectRoot, cli, config, rules } = ctx;
+    const datastore = cli.scope.datastore();
+    const sharded = await runShardedGraph({
+        shards,
+        projectRoot,
+        cliScript: opts.cliScript ?? process.argv[1] ?? '',
+        adapter: pickAdapter(projectRoot, opts.language),
+        resolutionMode: opts.resolution ?? 'exact',
+        concurrency: opts.concurrency,
+        useCache: opts.noCache !== true,
+        config,
+        rules,
+        catalogRepo: datastore ? new CatalogRepo(datastore) : null,
+        emitFeatures: DASHBOARD_FEATURE_COLUMNS,
+        ...(ctx.onProgress === undefined ? {} : { onProgress: ctx.onProgress }),
+        ...(opts.language === undefined ? {} : { language: opts.language }),
+    });
+    return {
+        catalog: sharded.catalog,
+        indexes: sharded.indexes,
+        signals: sharded.signals,
+        resolutionStats: sharded.resolutionStats,
+        cacheHit: sharded.cacheHit,
+        features: sharded.features,
+        shardStats: sharded.shardStats,
+    };
+}
+/**
+ * Run a sharded build and record its wall-clock stage in the optional graph
+ * profile. The build result is unchanged; this helper only centralizes timing
+ * so the main command handler does not own sharded profiling mechanics.
+ */
+export async function runProfiledShardedBuild(profileRun, ctx) {
+    const started = Date.now();
+    const result = await runShardedBuild(ctx);
+    if (profileRun !== undefined) {
+        // @fitness-ignore-next-line detached-promises -- GraphProfileRunRecorder.recordStage is synchronous timing bookkeeping, not a promise-returning call.
+        profileRun.recordStage('sharded-build', Date.now() - started, `${String(ctx.shards.length)} shard(s)`);
+    }
+    return result;
+}
+/**
+ * Resolve the live runner's build engine with the same shardability policy the
+ * static `graph` command uses. The live UI consumes the returned shard list to
+ * choose exact vs. sharded worker execution.
+ */
+export async function resolveLiveEngineShards(args, cli) {
+    const opts = {
+        cwd: args.cwd,
+        noCache: args.noCache,
+        resolution: args.resolution,
+        exact: args.exact,
+        ...(args.cliScript === undefined ? {} : { cliScript: args.cliScript }),
+    };
+    const resolution = await resolveEngineShards(opts, cli, []);
+    return resolution.shards;
+}
+/**
+ * Execute a sharded graph build for the interactive/live runner and reduce the
+ * result to the serializable `LiveGraphOutput` shape consumed by Ink and worker
+ * transports.
+ */
+export async function runShardedLiveBuild(args, shards, datastore, onProgress) {
+    const result = await runShardedGraph({
+        shards,
+        projectRoot: args.cwd,
+        cliScript: args.cliScript ?? process.argv[1] ?? '',
+        adapter: pickAdapter(args.cwd),
+        resolutionMode: args.resolution ?? 'exact',
+        useCache: args.noCache !== true,
+        config: args.config ?? {},
+        rules: args.rules ?? currentRules(),
+        catalogRepo: datastore ? new CatalogRepo(datastore) : null,
+        emitFeatures: DASHBOARD_FEATURE_COLUMNS,
+        onProgress,
+    });
+    return buildLiveGraphOutput({
+        catalog: result.catalog,
+        indexes: result.indexes,
+        signals: result.signals,
+        cacheHit: result.cacheHit,
+    }, args.cwd);
+}
+//# sourceMappingURL=graph-sharded-engine.js.map

package/dist/cli/graph-sharded-engine.js.map

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

package/dist/cli/graph-single-run-mode.d.ts

@@ -0,0 +1,23 @@
+import { type ToolCliContext } from '@opensip-cli/core';
+import { type RunGraphResult } from './orchestrate.js';
+import type { GraphCommandOptions } from './graph-options.js';
+import type { GraphRunOutcome } from './graph-run-outcome.js';
+import type { GraphProfileBuilder } from './profile.js';
+import type { Rule } from '../types.js';
+type DispatchGraphResult = (opts: GraphCommandOptions, rawResult: RunGraphResult, cli: ToolCliContext, startedAt: string, suppressionRoot: string) => Promise<GraphRunOutcome | undefined>;
+export interface SinglePathContext {
+    readonly opts: GraphCommandOptions;
+    readonly cli: ToolCliContext;
+    readonly rules: readonly Rule[];
+    readonly startedAt: string;
+    readonly profile?: GraphProfileBuilder;
+    readonly dispatchGraphResult: DispatchGraphResult;
+}
+/**
+ * Whole-project or single-positional-path graph execution. Owns the
+ * exact/sharded engine dispatch, profiling run bucket, shard-failure surfacing,
+ * and language mismatch policy for the single-run shape.
+ */
+export declare function executeSinglePathGraph(ctx: SinglePathContext, positionalPaths: readonly string[]): Promise<GraphRunOutcome | undefined>;
+export {};
+//# sourceMappingURL=graph-single-run-mode.d.ts.map

package/dist/cli/graph-single-run-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-single-run-mode.d.ts","sourceRoot":"","sources":["../../src/cli/graph-single-run-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,cAAc,CAAC;AACjF,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,aAAa,CAAC;AAKjD,KAAK,mBAAmB,GAAG,CACzB,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,cAAc,EACzB,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,KACpB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CACnD;AAmBD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,iBAAiB,EACtB,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CA8EtC"}

package/dist/cli/graph-single-run-mode.js

@@ -0,0 +1,107 @@
+import { ConfigurationError, currentScope, logger, SystemError, } from '@opensip-cli/core';
+import { DASHBOARD_FEATURE_COLUMNS } from './graph-feature-columns.js';
+import { countFiles } from './graph-report.js';
+import { engineSelectionReason, realpathOrSelf, resolveEngineShards, runProfiledShardedBuild, } from './graph-sharded-engine.js';
+import { loadGraphConfig, runGraph } from './orchestrate.js';
+import { positionalPathLabel } from './positional-paths.js';
+const MODULE_GRAPH_CLI = 'graph:cli';
+function recordPartitionStage(profileRun, partition) {
+    if (profileRun === undefined || partition === undefined)
+        return;
+    profileRun.recordStage('partition', partition.durationMs, partition.detail);
+}
+function finishProfileRun(profileRun, result) {
+    if (profileRun !== undefined) {
+        profileRun.finish(result);
+    }
+}
+/**
+ * Whole-project or single-positional-path graph execution. Owns the
+ * exact/sharded engine dispatch, profiling run bucket, shard-failure surfacing,
+ * and language mismatch policy for the single-run shape.
+ */
+export async function executeSinglePathGraph(ctx, positionalPaths) {
+    const { opts, cli, rules, startedAt, profile, dispatchGraphResult } = ctx;
+    // Realpath the run root ONCE, before engine selection (F3 path parity). The
+    // EXACT engine normalizes its project dir via realpathSync internally
+    // (graph-typescript normalize-project-dir); the SHARDED worker derives
+    // project-relative `code.file` paths against this `projectRoot`. Under a
+    // symlinked cwd a RAW root would make the sharded paths gain `../..` prefixes
+    // while exact stays canonical, so the two engines emitted different
+    // `code.file` values. Canonicalizing here keeps both engines byte-identical.
+    const runCwd = realpathOrSelf(positionalPaths[0] ?? opts.cwd, opts.cwd);
+    const config = loadGraphConfig(opts.cwd);
+    const resolution = await resolveEngineShards(opts, cli, positionalPaths);
+    const shards = resolution.shards;
+    logger.info({
+        evt: 'graph.cli.graph.engine',
+        module: MODULE_GRAPH_CLI,
+        mode: shards.length > 1 ? 'sharded' : 'exact',
+        requestedExact: opts.exact === true,
+        shards: shards.length,
+        reason: engineSelectionReason(opts, positionalPaths, shards.length > 1),
+    });
+    const profileRun = profile?.startRun({
+        label: positionalPaths.length === 0 ? 'root' : positionalPathLabel(runCwd, opts.cwd),
+        cwd: runCwd,
+        mode: shards.length > 1 ? 'sharded' : 'single-process',
+    });
+    // @fitness-ignore-next-line detached-promises -- sync profiling bookkeeping helper.
+    recordPartitionStage(profileRun, resolution.partition);
+    const result = shards.length > 1
+        ? await runProfiledShardedBuild(profileRun, {
+            opts,
+            shards,
+            projectRoot: runCwd,
+            cli,
+            config,
+            rules,
+        })
+        : await runGraph({
+            cwd: runCwd,
+            noCache: opts.noCache,
+            resolution: opts.resolution,
+            language: opts.language,
+            config,
+            rules,
+            datastore: cli.scope.datastore(),
+            emitFeatures: DASHBOARD_FEATURE_COLUMNS,
+            onProgress: profileRun?.onProgress,
+        });
+    // @fitness-ignore-next-line detached-promises -- sync profiling bookkeeping helper.
+    finishProfileRun(profileRun, result);
+    if (shards.length > 1) {
+        const sharded = result;
+        if (sharded.failedShardIds && sharded.failedShardIds.length > 0) {
+            throw new SystemError(`Sharded graph build had ${sharded.failedShardIds.length} shard failure(s); ` +
+                `catalog and any --gate-* / baseline artifacts are incomplete. ` +
+                `See 'graph.sharded.shard_failed' log events for per-shard details.`, { code: 'GRAPH.SHARD.FAILURES' });
+        }
+    }
+    // @fitness-ignore-next-line detached-promises -- sync validation helper; throws synchronously on mismatch.
+    enforceLanguageMismatchPolicy(opts, result.catalog, [runCwd]);
+    const scope = currentScope();
+    if (scope !== undefined) {
+        // @fitness-ignore-next-line detached-promises -- DiagnosticsBus.event is synchronous.
+        scope.diagnostics.event('execute', 'debug', 'graph build complete', {
+            mode: shards.length > 1 ? 'sharded' : 'exact',
+            shards: shards.length,
+        });
+    }
+    return await dispatchGraphResult(opts, result, cli, startedAt, runCwd);
+}
+/**
+ * D14 mixed policy. When `--language X` was specified and the run discovered
+ * zero files matching that adapter, exit 2 with the canonical error. Automatic
+ * detection paths do not trigger this check.
+ */
+function enforceLanguageMismatchPolicy(opts, catalog, paths) {
+    if (typeof opts.language !== 'string' || opts.language.length === 0)
+        return;
+    const fileCount = catalog === null ? 0 : countFiles(catalog);
+    if (fileCount > 0)
+        return;
+    const pathLabel = paths.map((p) => positionalPathLabel(p, opts.cwd)).join(', ');
+    throw new ConfigurationError(`--language ${opts.language} matched 0 files under ${pathLabel}; check the flag or paths.`);
+}
+//# sourceMappingURL=graph-single-run-mode.js.map

package/dist/cli/graph-single-run-mode.js.map

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

package/dist/cli/graph-workspace-mode.d.ts

@@ -0,0 +1,11 @@
+import { type ToolCliContext } from '@opensip-cli/core';
+import { type GraphProfileBuilder } from './profile.js';
+import type { GraphCommandOptions } from './graph-options.js';
+import type { GraphRunOutcome } from './graph-run-outcome.js';
+/**
+ * `graph --workspace` fan-out. The parent aggregates per-unit child runs for
+ * reporting and a single dashboard session, but intentionally does not emit a
+ * cloud signal envelope for the aggregate.
+ */
+export declare function executeWorkspaceGraph(opts: GraphCommandOptions, cli: ToolCliContext, profile?: GraphProfileBuilder): Promise<GraphRunOutcome | undefined>;
+//# sourceMappingURL=graph-workspace-mode.d.ts.map

package/dist/cli/graph-workspace-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-workspace-mode.d.ts","sourceRoot":"","sources":["../../src/cli/graph-workspace-mode.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAwB9D;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAsEtC"}

package/dist/cli/graph-workspace-mode.js

@@ -0,0 +1,87 @@
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { ConfigurationError, logger, } from '@opensip-cli/core';
+import { buildWorkspaceSessionContribution } from './graph-session-contribution.js';
+import { resolveAdaptersForRun } from './resolve-adapters.js';
+import { buildWorkspaceJsonDocument, writeWorkspaceReport } from './workspace-report.js';
+import { discoverPolyglotUnits, runWorkspaceUnitsInParallel } from './workspace-runner.js';
+const EVT_GRAPH_COMPLETE = 'graph.cli.graph.complete';
+const MODULE_GRAPH_CLI = 'graph:cli';
+function setProfileStageRecorded(profileRun, durationMs, unitCount) {
+    if (profileRun !== undefined) {
+        profileRun.recordStage('workspace-fanout', durationMs, `${String(unitCount)} unit(s)`);
+    }
+}
+function setProfileSummaryFinished(profileRun, summary) {
+    if (profileRun !== undefined) {
+        profileRun.finishSummary(summary);
+    }
+}
+/**
+ * `graph --workspace` fan-out. The parent aggregates per-unit child runs for
+ * reporting and a single dashboard session, but intentionally does not emit a
+ * cloud signal envelope for the aggregate.
+ */
+export async function executeWorkspaceGraph(opts, cli, profile) {
+    const cliScript = opts.cliScript ?? process.argv[1];
+    if (typeof cliScript !== 'string' || cliScript.length === 0) {
+        throw new ConfigurationError('--workspace: could not determine the CLI entry script (process.argv[1] is empty).');
+    }
+    const adapters = resolveAdaptersForRun(opts, cli);
+    const units = await discoverPolyglotUnits(opts.cwd, adapters);
+    if (units.length === 0) {
+        const adapterLabel = adapters.map((a) => a.id).join(', ') || '(no language adapters available)';
+        throw new ConfigurationError(`--workspace: no workspace units detected for [${adapterLabel}]. Use 'opensip graph' for whole-project analysis.`);
+    }
+    const profileRun = profile?.startRun({
+        label: 'workspace',
+        cwd: opts.cwd,
+        mode: 'workspace',
+    });
+    // Internal per-run timer for the workspace report artifact. The generic
+    // session row's timing remains host-owned.
+    const startedAt = Date.now();
+    const result = await runWorkspaceUnitsInParallel({
+        cwd: opts.cwd,
+        units,
+        cliScript,
+        concurrency: opts.concurrency,
+        noCache: opts.noCache,
+        resolution: opts.resolution,
+        recipe: opts.recipe,
+        ...(opts.language === undefined ? {} : { language: opts.language }),
+    });
+    const durationMs = Date.now() - startedAt;
+    setProfileStageRecorded(profileRun, durationMs, units.length);
+    const allSignals = [];
+    for (const r of result.perUnit)
+        allSignals.push(...r.signals);
+    setProfileSummaryFinished(profileRun, {
+        cacheHit: false,
+        signals: allSignals.length,
+    });
+    let session;
+    if (opts.json === true) {
+        cli.emitJson(buildWorkspaceJsonDocument(result.perUnit, durationMs));
+    }
+    else {
+        await writeWorkspaceReport(result.perUnit, durationMs, cli);
+        session = buildWorkspaceSessionContribution(opts, allSignals);
+    }
+    if (result.anyChildFailed) {
+        cli.setExitCode(EXIT_CODES.RUNTIME_ERROR);
+        process.stderr.write(`graph --workspace: at least one unit run failed; see per-unit output above.\n`);
+    }
+    else {
+        cli.setExitCode(EXIT_CODES.SUCCESS);
+    }
+    logger.info({
+        evt: EVT_GRAPH_COMPLETE,
+        module: MODULE_GRAPH_CLI,
+        units: result.perUnit.length,
+        findings: allSignals.length,
+        failed: result.anyChildFailed,
+        durationMs,
+    });
+    return session === undefined ? undefined : { session };
+}
+//# sourceMappingURL=graph-workspace-mode.js.map

package/dist/cli/graph-workspace-mode.js.map

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