Skip to content

Devostasis 0.1.0

Choose a tag to compare

View all tags
@drevendev drevendev released this 05 Sep 20:18
· 52 commits to master since this release
v0.1.0
c532242
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

First release: deterministic, model-free vital signs for software repositories.

Highlights

  • Seven Vitals under the accepted PV-VITALS-V1-002 taxonomy: Pulse, Flow, Integrity, Clutter, Horizon, Direction, Debt. Named bands, explicit UNKNOWN and DEGRADED bounds, declared correlations, no aggregate score.
  • Observation contract RAW-OBS-V0: every fact carries a status (AVAILABLE, PARTIAL, UNAVAILABLE, FORBIDDEN, UNKNOWN, ERROR), a freshness and a receipt. Zero is only ever a positively observed value.
  • Integrity implements PV-CI-UNIT-004: revision-level verdicts, provider-native parent identity, greatest-attempt current state, failure-sticky history. Retry-until-green cannot erase a failure.
  • Read-only GitHub adapter on the standard library, sized for very active repositories; pagination caps become PARTIAL, tier and permission failures become UNAVAILABLE / FORBIDDEN.
  • Immutable bundles (devostasis.bundle.v2): manifest, snapshot, delta, activity, observations, gauges, demand, persisted effective config and a deterministic Markdown report; SHA-256 identity over an acyclic preimage; devostasis verify needs nothing outside the bundle.
  • Gauges (devostasis.gauge.v1): 0-100 position of every band on the scale of its phenomenon, persisted as gauges.json.
  • Demand interface (devostasis.demand.v1): one level per Vital from an overridable band-to-level table plus an attention order, UNRESOLVED for missing evidence, no sum.
  • Register files: planning targets and debt items from targets.json and debt.json in the observed repository, change requests linked by a Target: <id> marker; label-based debt mapping and GitHub milestones also supported.
  • Display configuration: which Vitals, which card components (bar, number, band), which report sections.
  • Append-only history store with BASELINE / COMPARABLE / HISTORY_GAP / INCOMPARABLE comparison, activity since the previous successful bundle, and a fleet overview.
  • CLI: observe, evaluate, run, build, verify, render, index, gauges, demand.
  • 127 conformance and unit tests named after the research cases they implement; CI on Python 3.12, 3.13 and 3.14.

Install

pip install git+https://github.com/drevendev/devostasis@v0.1.0

See docs/deployment.md for the daily GitHub Actions setup with a companion history repository, and ROADMAP.md for what is deliberately deferred (GitLab, instruments, HTML report, custom templates, themes).

🤖 Generated with Claude Code

Assets 2
Loading