feat: Add guild charters and task boards for various components
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
- Introduced guild charters for Scanner Deno, PHP, Ruby, Native, WebService, Java, Surface.Env, Surface.FS, Surface.Secrets, Surface.Validation, UI, Zastava Observer, Zastava Webhook, Zastava Core, and Plugin Platform. - Each charter outlines the mission, scope, required reading, and working agreements for the respective guilds. - Created task boards for Surface.Env, Surface.FS, Surface.Secrets, Surface.Validation, and Zastava components to track progress and dependencies. - Ensured all documents emphasize determinism, offline readiness, security, and integration with shared Surface libraries.
This commit is contained in:
@@ -1,10 +1,21 @@
|
||||
# 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.
|
||||
# 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.
|
||||
|
||||
## Required Reading
|
||||
- `docs/modules/orchestrator/architecture.md`
|
||||
- `docs/modules/platform/architecture-overview.md`
|
||||
|
||||
## Working Agreement
|
||||
- 1. Update task status to `DOING`/`DONE` in both `docs/implplan/SPRINTS.md` and the local `TASKS.md` when you start or finish work.
|
||||
- 2. Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
|
||||
- 3. Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations.
|
||||
- 4. Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change.
|
||||
- 5. Revert to `TODO` if you pause the task without shipping changes; leave notes in commit/PR descriptions for context.
|
||||
|
||||
@@ -1,10 +1,21 @@
|
||||
# Worker SDK (Python) — Agent Charter
|
||||
|
||||
## Mission
|
||||
Publish the Python client library for StellaOps orchestrated workers. Provide asyncio-friendly claim/heartbeat/progress APIs, artifact publishing helpers, error handling, and observability hooks aligned with Epic 9 requirements and the imposed rule for cross-component parity.
|
||||
|
||||
## Responsibilities
|
||||
- Maintain typed client (httpx/async) with retry/backoff primitives mirroring orchestrator expectations.
|
||||
- Surface structured metrics/logging instrumentation and pluggable exporters.
|
||||
- Enforce idempotency token usage, artifact checksum publication, and watermark/backfill helpers.
|
||||
- Coordinate versioning with Go SDK, orchestrator service contracts, DevOps packaging, and Offline Kit deliverables.
|
||||
# Worker SDK (Python) — Agent Charter
|
||||
|
||||
## Mission
|
||||
Publish the Python client library for StellaOps orchestrated workers. Provide asyncio-friendly claim/heartbeat/progress APIs, artifact publishing helpers, error handling, and observability hooks aligned with Epic 9 requirements and the imposed rule for cross-component parity.
|
||||
|
||||
## Responsibilities
|
||||
- Maintain typed client (httpx/async) with retry/backoff primitives mirroring orchestrator expectations.
|
||||
- Surface structured metrics/logging instrumentation and pluggable exporters.
|
||||
- Enforce idempotency token usage, artifact checksum publication, and watermark/backfill helpers.
|
||||
- Coordinate versioning with Go SDK, orchestrator service contracts, DevOps packaging, and Offline Kit deliverables.
|
||||
|
||||
## Required Reading
|
||||
- `docs/modules/orchestrator/architecture.md`
|
||||
- `docs/modules/platform/architecture-overview.md`
|
||||
|
||||
## Working Agreement
|
||||
- 1. Update task status to `DOING`/`DONE` in both `docs/implplan/SPRINTS.md` and the local `TASKS.md` when you start or finish work.
|
||||
- 2. Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
|
||||
- 3. Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations.
|
||||
- 4. Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change.
|
||||
- 5. Revert to `TODO` if you pause the task without shipping changes; leave notes in commit/PR descriptions for context.
|
||||
|
||||
@@ -1,18 +1,29 @@
|
||||
# StellaOps Orchestrator Service — Agent Charter
|
||||
|
||||
## Mission
|
||||
Build and operate the Source & Job Orchestrator control plane described in Epic 9. Own scheduler, job state persistence, rate limiting, audit/provenance exports, and realtime streaming APIs while respecting the imposed rule: work of this type must be applied everywhere it belongs.
|
||||
|
||||
## Key Responsibilities
|
||||
- Maintain deterministic Postgres schema/migrations for sources, runs, jobs, dag edges, artifacts, quotas, and schedules.
|
||||
- Implement DAG planner, token-bucket rate limiting, watermark/backfill manager, dead-letter replay, and horizontal scale guards.
|
||||
- Publish REST + WebSocket/SSE APIs powering Console/CLI, capture audit trails, and guard tenant isolation/RBAC scopes.
|
||||
- Coordinate with Worker SDK, Concelier, Excititor, SBOM, Policy, VEX Lens, Findings Ledger, Authority, Console, CLI, DevOps, and Docs teams to keep integrations in sync.
|
||||
|
||||
## Module Layout
|
||||
- `StellaOps.Orchestrator.Core/` — scheduler primitives, DAG models, rate limit policies.
|
||||
- `StellaOps.Orchestrator.Infrastructure/` — Postgres DAL, queue integrations, telemetry shims.
|
||||
- `StellaOps.Orchestrator.WebService/` — control-plane APIs (sources, runs, jobs, streams).
|
||||
- `StellaOps.Orchestrator.Worker/` — execution coordinator / lease manager loops.
|
||||
- `StellaOps.Orchestrator.Tests/` — unit tests for core/infrastructure concerns.
|
||||
- `StellaOps.Orchestrator.sln` — solution bundling orchestrator components.
|
||||
# StellaOps Orchestrator Service — Agent Charter
|
||||
|
||||
## Mission
|
||||
Build and operate the Source & Job Orchestrator control plane described in Epic 9. Own scheduler, job state persistence, rate limiting, audit/provenance exports, and realtime streaming APIs while respecting the imposed rule: work of this type must be applied everywhere it belongs.
|
||||
|
||||
## Key Responsibilities
|
||||
- Maintain deterministic Postgres schema/migrations for sources, runs, jobs, dag edges, artifacts, quotas, and schedules.
|
||||
- Implement DAG planner, token-bucket rate limiting, watermark/backfill manager, dead-letter replay, and horizontal scale guards.
|
||||
- Publish REST + WebSocket/SSE APIs powering Console/CLI, capture audit trails, and guard tenant isolation/RBAC scopes.
|
||||
- Coordinate with Worker SDK, Concelier, Excititor, SBOM, Policy, VEX Lens, Findings Ledger, Authority, Console, CLI, DevOps, and Docs teams to keep integrations in sync.
|
||||
|
||||
## Module Layout
|
||||
- `StellaOps.Orchestrator.Core/` — scheduler primitives, DAG models, rate limit policies.
|
||||
- `StellaOps.Orchestrator.Infrastructure/` — Postgres DAL, queue integrations, telemetry shims.
|
||||
- `StellaOps.Orchestrator.WebService/` — control-plane APIs (sources, runs, jobs, streams).
|
||||
- `StellaOps.Orchestrator.Worker/` — execution coordinator / lease manager loops.
|
||||
- `StellaOps.Orchestrator.Tests/` — unit tests for core/infrastructure concerns.
|
||||
- `StellaOps.Orchestrator.sln` — solution bundling orchestrator components.
|
||||
|
||||
## Required Reading
|
||||
- `docs/modules/orchestrator/architecture.md`
|
||||
- `docs/modules/platform/architecture-overview.md`
|
||||
|
||||
## Working Agreement
|
||||
- 1. Update task status to `DOING`/`DONE` in both `docs/implplan/SPRINTS.md` and the local `TASKS.md` when you start or finish work.
|
||||
- 2. Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
|
||||
- 3. Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations.
|
||||
- 4. Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change.
|
||||
- 5. Revert to `TODO` if you pause the task without shipping changes; leave notes in commit/PR descriptions for context.
|
||||
|
||||
Reference in New Issue
Block a user