Skip to content

v0.3.0 — Lifecycle API v2, unified lock protocol

Choose a tag to compare

View all tags
@kolkov kolkov released this 12 Sep 13:15
· 14 commits to main since this release
v0.3.0
6bc8d2c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Lifecycle API v2 -- unified lock protocol. All lifecycle mutations serialize on a single startup lock. One internal path, two public semantics.

Breaking Changes

  • Start(ctx, binary, args) error → Start(ctx) (*Info, error)
  • Restart(ctx, binary, args) error → Restart(ctx) (*Info, error)
  • EnsureRunning(ctx, cfg, binary, args) (int, error) → method d.EnsureRunning(ctx) (*Info, error); package-level EnsureRunning(ctx, cfg) (int, error) kept as convenience wrapper
  • KillProcess(pid int) error → KillProcess(ctx, pid, grace) error -- context-aware with configurable timeout
  • Config gains Binary and Args fields -- daemon identity in config, not per-call params. Binary defaults to os.Executable()
  • Stop(ctx) now serialized on startup lock

Added

  • Unified lock protocol (ADR-002): startLocked/stopLocked internal methods; public methods never call other public methods (prevents OFD deadlock)
  • Config.Validate() enforced: called in Start, EnsureRunning, Stop, Restart, Serve -- path traversal rejected before any file I/O
  • Proxy IsHeld pre-check: dead daemon returns ErrNotRunning immediately instead of connection refused
  • InheritFD EWOULDBLOCK: documented and tested same-OFD re-flock behavior
  • Windows IsHeld: uses OPEN_EXISTING -- no empty file creation on probe
  • Orphan child killed on start failure (D8): KillProcess + log tail in error diagnostics
  • CI: actions upgraded to Node 24 (checkout@v7, setup-go@v7, codecov@v7, golangci-lint@v9), Dependabot for actions, cache: false for zero-deps module

Changed

  • EnsureRunning is now a method on *Daemon (testable with NewWithDeps)
  • All mutating methods return *Info (pid, port, start time in one call)
  • Restart runs stopLocked + startLocked under a single lock acquisition

Validation

  • Fable 5.1: 8 harness scenarios green -- concurrent Start (3 goroutines), Restart under parallel EnsureRunning (33 calls, 0 errors), D8 orphan kill, path traversal rejection
  • CI: 8/8 checks green (build/test/lint/fmt × 3 OS including Windows with -race)

Full Changelog: v0.2.0...v0.3.0

Assets 2
Loading