import { z } from "incur"; import { resolve } from "node:path"; import { createRecordedCrashService, createBinaryLayoutService, } from "../composition/binaryDiagnostics.js"; import { CLI_COMMANDS } from "../cliCommandNames.js"; import { logCliCommand } from "../cliLogging.js"; import { projectAnalysisError } from "../domain/analysisErrorProjection.js"; import type { Logger } from "pino"; import type { CliInstance } from "./types.js"; import { withCommandCancellation } from "./commandCancellation.js"; /** Inspect operator-selected files through the same shared workflow as MCP. */ export const registerBinaryDiagnosticsCommands = ( cli: CliInstance, logger: Logger, environment: Readonly, ): void => { const service = createBinaryLayoutService(environment); cli.command(CLI_COMMANDS.inspectBinaryLayout, { description: "Inspect binary file/linked layout without executing the selected object", args: z.object({ path: z.string().describe("Local ELF binary or relocatable object"), }), run: ({ args }) => withCommandCancellation((signal) => logCliCommand(logger, CLI_COMMANDS.inspectBinaryLayout, async () => { const result = await service.inspect( { path: resolve(args.path) }, { signal }, ); return result.ok ? result.value : projectAnalysisError(result.error); }), ), }); const recorded = createRecordedCrashService(environment); cli.command(CLI_COMMANDS.inspectRecordedCrash, { description: "Inspect supplied core registers/signals and optional debugger mapping evidence", args: z.object({ path: z.string().describe("Local Linux amd64 ELF core") }), options: z.object({ debuggerContext: z .boolean() .default(false) .describe("Add BYO core-only GDB/pwndbg mapping candidates"), }), run: ({ args, options }) => withCommandCancellation((signal) => logCliCommand(logger, CLI_COMMANDS.inspectRecordedCrash, async () => { const result = await recorded.inspect( { path: resolve(args.path), include_debugger_context: options.debuggerContext, }, { signal }, ); return result.ok ? result.value : projectAnalysisError(result.error); }), ), }); };