XI.Installation book · v0.13

Verify the archive / preview every write / keep a rollback path

Install STOLZ A.I. without a leap of faith.

Use the immutable v0.13 package, keep it local to the consumer project, and run every lifecycle change through an inspect-first command.

01

1. Verify the archive

Download the package and compare its SHA-256 before installing it. The canonical archive contains 191 files.

SHA-25605645ff2d899dee7a8c3231c04e069a11f7e6bccb044509f9d39e58f1b34c82c
02

2. Install in the consumer project

Install the downloaded archive as a development dependency. The CLI then runs without fetching another package.

terminal / npm
npm install --save-dev /absolute/downloads/stolz-ai-0.13.0.tgz
03

3. Resolve, preview, then install

Resolve the Codex profile, inspect the deterministic installation plan, and add `--apply` only after reviewing the destination and owned files.

terminal / profile
npx --no-install stolz-profile resolve --runtime codex
npx --no-install stolz-profile install --runtime codex --destination /absolute/path/to/skills --dry-run
npx --no-install stolz-profile install --apply --runtime codex --destination /absolute/path/to/skills
04

4. Run doctor

Doctor makes no provider or model call. It reports installation state, the observed runtime version, compatibility basis, lazy-adapter availability, and the next action.

terminal / doctor
npx --no-install stolz-profile doctor --runtime codex --runtime-version <version> --destination /absolute/path/to/skills
05

5. Commit a team lock and verify it in CI

The lock contains package and profile identity, not credentials or local paths. `verify-lock` exits non-zero on drift, an invalid lock, or an incompatible reported runtime version.

terminal / team lock
npx --no-install stolz-profile lock --apply --runtime codex --lockfile ./stolz-profile.lock.json
npx --no-install stolz-profile verify-lock --runtime codex --lockfile ./stolz-profile.lock.json
06

6. Review an update before applying it

The first command prints the future change. Apply only after review; locally changed or missing STOLZ-owned files stop the update.

terminal / update
npx --no-install stolz-profile update --runtime codex --destination /absolute/path/to/skills
npx --no-install stolz-profile update --apply --runtime codex --destination /absolute/path/to/skills
07

7. Recover an interrupted update

If doctor reports `recovery_required`, preview recovery first. Apply restores the verified prior installation recorded by the transaction journal.

terminal / recover
npx --no-install stolz-profile recover --dry-run --destination /absolute/path/to/skills
npx --no-install stolz-profile recover --apply --destination /absolute/path/to/skills
08

8. Roll back with the same discipline

Preview rollback before applying it. Rollback refuses to overwrite a locally changed owned file.

terminal / rollback
npx --no-install stolz-profile rollback --dry-run --destination /absolute/path/to/skills
npx --no-install stolz-profile rollback --apply --destination /absolute/path/to/skills

§ 3scope / evidence

What these checks prove

They prove package identity, selected configuration, and manifest-owned files. They do not prove model compatibility, provider-native tokens, billing, cost, or savings.

09

Real-project follow-up

No real pilot owner is recorded yet. Use the included pilot journal only after a project owner agrees to participate.

Return to the v0.13 release