stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 3 Releases Wiki Activity

Restructure solution layout by module

Browse Source
This commit is contained in:
master
2025-10-28 15:10:40 +02:00
parent 95daa159c4
commit d870da18ce
4103 changed files with 192899 additions and 187024 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
src/Orchestrator/StellaOps.Orchestrator.WorkerSdk.Go/AGENTS.md Normal file
View File

@@ -0,0 +1,10 @@
# Worker SDK (Go) — Agent Charter
## Mission
Provide the official Go SDK for StellaOps orchestrated workers. Implement claim/heartbeat/progress clients, artifact publishing, error classification, and guardrails so Concelier, Excititor, SBOM, Policy, and other teams can integrate with the orchestrator deterministically.
## Responsibilities
- Maintain idiomatic Go client with configurable transports, retries, and tenant-aware headers.
- Surface structured metrics/logging hooks mirroring orchestrator expectations.
- Enforce idempotency token usage, artifact checksum publication, and backfill/watermark handshakes.
- Coordinate release cadence with Worker Python SDK, orchestrator service, DevOps packaging, and Offline Kit requirements.

9
src/Orchestrator/StellaOps.Orchestrator.WorkerSdk.Go/TASKS.md Normal file
View File

@@ -0,0 +1,9 @@
# Worker SDK (Go) Task Board — Epic 9
| ID | Status | Owner(s) | Depends on | Description | Exit Criteria |
|----|--------|----------|------------|-------------|---------------|
| WORKER-GO-32-001 | TODO | Worker SDK Guild | ORCH-SVC-32-005 | Bootstrap Go SDK project with configuration binding, auth headers, job claim/acknowledge client, and smoke sample. | `go test ./...` green; sample worker claims job against local orchestrator; README outlines usage; compliance checklist recorded. |
| WORKER-GO-32-002 | TODO | Worker SDK Guild | WORKER-GO-32-001 | Add heartbeat/progress helpers, structured logging hooks, Prometheus metrics, and jittered retry defaults. | Heartbeat/progress methods documented; metrics exported; integration test verifies heartbeat timeout handling; lint/staticcheck clean. |
| WORKER-GO-33-001 | TODO | Worker SDK Guild | WORKER-GO-32-002, ORCH-SVC-33-003 | Implement artifact publish helpers (object storage client, checksum hashing, metadata payload) and idempotency guard. | Artifact upload API tested with fake object store; idempotency violations return typed error; docs include sample. |
| WORKER-GO-33-002 | TODO | Worker SDK Guild | WORKER-GO-32-002 | Provide error classification/retry helper, exponential backoff controls, and structured failure reporting to orchestrator. | Error helper maps to orchestrator error classes; retries configurable; integration test covers HTTP 5xx, validation errors; docs updated. |
| WORKER-GO-34-001 | TODO | Worker SDK Guild | WORKER-GO-33-001, ORCH-SVC-34-001 | Add backfill range execution helpers, watermark handshake utilities, and artifact dedupe verification for backfills. | Backfill helper handles window chunks; watermark handshake verified in integration test; dedupe proof recorded; offline kit sample updated. |