Skip to content

unit27research/release-desk

Repository files navigation

Release Desk

Release Desk is a small local Rails app for reviewing whether a public release candidate is structured enough for human release review.

It is built around a simple Unit27 posture: proof before claim, boundary before scale, review before release.

What It Does

Release Desk tracks whether a public release has visible claims, supporting artifacts, boundary notes, and approval gates.

It gives a release candidate one editable local review surface:

  • public claims that need evidence boundaries
  • artifact manifests that describe what exists locally
  • checklist gates that must be closed before release
  • review notes for unresolved risks or manual decisions

The first version is intentionally small. It ships with synthetic seed data and a minimal local CRUD loop so a user can create a release review, add claims and artifacts, mark gates open or done, and keep boundary notes visible before any public push, post, or upload.

What It Does Not Do

Release Desk is not a verifier, fact-checker, fraud detector, certification system, compliance tool, legal tool, medical tool, or truth oracle.

It does not prove a repo is safe to release. It does not replace human review. It makes release boundaries easier to inspect before a human makes the call.

Who It Is For

  • builders preparing public repos
  • researchers preserving evidence boundaries in release copy
  • operators checking whether proof, claims, and approvals still match
  • teams that want a quiet review surface before public release

Run Locally

Requirements:

  • Ruby 4.0.5
  • Bundler
  • SQLite

Use a Ruby version manager or Homebrew Ruby that honors .ruby-version. The macOS system Ruby is too old for this Rails app.

Install dependencies:

bundle install

Prepare the local database:

bin/rails db:setup

Run the app:

bin/rails server

Then open http://localhost:3000.

Use The Desk

From the local app, you can:

  • create a release review
  • edit the release frame
  • add, edit, or remove claims
  • add, edit, or remove supporting artifact records
  • add, edit, or remove release gates
  • add, edit, or remove boundary notes

The app stores records in local SQLite. It has no accounts, roles, remote publishing, deployment workflow, or collaboration layer.

Test And Review

Run the test suite:

bin/rails test

Run style and security checks:

bin/rubocop
bin/brakeman --no-pager
bin/bundler-audit

Synthetic Demo

The seeded demo uses a synthetic repo release review. It includes:

  • one bounded claim
  • one artifact manifest record
  • required release gates
  • a boundary note stating that an artifact record does not prove the claim

The sample is for local inspection only. It contains no real client, employer, school, family, or private data.

Standing Boundary

Release Desk is a local review aid. It can organize claims, artifacts, notes, and gates, but it does not decide whether a release should happen.

For this repository's own release checklist, see RELEASE_CHECKLIST.md.

About

Local release review surface for public claims, artifact records, boundary notes, and approval gates.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors