@reconcrap/boss-recommend-mcp 2.0.3 → 2.0.5

package/src/domains/chat/run-service.js

@@ -22,6 +22,7 @@ import {
   getNextInfiniteListCandidate,
   markInfiniteListCandidateProcessed
 } from "../../core/infinite-list/index.js";
+import { createViewportRunGuard } from "../../core/self-heal/index.js";
 import { createRunLifecycleManager } from "../../core/run/index.js";
 import {
   callScreeningLlm,
@@ -250,9 +251,13 @@ async function setupChatRunContext(client, {
   normalizedStartFrom,
   readyTimeoutMs,
   listSettleMs,
-  runControl
+  runControl,
+  ensureViewport = null
 } = {}) {
-  const rootState = await getChatRoots(client);
+  let rootState = await getChatRoots(client);
+  if (ensureViewport) {
+    rootState = await ensureViewport(rootState, "context_roots");
+  }
   runControl.checkpoint({
     top_document_node_id: rootState.rootNodes.top
   });
@@ -280,6 +285,10 @@ async function setupChatRunContext(client, {
   if (normalizeText(job) && !jobSelection.selected) {
     throw new Error(`Chat job selection failed: ${jobSelection.reason || "unknown"}`);
   }
+  rootState = await getChatRoots(client);
+  if (ensureViewport) {
+    rootState = await ensureViewport(rootState, "context_job");
+  }
   runControl.checkpoint({
     chat_context_step: "job_selection",
     primary_label: primaryLabel,
@@ -294,6 +303,10 @@ async function setupChatRunContext(client, {
   if (!startFilter.ok) {
     throw new Error(`Chat start filter selection failed: ${startFilter.error || "unknown"}`);
   }
+  rootState = await getChatRoots(client);
+  if (ensureViewport) {
+    rootState = await ensureViewport(rootState, "context_start_filter");
+  }
   runControl.checkpoint({
     chat_context_step: "start_filter",
     primary_label: primaryLabel,
@@ -362,6 +375,18 @@ export async function runChatWorkflow({
     domain: "chat",
     listName: "chat-candidates"
   });
+  const viewportGuard = createViewportRunGuard({
+    client,
+    domain: "chat",
+    root: "top",
+    frameOwnerRoot: "top",
+    runControl,
+    getRoots: getChatRoots
+  });
+  async function ensureChatViewport(rootState, phase) {
+    const result = await viewportGuard.ensure(rootState, { phase });
+    return result.rootState || rootState;
+  }
   const results = [];
   let cardNodeIds = [];
   let listEndReason = "";
@@ -398,7 +423,8 @@ export async function runChatWorkflow({
     normalizedStartFrom,
     readyTimeoutMs,
     listSettleMs,
-    runControl
+    runControl,
+    ensureViewport: ensureChatViewport
   });
   let rootState = setup.rootState;
   contextSetup = {
@@ -431,7 +457,8 @@ export async function runChatWorkflow({
       normalizedStartFrom,
       readyTimeoutMs,
       listSettleMs,
-      runControl
+      runControl,
+      ensureViewport: ensureChatViewport
     });
     rootState = recoveredSetup.rootState;
     contextSetup = {
@@ -449,7 +476,7 @@ export async function runChatWorkflow({
   await runControl.waitIfPaused();
   runControl.throwIfCanceled();
   runControl.setPhase("chat:cards");
-  const cardRootState = await getChatRoots(client);
+  const cardRootState = await ensureChatViewport(await getChatRoots(client), "cards");
   const initialCards = await waitForChatCandidateNodeIds(client, cardRootState.rootNodes.top, {
     timeoutMs: cardTimeoutMs,
     intervalMs: 500
@@ -479,7 +506,9 @@ export async function runChatWorkflow({
       request_skipped: 0,
       unique_seen: compactInfiniteListState(listState).seen_count,
       scroll_count: compactInfiniteListState(listState).scroll_count,
-      list_end_reason: listEndReason
+      list_end_reason: listEndReason,
+      viewport_checks: viewportGuard.getStats().checks,
+      viewport_recoveries: viewportGuard.getStats().recoveries
     });
     runControl.setPhase("chat:done");
     return {
@@ -493,6 +522,10 @@ export async function runChatWorkflow({
         requested_start_from: normalizedStartFrom
       },
       candidate_list: compactInfiniteListState(listState),
+      viewport_health: {
+        stats: viewportGuard.getStats(),
+        events: viewportGuard.getEvents()
+      },
       list_end_reason: listEndReason,
       target_pass_count: passTarget,
       process_until_list_end: Boolean(processUntilListEnd),
@@ -524,7 +557,9 @@ export async function runChatWorkflow({
     request_satisfied: 0,
     request_skipped: 0,
     unique_seen: compactInfiniteListState(listState).seen_count,
-    scroll_count: 0
+    scroll_count: 0,
+    viewport_checks: viewportGuard.getStats().checks,
+    viewport_recoveries: viewportGuard.getStats().recoveries
   });
 
   while (
@@ -537,6 +572,7 @@ export async function runChatWorkflow({
     await runControl.waitIfPaused();
     runControl.throwIfCanceled();
     runControl.setPhase("chat:candidate");
+    rootState = await ensureChatViewport(rootState, "candidate_loop");
     const loopTopLevelState = await getChatTopLevelState(client);
     if (!loopTopLevelState.is_chat_shell) {
       await recoverAndReapplyChatContext("candidate_loop_non_chat_shell", {
@@ -554,7 +590,8 @@ export async function runChatWorkflow({
       settleMs: listSettleMs,
       fallbackPoint: listFallbackPoint,
       findNodeIds: async () => {
-        const currentRootState = await getChatRoots(client);
+        const currentRootState = await ensureChatViewport(await getChatRoots(client), "candidate_find_nodes");
+        rootState = currentRootState;
         const currentCards = await waitForChatCandidateNodeIds(client, currentRootState.rootNodes.top, {
           timeoutMs: Math.min(cardTimeoutMs, 8000),
           intervalMs: 500
@@ -609,6 +646,7 @@ export async function runChatWorkflow({
         await runControl.waitIfPaused();
         runControl.throwIfCanceled();
         runControl.setPhase("chat:detail");
+        rootState = await ensureChatViewport(rootState, "detail");
 
         detailStep = "select_candidate";
         networkRecorder.clear();
@@ -921,6 +959,8 @@ export async function runChatWorkflow({
       unique_seen: compactInfiniteListState(listState).seen_count,
       scroll_count: compactInfiniteListState(listState).scroll_count,
       list_end_reason: listEndReason || null,
+      viewport_checks: viewportGuard.getStats().checks,
+      viewport_recoveries: viewportGuard.getStats().recoveries,
       last_candidate_id: screeningCandidate.id || null,
       last_candidate_key: candidateKey,
       last_score: screening.score
@@ -950,6 +990,10 @@ export async function runChatWorkflow({
     card_count: cardNodeIds.length,
     context_setup: contextSetup,
     candidate_list: compactInfiniteListState(listState),
+    viewport_health: {
+      stats: viewportGuard.getStats(),
+      events: viewportGuard.getEvents()
+    },
     list_end_reason: listEndReason || null,
     target_pass_count: passTarget,
     process_until_list_end: Boolean(processUntilListEnd),

package/src/domains/recommend/roots.js

@@ -25,7 +25,8 @@ export async function getRecommendRoots(client, {
     ].filter(Boolean),
     rootNodes: {
       top: topRoot.nodeId,
-      frame: iframe?.documentNodeId || 0
+      frame: iframe?.documentNodeId || 0,
+      frameOwner: iframe?.nodeId || 0
     }
   };
 }
@@ -49,7 +50,8 @@ export async function waitForRecommendRoots(client, {
         roots: [],
         rootNodes: {
           top: 0,
-          frame: 0
+          frame: 0,
+          frameOwner: 0
         }
       };
     }

package/src/domains/recommend/run-service.js

@@ -20,6 +20,7 @@ import {
   markInfiniteListCandidateProcessed,
   resetInfiniteListForRefreshRound
 } from "../../core/infinite-list/index.js";
+import { createViewportRunGuard } from "../../core/self-heal/index.js";
 import { screenCandidate } from "../../core/screening/index.js";
 import {
   closeRecommendDetail,
@@ -372,6 +373,18 @@ export async function runRecommendWorkflow({
     domain: "recommend",
     listName: "recommend-candidates"
   });
+  const viewportGuard = createViewportRunGuard({
+    client,
+    domain: "recommend",
+    root: "frame",
+    frameOwnerRoot: "frameOwner",
+    runControl,
+    getRoots: getRecommendRoots
+  });
+  async function ensureRecommendViewport(rootState, phase) {
+    const result = await viewportGuard.ensure(rootState, { phase });
+    return result.rootState || rootState;
+  }
   const results = [];
   const refreshAttempts = [];
   let refreshRounds = 0;
@@ -389,6 +402,7 @@ export async function runRecommendWorkflow({
   runControl.throwIfCanceled();
   runControl.setPhase("recommend:roots");
   let rootState = await getRecommendRoots(client);
+  rootState = await ensureRecommendViewport(rootState, "roots");
   runControl.checkpoint({
     iframe_selector: rootState.iframe.selector,
     iframe_document_node_id: rootState.iframe.documentNodeId
@@ -406,6 +420,7 @@ export async function runRecommendWorkflow({
       throw new Error(`Requested recommend job was not selected: ${jobSelection.reason}`);
     }
     rootState = await getRecommendRoots(client);
+    rootState = await ensureRecommendViewport(rootState, "job");
     runControl.checkpoint({
       job_selection: compactJobSelection(jobSelection)
     });
@@ -424,6 +439,7 @@ export async function runRecommendWorkflow({
     throw new Error(`Recommend page scope was not selected: ${pageScopeSelection.reason || pageScopeSelection.effective_scope || requestedPageScope}`);
   }
   rootState = await getRecommendRoots(client);
+  rootState = await ensureRecommendViewport(rootState, "page_scope");
   runControl.checkpoint({
     page_scope: compactPageScopeSelection(pageScopeSelection)
   });
@@ -440,6 +456,8 @@ export async function runRecommendWorkflow({
     if (!filterResult.confirmed) {
       throw new Error("Recommend run filter selection was not confirmed");
     }
+    rootState = await getRecommendRoots(client);
+    rootState = await ensureRecommendViewport(rootState, "filter");
     runControl.checkpoint({
       filter: compactFilterResult(filterResult)
     });
@@ -448,6 +466,7 @@ export async function runRecommendWorkflow({
   await runControl.waitIfPaused();
   runControl.throwIfCanceled();
   runControl.setPhase("recommend:cards");
+  rootState = await ensureRecommendViewport(rootState, "cards");
   cardNodeIds = await waitForRecommendCardNodeIds(client, rootState.iframe.documentNodeId, {
     timeoutMs: cardTimeoutMs,
     intervalMs: 300
@@ -468,13 +487,16 @@ export async function runRecommendWorkflow({
     unique_seen: compactInfiniteListState(listState).seen_count,
     scroll_count: 0,
     refresh_rounds: 0,
-    refresh_attempts: 0
+    refresh_attempts: 0,
+    viewport_checks: viewportGuard.getStats().checks,
+    viewport_recoveries: viewportGuard.getStats().recoveries
   });
 
   while (results.length < limit) {
     await runControl.waitIfPaused();
     runControl.throwIfCanceled();
     runControl.setPhase("recommend:candidate");
+    rootState = await ensureRecommendViewport(rootState, "candidate_loop");
 
     const nextCandidateResult = await getNextInfiniteListCandidate({
       client,
@@ -485,7 +507,9 @@ export async function runRecommendWorkflow({
       settleMs: listSettleMs,
       fallbackPoint: listFallbackPoint,
       findNodeIds: async () => {
-        const currentRootState = await getRecommendRoots(client);
+        let currentRootState = await getRecommendRoots(client);
+        currentRootState = await ensureRecommendViewport(currentRootState, "candidate_find_nodes");
+        rootState = currentRootState;
         const currentCardNodeIds = await waitForRecommendCardNodeIds(client, currentRootState.iframe.documentNodeId, {
           timeoutMs: Math.min(cardTimeoutMs, 5000),
           intervalMs: 300
@@ -544,10 +568,13 @@ export async function runRecommendWorkflow({
           refresh_attempts: refreshAttempts.length,
           refresh_method: refreshResult.method || null,
           refresh_forced_recent_not_view: true,
-          list_end_reason: listEndReason
+          list_end_reason: listEndReason,
+          viewport_checks: viewportGuard.getStats().checks,
+          viewport_recoveries: viewportGuard.getStats().recoveries
         });
         if (refreshResult.ok) {
           rootState = refreshResult.root_state || await getRecommendRoots(client);
+          rootState = await ensureRecommendViewport(rootState, "refresh_after");
           cardNodeIds = await waitForRecommendCardNodeIds(client, rootState.iframe.documentNodeId, {
             timeoutMs: cardTimeoutMs,
             intervalMs: 300
@@ -579,6 +606,7 @@ export async function runRecommendWorkflow({
       await runControl.waitIfPaused();
       runControl.throwIfCanceled();
       runControl.setPhase("recommend:detail");
+      rootState = await ensureRecommendViewport(rootState, "detail");
       networkRecorder.clear();
       const openedDetail = await openRecommendCardDetail(client, cardNodeId);
       const waitPlan = getCvNetworkWaitPlan(cvAcquisitionState);
@@ -719,6 +747,8 @@ export async function runRecommendWorkflow({
       refresh_rounds: refreshRounds,
       refresh_attempts: refreshAttempts.length,
       list_end_reason: listEndReason || null,
+      viewport_checks: viewportGuard.getStats().checks,
+      viewport_recoveries: viewportGuard.getStats().recoveries,
       last_candidate_id: screeningCandidate.id || null,
       last_candidate_key: candidateKey,
       last_score: screening.score
@@ -756,6 +786,10 @@ export async function runRecommendWorkflow({
     filter: compactFilterResult(filterResult),
     card_count: cardNodeIds.length,
     candidate_list: compactInfiniteListState(listState),
+    viewport_health: {
+      stats: viewportGuard.getStats(),
+      events: viewportGuard.getEvents()
+    },
     list_end_reason: listEndReason || null,
     refresh_rounds: refreshRounds,
     refresh_attempts: refreshAttempts,

package/src/domains/recruit/roots.js

@@ -25,7 +25,8 @@ export async function getRecruitRoots(client, {
     ].filter(Boolean),
     rootNodes: {
       top: topRoot.nodeId,
-      frame: iframe?.documentNodeId || 0
+      frame: iframe?.documentNodeId || 0,
+      frameOwner: iframe?.nodeId || 0
     }
   };
 }

package/src/domains/recruit/run-service.js

@@ -18,6 +18,7 @@ import {
   markInfiniteListCandidateProcessed,
   resetInfiniteListForRefreshRound
 } from "../../core/infinite-list/index.js";
+import { createViewportRunGuard } from "../../core/self-heal/index.js";
 import { screenCandidate } from "../../core/screening/index.js";
 import {
   closeRecruitDetail,
@@ -140,6 +141,18 @@ export async function runRecruitWorkflow({
     domain: "recruit",
     listName: "search-results"
   });
+  const viewportGuard = createViewportRunGuard({
+    client,
+    domain: "recruit",
+    root: "frame",
+    frameOwnerRoot: "frameOwner",
+    runControl,
+    getRoots: getRecruitRoots
+  });
+  async function ensureRecruitViewport(rootState, phase) {
+    const result = await viewportGuard.ensure(rootState, { phase });
+    return result.rootState || rootState;
+  }
   const results = [];
   const refreshAttempts = [];
   let refreshRounds = 0;
@@ -153,6 +166,7 @@ export async function runRecruitWorkflow({
   runControl.throwIfCanceled();
   runControl.setPhase("recruit:roots");
   let rootState = await getRecruitRoots(client);
+  rootState = await ensureRecruitViewport(rootState, "roots");
   runControl.checkpoint({
     iframe_selector: rootState.iframe.selector,
     iframe_document_node_id: rootState.iframe.documentNodeId,
@@ -186,11 +200,13 @@ export async function runRecruitWorkflow({
       }
     });
     rootState = await getRecruitRoots(client);
+    rootState = await ensureRecruitViewport(rootState, "search");
   }
 
   await runControl.waitIfPaused();
   runControl.throwIfCanceled();
   runControl.setPhase("recruit:cards");
+  rootState = await ensureRecruitViewport(rootState, "cards");
   cardNodeIds = await waitForRecruitCardNodeIds(client, rootState.iframe.documentNodeId, {
     timeoutMs: cardTimeoutMs,
     intervalMs: 300
@@ -209,13 +225,16 @@ export async function runRecruitWorkflow({
     unique_seen: compactInfiniteListState(listState).seen_count,
     scroll_count: 0,
     refresh_rounds: 0,
-    refresh_attempts: 0
+    refresh_attempts: 0,
+    viewport_checks: viewportGuard.getStats().checks,
+    viewport_recoveries: viewportGuard.getStats().recoveries
   });
 
   while (results.length < limit) {
     await runControl.waitIfPaused();
     runControl.throwIfCanceled();
     runControl.setPhase("recruit:candidate");
+    rootState = await ensureRecruitViewport(rootState, "candidate_loop");
 
     const nextCandidateResult = await getNextInfiniteListCandidate({
       client,
@@ -226,7 +245,9 @@ export async function runRecruitWorkflow({
       settleMs: listSettleMs,
       fallbackPoint: listFallbackPoint,
       findNodeIds: async () => {
-        const currentRootState = await getRecruitRoots(client);
+        let currentRootState = await getRecruitRoots(client);
+        currentRootState = await ensureRecruitViewport(currentRootState, "candidate_find_nodes");
+        rootState = currentRootState;
         const currentCardNodeIds = await waitForRecruitCardNodeIds(client, currentRootState.iframe.documentNodeId, {
           timeoutMs: Math.min(cardTimeoutMs, 5000),
           intervalMs: 300
@@ -283,10 +304,13 @@ export async function runRecruitWorkflow({
           refresh_attempts: refreshAttempts.length,
           refresh_method: refreshResult.method || null,
           refresh_forced_recent_viewed: true,
-          list_end_reason: listEndReason
+          list_end_reason: listEndReason,
+          viewport_checks: viewportGuard.getStats().checks,
+          viewport_recoveries: viewportGuard.getStats().recoveries
         });
         if (refreshResult.ok) {
           rootState = await getRecruitRoots(client);
+          rootState = await ensureRecruitViewport(rootState, "refresh_after");
           cardNodeIds = await waitForRecruitCardNodeIds(client, rootState.iframe.documentNodeId, {
             timeoutMs: cardTimeoutMs,
             intervalMs: 300
@@ -318,6 +342,7 @@ export async function runRecruitWorkflow({
       await runControl.waitIfPaused();
       runControl.throwIfCanceled();
       runControl.setPhase("recruit:detail");
+      rootState = await ensureRecruitViewport(rootState, "detail");
       networkRecorder.clear();
       const openedDetail = await openRecruitCardDetail(client, cardNodeId);
       const waitPlan = getCvNetworkWaitPlan(cvAcquisitionState);
@@ -430,6 +455,8 @@ export async function runRecruitWorkflow({
       refresh_rounds: refreshRounds,
       refresh_attempts: refreshAttempts.length,
       list_end_reason: listEndReason || null,
+      viewport_checks: viewportGuard.getStats().checks,
+      viewport_recoveries: viewportGuard.getStats().recoveries,
       last_candidate_id: screeningCandidate.id || null,
       last_candidate_key: candidateKey,
       last_score: screening.score
@@ -459,6 +486,10 @@ export async function runRecruitWorkflow({
     search_params: normalizedSearchParams,
     card_count: cardNodeIds.length,
     candidate_list: compactInfiniteListState(listState),
+    viewport_health: {
+      stats: viewportGuard.getStats(),
+      events: viewportGuard.getEvents()
+    },
     list_end_reason: listEndReason || null,
     refresh_rounds: refreshRounds,
     refresh_attempts: refreshAttempts,

package/src/index.js

@@ -7,7 +7,8 @@ import { fileURLToPath } from "node:url";
 import {
   getFeaturedCalibrationResolution,
   getBossChatTargetCountValue,
-  normalizeTargetCountInput
+  normalizeTargetCountInput,
+  resolveBossScreeningConfig
 } from "./chat-runtime-config.js";
 import {
   __resetChatMcpStateForTests,
@@ -1890,7 +1891,8 @@ async function handleRunRecommendSelfHealTool({ workspaceRoot, args }) {
   }
 
   const host = "127.0.0.1";
-  const port = parsePositiveInteger(args.port, 9222);
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const port = parsePositiveInteger(args.port, configResolution.ok ? configResolution.config.debugPort : 9222);
   let session = null;
   try {
     session = await connectToChromeTarget({
@@ -1909,7 +1911,8 @@ async function handleRunRecommendSelfHealTool({ workspaceRoot, args }) {
       domain: "recommend",
       roots: rootState?.roots || {},
       selectorProbes: config.selectorProbes,
-      accessibilityProbes: config.accessibilityProbes
+      accessibilityProbes: config.accessibilityProbes,
+      viewportProbes: config.viewportProbes
     });
     assertNoForbiddenCdpCalls(methodLog);
 

package/src/recommend-mcp.js

@@ -44,6 +44,10 @@ import {
   parseRecommendInstruction
 } from "./parser.js";
 import { getRunsDir } from "./run-state.js";
+import {
+  resolveBossConfiguredOutputDir,
+  resolveBossScreeningConfig
+} from "./chat-runtime-config.js";
 
 const DEFAULT_RECOMMEND_HOST = "127.0.0.1";
 const DEFAULT_RECOMMEND_PORT = 9222;
@@ -115,12 +119,14 @@ function getRecommendRunArtifacts(runId) {
   const normalized = normalizeRunId(runId);
   if (!normalized) return null;
   const runsDir = getRunsDir();
+  const outputDir = resolveBossConfiguredOutputDir("", runsDir);
   return {
     runs_dir: runsDir,
+    output_dir: outputDir,
     run_state_path: path.join(runsDir, `${normalized}.json`),
     checkpoint_path: path.join(runsDir, `${normalized}.checkpoint.json`),
-    output_csv: path.join(runsDir, `${normalized}.results.csv`),
-    report_json: path.join(runsDir, `${normalized}.report.json`)
+    output_csv: path.join(outputDir, `${normalized}.results.csv`),
+    report_json: path.join(outputDir, `${normalized}.report.json`)
   };
 }
 
@@ -484,8 +490,12 @@ async function readRecommendJobOptionsFromSession(session) {
 }
 
 export async function listRecommendJobsTool({ workspaceRoot = "", args = {} } = {}) {
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
   const host = normalizeText(args.host) || DEFAULT_RECOMMEND_HOST;
-  const port = parsePositiveInteger(args.port, DEFAULT_RECOMMEND_PORT);
+  const port = parsePositiveInteger(
+    args.port,
+    configResolution.ok ? configResolution.config.debugPort : DEFAULT_RECOMMEND_PORT
+  );
   const targetUrlIncludes = normalizeText(args.target_url_includes) || RECOMMEND_TARGET_URL;
   const allowNavigate = args.allow_navigate !== false;
   const slowLive = args.slow_live === true;
@@ -613,7 +623,8 @@ async function waitForHealthyRecommend(client, config, {
       domain: "recommend",
       roots: roots.roots,
       selectorProbes: config.selectorProbes,
-      accessibilityProbes: config.accessibilityProbes
+      accessibilityProbes: config.accessibilityProbes,
+      viewportProbes: config.viewportProbes
     });
     if (lastCheck.status === HEALTH_STATUS.HEALTHY) return lastCheck;
     await sleep(intervalMs);
@@ -922,7 +933,7 @@ function buildRecommendFilter(parsed, args = {}) {
   return groups.length ? { filterGroups: groups } : { enabled: false };
 }
 
-function normalizeRecommendStartInput(args = {}, parsed) {
+function normalizeRecommendStartInput(args = {}, parsed, configResolution = null) {
   const confirmation = args.confirmation || {};
   const overrides = args.overrides || {};
   const slowLive = args.slow_live === true;
@@ -932,7 +943,10 @@ function normalizeRecommendStartInput(args = {}, parsed) {
   );
   return {
     host: normalizeText(args.host) || DEFAULT_RECOMMEND_HOST,
-    port: parsePositiveInteger(args.port, DEFAULT_RECOMMEND_PORT),
+    port: parsePositiveInteger(
+      args.port,
+      configResolution?.ok ? configResolution.config.debugPort : DEFAULT_RECOMMEND_PORT
+    ),
     targetUrlIncludes: normalizeText(args.target_url_includes) || RECOMMEND_TARGET_URL,
     allowNavigate: args.allow_navigate !== false,
     slowLive,
@@ -1038,7 +1052,8 @@ async function startRecommendPipelineRunInternal(args = {}, { workspaceRoot = ""
   const parsed = parseRecommendPipelineRequest(args);
   const gate = evaluateRecommendPipelineGate(parsed, args);
   if (gate) return gate;
-  const normalized = normalizeRecommendStartInput(args, parsed);
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const normalized = normalizeRecommendStartInput(args, parsed, configResolution);
 
   let session;
   try {

package/src/recruit-mcp.js

@@ -32,6 +32,10 @@ import {
   runRecruitWorkflow,
   waitForRecruitSearchControls
 } from "./domains/recruit/index.js";
+import {
+  resolveBossConfiguredOutputDir,
+  resolveBossScreeningConfig
+} from "./chat-runtime-config.js";
 
 const RUN_MODE_ASYNC = "async";
 const RUN_MODE_SYNC = "sync";
@@ -108,12 +112,14 @@ function getRecruitRunArtifacts(runId) {
   const normalized = normalizeRunId(runId);
   if (!normalized) return null;
   const runsDir = getRecruitRunsDir();
+  const outputDir = resolveBossConfiguredOutputDir("", runsDir);
   return {
     runs_dir: runsDir,
+    output_dir: outputDir,
     run_state_path: path.join(runsDir, `${normalized}.json`),
     checkpoint_path: path.join(runsDir, `${normalized}.checkpoint.json`),
-    output_csv: path.join(runsDir, `${normalized}.results.csv`),
-    report_json: path.join(runsDir, `${normalized}.report.json`)
+    output_csv: path.join(outputDir, `${normalized}.results.csv`),
+    report_json: path.join(outputDir, `${normalized}.report.json`)
   };
 }
 
@@ -807,12 +813,18 @@ async function startRecruitPipelineRunInternal(args = {}, { workspaceRoot = "" }
   const parsed = parseRecruitPipelineRequest(args);
   const gate = evaluateRecruitPipelineGate(parsed);
   if (gate) return gate;
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const host = normalizeText(args.host) || DEFAULT_RECRUIT_HOST;
+  const port = parsePositiveInteger(
+    args.port,
+    configResolution.ok ? configResolution.config.debugPort : DEFAULT_RECRUIT_PORT
+  );
 
   let session;
   try {
     session = await recruitConnectorImpl({
-      host: normalizeText(args.host) || DEFAULT_RECRUIT_HOST,
-      port: parsePositiveInteger(args.port, DEFAULT_RECRUIT_PORT),
+      host,
+      port,
       targetUrlIncludes: normalizeText(args.target_url_includes) || RECRUIT_TARGET_URL,
       allowNavigate: args.allow_navigate !== false,
       slowLive: args.slow_live === true
@@ -858,8 +870,8 @@ async function startRecruitPipelineRunInternal(args = {}, { workspaceRoot = "" }
     workspaceRoot: normalizeText(workspaceRoot) || globalThis.process?.cwd?.() || "",
     args: clonePlain(args, {}),
     chrome: {
-      host: normalizeText(args.host) || DEFAULT_RECRUIT_HOST,
-      port: parsePositiveInteger(args.port, DEFAULT_RECRUIT_PORT),
+      host,
+      port,
       target_url: session.target?.url || RECRUIT_TARGET_URL,
       target_id: session.target?.id || null,
       auto_launch: session.chrome || null