windows-exe-decompiler-mcp-server 0.1.0 → 0.1.1

package/README.md

@@ -37,6 +37,7 @@ Primary use cases:
 - `yara.scan`
 - `runtime.detect`
 - `packer.detect`
+- `binary.role.profile`
 
 ### Ghidra and code analysis
 
@@ -90,6 +91,7 @@ tests/                       unit and integration tests
 workers/                     Python worker, YARA rules, dynamic helpers
 install-to-codex.ps1         local Codex MCP install helper
 install-to-copilot.ps1       local GitHub Copilot MCP install helper
+docs/QUALITY_EVALUATION.md   evaluation checklist for regression and release readiness
 ```
 
 ## Prerequisites
@@ -267,6 +269,9 @@ That tag push will trigger the publish workflow.
 See [`CONTRIBUTING.md`](./CONTRIBUTING.md) for local
 setup, validation, and release steps.
 
+For release-quality regression planning, see [`docs/QUALITY_EVALUATION.md`](./docs/QUALITY_EVALUATION.md)
+and [`examples/benchmark-corpus.example.json`](./examples/benchmark-corpus.example.json).
+
 ## Security
 
 See [`SECURITY.md`](./SECURITY.md) for disclosure guidance

package/dist/analysis-task-runner.js

@@ -5,6 +5,9 @@
 import { DecompilerWorker, GhidraProcessError } from './decompiler-worker.js';
 import { logger } from './logger.js';
 import { deepStaticWorkflow } from './workflows/deep-static.js';
+import { createReconstructWorkflowHandler } from './workflows/reconstruct.js';
+import { createSemanticNameReviewWorkflowHandler } from './workflows/semantic-name-review.js';
+import { createFunctionExplanationReviewWorkflowHandler } from './workflows/function-explanation-review.js';
 export class AnalysisTaskRunner {
     jobQueue;
     decompilerWorker;
@@ -154,6 +157,69 @@ export class AnalysisTaskRunner {
                 },
             };
         }
+        if (job.tool === 'workflow.reconstruct') {
+            if (!this.cacheManager) {
+                throw new Error('workflow.reconstruct requires cache manager for queued execution');
+            }
+            this.jobQueue.updateProgress(job.id, 5);
+            const handler = createReconstructWorkflowHandler(this.workspaceManager, this.database, this.cacheManager);
+            const result = await handler(job.args || {});
+            this.jobQueue.updateProgress(job.id, 100);
+            return {
+                jobId: job.id,
+                ok: result.ok,
+                data: result.data,
+                errors: result.errors || [],
+                warnings: result.warnings || [],
+                artifacts: result.artifacts || [],
+                metrics: {
+                    elapsedMs: typeof result.metrics?.elapsed_ms === 'number' ? result.metrics.elapsed_ms : 0,
+                    peakRssMb: 0,
+                },
+            };
+        }
+        if (job.tool === 'workflow.semantic_name_review') {
+            if (!this.cacheManager) {
+                throw new Error('workflow.semantic_name_review requires cache manager for queued execution');
+            }
+            this.jobQueue.updateProgress(job.id, 5);
+            const handler = createSemanticNameReviewWorkflowHandler(this.workspaceManager, this.database, this.cacheManager);
+            const result = await handler(job.args || {});
+            this.jobQueue.updateProgress(job.id, 100);
+            return {
+                jobId: job.id,
+                ok: result.ok,
+                data: result.data,
+                errors: result.errors || [],
+                warnings: result.warnings || [],
+                artifacts: result.artifacts || [],
+                metrics: {
+                    elapsedMs: typeof result.metrics?.elapsed_ms === 'number' ? result.metrics.elapsed_ms : 0,
+                    peakRssMb: 0,
+                },
+            };
+        }
+        if (job.tool === 'workflow.function_explanation_review') {
+            if (!this.cacheManager) {
+                throw new Error('workflow.function_explanation_review requires cache manager for queued execution');
+            }
+            this.jobQueue.updateProgress(job.id, 5);
+            const handler = createFunctionExplanationReviewWorkflowHandler(this.workspaceManager, this.database, this.cacheManager);
+            const result = await handler(job.args || {});
+            this.jobQueue.updateProgress(job.id, 100);
+            return {
+                jobId: job.id,
+                ok: result.ok,
+                data: result.data,
+                errors: result.errors || [],
+                warnings: result.warnings || [],
+                artifacts: result.artifacts || [],
+                metrics: {
+                    elapsedMs: typeof result.metrics?.elapsed_ms === 'number' ? result.metrics.elapsed_ms : 0,
+                    peakRssMb: 0,
+                },
+            };
+        }
         throw new Error(`Unsupported queued tool: ${job.tool}`);
     }
 }

package/dist/index.js

@@ -25,6 +25,7 @@ import { runtimeDetectToolDefinition, createRuntimeDetectHandler } from './tools
 import { dotNetMetadataExtractToolDefinition, createDotNetMetadataExtractHandler } from './tools/dotnet-metadata-extract.js';
 import { dotNetTypesListToolDefinition, createDotNetTypesListHandler } from './tools/dotnet-types-list.js';
 import { packerDetectToolDefinition, createPackerDetectHandler } from './tools/packer-detect.js';
+import { binaryRoleProfileToolDefinition, createBinaryRoleProfileHandler, } from './tools/binary-role-profile.js';
 import { triageWorkflowToolDefinition, createTriageWorkflowHandler } from './workflows/triage.js';
 import { reconstructWorkflowToolDefinition, createReconstructWorkflowHandler } from './workflows/reconstruct.js';
 import { deepStaticWorkflowToolDefinition, createDeepStaticWorkflowHandler } from './workflows/deep-static.js';
@@ -113,18 +114,19 @@ async function main() {
         server.registerTool(dotNetTypesListToolDefinition, createDotNetTypesListHandler(workspaceManager, database, cacheManager));
         // Task 8.10: packer.detect tool
         server.registerTool(packerDetectToolDefinition, createPackerDetectHandler(workspaceManager, database, cacheManager));
+        server.registerTool(binaryRoleProfileToolDefinition, createBinaryRoleProfileHandler(workspaceManager, database, cacheManager));
         // Task 9.1: workflow.triage - Quick triage workflow
         server.registerTool(triageWorkflowToolDefinition, createTriageWorkflowHandler(workspaceManager, database, cacheManager));
         // Task 40.5.1: workflow.reconstruct - End-to-end source reconstruction workflow
-        server.registerTool(reconstructWorkflowToolDefinition, createReconstructWorkflowHandler(workspaceManager, database, cacheManager));
+        server.registerTool(reconstructWorkflowToolDefinition, createReconstructWorkflowHandler(workspaceManager, database, cacheManager, undefined, jobQueue));
         // Task 16.x: workflow.deep_static - Comprehensive long-running static analysis
         server.registerTool(deepStaticWorkflowToolDefinition, createDeepStaticWorkflowHandler(workspaceManager, database, cacheManager, jobQueue));
-        server.registerTool(semanticNameReviewWorkflowToolDefinition, createSemanticNameReviewWorkflowHandler(workspaceManager, database, cacheManager, server));
-        server.registerTool(functionExplanationReviewWorkflowToolDefinition, createFunctionExplanationReviewWorkflowHandler(workspaceManager, database, cacheManager, server));
+        server.registerTool(semanticNameReviewWorkflowToolDefinition, createSemanticNameReviewWorkflowHandler(workspaceManager, database, cacheManager, server, undefined, jobQueue));
+        server.registerTool(functionExplanationReviewWorkflowToolDefinition, createFunctionExplanationReviewWorkflowHandler(workspaceManager, database, cacheManager, server, undefined, jobQueue));
         // Task 9.2: report.summarize - Generate quick triage report
         server.registerTool(reportSummarizeToolDefinition, createReportSummarizeHandler(workspaceManager, database, cacheManager));
         // Task 24.x: report.generate - Generate stored multi-stage analysis report artifact
-        server.registerTool(reportGenerateToolDefinition, createReportGenerateHandler(workspaceManager, database));
+        server.registerTool(reportGenerateToolDefinition, createReportGenerateHandler(workspaceManager, database, cacheManager));
         // Task 15.1: ghidra.analyze - Analyze binary with Ghidra
         server.registerTool(ghidraAnalyzeToolDefinition, createGhidraAnalyzeHandler(workspaceManager, database, jobQueue));
         // Task execution controls: query/cancel/sweep analysis jobs

package/dist/server.js

@@ -30,7 +30,7 @@ export class MCPServer {
         // Initialize MCP SDK server
         this.server = new Server({
             name: 'windows-exe-decompiler-mcp-server',
-            version: '0.1.0',
+            version: '0.1.1',
         }, {
             capabilities: {
                 tools: {},

package/dist/tools/artifact-read.d.ts

@@ -24,11 +24,11 @@ export declare const ArtifactReadInputSchema: z.ZodObject<{
     sample_id: string;
     recursive: boolean;
     encoding: "utf8" | "base64" | "auto";
+    max_bytes: number;
     include_untracked_files: boolean;
     scan_roots: string[];
     select_latest: boolean;
     include_content: boolean;
-    max_bytes: number;
     parse_json: boolean;
     ioc_highlights: boolean;
     path?: string | undefined;
@@ -39,13 +39,13 @@ export declare const ArtifactReadInputSchema: z.ZodObject<{
     path?: string | undefined;
     recursive?: boolean | undefined;
     encoding?: "utf8" | "base64" | "auto" | undefined;
+    max_bytes?: number | undefined;
     artifact_id?: string | undefined;
     artifact_type?: string | undefined;
     include_untracked_files?: boolean | undefined;
     scan_roots?: string[] | undefined;
     select_latest?: boolean | undefined;
     include_content?: boolean | undefined;
-    max_bytes?: number | undefined;
     parse_json?: boolean | undefined;
     ioc_highlights?: boolean | undefined;
 }>;

package/dist/tools/artifacts-list.d.ts

@@ -169,16 +169,16 @@ export declare const ArtifactsListOutputSchema: z.ZodObject<{
             }, "strip", z.ZodTypeAny, {
                 count: number;
                 latest_created_at: string;
+                types: string[];
                 untracked_count: number;
                 tracked_count: number;
-                types: string[];
                 retention_buckets: string[];
             }, {
                 count: number;
                 latest_created_at: string;
+                types: string[];
                 untracked_count: number;
                 tracked_count: number;
-                types: string[];
                 retention_buckets: string[];
             }>>;
             by_retention_bucket: z.ZodRecord<z.ZodString, z.ZodNumber>;
@@ -205,9 +205,9 @@ export declare const ArtifactsListOutputSchema: z.ZodObject<{
             session_index: Record<string, {
                 count: number;
                 latest_created_at: string;
+                types: string[];
                 untracked_count: number;
                 tracked_count: number;
-                types: string[];
                 retention_buckets: string[];
             }>;
             by_retention_bucket: Record<string, number>;
@@ -234,9 +234,9 @@ export declare const ArtifactsListOutputSchema: z.ZodObject<{
             session_index: Record<string, {
                 count: number;
                 latest_created_at: string;
+                types: string[];
                 untracked_count: number;
                 tracked_count: number;
-                types: string[];
                 retention_buckets: string[];
             }>;
             by_retention_bucket: Record<string, number>;
@@ -266,9 +266,9 @@ export declare const ArtifactsListOutputSchema: z.ZodObject<{
             session_index: Record<string, {
                 count: number;
                 latest_created_at: string;
+                types: string[];
                 untracked_count: number;
                 tracked_count: number;
-                types: string[];
                 retention_buckets: string[];
             }>;
             by_retention_bucket: Record<string, number>;
@@ -325,9 +325,9 @@ export declare const ArtifactsListOutputSchema: z.ZodObject<{
             session_index: Record<string, {
                 count: number;
                 latest_created_at: string;
+                types: string[];
                 untracked_count: number;
                 tracked_count: number;
-                types: string[];
                 retention_buckets: string[];
             }>;
             by_retention_bucket: Record<string, number>;
@@ -403,9 +403,9 @@ export declare const ArtifactsListOutputSchema: z.ZodObject<{
             session_index: Record<string, {
                 count: number;
                 latest_created_at: string;
+                types: string[];
                 untracked_count: number;
                 tracked_count: number;
-                types: string[];
                 retention_buckets: string[];
             }>;
             by_retention_bucket: Record<string, number>;
@@ -471,9 +471,9 @@ export declare const ArtifactsListOutputSchema: z.ZodObject<{
             session_index: Record<string, {
                 count: number;
                 latest_created_at: string;
+                types: string[];
                 untracked_count: number;
                 tracked_count: number;
-                types: string[];
                 retention_buckets: string[];
             }>;
             by_retention_bucket: Record<string, number>;