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

feat: Add guild charters and task boards for various components
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details

Browse Source 
- 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:
master
2025-11-01 02:21:46 +02:00
parent e5629454cf
commit 66cb6c4b8a
227 changed files with 9913 additions and 6210 deletions
Download Patch File Download Diff File Expand all files Collapse all files

67
src/TimelineIndexer/StellaOps.TimelineIndexer/AGENTS.md
View File

@@ -1,28 +1,39 @@
# Tenant Timeline Indexer — Agent Charter
## Mission
Build the tenant-scoped timeline ingestion and query service described in Epic 15. Consume structured timeline events from all services, maintain queryable indices, and expose APIs to Console and CLI without violating imposed rule guarantees.
## Responsibilities
- Define Postgres schema, RLS policies, and ingestion pipelines for `timeline_events`.
- Provide event consumers for NATS/Redis queues with dedupe + ordering logic.
- Serve REST/gRPC APIs powering Console Forensics Explorer and CLI `stella obs trace`/`timeline` flows.
- Emit metrics/traces/logs for ingestion health and query performance.
## Collaboration
- Coordinate with Telemetry Core for event schema definitions.
- Work with Evidence Locker to link events to evidence bundle digests.
- Align with Authority on new `timeline:read` scopes and tenant enforcement.
## Definition of Done
- Service ships with deterministic migrations + repeatable seeds.
- Integration tests replay recorded event fixtures to stable results.
- Docs updated under `/docs/forensics/timeline.md` per release.
## Module Layout
- `StellaOps.TimelineIndexer.Core/` — event models, ordering/dedupe logic, query contracts.
- `StellaOps.TimelineIndexer.Infrastructure/` — Postgres/NATS clients, persistence abstractions.
- `StellaOps.TimelineIndexer.WebService/` — query/lookup APIs and authentication glue.
- `StellaOps.TimelineIndexer.Worker/` — ingestion consumers and background compaction jobs.
- `StellaOps.TimelineIndexer.Tests/` — unit tests focused on ordering/dedupe/query correctness.
- `StellaOps.TimelineIndexer.sln` — solution aggregating module projects.
# Tenant Timeline Indexer — Agent Charter
## Mission
Build the tenant-scoped timeline ingestion and query service described in Epic 15. Consume structured timeline events from all services, maintain queryable indices, and expose APIs to Console and CLI without violating imposed rule guarantees.
## Responsibilities
- Define Postgres schema, RLS policies, and ingestion pipelines for `timeline_events`.
- Provide event consumers for NATS/Redis queues with dedupe + ordering logic.
- Serve REST/gRPC APIs powering Console Forensics Explorer and CLI `stella obs trace`/`timeline` flows.
- Emit metrics/traces/logs for ingestion health and query performance.
## Collaboration
- Coordinate with Telemetry Core for event schema definitions.
- Work with Evidence Locker to link events to evidence bundle digests.
- Align with Authority on new `timeline:read` scopes and tenant enforcement.
## Definition of Done
- Service ships with deterministic migrations + repeatable seeds.
- Integration tests replay recorded event fixtures to stable results.
- Docs updated under `docs/forensics/timeline.md` per release.
## Module Layout
- `StellaOps.TimelineIndexer.Core/` — event models, ordering/dedupe logic, query contracts.
- `StellaOps.TimelineIndexer.Infrastructure/` — Postgres/NATS clients, persistence abstractions.
- `StellaOps.TimelineIndexer.WebService/` — query/lookup APIs and authentication glue.
- `StellaOps.TimelineIndexer.Worker/` — ingestion consumers and background compaction jobs.
- `StellaOps.TimelineIndexer.Tests/` — unit tests focused on ordering/dedupe/query correctness.
- `StellaOps.TimelineIndexer.sln` — solution aggregating module projects.
## Required Reading
- `docs/modules/telemetry/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.