fix: stabilize dynamic dependency probe and CI bootstrap

Author: Last-emo-boy

.github/workflows/ci.yml

@@ -37,6 +37,9 @@ jobs:
       - name: Install JavaScript dependencies
         run: npm ci
 
+      - name: Install baseline Python dependencies
+        run: python -m pip install -r requirements.txt
+
       - name: Build TypeScript
         run: npm run build
 

.github/workflows/publish-npm.yml

@@ -37,6 +37,9 @@ jobs:
       - name: Install JavaScript dependencies
         run: npm ci
 
+      - name: Install baseline Python dependencies
+        run: python -m pip install -r requirements.txt
+
       - name: Build TypeScript
         run: npm run build
 

package.json

@@ -59,6 +59,14 @@
   ],
   "author": "",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Last-emo-boy/windows-exe-decompiler-mcp-server.git"
+  },
+  "homepage": "https://github.com/Last-emo-boy/windows-exe-decompiler-mcp-server",
+  "bugs": {
+    "url": "https://github.com/Last-emo-boy/windows-exe-decompiler-mcp-server/issues"
+  },
   "publishConfig": {
     "access": "public"
   },

src/tools/dynamic-dependencies.ts

@@ -80,6 +80,56 @@ interface WorkerResponse {
   metrics: Record<string, unknown>
 }
 
+interface DynamicDependenciesDependencies {
+  callWorker?: (request: WorkerRequest) => Promise<WorkerResponse>
+}
+
+function buildBootstrapFallback(startTime: number, errorMessage: string): WorkerResult {
+  return {
+    ok: true,
+    data: {
+      status: 'bootstrap_required',
+      available_components: [],
+      components: {
+        speakeasy: {
+          available: false,
+          version: null,
+          distribution: null,
+          api_available: false,
+          warnings: [],
+          error: errorMessage,
+        },
+        frida: {
+          available: false,
+          version: null,
+          error: errorMessage,
+        },
+        psutil: {
+          available: false,
+          version: null,
+          error: errorMessage,
+        },
+        worker: {
+          available: false,
+          error: errorMessage,
+        },
+      },
+      recommendations: [
+        'Install baseline Python dependencies first: pip install -r requirements.txt',
+        'Install FLARE Speakeasy emulator for PE user-mode emulation: pip install speakeasy-emulator',
+        'Install frida for runtime API tracing: pip install frida',
+        'Install psutil for process telemetry collection: pip install psutil',
+      ],
+      checked_at: new Date().toISOString(),
+    },
+    warnings: [`dynamic.dependencies probe degraded: ${errorMessage}`],
+    metrics: {
+      elapsed_ms: Date.now() - startTime,
+      tool: TOOL_NAME,
+    },
+  }
+}
+
 async function callStaticWorker(request: WorkerRequest): Promise<WorkerResponse> {
   return new Promise((resolve, reject) => {
     const workerPath = resolvePackagePath('workers', 'static_worker.py')
@@ -134,10 +184,12 @@ async function callStaticWorker(request: WorkerRequest): Promise<WorkerResponse>
 
 export function createDynamicDependenciesHandler(
   workspaceManager: WorkspaceManager,
-  database: DatabaseManager
+  database: DatabaseManager,
+  dependencies?: DynamicDependenciesDependencies
 ) {
   return async (args: ToolArgs): Promise<WorkerResult> => {
     const startTime = Date.now()
+    const runWorker = dependencies?.callWorker || callStaticWorker
 
     try {
       const input = DynamicDependenciesInputSchema.parse(args)
@@ -185,17 +237,18 @@ export function createDynamicDependenciesHandler(
         },
       }
 
-      const workerResponse = await callStaticWorker(workerRequest)
+      let workerResponse: WorkerResponse
+      try {
+        workerResponse = await runWorker(workerRequest)
+      } catch (error) {
+        return buildBootstrapFallback(startTime, (error as Error).message)
+      }
+
       if (!workerResponse.ok) {
-        return {
-          ok: false,
-          errors: workerResponse.errors,
-          warnings: workerResponse.warnings,
-          metrics: {
-            elapsed_ms: Date.now() - startTime,
-            tool: TOOL_NAME,
-          },
-        }
+        return buildBootstrapFallback(
+          startTime,
+          workerResponse.errors.join('; ') || 'dynamic dependency probe failed'
+        )
       }
 
       return {

tests/unit/dynamic-dependencies.test.ts

@@ -60,4 +60,31 @@ describe('dynamic.dependencies tool', () => {
       expect(data.recommendations.join(' ')).toContain('pip uninstall speakeasy')
     }
   })
+
+  test('should degrade to bootstrap_required when the worker probe fails', async () => {
+    const handler = createDynamicDependenciesHandler(workspaceManager, database, {
+      callWorker: async () => {
+        throw new Error('Python worker exited with code 1')
+      },
+    })
+
+    const result = await handler({})
+
+    expect(result.ok).toBe(true)
+    const data = result.data as {
+      status: string
+      components: {
+        worker?: {
+          available?: boolean
+          error?: string
+        }
+      }
+      recommendations: string[]
+    }
+
+    expect(data.status).toBe('bootstrap_required')
+    expect(data.components.worker?.available).toBe(false)
+    expect(data.components.worker?.error).toContain('Python worker exited with code 1')
+    expect(data.recommendations.join(' ')).toContain('pip install -r requirements.txt')
+  })
 })