ctxtop 0.0.0-stage → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (240) hide show
  1. package/.antigravity-plugin/plugin.json +36 -0
  2. package/.claude-plugin/plugin.json +18 -0
  3. package/CHECKSUMS.sha256 +149 -0
  4. package/LICENSE +27 -0
  5. package/README.md +330 -3
  6. package/SECURITY.md +22 -0
  7. package/agents/ah-flash-scout.md +25 -0
  8. package/assets/advanced_view_loaded_420px.png +0 -0
  9. package/assets/hero-demo.svg +188 -0
  10. package/assets/logo.svg +19 -0
  11. package/assets/simple_view_lean_420px.png +0 -0
  12. package/assets/simple_view_loaded_420px.png +0 -0
  13. package/assets/social-preview.svg +72 -0
  14. package/assets/zone_c_step3_shield_full.png +0 -0
  15. package/bin/ah-statusline.mjs +145 -0
  16. package/bin/cli.mjs +3 -0
  17. package/bin/ctxtop.mjs +1474 -0
  18. package/commands/cost-radar.md +11 -0
  19. package/commands/evolve.md +10 -0
  20. package/commands/handoff.md +10 -0
  21. package/commands/horizon.md +10 -0
  22. package/commands/inspect.md +10 -0
  23. package/commands/precheck.md +10 -0
  24. package/config/default_flightcheck.json +114 -0
  25. package/config/modelCatalog.json +620 -0
  26. package/config/platformQuirks.json +19 -0
  27. package/hooks/handlers/compact-lifecycle.mjs +262 -0
  28. package/hooks/handlers/hookIo.mjs +255 -0
  29. package/hooks/handlers/hookIpcClient.mjs +83 -0
  30. package/hooks/handlers/post-tool-use.mjs +265 -0
  31. package/hooks/handlers/pre-model-switch.mjs +249 -0
  32. package/hooks/handlers/pre-tool-use.mjs +365 -0
  33. package/hooks/handlers/stop-gate.mjs +240 -0
  34. package/hooks/handlers/user-prompt-submit.mjs +143 -0
  35. package/hooks/hooks.json +81 -0
  36. package/hooks/post_invocation.mjs +13 -0
  37. package/hooks/post_tool_use.mjs +17 -0
  38. package/hooks/pre_invocation.mjs +14 -0
  39. package/hooks/pre_tool_use.mjs +97 -0
  40. package/hooks/register.js +687 -0
  41. package/hooks/session_start.mjs +14 -0
  42. package/hooks/stop.mjs +13 -0
  43. package/hooks.json +56 -0
  44. package/package.json +103 -4
  45. package/packages/antigravity/package.json +14 -0
  46. package/packages/antigravity/src/index.mjs +1 -0
  47. package/packages/claude-code/package.json +14 -0
  48. package/packages/claude-code/src/index.mjs +2 -0
  49. package/packages/core/package.json +14 -0
  50. package/packages/core/src/index.mjs +1 -0
  51. package/packages/engine-node/package.json +14 -0
  52. package/packages/engine-node/src/index.mjs +1 -0
  53. package/packages/mcp/package.json +17 -0
  54. package/packages/mcp/src/server.mjs +396 -0
  55. package/packages/pro/LICENSE-COMMERCIAL.md +19 -0
  56. package/packages/pro/README-SIGNING.md +30 -0
  57. package/packages/pro/package.json +16 -0
  58. package/packages/pro/src/index.mjs +3 -0
  59. package/packages/pro/src/team_finops_pack.mjs +241 -0
  60. package/packages/pro/workers/polar_webhook_worker.mjs +215 -0
  61. package/plugin.json +36 -0
  62. package/rules/AGENTS.md +10 -0
  63. package/sidecars/horizon-daemon/ipcServer.mjs +24 -0
  64. package/sidecars/horizon-daemon/server.mjs +2002 -0
  65. package/sidecars/horizon-daemon/sidecar.json +19 -0
  66. package/skills/cost-radar/SKILL.md +21 -0
  67. package/skills/evolve/SKILL.md +21 -0
  68. package/skills/handoff/SKILL.md +42 -0
  69. package/skills/horizon/SKILL.md +17 -0
  70. package/skills/inspect/SKILL.md +18 -0
  71. package/skills/precheck/SKILL.md +44 -0
  72. package/src/adapters/antigravity/index.mjs +79 -0
  73. package/src/adapters/claude-code/index.mjs +155 -0
  74. package/src/cli/cost_radar.mjs +70 -0
  75. package/src/cli/doctor.mjs +351 -0
  76. package/src/cli/horizon_hud.mjs +686 -0
  77. package/src/cli/init.mjs +425 -0
  78. package/src/cli/postmortem.mjs +515 -0
  79. package/src/coach/cacheGravityRouter.mjs +12 -0
  80. package/src/config/modelCatalog.json +620 -0
  81. package/src/config/platformQuirks.json +19 -0
  82. package/src/core/action_queue.mjs +264 -0
  83. package/src/core/ag_bridge.mjs +346 -0
  84. package/src/core/atomic_io.mjs +124 -0
  85. package/src/core/baseline.mjs +607 -0
  86. package/src/core/blindspot_sensors.mjs +399 -0
  87. package/src/core/classifier.mjs +1757 -0
  88. package/src/core/coach/circuit_breakers.mjs +650 -0
  89. package/src/core/coach/contradiction_auditor.mjs +239 -0
  90. package/src/core/coach/effort_advisor.mjs +143 -0
  91. package/src/core/coach/handoff_hydrator.mjs +483 -0
  92. package/src/core/coach/progressive_checkpointer.mjs +551 -0
  93. package/src/core/coach/prompt_decomposer_coach.mjs +141 -0
  94. package/src/core/coach/reflector_queue.mjs +505 -0
  95. package/src/core/coach/saved_quota_ledger.mjs +615 -0
  96. package/src/core/coach/subagent_ipi_sanitizer.mjs +200 -0
  97. package/src/core/coach/subagent_phantom_auditor.mjs +261 -0
  98. package/src/core/coach/task_quota_router.mjs +955 -0
  99. package/src/core/coach/turn_zero_gate.mjs +574 -0
  100. package/src/core/compaction_coach.mjs +1126 -0
  101. package/src/core/config.mjs +214 -0
  102. package/src/core/constants.mjs +1800 -0
  103. package/src/core/detectors_det01_to_16.mjs +1474 -0
  104. package/src/core/episodic_memory.mjs +135 -0
  105. package/src/core/fts5_output_compressor.mjs +359 -0
  106. package/src/core/git_ledger.mjs +189 -0
  107. package/src/core/handoff_audit.mjs +558 -0
  108. package/src/core/history.mjs +221 -0
  109. package/src/core/hook_diagnostics.mjs +158 -0
  110. package/src/core/horizon_classifier.mjs +326 -0
  111. package/src/core/horizon_config.mjs +802 -0
  112. package/src/core/host_watchdog.mjs +200 -0
  113. package/src/core/layer5_hygiene.mjs +966 -0
  114. package/src/core/log_resolver.mjs +231 -0
  115. package/src/core/mcp_auditor.mjs +138 -0
  116. package/src/core/micro_skills_store.mjs +91 -0
  117. package/src/core/offenders.mjs +161 -0
  118. package/src/core/parser.mjs +1996 -0
  119. package/src/core/path_canonicalizer.mjs +73 -0
  120. package/src/core/paths.mjs +310 -0
  121. package/src/core/prefix_cache_shield.mjs +386 -0
  122. package/src/core/pro_license.mjs +385 -0
  123. package/src/core/prompt_rubric.mjs +518 -0
  124. package/src/core/pruner.mjs +433 -0
  125. package/src/core/quota.mjs +1860 -0
  126. package/src/core/rsi_instinct_engine.mjs +1197 -0
  127. package/src/core/sanitizer.mjs +121 -0
  128. package/src/core/session_forensics.mjs +303 -0
  129. package/src/core/session_timeline.mjs +358 -0
  130. package/src/core/settings.mjs +99 -0
  131. package/src/core/shared/detectors.mjs +1342 -0
  132. package/src/core/shared/fnv1a64.mjs +85 -0
  133. package/src/core/shared/handoff_schema.mjs +123 -0
  134. package/src/core/shared/index.mjs +5 -0
  135. package/src/core/shared/ipi_sanitizer.mjs +165 -0
  136. package/src/core/shared/micro_skills.mjs +1 -0
  137. package/src/core/shared/plugin_validator.mjs +202 -0
  138. package/src/core/shared/prompt_hygiene_governor.mjs +1 -0
  139. package/src/core/sidecar_store.mjs +302 -0
  140. package/src/core/sprint_metrics.mjs +366 -0
  141. package/src/core/sqlite_client.mjs +283 -0
  142. package/src/core/storage_doctor.mjs +358 -0
  143. package/src/core/subagents.mjs +609 -0
  144. package/src/core/swarm_topology.mjs +360 -0
  145. package/src/core/task_quota_router.mjs +1656 -0
  146. package/src/core/telemetry/cache_ttl_watchdog.mjs +284 -0
  147. package/src/core/telemetry/scope_lock_registry.mjs +578 -0
  148. package/src/core/telemetry/shadow_file_detector.mjs +291 -0
  149. package/src/core/telemetry/trajectory_watcher.mjs +259 -0
  150. package/src/core/timeline_svg.mjs +236 -0
  151. package/src/core/tool_surgeon.mjs +305 -0
  152. package/src/core/trajectory_stitcher.mjs +645 -0
  153. package/src/core/u_shaped_optimizer.mjs +789 -0
  154. package/src/core/wal_hygiene.mjs +233 -0
  155. package/src/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  156. package/src/core-isomorphic/catalog/index.mjs +1 -0
  157. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +720 -0
  158. package/src/core-isomorphic/coach/microSkills.mjs +1 -0
  159. package/src/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  160. package/src/core-isomorphic/coach/repoCalibration.mjs +254 -0
  161. package/src/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  162. package/src/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  163. package/src/core-isomorphic/coach/ttlWatchdog.mjs +457 -0
  164. package/src/core-isomorphic/config/anthropicModelCatalog.json +203 -0
  165. package/src/core-isomorphic/config/catalogLoader.mjs +768 -0
  166. package/src/core-isomorphic/config/horizonConfig.mjs +1009 -0
  167. package/src/core-isomorphic/control/callTree.mjs +338 -0
  168. package/src/core-isomorphic/control/coachLatches.mjs +126 -0
  169. package/src/core-isomorphic/control/controlStateMachine.mjs +205 -0
  170. package/src/core-isomorphic/control/index.mjs +49 -0
  171. package/src/core-isomorphic/control/swarmWorktree.mjs +109 -0
  172. package/src/core-isomorphic/control/toolSuspension.mjs +197 -0
  173. package/src/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  174. package/src/core-isomorphic/diagnostics/index.mjs +9 -0
  175. package/src/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  176. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +622 -0
  177. package/src/core-isomorphic/economics/billingBlocks.mjs +251 -0
  178. package/src/core-isomorphic/economics/cacheGravity.mjs +351 -0
  179. package/src/core-isomorphic/economics/cliffBreaker.mjs +170 -0
  180. package/src/core-isomorphic/economics/driftLatency.mjs +319 -0
  181. package/src/core-isomorphic/economics/dualTtl.mjs +198 -0
  182. package/src/core-isomorphic/economics/index.mjs +47 -0
  183. package/src/core-isomorphic/economics/retentionRadar.mjs +348 -0
  184. package/src/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  185. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +1035 -0
  186. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +480 -0
  187. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +603 -0
  188. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +301 -0
  189. package/src/core-isomorphic/index.js +26 -0
  190. package/src/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  191. package/src/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  192. package/src/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  193. package/src/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  194. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +1132 -0
  195. package/src/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  196. package/src/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  197. package/src/core-isomorphic/ui/horizonGrid.mjs +475 -0
  198. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +1181 -0
  199. package/src/core-isomorphic/ui/modViews.mjs +1478 -0
  200. package/src/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  201. package/src/core-isomorphic/ustf/index.mjs +7 -0
  202. package/src/core-isomorphic/ustf/normalizer.mjs +512 -0
  203. package/src/core-isomorphic/ustf/schema.mjs +186 -0
  204. package/src/core-isomorphic/utils/runtime.mjs +962 -0
  205. package/src/demo/synthetic_states.mjs +661 -0
  206. package/src/diagnostics/bugReportGenerator.mjs +253 -0
  207. package/src/diagnostics/doctorEngine.mjs +203 -0
  208. package/src/engine-node/db/index.mjs +58 -0
  209. package/src/engine-node/db/jsonl_fallback.mjs +184 -0
  210. package/src/engine-node/db/probe.mjs +110 -0
  211. package/src/engine-node/db/sqlite_wrapper.mjs +122 -0
  212. package/src/engine-node/index.mjs +9 -0
  213. package/src/engine-node/ipc/client.mjs +447 -0
  214. package/src/engine-node/ipc/index.mjs +22 -0
  215. package/src/engine-node/ipc/protocol.mjs +177 -0
  216. package/src/engine-node/ipc/server.mjs +445 -0
  217. package/src/engine-node/offloader/index.mjs +6 -0
  218. package/src/engine-node/offloader/tool_offloader.mjs +241 -0
  219. package/src/engine-node/sensors/blindspots.mjs +369 -0
  220. package/src/engine-node/sensors/git_merge_tree.mjs +223 -0
  221. package/src/engine-node/sensors/index.mjs +7 -0
  222. package/src/hooks/portfolio_runtime.mjs +858 -0
  223. package/src/hooks/post_invocation.mjs +419 -0
  224. package/src/hooks/pre_invocation.mjs +1015 -0
  225. package/src/hooks/session_start.mjs +161 -0
  226. package/src/shims/agy_cli_compressor.mjs +705 -0
  227. package/src/shims/agy_git_guard.mjs +749 -0
  228. package/src/shims/ah_log_query.mjs +39 -0
  229. package/src/ui/costRadarSvg.mjs +6 -0
  230. package/src/ui/horizonGrid.mjs +1 -0
  231. package/src/ui/horizonPanelHtml.mjs +1 -0
  232. package/src/ui/horizon_panel.css +167 -0
  233. package/src/ui/horizon_panel.js +212 -0
  234. package/src/ui/modViews.mjs +1 -0
  235. package/src/utils/nodeIo.mjs +59 -0
  236. package/src/utils/runtime.mjs +1 -0
  237. package/src/webview/advanced_view.html +1808 -0
  238. package/src/webview/horizon_panel.html +11389 -0
  239. package/src/webview/registry.mjs +80 -0
  240. package/src/webview/simple_view.html +1370 -0
@@ -0,0 +1,200 @@
1
+ import { execFile } from 'node:child_process';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+
5
+ /**
6
+ * Host Process & Zombie Subagent/MCP Watchdog.
7
+ *
8
+ * Polls the OS process table (memoized for 10s) to detect:
9
+ * 1. Orphaned `language_server*` processes spawned with `multicall schedule`
10
+ * or detached from exited parent IDE processes.
11
+ * 2. Orphaned `mcp-server*` stdio processes.
12
+ * 3. Total language_server + MCP RSS memory spikes (> 4.0 GB warning threshold).
13
+ */
14
+
15
+ export const HOST_WATCHDOG_LIMITS = Object.freeze({
16
+ POLL_TTL_MS: 10000,
17
+ WARNING_ORPHAN_COUNT: 3,
18
+ WARNING_RSS_GB: 4.0
19
+ });
20
+
21
+ let lastPollMs = 0;
22
+ let cachedHostHealth = null;
23
+
24
+ function execCommandSafe(file, args, timeoutMs = 2500) {
25
+ return new Promise((resolve) => {
26
+ try {
27
+ execFile(file, args, { timeout: timeoutMs, windowsHide: true, maxBuffer: 2 * 1024 * 1024 }, (err, stdout) => {
28
+ if (err) return resolve('');
29
+ resolve(String(stdout || ''));
30
+ });
31
+ } catch {
32
+ resolve('');
33
+ }
34
+ });
35
+ }
36
+
37
+ /**
38
+ * Parses a raw list of OS process records into host health & orphan diagnostics.
39
+ * Exported as a pure function so unit tests can verify orphan detection deterministically.
40
+ */
41
+ export function evaluateProcessTable(processRecords = [], activePids = new Set()) {
42
+ const allPidSet = new Set(processRecords.map(p => Number(p.pid)));
43
+ for (const pid of activePids) allPidSet.add(Number(pid));
44
+
45
+ let totalRelevantRssBytes = 0;
46
+ const orphans = [];
47
+ let languageServerCount = 0;
48
+
49
+ for (const proc of processRecords) {
50
+ const pid = Number(proc.pid || 0);
51
+ const ppid = Number(proc.ppid || 0);
52
+ const name = String(proc.name || '').toLowerCase();
53
+ const cmd = String(proc.commandLine || '').toLowerCase();
54
+ const rssBytes = Number(proc.rssBytes || 0);
55
+
56
+ const isAgyHub = (name.includes('agy') || cmd.includes('agy')) && cmd.includes('--hub');
57
+ const isLangServer = name.includes('language_server') || cmd.includes('language_server') || isAgyHub;
58
+ const isMcpServer = cmd.includes('mcp-server') || cmd.includes('@modelcontextprotocol') || name.includes('mcp');
59
+
60
+ if (!isLangServer && !isMcpServer) continue;
61
+
62
+ totalRelevantRssBytes += rssBytes;
63
+ if (isLangServer) languageServerCount++;
64
+
65
+ const isMulticallSchedule = cmd.includes('multicall') && cmd.includes('schedule');
66
+ const parentDead = ppid > 0 && allPidSet.size >= 2 && !allPidSet.has(ppid);
67
+
68
+ let scheduleDetails = '';
69
+ if (isMulticallSchedule) {
70
+ const wsMatch = cmd.match(/--workspace\s+([^\s"']+)/i);
71
+ const scriptMatch = cmd.match(/schedule\s+"[^"]*"\s+([^\s"']+)/i);
72
+ const wsName = wsMatch ? path.basename(wsMatch[1].replace(/\\/g, '/')) : '';
73
+ const scriptName = scriptMatch ? path.basename(scriptMatch[1].replace(/\\/g, '/')) : '';
74
+ scheduleDetails = wsName ? `[${wsName}] ${scriptName || 'cron'}` : (scriptName || 'scheduled task');
75
+ }
76
+
77
+ // An active language_server with an alive parent process is NOT an orphan or cron leak;
78
+ // only flag actual disconnected/leaked scheduled processes where parent is dead, or non-main multicall leaks.
79
+ const isMainIdeServer = isLangServer && !isMulticallSchedule && !parentDead;
80
+ if (isMainIdeServer) continue;
81
+
82
+ if ((isMulticallSchedule && parentDead) || (parentDead && pid !== process.pid && pid !== process.ppid)) {
83
+ orphans.push({
84
+ pid,
85
+ ppid,
86
+ name: proc.name || (isAgyHub ? 'agy' : (isLangServer ? 'language_server' : 'mcp-server')),
87
+ reason: isMulticallSchedule ? (parentDead ? 'multicall_schedule_leak' : 'active_scheduled_task') : 'detached_parent_pid',
88
+ scheduleDetails,
89
+ parentAlive: !parentDead,
90
+ rssMb: Math.round(rssBytes / (1024 * 1024))
91
+ });
92
+ }
93
+ }
94
+
95
+ const hostRssGb = parseFloat((totalRelevantRssBytes / (1024 ** 3)).toFixed(2));
96
+ const orphanCount = orphans.length;
97
+ const isAlert = orphanCount > HOST_WATCHDOG_LIMITS.WARNING_ORPHAN_COUNT || hostRssGb >= HOST_WATCHDOG_LIMITS.WARNING_RSS_GB;
98
+
99
+ return {
100
+ rssGb: hostRssGb,
101
+ languageServerCount,
102
+ orphanCount,
103
+ orphans,
104
+ status: isAlert ? (orphanCount > HOST_WATCHDOG_LIMITS.WARNING_ORPHAN_COUNT ? 'ZOMBIE_LEAK' : 'HIGH_RAM') : 'HEALTHY',
105
+ alertBanner: isAlert
106
+ ? `Host Process Alert: ${orphanCount} orphaned language_server/MCP processes (${hostRssGb} GB RAM)`
107
+ : null,
108
+ checkedAt: new Date().toISOString()
109
+ };
110
+ }
111
+
112
+ /**
113
+ * Polls the live OS process table (Windows CIM / tasklist or POSIX ps) with a 10s cache.
114
+ */
115
+ export async function inspectHostProcesses({ force = false } = {}) {
116
+ const now = Date.now();
117
+ if (!force && cachedHostHealth && (now - lastPollMs) < HOST_WATCHDOG_LIMITS.POLL_TTL_MS) {
118
+ return cachedHostHealth;
119
+ }
120
+
121
+ const records = [];
122
+ if (os.platform() === 'win32') {
123
+ const psScript = 'Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,Name,WorkingSetSize,CommandLine | ConvertTo-Json -Compress';
124
+ const out = await execCommandSafe('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', psScript], 2500);
125
+ if (out) {
126
+ try {
127
+ const parsed = JSON.parse(out);
128
+ const arr = Array.isArray(parsed) ? parsed : [parsed];
129
+ for (const item of arr) {
130
+ if (!item) continue;
131
+ records.push({
132
+ pid: Number(item.ProcessId || 0),
133
+ ppid: Number(item.ParentProcessId || 0),
134
+ name: String(item.Name || ''),
135
+ rssBytes: Number(item.WorkingSetSize || 0),
136
+ commandLine: String(item.CommandLine || '')
137
+ });
138
+ }
139
+ } catch {}
140
+ }
141
+ } else {
142
+ const out = await execCommandSafe('ps', ['-eo', 'pid,ppid,rss,comm,args'], 2000);
143
+ for (const line of out.split(/\r?\n/).slice(1)) {
144
+ const m = line.trim().match(/^(\d+)\s+(\d+)\s+(\d+)\s+(\S+)\s+(.*)$/);
145
+ if (m) {
146
+ records.push({
147
+ pid: Number(m[1]),
148
+ ppid: Number(m[2]),
149
+ rssBytes: Number(m[3]) * 1024,
150
+ name: m[4],
151
+ commandLine: m[5]
152
+ });
153
+ }
154
+ }
155
+ }
156
+
157
+ try {
158
+ cachedHostHealth = evaluateProcessTable(records);
159
+ } catch {
160
+ cachedHostHealth = {
161
+ rssGb: 0,
162
+ languageServerCount: 0,
163
+ orphanCount: 0,
164
+ orphans: [],
165
+ status: 'HEALTHY',
166
+ alertBanner: null,
167
+ checkedAt: new Date().toISOString()
168
+ };
169
+ }
170
+ lastPollMs = now;
171
+ return cachedHostHealth;
172
+ }
173
+
174
+ /**
175
+ * Safely terminates verified orphan PIDs (restricted strictly to language_server/MCP orphans).
176
+ */
177
+ export async function reapOrphanProcesses(explicitPids = null) {
178
+ const currentHealth = await inspectHostProcesses({ force: true });
179
+ const allowedOrphanMap = new Map(currentHealth.orphans.map(o => [o.pid, o]));
180
+ const targets = Array.isArray(explicitPids) && explicitPids.length > 0
181
+ ? explicitPids.map(Number).filter(pid => allowedOrphanMap.has(pid))
182
+ : Array.from(allowedOrphanMap.keys());
183
+
184
+ const reaped = [];
185
+ for (const pid of targets) {
186
+ if (pid <= 0 || pid === process.pid || pid === process.ppid) continue;
187
+ try {
188
+ process.kill(pid, 'SIGTERM');
189
+ reaped.push(pid);
190
+ } catch {}
191
+ }
192
+
193
+ const nextHealth = await inspectHostProcesses({ force: true });
194
+ return {
195
+ success: true,
196
+ reapedCount: reaped.length,
197
+ reapedPids: reaped,
198
+ hostHealth: nextHealth
199
+ };
200
+ }