@opensip-cli/graph 0.1.0

package/dist/cli/graph-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-progress.js","sourceRoot":"","sources":["../../src/cli/graph-progress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAyC;IAChE,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,eAAe;IACtB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,oBAAoB;IAC7B,KAAK,EAAE,eAAe;IACtB,QAAQ,EAAE,iBAAiB;IAC3B,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAyC;IACxE,GAAG,YAAY;IACf,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAyB,EAAE,OAAO,GAAG,KAAK;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,YAAY,CAAC;IAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACjF,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;YACjC,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * graph-recipes command — list all available graph recipes.
+ *
+ * Mirrors fitness's `listRecipes` (`cli/fit-recipes.ts`): maps the
+ * scope-bound recipe registry to the shared `ListRecipesResult` contract so
+ * the existing CLI renderer (`viewListRecipes`) handles the output with no
+ * contracts change. `checkCount` is a free-form label; graph reuses it as a
+ * rule count ("all rules" / "N rules").
+ *
+ * Reads `currentGraphRecipes()`, so it runs inside the entered RunScope (the
+ * command action body does).
+ */
+import type { ListRecipesResult } from '@opensip-cli/contracts';
+/**
+ * Returns metadata for every registered graph recipe.
+ *
+ * Returns a `Promise` to mirror fitness's `listRecipes` signature (which is
+ * genuinely async — it loads user plugins first). Graph has no async
+ * pre-step today; the registry is scope-seeded at construction, so this
+ * resolves synchronously.
+ */
+export declare function listGraphRecipes(): Promise<ListRecipesResult>;
+//# sourceMappingURL=graph-recipes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-recipes.d.ts","sourceRoot":"","sources":["../../src/cli/graph-recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAoB7D"}

package/dist/cli/graph-recipes.js

@@ -0,0 +1,44 @@
+/**
+ * graph-recipes command — list all available graph recipes.
+ *
+ * Mirrors fitness's `listRecipes` (`cli/fit-recipes.ts`): maps the
+ * scope-bound recipe registry to the shared `ListRecipesResult` contract so
+ * the existing CLI renderer (`viewListRecipes`) handles the output with no
+ * contracts change. `checkCount` is a free-form label; graph reuses it as a
+ * rule count ("all rules" / "N rules").
+ *
+ * Reads `currentGraphRecipes()`, so it runs inside the entered RunScope (the
+ * command action body does).
+ */
+import { currentGraphRecipes } from '../recipes/registry.js';
+/**
+ * Returns metadata for every registered graph recipe.
+ *
+ * Returns a `Promise` to mirror fitness's `listRecipes` signature (which is
+ * genuinely async — it loads user plugins first). Graph has no async
+ * pre-step today; the registry is scope-seeded at construction, so this
+ * resolves synchronously.
+ */
+export function listGraphRecipes() {
+    const recipes = currentGraphRecipes()
+        .getAllRecipes()
+        .map((recipe) => {
+        const selector = recipe.rules;
+        let checkCount;
+        if (selector.type === 'all') {
+            checkCount = 'all rules';
+        }
+        else if (selector.type === 'explicit') {
+            checkCount = `${selector.ids.length} rules`;
+        }
+        else {
+            checkCount = 'pattern-based';
+        }
+        return { name: recipe.name, description: recipe.description, checkCount };
+    });
+    return Promise.resolve({
+        type: 'list-recipes',
+        recipes,
+    });
+}
+//# sourceMappingURL=graph-recipes.js.map

package/dist/cli/graph-recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-recipes.js","sourceRoot":"","sources":["../../src/cli/graph-recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAI7D;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,mBAAmB,EAAE;SAClC,aAAa,EAAE;SACf,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;QAC9B,IAAI,UAAkB,CAAC;QACvB,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC5B,UAAU,GAAG,WAAW,CAAC;QAC3B,CAAC;aAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACxC,UAAU,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,eAAe,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,EAAE,cAAc;QACpB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Unified human-readable graph report.
+ *
+ * Extracted from `cli/graph.ts` so the orchestrator there stays focused
+ * on dispatch (json/sarif/catalog-json/packages/report/gate/cloud-report).
+ *
+ * Owns the catalog-summary, findings-by-rule, entry-points, and summary
+ * sections as a `string[]` builder (`buildUnifiedReportLines`). The graph
+ * CLI feeds these lines into a `GraphDoneResult`; the central render seam
+ * turns them into Ink (TTY) or plain text (pipe/CI) — there is no direct
+ * stdout writer here anymore.
+ */
+import type { Catalog, Indexes } from '../types.js';
+import type { Signal } from '@opensip-cli/core';
+export interface UnifiedReportInput {
+    readonly catalog: Catalog | null;
+    readonly indexes: Indexes | null;
+    readonly signals: readonly Signal[];
+    readonly cacheHit: boolean;
+}
+/**
+ * The serializable live-run output the off-process graph worker streams back to
+ * the parent (ADR-0028). A `RunGraphResult` itself can't cross the fork boundary
+ * — it carries class instances with methods (the resolution-stats accumulator) +
+ * Maps — so the worker (which holds the catalog/indexes) pre-computes the things
+ * the live renderer needs: the run's `signals` (for persistence + the verdict),
+ * the count of waivers applied, and the already-built `reportLines`. All plain
+ * data.
+ *
+ * `signals` here is the POST-`@graph-ignore` waived set. {@link buildLiveGraphOutput}
+ * is the live path's leg of the single suppression chokepoint (it calls
+ * {@link finalizeGraphSignals}), so the live/worker producers and the static
+ * `dispatchGraphResult` path apply IDENTICAL waivers — that is the structural fix
+ * for the TTY-only leak (suppression was previously applied on the static path
+ * only). `reportLines` is rendered from the SAME waived set, so the TTY final
+ * frame and the piped report agree finding-for-finding.
+ */
+export interface LiveGraphOutput {
+    readonly signals: readonly Signal[];
+    readonly suppressedCount: number;
+    readonly reportLines: readonly string[];
+}
+/**
+ * Derive the serializable {@link LiveGraphOutput} from a completed build — the
+ * LIVE path's leg of the single suppression chokepoint. Used by BOTH the
+ * off-process worker and the in-process fallback so the live renderer gets an
+ * identical, already-waived payload regardless of where the build ran.
+ *
+ * `buildRoot` is the directory the signals' project-relative `code.file` paths
+ * resolve against — the same base the static path threads as `suppressionRoot`.
+ * For the bare-`graph` live view this is the project cwd. Both `signals` and the
+ * `reportLines` rendered from them are the WAIVED set, closing the parity gap.
+ */
+export declare function buildLiveGraphOutput(input: UnifiedReportInput, buildRoot: string): Promise<LiveGraphOutput>;
+export declare function countFiles(catalog: Catalog): number;
+/**
+ * Build the unified terminal report lines: catalog summary, findings
+ * grouped by rule, top-N entry points, and a single-line summary. The
+ * caller decides where to write them (raw stdout for non-interactive
+ * paths, or the Ink view in the default human-report path).
+ */
+export interface BuildUnifiedReportOptions {
+    /**
+     * Whether to append the trailing "== Summary ==" footer block.
+     * Default `true` for back-compat with the stdout writer. The Ink
+     * runner sets this to `false` because the cli-ui `RunSummary`
+     * component renders the summary in its place.
+     */
+    readonly includeSummary?: boolean;
+}
+export declare function buildUnifiedReportLines(input: UnifiedReportInput, options?: BuildUnifiedReportOptions): readonly string[];
+/**
+ * The fast-tier approximation caveat for a catalog, or `undefined` when
+ * the catalog is exact (semantic). Surfaced through `GraphDoneResult` so
+ * the render seam shows it once, themed in Ink and plain in pipes — no
+ * hand-written stdout copy.
+ */
+export declare function resolutionBannerText(resolutionMode: 'exact' | 'fast' | undefined): string | undefined;
+//# sourceMappingURL=graph-report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-report.d.ts","sourceRoot":"","sources":["../../src/cli/graph-report.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQnD;AAWD;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,yBAAyB,GAClC,SAAS,MAAM,EAAE,CAenB;AAWD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAC3C,MAAM,GAAG,SAAS,CAEpB"}

package/dist/cli/graph-report.js

@@ -0,0 +1,186 @@
+// @fitness-ignore-file performance-anti-patterns -- spread in CLI report aggregation iterates bounded result sets (rule counts, entry-point lists).
+// @fitness-ignore-file public-api-jsdoc -- helper barrel for the graph CLI report; the report payload types are documented via their consumers (graph.ts) and the engine's public types module.
+/**
+ * @fileoverview Unified human-readable graph report.
+ *
+ * Extracted from `cli/graph.ts` so the orchestrator there stays focused
+ * on dispatch (json/sarif/catalog-json/packages/report/gate/cloud-report).
+ *
+ * Owns the catalog-summary, findings-by-rule, entry-points, and summary
+ * sections as a `string[]` builder (`buildUnifiedReportLines`). The graph
+ * CLI feeds these lines into a `GraphDoneResult`; the central render seam
+ * turns them into Ink (TTY) or plain text (pipe/CI) — there is no direct
+ * stdout writer here anymore.
+ */
+import { inferEntryPoints } from '../rules/_entry-points.js';
+import { currentRules } from '../rules/registry.js';
+import { finalizeGraphSignals } from './apply-suppressions.js';
+const ENTRY_POINTS_PREVIEW = 10;
+const FINDINGS_PREVIEW = 10;
+/**
+ * Derive the serializable {@link LiveGraphOutput} from a completed build — the
+ * LIVE path's leg of the single suppression chokepoint. Used by BOTH the
+ * off-process worker and the in-process fallback so the live renderer gets an
+ * identical, already-waived payload regardless of where the build ran.
+ *
+ * `buildRoot` is the directory the signals' project-relative `code.file` paths
+ * resolve against — the same base the static path threads as `suppressionRoot`.
+ * For the bare-`graph` live view this is the project cwd. Both `signals` and the
+ * `reportLines` rendered from them are the WAIVED set, closing the parity gap.
+ */
+export async function buildLiveGraphOutput(input, buildRoot) {
+    const finalized = await finalizeGraphSignals(input.signals, buildRoot);
+    const waivedInput = { ...input, signals: finalized.signals };
+    return {
+        signals: finalized.signals,
+        suppressedCount: finalized.suppressedCount,
+        reportLines: buildUnifiedReportLines(waivedInput, { includeSummary: false }),
+    };
+}
+export function countFiles(catalog) {
+    const files = new Set();
+    for (const name of Object.keys(catalog.functions)) {
+        const occs = catalog.functions[name];
+        if (!occs)
+            continue;
+        for (const o of occs)
+            files.add(o.filePath);
+    }
+    return files.size;
+}
+function countOccurrences(catalog) {
+    let n = 0;
+    for (const name of Object.keys(catalog.functions)) {
+        const occs = catalog.functions[name];
+        if (occs)
+            n += occs.length;
+    }
+    return n;
+}
+export function buildUnifiedReportLines(input, options) {
+    const knownRuleIds = currentRules().map((r) => r.slug);
+    const byRule = groupSignalsByRule(input.signals);
+    const eps = input.catalog && input.indexes ? enrichEntryPoints(input.catalog, input.indexes) : [];
+    const includeSummary = options?.includeSummary ?? true;
+    return [
+        ...renderCatalogSection(input.catalog, input.cacheHit),
+        '',
+        ...renderFindingsSection(input.signals.length, byRule, knownRuleIds),
+        ...renderEntryPointsSection(eps),
+        ...(includeSummary
+            ? ['', ...renderSummarySection(byRule, knownRuleIds, input.signals.length)]
+            : []),
+    ];
+}
+/**
+ * The one-line "approximate edges" caveat for a fast-tier catalog. Kept
+ * factual and non-alarming: fast mode is a legitimate chosen tier, not an
+ * error — "you asked for fast; here's the honest caveat."
+ */
+function resolutionBanner() {
+    return 'Resolution: fast (syntactic) — edges are approximate; re-run with --resolution exact for semantic precision.';
+}
+/**
+ * The fast-tier approximation caveat for a catalog, or `undefined` when
+ * the catalog is exact (semantic). Surfaced through `GraphDoneResult` so
+ * the render seam shows it once, themed in Ink and plain in pipes — no
+ * hand-written stdout copy.
+ */
+export function resolutionBannerText(resolutionMode) {
+    return resolutionMode === 'fast' ? resolutionBanner() : undefined;
+}
+function renderCatalogSection(catalog, cacheHit) {
+    const lines = ['== Catalog =='];
+    if (catalog) {
+        const fileCount = countFiles(catalog);
+        const fnCount = countOccurrences(catalog);
+        lines.push(`${String(fnCount)} functions across ${String(fileCount)} files (cacheHit=${String(cacheHit)})`);
+        if (catalog.resolutionMode === 'fast') {
+            lines.push(resolutionBanner());
+        }
+    }
+    else {
+        /* v8 ignore next */
+        lines.push('(no catalog produced)');
+    }
+    return lines;
+}
+function renderFindingsSection(totalSignals, byRule, knownRuleIds) {
+    const lines = [`== Findings (${String(totalSignals)}) ==`];
+    for (const ruleId of knownRuleIds) {
+        lines.push(...renderRuleBlock(ruleId, byRule.get(ruleId) ?? []));
+    }
+    return lines;
+}
+function renderRuleBlock(ruleId, findings) {
+    const header = `[${ruleId}] ${String(findings.length)} finding(s)`;
+    const preview = findings.slice(0, FINDINGS_PREVIEW).map((f) => {
+        const loc = f.line ? `:${String(f.line)}` : '';
+        return `  ${f.filePath}${loc} — ${f.message}`;
+    });
+    const overflow = findings.length > preview.length
+        ? /* v8 ignore next */
+            [`  ... ${String(findings.length - preview.length)} more (use --json for full list)`]
+        : [];
+    return [header, ...preview, ...overflow, ''];
+}
+function renderEntryPointsSection(eps) {
+    const header = `== Entry points (${String(eps.length)}) ==`;
+    if (eps.length === 0)
+        return [header, '(none inferred)'];
+    const top = [...eps]
+        .sort((a, b) => a.qualifiedName.localeCompare(b.qualifiedName))
+        .slice(0, ENTRY_POINTS_PREVIEW);
+    const intro = `Top ${String(top.length)} (use --json for full list):`;
+    const items = top.map((ep) => `  [${ep.reason}] ${ep.qualifiedName}`);
+    return [header, intro, ...items];
+}
+function renderSummarySection(byRule, knownRuleIds, totalSignals) {
+    const stats = summarizeRules(byRule, knownRuleIds);
+    return [
+        '== Summary ==',
+        `${String(stats.clean)} rule(s) clean, ${String(stats.dirty)} with findings (${String(totalSignals)} total).`,
+        'Run `opensip report` for the interactive Code Paths view.',
+    ];
+}
+function enrichEntryPoints(catalog, indexes) {
+    const eps = inferEntryPoints(catalog, indexes);
+    const out = [];
+    for (const ep of eps) {
+        const occ = indexes.byBodyHash.get(ep.bodyHash);
+        if (!occ)
+            continue;
+        out.push({
+            reason: ep.reason,
+            qualifiedName: occ.qualifiedName,
+            filePath: occ.filePath,
+            line: occ.line,
+        });
+    }
+    return out;
+}
+function groupSignalsByRule(signals) {
+    const out = new Map();
+    for (const s of signals) {
+        let arr = out.get(s.ruleId);
+        if (!arr) {
+            arr = [];
+            out.set(s.ruleId, arr);
+        }
+        arr.push(s);
+    }
+    return out;
+}
+function summarizeRules(byRule, knownRuleIds) {
+    let clean = 0;
+    let dirty = 0;
+    for (const ruleId of knownRuleIds) {
+        const findings = byRule.get(ruleId) ?? [];
+        if (findings.length === 0)
+            clean += 1;
+        else
+            dirty += 1;
+    }
+    return { clean, dirty };
+}
+//# sourceMappingURL=graph-report.js.map

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

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

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

@@ -0,0 +1,106 @@
+/**
+ * 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 heavy build, 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 the
+ * type-check. 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.
+ */
+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 {
+    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 runs IN-PROCESS here (its shards
+     * are already subprocesses, so the render thread isn't doing the heavy build);
+     * otherwise the EXACT single-program engine runs OFF-process in the
+     * `graph-run-worker` (ADR-0028). Passed by reference in-process (the runner
+     * shares the dispatch process), so the file paths never cross an IPC boundary.
+     */
+    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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runner.d.ts","sourceRoot":"","sources":["../../src/cli/graph-runner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA0BH,OAAO,EAGL,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;AA8DxD,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;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CACpC;AA8RD,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"}