opencode-agent-skill 13.0.0-beta.1 → 14.2.0-beta.1

package/global-config/plugins/ues-router/command-runtime.js

@@ -29,6 +29,60 @@ export function normalizeUesPromptPaste(text) {
   return value
 }
 
+export function policySourceForPromptAlias(promptAlias, promptText) {
+  if (!promptAlias) return normalizeUesPromptPaste(promptText).trim()
+
+  const args = String(promptAlias.arguments || "").trim()
+  if (promptAlias.alias === "ues-resume") {
+    return [
+      "Resume an existing durable UES execution.",
+      args,
+    ].filter(Boolean).join("\n")
+  }
+
+  return args || `/${promptAlias.alias}`
+}
+
+export function promptAliasTextForPolicy(promptAlias, policy) {
+  if (!promptAlias) return null
+  if (promptAlias.alias !== "ues-run") return promptAlias.text
+
+  const args = String(promptAlias.arguments || "").trim()
+  const mode = String(policy?.mode || "").toLowerCase()
+  const risk = String(policy?.risk || "").toLowerCase()
+  const profile = String(policy?.executionProfile || policy?.profile?.name || "").toLowerCase()
+  const isDeep = mode === "long-horizon" || risk === "high" || profile === "deep"
+  const isFast = !isDeep && (profile === "fast" || mode === "inline")
+  const isStandard = !isDeep && (profile === "standard" || mode === "standard")
+
+  if (isFast) {
+    return [
+      "UES V2 prompt alias: /ues-run. Adaptive policy selected FAST from the actual user request.",
+      "Preserve the user's exact requested outcome and response constraints.",
+      "Do not initialize .ues-work, create SPEC/PLAN state, inspect the repository, dispatch subagents, or run verification unless the request itself requires repository work or machine-checkable evidence.",
+      "If the request is directly answerable, answer it directly now.",
+      "",
+      "User request:",
+      args,
+    ].join("\n").trim()
+  }
+
+  if (isStandard) {
+    return [
+      "UES V2 prompt alias: /ues-run. Adaptive policy selected STANDARD from the actual user request.",
+      "Preserve the user's exact requested outcome and approval boundaries.",
+      "Use targeted repository evidence, bounded edits, and targeted + affected verification.",
+      "Do not create durable .ues-work state, plan gates, integration gates, or parallel workers unless new evidence justifies reclassification to DEEP/high-risk.",
+      "If evidence materially widens scope or risk, re-run ocskill task-policy on a concise updated summary before escalating.",
+      "",
+      "User request:",
+      args,
+    ].join("\n").trim()
+  }
+
+  return promptAlias.text
+}
+
 export function policyPromptForCli(text, maxChars = 12_000) {
   const raw = normalizeUesPromptPaste(text).trim()
   const limit = Math.max(2_000, Number(maxChars) || 12_000)

package/global-config/plugins/ues-router/index.js

@@ -8,7 +8,13 @@ import { runtimeCapabilities } from "./capabilities.js"
 import { parallelRootBaseline, runEventDrivenDAG } from "./parallel-runtime.js"
 import { readProjectJson, readProjectText } from "./text-runtime.js"
 import { extractVerifierVerdict } from "./verifier-runtime.js"
-import { expandUesPromptAlias, policyPromptForCli } from "./command-runtime.js"
+import {
+  expandUesPromptAlias,
+  policyPromptForCli,
+  policySourceForPromptAlias,
+  promptAliasTextForPolicy,
+} from "./command-runtime.js"
+import { classifyEngineeringTask } from "./policy-runtime.js"
 import {
   budgetToolResult,
   classifyProviderFailure,
@@ -51,6 +57,13 @@ function spawnHidden(command, args, options = {}) {
   })
 }
 
+function bestEffortProgress(tool, status) {
+  try {
+    const pending = tool?.progress?.({ status })
+    if (pending && typeof pending.catch === "function") pending.catch(() => {})
+  } catch {}
+}
+
 function findWindowsCommand(name) {
   const result = spawnHidden("where", [name], { encoding: "utf8" })
   if (result.status !== 0 || !result.stdout) return null
@@ -566,7 +579,7 @@ export default {
         },
         options: { namespace: "ues", codemode: true },
         execute: async (input) => ({
-          content: runOcskill(["task-policy", input.text], projectRoot),
+          content: JSON.stringify(classifyEngineeringTask(input.text), null, 2),
         }),
       })
       editor.add({
@@ -975,7 +988,7 @@ export default {
             ...(started?.contextPack?.task?.acceptance || []),
             started?.contextPack?.task?.risk ? "risk: " + started.contextPack.task.risk : null,
           ].filter(Boolean).join(" ")
-          const taskPolicy = runOcskillJSON(["task-policy", taskText], projectRoot)
+          const taskPolicy = classifyEngineeringTask(taskText)
           appendTrace(traceID, "dispatch.started", {
             slug: input.slug,
             task: input.task,
@@ -1473,7 +1486,7 @@ export default {
                 if (result.sandbox?.dir) {
                   try { runOcskill(["sandbox", "remove", result.sandbox.dir, projectRoot, "--force", "--delete-branch"], projectRoot) } catch {}
                 }
-                try { void tool.progress({ status: "parallel task " + task.id + " verified and integrated" }) } catch {}
+                bestEffortProgress(tool, "parallel task " + task.id + " verified and integrated")
                 return { integration, deterministicReceipts, receipt, completed }
               } catch (error) {
                 if (!durableCompleted) {
@@ -1489,7 +1502,7 @@ export default {
             },
             onEvent: (event) => {
               if (["task.started", "task.completed", "task.failed"].includes(event.type)) {
-                void tool.progress({ status: "parallel " + event.type + " " + event.task })
+                bestEffortProgress(tool, "parallel " + event.type + " " + event.task)
               }
             },
           })
@@ -1538,9 +1551,17 @@ export default {
       const config = routerConfig()
       if (!config.enabled) return
 
-      const promptAlias = expandUesPromptAlias(event.prompt?.text, COMMAND_TEMPLATE_DIR)
+      const originalPromptText = String(event.prompt?.text || "")
+      const promptAlias = expandUesPromptAlias(originalPromptText, COMMAND_TEMPLATE_DIR)
+      const routingText = promptAlias
+        ? (promptAlias.arguments || `/${promptAlias.alias}`)
+        : originalPromptText
+      const policySource = policySourceForPromptAlias(promptAlias, originalPromptText)
+      const policyInput = policyPromptForCli(policySource)
+      const policy = classifyEngineeringTask(policyInput.text)
+
       if (promptAlias && event.prompt) {
-        event.prompt.text = promptAlias.text
+        event.prompt.text = promptAliasTextForPolicy(promptAlias, policy)
         event.metadata = {
           ...event.metadata,
           uesPromptAlias: {
@@ -1548,27 +1569,12 @@ export default {
             sourceName: promptAlias.sourceName,
             preferredAgent: promptAlias.agent,
             transport: "session.prompt",
+            adaptiveProfile: policy?.executionProfile || policy?.profile?.name || null,
           },
         }
       }
 
-      const promptText = String(event.prompt?.text || "")
-      const routingText = promptAlias
-        ? (promptAlias.arguments || `/${promptAlias.alias}`)
-        : promptText
-      const policySource = promptAlias
-        ? [
-            ["ues-run", "ues-resume"].includes(promptAlias.alias)
-              ? "Explicit long-horizon engineering request."
-              : `UES command /${promptAlias.alias}.`,
-            promptAlias.arguments,
-          ].filter(Boolean).join("\n")
-        : routingText
-      const policyInput = policyPromptForCli(policySource)
-      let policy = null
-      try {
-        policy = runOcskillJSON(["task-policy", policyInput.text], projectRoot)
-      } catch {}
+      const promptText = String(event.prompt?.text || originalPromptText)
       const intent = classifyIntent(routingText, routingFacts)
       const effectiveMaxSkills = Math.max(
         1,

package/global-config/plugins/ues-router/policy-runtime.js

@@ -0,0 +1,7 @@
+// Legacy OpenCode router compatibility shim.
+// The canonical task policy is Pi-native and lives in lib/task-policy.mjs.
+// Keep this file only so older installations do not fork policy behavior.
+export {
+  classifyEngineeringTask,
+  recoveryPolicyForAttempt,
+} from "../../../lib/task-policy.mjs"

package/global-config/plugins/ues-router/router.js

@@ -2,6 +2,16 @@ function add(list, id) {
   if (!list.includes(id)) list.push(id)
 }
 
+const HIGH_RISK_MUTATION = /((?:fix|change|modify|update|alter|migrate|drop|truncate|delete|remove|rotate|deploy|publish|push|sửa|thay đổi|cập nhật|xóa|xoá|di trú|chuyển đổi|triển khai).{0,64}(?:\bauth\b|authorization|authentication|security|permission|payment(?: handling| flow)?|schema|database|production|public api|secret|credential|phân quyền|bảo mật|thanh toán|cơ sở dữ liệu|api công khai|bí mật|thông tin xác thực)|(?:\bauth\b|authorization|authentication|security|permission|payment(?: handling| flow)?|schema|database|production|public api|secret|credential|phân quyền|bảo mật|thanh toán|cơ sở dữ liệu|api công khai|bí mật|thông tin xác thực).{0,64}(?:fix|change|modify|update|alter|migrate|drop|truncate|delete|remove|rotate|deploy|publish|push|sửa|thay đổi|cập nhật|xóa|xoá|di trú|chuyển đổi|triển khai)|database migration|schema migration|migrate database|migrate schema|drop table|truncate table|deploy(?:ment)?\s+(?:to\s+)?production|production\s+deploy(?:ment)?|rotate\s+(?:secret|credential)|breaking\s+(?:change\s+to\s+)?(?:public\s+)?api|npm publish|git push|force push|reset --hard|git clean)/i
+
+function riskTextFor(value) {
+  return String(value || "")
+    .replace(/\b(?:do not|don't|without)\s+(?:edit|modify|change|write|delete|remove)[^.\n]*/gi, "")
+    .replace(/\b(?:no|read[- ]only)\s+(?:edits?|changes?|writes?)[^.\n]*/gi, "")
+    .replace(/không\s+(?:sửa|chỉnh sửa|thay đổi|ghi|xóa|xoá)[^.\n]*/gi, "")
+    .replace(/chỉ\s+đọc[^.\n]*/gi, "")
+}
+
 const PROCESS_SKILLS = new Set([
   "ues-engineering-orchestrator",
   "ues-long-task-state",
@@ -90,8 +100,8 @@ export function classifyIntent(text, facts = {}) {
   if (/(refactor|cleanup|restructure|refactor toàn bộ)/.test(value)) add(actions, "refactor")
   if (/(latest|current docs|documentation|release notes|version compatibility|dependency|package version|api changed|tài liệu mới nhất|phiên bản mới|tương thích phiên bản|package mới)/.test(value)) add(actions, "research")
 
-  const risky = /(migration|schema|database|sql|\bauth\b|authorization|authentication|permission|security|payment|webhook|public api|contract|dependency|deploy|\bci\b|production|rollback|cơ sở dữ liệu|phân quyền|xác thực|bảo mật|thanh toán|triển khai|phụ thuộc)/.test(value)
-  const longHorizon = value.length > 700 || /(large task|big task|long[- ]running|multi[- ]file|cross[- ]module|whole (?:repo|repository|project)|entire (?:repo|repository|project)|full refactor|refactor all|migrate all|resume this work|toàn bộ (?:repo|repository|dự án)|nhiều file|nhiều module|refactor toàn bộ|tiếp tục công việc)/.test(value)
+  const risky = HIGH_RISK_MUTATION.test(riskTextFor(value))
+  const longHorizon = value.length > 700 || /(large task|big task|long[- ]running|multi[- ]file|cross[- ]module|whole (?:repo|repository|project)|entire (?:repo|repository|project)|full refactor|refactor all|migrate all|multi[- ]step migration|migration across|resume this work|toàn bộ (?:repo|repository|dự án)|nhiều file|nhiều module|refactor toàn bộ|tiếp tục công việc)/.test(value)
   const nonTrivial = value.length > 220 || risky || actions.length > 0
 
   const feedbackDomains = [...new Set((facts.feedbackDomains || []).filter((item) => domains.includes(item)))]

package/global-config/skills/ecommerce-engineering/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ecommerce-engineering
-description: Build/review ecommerce and marketplace systems: catalog, sellers, carts, checkout, orders, inventory, pricing, images, and traceability.
+description: "Build/review ecommerce and marketplace systems: catalog, sellers, carts, checkout, orders, inventory, pricing, images, and traceability."
 ---
 
 # Ecommerce Engineering

package/global-config/skills/file-upload-engineering/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: file-upload-engineering
-description: Implement file/image uploads safely: validation, storage, naming, URLs, cleanup, permissions, progress, and errors.
+description: "Implement file/image uploads safely: validation, storage, naming, URLs, cleanup, permissions, progress, and errors."
 ---
 
 # File Upload Engineering

package/global-config/skills/git-safety/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: git-safety
-description: Use Git safely: inspect status/diffs, preserve user work, stage intentional files, commit clearly, and avoid destructive history operations.
+description: "Use Git safely: inspect status/diffs, preserve user work, stage intentional files, commit clearly, and avoid destructive history operations."
 ---
 
 # Git Safety

package/global-config/skills/nestjs-engineering/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: nestjs-engineering
-description: Work on NestJS apps: modules, controllers, providers, DTO validation, guards, interceptors, persistence, and tests.
+description: "Work on NestJS apps: modules, controllers, providers, DTO validation, guards, interceptors, persistence, and tests."
 ---
 
 # Nestjs Engineering

package/global-config/skills/performance-engineering/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: performance-engineering
-description: Diagnose and improve performance using evidence: rendering, database, network, memory, caching, bundles, concurrency, and hot paths.
+description: "Diagnose and improve performance using evidence: rendering, database, network, memory, caching, bundles, concurrency, and hot paths."
 ---
 
 # Performance Engineering

package/global-config/skills/react-native-engineering/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: react-native-engineering
-description: Work on React Native/Expo apps: components, hooks, navigation, styling, APIs, native modules, Android/iOS build failures, platform behavior, and performance with version-aware verification.
+description: "Work on React Native/Expo apps: components, hooks, navigation, styling, APIs, native modules, Android/iOS build failures, platform behavior, and performance with version-aware verification."
 ---
 
 # React Native Engineering

package/global-config/skills/rest-api-design/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rest-api-design
-description: Design/review REST APIs: resources, methods, status codes, pagination, validation, errors, versioning, and idempotency.
+description: "Design/review REST APIs: resources, methods, status codes, pagination, validation, errors, versioning, and idempotency."
 ---
 
 # Rest Api Design

package/global-config/skills/ui-ux-engineering/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ui-ux-engineering
-description: Improve production UI/UX: hierarchy, responsive layout, components, forms, states, accessibility, realistic content, and design consistency.
+description: "Improve production UI/UX: hierarchy, responsive layout, components, forms, states, accessibility, realistic content, and design consistency."
 ---
 
 # Ui Ux Engineering

package/lib/adaptive-context-budget.mjs

@@ -0,0 +1,97 @@
+const ROLE_TARGETS = Object.freeze({
+  fast: {
+    architect: 8_000,
+    "plan-checker": 6_000,
+    executor: 6_000,
+    debugger: 8_000,
+    verifier: 4_500,
+    "integration-verifier": 8_000,
+    "visual-verifier": 5_000,
+    reviewer: 5_000,
+    critic: 6_000,
+    "codebase-mapper": 6_000,
+    researcher: 6_000,
+    "merge-arbiter": 8_000,
+  },
+  standard: {
+    architect: 12_000,
+    "plan-checker": 10_000,
+    executor: 11_000,
+    debugger: 14_000,
+    verifier: 8_000,
+    "integration-verifier": 12_000,
+    "visual-verifier": 8_000,
+    reviewer: 8_000,
+    critic: 10_000,
+    "codebase-mapper": 10_000,
+    researcher: 10_000,
+    "merge-arbiter": 12_000,
+  },
+  deep: {
+    architect: 30_000,
+    "plan-checker": 24_000,
+    executor: 26_000,
+    debugger: 32_000,
+    verifier: 20_000,
+    "integration-verifier": 30_000,
+    "visual-verifier": 18_000,
+    reviewer: 20_000,
+    critic: 24_000,
+    "codebase-mapper": 28_000,
+    researcher: 24_000,
+    "merge-arbiter": 30_000,
+  },
+})
+
+function clamp(value, fallback, min, max) {
+  const parsed = Number(value)
+  if (!Number.isFinite(parsed)) return fallback
+  return Math.max(min, Math.min(max, Math.trunc(parsed)))
+}
+
+export function adaptiveContextBudget(taskPolicy = {}, role = "executor", attempt = 1, options = {}) {
+  const base = clamp(
+    taskPolicy.contextBudget ?? taskPolicy.profile?.contextBudget,
+    20_000,
+    4_000,
+    48_000,
+  )
+  const profile = String(taskPolicy.executionProfile || taskPolicy.profile?.name || "standard")
+  const highRisk = taskPolicy.risk === "high" || taskPolicy.risk === "critical"
+
+  // High-risk work keeps the original evidence budget. Turbo mode must not trade
+  // away security/payment/schema evidence for latency.
+  if (highRisk || options.disabled === true) {
+    return {
+      schemaVersion: 1,
+      budget: base,
+      baseBudget: base,
+      adaptive: false,
+      reason: highRisk ? "high-risk-preserves-base-budget" : "disabled",
+    }
+  }
+
+  const table = ROLE_TARGETS[profile] || ROLE_TARGETS.standard
+  const target = clamp(table?.[role], base, 4_000, base)
+  const normalizedAttempt = Math.max(1, Math.trunc(Number(attempt || 1)))
+
+  // Failed attempts expand deterministically back toward the policy ceiling.
+  let budget = target
+  if (normalizedAttempt === 2) budget = Math.min(base, Math.max(target, Math.round(target * 1.5)))
+  else if (normalizedAttempt >= 3) budget = base
+
+  if (options.contextInsufficient === true) {
+    budget = Math.min(base, Math.max(budget, Math.round(target * 1.75)))
+  }
+
+  return {
+    schemaVersion: 1,
+    budget,
+    baseBudget: base,
+    adaptive: budget < base,
+    profile,
+    role,
+    attempt: normalizedAttempt,
+    reason: budget < base ? "role-bounded-expand-on-failure" : "policy-ceiling",
+  }
+}

package/lib/affected-tests.mjs

@@ -0,0 +1,260 @@
+import { existsSync } from "node:fs"
+import { readFile, readdir, stat } from "node:fs/promises"
+import path from "node:path"
+import { spawnSync } from "node:child_process"
+import { runtimeWorkspaceFingerprint } from "./workspace-fingerprint.mjs"
+
+const TEST_RE = /(?:^|[/.\\])(?:__tests__|tests?|spec)(?:[/.\\]|$)|\.(?:test|spec|e2e-spec)\.[cm]?[jt]sx?$/i
+const SOURCE_EXT = new Set([".js",".jsx",".mjs",".cjs",".ts",".tsx",".py",".java",".kt",".kts",".cs",".go",".rs",".dart",".swift"])
+const SKIP = new Set([".git","node_modules",".next","dist","build","coverage",".venv","venv","target","Pods","DerivedData",".gradle",".ues-cache",".ues-work",".ues-sandboxes",".ues-traces",".ues-learning",".ues-dashboard",".ues-memory",".ues-evals"])
+const AFFECTED_TEST_CACHE = new Map()
+const AFFECTED_TEST_INFLIGHT = new Map()
+
+function git(root, args) {
+  return spawnSync("git", args, { cwd: root, encoding: "utf8", maxBuffer: 8 * 1024 * 1024 })
+}
+
+function normalize(file) {
+  return String(file || "").replaceAll("\\", "/").replace(/^\.\//, "")
+}
+
+function stem(file) {
+  return path.basename(file)
+    .replace(/\.(?:test|spec|e2e-spec)(?=\.)/i, "")
+    .replace(/\.[^.]+$/, "")
+    .toLowerCase()
+}
+
+function tokens(file) {
+  return [...new Set(normalize(file).toLowerCase().split(/[^a-z0-9]+/).filter((x) => x.length >= 3))]
+}
+
+async function walk(root, options = {}) {
+  const maxFiles = Math.max(200, Number(options.maxFiles || 6000))
+  const rows = []
+  async function visit(dir, depth) {
+    if (rows.length >= maxFiles || depth > 14) return
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => [])
+    for (const entry of entries) {
+      if (rows.length >= maxFiles) break
+      if (entry.isDirectory() && SKIP.has(entry.name)) continue
+      const full = path.join(dir, entry.name)
+      if (entry.isDirectory()) await visit(full, depth + 1)
+      else if (entry.isFile()) rows.push(full)
+    }
+  }
+  await visit(root, 0)
+  return rows
+}
+
+export function gitChangedFiles(root = process.cwd()) {
+  root = path.resolve(root)
+  const inside = git(root, ["rev-parse", "--is-inside-work-tree"])
+  if (inside.status !== 0) return []
+
+  const names = new Set()
+  for (const args of [
+    ["diff", "--name-only", "--"],
+    ["diff", "--cached", "--name-only", "--"],
+    ["ls-files", "--others", "--exclude-standard"],
+  ]) {
+    const result = git(root, args)
+    if (result.status !== 0) continue
+    for (const row of String(result.stdout || "").split(/\r?\n/)) {
+      const file = normalize(row.trim())
+      if (file) names.add(file)
+    }
+  }
+  return [...names]
+}
+
+function scoreTest(testFile, changedFile, content = "") {
+  const test = normalize(testFile).toLowerCase()
+  const changed = normalize(changedFile).toLowerCase()
+  let score = 0
+  const reasons = []
+  const changedStem = stem(changed)
+  const testStem = stem(test)
+
+  if (changedStem && testStem.includes(changedStem)) {
+    score += 35
+    reasons.push("same-stem")
+  }
+  const testDir = path.posix.dirname(test)
+  const changedDir = path.posix.dirname(changed)
+  if (testDir === changedDir) {
+    score += 20
+    reasons.push("same-directory")
+  } else if (testDir.startsWith(changedDir + "/") || changedDir.startsWith(testDir + "/")) {
+    score += 10
+    reasons.push("nearby-directory")
+  }
+
+  const changedTokens = tokens(changed)
+  const overlap = changedTokens.filter((token) => test.includes(token)).length
+  if (overlap) {
+    score += Math.min(20, overlap * 4)
+    reasons.push("path-token-overlap")
+  }
+
+  const base = path.basename(changed).replace(/\.[^.]+$/, "")
+  if (base.length >= 3 && content.toLowerCase().includes(base.toLowerCase())) {
+    score += 25
+    reasons.push("content-reference")
+  }
+
+  return { score, reasons }
+}
+
+async function nearestPackage(root, file) {
+  let dir = path.dirname(path.resolve(root, file))
+  const base = path.resolve(root)
+  while (dir === base || dir.startsWith(base + path.sep)) {
+    const packageFile = path.join(dir, "package.json")
+    if (existsSync(packageFile)) {
+      try {
+        return { dir, json: JSON.parse(await readFile(packageFile, "utf8")) }
+      } catch {}
+    }
+    if (dir === base) break
+    dir = path.dirname(dir)
+  }
+  return null
+}
+
+function packageManager(root) {
+  if (existsSync(path.join(root, "pnpm-lock.yaml"))) return "pnpm"
+  if (existsSync(path.join(root, "yarn.lock"))) return "yarn"
+  if (existsSync(path.join(root, "bun.lock")) || existsSync(path.join(root, "bun.lockb"))) return "bun"
+  return "npm"
+}
+
+function targetedCommand(root, pkg, testFile) {
+  const script = String(pkg?.json?.scripts?.test || "")
+  if (!script || !/(jest|vitest|node\s+--test|tsx\s+--test)/i.test(script)) return null
+  const manager = packageManager(root)
+  const relativeDir = normalize(path.relative(root, pkg.dir)) || "."
+  const relativeTest = normalize(path.relative(pkg.dir, path.resolve(root, testFile)))
+
+  if (manager === "pnpm") {
+    return { command: "pnpm", args: ["--dir", relativeDir, "run", "test", "--", relativeTest], confidence: "high" }
+  }
+  if (manager === "yarn") {
+    return { command: "yarn", args: ["--cwd", relativeDir, "test", relativeTest], confidence: "high" }
+  }
+  if (manager === "bun") {
+    return { command: "bun", args: ["--cwd", relativeDir, "run", "test", "--", relativeTest], confidence: "high" }
+  }
+  return { command: "npm", args: ["--prefix", relativeDir, "test", "--", relativeTest], confidence: "high" }
+}
+
+export async function resolveAffectedTests(root = process.cwd(), options = {}) {
+  root = path.resolve(root)
+  const changed = (options.changedFiles || gitChangedFiles(root))
+    .map(normalize)
+    .filter((file) => SOURCE_EXT.has(path.extname(file).toLowerCase()) && !TEST_RE.test(file))
+
+  if (!changed.length) {
+    return {
+      schemaVersion: 1,
+      root,
+      changedFiles: [],
+      tests: [],
+      suggestedCommands: [],
+      truncated: false,
+      cacheHit: false,
+    }
+  }
+
+  const limit = Math.max(1, Math.min(40, Number(options.limit || 12)))
+  let fingerprint = String(options.workspaceFingerprint || "")
+  if (!fingerprint || fingerprint === "unknown") {
+    try { fingerprint = runtimeWorkspaceFingerprint(root) } catch { fingerprint = "" }
+  }
+  if (fingerprint === "unknown") fingerprint = ""
+
+  const cacheKey = JSON.stringify([
+    root,
+    fingerprint || "no-fingerprint",
+    [...changed].sort(),
+    Number(options.maxFiles || 6000),
+    limit,
+  ])
+
+  if (fingerprint && AFFECTED_TEST_CACHE.has(cacheKey)) {
+    return { ...AFFECTED_TEST_CACHE.get(cacheKey), cacheHit: true }
+  }
+  if (fingerprint && AFFECTED_TEST_INFLIGHT.has(cacheKey)) {
+    const value = await AFFECTED_TEST_INFLIGHT.get(cacheKey)
+    return { ...value, cacheHit: true, cacheCoalesced: true }
+  }
+
+  const compute = async () => {
+    const files = await walk(root, options)
+    const tests = files
+      .map((file) => normalize(path.relative(root, file)))
+      .filter((file) => TEST_RE.test(file))
+
+    const ranked = []
+    for (const testFile of tests) {
+      const info = await stat(path.join(root, testFile)).catch(() => null)
+      const content = info?.size && info.size <= 512 * 1024
+        ? await readFile(path.join(root, testFile), "utf8").catch(() => "")
+        : ""
+      let best = { score: 0, reasons: [], changedFile: null }
+      for (const changedFile of changed) {
+        const current = scoreTest(testFile, changedFile, content)
+        if (current.score > best.score) best = { ...current, changedFile }
+      }
+      if (best.score > 0) ranked.push({ path: testFile, ...best })
+    }
+
+    ranked.sort((a, b) => b.score - a.score || a.path.localeCompare(b.path))
+    const selected = ranked.slice(0, limit)
+    const suggestedCommands = []
+    const seen = new Set()
+
+    for (const item of selected.slice(0, 8)) {
+      const pkg = await nearestPackage(root, item.path)
+      const command = pkg ? targetedCommand(root, pkg, item.path) : null
+      if (!command) continue
+      const key = JSON.stringify([command.command, command.args])
+      if (seen.has(key)) continue
+      seen.add(key)
+      suggestedCommands.push({ ...command, test: item.path })
+    }
+
+    return {
+      schemaVersion: 1,
+      root,
+      changedFiles: changed,
+      tests: selected,
+      suggestedCommands,
+      truncated: ranked.length > selected.length,
+      cacheHit: false,
+    }
+  }
+
+  const pending = compute()
+  if (fingerprint) AFFECTED_TEST_INFLIGHT.set(cacheKey, pending)
+
+  try {
+    const result = await pending
+    if (fingerprint) {
+      AFFECTED_TEST_CACHE.set(cacheKey, result)
+      while (AFFECTED_TEST_CACHE.size > 24) {
+        const oldest = AFFECTED_TEST_CACHE.keys().next().value
+        if (!oldest) break
+        AFFECTED_TEST_CACHE.delete(oldest)
+      }
+    }
+    return result
+  } finally {
+    if (fingerprint) AFFECTED_TEST_INFLIGHT.delete(cacheKey)
+  }
+}
+
+export function clearAffectedTestCache() {
+  AFFECTED_TEST_CACHE.clear()
+  AFFECTED_TEST_INFLIGHT.clear()
+}