stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
582a88e8f8ddf9e03bf1a0cff65f619bf4306ea1
git.stella-ops.org/docs/modules/policy/prep/2025-11-20-batch-context-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

Batch Context Endpoint Prep — PREP-POLICY-ENGINE-31-002-BATCH-CONTEXT-ENDPO

Status: Draft (2025-11-20) Owners: Policy Guild Scope: Define the batch context endpoint contract that builds on Advisory AI knobs (31-001) and trust weighting outputs.

Dependencies

  • Final knobs list from 31-001.
  • Policy profile schema (hash + version) from 30-001 overlays.

Draft API surface

  • POST /policy/batch/context with payload: {tenant_id, policy_profile_hash, knobs_version, overlay_hash, items:[{component_purl, advisory_id}], options:{include_reachability:boolean}}.
  • Response: {context_id, expires_at, knobs_version, overlay_hash, items:[{component_purl, advisory_id, status, trace_ref}]}.
  • Determinism: items sorted by (component_purl, advisory_id); context_id derived as hash of request payload.

Acceptance to close PREP

  • Align fields with 31-001 knobs and 30-001 overlay schema; record hashes/versions.
  • Save draft schema at docs/modules/policy/schemas/policy-batch-context@draft.json and sample at docs/modules/policy/samples/policy-batch-context@draft.json.

Handoff

Use this document as the prep artefact for PREP-POLICY-ENGINE-31-002-BATCH-CONTEXT-ENDPO. Update when knobs and overlays freeze; then move implementation to DOING.