{"id":50453989,"url":"https://github.com/mizcausevic-dev/release-readiness-gatekeeper","last_synced_at":"2026-06-01T01:05:31.501Z","repository":{"id":358388022,"uuid":"1235976257","full_name":"mizcausevic-dev/release-readiness-gatekeeper","owner":"mizcausevic-dev","description":"Kotlin backend for release gate evaluation, dependency readiness scoring, freeze-window checks, and rollback-aware launch coordination","archived":false,"fork":false,"pushed_at":"2026-05-28T01:08:15.000Z","size":307,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T03:09:32.828Z","etag":null,"topics":["javalin","jvm","kotlin","platform-engineering","policy-engine","rollback"],"latest_commit_sha":null,"homepage":"https://kineticgain.com","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mizcausevic-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T20:46:44.000Z","updated_at":"2026-05-28T01:08:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mizcausevic-dev/release-readiness-gatekeeper","commit_stats":null,"previous_names":["mizcausevic-dev/release-readiness-gatekeeper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mizcausevic-dev/release-readiness-gatekeeper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Frelease-readiness-gatekeeper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Frelease-readiness-gatekeeper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Frelease-readiness-gatekeeper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Frelease-readiness-gatekeeper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mizcausevic-dev","download_url":"https://codeload.github.com/mizcausevic-dev/release-readiness-gatekeeper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Frelease-readiness-gatekeeper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33755379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javalin","jvm","kotlin","platform-engineering","policy-engine","rollback"],"created_at":"2026-06-01T01:05:31.421Z","updated_at":"2026-06-01T01:05:31.486Z","avatar_url":"https://github.com/mizcausevic-dev.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Release Readiness Gatekeeper\r\n\r\nRelease Readiness Gatekeeper is a Kotlin and Javalin backend for turning launch pressure into explicit release decisions. It models freeze windows, dependency drag, rollback posture, and error-budget pressure so teams can decide whether to ship, watch, or hold without relying on vague release calls.\r\n\r\n## Portfolio Takeaway\r\n\r\n- Kotlin backend with release policy logic that feels operational, not academic\r\n- launch, freeze, and rollback posture turned into concrete ship decisions\r\n- simple JSON API with docs, tests, CI, and real PNG proof\r\n\r\n## Overview\r\n\r\n| Area | Details |\r\n| --- | --- |\r\n| Language | Kotlin 2.0 |\r\n| Runtime | Java 21 |\r\n| Server | Javalin |\r\n| Focus | Release gate evaluation, dependency readiness, freeze-window pressure, rollback guidance |\r\n| Routes | `/`, `/docs`, `/api/dashboard/summary`, `/api/releases`, `/api/releases/{id}`, `/api/sample`, `/api/analyze/release` |\r\n| Validation | `./gradlew.bat test`, `./gradlew.bat build` |\r\n\r\n## What It Does\r\n\r\n- models release threads with severity, blocked dependencies, and rollback posture\r\n- scores each payload into `stable`, `watch`, or `escalate`\r\n- returns a release decision of `ship`, `conditional-ship`, or `hold`\r\n- exposes a JSON API that can feed launch dashboards, runbooks, or internal review surfaces\r\n\r\n## Architecture\r\n\r\n```mermaid\r\nflowchart LR\r\n  A[\"Release thread intake\"] --\u003e B[\"Javalin routes\"]\r\n  B --\u003e C[\"Release readiness engine\"]\r\n  C --\u003e D[\"Risk scoring\"]\r\n  C --\u003e E[\"Release decision\"]\r\n  C --\u003e F[\"Owner-facing next action\"]\r\n  D --\u003e G[\"JSON response\"]\r\n  E --\u003e G\r\n  F --\u003e G\r\n```\r\n\r\nAdditional detail lives in [docs/architecture.md](./docs/architecture.md).\r\n\r\n## API\r\n\r\n### `GET /`\r\nReturns service metadata and route discovery.\r\n\r\n### `GET /docs`\r\nReturns a lightweight HTML operator guide.\r\n\r\n### `GET /api/dashboard/summary`\r\nReturns queue posture and aggregate release pressure.\r\n\r\n### `GET /api/releases`\r\nReturns the modeled release threads.\r\n\r\n### `GET /api/releases/{id}`\r\nReturns a single release thread.\r\n\r\n### `GET /api/sample`\r\nReturns a sample release analysis.\r\n\r\n### `POST /api/analyze/release`\r\nScores a payload and returns the recommended action.\r\n\r\nExample payload:\r\n\r\n```json\r\n{\r\n  \"id\": \"rel-9502\",\r\n  \"title\": \"Checkout patch is entering a freeze window with unresolved tax retries\",\r\n  \"service\": \"checkout-runtime\",\r\n  \"severity\": \"critical\",\r\n  \"releaseWindowHours\": 1.25,\r\n  \"errorBudgetRemaining\": 0.16,\r\n  \"blockedDependencies\": 3,\r\n  \"rollbackReady\": false,\r\n  \"freezeWindowActive\": true,\r\n  \"ownerLane\": \"platform-release\",\r\n  \"blockers\": [\r\n    \"Rollback artifact is not validated in-region\",\r\n    \"Tax service retries are still above tolerance\"\r\n  ],\r\n  \"nextSteps\": [\r\n    \"Assign a rollback owner\",\r\n    \"Pause the release lane\"\r\n  ]\r\n}\r\n```\r\n\r\n## Screenshots\r\n\r\n### Hero\r\n![Release Readiness Gatekeeper hero](https://raw.githubusercontent.com/mizcausevic-dev/release-readiness-gatekeeper/main/screenshots/01-hero.png)\r\n\r\n### Decision Lanes\r\n![Release Readiness Gatekeeper decision lanes](https://raw.githubusercontent.com/mizcausevic-dev/release-readiness-gatekeeper/main/screenshots/02-decision-lanes.png)\r\n\r\n### Escalation View\r\n![Release Readiness Gatekeeper escalation view](https://raw.githubusercontent.com/mizcausevic-dev/release-readiness-gatekeeper/main/screenshots/03-escalation.png)\r\n\r\n### Validation Proof\r\n![Release Readiness Gatekeeper proof](https://raw.githubusercontent.com/mizcausevic-dev/release-readiness-gatekeeper/main/screenshots/04-proof.png)\r\n\r\n## Local Run\r\n\r\n```powershell\r\ncd release-readiness-gatekeeper\r\n$env:JAVA_HOME = \"C:\\Program Files\\Microsoft\\jdk-21.0.11.10-hotspot\"\r\n$env:Path = \"$env:JAVA_HOME\\bin;$env:Path\"\r\n.\\gradlew.bat run\r\n```\r\n\r\nThen open:\r\n\r\n- `http://127.0.0.1:4428/`\r\n- `http://127.0.0.1:4428/docs`\r\n\r\nIf that port is already occupied, choose another one before running:\r\n\r\n```powershell\r\n$env:PORT = \"4432\"\r\n.\\gradlew.bat run\r\n```\r\n\r\n## Validation\r\n\r\n```powershell\r\ncd release-readiness-gatekeeper\r\n$env:JAVA_HOME = \"C:\\Program Files\\Microsoft\\jdk-21.0.11.10-hotspot\"\r\n$env:Path = \"$env:JAVA_HOME\\bin;$env:Path\"\r\n.\\gradlew.bat test\r\n.\\gradlew.bat build\r\n```\r\n\r\n## Tech Stack\r\n\r\n[![Kotlin](https://img.shields.io/badge/Kotlin-2.0-0f172a?style=for-the-badge\u0026logo=kotlin\u0026logoColor=f8fafc)](https://kotlinlang.org/)\r\n[![Javalin](https://img.shields.io/badge/Javalin-6.6-0f172a?style=for-the-badge\u0026logo=java\u0026logoColor=f8fafc)](https://javalin.io/)\r\n[![Gradle](https://img.shields.io/badge/Gradle-8.x-0f172a?style=for-the-badge\u0026logo=gradle\u0026logoColor=f8fafc)](https://gradle.org/)\r\n\r\n## Portfolio Links\r\n\r\n- [Kinetic Gain](https://kineticgain.com/)\r\n- [LinkedIn](https://www.linkedin.com/in/mirzacausevic)\r\n- [GitHub](https://github.com/mizcausevic-dev)\r\n- [Skills Page](https://mizcausevic.com/skills/)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmizcausevic-dev%2Frelease-readiness-gatekeeper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmizcausevic-dev%2Frelease-readiness-gatekeeper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmizcausevic-dev%2Frelease-readiness-gatekeeper/lists"}