Skip to content

Spawn v1.1.0

Choose a tag to compare

@Abhiix0 Abhiix0 released this 27 Oct 01:01
· 18 commits to main since this release
668e227

Spawn v1.1.0 — spawn inspect

Spawn can now read a repository, not just create one. Point it at any local project and get a deterministic, evidence-backed summary of what it contains.

spawn inspect            # inspect the current directory
spawn inspect ./my-app   # inspect a path
spawn inspect . --json   # full machine-readable report on stdout

What spawn inspect does

  • Read-only and static. It never runs project code, installs dependencies, makes network calls, or needs an LLM, and it writes nothing to the target.
  • Evidence-backed. Every finding carries repo-relative evidence and one of five states: detected, inferred, not_detected, unknown, not_checked. A dependency declaration alone is reported as inferred, not detected.
  • Deterministic. The same repository gives the same report, with stable ordering and no machine-specific absolute paths.
  • Partial results. Unreadable or malformed files produce diagnostics and a partial status instead of aborting the run.

What it detects

  • Languages and frameworks: 25 languages; React, Next.js, Vue, Nuxt, Angular, Svelte, Express, FastAPI, Flask, Django, Starlette, Pydantic, Laravel.
  • Dependencies and package managers: direct dependencies from pyproject.toml, requirements*.txt and package.json; uv, poetry, pipenv, pip, npm, yarn, pnpm, bun.
  • Tooling and layout: linters, formatters, test runners, git, CI systems, Docker/Compose, database drivers, tests directory, src layout, and Spawn-generated projects.

Other changes

  • spawn --version prints the same line as spawn version.
  • spawn inspect --verbose shows more detail in the human report.
  • A documented JSON report contract (schema 1.0) with validate_report, to_json and from_json in spawn.inspection.
  • New exit code 7 for an invalid path or failed inspection. In --json mode errors go to stderr and stdout stays empty.
  • Release smoke test now runs spawn inspect . --json on a generated project and verifies it is unchanged.
  • create, doctor and version behave exactly as before.

Known limitations

  • Framework imports are matched with regular expressions. Import-like text in comments or strings can produce false positives (for example, scaffolding tools that embed sample code), and multi-line or destructured imports are missed.
  • Directories named build, dist, env, venv, target, vendor, coverage and similar are skipped at any depth.
  • CI, container and pre-commit detection is by file presence only; YAML is not parsed.
  • Databases are inferred from driver packages only.
  • Pipfile, setup.py, Cargo.toml, go.mod, Gemfile, composer.json, pom.xml and Gradle files produce no dependency findings. Rails is not detected.
  • A pip and an npm package with the same name share one finding.
  • On POSIX, filenames that aren't valid UTF-8 can break to_json for library callers (the CLI still works). A fix is planned.
  • summary.name is the directory name, and primary_framework may be inferred.

Upgrade

pip install -U spawnio    # or: uv tool upgrade spawnio

Full changelog: see docs/changelog.md