broader-vids 0.1.9 → 0.1.10
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.
- package/.claude-plugin/plugin.json +1 -1
- package/bin/broader-vids.cjs +309 -38
- package/docs/REFERENCE.md +36 -0
- package/package.json +3 -3
- package/plugin.json +1 -1
- package/python/{broader_vids-0.1.9-py3-none-any.whl → broader_vids-0.1.10-py3-none-any.whl} +0 -0
- package/skills/broader-vids-setup/SKILL.md +12 -0
package/bin/broader-vids.cjs
CHANGED
|
@@ -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 (
|
|
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
|
|
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: { ...
|
|
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
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
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
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
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(
|
|
406
|
-
"
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
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(
|
|
496
|
-
|
|
497
|
-
"broader_vids",
|
|
498
|
-
|
|
499
|
-
|
|
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.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "broader-vids",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.10",
|
|
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.
|
|
14
|
+
"python/broader_vids-0.1.10-*.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": "
|
|
51
|
+
"sourceCommit": "b089281c8f32dadab8fdd8364d9015cc70ea5cfa"
|
|
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.
|
|
4
|
+
"version": "0.1.10",
|
|
5
5
|
"description": "Curated YouTube and Bilibili recommendations with bounded quality evidence and local watched/feedback state.",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"extensions": {
|
|
Binary file
|
|
@@ -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`.
|