mirror of
https://github.com/morluto/rea.git
synced 2026-11-20 13:45:30 +00:00
* refactor(cli): register every command in an REA-owned command table * fix(cli): flag grouped fields and named selectors in each command's input binding
127 lines
5.1 KiB
TypeScript
127 lines
5.1 KiB
TypeScript
import { z } from "zod";
|
|
|
|
import { inspectAnalysisView } from "../application/analysisView/AnalysisViewService.js";
|
|
import { ArtifactResourceScope } from "../resources/index.js";
|
|
import { ANALYSIS_VIEW_PROVIDER } from "../domain/investigationProviders.js";
|
|
import { inspectEvidenceBundleCommand } from "../application/EvidenceBundleCommands.js";
|
|
import { ANALYSIS_VIEW_TOOL_CONTRACTS } from "../contracts/analysisViewToolContracts.js";
|
|
import {
|
|
getEvidenceBundleInputSchema,
|
|
importEvidenceBundleInputSchema,
|
|
} from "../contracts/sessionToolSchemas.js";
|
|
import { CLI_COMMANDS } from "../contracts/cliCommandNames.js";
|
|
import { parseCliJsonInput } from "./cliJsonInput.js";
|
|
import { logCliCommand } from "../cliLogging.js";
|
|
import { projectAnalysisError } from "../domain/analysisErrorProjection.js";
|
|
import { analysisInputErrorFromIssues } from "../domain/inputIssueProjection.js";
|
|
import type { Logger } from "pino";
|
|
import { registerCliCommand } from "./commandRegistry.js";
|
|
import type { CliInstance } from "./types.js";
|
|
import { localPathStringSchema } from "../domain/localPath.js";
|
|
import { withCommandCancellation } from "./commandCancellation.js";
|
|
import { contractNamed } from "./contractCliDescription.js";
|
|
import { registerContractDocumentCommand } from "./contractCommand.js";
|
|
import { finishAnalysisCommand } from "./finishAnalysisCommand.js";
|
|
import { jsonInputArgument } from "./jsonInputArgument.js";
|
|
|
|
const inspectEvidenceBundleCliInputSchema =
|
|
getEvidenceBundleInputSchema.safeExtend({
|
|
path: importEvidenceBundleInputSchema.shape.path,
|
|
});
|
|
|
|
/** Project selected views of completed analysis Evidence through the CLI. */
|
|
export const registerAnalysisViewCommands = (
|
|
cli: CliInstance,
|
|
logger: Logger,
|
|
): void => {
|
|
registerCliCommand(cli, CLI_COMMANDS.inspectEvidenceBundle, {
|
|
description:
|
|
"Inspect a local Evidence bundle completely, as discovery metadata, as a page of selected complete records, or as direct-link and retained-closure membership.",
|
|
args: z.object({
|
|
inputJson: jsonInputArgument(
|
|
"JSON or JSON file with absolute path, detail, optional record filters, records or links offset/limit, and links traversal/link_status",
|
|
inspectEvidenceBundleCliInputSchema,
|
|
),
|
|
}),
|
|
run: ({ args }) =>
|
|
withCommandCancellation((signal) =>
|
|
logCliCommand(logger, CLI_COMMANDS.inspectEvidenceBundle, async () => {
|
|
const input = await parseCliJsonInput(
|
|
args.inputJson,
|
|
CLI_COMMANDS.inspectEvidenceBundle,
|
|
signal,
|
|
);
|
|
if (!input.ok) return input.error;
|
|
const parsed = inspectEvidenceBundleCliInputSchema.safeParse(
|
|
input.value,
|
|
);
|
|
if (!parsed.success)
|
|
return {
|
|
error: "Evidence bundle inspection failed",
|
|
...projectAnalysisError(
|
|
analysisInputErrorFromIssues(
|
|
CLI_COMMANDS.inspectEvidenceBundle,
|
|
parsed.error.issues,
|
|
input.value,
|
|
),
|
|
),
|
|
};
|
|
const result = await inspectEvidenceBundleCommand(
|
|
parsed.data,
|
|
signal,
|
|
);
|
|
return result.ok
|
|
? result.value
|
|
: {
|
|
error: "Evidence bundle inspection failed",
|
|
...projectAnalysisError(result.error),
|
|
};
|
|
}),
|
|
),
|
|
});
|
|
registerContractDocumentCommand(
|
|
cli,
|
|
logger,
|
|
contractNamed(ANALYSIS_VIEW_TOOL_CONTRACTS, "inspect_analysis_view"),
|
|
{
|
|
description:
|
|
"Project a selected view of completed Evidence JSON for a supported analysis operation. For inventory rows, use --format csv or --format tsv with --filter-output normalized_result.items and --columns logical_path,artifact_id (if those fields are included in the view).",
|
|
document: "Inline workflow JSON or JSON file path",
|
|
// An evidence-file path is resolved against the operator's working directory.
|
|
callerPaths: [["source", "path"]],
|
|
cliOptions: {
|
|
evidenceBundle: localPathStringSchema
|
|
.optional()
|
|
.describe(
|
|
"Read the exact retained-evidence source ID from this local Evidence bundle without reopening the target; omit for inline Evidence",
|
|
),
|
|
},
|
|
},
|
|
async (document, { signal, operation, cliOptions }) => {
|
|
const resources = new ArtifactResourceScope();
|
|
const bundlePath = cliOptions.evidenceBundle;
|
|
const result = await finishAnalysisCommand(
|
|
() =>
|
|
inspectAnalysisView(document, undefined, {
|
|
signal,
|
|
resources,
|
|
...(bundlePath === undefined
|
|
? {}
|
|
: { evidenceBundlePath: bundlePath }),
|
|
}),
|
|
resources,
|
|
ANALYSIS_VIEW_PROVIDER.id,
|
|
operation,
|
|
signal,
|
|
);
|
|
// Preserve the inline command's existing error label without copying
|
|
// the authenticated completed Evidence or its partial observation.
|
|
return result.ok
|
|
? result.value
|
|
: bundlePath === undefined
|
|
? { error: "Application workflow failed", ...result.error }
|
|
: result.error;
|
|
},
|
|
);
|
|
};
|