@opensip-cli/graph 0.1.0

package/dist/cli/graph/graph-aux-command-specs.js

@@ -0,0 +1,390 @@
+// @fitness-ignore-file no-direct-stdout-in-tool-engine -- auxiliary subcommand status line: `graph-baseline-export` writes the JSON baseline to a file and prints a one-line "Exported graph baseline to <path>" confirmation (the --json path uses cli.emitJson). This is not the signal-envelope run output (ADR-0011), which routes through the composition root.
+// @fitness-ignore-file detached-promises -- async command handlers invoke synchronous helpers (runCatalogJsonMode/runSarifExportMode/handleGraphError all return void); the heuristic flags them inside the async handlers. Matches the sibling graph CLI files (graph.ts, graph-modes.ts, orchestrate.ts).
+// @fitness-ignore-file only-documented-toolcli-seams -- same rationale as the no-direct-stdout waiver above: the one-line "Exported graph baseline to <path>" status confirmation after a file write; the --json path uses cli.emitJson. Not run output through a ToolCliContext seam.
+/**
+ * graph-aux-command-specs — the declarative graph auxiliary commands (release
+ * launch Phase 5 Task 5.2).
+ *
+ * Replaces graph's hand-rolled `registerGraph*Command()` bodies. The host mounts
+ * each spec via `mountCommandSpec`; the tool no longer touches Commander. Each
+ * helper's raw `.option()`/`.argument()` calls translate 1:1 to
+ * `OptionSpec`/`ArgSpec`; positional arguments arrive on the parsed-opts object
+ * under the `_args` key (the host's uniform positional convention — see
+ * `mountCommandSpec`).
+ *
+ * Output modes:
+ *  - `graph-recipes` → `command-result`: the handler returns the list result;
+ *    the host dispatches it through the shared seam (`--json` → JSON, else
+ *    render). Byte-identical to the former `if (json) emitJson else render` body.
+ *  - every other aux command → `raw-stream`: each owns its full IO (writes a
+ *    file and/or prints a line, sets its own exit code, owns its `--json`
+ *    branch) — the documented non-Ink exception. The host renders nothing.
+ */
+import { commonFlags, EXIT_CODES } from '@opensip-cli/contracts';
+import { ConfigurationError, defineCommand, logger } from '@opensip-cli/core';
+import { executeEquivalenceCheck } from '../equivalence-check-command.js';
+import { runCatalogJsonMode } from '../graph-modes.js';
+import { listGraphRecipes } from '../graph-recipes.js';
+import { handleGraphError } from '../graph.js';
+import { executeLookup } from '../lookup.js';
+import { runGraph } from '../orchestrate.js';
+import { runSarifExportMode } from '../sarif-export.js';
+import { executeShardWorker } from '../shard-worker.js';
+import { executeSymbolIndex } from '../symbol-index.js';
+// Shared --cwd flag string for the auxiliary subcommands that declare it as a
+// tool option (symbol-index keeps a custom description; the export commands keep
+// the canonical one). Sourced from the ADR-0021 common-flag registry so the
+// string matches the run command's --cwd and cannot drift.
+const OPT_CWD = commonFlags.cwd.flags;
+const OPT_DESC_CWD = commonFlags.cwd.description;
+// Shared output mode for the file-/stdout-writing aux commands (every aux
+// command except graph-recipes owns its full IO). Extracted to a const so the
+// literal is declared once (sonarjs/no-duplicate-string) and stays a typed
+// CommandOutputMode member.
+const RAW_STREAM = 'raw-stream';
+/** Read the single trailing positional (`<name>` / `<specPath>`) off the parsed opts. */
+function firstArg(opts) {
+    const args = (opts._args ?? []);
+    return args[0] ?? '';
+}
+/** `graph-lookup` — look up function occurrences by simple name. */
+export const graphLookupCommandSpec = defineCommand({
+    name: 'graph-lookup',
+    description: 'Look up function occurrences by simple name from the persisted catalog',
+    commonFlags: ['json'],
+    args: [{ name: 'name', description: 'Function simple name to look up (e.g. "saveBaseline")' }],
+    scope: 'project',
+    output: RAW_STREAM,
+    rawStreamReason: 'lookup',
+    handler: async (rawOpts, cli) => {
+        const opts = rawOpts;
+        await executeLookup({ name: firstArg(opts), json: opts.json }, cli);
+    },
+});
+/** `graph-shard-worker` — [internal] build one shard from a spec file. */
+export const graphShardWorkerCommandSpec = defineCommand({
+    name: 'graph-shard-worker',
+    description: '[internal] Build one shard from a spec file and emit a ShardBuildResult JSON (spawned by the sharded build)',
+    commonFlags: [],
+    args: [{ name: 'specPath', description: 'Path to a JSON ShardWorkerSpec file' }],
+    scope: 'project',
+    output: RAW_STREAM,
+    rawStreamReason: 'worker-ipc',
+    handler: async (rawOpts, cli) => {
+        await executeShardWorker(firstArg(rawOpts), cli);
+    },
+});
+/**
+ * `graph-equivalence-check` — [internal] REAL-REPO sharded≡exact equivalence
+ * guardrail. Builds both catalogs on the target with the real adapter (real
+ * `dist/*.d.ts` resolution), classifies the residual by owner file, and gates
+ * the PRODUCTION divergence against the committed budget. The dogfood/CI gate
+ * the synthetic in-test harness cannot be (it agrees by construction). Owns its
+ * full IO + exit code (raw-stream).
+ */
+export const graphEquivalenceCheckCommandSpec = defineCommand({
+    name: 'graph-equivalence-check',
+    description: '[internal] Verify the sharded build is byte-equivalent to the exact build on a real repo (gates production edge divergence against a committed budget)',
+    commonFlags: [],
+    options: [
+        {
+            flag: OPT_CWD,
+            description: 'Target repo root to check (default: current directory)',
+            default: process.cwd(),
+        },
+        {
+            flag: '--budget',
+            value: '<path>',
+            description: 'Path to the committed budget JSON (relative to cwd or absolute)',
+            default: '.config/graph-equivalence-budget.json',
+        },
+        {
+            flag: '--update-budget',
+            description: 'Rewrite the budget file to the observed production divergence count (capture/tighten); always exits 0',
+        },
+    ],
+    scope: 'project',
+    output: RAW_STREAM,
+    rawStreamReason: 'diagnostic-gate',
+    handler: async (rawOpts, cli) => {
+        const opts = rawOpts;
+        await executeEquivalenceCheck({ cwd: opts.cwd, budget: opts.budget, updateBudget: opts.updateBudget }, cli);
+    },
+});
+/** `graph-symbol-index` — emit a symbolindex.json artifact. */
+export const graphSymbolIndexCommandSpec = defineCommand({
+    name: 'graph-symbol-index',
+    description: 'Emit a symbolindex.json artifact (name→file:line and file→names) from the persisted catalog',
+    commonFlags: [],
+    options: [
+        // --cwd keeps its command-specific description (the out path resolves
+        // against it), so it is declared as a tool option rather than the common
+        // flag. The literal default is `process.cwd()`, evaluated once at module
+        // load (CLI startup) — equivalent to the former register-time evaluation.
+        {
+            flag: OPT_CWD,
+            description: 'Target directory (out path resolves against this)',
+            default: process.cwd(),
+        },
+        {
+            flag: '--out',
+            value: '<path>',
+            description: 'Output file path',
+            default: 'symbolindex.json',
+        },
+    ],
+    scope: 'project',
+    output: RAW_STREAM,
+    rawStreamReason: 'file-export',
+    handler: (rawOpts, cli) => {
+        const opts = rawOpts;
+        executeSymbolIndex({ cwd: opts.cwd, out: opts.out }, cli);
+    },
+});
+/** `graph-baseline-export` — export the graph gate baseline (JSON). */
+export const graphBaselineExportCommandSpec = defineCommand({
+    name: 'graph-baseline-export',
+    description: 'Export the graph gate baseline (JSON) from the datastore to a file',
+    commonFlags: ['cwd', 'json'],
+    options: [
+        {
+            flag: '--out',
+            value: '<path>',
+            description: 'Output file path for the JSON baseline',
+            required: true,
+        },
+    ],
+    scope: 'project',
+    output: RAW_STREAM,
+    rawStreamReason: 'file-export',
+    handler: async (rawOpts, cli) => {
+        const opts = rawOpts;
+        // ADR-0036: the host owns the byte-identical fingerprint-JSON export. The seam
+        // throws ConfigurationError (→ exit 2) when no baseline exists; map it here for
+        // both the --json (structured) and plain-text boundaries, as today.
+        try {
+            await cli.exportBaselineFingerprints('graph', opts.out);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const exitCode = error instanceof ConfigurationError
+                ? EXIT_CODES.CONFIGURATION_ERROR
+                : EXIT_CODES.RUNTIME_ERROR;
+            logger.warn({
+                evt: 'cli.graph.baseline_export.failed',
+                module: 'graph:cli',
+                message,
+                exitCode,
+            });
+            if (opts.json === true) {
+                cli.emitError({ message, exitCode });
+                return;
+            }
+            cli.setExitCode(exitCode);
+            process.stderr.write(`Error: ${message}\n`);
+            return;
+        }
+        const result = { type: 'graph-baseline-export', outPath: opts.out };
+        if (opts.json === true) {
+            cli.emitJson(result);
+            return;
+        }
+        process.stdout.write(`Exported graph baseline to ${opts.out}\n`);
+    },
+});
+/**
+ * `catalog-export` — dedicated subcommand carrying the catalog-JSON renderer +
+ * machine flags (`--catalog-output`/`--tenant-id`/`--repo-id`/`--git-sha`). This
+ * is the CLI contract the opensip `EngineSubprocessPort.runCatalogExport` spawns
+ * (DEC-498). The flags live here, NOT on `graph` — the v1 `graph
+ * --catalog-output` shape was retired by the split, so docs/consumers must
+ * target `catalog-export`.
+ */
+export const graphCatalogExportCommandSpec = defineCommand({
+    name: 'catalog-export',
+    description: 'Run graph analysis and write the CatalogExport JSON document (symbols + edges + provenance) to a file',
+    commonFlags: [],
+    options: [
+        {
+            flag: '--catalog-output',
+            value: '<path>',
+            description: 'Output file path for the CatalogExport JSON',
+            required: true,
+        },
+        {
+            flag: '--tenant-id',
+            value: '<id>',
+            description: 'Tenant scope stamped on every row + provenance',
+            required: true,
+        },
+        {
+            flag: '--repo-id',
+            value: '<id>',
+            description: 'Repository scope stamped on every row',
+            required: true,
+        },
+        {
+            flag: '--git-sha',
+            value: '<sha>',
+            description: 'Commit SHA the catalog was extracted at',
+            required: true,
+        },
+        {
+            flag: '--run-id',
+            value: '<uuid>',
+            description: 'Run id for provenance (auto-generated if absent)',
+        },
+        {
+            flag: '--mode',
+            value: '<mode>',
+            description: "'initial' (full rebuild) or 'incremental' (reuse cache when present)",
+            default: 'initial',
+        },
+        {
+            flag: '--changed-file',
+            value: '<relPath>',
+            description: 'Changed file (repeatable). Advisory today — the engine derives the true changed set from fingerprint diffs; recorded for observability.',
+            arrayDefault: [],
+            parse: (val, prev) => [...prev, val],
+        },
+        { flag: OPT_CWD, description: OPT_DESC_CWD, default: process.cwd() },
+        {
+            flag: '--language',
+            value: '<name>',
+            description: 'Force a specific language adapter (suppresses auto-detection)',
+        },
+        {
+            flag: '--resolution',
+            value: '<mode>',
+            description: 'Edge resolution tier: exact (semantic) or fast (syntactic, no type checker)',
+            default: 'exact',
+            choices: ['exact', 'fast'],
+        },
+    ],
+    scope: 'project',
+    output: RAW_STREAM,
+    rawStreamReason: 'file-export',
+    handler: async (rawOpts, cli) => {
+        const opts = rawOpts;
+        const startedAt = new Date().toISOString();
+        try {
+            // `--resolution`'s value is `exact`/`fast` by construction (declared
+            // `choices`); the mount layer rejected any other value before we got here.
+            const resolution = opts.resolution === 'fast' ? 'fast' : 'exact';
+            const incremental = opts.mode === 'incremental';
+            const changedFiles = opts.changedFile ?? [];
+            if (incremental && changedFiles.length > 0) {
+                // Advisory only: the incremental path self-derives the changed set from
+                // on-disk fingerprint diffs, so a caller-supplied set does not (yet)
+                // narrow the walk. Logged for observability.
+                logger.info({
+                    evt: 'graph.cli.catalog_export.changed_files_advisory',
+                    module: 'graph:cli',
+                    runId: opts.runId,
+                    changedFileCount: changedFiles.length,
+                });
+            }
+            const result = await runGraph({
+                cwd: opts.cwd,
+                noCache: !incremental,
+                resolution,
+                language: opts.language,
+                datastore: cli.scope.datastore(),
+            });
+            runCatalogJsonMode({
+                cwd: opts.cwd,
+                catalogOutput: opts.catalogOutput,
+                tenantId: opts.tenantId,
+                repoId: opts.repoId,
+                gitSha: opts.gitSha,
+                runId: opts.runId,
+            }, result, cli, startedAt);
+        }
+        catch (error) {
+            handleGraphError('catalog-export', error, cli);
+        }
+    },
+});
+/**
+ * `sarif-export` — runs the pipeline and writes OpenSIP-convention SARIF to a
+ * file, matching the opensip `EngineSubprocessPort.runSarifExport` contract
+ * (DEC-498). Always a full run (findings, not incremental).
+ */
+export const graphSarifExportCommandSpec = defineCommand({
+    name: 'sarif-export',
+    description: 'Run graph analysis and write OpenSIP-convention SARIF v2.1.0 findings to a file',
+    commonFlags: [],
+    options: [
+        {
+            flag: '--output-sarif',
+            value: '<path>',
+            description: 'Output file path for the SARIF v2.1.0 document',
+            required: true,
+        },
+        { flag: '--tenant-id', value: '<id>', description: 'Tenant scope for the run', required: true },
+        {
+            flag: '--repo-id',
+            value: '<id>',
+            description: 'Repository scope for the run',
+            required: true,
+        },
+        {
+            flag: '--run-id',
+            value: '<uuid>',
+            description: 'Run id for trace correlation (auto-generated if absent)',
+        },
+        { flag: OPT_CWD, description: OPT_DESC_CWD, default: process.cwd() },
+        {
+            flag: '--language',
+            value: '<name>',
+            description: 'Force a specific language adapter (suppresses auto-detection)',
+        },
+        {
+            flag: '--resolution',
+            value: '<mode>',
+            description: 'Edge resolution tier: exact (semantic) or fast (syntactic, no type checker)',
+            default: 'exact',
+            choices: ['exact', 'fast'],
+        },
+    ],
+    scope: 'project',
+    output: RAW_STREAM,
+    rawStreamReason: 'file-export',
+    handler: async (rawOpts, cli) => {
+        const opts = rawOpts;
+        try {
+            const resolution = opts.resolution === 'fast' ? 'fast' : 'exact';
+            const result = await runGraph({
+                cwd: opts.cwd,
+                noCache: true,
+                resolution,
+                language: opts.language,
+                datastore: cli.scope.datastore(),
+            });
+            await runSarifExportMode({
+                outputSarif: opts.outputSarif,
+                tenantId: opts.tenantId,
+                repoId: opts.repoId,
+                runId: opts.runId,
+            }, result.signals, cli);
+        }
+        catch (error) {
+            handleGraphError('sarif-export', error, cli);
+        }
+    },
+});
+/**
+ * `graph-recipes` — list available graph recipes (mirrors fit-recipes). Reuses
+ * the shared ListRecipesResult contract + viewListRecipes renderer.
+ * `command-result`: the host dispatches the returned result through the shared
+ * seam (`--json` → JSON, else render).
+ */
+export const graphRecipesCommandSpec = defineCommand({
+    name: 'graph-recipes',
+    description: 'List available graph recipes',
+    commonFlags: ['json'],
+    scope: 'project',
+    output: 'command-result',
+    handler: async () => listGraphRecipes(),
+});
+//# sourceMappingURL=graph-aux-command-specs.js.map

package/dist/cli/graph/graph-aux-command-specs.js.map

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

package/dist/cli/graph/graph-command-spec.d.ts

@@ -0,0 +1,43 @@
+/**
+ * graph-command-spec — the declarative primary `graph` command (launch
+ * Phase 5 Task 5.1).
+ *
+ * Replaces graph's hand-rolled `registerGraphCommand()` body: the host mounts
+ * this spec via `mountCommandSpec`, applies the ADR-0021 common flags + graph's
+ * own options, and invokes {@link runGraphCommand}. The tool no longer touches
+ * Commander.
+ *
+ * `output: 'raw-stream'` because graph's handler owns its entire output surface —
+ * it dispatches at runtime between the interactive Ink live view (TTY-only
+ * default), a discovery-only `--list-files` short-circuit, the static
+ * gate/json/render path, and the `--sarif` file write, then performs its own
+ * cloud egress (`deliverSignals` / `--report-to`) and exit-code decision. None of
+ * that is expressible through the `signal-envelope` dispatch arm (which only does
+ * `emitEnvelope`/`render`), so the host renders nothing and the handler stays
+ * authoritative — byte-identical to the former `registerGraphCommand` action
+ * body.
+ *
+ * `--resolution` validation: the legacy action validated the raw string via
+ * `parseResolutionMode` inside the body (a `ValidationError` on a typo). That
+ * validation now lives in the declared `choices: ['exact', 'fast']` — the mount
+ * layer enforces membership at parse time (Commander rejects an out-of-set value
+ * before the handler runs), so the handler trusts the parsed value.
+ */
+import type { CommandSpec, ToolCliContext } from '@opensip-cli/core';
+/**
+ * Live-view key graph contributes to the CLI's renderer registry. Owned by this
+ * package — the CLI dispatcher does NOT key off this literal; each tool decides
+ * its own live-view name. It matches the `graph` command name so the dispatcher's
+ * `renderLive(key)` lookup reads naturally next to the command that triggers it.
+ *
+ * The renderer is registered lazily inside the interactive branch of the handler
+ * via {@link setUpGraphLiveView} (the tool wires that callback in).
+ */
+export declare const GRAPH_LIVE_VIEW_KEY = "graph";
+/**
+ * The declarative primary `graph` command (launch Phase 5 Task 5.1).
+ * The host mounts this spec, applies the ADR-0021 common flags + graph's options
+ * + the `[paths...]` variadic argument, and invokes {@link runGraphCommand}.
+ */
+export declare const graphCommandSpec: CommandSpec<unknown, ToolCliContext>;
+//# sourceMappingURL=graph-command-spec.d.ts.map

package/dist/cli/graph/graph-command-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-command-spec.d.ts","sourceRoot":"","sources":["../../../src/cli/graph/graph-command-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAgBH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAGxF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAsa3C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,OAAO,EAAE,cAAc,CA4FhE,CAAC"}