v1.0.0 “Stand” (stable core)

[greenarmor]

Bamboo v1.0.0 Release Summary

Bamboo 1.0.0 graduates into a lightweight, OpenSwoole-powered PHP microframework that keeps an Express-style developer experience while locking in the contracts needed for long-lived services.

---

Runtime and Framework Foundation

• Ships an OpenSwoole application core with:

  • Dependency injection
  • Route caching
  • Module bootstrapping
  • Optional Eloquent support

• All pre-wired by bootstrap scripts that validate configuration and register default providers before the HTTP server comes online.

• The default HTTP surface includes:

  • Landing content
  • /metrics, /healthz, /readyz
  • A concurrency demo that fans out to httpbin
  • Redis-backed job enqueue endpoint to showcase core capabilities out of the box

---

Resilience and Observability

• Global middleware standardises:

  • Request IDs
  • End-to-end HTTP metrics
  • Circuit breaker enforcement
  • Timeout handling

• Configuration knobs for global and per-route policies baked into the new resilience config file.

• Metrics provider exposes Prometheus counters, gauges, and histograms, with storage backends:

  • Swoole-table
  • APCu
  • In-memory

• HTTP & circuit-breaker metric classes register instruments and bucket layouts.

• Resilience provider binds shared health state and circuit-breaker registries.

• Controllers serve:

  • JSON health checks
  • Prometheus text metrics
  • Graceful fallbacks when dependencies are unavailable

---

Async Client and Integration Tooling

• PSR-18 client wrapper provides:

  • Concurrent fan-out via OpenSwoole wait groups
  • Automatic sequential fallbacks (with warnings if extension missing)
  • JSON error wrapping
  • Default headers
  • Configurable retry/backoff policies

• Application provider:

  • Attaches request-context metadata to Monolog records
  • Exposes a Predis factory
  • Binds the HTTP client facade

• Sample routes exercise bindings for:

  • Concurrent upstream calls
  • Queue writes

---

Operations and Developer Experience

• CLI kernel now freezes the dot-notation command catalogue, covering:

  • HTTP serving
  • Route inspection and caching
  • Cache purges
  • Key generation
  • Redis work queues
  • WebSockets
  • Client probes
  • Config validation
  • Scheduling
  • Dev watch
  • Package introspection

• config.validate wraps the formal configuration validator, enforcing schema rules across:

  • Server
  • Cache
  • Redis
  • HTTP client
  • App secrets
  • Metrics
  • Resilience settings

• Operational helpers:

  • Redis BLPOP worker with --once / --max-jobs safety rails
  • Inotify/Symfony Finder–backed dev watcher (supervises HTTP process with debounce, signal handling, and restart logic)
  • WebSocket echo server for quick smoke tests

---

Documentation, Starters, and Quality Tooling

• v1.0 documentation freeze includes:

  • Complete references for CLI, router, module lifecycle, configuration schema
  • Upgrade guidance
  • Performance benchmarking
  • Starter blueprints
  • Standard quick-start workflow

• Official Composer starters:

  • REST APIs
  • Queue workers
  • WebSocket gateways

• Release engineering:

  • Reproducible HTTP benchmark harness
  • Documented workflows for composer, lint, static analysis, test, and CI
  • PHP 8.2–8.4 support
  • Contracts locked post-1.0

---

---

This discussion was created from the release v1.0.0 “Stand” (stable core).