fix: reliable, self-healing AI feature-bundle installs (#472)

Make on-demand AI feature-bundle installs reliable and self-healing, closing
the failure modes behind most "some tool doesn't work" reports.

Multi-bundle installs: tools needing more than one bundle (Passport Photo,
Enhance Faces) install every required bundle from one action and stay
not-installed until all are present. Verified across all 19 AI tools.

Downloads: self-heal the accelerated Hugging Face (Xet) client so an upgraded
venv no longer silently falls back to slow urllib; restart instead of
corrupting a resumed partial when a proxy ignores Range and returns 200;
verify the completed size; fail fast on disk-full and HTTP 4xx; retry
transient errors five times; add hf_transfer fallback and document Xet egress.

Install integrity: crash-atomic venv writes so a killed or out-of-space
install can no longer tear the shared venv and break other tools; a boot
breadcrumb reseeds a torn venv to a clean state automatically; a post-install
smoke import test refuses to record a bundle whose libraries cannot load; an
install watchdog stops a wedged installer that would otherwise hold the venv
writer lock forever.

Adds unit and end-to-end tests for every failure mode above.
This commit is contained in:
SnapOtter
2026-07-10 07:32:48 +00:00
committed by GitHub
parent ffeacd4b3c
commit a731c3d1fe
33 changed files with 1913 additions and 125 deletions
+5 -2
View File
@@ -1309,6 +1309,7 @@ describe("bridge - env passthrough for sidecar-specific vars", () => {
vi.restoreAllMocks();
delete process.env.U2NET_HOME;
delete process.env.DATA_DIR;
delete process.env.MODELS_PATH;
delete process.env.DISPATCHER_MAX_REQUESTS;
});
@@ -1360,9 +1361,10 @@ describe("bridge - env passthrough for sidecar-specific vars", () => {
expect(getLastSpawnEnv()?.DISPATCHER_MAX_REQUESTS).toBe("100");
});
it("does not include unset vars in subprocess env", async () => {
it("defaults data/model paths but does not include other unset vars in subprocess env", async () => {
delete process.env.U2NET_HOME;
delete process.env.DATA_DIR;
delete process.env.MODELS_PATH;
delete process.env.DISPATCHER_MAX_REQUESTS;
const mock = createMockProcess();
@@ -1375,7 +1377,8 @@ describe("bridge - env passthrough for sidecar-specific vars", () => {
const env = getLastSpawnEnv();
expect(env?.U2NET_HOME).toBeUndefined();
expect(env?.DATA_DIR).toBeUndefined();
expect(env?.DATA_DIR).toBe("./data");
expect(env?.MODELS_PATH).toBe("./data/ai/models");
expect(env?.DISPATCHER_MAX_REQUESTS).toBeUndefined();
});
});