feat(application): add cross-layer graph workflows

This commit is contained in:
N0zoM1z0
2026-07-16 11:29:54 +09:00
committed by N0zoM1z0
parent 87b23482e2
commit 778b995bbf
218 changed files with 6783 additions and 325 deletions
+17
View File
@@ -19,6 +19,7 @@ import type { BrowserObservationPort } from "../application/BrowserObservationPo
import { registerBrowserTools } from "./registerBrowserTools.js";
import type { ElectronObservationPort } from "../application/ElectronObservationPort.js";
import { registerElectronTools } from "./registerElectronTools.js";
import { registerApplicationTools } from "./registerApplicationTools.js";
export interface CreateServerOptions {
readonly logger?: Logger;
@@ -113,6 +114,17 @@ export const createServer = (
server.sendResourceListChanged();
return recorded;
};
const recordEvidenceWithUnknown =
session === undefined
? undefined
: (
evidence: Parameters<typeof session.recordEvidenceWithUnknown>[0],
input: Parameters<typeof session.recordEvidenceWithUnknown>[1],
) => {
const recorded = session.recordEvidenceWithUnknown(evidence, input);
if (recorded.ok) server.sendResourceListChanged();
return recorded;
};
registerOfficialTools(server, analysis, {
logger: toolLogger,
activeTarget,
@@ -158,6 +170,11 @@ export const createServer = (
permissionAuthority: options.permissionAuthority,
recordEvidence,
});
registerApplicationTools(server, {
logger: toolLogger,
recordEvidence,
recordEvidenceWithUnknown,
});
registerGuidedPrompts(server, analysis, session);
if (session !== undefined) {
registerEvidenceResources(server, session);
+131
View File
@@ -0,0 +1,131 @@
import type { McpServer } from "@modelcontextprotocol/server";
import type { BinarySessionPort } from "../application/BinarySession.js";
import {
compareApplicationVersionsEvidence,
traceApplicationFeatureEvidence,
} from "../application/JavaScriptApplicationWorkflowService.js";
import { APPLICATION_TOOL_CONTRACTS } from "../contracts/applicationToolContracts.js";
import { compareApplicationVersionsInputSchema } from "../domain/javascriptApplicationVersionComparisonSchemas.js";
import { applicationVersionComparisonResultSchema } from "../domain/javascriptApplicationVersionComparisonSchemas.js";
import { traceApplicationFeatureInputSchema } from "../domain/javascriptFeatureTraceSchemas.js";
import type { Evidence } from "../domain/evidence.js";
import type { Logger } from "../logger.js";
import { logToolExecution } from "./toolLogging.js";
import { toCallToolResult } from "./toolResult.js";
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
interface ApplicationToolRegistration {
readonly logger: Logger;
readonly recordEvidence: BinarySessionPort["recordEvidence"] | undefined;
readonly recordEvidenceWithUnknown:
| BinarySessionPort["recordEvidenceWithUnknown"]
| undefined;
}
/** Register provider-neutral JavaScript application graph workflows. */
export const registerApplicationTools = (
server: McpServer,
options: ApplicationToolRegistration,
): void => {
const [traceContract, compareContract] = APPLICATION_TOOL_CONTRACTS;
server.registerTool(
traceContract.name,
toolRegistrationOptions(traceContract),
async (input) => {
const parsed = traceApplicationFeatureInputSchema.parse(input);
const result = await logToolExecution(
options.logger,
traceContract.name,
() => Promise.resolve(traceApplicationFeatureEvidence(parsed)),
);
if (!result.ok) return toCallToolResult(result, traceContract);
const sources = [parsed.application, ...parsed.native_observations];
const recorded = recordSources(options.recordEvidence, sources);
if (!recorded.ok) return toCallToolResult(recorded, traceContract);
return recordResult(options, traceContract, result.value);
},
);
server.registerTool(
compareContract.name,
toolRegistrationOptions(compareContract),
async (input) => {
const parsed = compareApplicationVersionsInputSchema.parse(input);
const result = await logToolExecution(
options.logger,
compareContract.name,
() => Promise.resolve(compareApplicationVersionsEvidence(parsed)),
);
if (!result.ok) return toCallToolResult(result, compareContract);
const sources = [
parsed.left,
parsed.right,
...parsed.left_native_observations,
...parsed.right_native_observations,
];
const recorded = recordSources(options.recordEvidence, sources);
if (!recorded.ok) return toCallToolResult(recorded, compareContract);
const comparison = applicationVersionComparisonResultSchema.parse(
result.value.normalized_result,
);
const unknown = comparison.summary.unknown > 0;
return recordResult(
options,
compareContract,
result.value,
parsed.unknown_registry_approved === true && unknown,
);
},
);
};
const recordSources = (
recordEvidence: ApplicationToolRegistration["recordEvidence"],
sources: readonly Evidence[],
) => {
for (const source of sources) {
const recorded = recordEvidence?.(source);
if (recorded !== undefined && !recorded.ok) return recorded;
}
return { ok: true as const, value: null };
};
const recordResult = (
options: ApplicationToolRegistration,
contract: (typeof APPLICATION_TOOL_CONTRACTS)[number],
evidence: Evidence,
recordUnknown = false,
) => {
const recorded = recordUnknown
? options.recordEvidenceWithUnknown?.(evidence, {
approved: true,
question:
"Which application entities remain unmatched or ambiguous across these versions?",
severity: "medium",
domain: "application-version-comparison",
supporting_evidence_ids: [evidence.evidence_id],
contradicting_evidence_ids: [],
required_authority: "shipped-artifact",
required_confidence: "observed",
required_environment: null,
recommended_probes: [
{
operation: "analyze_javascript_application",
rationale:
"Repeat static reconstruction with complete artifacts and source maps when available.",
},
{
operation: "reconcile_javascript_runtime",
rationale:
"Add approved passive runtime Evidence without promoting it to static fact.",
},
],
relationships: [],
})
: options.recordEvidence?.(evidence);
if (recorded !== undefined && !recorded.ok)
return toCallToolResult(recorded, contract);
return toCallToolResult({ ok: true, value: evidence }, contract, {
evidenceResourcesAvailable: recorded !== undefined,
});
};