code-foundry 1.47.5 → 1.48.1

package/.github/workflows/ci.yml

@@ -119,6 +119,9 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   lint:
     name: Lint
     if: vars.CI_BILLING_PAUSED != 'true'
@@ -180,6 +183,9 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   type-check:
     name: Type-Check
     if: vars.CI_BILLING_PAUSED != 'true'
@@ -246,6 +252,9 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   build:
     name: Build
     if: vars.CI_BILLING_PAUSED != 'true'
@@ -311,3 +320,6 @@ jobs:
           include-hidden-files: true
           if-no-files-found: error
           retention-days: 14
+
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save

package/.github/workflows/cloudflare-delivery.yml

@@ -243,7 +243,14 @@ jobs:
             isAbsolute(workspaceRelative) ||
             workspaceRelative === '..' ||
             workspaceRelative.startsWith(`..${sep}`)
-          if (!existsSync('turbo.json') && !existsSync('turbo.jsonc')) {
+          // Vite+ repositories are not served by this Turbo-only check.
+          const config = resolve(workspace, '.github/code-foundry.yml')
+          const optedIntoVitePlus =
+            existsSync(config) &&
+            /^monorepo_tool:\s*["']?vite-plus["']?\s*(?:#.*)?$/m.test(readFileSync(config, 'utf8'))
+          if (optedIntoVitePlus) {
+            conservative('monorepo_tool is vite-plus')
+          } else if (!existsSync('turbo.json') && !existsSync('turbo.jsonc')) {
             conservative('Turbo config not found')
           } else if (outsideWorkspace) {
             conservative('working-directory is outside the workspace')

package/.github/workflows/cloudflare-deploy.yml

@@ -171,7 +171,14 @@ jobs:
             isAbsolute(workspaceRelative) ||
             workspaceRelative === '..' ||
             workspaceRelative.startsWith(`..${sep}`)
-          if (!existsSync('turbo.json') && !existsSync('turbo.jsonc')) {
+          // Vite+ repositories are not served by this Turbo-only check.
+          const config = resolve(workspace, '.github/code-foundry.yml')
+          const optedIntoVitePlus =
+            existsSync(config) &&
+            /^monorepo_tool:\s*["']?vite-plus["']?\s*(?:#.*)?$/m.test(readFileSync(config, 'utf8'))
+          if (optedIntoVitePlus) {
+            conservative('monorepo_tool is vite-plus')
+          } else if (!existsSync('turbo.json') && !existsSync('turbo.jsonc')) {
             conservative('Turbo config not found')
           } else if (outsideWorkspace) {
             conservative('working-directory is outside the workspace')

package/.github/workflows/eval.yml

@@ -124,3 +124,6 @@ jobs:
             eval-results/summary.json
           if-no-files-found: error
           retention-days: 14
+
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save

package/.github/workflows/test.yml

@@ -161,6 +161,9 @@ jobs:
           if-no-files-found: ignore
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   performance:
     name: Performance
     if: vars.CI_BILLING_PAUSED != 'true'
@@ -247,6 +250,9 @@ jobs:
           if-no-files-found: ignore
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   integration:
     name: Integration
     if: vars.CI_BILLING_PAUSED != 'true' && inputs.unit-only != true
@@ -317,6 +323,9 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   e2e:
     name: E2E
     if: vars.CI_BILLING_PAUSED != 'true' && inputs.unit-only != true
@@ -410,6 +419,9 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   smoke:
     name: Smoke
     if: vars.CI_BILLING_PAUSED != 'true' && inputs.unit-only != true
@@ -479,3 +491,6 @@ jobs:
           include-hidden-files: true
           if-no-files-found: error
           retention-days: 14
+
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save

package/.github/workflows/validation-billing.yml

@@ -469,6 +469,9 @@ jobs:
               if-no-files-found: error
               retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   lint:
     name: Lint
     if: vars.CI_BILLING_PAUSED != 'true'
@@ -530,6 +533,9 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   type-check:
     name: Type-Check
     if: vars.CI_BILLING_PAUSED != 'true'
@@ -596,6 +602,9 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   unit:
     name: Unit
     if: vars.CI_BILLING_PAUSED != 'true'
@@ -682,6 +691,9 @@ jobs:
           if-no-files-found: ignore
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   e2e:
     name: E2E
     if: vars.CI_BILLING_PAUSED != 'true' && inputs.mode == 'audit'
@@ -775,11 +787,15 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+      - name: Save Vite+ task cache
+        uses: ./.github/actions/vite-plus-cache-save
+
   # Profile and dependency audit merged into one job. The split orchestrators
   # run a profile job that feeds an audit matrix; here the language blocks run
   # sequentially, driven directly by the profile step's outputs, so the second
   # runner spin-up disappears. Python requirements run in one loop inside the
   # audit step because a matrix cannot follow preceding steps in the same job.
+
   audit:
     name: Audit
     if: vars.CI_BILLING_PAUSED != 'true' && inputs.mode == 'audit'

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.48.1](https://github.com/0xPlayerOne/code-foundry/compare/v1.48.0...v1.48.1) (2026-10-16)
+
+
+### Bug Fixes
+
+* vite-plus-cache-post-job-save ([#765](https://github.com/0xPlayerOne/code-foundry/issues/765)) ([3f82e85](https://github.com/0xPlayerOne/code-foundry/commit/3f82e850f5c09af6cea4de6f1a791d098bbd2f6e))
+
+## [1.48.0](https://github.com/0xPlayerOne/code-foundry/compare/v1.47.5...v1.48.0) (2026-10-16)
+
+
+### Features
+
+* add opt-in Vite+ task runner support ([#763](https://github.com/0xPlayerOne/code-foundry/issues/763)) ([f7970cd](https://github.com/0xPlayerOne/code-foundry/commit/f7970cdf1c1880aaee159d2de79ba043f93711a7))
+
 ## [1.47.5](https://github.com/0xPlayerOne/code-foundry/compare/v1.47.4...v1.47.5) (2026-10-15)
 
 
@@ -126,23 +140,9 @@
 
 * **release:** treat ref-creation errors in the REST fallback as non-fatal ([#727](https://github.com/0xPlayerOne/code-foundry/issues/727)) ([75ea614](https://github.com/0xPlayerOne/code-foundry/commit/75ea61465e7c4cacd39e3aa8c52df93c2ea9bf03))
 
-## [1.44.9](https://github.com/0xPlayerOne/code-foundry/compare/v1.44.8...v1.44.9) (2026-10-06)
-
-
-### Bug Fixes
-
-* **release:** make the REST fallback draft-aware and idempotent ([#725](https://github.com/0xPlayerOne/code-foundry/issues/725)) ([c29da6e](https://github.com/0xPlayerOne/code-foundry/commit/c29da6efb919d68a568c2328eea2c2f7654334fe))
-
-## [1.44.8](https://github.com/0xPlayerOne/code-foundry/compare/v1.44.7...v1.44.8) (2026-10-06)
-
-
-### Bug Fixes
-
-* **release:** query the version-PR branch directly in the REST fallback ([#722](https://github.com/0xPlayerOne/code-foundry/issues/722)) ([b38f394](https://github.com/0xPlayerOne/code-foundry/commit/b38f394c0ca6438117fdd2f45bd106b0b145a0f9))
-
 <!-- code-foundry: packaged changelog -->
 
 ---
 
-This packaged changelog lists the 20 most recent releases; 247 older releases are omitted to keep the package small.
+This packaged changelog lists the 20 most recent releases; 249 older releases are omitted to keep the package small.
 See the [full changelog](https://github.com/0xPlayerOne/code-foundry/blob/main/CHANGELOG.md) for the complete history.

package/docs/CACHING.md

@@ -22,6 +22,90 @@ Non-Turborepo repositories do not need either setting. Deployment to Vercel is
 not required. Custom workflows can pass these values to Turbo directly when
 the repository's task graph benefits from remote reuse.
 
+## Vite+ local task cache (opt-in)
+
+Repositories that run their workspace tasks with Vite+ (`vp run`, `vpr`) can
+opt in with `monorepo_tool: vite-plus` in `.github/code-foundry.yml`. Turbo
+stays the default for every repository that does not set it.
+
+When opted in, the setup action:
+
+- stops treating a `turbo.json` as the active runner, so no Turborepo cache or
+  remote-cache step runs;
+- restores `node_modules/.vite/task-cache` as its last step, after Install and
+  after every step that archives `node_modules` (Install can replace it);
+- publishes a cache path, key, and save-intent contract for the explicit
+  `.github/actions/vite-plus-cache-save` action to use after repository tasks;
+- saves it push-only, so pull requests and scheduled runs cannot poison it;
+- keeps it out of the generic JavaScript build-state archive.
+
+The generated CI, test, eval, and billing workflows call the save action at the
+end of each task job. Custom workflows that use `.github/actions/setup` must
+also call it after their Vite+ tasks complete; it reads the setup contract from
+the job environment. A job can disable saving with `cache-save: false` on every
+applicable setup call. With multiple setup calls in one job, save intent is
+combined so an enabled Vite+ task setup is not overridden by a later disabled
+setup. The setup action also exposes `vite-plus-cache-path`,
+`vite-plus-cache-key`, and `vite-plus-cache-save` outputs for workflows that
+prefer to pass these values explicitly to the save action.
+
+Keys are `<namespace>-<workflow>-<job>-<lockfiles>-<vite.config>-<run id>-<attempt>`,
+so every push saves a refreshed entry (more storage than a fixed key). Restore
+keys fall back by lockfiles, job, then any job, but never leave the namespace
+`vite-plus-v1-<OS>-<arch>-node<version>-bun<version>-vp<version>`, because Vite
+Task does not fingerprint the Node or Bun binary. If the `vite-plus` version
+cannot be resolved, nothing is restored or saved.
+
+If `VITE_CACHE_PATH` (absolute, from any environment source) is set, Vite+
+writes its cache there and the setup action caches that directory too.
+
+Vite+ has no remote cache and this repository does not configure one.
+
+Known limits (not parity with Turbo):
+
+- Vite Task keeps one cache entry per task, so alternating between states
+  (A, B, A) re-runs the task instead of hitting the cache.
+- `package.json` scripts are not cached unless the consumer sets
+  `run.cache.scripts: true` in its root `vite.config.ts` or passes `--cache` to
+  `vp run`. Code Foundry does not change consumer config. Commands that read no
+  files, such as a bare `echo`, are never cached.
+- Tasks reading files that only Bun loads may need explicit input globs in the
+  consumer's Vite+ config (untested here).
+- `cloudflare-deploy.yml` and `cloudflare-delivery.yml` keep a Turbo-only
+  affected check. With `monorepo_tool: vite-plus` they skip it and deploy
+  conservatively, even with a leftover `turbo.json`.
+
+### Affected packages
+
+`npx code-foundry affected --base <ref> --head <ref>` prints the affected
+packages as JSON (`tool`, `packages`, `removedPackages`, `all`, `conservative`,
+`reason`, `filterArgs`). Both refs must be present in the clone (use a
+non-shallow checkout or fetch the base commit).
+
+- Turbo repositories use `turbo query affected --packages`; this module does
+  not parse their workspace.
+- Vite+ repositories compute the set from `git diff base...head` and the
+  workspace graphs read from the committed trees at both refs, because Vite+
+  has no equivalent query. Each changed file marks the package that owns it;
+  dependents are added transitively over the union of both graphs' edges, so
+  deleted, renamed, moved, and re-wired packages still select their dependents.
+  `removedPackages` lists selected packages that no longer exist at the head.
+- Any changed file that no workspace package owns selects every package
+  (`all: true`): lockfiles, root manifest, config, scripts, docs, templates. A
+  build may read any of them. Only `affected_ignore` in `.github/code-foundry.yml`
+  (comma-separated globs, for example `README.md, docs/**`) skips unowned files.
+- Anything the module cannot evaluate faithfully makes the result
+  conservative (`all: true`, `conservative: true`): no runner, a git or Turbo
+  failure, a malformed or unnamed workspace manifest at either ref, duplicate
+  package names, or workspace syntax it does not support (brace, bracket, or
+  extglob patterns). Supported syntax is `package.json` `workspaces` (array or
+  `{ packages }`) and pnpm `packages:` as a block or flow list, with `*`, `**`,
+  `?`, and `!` exclusions.
+- `--tool turbo|vite-plus` overrides `monorepo_tool` for one invocation.
+- For Vite+, `filterArgs` is ready to append to `vp run`. When `all` is true
+  run with `-r` instead, and when `packages` is empty skip the run: an empty
+  filter list would otherwise select every package.
+
 ## Runner selection
 
 Lightweight detection, orchestration, audits, and release metadata jobs can use

package/docs/CONFIGURATION.md

@@ -289,6 +289,19 @@ behavior:
   `TURBO_TEAM`.
 - `TURBO_TOKEN` and `TURBO_TEAM` provide the Turborepo remote-cache
   credentials.
+- `monorepo_tool: auto`, `turbo`, or `vite-plus` selects the workspace task
+  runner. `auto` (the default) is Turbo when a `turbo.json` or `turbo.jsonc`
+  exists and no runner otherwise, exactly as before Vite+ support. Vite+ is
+  opt-in: only `monorepo_tool: vite-plus` selects it, and it then takes
+  precedence over a turbo config. `doctor` warns when the selected runner has
+  no matching evidence in the repository.
+- `cache-vite-plus: auto`, `true`, or `false` is an input of the setup action
+  (not a config key). It controls the local Vite+ task cache only when
+  `monorepo_tool: vite-plus` is set.
+- Custom workflows using the setup action must add
+  `.github/actions/vite-plus-cache-save` after task execution. The generated
+  Code Foundry workflows already include this save boundary; see
+  [Caching and remote caching](CACHING.md).
 
 Use these controls only after measuring a repeatable benefit. See [Caching and
 remote caching](CACHING.md).

package/docs/README.md

@@ -33,7 +33,7 @@ details before copying any guide elsewhere.
 - [Declarative fleet rollouts](fleet-rollouts.md) — inventory, canaries, staged upgrades, and recovery.
 - [Fleet release eligibility](fleet-release-eligibility.md) — require verified release evidence before upgrades.
 - [Verified Cloudflare delivery](cloudflare-delivery.md) — build, verify, canary, and promote Worker versions.
-- [Caching and remote caching](CACHING.md) — configure package, build, and Turborepo caching.
+- [Caching and remote caching](CACHING.md) — configure package, build, Turborepo, and opt-in Vite+ caching.
 
 ## Repository-specific documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-foundry",
-  "version": "1.47.5",
+  "version": "1.48.1",
   "description": "A fast, language-aware repository factory for agent-ready workflows, testing, security, and release automation.",
   "homepage": "https://github.com/0xPlayerOne/code-foundry#readme",
   "bugs": {
@@ -18,6 +18,7 @@
     "src",
     "docs",
     ".github",
+    "!.github/actions/**",
     ".githooks",
     ".editorconfig",
     ".gitattributes",

package/src/cli.mjs

@@ -7,7 +7,7 @@ import { fileURLToPath } from 'node:url'
 
 const packageRoot = resolve(fileURLToPath(new URL('..', import.meta.url)))
 
-/** @typedef {{ target: string, root: string, source: string, dryRun: boolean, force: boolean, github: boolean, createPr: boolean, exclude: string[], base: string, head: string, tag: string, workflow: string, mode: string, version: string, versionExplicit: boolean, repository: string, expectedSha: string, assets: string[], rootProvided: boolean, releaseSubcommand?: string, fleetSubcommand?: string, integritySubcommand?: 'settings'|'release'|'manifest', ciSubcommand?: 'pause'|'resume'|'status' }} Options */
+/** @typedef {{ target: string, root: string, source: string, dryRun: boolean, force: boolean, github: boolean, createPr: boolean, exclude: string[], base: string, head: string, tag: string, workflow: string, mode: string, version: string, versionExplicit: boolean, repository: string, expectedSha: string, assets: string[], rootProvided: boolean, tool: string, headProvided: boolean, releaseSubcommand?: string, fleetSubcommand?: string, integritySubcommand?: 'settings'|'release'|'manifest', ciSubcommand?: 'pause'|'resume'|'status' }} Options */
 /** @typedef {{ command: string, options: Options }} ParsedArgs */
 
 const usage = `code-foundry — initialize and maintain agent-ready repositories
@@ -18,6 +18,7 @@ Usage:
   npx code-foundry doctor [--target PATH]
   npx code-foundry plan [--target PATH] [--tier fast|audit] [--changed] [--base REF] [--json]
   npx code-foundry check [--target PATH] [--tier fast|audit] [--changed] [--base REF] [--timeout SECONDS] [--json]
+  npx code-foundry affected [--target PATH] [--base REF] [--head REF] [--tool auto|turbo|vite-plus]
   npx code-foundry ci pause|resume|status [--target PATH]
   npx code-foundry release reconcile [--github] [--base BRANCH] [--head BRANCH]
   npx code-foundry release hook --tag TAG --workflow WORKFLOW
@@ -37,7 +38,8 @@ Options:
   --force         Replace protected standard documents
   --github        Apply a verified fast-forward through GitHub
   --base BRANCH   Release source branch (default: main)
-  --head BRANCH   Branch to reconcile (default: staging)
+  --head BRANCH   Branch to reconcile (default: staging; HEAD for affected)
+  --tool TOOL     Task runner for affected: auto, turbo, or vite-plus (default: auto)
   --tag TAG       Published release tag for a post-release hook
   --workflow FILE  Workflow to dispatch for a post-release hook
   --mode MODE     auto, workflow-dispatch, release-event, or disabled
@@ -78,6 +80,8 @@ function parseArgs(argv) {
     tag: '',
     workflow: '',
     mode: 'auto',
+    tool: 'auto',
+    headProvided: false,
     version: `v${readPackageVersion(packageRoot)}`,
     versionExplicit: false,
     repository: '',
@@ -128,8 +132,15 @@ function parseArgs(argv) {
     else if (arg === '--force') options.force = true
     else if (arg === '--github') options.github = true
     else if (arg === '--base') options.base = argv.shift() ?? fail('--base requires a branch')
-    else if (arg === '--head') options.head = argv.shift() ?? fail('--head requires a branch')
-    else if (arg === '--tag') options.tag = argv.shift() ?? fail('--tag requires a tag')
+    else if (arg === '--head') {
+      options.head = argv.shift() ?? fail('--head requires a branch')
+      options.headProvided = true
+    } else if (arg === '--tool') {
+      if (command !== 'affected') fail('--tool is only supported by the affected command')
+      options.tool = argv.shift() ?? fail('--tool requires auto, turbo, or vite-plus')
+      if (!['auto', 'turbo', 'vite-plus'].includes(options.tool))
+        fail(`unsupported --tool: ${options.tool}; use auto, turbo, or vite-plus`)
+    } else if (arg === '--tag') options.tag = argv.shift() ?? fail('--tag requires a tag')
     else if (arg === '--repo') {
       if (command !== 'release-integrity')
         fail('--repo is only supported by release-integrity commands')
@@ -204,6 +215,18 @@ async function main() {
       console.error(`code-foundry: ${error instanceof Error ? error.message : String(error)}`)
       process.exitCode = 1
     }
+  } else if (command === 'affected') {
+    try {
+      const { affectedPackages } = await import('./lib/task-filters.mjs')
+      const result = affectedPackages(target, {
+        base: options.base,
+        head: options.headProvided ? options.head : 'HEAD',
+        tool: options.tool,
+      })
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      fail(error instanceof Error ? error.message : String(error))
+    }
   } else if (command === 'release') {
     try {
       const {

package/src/commands/doctor.mjs

@@ -4,7 +4,7 @@ import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs'
 import { join, resolve, isAbsolute } from 'node:path'
 import { spawnSync } from 'node:child_process'
 import { includesValue, readConfig } from '../lib/config.mjs'
-import { recommendRunners, resolveProfile } from '../lib/profile.mjs'
+import { recommendRunners, resolveMonorepoTool, resolveProfile } from '../lib/profile.mjs'
 import { packageManagerForLockfile } from '../lib/lockfiles.mjs'
 import { doctorGithub } from '../lib/github-doctor.mjs'
 import { isGeneratedEventCaller } from './sync.mjs'
@@ -38,6 +38,10 @@ export function doctor(root, options = {}) {
         : 'Toolchain: native (mise not configured).'
     )
   }
+  const monorepoTool = resolveMonorepoTool(target, config)
+  for (const message of monorepoTool.warnings) warn(message)
+  if (monorepoTool.tool === 'vite-plus')
+    console.log(`Task runner: vite-plus (${monorepoTool.reason}).`)
   const hooks = git(target, ['config', '--get', 'core.hooksPath'])
   if (hooks !== '.githooks') warn('Git hooks are not enabled; run `npx code-foundry init`')
   // A correctly enabled hook that enforces nothing is the failure this check

package/src/commands/sync.mjs

@@ -2168,6 +2168,7 @@ function createDefaultConfig(root, source, configuredWorkflow) {
     coverage_metrics: 'lines',
     coverage_report: '',
     turbo_remote: 'auto',
+    monorepo_tool: 'auto',
     release_type: detectPackageManager(root) === 'none' ? 'auto' : 'node',
     npm_publish: 'false',
     post_release: 'false',

package/src/lib/profile.mjs

@@ -160,3 +160,123 @@ function detectReleaseType(root) {
 }
 
 export { includesValue }
+
+/**
+ * Workspace task runner. `auto` (default) is Turbo when a turbo config exists,
+ * else none; Vite+ needs an explicit `monorepo_tool: vite-plus`.
+ */
+export const MONOREPO_TOOLS = ['auto', 'turbo', 'vite-plus']
+
+/** @typedef {'turbo'|'vite-plus'|'none'} ResolvedTool */
+/** @typedef {{ configured: string, tool: ResolvedTool, reason: string, warnings: string[] }} ToolResolution */
+
+/** @param {string} root @returns {Record<string, any> | null} */
+function readPackageJson(root) {
+  try {
+    return JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+/** @param {string} root */
+export function hasTurboConfig(root) {
+  return existsSync(join(root, 'turbo.json')) || existsSync(join(root, 'turbo.jsonc'))
+}
+
+/**
+ * Whether a shell command invokes the Vite+ task runner. `vp run ...` and the
+ * `vpr` shorthand populate the task cache; plain `vp build` or `vp test` do
+ * not, so they are intentionally not matched.
+ * @param {string} command
+ */
+export function commandUsesVitePlus(command) {
+  return /(?:^|[\s;&|(])(?:vp\s+(?:-C\s+\S+\s+)?run|vpr)(?:\s|$)/.test(command)
+}
+
+/** @param {string} command */
+export function commandUsesTurbo(command) {
+  return /\bturbo(?:\s|$)/.test(command)
+}
+
+/**
+ * Evidence that a repository declares Vite+: the `vite-plus` package in any
+ * dependency table or a script that runs `vp run` / `vpr`.
+ * @param {string} root
+ * @returns {{ declared: boolean, via: string[] }}
+ */
+export function detectVitePlus(root) {
+  const packageJson = readPackageJson(root)
+  /** @type {string[]} */
+  const via = []
+  if (!packageJson) return { declared: false, via }
+  for (const table of ['dependencies', 'devDependencies', 'optionalDependencies']) {
+    if (
+      packageJson[table] &&
+      typeof packageJson[table] === 'object' &&
+      packageJson[table]['vite-plus']
+    )
+      via.push(`${table}.vite-plus`)
+  }
+  const scripts =
+    packageJson.scripts && typeof packageJson.scripts === 'object' ? packageJson.scripts : {}
+  for (const [name, command] of Object.entries(scripts)) {
+    if (typeof command === 'string' && commandUsesVitePlus(command)) via.push(`scripts.${name}`)
+  }
+  return { declared: via.length > 0, via }
+}
+
+/**
+ * Resolve which task runner a repository uses. Never throws: invalid or
+ * unsatisfied configuration falls back to the legacy behavior and is reported
+ * in `warnings` so doctor can surface it.
+ * @param {string} root
+ * @param {Record<string, string>} [config] Defaults to .github/code-foundry.yml.
+ * @returns {ToolResolution}
+ */
+export function resolveMonorepoTool(
+  root,
+  config = readConfig(join(root, '.github/code-foundry.yml'))
+) {
+  /** @type {string[]} */
+  const warnings = []
+  let selected = (config.monorepo_tool ?? '').trim() || 'auto'
+  if (!MONOREPO_TOOLS.includes(selected)) {
+    warnings.push(
+      `unsupported monorepo_tool: ${selected}; use auto, turbo, or vite-plus. Falling back to auto.`
+    )
+    selected = 'auto'
+  }
+  const turbo = hasTurboConfig(root)
+
+  if (selected === 'vite-plus') {
+    const evidence = detectVitePlus(root)
+    if (!evidence.declared)
+      warnings.push(
+        'monorepo_tool: vite-plus but neither a vite-plus dependency nor a `vp run` script was found in package.json.'
+      )
+    return {
+      configured: selected,
+      tool: 'vite-plus',
+      reason: turbo
+        ? 'monorepo_tool: vite-plus (turbo config present but ignored)'
+        : 'monorepo_tool: vite-plus',
+      warnings,
+    }
+  }
+  if (selected === 'turbo') {
+    if (!turbo) warnings.push('monorepo_tool: turbo but no turbo.json or turbo.jsonc was found.')
+    return {
+      configured: selected,
+      tool: turbo ? 'turbo' : 'none',
+      reason: 'monorepo_tool: turbo',
+      warnings,
+    }
+  }
+  return {
+    configured: selected,
+    tool: turbo ? 'turbo' : 'none',
+    reason: turbo ? 'turbo config detected' : 'no task runner configured',
+    warnings,
+  }
+}