Skip to content

Mainspring v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@dlogvinenko dlogvinenko released this 16 Jun 09:22
v1.0.0
This tag was signed with the committer’s verified signature.
dlogvinenko Dmitri Logvinenko
GPG key ID: AA7468C0D0227848
Verified
Learn about vigilant mode.
4d365cc

Mainspring v1.0.0 is the first public source release of a PRD-first AI coding agent orchestration tool for production-grade software delivery.

It is built for teams and solo operators who want autonomous coding work to stay planned, reviewable, observable, and auditable instead of turning into untracked prompt drift.

Install from source

git clone https://github.com/dlogvinenko/mainspring.git
cd mainspring
make install-user
mainspring --help

For a source checkout without installing globally:

./mainspring.sh --help
./mainspring.sh init your-project-name

What is included

  • PRD-first workflow commands: init, decompose, scope-check, next, and validate-prd.
  • Agent orchestration runtime with solo and team execution paths, scoped write checks, wave logs, and replayable evidence.
  • Hard reviewer gate with structured review parsing and fail-closed behavior when review output is missing or malformed.
  • Taskmaster-aware backlog integration for PRD-backed implementation loops.
  • Read-only HUD for current run state, Taskmaster progress, notifier health, quotas, and recent wave evidence.
  • Provider registry covering Codex, Claude, Gemini, Grok, OpenAI, Anthropic, Azure, OpenRouter, Mistral, and Ollama routes through local adapters and LiteLLM-backed providers.
  • Telegram notification support with health checks, deduplication, rate limiting, daily digest, and safe restart behavior.
  • Generated docs site and public operator documentation for setup, workflows, metrics, architecture, and recovery.

Verification

The release commit is 4d365cc1d5531aa772d41eb8766e34515c788f16.

Validated before publication:

  • make release-check
  • 1124 Python tests passed, 1 skipped
  • 223 Bats tests passed
  • Python coverage gate passed at 90.6%
  • package smoke passed, including source archive bootstrap behavior without .git
  • dependency audit passed
  • PRD validation passed
  • GitHub Actions CI passed on Linux and macOS for this release commit
  • GitHub Pages docs deployment passed for this release commit
  • Published release tarball smoke passed after download from GitHub Releases

Signature

The v1.0.0 tag is signed with GPG fingerprint 10E666081234F2901CF09A68AA7468C0D0227848.
The public key is attached to this release as mainspring-release-gpg-public-key-10E666081234F2901CF09A68AA7468C0D0227848.asc.

Notes

This is a source-install release. Package-manager distribution and benchmark result pages are intentionally left out until they have separate release evidence.

Assets 6
Loading