Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.
[1.2.0] - 2026-08-15
π Production Readiness Release
- Full-stack E2E proof (
scripts/e2e-proof.sh, 20 checks): real git push β workflow β CI success (Docker), PR + squash merge, OAuth provider flow, org invites + transfer, org-owned repo APIs β all green against Postgres + Redis. - Git protocol fixes (found by the proof): post-receive hooks now fire (stdin newline + capability stripping), receive-pack status on sideband band 1 with nested pkt-line framing + inner flush β real
git pushcompletes cleanly. - CI engine: parallel job waves with
needsordering, matrix expansion, cron scheduler, GITHUB_OUTPUT/GITHUB_ENV, repo secrets injection, Docker image auto-pull, speculative-build CI execution, docker actions (uses: docker://) on self-hosted runners, action resolver for composite actions + checkout. - Configuration:
.envno longer shadows real environment variables; Redis uses static imports (distributed rate limiting + locks actually active). - Collaboration: issue assignees/milestones/custom-fields/workflow transitions wired, PR labels + assignees + requested-reviewers, draft PRs, merge-method selection, review-thread resolution, @mentions, issue templates, real contribution graph, watch/unwatch.
- Security: OAuth provider mode (authorization-code + refresh-token grants, userinfo), fine-grained PAT scopes with implication, GitHub/Google login, org SAML config, org-aware permission resolution everywhere.
- Organizations: CRUD + pages, member invites, teams, repo transfer (API + UI), org-owned repos work across all routes/pages.
- DX: GraphQL expansion (issues/orgs/labels mutations), OpenAPI 100% coverage (275 routes) with an idempotent generator + CI gate, npm registry protocol completion (login/whoami/publish/metadata/tarballs).
- Observability: per-request correlation IDs bound to every log line; OTLP transport for Grafana Cloud.
- Quality: authz matrix suite (43 cases, scope-implication fix), multi-instance chaos suite, load baseline green (p95 β€136ms at 20-concurrency), DR drills, wiring-audit gate, contract/smoke lanes.
- CLI:
opencodehub-cli1.2.0.
[1.1.2] - 2026-08-10
π‘οΈ Quality Gates (Phase 0 of production-parity plan)
- CI lanes: Added real
Contract Tests (Lane: contract)andSmoke Tests (Lane: smoke)jobs; branch ruleset now requires job names that exist. - Contract suite: New
tests/contract/β pkt-line protocol, webhook HMAC (GitHub-vector pinned), workflow trigger semantics, OpenAPI shape (27 tests). - Smoke suite: New
tests/smoke/β boot-critical module wiring (env validation, storage, db, auth, git) (6 tests). - Coverage: vitest now emits
coverage-summary.json+lcov.info; the CI threshold check is no longer a silent no-op. - Disaster-recovery drills: Implemented
drill:backup-restore,drill:redis,drill:postgresscripts that the weekly-drills workflow was already calling. - Versioning: Root package unified to 1.1.2 (was 1.0.0), matching the CLI.
- GitHub-Actions glob fix:
**in branch/path filters now spans directories correctly (previously collapsed to a single level);on: workflow_dispatchshorthand triggers now work;!-negation inpaths:filters is honored. - OpenAPI: Documented previously-missing core paths (
/repos,/repos/{owner}/{repo}/issues,/issues/{number},/branches,/labels).
[1.1.0] - 2026-01-22
π Documentation (Major Overhaul)
- Structure: Reorganized
docs/into a comprehensive knowledge base (getting-started,guides,tutorials,api,administration). - Visuals:
- Added Mermaid.js C4 Architecture diagrams.
- Added Git Graph diagrams for workflow comparisons.
- Created custom SVGs for
stack-workflowandarchitecture.
- New Guides:
- Production Installation: Detailed hardware specs, Nginx config, and go-live checklist.
- API Reference: Swagger-style documentation with JSON examples and parameter tables.
- Troubleshooting: Solutions for common errors (Docker, 403s, Database).
- CLI Reference: Unified command list for
opencodehub-cli. - Glossary: Definitions for core terms like "Stacked PRs" and "Merge Queue".
π» CLI (v1.1.0)
- UI Polish:
- Implemented "Dracula" theme for consistent coloring.
- Added ASCII art logo and gradient banners.
- Replaced raw logs with animated spinners (
ora) and progress bars. - Added "Success Boxes" for clearer operation summaries.
- Commands:
och stack view: Now displays a visual ASCII tree of the current stack.och push: Shows PR compilation status and links.
π‘ Security & Fixes
- Authorization: Fixed critical bypass in
issues/index.tsandcollaborators/index.ts. - Fixes: Resolved incorrect binary path in CLI package.json.
- Repo Links: Updated hardcoded GitHub links to the official repository.
[0.2.0] - 2026-01-21
Added
- Cloudflare R2 Storage Integration:
- Full support for Cloudflare R2 as a repository storage backend.
- Configure with
STORAGE_TYPE=s3and R2-specific environment variables. - Repositories are automatically uploaded to R2 on creation.
- Repositories are automatically deleted from R2 on deletion.
- Git clone/push operations now work with cloud-stored repositories.
- UI Modernization:
- Added global toast notification system using
sonnerpackage. - Created
src/components/ui/sonner.tsxShadcn UI wrapper. - Added
<Toaster />component toBaseLayout.astrofor app-wide notifications. - New
RepoSettings.tsxReact component for repository settings management. - Replaced native
alert()andconfirm()with ShadcnAlertDialogcomponents.
- Added global toast notification system using
- New Pages & Features:
src/pages/insights.astro- Platform-wide analytics dashboard.src/pages/merge-queue.astro- Merge queue management interface.src/pages/settings/ai-review-rules.astro- AI code review configuration.src/pages/settings/automations.astro- Workflow automation settings.src/pages/settings/notification-preferences.astro- User notification settings.src/pages/api/user/notification-preferences.ts- New API endpoint.
Changed
- Database: Migrated all schema files to use
pgTablewith PostgreSQL types. - API Routes: Standardized logging and error handling across 60+ API files.
- Drizzle ORM: Automated TypeScript casting fixes across the codebase.
- Repository Creation: Made cloud storage sync asynchronous for faster API responses.
- Git Operations: Refactored
initRepositoryto separate cloud storage concerns from git initialization.
Fixed
- Cloud Storage: Fixed
S3StorageAdapterincorrectly prepending base path to S3 keys (causedNoSuchKeyerrors). - Cloud Storage: Fixed
uploadRepoToStorageuploading 0 files due to duplicateinitRepoInStoragecalls. - Cloud Storage: Fixed
triggerRepoWorkflowsfailing with "directory does not exist" for R2-backed repos. - Cloud Storage: Fixed repository deletion not cleaning up objects from R2 storage.
- Git Backend: Fixed
git cloneandgit pushoperations for cloud-stored repositories. - Git Operations: Added
resolveRepoPathfor resolving logical cloud paths to local temp directories. - Admin Pages: Fixed TypeScript errors in
admin/settings.astroandadmin/users.astro. - Tree Pages: Fixed layout issues by replacing missing
RepositoryLayout.astro. - API: Fixed Drizzle ORM "count" property errors in admin pages.
- Stacks API: Fixed TypeScript type limitations.
Security
- Postgres Support: Full PostgreSQL support with
node-postgresdriver. - Environment Variables: Improved
isCloudStorage()detection usingSTORAGE_TYPEenv directly.
[0.1.0] - 2026-01-14
Added
- Initial release of OpenCodeHub.
- Basic repo management, issue tracking, and PR workflow.