frontend-patterns/templates/PatternUseReceipt.yaml
tegwick bd85fcd179 Add verified reference lookup and immutable consumer receipts
Assistant: codex
Assistant-Model: gpt-6.1-sol
Assistant-Session: 01a1045b-933d-7aa1-b2db-104557487a79
2026-10-04 09:02:35 +02:00

44 lines
2.3 KiB
YAML

# Producer template for FEP-WP-0008-T02; placeholders are not valid use evidence.
# Executable schema-v1 event validation/collection: activity-core
# src/activity_core/context_resolvers/frontend_patterns.py (validate_event).
# Consumer closeout integration and real-use acceptance remain open in T02.
# Local producer: scripts/reference_consume.py receipt (explicit JSON decision input).
# Consumer produces immutable events; collector supplies independently verified origin.
schema_version: 1
use_id: "<consumer-repo>:<task-id>:<decision-id>"
event_id: "<unique-event-id>"
previous_event_sha256: null # Follow-up must name the prior event digest; never overwrite.
recorded_at: "<RFC3339 timestamp>"
kind: synthetic # real only for an actual consumer decision; never change a fixture to real.
consumer:
repo: "<repo slug>"
revision: "<full commit SHA>"
task_ref: "<repo-relative work record path and stable task ID>"
producer: "<agent or person identity>"
run_ref: "<execution receipt locator>"
reference:
version: "0.1"
packaging_revision: "<full commit SHA containing reference files>"
manifest_sha256: "<sha256 of consumed manifest>"
context:
problem: "<short frontend decision>"
constraints: []
considered: [] # Stable CAND IDs; empty is valid for no match.
selected: []
decision:
action: no-match # applied | adapted | rejected | no-match
reason: "<why the guidance was used, changed or rejected>"
artifact_ref: null # Pinned consumer decision/implementation diff when available.
outcome:
value: unknown # helpful | harmful | mixed | no-effect | unknown
basis: consumer-report # consumer-report | model-assessment | observed-result
stage: decision # decision | implementation | test | operation
expectation: "<observable criterion, recorded before assessing the result>"
observation: null
evidence_refs: [] # Authorized artifact/test locators; no pasted private code or secrets.
next_observation: "<linked test/review/outcome condition, or null if complete>"
measured_decision_minutes: null
measured_rework_minutes: null
comparison_ref: null # Needed to claim improvement over a baseline.
# Collector records origin repo/ref/file digest and validation result separately;
# it must not trust producer-written origin verification or rating as proof of benefit.