@pushpalsdev/cli 1.1.18 → 1.1.20

package/dist/pushpals-cli.js

@@ -1040,6 +1040,7 @@ function loadPushPalsConfig(options = {}) {
         enabled: parseBoolEnv("REMOTEBUDDY_AUTONOMY_ENABLED") ?? asBoolean(remoteAutonomyNode.enabled, true),
         killSwitchEnabled: parseBoolEnv("REMOTEBUDDY_AUTONOMY_KILL_SWITCH_ENABLED") ?? asBoolean(remoteAutonomyNode.kill_switch_enabled, false),
         tickIntervalMs: Math.max(5000, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_TICK_INTERVAL_MS") ?? remoteAutonomyNode.tick_interval_ms, 120000)),
+        startupGraceMs: Math.max(0, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_STARTUP_GRACE_MS") ?? remoteAutonomyNode.startup_grace_ms, 120000)),
         heartbeatLogMs: Math.max(1000, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_HEARTBEAT_LOG_MS") ?? remoteAutonomyNode.heartbeat_log_ms, 30000)),
         visionContextMaxChars: Math.max(1000, Math.min(1e6, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_VISION_CONTEXT_MAX_CHARS") ?? remoteAutonomyNode.vision_context_max_chars, 65536))),
         ideationBudgetMs: Math.max(1000, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_IDEATION_BUDGET_MS") ?? remoteAutonomyNode.ideation_budget_ms, 20000)),
@@ -1648,7 +1649,8 @@ var DEFAULT_STARTUP_GIT_PROBE_TIMEOUT_MS = 5000;
 var DEFAULT_STARTUP_GIT_REMOTE_TIMEOUT_MS = 1e4;
 var DEFAULT_EMBEDDED_SERVICE_LAUNCH_WARN_MS = 5000;
 var EMBEDDED_SERVICE_RESTART_MAX_ATTEMPTS = 4;
-var WORKERPAL_STARTUP_READINESS_PROBE_MAX_MS = 15000;
+var DEFAULT_WORKERPAL_STARTUP_READINESS_PROBE_MAX_MS = 5000;
+var WORKERPAL_STARTUP_READINESS_PROBE_MAX_MS_ENV = "PUSHPALS_WORKERPAL_STARTUP_READINESS_PROBE_MAX_MS";
 var BLOCKING_WORKERPAL_IMAGE_BUILD_ENV = "PUSHPALS_BLOCKING_WORKERPAL_IMAGE_BUILD";
 var CLI_SESSION_JOB_LOG_MAX_CHARS = 700;
 var CLI_SESSION_SHOW_JOB_EVENTS_ENV = "PUSHPALS_CLI_SHOW_JOB_EVENTS";
@@ -1681,6 +1683,13 @@ function formatTimestampedCliLine(line, at = new Date) {
 function isTruthyCliEnvValue(value) {
   return /^(1|true|yes|on)$/i.test(String(value ?? "").trim());
 }
+function parseCliIntEnv(name, env = process.env) {
+  const raw = env[name];
+  if (raw == null || String(raw).trim() === "")
+    return null;
+  const parsed = Number.parseInt(String(raw), 10);
+  return Number.isFinite(parsed) ? parsed : null;
+}
 function shouldShowCliSessionOperationalEvents(env = process.env) {
   return isTruthyCliEnvValue(env[CLI_SESSION_SHOW_JOB_EVENTS_ENV]);
 }
@@ -3899,8 +3908,12 @@ async function precheckWorkerpalDockerAvailability(opts) {
 function resolveWorkerpalCapacityTimeoutMs(config) {
   return Math.max(config.remotebuddy.waitForWorkerpalMs, config.remotebuddy.workerpalStartupTimeoutMs, config.remotebuddy.workerpalDocker ? config.workerpals.dockerAgentStartupTimeoutMs + 15000 : 0, 1e4);
 }
+function resolveWorkerpalStartupReadinessProbeMaxMs(env = process.env) {
+  const configured = parseCliIntEnv(WORKERPAL_STARTUP_READINESS_PROBE_MAX_MS_ENV, env);
+  return Math.max(1000, configured ?? DEFAULT_WORKERPAL_STARTUP_READINESS_PROBE_MAX_MS);
+}
 function resolveWorkerpalStartupReadinessProbeTimeoutMs(config) {
-  return Math.max(5000, Math.min(resolveWorkerpalCapacityTimeoutMs(config), WORKERPAL_STARTUP_READINESS_PROBE_MAX_MS));
+  return Math.max(1000, Math.min(resolveWorkerpalCapacityTimeoutMs(config), resolveWorkerpalStartupReadinessProbeMaxMs()));
 }
 function shouldPrepareEmbeddedWorkerpalDockerImageBlocking(opts = {}) {
   const env = opts.env ?? process.env;
@@ -6082,6 +6095,7 @@ export {
   shouldPrepareEmbeddedWorkerpalDockerImageBlocking,
   shouldDeferRemoteBuddySessionConsumerReadiness,
   runCommandWithEnv,
+  resolveWorkerpalStartupReadinessProbeMaxMs,
   resolveWorkerpalDockerProbe,
   resolveWorkerExecutionReadiness,
   resolveWindowsWhereExecutableCandidatesForEnv,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushpalsdev/cli",
-  "version": "1.1.18",
+  "version": "1.1.20",
   "description": "PushPals terminal CLI for LocalBuddy -> RemoteBuddy orchestration",
   "license": "MIT",
   "repository": {

package/runtime/configs/default.toml

@@ -75,6 +75,7 @@ session_id = "remotebuddy-dev"
 enabled = true
 kill_switch_enabled = false
 tick_interval_ms = 300000
+startup_grace_ms = 120000
 heartbeat_log_ms = 30000
 vision_context_max_chars = 65536
 ideation_budget_ms = 20000

package/runtime/sandbox/.pushpals-remotebuddy-fallback.js

@@ -1323,6 +1323,7 @@ function loadPushPalsConfig(options = {}) {
         enabled: parseBoolEnv("REMOTEBUDDY_AUTONOMY_ENABLED") ?? asBoolean(remoteAutonomyNode.enabled, true),
         killSwitchEnabled: parseBoolEnv("REMOTEBUDDY_AUTONOMY_KILL_SWITCH_ENABLED") ?? asBoolean(remoteAutonomyNode.kill_switch_enabled, false),
         tickIntervalMs: Math.max(5000, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_TICK_INTERVAL_MS") ?? remoteAutonomyNode.tick_interval_ms, 120000)),
+        startupGraceMs: Math.max(0, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_STARTUP_GRACE_MS") ?? remoteAutonomyNode.startup_grace_ms, 120000)),
         heartbeatLogMs: Math.max(1000, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_HEARTBEAT_LOG_MS") ?? remoteAutonomyNode.heartbeat_log_ms, 30000)),
         visionContextMaxChars: Math.max(1000, Math.min(1e6, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_VISION_CONTEXT_MAX_CHARS") ?? remoteAutonomyNode.vision_context_max_chars, 65536))),
         ideationBudgetMs: Math.max(1000, asInt(parseIntEnv("REMOTEBUDDY_AUTONOMY_IDEATION_BUDGET_MS") ?? remoteAutonomyNode.ideation_budget_ms, 20000)),
@@ -4812,6 +4813,46 @@ var IGNORED_REPO_TARGET_DIRS = new Set([
   "__pycache__",
   "target"
 ]);
+function isPushPalsRepository(repoRoot) {
+  return existsSync4(resolve4(repoRoot, "apps", "remotebuddy", "src", "autonomous_engine.ts")) && existsSync4(resolve4(repoRoot, "apps", "workerpals", "src", "workerpals_main.ts")) && existsSync4(resolve4(repoRoot, "packages", "shared", "src", "autonomy_policy.ts"));
+}
+function isPushPalsInternalUserRepoPath(path) {
+  const normalized = asString2(path).replace(/\\/g, "/").toLowerCase();
+  if (!normalized)
+    return false;
+  return /(^|\/)_layout\.autonomy\.test\.[cm]?[jt]sx?$/.test(normalized);
+}
+function containsPushPalsInternalUserRepoText(text) {
+  return /\b(queue_health|workerpal|remotebuddy|sourcecontrolmanager|source_control_manager|reviewagent|pushpals)\b/i.test(text);
+}
+function candidateLeaksPushPalsInternals(candidate) {
+  if ([candidate.component_area, ...candidate.target_paths].some((path) => isPushPalsInternalUserRepoPath(path))) {
+    return true;
+  }
+  const publicText = [
+    candidate.title,
+    candidate.problem_statement,
+    candidate.vision_alignment_reason,
+    ...candidate.feature_hypotheses,
+    ...candidate.target_paths
+  ].join(`
+`);
+  return containsPushPalsInternalUserRepoText(publicText);
+}
+function buildRepoNativeFallbackInstruction(candidate) {
+  return [
+    candidate.title,
+    "",
+    candidate.problem_statement,
+    "",
+    "Keep the change scoped to the repo's own product/runtime behavior. Do not add PushPals, WorkerPal, RemoteBuddy, queue-health, or autonomy-internal concepts to user-facing code or tests.",
+    "",
+    "Scope:",
+    `- target_paths: ${candidate.target_paths.join(", ")}`,
+    `- write_globs: ${candidate.scope.write_globs.join(", ")}`
+  ].join(`
+`);
+}
 function pathBasename(path) {
   const normalized = path.replace(/\\/g, "/").replace(/\/+$/, "");
   const idx = normalized.lastIndexOf("/");
@@ -4890,10 +4931,13 @@ function collectRepoTargetFiles(repoRoot, startRelativePath, maxResults, maxDept
 function discoverRepoTargetProfiles(repoRoot, maxProfiles = 16) {
   const profiles = [];
   const seen = new Set;
+  const allowPushPalsInternalTargets = isPushPalsRepository(repoRoot);
   const add = (targetPath) => {
     const finalPath = normalizeAutonomyComponentArea(targetPath);
     if (!finalPath)
       return;
+    if (!allowPushPalsInternalTargets && isPushPalsInternalUserRepoPath(finalPath))
+      return;
     if (seen.has(finalPath))
       return;
     seen.add(finalPath);
@@ -4959,6 +5003,8 @@ function chooseRepoObjectiveTargetProfile(profiles, objective) {
   let best = null;
   for (const profile of profiles) {
     const label = profile.label.toLowerCase();
+    if (isPushPalsInternalUserRepoPath(label))
+      continue;
     const profileTokens = new Set(profile.keywords);
     let score = 0;
     for (const token of hintTokens) {
@@ -4988,6 +5034,17 @@ function chooseRepoObjectiveTargetProfile(profiles, objective) {
       if (productSurface)
         score += 1;
     }
+    if (/\b(web|browser|smoke|e2e|review path|review|navigation|delivery|trust)\b/i.test(objective.title)) {
+      if (/(^|\/)(scripts?|tools?)\/.*(web|browser|smoke|e2e|playwright)/i.test(label)) {
+        score += 8;
+      }
+      if (/\b(app\/(_layout|index)|route|navigation|shell|home|screen)\b/i.test(label)) {
+        score += 4;
+      }
+      if (validationSurface && !/(web|browser|smoke|e2e|playwright)/i.test(label)) {
+        score -= 3;
+      }
+    }
     if (categories.has("performance")) {
       if (productSurface || /\b(perf|render|animation|worker|server)\b/i.test(label))
         score += 4;
@@ -6513,6 +6570,7 @@ class RemoteBuddyAutonomousEngine {
   cfg;
   runtimeEnabled = true;
   timer = null;
+  startupGraceTimer = null;
   startupFastTickTimer = null;
   heartbeatTimer = null;
   inFlight = false;
@@ -6585,7 +6643,8 @@ class RemoteBuddyAutonomousEngine {
       console.log(`[RemoteBuddyAutonomousEngine] heartbeat: status=running run=${this.currentRunId} phase=${this.currentPhase} run_elapsed_ms=${runElapsedMs} phase_elapsed_ms=${phaseElapsedMs}`);
       return;
     }
-    const nextTickInMs = this.timer && this.nextTickAtMs > 0 ? Math.max(0, this.nextTickAtMs - now) : 0;
+    const hasScheduledTick = Boolean(this.timer || this.startupGraceTimer || this.startupFastTickTimer);
+    const nextTickInMs = hasScheduledTick && this.nextTickAtMs > 0 ? Math.max(0, this.nextTickAtMs - now) : 0;
     const lastAgeMs = this.lastCompletedAtMs > 0 ? Math.max(0, now - this.lastCompletedAtMs) : -1;
     console.log(`[RemoteBuddyAutonomousEngine] heartbeat: status=idle last_outcome=${this.lastOutcome} detail=${this.lastDetail} last_tick_age_ms=${lastAgeMs} next_tick_in_ms=${nextTickInMs}`);
   }
@@ -6611,6 +6670,15 @@ class RemoteBuddyAutonomousEngine {
   startupFastTickDelayMs() {
     return Math.max(1000, Math.min(STARTUP_FAST_TICK_MAX_DELAY_MS, Math.floor(this.cfg.tickIntervalMs / 10)));
   }
+  startupGraceMs() {
+    return Math.max(0, this.cfg.startupGraceMs ?? 0);
+  }
+  clearStartupGraceTimer() {
+    if (this.startupGraceTimer) {
+      clearTimeout(this.startupGraceTimer);
+      this.startupGraceTimer = null;
+    }
+  }
   clearStartupFastTickTimer() {
     if (this.startupFastTickTimer) {
       clearTimeout(this.startupFastTickTimer);
@@ -7479,6 +7547,7 @@ ${JSON.stringify(input.messages ?? [])}`),
       }
       const normalizedCandidates = [];
       const dropReasonCounts = new Map;
+      const allowPushPalsInternalCandidates = isPushPalsRepository(this.autonomyRepo);
       const recordDropReason = (reason) => {
         dropReasonCounts.set(reason, (dropReasonCounts.get(reason) ?? 0) + 1);
       };
@@ -7553,6 +7622,11 @@ ${JSON.stringify(input.messages ?? [])}`),
           candidate.component_area = scopeValidation.componentArea ?? candidate.component_area;
           candidate.target_paths = scopeValidation.normalizedTargetPaths;
           candidate.scope.write_globs = scopeValidation.normalizedWriteGlobs;
+          if (!allowPushPalsInternalCandidates && candidateLeaksPushPalsInternals(candidate)) {
+            recordDropReason(`${source}_pushpals_internal_leak`);
+            console.warn(`[RemoteBuddyAutonomousEngine] dropping candidate ${candidate.id}: PushPals-internal concepts do not belong in user-repo autonomy work.`);
+            continue;
+          }
           const missingTargetPaths = findMissingRepoTargetPaths(this.autonomyRepo, candidate.target_paths);
           if (missingTargetPaths.length > 0) {
             recordDropReason(`${source}_target_paths_missing_in_repo`);
@@ -7966,13 +8040,17 @@ ${JSON.stringify(input.messages ?? [])}`),
         outcomeDetail = "lock_renew_failed_before_enqueue";
         return;
       }
-      const instruction = canonicalizeInstructionTextForBun(asString2(planningJson.instruction) || `${selected.candidate.title}
+      let instruction = canonicalizeInstructionTextForBun(asString2(planningJson.instruction) || `${selected.candidate.title}
 
 ${selected.candidate.problem_statement}
 
 Scope:
 - target_paths: ${selected.candidate.target_paths.join(", ")}
 - write_globs: ${selected.candidate.scope.write_globs.join(", ")}`);
+      if (!isPushPalsRepository(this.autonomyRepo) && containsPushPalsInternalUserRepoText(instruction)) {
+        console.warn(`[RemoteBuddyAutonomousEngine] replacing autonomy instruction for ${selected.candidate.id}: planner output contained PushPals-internal wording.`);
+        instruction = canonicalizeInstructionTextForBun(buildRepoNativeFallbackInstruction(selected.candidate));
+      }
       this.setPhase("enqueue_request");
       const requestId = await this.enqueueSyntheticRequest(instruction, {
         objectiveId,
@@ -8094,22 +8172,42 @@ Scope:
     });
   }
   start() {
-    if (!this.runtimeEnabled || this.timer)
+    if (!this.runtimeEnabled || this.timer || this.startupGraceTimer)
       return;
     console.log(`[RemoteBuddyAutonomousEngine] Using dedicated autonomy worktree ${this.autonomyRepo} (remote=${this.gitRemote} integration=${this.integrationBranch} base=${this.baseBranch}).`);
     this.startupFastTickAttemptsRemaining = STARTUP_FAST_TICK_MAX_ATTEMPTS;
-    this.nextTickAtMs = Date.now();
-    this.timer = setInterval(() => {
-      this.nextTickAtMs = Date.now() + this.cfg.tickIntervalMs;
-      this.tick();
-    }, this.cfg.tickIntervalMs);
+    const startInterval = () => {
+      if (this.timer)
+        return;
+      this.timer = setInterval(() => {
+        this.nextTickAtMs = Date.now() + this.cfg.tickIntervalMs;
+        this.tick();
+      }, this.cfg.tickIntervalMs);
+    };
+    const firstTickDelayMs = this.startupGraceMs();
+    this.nextTickAtMs = Date.now() + firstTickDelayMs;
     this.heartbeatTimer = setInterval(() => {
       this.logHeartbeat();
     }, this.cfg.heartbeatLogMs);
     this.logHeartbeat();
+    if (firstTickDelayMs > 0) {
+      console.log(`[RemoteBuddyAutonomousEngine] startup autonomy tick delayed by ${firstTickDelayMs}ms to leave cold-start capacity available for user work.`);
+      this.startupGraceTimer = setTimeout(() => {
+        this.startupGraceTimer = null;
+        if (!this.runtimeEnabled)
+          return;
+        startInterval();
+        this.nextTickAtMs = Date.now() + this.cfg.tickIntervalMs;
+        this.tick();
+      }, firstTickDelayMs);
+      return;
+    }
+    startInterval();
+    this.nextTickAtMs = Date.now() + this.cfg.tickIntervalMs;
     this.tick();
   }
   stop() {
+    this.clearStartupGraceTimer();
     this.clearStartupFastTickTimer();
     if (this.timer) {
       clearInterval(this.timer);
@@ -8426,7 +8524,7 @@ function ensureWriteGlobsCoverTargetPaths(targetPaths, writeGlobs) {
   }
   return { normalizedWriteGlobs, uncoveredTargets, addedGlobs };
 }
-function buildExecutionGuidance(plan, targetPaths, requiredValidationSteps = []) {
+function buildExecutionGuidance(plan, targetPaths, requiredValidationSteps = [], repoHintDiagnostics = []) {
   const lines = [];
   const targets = normalizePathHints(targetPaths.length > 0 ? targetPaths : plan.scope.write_globs ?? []);
   if (targets.length > 0) {
@@ -8438,6 +8536,13 @@ function buildExecutionGuidance(plan, targetPaths, requiredValidationSteps = [])
     lines.push("- Do not prepend a leading slash to target paths.");
     lines.push("- These paths are relevance hints, not hard write boundaries; edit the behavior-owning files needed for the task and explain any expansion.");
   }
+  if (repoHintDiagnostics.length > 0) {
+    lines.push("Repo hint preflight:");
+    for (const diagnostic of repoHintDiagnostics.slice(0, 8)) {
+      lines.push(`- ${diagnostic}`);
+    }
+    lines.push("- If a hinted path is absent, treat it as stale guidance unless the user explicitly asked to create that path. Prefer an existing repo-native owner or nearby test.");
+  }
   lines.push("Scope:");
   lines.push(`- read_anywhere: ${plan.scope.read_anywhere ? "true" : "false"}`);
   lines.push(`- write_allowed: ${plan.scope.write_allowed ? "true" : "false"}`);
@@ -8490,6 +8595,75 @@ function buildExecutionGuidance(plan, targetPaths, requiredValidationSteps = [])
   return lines.join(`
 `).trim();
 }
+function pathHintHasGlob(value) {
+  return /[*?[\]{}]/.test(value);
+}
+function pathHintLooksLikeConcreteFile(value) {
+  const normalized = value.replace(/\\/g, "/").replace(/^\.\/+/, "");
+  const tail = normalized.split("/").pop() ?? normalized;
+  return /\.[A-Za-z0-9][A-Za-z0-9_-]{0,12}$/.test(tail);
+}
+function requestAllowsCreatingMissingPath(value) {
+  return /\b(create|add|new|scaffold|generate|introduce|write)\b.{0,80}\b(file|test|module|component|script|page|route|fixture|helper)\b/i.test(value);
+}
+function shouldTreatMissingTargetAsStale(repoRoot, path, requestText) {
+  const normalized = normalizeTargetPath(path);
+  if (!normalized || normalized === "." || pathHintHasGlob(normalized))
+    return false;
+  if (!pathHintLooksLikeConcreteFile(normalized))
+    return false;
+  if (existsSync5(resolve5(repoRoot, normalized)))
+    return false;
+  if (requestAllowsCreatingMissingPath(requestText))
+    return false;
+  return true;
+}
+function sanitizeRepoNativeTargetHints(params) {
+  const requestText = [
+    params.prompt,
+    params.plan.worker_instruction,
+    params.plan.assistant_message,
+    ...params.plan.acceptance_criteria,
+    ...params.targetPaths
+  ].join(`
+`);
+  const diagnostics = [];
+  const staleHints = [];
+  const targetPaths = params.targetPaths.filter((path) => {
+    const normalized = normalizeTargetPath(path);
+    if (!normalized)
+      return false;
+    if (!shouldTreatMissingTargetAsStale(params.repoRoot, normalized, requestText))
+      return true;
+    staleHints.push(normalized);
+    diagnostics.push(`Path hint "${normalized}" does not exist in this checkout; it was removed as a canonical target and kept only as advisory context.`);
+    return false;
+  });
+  if (staleHints.length > 0) {
+    const staleLower = staleHints.map((path) => path.toLowerCase());
+    params.plan.validation_steps = params.plan.validation_steps.filter((step) => {
+      const lower = step.replace(/\\/g, "/").toLowerCase();
+      return !staleLower.some((path) => lower.includes(path));
+    });
+    params.plan.scope.write_globs = params.plan.scope.write_globs.filter((glob) => {
+      const normalized = normalizeTargetPath(glob);
+      if (!normalized)
+        return false;
+      return !staleLower.includes(normalized.toLowerCase());
+    });
+    if (!params.plan.discovery) {
+      params.plan.discovery = { ripgrep_queries: [] };
+    }
+    const keywords = new Set([...params.plan.discovery.keywords ?? []]);
+    for (const path of staleHints) {
+      const tail = path.split("/").pop();
+      if (tail)
+        keywords.add(tail.replace(/\.[^.]+$/, ""));
+    }
+    params.plan.discovery.keywords = [...keywords].slice(0, 12);
+  }
+  return { targetPaths, diagnostics, staleHints };
+}
 var VALIDATION_COMMAND_PREFIX = /^(git|bun|bunx|npm|npx|pnpm|yarn|node|python|python3|uv|pytest|vitest|jest|tsc|eslint|ruff|mypy|go|cargo|make|docker|pwsh|powershell|sh|bash)\b/i;
 var VALIDATION_GENERIC_SAFE = /^(git\s+status\s+--porcelain|git\s+diff\b)/i;
 var PATH_TOKEN_REGEX = /\b([A-Za-z0-9._/\-\\]+\.[A-Za-z0-9._-]+)\b/g;
@@ -8872,7 +9046,7 @@ class RemoteBuddyOrchestrator {
     console.log(`[RemoteBuddy] Budgets: interactive=${this.executionBudgetInteractiveMs}ms normal=${this.executionBudgetNormalMs}ms background=${this.executionBudgetBackgroundMs}ms finalization=${this.finalizationBudgetMs}ms`);
     console.log(`[RemoteBuddy] Failure log fetch on job failures: ${this.fetchFailureLogsOnJobFailure ? "on" : "off"}`);
     console.log(`[RemoteBuddy] Persistent memory: ${this.memoryEnabled ? "on" : "off"} crossSession=${this.memoryIncludeCrossSession ? "on" : "off"} recallItems=${this.memoryMaxRecallItems} recallChars=${this.memoryMaxRecallChars} retentionDays=${this.memoryRetentionDays}`);
-    console.log(`[RemoteBuddy] Autonomous engine: ${CONFIG.remotebuddy.autonomy.enabled ? "enabled" : "disabled"} tick=${CONFIG.remotebuddy.autonomy.tickIntervalMs}ms maxConcurrentObjectives=${CONFIG.remotebuddy.autonomy.maxConcurrentObjectives} maxDispatchPerHour=${CONFIG.remotebuddy.autonomy.maxDispatchPerHour} exploreRate=${CONFIG.remotebuddy.autonomy.exploreRate.toFixed(2)} allowDirtyWorktree=${CONFIG.remotebuddy.autonomy.allowDirtyWorktree ? "on" : "off"}`);
+    console.log(`[RemoteBuddy] Autonomous engine: ${CONFIG.remotebuddy.autonomy.enabled ? "enabled" : "disabled"} tick=${CONFIG.remotebuddy.autonomy.tickIntervalMs}ms startupGrace=${CONFIG.remotebuddy.autonomy.startupGraceMs}ms maxConcurrentObjectives=${CONFIG.remotebuddy.autonomy.maxConcurrentObjectives} maxDispatchPerHour=${CONFIG.remotebuddy.autonomy.maxDispatchPerHour} exploreRate=${CONFIG.remotebuddy.autonomy.exploreRate.toFixed(2)} allowDirtyWorktree=${CONFIG.remotebuddy.autonomy.allowDirtyWorktree ? "on" : "off"}`);
     console.log(`[RemoteBuddy] Autonomy runtime-config polling: every ${this.autonomyConfigPollMs}ms`);
   }
   async emitStartupStatus() {
@@ -9923,7 +10097,17 @@ Please reply with the missing details and I will enqueue a follow-up request.` :
       }
       this.pushContext(`[user] ${toSingleLine(prompt, 700)}`, requestSessionId);
       this.pushContext(`[plan] ${toSingleLine(JSON.stringify(plan), 900)}`, requestSessionId);
-      const targetPaths = autonomyMetadata && autonomyMetadata.targetPaths.length > 0 ? autonomyMetadata.targetPaths : plannerTargetPaths(plan, prompt);
+      let targetPaths = autonomyMetadata && autonomyMetadata.targetPaths.length > 0 ? autonomyMetadata.targetPaths : plannerTargetPaths(plan, prompt);
+      const repoHintPreflight = sanitizeRepoNativeTargetHints({
+        repoRoot: this.repo,
+        prompt,
+        plan,
+        targetPaths
+      });
+      targetPaths = repoHintPreflight.targetPaths;
+      if (repoHintPreflight.diagnostics.length > 0) {
+        console.warn(`[RemoteBuddy] Repo hint preflight: ${repoHintPreflight.diagnostics.slice(0, 3).join(" | ")}`);
+      }
       this.rememberPersistentMemory("plan", `intent=${plan.intent} worker=${plan.requires_worker ? "yes" : "no"} lane=${plan.lane} risk=${plan.risk_level} targets=${targetPaths.slice(0, 6).join(",") || "(none)"}`, requestId, requestSessionId);
       const targetPath = targetPaths[0];
       const isAnalysisFromEngine = plan.intent === "analysis" && Boolean(autonomyMetadata);
@@ -9961,8 +10145,9 @@ Please reply with the missing details and I will enqueue a follow-up request.` :
         }
         if (!forceWorker) {
           const missing = [];
-          if (targetPaths.length === 0)
+          if (targetPaths.length === 0 && repoHintPreflight.diagnostics.length === 0) {
             missing.push("target_paths");
+          }
           if (plan.acceptance_criteria.length === 0)
             missing.push("acceptance_criteria");
           if (plan.validation_steps.length === 0)
@@ -9981,7 +10166,7 @@ Please reply with the missing details and I will enqueue a follow-up request.` :
       }
       const canonicalInstruction = prompt.trim();
       const rawPlannerInstruction = sanitizePlannerWorkerInstruction(String(plan.worker_instruction ?? ""), canonicalInstruction);
-      const executionGuidance = buildExecutionGuidance(plan, targetPaths, requiredValidationSteps);
+      const executionGuidance = buildExecutionGuidance(plan, targetPaths, requiredValidationSteps, repoHintPreflight.diagnostics);
       const plannerWorkerInstruction = [rawPlannerInstruction, executionGuidance].filter(Boolean).join(`
 
 `).trim();
@@ -10087,6 +10272,7 @@ Please reply with the missing details and I will enqueue a follow-up request.` :
           } : {},
           acceptanceCriteria: plan.acceptance_criteria,
           validationSteps: plan.validation_steps,
+          ...repoHintPreflight.diagnostics.length > 0 ? { repoHintDiagnostics: repoHintPreflight.diagnostics } : {},
           ...requiredValidationSteps.length > 0 ? { requiredValidationSteps } : {},
           queuePriority: priority,
           queueWaitBudgetMs,