@opensip-cli/graph 0.1.10 → 0.1.11

package/dist/cli/graph-result-delivery.js

@@ -0,0 +1,231 @@
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { currentScope, logger } from '@opensip-cli/core';
+import { finalizeGraphSignals } from './apply-suppressions.js';
+import { buildGraphEnvelope } from './build-envelope.js';
+import { runCatalogJsonMode, runGateMode } from './graph-modes.js';
+import { buildUnifiedReportLines, resolutionBannerText } from './graph-report.js';
+import { buildGraphSessionContribution } from './graph-session-contribution.js';
+import { GraphProfileBuilder, writeGraphProfile } from './profile.js';
+const EVT_GRAPH_COMPLETE = 'graph.cli.graph.complete';
+const MODULE_GRAPH_CLI = 'graph:cli';
+const MODULE_GRAPH_RENDER = 'graph:render';
+/** Profile bucket for the run shape: workspace fan-out, multi-path, or single graph. */
+function profileMode(opts) {
+    if (opts.workspace === true)
+        return 'workspace';
+    if ((opts.paths?.length ?? 0) > 1)
+        return 'multi-path';
+    return 'graph';
+}
+/** Create a profile builder when `--profile-output` is set. */
+export function createProfileBuilder(opts, startedAt) {
+    if (typeof opts.profileOutput !== 'string' || opts.profileOutput.length === 0) {
+        return undefined;
+    }
+    return new GraphProfileBuilder({
+        cwd: opts.cwd,
+        mode: profileMode(opts),
+        resolutionMode: opts.resolution,
+        startedAt,
+    });
+}
+/** Write the timing profile when `--profile-output` was requested. */
+export function writeProfileIfRequested(opts, profile) {
+    if (profile === undefined)
+        return;
+    if (typeof opts.profileOutput !== 'string' || opts.profileOutput.length === 0)
+        return;
+    const outPath = writeGraphProfile(opts.profileOutput, opts.cwd, profile.complete());
+    logger.info({
+        evt: 'graph.profile.write.complete',
+        module: MODULE_GRAPH_CLI,
+        output: outPath,
+    });
+}
+/**
+ * Assemble the run's {@link SignalEnvelope} from its raw engine signals
+ * (ADR-0011). Centralises `runId`/`createdAt` resolution off the live scope so
+ * cloud egress correlates with the run id the logger stamps; the envelope is
+ * pure (the clock read happens here, once).
+ */
+function envelopeFor(opts, result, durationMs) {
+    return buildGraphEnvelope({
+        signals: result.signals,
+        recipe: opts.recipe,
+        runId: currentScope()?.runId ?? '',
+        createdAt: new Date().toISOString(),
+        durationMs,
+        resolutionMode: result.catalog?.resolutionMode,
+    });
+}
+/**
+ * Dispatch a completed graph run to its output mode and return the run outcome
+ * for signal delivery and session persistence (undefined for plain `--json`).
+ */
+export async function dispatchGraphResult(opts, rawResult, cli, startedAt, suppressionRoot) {
+    // ADR-0014: apply the inline graph-ignore waivers BEFORE any mode consumes
+    // the signals — the gate baseline, catalog, render, and session persistence
+    // all see the post-waiver set. `--workspace` is covered transitively: each
+    // child runs `graph --json` through this function, so the parent aggregates
+    // already-waived signals.
+    //
+    // `suppressionRoot` is the build root the signals' `code.file` paths are
+    // RELATIVE TO — i.e. the positional subtree / sharded-child / workspace-unit
+    // root, NOT necessarily `opts.cwd`. A `graph <subdir>` run (and every
+    // `--workspace` child, which runs `graph <unitRoot> --json`) builds against
+    // `runCwd = positionalPaths[0]`, so its signal paths and directive files
+    // resolve under that root. Resolving against `opts.cwd` instead made every
+    // `@graph-ignore` directive file unreadable (ENOENT), silently leaking the
+    // waiver — the bug this parameter closes.
+    // Route through the SINGLE suppression chokepoint (finalizeGraphSignals) — the
+    // same seam the live/worker producers cross via buildLiveGraphOutput. The
+    // branded FinalizedSignals it returns is the only signal shape the
+    // session-contribution builder (and, transitively, the verdict + render) will
+    // accept, so a future fourth output path cannot deliver un-waived signals: the
+    // compiler rejects it.
+    const finalized = await finalizeGraphSignals(rawResult.signals, suppressionRoot);
+    return deliverGraphResult(opts, { ...rawResult, signals: finalized.signals }, cli, startedAt, finalized);
+}
+/**
+ * Deliver an already-waived run to its output mode (gate / catalog-json /
+ * render) and, on the human-facing render path, BUILD the generic-session
+ * contribution the host run plane persists (host-owned-run-timing Phase 3 —
+ * graph never writes the row itself). Split out of {@link dispatchGraphResult}
+ * so the multi-path path — which must waive each path's signals against ITS
+ * OWN root before aggregating (the roots differ) — can aggregate the kept
+ * signals and deliver once, without a second (wrong-root) suppression pass.
+ *
+ * The contribution is built HERE, where the branded {@link FinalizedSignals}
+ * is in scope, so the dashboard history can only ever carry post-waiver
+ * findings (the branding guard is not lost across the return boundary).
+ */
+export async function deliverGraphResult(opts, result, cli, startedAt, finalized) {
+    const suppressedCount = finalized.suppressedCount;
+    const durationMs = Math.max(0, Date.now() - Date.parse(startedAt));
+    if (opts.gateSave === true || opts.gateCompare === true) {
+        // ADR-0036: the envelope arrives fingerprint-stamped — `buildGraphEnvelope`
+        // passes graph's byte-preserved strategy into `buildSignalEnvelope`, which
+        // stamps at construction (over the canonical remapped ruleIds, exactly what
+        // the former post-hoc gate-path stamp produced). The host seams only read
+        // `signal.fingerprint`. runGateMode owns the deliverSignals call
+        // (host-derived exit), so the command-spec skips it.
+        const envelope = envelopeFor(opts, result, durationMs);
+        await runGateMode(opts, envelope, cli, result.catalog?.resolutionMode);
+        logger.info({
+            evt: EVT_GRAPH_COMPLETE,
+            module: MODULE_GRAPH_CLI,
+            suppressed: suppressedCount,
+        });
+        return { envelope };
+    }
+    if (typeof opts.catalogOutput === 'string' && opts.catalogOutput.length > 0) {
+        runCatalogJsonMode(opts, result, cli, startedAt);
+        logger.info({
+            evt: EVT_GRAPH_COMPLETE,
+            module: MODULE_GRAPH_CLI,
+            suppressed: suppressedCount,
+        });
+        return { envelope: envelopeFor(opts, result, durationMs) };
+    }
+    const envelope = await renderGraphResult(opts, result, startedAt, cli);
+    // Session persistence is dashboard history — populated on human-facing runs
+    // only. Skipped for:
+    //   - `--json` (the machine-artifact mode AND the carrier each
+    //     `executeWorkspaceGraph` child runs under — keeps "one human invocation
+    //     = one session"; the --workspace parent persists the single aggregate);
+    //   - `--report-to` (an export mode; like gate/catalog it opts out of session
+    //     history — the root delivers the envelope to the receiver instead).
+    // The host persists the returned `session` after the handler resolves; graph
+    // builds it here from the BRANDED FinalizedSignals so the contribution can
+    // only ever carry post-waiver findings regardless of which path reached here.
+    const isReportTo = typeof opts.reportTo === 'string' && opts.reportTo.length > 0;
+    const session = opts.json !== true && !isReportTo ? buildGraphSessionContribution(opts, finalized) : undefined;
+    cli.setExitCode(EXIT_CODES.SUCCESS);
+    logger.info({
+        evt: EVT_GRAPH_COMPLETE,
+        module: MODULE_GRAPH_CLI,
+        signals: result.signals.length,
+        suppressed: suppressedCount,
+    });
+    // Plain `--json` is the workspace-child carrier: it returns `undefined` so
+    // the root does not cloud-emit per child (the parent owns the dashboard
+    // aggregate, not per-unit signal batches — audit P1-2). Every other mode
+    // (default render, `--report-to`) returns the outcome for root delivery; only
+    // the non-export render path carries a `session`.
+    return opts.json === true ? undefined : { envelope, ...(session ? { session } : {}) };
+}
+/**
+ * Render the run and return its {@link SignalEnvelope} (ADR-0011).
+ *
+ * `--json` emits the envelope through the shared `formatSignalJson`
+ * (`cli.emitEnvelope`). The default/`--verbose` path hands a {@link RunPresentation}
+ * to the render seam (Ink on TTY, plain text in pipes/CI): the SAME `envelope`
+ * already built here IS carried on the render object (envelope-first-presentation
+ * plan, RP-2), so `presentationToView` derives the PASS/FAIL summary and verdict
+ * from it — graph no longer carries a count-based `graph-done` summary. The
+ * verbose catalog/findings/entry-point body rides as `verboseDetail`
+ * ({kind:'lines'}, ADR-0021), and that verbose/detail surface also carries the
+ * per-unit table; graph's fast-tier caveat moves to `RunPresentation.banners` (a
+ * muted line above the summary); the non-verbose footer hints are emitted by the
+ * shared seam. The host-stamped
+ * `durationMs` (ADR-0051) is threaded as `RunPresentation.durationMs` so the
+ * summary shows the real wall-clock — graph's envelope units carry `durationMs: 0`,
+ * so without this thread `presentationToView`'s unit-sum default would render
+ * `0ms`. The envelope is also RETURNED for the composition root's cloud +
+ * `--report-to` delivery (egress, a separate plane — untouched here).
+ */
+async function renderGraphResult(opts, result, startedAt, cli) {
+    const durationMs = Math.max(0, Date.now() - Date.parse(startedAt));
+    const envelope = envelopeFor(opts, result, durationMs);
+    if (opts.json === true) {
+        logger.info({
+            evt: 'graph.render.json.start',
+            module: MODULE_GRAPH_RENDER,
+        });
+        cli.emitEnvelope(envelope);
+        logger.info({
+            evt: 'graph.render.json.complete',
+            module: MODULE_GRAPH_RENDER,
+        });
+        return envelope;
+    }
+    logger.info({ evt: 'graph.render.presentation.start', module: MODULE_GRAPH_RENDER });
+    const verbose = opts.verbose === true;
+    // ADR-0021: graph's verbose body is carried as VerboseDetail{kind:'lines'} and
+    // rendered through the shared resultToView seam — the same path the live runner
+    // uses — instead of a graph-only `reportLines`/`footerHints` shape. The
+    // non-verbose footer hints are emitted by the seam (envelope-first-presentation
+    // RP-2 → `presentationToView`).
+    const verboseDetail = verbose
+        ? {
+            kind: 'lines',
+            lines: buildUnifiedReportLines({
+                catalog: result.catalog,
+                indexes: result.indexes,
+                signals: result.signals,
+                cacheHit: result.cacheHit,
+            }, { includeSummary: false }),
+        }
+        : undefined;
+    const resolutionBanner = resolutionBannerText(result.catalog?.resolutionMode);
+    // envelope-first-presentation RP-2: route graph's static render through the
+    // shared RunPresentation. The envelope IS carried (it drives the verdict and
+    // optional verbose/detail table); `durationMs` is threaded so the host-owned
+    // wall-clock wins over the unit-sum (graph units carry durationMs:0); the
+    // resolution caveat moves to `banners`.
+    const presentation = {
+        type: 'run-presentation',
+        tool: 'graph',
+        envelope,
+        ...(verboseDetail === undefined ? {} : { verboseDetail }),
+        ...(resolutionBanner === undefined ? {} : { banners: [resolutionBanner] }),
+        durationMs,
+    };
+    await cli.render(presentation);
+    logger.info({
+        evt: 'graph.render.presentation.complete',
+        module: MODULE_GRAPH_RENDER,
+    });
+    return envelope;
+}
+//# sourceMappingURL=graph-result-delivery.js.map

package/dist/cli/graph-result-delivery.js.map

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

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

@@ -1,105 +1,24 @@
 /**
- * graph-runner — owns the live-view state machine for `opensip graph`.
- *
- * Layer 5 Phase 3 lifted the graph live view out of `opensip-cli`.
- * The state machine (loading → running → done | error), `runGraph`
- * orchestration, `buildUnifiedReportLines` post-call, and the Ink/React
- * render tree live here, in the package that owns the graph command
- * surface. Adding a fourth tool with a live view requires zero CLI
- * edits — each tool ships its own renderer and registers it via
- * `cli.registerLiveView(key, renderer)`.
- *
- * Progress rendering is the shared `<LiveProgress>` from
- * `@opensip-cli/cli-ui` (ADR-0016), driven in `phases` mode: graph's
- * 7 fixed pipeline stages map onto the universal `ProgressEvent` stream.
- * The former graph-local StageChecklist/StageLine/RunningStageLine are
- * gone. The build runs OFF the main process (ADR-0028): the runner forks
- * the CLI to `graph-run-worker` via `runOffThreadOrInProcess`, which
- * re-bootstraps the scope, runs the selected graph engine (exact or sharded),
- * and streams stage progress + the slim {@link LiveGraphOutput} back over IPC
- * — so this process stays free to animate the spinner + 80ms clock instead of
- * freezing under type-checking, shard coordination, merge/link, or rule work.
- * It falls back to the in-process closure when forking is disabled
- * (`OPENSIP_CLI_NO_WORKER`) or the fork fails; both paths reduce to the same
- * `{ signals, reportLines }` payload.
- *
- * Single exit-code write path: error outcomes route through the
- * supplied `setExitCode` callback (`ToolCliContext.setExitCode`) so the
- * CLI keeps its only `process.exitCode` mutator.
+ * graph-runner — live-view entry for `opensip graph` via @opensip-cli/cli-live.
  */
 import { type LiveViewContext, type ToolRunCompletion } from '@opensip-cli/core';
 import type { Shard } from './orchestrate/shard-model.js';
 import type { GraphConfig, ResolutionMode, Rule } from '../types.js';
 import type { DataStore } from '@opensip-cli/datastore';
-interface GraphRunnerArgs {
+export interface GraphRunnerArgs {
     readonly cwd: string;
     readonly noCache?: boolean;
-    /**
-     * `--resolution`: edge resolution tier. Forwarded to `runGraph` so the
-     * interactive default path (`graph --resolution fast` with no other
-     * flags) actually runs the chosen tier instead of silently using exact.
-     */
     readonly resolution?: ResolutionMode;
-    /**
-     * `--verbose`: when true, show the detailed catalog / findings-by-rule
-     * / entry-points blocks in the done view. Default (false) shows the
-     * summary line + footer hint only, matching fit's default surface.
-     */
     readonly verbose?: boolean;
-    /** `--quiet`: suppress the banner / project header / run header chrome, leaving
-     *  only the live progress, summary, and (when not verbose) footer hints —
-     *  parity with fit/sim. */
     readonly quiet?: boolean;
-    /**
-     * The project's `graph:` config block (rule knobs like
-     * `minCrossPackageDuplicatePackages`, `minDuplicateBodyLines`,
-     * `entryPointHashes`). Forwarded to `runGraph` so the interactive
-     * default path honors the SAME config as the `executeGraph` dispatch
-     * path.
-     */
     readonly config?: GraphConfig;
-    /**
-     * `--recipe`: the resolved rule subset for this run. Resolved on the
-     * dispatch seam (`tool.ts`, inside the entered RunScope) and forwarded
-     * to `runGraph` so the interactive path honors `--recipe` for parity
-     * with `executeGraph`. Absent ⇒ `runGraph` falls back to `currentRules()`.
-     */
     readonly rules?: readonly Rule[];
-    /**
-     * `--recipe` NAME (serializable), forwarded to the off-process worker so it can
-     * re-resolve the rule set itself (rules are functions — they can't cross the
-     * fork boundary). The in-process fallback uses {@link GraphRunnerArgs.rules}.
-     */
     readonly recipe?: string;
-    /**
-     * `--exact`: whether the user opted out of the default sharded engine. Threaded
-     * through so the live view drives the SAME engine the static path's policy
-     * selects (ADR-0032). `isTTY` NEVER affects the engine — only `exact` +
-     * shardability do.
-     */
     readonly exact?: boolean;
-    /**
-     * The pre-resolved shard set (ADR-0032), computed on the dispatch seam
-     * (`dispatchGraphLiveView`, which holds the `cli` context the engine policy
-     * needs). `length > 1` ⇒ the SHARDED engine. The normal path serializes this
-     * plain-data plan into the worker spec so the render process never coordinates
-     * the sharded build.
-     */
     readonly shards?: readonly Shard[];
 }
 export interface RenderGraphLiveOptions {
     readonly setExitCode?: (code: number) => void;
 }
-/**
- * Render the live `graph` view. Resolves once the underlying Ink app exits with
- * a {@link ToolRunCompletion} carrying the run's `session` contribution (the
- * HOST persists it after this resolves — host-owned-run-timing Phase 2; the
- * component no longer writes the session itself). Graph's cloud egress lives on
- * the static gate path, so the live wrapper returns no envelope.
- *
- * `setExitCode` is the single mutator path on `process.exitCode`; the runner
- * calls it for error outcomes so the CLI's exit-code seam stays the only writer.
- */
 export declare function renderGraphLive(args: GraphRunnerArgs, datastore?: DataStore, options?: RenderGraphLiveOptions, liveContext?: LiveViewContext): Promise<ToolRunCompletion>;
-export {};
 //# sourceMappingURL=graph-runner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graph-runner.d.ts","sourceRoot":"","sources":["../../src/cli/graph-runner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA6BH,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAkB3B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAuExD,UAAU,eAAe;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;+BAE2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CACpC;AAuTD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,eAAe,EACrB,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,CAAC,EAAE,sBAAsB,EAChC,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAoB5B"}
+{"version":3,"file":"graph-runner.d.ts","sourceRoot":"","sources":["../../src/cli/graph-runner.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAgB3B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAmCxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CACpC;AAmBD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,eAAe,EACrB,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,CAAC,EAAE,sBAAsB,EAChC,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA6G5B"}