{"id":47929943,"url":"https://github.com/alexk-dev/golemcore-hive","last_synced_at":"2026-04-08T23:06:01.129Z","repository":{"id":345108163,"uuid":"1183752106","full_name":"alexk-dev/golemcore-hive","owner":"alexk-dev","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-31T00:00:37.000Z","size":480,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T01:37:58.122Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexk-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-16T23:17:56.000Z","updated_at":"2026-03-31T00:00:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alexk-dev/golemcore-hive","commit_stats":null,"previous_names":["alexk-dev/golemcore-hive"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/alexk-dev/golemcore-hive","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-hive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-hive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-hive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-hive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexk-dev","download_url":"https://codeload.github.com/alexk-dev/golemcore-hive/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-hive/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31391079,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-04-04T07:14:57.719Z","updated_at":"2026-04-04T07:15:00.453Z","avatar_url":"https://github.com/alexk-dev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Golemcore Hive\n\nSelf-hosted orchestration and control plane for `golemcore-bot` runtimes.\n\n## Stack\n\n- Spring Boot 4.0\n- Java 25\n- Maven\n- React + TypeScript\n- Tailwind CSS 3\n- Local JSON persistence\n\n## What is implemented\n\n- operator auth with access JWT + refresh JWT cookie\n- bot enrollment, machine JWT rotation, fleet registry, roles, and heartbeats\n- board flows, board teams, cards, card-bound threads, and command dispatch\n- lifecycle signal ingestion from golems\n- approval gates for destructive or high-cost commands\n- audit history, budget snapshots, notification events, and production guardrails\n\n## Local development\n\n### Backend\n\n```bash\n./mvnw test\n./mvnw spring-boot:run\n```\n\n### Frontend\n\n```bash\ncd ui\nnvm use\nnpm ci\nnpm run test\nnpm run build\nnpm run dev\n```\n\nThe Vite dev server proxies `/api` and `/ws` to the backend on `http://localhost:8080`.\n\nDefault bootstrap operator:\n\n- username: `admin`\n- password: `change-me-now`\n\nOverride bootstrap credentials in `src/main/resources/application.yml` or environment-backed Spring properties before using the app outside local development.\n\n## Storage layout\n\nHive stores state under `hive.storage.base-path`, defaulting to `./data/hive`.\n\nImportant directories:\n\n- `operators/`\n- `auth/refresh-sessions/`\n- `auth/golem-refresh-sessions/`\n- `golems/`\n- `golem-roles/`\n- `enrollment-tokens/`\n- `heartbeats/`\n- `boards/`\n- `cards/`\n- `threads/`\n- `thread-messages/`\n- `commands/`\n- `runs/`\n- `lifecycle-signals/`\n- `approvals/`\n- `audit/`\n- `budgets/`\n- `notifications/`\n\n## Packaging\n\nPackage the backend and built frontend together:\n\n```bash\nnvm use\n./mvnw package\n```\n\n`prepare-package` runs `npm ci`, `npm run build`, and copies `ui/dist` into the Spring Boot jar as static assets.\n\nIf you need a backend-only package during local debugging:\n\n```bash\n./mvnw -Dskip.frontend=true package\n```\n\n## Releases\n\nPushes to `main` run the conventional release workflow. When releasable commits are present, Hive:\n\n- creates the next `v*` tag with `cocogitto`,\n- builds the packaged Spring Boot jar,\n- publishes `hive-*.jar` and `sha256sums.txt` to the GitHub Release for that tag,\n- triggers container publication to `ghcr.io`.\n\nPublished image tags:\n\n- branch pushes outside `main`: short SHA only\n- `main`: `latest` and short SHA\n- release tags `v*`: `\u003cversion\u003e`, `latest`, and short SHA\n\nExample:\n\n```bash\ndocker pull ghcr.io/\u003cowner\u003e/golemcore-hive:latest\n```\n\n## Production checklist\n\n1. Copy `application-prod.example.yml` into your deployment config and replace secrets.\n2. Set a non-empty `hive.security.jwt.secret`.\n3. Enable `hive.security.cookie.secure=true`.\n4. Change the bootstrap admin password or disable bootstrap admin creation.\n5. Set `hive.deployment.production-mode=true`.\n\nWhen production mode is enabled, Hive fails fast if the JWT secret is missing, refresh cookies are not secure, or the bootstrap password still uses the local default.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexk-dev%2Fgolemcore-hive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexk-dev%2Fgolemcore-hive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexk-dev%2Fgolemcore-hive/lists"}