mirror of
https://github.com/morluto/rea.git
synced 2026-11-17 04:04:25 +00:00
Declare logical Evidence sources once and resolve exact retained inputs through shared application workflows across 20 composition tools. Preserve domain-owned authentication, source closure, caller choices, coverage and resource admission. Validation includes public CLI/MCP regressions, local Codex terra/high trials and fresh-import real-artifact workflows. Measurements, failed attempts and coverage limits are recorded in docs/verification/evidence-input-composition-2026-10-31.md. Fixes #8293. Fixes #8281. Assisted-by: Suika (gensokyo-skills:suika-scatter-gather-planning)
80 lines
2.5 KiB
TypeScript
80 lines
2.5 KiB
TypeScript
import type { ServerContext } from "@modelcontextprotocol/server";
|
|
import { setImmediate } from "node:timers/promises";
|
|
|
|
import { AnalysisError } from "../domain/analysisErrorBase.js";
|
|
import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";
|
|
import { err, ok } from "../domain/result.js";
|
|
import { mcpProgressReporter, type McpProgressContext } from "./mcpProgress.js";
|
|
import type { EvidenceWorkflowExecution } from "../application/investigation/EvidenceWorkflowExecution.js";
|
|
import {
|
|
withEvidenceSources,
|
|
type AnalysisResultWithSources,
|
|
} from "../application/investigation/recordEvidenceSources.js";
|
|
|
|
export interface DerivedOperationContext extends McpProgressContext {
|
|
readonly mcpReq: McpProgressContext["mcpReq"] &
|
|
Pick<ServerContext["mcpReq"], "signal">;
|
|
}
|
|
|
|
/** Run synchronous derived work with transport yields and a publication guard. */
|
|
export const runDerivedOperation = async <Value>(
|
|
context: DerivedOperationContext,
|
|
operation: string,
|
|
compute: () => Value,
|
|
retainCompleted?: (value: Value) => EvidenceWorkflowExecution,
|
|
): Promise<AnalysisResultWithSources<Value>> => {
|
|
const progress = mcpProgressReporter(context);
|
|
await progress.report({
|
|
phase: "prepare",
|
|
completed: 0,
|
|
total: 2,
|
|
message: `Preparing ${operation}`,
|
|
});
|
|
await setImmediate();
|
|
if (context.mcpReq.signal.aborted)
|
|
return err(
|
|
new AnalysisCancelledError(operation, {
|
|
cause: context.mcpReq.signal.reason,
|
|
}),
|
|
);
|
|
let value: Value;
|
|
try {
|
|
value = compute();
|
|
} catch (cause: unknown) {
|
|
// Typed causes already name the failed constraint; keep their issues.
|
|
if (cause instanceof AnalysisError) return err(cause);
|
|
throw cause;
|
|
}
|
|
const cancelledCompletion = (): AnalysisResultWithSources<Value> => {
|
|
const completed = retainCompleted?.(value);
|
|
return withEvidenceSources(
|
|
err(
|
|
new AnalysisCancelledError(operation, {
|
|
cause: context.mcpReq.signal.reason,
|
|
...(completed === undefined
|
|
? {}
|
|
: { partialObservation: completed.evidence }),
|
|
}),
|
|
),
|
|
completed?.sources ?? [],
|
|
);
|
|
};
|
|
await progress.report({
|
|
phase: "compute",
|
|
completed: 1,
|
|
total: 2,
|
|
message: `Computed ${operation}`,
|
|
});
|
|
await setImmediate();
|
|
if (context.mcpReq.signal.aborted) return cancelledCompletion();
|
|
await progress.report({
|
|
phase: "complete",
|
|
completed: 2,
|
|
total: 2,
|
|
message: `Completed ${operation}`,
|
|
terminal: true,
|
|
});
|
|
if (context.mcpReq.signal.aborted) return cancelledCompletion();
|
|
return ok(value);
|
|
};
|