broader-vids 0.1.9 → 0.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "broader-vids",
3
- "version": "0.1.9",
3
+ "version": "0.1.11",
4
4
  "description": "Curated YouTube and Bilibili recommendations for Claude Code",
5
5
  "author": {
6
6
  "name": "Broader Vids contributors"
@@ -4,6 +4,7 @@
4
4
  const fs = require("node:fs");
5
5
  const os = require("node:os");
6
6
  const path = require("node:path");
7
+ const { pathToFileURL } = require("node:url");
7
8
  const { createHash, randomUUID } = require("node:crypto");
8
9
  const {
9
10
  withRuntimeUse,
@@ -132,23 +133,233 @@ function commandIndex(args) {
132
133
  function validateSetupArguments(args, index) {
133
134
  for (let item = index + 1; item < args.length; item += 1) {
134
135
  const value = args[item];
135
- if (value === "--asr" || value === "--evidence") continue;
136
+ if (["--asr", "--evidence", "--check"].includes(value)) continue;
136
137
  if (value === "--data-dir") {
137
138
  item += 1;
138
139
  continue;
139
140
  }
140
141
  if (value.startsWith("--data-dir=")) continue;
141
142
  throw new Error(
142
- "Use setup with optional --evidence, --asr, and --data-dir PATH.",
143
+ "Use setup with optional --evidence, --asr, --check, and --data-dir PATH.",
143
144
  );
144
145
  }
145
146
  }
146
147
 
147
- function invoke(command, args) {
148
+ function runtimeEnvironment() {
149
+ return Object.fromEntries(
150
+ Object.entries(process.env).filter(
151
+ ([name]) =>
152
+ ![
153
+ "PYTHONHOME",
154
+ "PYTHONPATH",
155
+ "__PYVENV_LAUNCHER__",
156
+ "UV_INTERNAL__PYTHONHOME",
157
+ ].includes(name.toUpperCase()),
158
+ ),
159
+ );
160
+ }
161
+
162
+ function environmentArguments(
163
+ runtime,
164
+ platform = process.platform,
165
+ linked = false,
166
+ ) {
167
+ if (platform === "win32" && runtime.includes(";"))
168
+ throw new Error(
169
+ "Python venv cannot use a Windows data path with a semicolon. Select a path without semicolons before setup.",
170
+ );
171
+ return platform === "win32"
172
+ ? [
173
+ "run",
174
+ "--no-project",
175
+ "--python",
176
+ ">=3.12",
177
+ "python",
178
+ "-m",
179
+ "venv",
180
+ "--without-pip",
181
+ linked ? "--symlinks" : "--copies",
182
+ runtime,
183
+ ]
184
+ : ["venv", "--allow-existing", "--python", ">=3.12", runtime];
185
+ }
186
+
187
+ function clearInterpreterEntries(runtime) {
188
+ for (const directory of [path.dirname(runtime), runtime]) {
189
+ try {
190
+ if (fs.lstatSync(directory).isSymbolicLink())
191
+ throw new Error(
192
+ "The managed runtime directory is a link. Setup stopped before removing interpreter entries.",
193
+ );
194
+ } catch (error) {
195
+ if (error.code !== "ENOENT") throw error;
196
+ }
197
+ }
198
+ if (!fs.existsSync(runtime)) return;
199
+ const config = fs
200
+ .readdirSync(runtime, { withFileTypes: true })
201
+ .find((entry) => entry.name.toLowerCase() === "pyvenv.cfg");
202
+ if (config?.isSymbolicLink())
203
+ throw new Error(
204
+ "The runtime configuration is a link. Setup left it unchanged.",
205
+ );
206
+ const scripts = path.join(runtime, "Scripts");
207
+ if (!fs.existsSync(scripts)) return;
208
+ const target = fs.realpathSync(scripts);
209
+ const relative = path.relative(fs.realpathSync(runtime), target);
210
+ if (relative.toLowerCase() !== "scripts")
211
+ throw new Error(
212
+ "The runtime Scripts directory resolves outside its managed location. Setup stopped before removing interpreter entries.",
213
+ );
214
+ for (const entry of fs.readdirSync(scripts, { withFileTypes: true })) {
215
+ if (
216
+ !entry.isDirectory() &&
217
+ /^(?:python[\dw]*\.(?:exe|dll)|vcruntime\d+(?:_\d+)?\.dll)$/i.test(
218
+ entry.name,
219
+ )
220
+ )
221
+ fs.unlinkSync(path.join(scripts, entry.name));
222
+ }
223
+ }
224
+
225
+ function checkRuntime(runtime, executable) {
226
+ const report = {
227
+ version: 1,
228
+ runtime,
229
+ executable,
230
+ creation_backend: process.platform === "win32" ? "stdlib-venv" : "uv-venv",
231
+ executable_linked: false,
232
+ status: "unverified",
233
+ reason: "",
234
+ };
235
+ let expectedIdentity;
236
+ try {
237
+ report.executable_linked = fs.lstatSync(executable).isSymbolicLink();
238
+ fs.statSync(path.join(runtime, "pyvenv.cfg"));
239
+ const entry = fs.statSync(runtime, { bigint: true });
240
+ expectedIdentity = [entry.dev.toString(), entry.ino.toString()];
241
+ } catch (error) {
242
+ if (error.code === "ENOENT")
243
+ return {
244
+ ...report,
245
+ status: "missing",
246
+ reason: "The interpreter or pyvenv.cfg is missing.",
247
+ };
248
+ return {
249
+ ...report,
250
+ status: "unusable",
251
+ reason: `The host cannot inspect the selected runtime (${error.code}). Request access to this same directory.`,
252
+ };
253
+ }
254
+ const result = spawnSync(
255
+ executable,
256
+ [
257
+ "-I",
258
+ "-B",
259
+ "-c",
260
+ [
261
+ "import json,sys,pathlib,os",
262
+ 'result={"prefix":sys.prefix,"base_prefix":sys.base_prefix,"interpreter_executable":sys.executable,"python_version":list(sys.version_info[:2])}',
263
+ "environment=pathlib.Path(sys.executable).parent.parent",
264
+ "try:",
265
+ ' environment.joinpath("pyvenv.cfg").read_bytes()',
266
+ ' result["configuration_readable"]=True',
267
+ " entry=os.stat(sys.prefix)",
268
+ ' result["root_identity"]=[str(entry.st_dev & 0xffffffff if os.name=="nt" else entry.st_dev),str(entry.st_ino)]',
269
+ ' result["environment_matches_executable"]=os.path.samestat(entry,os.stat(environment))',
270
+ ' result["isolated"]=os.path.normcase(os.path.abspath(sys.prefix))!=os.path.normcase(os.path.abspath(sys.base_prefix))',
271
+ "except OSError as error:",
272
+ ' result.setdefault("configuration_readable",False)',
273
+ ' key="identity_error" if result["configuration_readable"] else "configuration_error"',
274
+ ' result[key]={"message":str(error),"errno":error.errno,"winerror":getattr(error,"winerror",None)}',
275
+ "print(json.dumps(result))",
276
+ ].join("\n"),
277
+ ],
278
+ {
279
+ encoding: "utf8",
280
+ timeout: 15000,
281
+ windowsHide: true,
282
+ env: runtimeEnvironment(),
283
+ },
284
+ );
285
+ if (result.error || result.status !== 0)
286
+ return {
287
+ ...report,
288
+ status: "unusable",
289
+ reason:
290
+ result.error?.code ||
291
+ result.stderr?.trim().slice(0, 1500) ||
292
+ "The interpreter did not complete its check.",
293
+ };
294
+ try {
295
+ const value = JSON.parse(result.stdout);
296
+ const version = value.python_version;
297
+ Object.assign(report, {
298
+ prefix: value.prefix,
299
+ base_prefix: value.base_prefix,
300
+ python_version: version,
301
+ interpreter_executable: value.interpreter_executable,
302
+ environment_matches_executable: value.environment_matches_executable,
303
+ isolated: value.isolated,
304
+ root_identity: value.root_identity,
305
+ expected_identity: expectedIdentity,
306
+ identity_error: value.identity_error,
307
+ configuration_readable: value.configuration_readable,
308
+ configuration_error: value.configuration_error,
309
+ });
310
+ if (value.configuration_readable === false)
311
+ return {
312
+ ...report,
313
+ status: "unusable",
314
+ reason:
315
+ "The Python process cannot read its own pyvenv.cfg in this host context. Setup stopped before dependency installation.",
316
+ };
317
+ if (
318
+ value.environment_matches_executable !== true ||
319
+ value.isolated !== true ||
320
+ !Array.isArray(value.root_identity) ||
321
+ value.root_identity.length !== 2 ||
322
+ value.root_identity.some(
323
+ (part, index) => part !== expectedIdentity[index],
324
+ )
325
+ )
326
+ return {
327
+ ...report,
328
+ status: "unusable",
329
+ reason:
330
+ "The interpreter prefix does not identify the selected virtual environment.",
331
+ };
332
+ if (
333
+ !Array.isArray(version) ||
334
+ version.length !== 2 ||
335
+ !version.every(Number.isInteger) ||
336
+ version[0] !== 3 ||
337
+ version[1] < 12
338
+ )
339
+ return {
340
+ ...report,
341
+ status: "unusable",
342
+ reason: "The runtime requires Python 3.12 or later.",
343
+ };
344
+ return {
345
+ ...report,
346
+ status: "ready",
347
+ reason: "The selected Python environment is isolated.",
348
+ };
349
+ } catch {
350
+ return {
351
+ ...report,
352
+ status: "unverified",
353
+ reason: "The interpreter returned an invalid identity report.",
354
+ };
355
+ }
356
+ }
357
+
358
+ function invoke(command, args, env = process.env) {
148
359
  const result = spawnSync(command, args, {
149
360
  stdio: "inherit",
150
361
  shell: false,
151
- env: { ...process.env, BROADER_VIDS_LAUNCHER: __filename },
362
+ env: { ...env, BROADER_VIDS_LAUNCHER: __filename },
152
363
  });
153
364
  if (result.error)
154
365
  throw new Error(
@@ -184,6 +395,27 @@ function cacheWheel(source, root) {
184
395
  return destination;
185
396
  }
186
397
 
398
+ function withWheelSource(wheel, action) {
399
+ const unsafe = (value) => /[#%?]/.test(value);
400
+ if (!unsafe(wheel)) return action(pathToFileURL(wheel).href);
401
+ const temporaryRoot = os.tmpdir();
402
+ if (unsafe(temporaryRoot))
403
+ throw new Error(
404
+ "UV cannot install this wheel from the selected paths. Set TEMP and TMP to a directory without #, %, or ?, then repeat setup.",
405
+ );
406
+ const directory = fs.mkdtempSync(
407
+ path.join(temporaryRoot, "broader-vids-wheel-"),
408
+ );
409
+ const temporary = path.join(directory, path.basename(wheel));
410
+ try {
411
+ fs.copyFileSync(wheel, temporary);
412
+ return action(pathToFileURL(temporary).href);
413
+ } finally {
414
+ if (fs.existsSync(temporary)) fs.unlinkSync(temporary);
415
+ fs.rmdirSync(directory);
416
+ }
417
+ }
418
+
187
419
  function bundledWheel(packageRoot, version) {
188
420
  const prefix = `broader_vids-${version.replace("-alpha.", "a")}-`;
189
421
  const folder = path.join(packageRoot, "python");
@@ -370,31 +602,65 @@ function main(args = process.argv.slice(2)) {
370
602
  }
371
603
  if (args[index] === "setup") {
372
604
  validateSetupArguments(args, index);
605
+ if (args.includes("--check")) {
606
+ const report = withRuntimeUse(root, () =>
607
+ checkRuntime(runtime, executable),
608
+ );
609
+ console.log(JSON.stringify({ data_directory: root, ...report }, null, 2));
610
+ if (report.status !== "ready") process.exitCode = 2;
611
+ return;
612
+ }
613
+ const creationArguments = environmentArguments(runtime);
373
614
  const sourceWheel = bundledWheel(packageRoot, manifest.version);
374
615
  const wheelRoot = path.dirname(sourceWheel);
375
616
  return withSetup(root, () => {
376
617
  require("./profile-data.cjs").ensureMarker(root);
377
618
  const receipt = path.join(runtime, "broader-vids-build.json");
378
619
  if (fs.existsSync(receipt)) fs.unlinkSync(receipt);
379
- if (!fs.existsSync(executable))
380
- invoke("uv", [
381
- "venv",
382
- "--allow-existing",
383
- "--python",
384
- ">=3.12",
385
- runtime,
386
- ]);
620
+ const environment = runtimeEnvironment();
621
+ let runtimeCheck = checkRuntime(runtime, executable);
622
+ if (runtimeCheck.status !== "ready") {
623
+ if (process.platform === "win32") clearInterpreterEntries(runtime);
624
+ invoke("uv", creationArguments, environment);
625
+ runtimeCheck = checkRuntime(runtime, executable);
626
+ if (runtimeCheck.status !== "ready" && process.platform === "win32") {
627
+ clearInterpreterEntries(runtime);
628
+ invoke(
629
+ "uv",
630
+ environmentArguments(runtime, "win32", true),
631
+ environment,
632
+ );
633
+ runtimeCheck = checkRuntime(runtime, executable);
634
+ runtimeCheck.link_fallback = runtimeCheck.executable_linked
635
+ ? "created"
636
+ : "unavailable";
637
+ }
638
+ if (runtimeCheck.status !== "ready") {
639
+ const error = new Error(
640
+ `The Python runtime is not an isolated environment. ${runtimeCheck.reason}`,
641
+ );
642
+ error.code = "RUNTIME_NOT_ISOLATED";
643
+ error.report = { data_directory: root, ...runtimeCheck };
644
+ throw error;
645
+ }
646
+ }
387
647
  const wheel = cacheWheel(sourceWheel, root);
388
- invoke("uv", [
389
- "pip",
390
- "install",
391
- "--python",
392
- executable,
393
- "--reinstall",
394
- "--no-index",
395
- "--no-deps",
396
- wheel,
397
- ]);
648
+ withWheelSource(wheel, (url) =>
649
+ invoke(
650
+ "uv",
651
+ [
652
+ "pip",
653
+ "install",
654
+ "--python",
655
+ executable,
656
+ "--reinstall",
657
+ "--no-index",
658
+ "--no-deps",
659
+ url,
660
+ ],
661
+ environment,
662
+ ),
663
+ );
398
664
  const extras = args.includes("--asr")
399
665
  ? ["evidence", "asr"]
400
666
  : args.includes("--evidence")
@@ -402,15 +668,19 @@ function main(args = process.argv.slice(2)) {
402
668
  : [];
403
669
  const groups = ["core", ...extras];
404
670
  for (const extra of groups) {
405
- invoke("uv", [
406
- "pip",
407
- "install",
408
- "--python",
409
- executable,
410
- "--require-hashes",
411
- "-r",
412
- path.join(wheelRoot, `${extra}-requirements.txt`),
413
- ]);
671
+ invoke(
672
+ "uv",
673
+ [
674
+ "pip",
675
+ "install",
676
+ "--python",
677
+ executable,
678
+ "--require-hashes",
679
+ "-r",
680
+ path.join(wheelRoot, `${extra}-requirements.txt`),
681
+ ],
682
+ environment,
683
+ );
414
684
  }
415
685
  recordRuntimeBuild(runtime, wheelDigest(wheel), packageRoot, groups);
416
686
  console.log(
@@ -492,19 +762,18 @@ function main(args = process.argv.slice(2)) {
492
762
  ...(selectedHost.explicit ? ["--host", host] : []),
493
763
  ...args.slice(index),
494
764
  ];
495
- return invoke(executable, [
496
- "-m",
497
- "broader_vids",
498
- "--data-dir",
499
- root,
500
- ...engineArgs,
501
- ]);
765
+ return invoke(
766
+ executable,
767
+ ["-m", "broader_vids", "--data-dir", root, ...engineArgs],
768
+ runtimeEnvironment(),
769
+ );
502
770
  });
503
771
  }
504
772
 
505
773
  module.exports = {
506
774
  defaultRoot,
507
775
  dataRoot,
776
+ environmentArguments,
508
777
  commandIndex,
509
778
  parseHost,
510
779
  cacheWheel,
@@ -531,6 +800,8 @@ if (require.main === module) {
531
800
  2,
532
801
  ),
533
802
  );
803
+ else if (error.code === "RUNTIME_NOT_ISOLATED")
804
+ console.log(JSON.stringify(error.report, null, 2));
534
805
  else if (error.code === "RUNTIME_BUILD_MISMATCH")
535
806
  console.log(
536
807
  JSON.stringify(
package/docs/REFERENCE.md CHANGED
@@ -921,6 +921,8 @@ codex plugin add broader-vids@broader-vids-local
921
921
 
922
922
  The command builds the Python wheel, packs and verifies the npm archive, builds the plugin ZIP and local marketplace, and writes `dist/release.json` and `dist/SHA256SUMS`.
923
923
  The generated local marketplace contains the installable plugin payload.
924
+ Use `dist/local-marketplace` to test unpublished source changes.
925
+ The repository-root marketplace uses npm, even when you add that folder locally.
924
926
  These commands install locally and do not publish anything.
925
927
 
926
928
  Open a new desktop or CLI conversation after installation.
@@ -1135,6 +1137,7 @@ From an unpacked package, install its external engine:
1135
1137
 
1136
1138
  ```powershell
1137
1139
  node bin/broader-vids.cjs setup --evidence
1140
+ node bin/broader-vids.cjs setup --check
1138
1141
  node bin/broader-vids.cjs doctor
1139
1142
  ```
1140
1143
 
@@ -1144,6 +1147,39 @@ A missing, older, or mismatched build receipt requires one `setup --evidence` re
1144
1147
  This also applies to a rebuilt package with the same version.
1145
1148
  The refresh preserves profile data and sign-in. `dashboard stop` remains available during repair.
1146
1149
  Normal commands do not reinstall dependencies.
1150
+ Setup verifies the virtual environment before it installs packages.
1151
+ On Windows, UV selects Python and invokes its standard `venv` module with executable copies and no pip seed.
1152
+ This avoids UV's custom Windows interpreter launcher.
1153
+ Windows runtime paths cannot contain semicolons because Python venv rejects this character.
1154
+ See the [upstream Windows launcher change](https://github.com/astral-sh/uv/pull/19199) for the old `PYTHONHOME` behavior.
1155
+ UV still installs the engine and locked dependencies.
1156
+ If copied Windows launchers cannot initialize, setup tries one standard symlink-based environment in the same directory.
1157
+ This reuses the installed Python executable. Configuration, packages, and profile data stay in the selected sandbox.
1158
+ The host must permit executable symlinks. Setup does not enable Developer Mode or change Windows permissions.
1159
+ A failed fallback stops before dependency installation.
1160
+ Other platforms retain `uv venv`.
1161
+ It checks `pyvenv.cfg`, Python 3.12 or later, and the native identity of the selected environment.
1162
+ Python checks its own environment in its active filesystem namespace.
1163
+ Node compares directory identities rather than logical and physical sandbox path strings.
1164
+ The base Python directory does not need a separate filesystem lookup.
1165
+ An incomplete environment receives a repair before dependency installation.
1166
+ If verification still fails, setup stops without a success receipt.
1167
+ Inherited `PYTHONHOME`, `PYTHONPATH`, `__PYVENV_LAUNCHER__`, and `UV_INTERNAL__PYTHONHOME` values do not redirect the managed runtime.
1168
+ The launcher retains UV's protection for externally managed Python installations.
1169
+ Some UV versions misread local wheel paths that contain `#`, `%`, or `?`.
1170
+ The launcher copies the immutable cached wheel to a temporary directory when its path contains these characters.
1171
+ It removes the temporary copy after installation or failure.
1172
+ The temporary directory must also avoid these characters.
1173
+ The profile and runtime stay in the selected data directory.
1174
+
1175
+ `setup --check` returns runtime identity and access diagnostics without installing packages or changing profile data.
1176
+ It uses a temporary launcher lease to prevent concurrent runtime repair. The launcher directory can remain afterward.
1177
+ Run it in the host conversation where setup failed, with the same directory and permissions.
1178
+ It reports the selected path, configured backend, executable-link status, resolved prefixes, and configuration access errors.
1179
+ A runtime check does not verify dependencies or complete onboarding.
1180
+ If the host reports `EPERM` or `EACCES`, request its normal access to that path and retry there.
1181
+ Do not disable sandboxing, change ACLs, or move the profile automatically.
1182
+
1147
1183
  Finish active recommendations and Bilibili browser operations before setup.
1148
1184
  Concurrent setup or runtime use returns a busy result instead of changing active files.
1149
1185
  A failed child command releases its installation lock.
@@ -1285,6 +1321,13 @@ Continuation preserves an explicit deadline and all cumulative request, media, a
1285
1321
 
1286
1322
  YouTube metadata retrieval uses one active watch-page request and starts at least one second apart.
1287
1323
  Bilibili metadata retrieval uses at most two concurrent requests and starts at least one second apart.
1324
+ A Bilibili metadata response with code `-404` receives one initial attempt and up to three retries.
1325
+ These attempts use the same signed-in session, pacing, and request allowance.
1326
+ Recorded `-404` attempts remain counted when a paused round continues. A new round has its own count.
1327
+ If all attempts return `-404`, collection skips and reports that candidate, then fills its lane from other candidates.
1328
+ Saved eligible candidates and unfinished batches remain available on continuation.
1329
+ This result does not prove permanent deletion and does not assign a quality score or preference rating.
1330
+ Login errors, access challenges, malformed metadata, and mismatched video identities still pause collection.
1288
1331
  Workers retain server-issued session cookies in memory.
1289
1332
  Pacing waits count toward an optional saved time allowance.
1290
1333
  The [yt-dlp request-rate guidance](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#common-youtube-errors) recommends longer waits between downloads when rate limits occur.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "broader-vids",
3
- "version": "0.1.9",
3
+ "version": "0.1.11",
4
4
  "description": "Codex and experimental Claude Code skills for local YouTube/Bilibili recommendations",
5
5
  "license": "MIT",
6
6
  "engines": {
@@ -11,7 +11,7 @@
11
11
  },
12
12
  "files": [
13
13
  "bin/",
14
- "python/broader_vids-0.1.9-*.whl",
14
+ "python/broader_vids-0.1.11-*.whl",
15
15
  "python/core-requirements.txt",
16
16
  "python/evidence-requirements.txt",
17
17
  "python/asr-requirements.txt",
@@ -48,6 +48,6 @@
48
48
  "tag": "latest"
49
49
  },
50
50
  "broaderVidsRelease": {
51
- "sourceCommit": "2e55f23f0279297c157c71195a5e8c72f1e6aa40"
51
+ "sourceCommit": "f75476bc23dce185b4a8a5479a8a984f17bffa1d"
52
52
  }
53
53
  }
package/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "broader-vids",
4
- "version": "0.1.9",
4
+ "version": "0.1.11",
5
5
  "description": "Curated YouTube and Bilibili recommendations with bounded quality evidence and local watched/feedback state.",
6
6
  "license": "MIT",
7
7
  "extensions": {
@@ -98,6 +98,18 @@ Do not repeat the introduction for a completed profile during routine checks.
98
98
  Check Node.js 20 or later, UV, and Codex CLI availability.
99
99
  Report exact repair steps for missing system tools.
100
100
  Run `setup --evidence` to install the external runtime and evidence dependencies when needed.
101
+ Setup creates the runtime directory before platform or interest configuration.
102
+ On Windows, it uses UV to select Python and Python's standard module to create the virtual environment.
103
+ If copied Windows launchers cannot initialize, setup tries an executable-link environment in the same directory once.
104
+ It verifies isolation before installing packages. Do not disable the check or move data to make it pass.
105
+ If the host denies file access, request its normal permission for the same data directory before retrying.
106
+ If access was already granted in this session, do not repeat the same permission request or installation without a changed condition.
107
+ If isolation verification fails, run `setup --check` in this same host conversation and permission context.
108
+ Show its reason, prefix, base prefix, and access error. This command does not install packages or change profile data.
109
+ It briefly holds a launcher lease and releases that lease after the check.
110
+ Do not compare physical sandbox paths from an external terminal to diagnose this check.
111
+ Do not move the profile or select another directory unless the user requests that change.
112
+ Do not disable UV's protection for externally managed Python installations.
101
113
  Install optional transcription with `setup --asr` only when requested.
102
114
  Do not reinstall a working runtime during normal recommendation requests.
103
115
  If the launcher reports a missing or mismatched build receipt, refresh the runtime with `setup --evidence`.