docs consolidation

This commit is contained in:
StellaOps Bot
2025-12-24 12:38:14 +02:00
parent 7503c19b8f
commit 9a08d10b89
215 changed files with 2188 additions and 9623 deletions

View File

@@ -1,27 +0,0 @@
# Surface FS Pointer Contract (Draft) — PREP-SCHED-SURFACE-01
Status: Draft (2025-11-20)
Owners: Scheduler Worker Guild
Scope: Define pointer model for Surface FS to unblock scheduler worker planning.
## Pointer model
- Identifier: `surfacefs://<tenant>/<dataset>/<version>`.
- Fields:
- `tenant_id`
- `dataset` (e.g., `sbom`, `findings`, `reachability`)
- `version` (content hash or monotonic version)
- `storage_uri` (unset/relative in sealed mode; content-addressed path recommended)
- `created_at` (RFC3339 UTC)
- Deterministic JSON serialization with sorted keys.
## Scheduler usage
- Workers receive pointer in job payload; pointer is immutable per job.
- Cache key = `surface_fs_pointer`.
- Validation: ensure `dataset` is allowlisted; reject untrusted storage_uri when sealed mode is on.
## Open decisions
- Final allowlist of datasets.
- Whether inline `storage_uri` is permitted under sealed mode or requires local mirror resolution.
## Handoff
Use this doc as the PREP artefact for PREP-SCHED-SURFACE-01; update once datasets and sealed-mode rule are agreed.

View File

@@ -1,21 +0,0 @@
# Scheduler Worker PREP — SCHED-WORKER-23-101
Status: Draft (2025-11-20)
Owners: Scheduler Worker Guild · Policy Guild
Scope: Capture activation event contract and throttle source needed for worker 23-101.
## Required inputs
- Activation event schema from Policy guild: expected fields `{job_id, policy_run_id, tenant_id, priority, throttle_source}`.
- Throttle source definition (static config vs dynamic policy signals).
## Proposed contract
- Event type: `scheduler.policy.activation.requested`.
- Payload: `{job_id, policy_run_id, tenant_id, priority, requested_at_utc, throttle_source}`.
- Throttle source values: `scheduler-default`, `policy-signal`, `manual-override` (to be confirmed).
## Open decisions
- Whether to carry bundle pointers (policy/export) in the activation event.
- Retry/backoff policy if Policy service is down.
## Handoff
Use this doc as PREP artefact for SCHED-WORKER-23-101; update once Policy guild provides final schema/throttle rules.