HomeLab/ForgeBucket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
4f2fb846dd448f360a18d2f19d562bd57f072585
ForgeBucket/CHANGELOG.md
T

9.7 KiB
Raw Blame History

Changelog

All notable changes to ForgeBucket are documented here.

Format follows Keep a Changelog. Versions follow Semantic Versioning.

Unreleased

In Progress — Phase 2C (CI Legibility)

  • Pipeline DAG visualization (PipelineRunPage with real job/step graph)
  • Dashboard CI command center upgrade (replace placeholder with live recent runs)
  • Command palette wiring (pipeline runs in search, Pipelines quick-nav)
  • Global cross-repo pipeline runs feed (/pipelines page)
  • Per-step log viewer (collapsible, streamed from backend)

Planned — Phase 3 (GitOps + Observability + Federation)

  • GitOps controller with reconciliation loops
  • Environment model + deployment tracking
  • Unified operational timeline (commits + deployments + CI failures merged)
  • Drift detection and sync status
  • Deployment promotion workflows (dev → staging → production)
  • Rollback visualization and one-click rollbacks
  • Canary and blue/green deployment support
  • ActivityPub / ForgeFed federation handlers (inbox, outbox, cross-instance PRs)
  • Secret management hierarchy (Global → Org → Repo → Env)
  • Observability (Prometheus endpoint, health sparklines)

Planned — Phase 4

  • AI diagnostics (pipeline failure root-cause analysis)
  • Signed artifacts (Sigstore/Cosign)
  • OCI package registry
  • Secret and dependency vulnerability scanning

0.3.0 — 2026-05-11

Phase 2B complete. Full CI/CD execution backend operational.

Added — CI Orchestrator (internal/domain/ci/)

  • DAG-based pipeline orchestrator (orchestrator.go): subscribes to NATS push.received, parses .forgebucket/workflows/*.yml, creates PipelineRun/PipelineJob/PipelineStep records, advances DAG on job.completed/job.failed, recovers stale runs on startup
  • Docker executor (executor.go): runs steps in isolated containers (docker run --rm), streams logs to DB and NATS via pipeline.log subject, handles git archive workspace extraction
  • Runner manager (runner_manager.go): semaphore-limited concurrent job dispatch (default 4), subscribes to job.queued, calls executor when Docker is available
  • DAG engine (dag.go): full topological sort (TopoSort) and ReadyJobs for dependency resolution
  • Workflow parser (parser.go): reads .forgebucket/workflows/*.yml from git ref, MatchesPushTrigger with glob pattern support
  • CI types (types.go): WorkflowFile, WorkflowJob, WorkflowStep, YAML StringOrSlice unmarshaler

Added — CI API Handlers

  • GET /api/v1/repos/:owner/:repo/pipelines — list pipeline definitions
  • GET /api/v1/repos/:owner/:repo/runs — list pipeline runs (most recent first, limit 30)
  • GET /api/v1/repos/:owner/:repo/runs/:runID — run detail with full job + step tree
  • POST /api/v1/repos/:owner/:repo/runs/:runID/cancel — cancel queued or running run
  • POST /api/v1/repos/:owner/:repo/runs/:runID/jobs/:jobID/retry — re-queue failed/cancelled job
  • GET /api/v1/repos/:owner/:repo/runs/:runID/jobs/:jobID/logs — step-level log chunks
  • GET /api/v1/repos/:owner/:repo/runs/:runID/artifacts — list artifacts for a run
  • POST /api/v1/repos/:owner/:repo/runs/:runID/artifacts — upload artifact (multipart, 512 MB max)
  • GET /api/v1/repos/:owner/:repo/artifacts/:artifactID/download — artifact download with path traversal guard
  • GET /api/v1/admin/runners — list registered runners (admin-only)
  • POST /api/v1/admin/runners/register — register a new runner with bcrypt token hashing (admin-only)

Added — Database Models (migration 009_ci)

  • Pipeline — workflow definition record (name, filePath, repoId)
  • PipelineRun — execution record (triggerRef, triggerSha, triggeredBy, status, startedAt, finishedAt)
  • PipelineJob — single DAG node (name, image, needs JSON, status, timing)
  • PipelineStep — single command within a job (seq, runCmd, usesAction, exitCode, timing)
  • PipelineStepLog — append-only log chunk storage (stepId, chunkIndex, content)
  • Runner — registered execution backend (name, labels, status, tokenHash, lastSeenAt)
  • Artifact — build artifact (runId, repoId, name, storagePath, size, contentType)

0.2.0 — 2026-05-11

Phase 2A complete. Real-time event infrastructure and audit log operational.

Added — NATS Event Bus (internal/events/)

  • EventBus interface: Publish, Subscribe, Close
  • NATSBus: NATS-backed implementation with auto-reconnect, max-reconnect disabled
  • NoOpBus: silent fallback when NATS_URL is not configured (app fully functional without NATS)
  • New(url) factory: returns NATSBus if URL is set, NoOpBus otherwise
  • Event subjects defined in subjects.go:
    • repo.* (created, deleted, pushed)
    • push.received
    • pr.* (opened, merged, closed)
    • issue.* (opened, closed)
    • pipeline.* (queued, started, succeeded, failed, cancelled)
    • job.* (queued, started, completed, failed), pipeline.log
    • deployment.*, environment.* (Phase 3 stubs)
    • audit.event

Added — WebSocket Hub (internal/api/handlers/ws.go)

  • GET /ws — upgrades HTTP to WebSocket (nhooyr.io/websocket)
  • Subscribes to all NATS subjects on connect, fans events to the client as JSON
  • Optional session auth (auth.Optional middleware) — works for guests too
  • Phase 2B note: per-user event filtering is a planned upgrade

Added — Audit Log

  • AuditLog model (migration 008_audit_log): actor, method, path, statusCode, requestBody, ipAddr, timestamp
  • AuditLog middleware: records every authenticated request to the DB and publishes audit.event
  • GET /api/v1/audit — paginated audit log query (admin-only, filterable by actor/method/time range)

Fixed — Local development environment

  • DATABASE_URL was using Docker-internal hostname postgres; corrected to localhost for make dev
  • Added NATS_URL=nats://localhost:4222 to .env (was missing; CI orchestrator requires it)
  • REPO_ROOT corrected to /tmp/forgebucket/repos (Docker path /var/lib/forgebucket/repos requires sudo on macOS)

0.1.0 — 2026-05-11

Initial development milestone. Core Git hosting, collaboration, and frontend SPA are functional.

Added — Authentication & Security

  • User registration and login with secure session cookies
  • CSRF protection on all mutating routes via X-CSRF-Token header
  • Middleware chain: Logger → RealIP → Recoverer → CORS → CSRF → SessionAuth → RBAC → Handler
  • SSH key management per user
  • OIDC / OAuth2 optional integration (configurable via env)
  • Scoped access tokens with optional expiration dates
  • Repository deploy keys (read-only or read-write HTTP tokens)
  • ENV-driven config with fail-fast validation on missing secrets

Added — Git Hosting

  • Smart HTTP transport (git clone, push, pull over HTTP)
  • AGit protocol support (refs/for/ push for instant PR creation without branch switching)
  • Branch management (list, create, delete, default branch configuration)
  • Commit log and diff viewing
  • Git LFS per-repository (configurable file size limits, locking)
  • Branch protection rules (force-push blocking, required reviews)
  • Repository visibility (public / private)

Added — Collaboration

  • Pull requests (open / merged / closed states) with author tracking
  • Issues (open / closed)
  • Reviewer assignment (default reviewer per repo, per-PR reviewer assignment)
  • Merge strategy selection per repository (merge commit / squash / rebase)
  • Branching model configuration (feature / bugfix / release / hotfix prefixes)
  • PR default description templates (per-repo)
  • Excluded files from diffs (glob pattern configuration)
  • Webhook system with event filtering (push, pull_request, issue)
  • Repository member RBAC (read / write / admin roles)

Added — Frontend SPA

  • React 18 + TypeScript + Vite, embedded into Go binary via //go:embed
  • 20 route-level pages: Login, Register, Dashboard, Repos, CreateRepo, ImportRepo, Repo, RepoSettings, Blob, Commits, Branches, RepoIssues, RepoPRs, CreatePR, PRDetail, Starred, PRs (cross-repo), Pipelines (placeholder), Explore, Profile, Settings
  • AppShell layout wrapper for all authenticated pages
  • Triple-state sidebar: expanded (320px) / collapsed (56px) / mobile bottom bar
  • Mobile-first responsive design (375px → 1440px)
  • DiffViewer: side-by-side and unified views with syntax highlighting
  • MobileComment: bottom-sheet overlay for inline code review on mobile
  • TreeBrowser: repository file tree navigation
  • PipelineWaterfall: placeholder pipeline visualization component
  • Skeleton loading states for perceived performance

Added — Design System

  • Custom semantic token palette in frontend/src/ui/tokens.ts
  • Full dark/light mode support via Tailwind CSS v4 @variant dark
  • Brand colors: #0052CC (light) / #3B82F6 (dark)
  • 8px grid system (xs: 4px, sm: 8px, md: 16px, lg: 24px, xl: 32px, xxl: 48px)
  • 44px minimum touch targets on all interactive elements (WCAG 2.5.5)
  • Consistent border radius scale (subtle 3–8px, full 9999px)
  • System font stack (Segoe UI, Roboto, sans-serif)

Added — Infrastructure

  • PostgreSQL + XORM with 7 migration files covering: users, repositories, issues, SSH keys, access tokens, deploy keys, workflows, and LFS settings
  • ActivityPub actor data model (FederationActor with inbox/outbox URLs and RSA key pairs) — data layer only
  • Docker Compose setup for local PostgreSQL + NATS
  • Makefile targets: dev, build, migrate, test, lint, docker-up
  • WebSockets foundation for live logs and notifications
Reference in New Issue View Git Blame Copy Permalink