docs(milestone): complete scheduling-streaming (v0.3)

---ci---
project: orca
phase: 3
milestone: v0.3
status: complete
requirements:
  covered: [REQ-022, REQ-030, REQ-032]
  partial: []
---/ci---

v0.3 milestone merged to main. Includes all v0.2 work (P08-P10) that
was previously on the milestone branch but not yet merged to main, plus
the v0.3 completion work (iter.Seq streaming + doctor network/db).

v0.2 phases included: P08 (mTLS), P09 (scheduling), P10 (security scan).
v0.3 phases: P0 (pre-execution), P1 (iter.Seq streaming), P2 (doctor),
P3 (final review+ship).

Total: 40 requirements, all complete. No new go.mod dependencies.
Full test suite passes under -race. gofmt + go vet clean.
This commit is contained in:
Jon Chery
2026-08-01 20:06:47 +00:00
parent f503404dda
commit df58bc25a3
52 changed files with 5488 additions and 198 deletions
+23 -8
View File
@@ -4,6 +4,7 @@ import (
"context"
"errors"
"fmt"
"log/slog"
"net/http"
"os"
"os/signal"
@@ -13,6 +14,8 @@ import (
"github.com/spf13/cobra"
"git.cloudinit.dev/coreci/orca/internal/daemon"
"git.cloudinit.dev/coreci/orca/internal/engine"
"git.cloudinit.dev/coreci/orca/internal/store"
)
var (
@@ -22,7 +25,7 @@ var (
var daemonCmd = &cobra.Command{
Use: "daemon",
Short: "Run the orca daemon (HTTP API + health checks)",
Long: "Start the orca daemon. Listens on the configured address for health and API requests.",
Long: "Start the orca daemon. Listens on the configured address for health, API, and dispatch requests.",
RunE: func(cmd *cobra.Command, args []string) error {
db, closer, err := openDB()
if err != nil {
@@ -30,12 +33,21 @@ var daemonCmd = &cobra.Command{
}
defer closer()
log := newLogger()
srv := daemon.NewServer(daemon.Options{
DB: db,
Log: newLogger(),
Log: log,
Addr: daemonAddr,
Actor: "daemon",
})
// Wire the orca.v1.Dispatch service (v0.2 P02). The executor
// runs jobs locally; the dispatcher decides local vs peer.
executor := engine.NewExecutor(store.NewJobRepo(db), store.NewTaskRepo(db), log)
peers := engine.NewPeerRegistry()
dispatcher := engine.NewDispatcher(log, store.NewCapacityRepo(db), peers, executor)
srv.RegisterDispatch(daemon.NewDispatchHandlers(dispatcher, dispatcher.Dedupe()))
srv.MarkReady()
errCh := make(chan error, 1)
@@ -47,12 +59,14 @@ var daemonCmd = &cobra.Command{
}()
fmt.Fprintf(cmd.OutOrStdout(), "✓ orca daemon listening on %s\n", daemonAddr)
fmt.Fprintln(cmd.OutOrStdout(), " /healthz - liveness")
fmt.Fprintln(cmd.OutOrStdout(), " /readyz - readiness (db + ready flag)")
fmt.Fprintln(cmd.OutOrStdout(), " /v1/status - status JSON")
fmt.Fprintln(cmd.OutOrStdout(), " /v1/jobs - list jobs")
fmt.Fprintln(cmd.OutOrStdout(), " /v1/nodes - list nodes")
fmt.Fprintln(cmd.OutOrStdout(), " /v1/tasks - list tasks")
fmt.Fprintln(cmd.OutOrStdout(), " /healthz - liveness")
fmt.Fprintln(cmd.OutOrStdout(), " /readyz - readiness (db + ready flag)")
fmt.Fprintln(cmd.OutOrStdout(), " /v1/status - status JSON")
fmt.Fprintln(cmd.OutOrStdout(), " /v1/jobs - list jobs")
fmt.Fprintln(cmd.OutOrStdout(), " /v1/nodes - list nodes")
fmt.Fprintln(cmd.OutOrStdout(), " /v1/tasks - list tasks")
fmt.Fprintln(cmd.OutOrStdout(), " /orca.v1.Dispatch/Submit - cross-node job submit (P02)")
fmt.Fprintln(cmd.OutOrStdout(), " /orca.v1.Dispatch/Status - cross-node job status (P02)")
fmt.Fprintln(cmd.OutOrStdout(), " press Ctrl+C to stop")
ctx, stop := signal.NotifyContext(cmd.Context(), os.Interrupt, syscall.SIGTERM)
@@ -73,4 +87,5 @@ var daemonCmd = &cobra.Command{
func init() {
daemonCmd.Flags().StringVar(&daemonAddr, "addr", ":8080", "listen address")
rootCmd.AddCommand(daemonCmd)
_ = slog.Default // keep import if unused above
}