xgauntlet 0.8.3 → 0.8.5

package/README.md

@@ -5,7 +5,8 @@
   <a href="#️-mappestruktur-package-by-feature"><b>🏗️ Mappestruktur</b></a> •
   <a href="#️-fuld-cli-reference"><b>🛠️ CLI Reference</b></a> •
   <a href="#-rust-api"><b>🦀 Rust API</b></a> •
-  <a href="#️-arkitektur-adrs"><b>🏛️ ADRs</b></a>
+  <a href="#️-arkitektur-adrs"><b>🏛️ ADRs</b></a> •
+  <a href="#-licens"><b>📄 Licens</b></a>
 </p>
 
 ---
@@ -99,7 +100,7 @@ xgauntlet init
 Når du eller agenten arbejder på en opgave i projektet, afvikles gauntlettet direkte:
 
 ```bash
-# Kør gauntlet og forseg evidens for en opgave:
+# Kør gauntlet og forsegl evidens for en opgave:
 xgauntlet verify --task-id 001-bootstrap
 
 # Valider kildetræets integritet mod rapporten (drift-kontrol):
@@ -144,8 +145,8 @@ rm -rf ~/.cache/xgauntlet
 ## 🧭 Pipeline og Gates: Sådan virker det
 
 `xGauntlet` arbejder på to adskilte niveauer:
-1. **Metodiske retningslinjer (Agent Skills)**: Proceskrav (såsom sokratisk grilling, TDD-disciplin og arkitektur-review), som agenten instrueres i at følge (`grill-me`, `old-coder`, `code-review`).
-2. **Håndhævede software-gates (CLI & In-Memory WASM)**: Deterministiske kontrolpunkter i Rust-koden (`check-spec`, pre-invocation WASM hook, `verify`, `check-evidence` og `check-release`), der fysisk blokerer uautoriserede handlinger med exit-koder og multi-digest integritetskontrol.
+1. **Metodiske retningslinjer (Agent Skills)**: Proceskrav (såsom sokratisk behovsafklaring, TDD-disciplin og arkitektur-review), som agenten instrueres i at følge (`discover`, `spec`, `tdd`, `review`, `diagnose`, `release`).
+2. **Håndhævede software-gates (CLI & In-Memory WASM)**: Deterministiske kontrolpunkter i Rust-koden (`check-spec`, pre-invocation WASM hook, `verify`, `check-evidence`, `check-attestation`, `check-architecture` og `check-release`), der fysisk blokerer uautoriserede handlinger med exit-koder og multi-digest integritetskontrol.
 
 > [!NOTE]
 > **Bemærk om tilstande og Zero-Daemon:** Systemet styres ikke af en global database eller baggrundsdæmon, men af diskrete, uafhængige CLI-kald (`sub-3ms` koldstart). Opgavestatus (`DRAFT`, `ACTIVE`, `PASSED`, `DONE`) er forankret direkte i de enkelte task-filers OKF YAML-frontmatter (`tasks/*.md`), som evalueres on-demand af de respektive gates uden behov for en tilstandsmaskine-service.
@@ -153,33 +154,33 @@ rm -rf ~/.cache/xgauntlet
 ### Oversigt over udviklingsflowet
 
 ```text
-[ 1. IDÉAFKLARING ]             ──► Metodisk skill (grill-me / grill-with-docs)
+[ 1. IDÉAFKLARING ]             ──► Metodisk skill (discover)
          │                          (Opdaterer CONTEXT.md & docs/adr/)
          ▼
 [ 2. SPECIFIKATION ]            ──► HÅRD GATE: xgauntlet check-spec
          │                          (OKF metadata, formål, kriterier, Must NOT, Aristoteles-glossar)
          ▼
 [ 3. TDD & KODNING ]            ──► HÅRD GATE: Zero-Ambient-Authority WASM Policy Hook
-         │                          (Kræver aktiv task for beskyttede stier, forhindrer git push)
+         │                          (Quote-aware tokenization, task scope, forhindrer wrappers & git push)
          ▼
 [ 4. FLERLAGS VERIFIKATION ]    ──► HÅRD GATE: xgauntlet verify
          │                          (Kører linters, typer, tests; matematisk pre/post manifestkontrol)
          ▼
-[ 5. KODESTANDARD-REVIEW ]      ──► Hybrid skill: code-review & udvikleraccept
-         │                          (Audit mod CODING_STANDARDS.md)
+[ 5. KODESTANDARD-REVIEW ]      ──► Hybrid skill: review & udvikleraccept
+         │                          (Audit mod CODING_STANDARDS.md & Fowler smells)
          ▼
-[ 6. DRIFT-KONTROL ]            ──► HÅRD GATE: xgauntlet check-evidence
-         │                          (Verificerer at workspace matcher rapporten via Git OID hash)
+[ 6. DRIFT- & ATTESTATION ]     ──► HÅRD GATE: xgauntlet check-evidence & check-attestation
+         │                          (Git OID drift-kontrol og kryptografisk Sigstore OIDC verifikation)
          ▼
-[ 7. RELEASE READINESS ]        ──► HÅRD GATE: xgauntlet check-release
-                                    (Versionssynkronisering, CHANGELOG.md og ADR-krydsreferencer)
+[ 7. RELEASE READINESS ]        ──► HÅRD GATE: xgauntlet check-release (--strict) & release bump
+                                    (WASM-sync, manifest harmony, changelog og transaktionel staging)
 ```
 
 ### Pipelinen trin for trin
 
 #### 1. Idé- og kontekstafklaring
 * **Type**: Metodisk proces (Agent Skill)
-* **Hvad der sker**: Før der skrives specifikationer eller kode, aktiveres grilling-skills (`grill-me` eller `grill-with-docs`). Agenten udfordrer antagelser, identificerer risici og afstemmer planer mod eksisterende arkitektur og ADR'er.
+* **Hvad der sker**: Før der skrives specifikationer eller kode, aktiveres sparringsskillen `discover`. Agenten udfordrer antagelser, identificerer risici og afstemmer planer mod eksisterende arkitektur og ADR'er.
 * **Kontrolpunkt**:
   * *Hvem godkender*: Udvikleren i direkte dialog.
   * *Hvordan*: Dialogen udmønter sig i, at agenten opdaterer `CONTEXT.md` og eventuelt udarbejder en ny ADR i `docs/adr/`.
@@ -206,9 +207,10 @@ rm -rf ~/.cache/xgauntlet
   * *Hvordan*: Agentens værktøjskald (tool calls) overvåges deterministisk ved hvert kald via `xgauntlet hook <harness>`.
   * *Håndhævelse i koden*:
     * **Zero Ambient Authority**: WebAssembly-modulet har absolut nul adgang til værtsfilsystem, netværk, systemur eller tilfældighedskilder.
-    * Beskyttede produktions- og kildestier (`src/`, `tests/`, `crates/`, `packages/`, `.agents/`) kan **ikke** modificeres, medmindre der findes en aktiv task (`tasks/*.md`) med status `ACTIVE`.
-    * Destruktive kommandoer som `git push`, `git reset --hard`, `git clean -f`, `git branch -D` og `rm -rf /` blokeres hårdt (`reason_code: 4039`).
-    * Linux Bubblewrap (`bwrap`) er erstattet til fordel for WebAssembly + matematisk invariantkontrol (pre/post manifest-digests i verifikationspipelinen), hvilket sikrer fuld 100% krydsplatform understøttelse på tværs af Linux, macOS og Windows 11 uden kerne-afhængigheder eller root-rettigheder.
+    * **Struktureret Command Tokenization**: Shell-kommandoer evalueres via en quote-aware argument-lexer. Eksekverings-wrappers (`env`, `sudo`, `eval`, `bash -c`, `sh -c`, `xargs`, `doas`, `su`, `exec`) afvises fail-closed med `reason_code: 4039`.
+    * **Fail-Closed Task Scope**: Filmodifikationer (`WriteFile`) uden for den aktive opgaves erklærede `scope` blokeres hårdt (`reason_code: 4037`). Hvis task scope er udefineret, tillader test-scope isolation udelukkende skrivning til verificerede testfiler.
+    * **Destruktiv Beskyttelse**: Destruktive kommandoer som `git push`, `git reset --hard`, `git clean -f`, `git branch -D` og `rm -rf /` blokeres uanset globale flag (`-C`, `-c`, `--no-pager`).
+    * **Harness Compliance**: Understøtter officielt fladt `PreInvocation` skema for Google Antigravity og sikker, ikke-destruktiv hook-scaffolding mod JSON-korruption.
   * *Bemærk om TDD*: Selve rækkefølgen (Red før Green) registreres ikke historisk af test-runneren; det er en metodisk adfærd instrueret via agent-skills.
 
 #### 4. Flerlags Verifikation
@@ -225,7 +227,7 @@ rm -rf ~/.cache/xgauntlet
 #### 5. Review mod Kodestandarder
 * **Type**: Hybrid gate (Agent Skill + Udvikleraccept)
 * **Hvad der sker**: Den implementerede løsning auditeres mod arkitekturretningslinjer og regler i `CODING_STANDARDS.md`.
-* **Kontrolpunkt**: Standards Review (`code-review` skill)
+* **Kontrolpunkt**: Standards Review (`review` skill)
   * *Hvem godkender*: Udvikleren assisteret af agentens review-skill.
   * *Hvordan*: Agenten gennemgår diff'en op mod kodestandarderne og fremhæver eventuelle arkitekturbrud, manglende fejlhåndtering eller navngivningsfejl.
   * *Håndhævelse i koden*: Gaten er procesmæssig og beror på agentens review-rapport kombineret med udviklerens godkendelse.
@@ -233,24 +235,25 @@ rm -rf ~/.cache/xgauntlet
 #### 6. Drift- og Integritetskontrol (Two-Tier Model)
 * **Type**: Hård software-gate
 * **Hvad der sker**: Verificering af, at kildekoden og arbejdstræet ikke er blevet manipuleret eller er driftet efter testkørslen.
-* **Kontrolpunkt**: Drift Verification (`xgauntlet check-evidence`)
-  * *Hvem godkender*: Drift-detektionsmotoren (`crates/xgauntlet-core/src/features/evidence/drift.rs`).
+* **Kontrolpunkt**: Drift Verification (`xgauntlet check-evidence`) & Attestation Gate (`xgauntlet check-attestation`)
+  * *Hvem godkender*: Drift-detektionsmotoren (`crates/xgauntlet-core/src/features/evidence/drift.rs`) og attestation-verifikatoren (`attestation.rs`).
   * *Hvordan*: Værktøjet genberegner det aktuelle kildetræs workspace-manifest og sammenligner det direkte med værdierne i `verification-report.json`.
   * *Håndhævelse i koden*:
     * **Tier 1 (Lokal drift-kontrol)**: Er blot én byte ændret i kildetræ, opgave, config eller politik efter `verify`, afvises tjekket med en specifik `DriftViolation`. Beregningen benytter Git-tree/blob OID-hashes, hvilket gør driftkontrollen fuldstændig immun over for linjeskift-forskelle (LF vs. CRLF) på tværs af styresystemer.
-    * **Tier 2 (Attestation i CI)**: Jf. [ADR 0005](docs/adr/0005-two-tier-verification-and-attestation-model.md) adskilles lokal verifikation fra uafviselig CI-attestering. I beskyttede CI-miljøer genereres en kryptografisk in-toto/DSSE-attest (Sigstore/OIDC), som forsegler kildens herkomst forud for release.
+    * **Tier 2 (Kryptografisk Attestation i CI)**: Jf. [ADR 0005](docs/adr/0005-two-tier-verification-and-attestation-model.md) udstedes der i beskyttede CI-miljøer en kryptografisk in-toto/DSSE-attest (Sigstore/OIDC), som forsegler kildens og binærens herkomst (`attestation.bundle` og `attestation.json`). Denne kan efterprøves lokalt eller remote via `xgauntlet check-attestation`.
 
 #### 7. Release Readiness
 * **Type**: Hård software-gate
-* **Hvad der sker**: Koden klargøres til release og merge ved at kontrollere synkronisering mellem versioner, ændringslog og dokumentation.
-* **Kontrolpunkt**: Release Gate (`xgauntlet check-release`)
+* **Hvad der sker**: Koden klargøres til release og merge ved at kontrollere synkronisering mellem versioner, ændringslog, WASM-bytecode og dokumentation.
+* **Kontrolpunkt**: Release Gate (`xgauntlet check-release`) & Transaktionel Bump (`xgauntlet release bump`)
   * *Hvem godkender*: Release-orkestratoren (`crates/xgauntlet-core/src/features/release/engine.rs`).
-  * *Hvordan*: Værktøjet udfører tre specifikke tjek:
-    1. **Versionskonsistens**: Versionsnumre skal matche på tværs af projektets manifests (`Cargo.toml`, `package.json`, `pyproject.toml`).
-    2. **Changelog-synkronisering**: `CHANGELOG.md` skal indeholde en sektion for den pågældende version.
-    3. **ADR-referencer**: Samtlige ADR-dokumenter i `docs/adr/` skal være eksplicit refereret eller linket i enten `README.md` eller `spec.md`.
-  * *Håndhævelse i koden*: Returnerer exit-kode 1, hvis der er uoverensstemmelse i versionsnumre, manglende changelog-sektion eller forældreløse ADR-dokumenter.
-  * *Praktisk udviklerflag*: Med flaget `--allow-unreleased` tillader værktøjet sektionen `[Unreleased]` i `CHANGELOG.md` under løbende udvikling forud for den endelige versions-tagging.
+  * *Hvordan*: Værktøjet udfører dybdegående kontroller:
+    1. **Versionskonsistens**: Versionsnumre skal matche på tværs af projektets manifests (`Cargo.toml`, `package.json`, `packages/cli/package.json`).
+    2. **WASM Bytecode Paritet**: Det indlejrede WebAssembly-bytecode valideres mod workspace-versionen (`CONFIG_VERSION_MISMATCH`).
+    3. **Changelog-synkronisering**: `CHANGELOG.md` skal indeholde en sektion for den pågældende version.
+    4. **ADR-referencer**: Samtlige ADR-dokumenter i `docs/adr/` skal være eksplicit refereret eller linket i enten `README.md` eller `spec.md`.
+    5. **Strict Release Mode (`--strict`)**: Validerer rent git-arbejdstræ (med automatisk udelukkelse af cirkulære artefakter) og eksekverer kodeformatering fail-closed.
+    6. **Transaktionel Release Bump**: `xgauntlet release bump [patch|minor|major]` udfører atomisk disk-staging backup (`.xgauntlet_staging_<nonce>`), opdaterer manifests, kompilerer WASM og ruller sikkert tilbage ved fejl uden destruktive git-handlinger.
 
 ### 👥 De 4 AI-roller & Session Handoff
 
@@ -322,7 +325,7 @@ xGauntlet/
 │
 └── packages/
     └── cli/                      # NPM distributionspakke (xgauntlet)
-        └── bin/xgauntlet.js      # Zero-dependency platform bootstrapper
+        └── bin/xgauntlet.js      # Zero-dependency bootstrapper med Sigstore integritetskontrol
 ```
 
 ---
@@ -360,18 +363,64 @@ Mekanisk validering af at opgavespecifikationer indeholder forretningsinvariante
 xgauntlet check-spec
 ```
 
-### 5. Release Readiness (`check-release`)
-Validerer at versioner matcher på tværs af manifests (`Cargo.toml`, `package.json`), `CHANGELOG.md` og ADR-krydsreferencer:
+### 5. Release Readiness Gatekeeper (`check-release`)
+Validerer versionskonsistens, WASM-bytecode synkronisering, `CHANGELOG.md` og ADR-krydsreferencer:
 ```bash
-xgauntlet check-release
+# Standard kørsel under udvikling
+xgauntlet check-release --allow-unreleased
+
+# Streng release mode (fail-closed ved uncommitted filer eller formateringsfejl)
+xgauntlet check-release --strict
+```
+
+### 6. Kryptografisk Attesteringskontrol (`check-attestation`)
+Verificerer Sigstore in-toto/DSSE attesteringsbundter (`attestation.bundle` / `attestation.json`) lokalt eller direkte mod GitHub Releases:
+```bash
+# Valider lokalt bundt mod release-artefakt
+xgauntlet check-attestation --bundle attestation.bundle --artifact target/release/xgauntlet
+
+# Valider remote mod GitHub release med statisk forankret repo-ID (1359184794)
+xgauntlet check-attestation --remote-tag v0.8.4
+```
+
+### 7. Deklarativ Arkitekturkontrol (`check-architecture`)
+Håndhæver kodestruktur, filstørrelsesgrænser (kildekode max 800 linjer, tests max 1.000 linjer) og forbudte API-tokens:
+```bash
+xgauntlet check-architecture
+```
+
+### 8. Transaktionel Versionsstyring (`release bump`)
+Udfører atomisk SemVer opgradering på tværs af manifests, kompilerer og synkroniserer WASM bytecode, roterer CHANGELOG.md og ruller automatisk tilbage ved fejl via disk-staging:
+```bash
+# Bump patch, minor eller major
+xgauntlet release bump patch
+```
+
+### 9. Sessions-Overdragelseskort (`handoff`)
+Genererer et standardiseret `🏁 SESSION HANDOFF` telemetrikort til ren kontekstoverdragelse i AI-sessioner:
+```bash
+xgauntlet handoff --task-id 001-bootstrap
 ```
 
-### 6. Workspace Diagnostik (`doctor`)
+### 10. Workspace Diagnostik (`doctor`)
 Undersøg workspace-konfiguration, stakke og miljøforudsætninger på tværs af Linux, macOS og Windows:
 ```bash
 xgauntlet doctor
 ```
 
+### 11. Global Plugin & Agent Skills Distribution (`plugin install`)
+Installer eller opdater de 6 suveræne agent-skills (`discover`, `spec`, `tdd`, `review`, `diagnose`, `release`) på tværs af opdagede AI agent harnesses:
+```bash
+# Installer automatisk til alle detekterede agent-harnesses
+xgauntlet plugin install --global
+
+# Preview handlinger uden at skrive filer til disk
+xgauntlet plugin install --global --dry-run
+
+# Tving overskrivning ved opdatering til ny xgauntlet-version
+xgauntlet plugin install --global --force
+```
+
 ---
 
 ## 🦀 Rust API
@@ -399,13 +448,24 @@ Projektets invariante tekniske valg og designprincipper er dokumenteret i [`docs
 - 🏛️ **[ADR 0005](docs/adr/0005-two-tier-verification-and-attestation-model.md)**: Two-Tier Verification and Attestation Model
 - 🏛️ **[ADR 0006](docs/adr/0006-multi-harness-policy-adapter-contract.md)**: Multi-Harness Policy Adapter Contract
 - 🏛️ **[ADR 0007](docs/adr/0007-local-transparent-supervisor-and-wasm-verifier.md)**: Zero-Daemon WASM Policy Verifier
+- 🏛️ **[ADR 0008](docs/adr/0008-sovereign-agentic-sdlc-task-scoping-and-design-tokens.md)**: Sovereign Agentic SDLC, Task Scoping, and Design Token Governance
 
 ---
 
 ## 🙏 Anerkendelse & Inspiration (Credits)
 
-`xGauntlet` bygger videre på idéer og pionerarbejde inden for stringent verifikation:
-- **[Robert C. Martin ("Uncle Bob")](https://x.com/unclebobmartin/status/2080257779395154409)**: For TDD, Clean Craftsmanship og idéen om at omgive koden med en uomgængelig *gauntlet*.
+`xGauntlet` bygger videre på idéer, filosofi og pionerarbejde inden for stringent software-verifikation, agent-craftsmanship og forsyningskædesikkerhed:
+- **[Robert C. Martin ("Uncle Bob")](https://x.com/unclebobmartin/status/2080257779395154409)**: For TDD, Clean Craftsmanship og princippet om at omgive koden med en uomgængelig, automatiseret *gauntlet*.
 - **[amazingang (old-coder)](https://github.com/amazingang/old-coder)**: For formuleringen af Evidence-First filosofien (*"Trust moves from inspection to constraints"*).
-- **[Matt Pocock](https://github.com/mattpocock)**: For sokratiske workflow-skills (`grill-me`, `grill-with-docs`, `code-review`).
+- **[Matt Pocock](https://github.com/mattpocock)**: For banebrydende arbejde med sokratiske agent-workflows og to-akset review-metodologi.
+- **[Addy Osmani](https://addyosmani.com/)**: For metodiske agent-skills inden for kildestyring under implementering, metodisk forsimpling (*Chesterton's Fence*) og adversarial kvalitets-ratchets.
+- **[Jesse Vincent (obra)](https://github.com/obra/superpowers)**: For Superpowers agent-metodikken, *The Iron Law of Debugging*, anti-goals og deterministisk branch-afslutning.
 - **[Bytecode Alliance](https://bytecodealliance.org/)**: For Wasmtime og WebAssembly Component Model med formel Zero Ambient Authority.
+- **[Sigstore & OpenSSF](https://sigstore.dev/)**: For keyless OIDC-attestation og in-toto standarder for uafviselig forsyningskædesikkerhed.
+
+---
+
+## 📄 Licens
+
+Dette projekt er licenseret under [MIT Licensen](LICENSE).
+

package/bin/xgauntlet.js

@@ -236,6 +236,34 @@ function findLocalBinary() {
   return null;
 }
 
+export async function fetchAttestationBundle(repo = REPO, version = VERSION, customFetcher = null) {
+  const fetchFn = customFetcher || fetch;
+  const candidates = [
+    `https://github.com/${repo}/releases/download/v${version}/attestation.bundle`,
+    `https://github.com/${repo}/releases/download/v${version}/attestation.json`,
+  ];
+
+  let lastStatus = 404;
+  let lastStatusText = 'Not Found';
+
+  for (const url of candidates) {
+    try {
+      const res = await fetchFn(url, { redirect: 'follow' });
+      if (res && res.ok) {
+        return await res.json();
+      }
+      if (res) {
+        lastStatus = res.status;
+        lastStatusText = res.statusText || 'Not Found';
+      }
+    } catch (err) {
+      lastStatusText = err.message;
+    }
+  }
+
+  throw new Error(`HTTP ${lastStatus} fetching attestation bundle: ${lastStatusText}`);
+}
+
 async function downloadAndCacheBinary() {
   if (process.env.XGAUNTLET_TEST_FORCE_NOT_FOUND === '1') {
     throw new Error('Forced missing binary for test');
@@ -254,27 +282,22 @@ async function downloadAndCacheBinary() {
   }
 
   const downloadUrl = `https://github.com/${REPO}/releases/download/v${VERSION}/${archiveName}`;
-  const bundleUrl = `https://github.com/${REPO}/releases/download/v${VERSION}/attestation.bundle`;
   process.stderr.write(`[xgauntlet] Fetching native engine v${VERSION} for ${platform}-${arch}...\n`);
 
-  fs.mkdirSync(cacheDir, { recursive: true });
-  const tempArchive = path.join(cacheDir, `temp-${Date.now()}-${archiveName}`);
+  let tempArchive = null;
+  let createdCacheDir = false;
 
   try {
-    const [resArchive, resBundle] = await Promise.all([
+    const [resArchive, bundleJson] = await Promise.all([
       fetch(downloadUrl, { redirect: 'follow' }),
-      fetch(bundleUrl, { redirect: 'follow' }),
+      fetchAttestationBundle(REPO, VERSION),
     ]);
 
     if (!resArchive.ok) {
       throw new Error(`HTTP ${resArchive.status} fetching binary archive: ${resArchive.statusText}`);
     }
-    if (!resBundle.ok) {
-      throw new Error(`HTTP ${resBundle.status} fetching attestation bundle: ${resBundle.statusText}`);
-    }
 
     const archiveBuffer = Buffer.from(await resArchive.arrayBuffer());
-    const bundleJson = await resBundle.json();
 
     process.stderr.write(`[xgauntlet] Verifying cryptographic release attestation for ${archiveName}...\n`);
     await verifyReleaseArchive({
@@ -288,6 +311,11 @@ async function downloadAndCacheBinary() {
     });
     process.stderr.write(`[xgauntlet] Attestation verified successfully (Repo ID: ${EXPECTED_REPOSITORY_ID}).\n`);
 
+    if (!fs.existsSync(cacheDir)) {
+      fs.mkdirSync(cacheDir, { recursive: true });
+      createdCacheDir = true;
+    }
+    tempArchive = path.join(cacheDir, `temp-${Date.now()}-${archiveName}`);
     fs.writeFileSync(tempArchive, archiveBuffer);
 
     if (archiveName.endsWith('.tar.gz')) {
@@ -300,7 +328,7 @@ async function downloadAndCacheBinary() {
       }
     }
 
-    if (fs.existsSync(tempArchive)) {
+    if (tempArchive && fs.existsSync(tempArchive)) {
       fs.unlinkSync(tempArchive);
     }
 
@@ -315,9 +343,17 @@ async function downloadAndCacheBinary() {
       throw new Error(`Extracted archive did not contain expected binary: ${binName}`);
     }
   } catch (err) {
-    if (fs.existsSync(tempArchive)) {
+    if (tempArchive && fs.existsSync(tempArchive)) {
       try { fs.unlinkSync(tempArchive); } catch {}
     }
+    if (createdCacheDir && fs.existsSync(cacheDir)) {
+      try {
+        const files = fs.readdirSync(cacheDir);
+        if (files.length === 0) {
+          fs.rmdirSync(cacheDir);
+        }
+      } catch {}
+    }
     throw err;
   }
 }

package/package.json

@@ -38,7 +38,7 @@
     "test": "node --test"
   },
   "type": "module",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "dependencies": {
     "sigstore": "^3.1.0"
   }