stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity
Files
0987cd6ac81edc2540d8abce362e822e2f0ecef3
git.stella-ops.org/docs/modules/policy/prep/2025-11-20-worker-implementation-prep.md
master d519782a8f
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
prep docs and service updates
2025-11-21 06:56:36 +00:00

1.2 KiB
Raw Blame History

Worker Implementation Prep — PREP-POLICY-ENGINE-33-101-WORKER-IMPLEMENTATI

Status: Draft (2025-11-20) Owners: Policy Guild Scope: Define worker execution contract that consumes orchestrator jobs (32-101).

Dependencies

  • Job schema from 32-101.
  • Overlay + batch context schemas (30-001, 31-002).

Draft execution contract

  • Worker input: job document with context_id, batch_items, policy_profile_hash, callbacks.
  • Output record: {job_id, worker_id, started_at, completed_at, results[]} where each result mirrors change-event format {component_purl, advisory_id, status, trace_ref}.
  • Idempotency: result hash over sorted results; retries compare hash and skip duplicate emission.
  • Metrics: policy_worker_jobs_total{result}, policy_worker_duration_seconds (histogram), policy_worker_results_total{status}.

Acceptance

  • Save schema draft at docs/modules/policy/schemas/policy-worker-result@draft.json and sample result at docs/modules/policy/samples/policy-worker-result@draft.json.
  • Confirm dedupe strategy with Scheduler/Orchestrator.

Handoff

Prep artefact for PREP-POLICY-ENGINE-33-101-WORKER-IMPLEMENTATI. Finalize once job schema is fixed and dedupe/metric names are agreed.