Repository navigation
Spawn v1.0.9
Spawn v1.0.9 — Core Hardening
A reliability release. Project generation is now safer, errors are predictable, and the internals are cleaner for what comes next. Generated output for default options is unchanged from v1.0.8.
Behavior changes
- Failures now exit non-zero. Generation, git/uv and GitHub-publish failures used to print an error and exit
0. They now exit with a stable code (see the table below), so scripts and CI can trust the result. --no-uvis now honored for template projects. It previously still ran uv. Without uv, Spawn skipsuv init, dependency installs and extras that needpyproject.toml(Dockerfile, CI workflow, ruff/pytest/mypy config). It prints one line listing what was skipped. File-only extras such aspre-commitare still written.- Interactive
spawn create --dry-runnow validates and prints the config without creating anything. It previously created the project.
Security
- Custom-structure paths that escape the project directory (
../, absolute paths, backslashes, drive letters) are rejected. - Failure cleanup only removes directories created by the current run.
- Git and GitHub error output no longer includes URL credentials.
Added
ProjectConfig.destinationandto_dict(), plusplan_projectandgenerate_projectas the single plan and generate entry points.read_project_metadata(): read-only access to.spawn/meta.json. The metadata is historical, not proof of current repo state.- A typed error hierarchy and documented exit codes.
SPAWN_DEBUG=1to get a full traceback for unexpected errors.SECURITY.md, golden-tree fixtures for every template, and expanded CI (Python 3.12/3.13, wheel smoke test).--configwith an explicit--no-git/--no-uvnow warns that the config file takes precedence.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success (including a valid --dry-run) |
| 1 | Invalid input or config |
| 2 | CLI usage error |
| 3 | Filesystem error (e.g. directory exists) |
| 4 | Toolchain error (git/uv missing or failed) |
| 5 | Generation / template error |
| 6 | GitHub publish error |
| 10 | Unexpected error |
| 130 | Cancelled |
Upgrade
pip install --upgrade spawnio
If you script spawn create, check how it handles non-zero exits, since failures that used to exit 0 now don't.
Full changelog: https://github.com/Abhiix0/Spawn/blob/main/docs/changelog.md