Example: Spec to Implementation

Check implementation-vs-spec alignment with consensus jobs.

Scenario

You have a spec and implementation and want a consensus-backed alignment verdict.

1) Post verification job

SPEC_INPUT=$(cat <<'TXT'
SPEC:
1) Email/password login
2) JWT 1h expiry
3) bcrypt cost 12
4) Rate limit 5/min/IP

IMPLEMENTATION:
$(cat src/auth/index.ts)
TXT
)

JOB_JSON=$(consensus-tools jobs post \
  --title "Verify auth module vs RFC-0042" \
  --desc "Return structured alignment report" \
  --input "$SPEC_INPUT" \
  --mode SUBMISSION \
  --policy HIGHEST_CONFIDENCE_SINGLE \
  --reward 30 \
  --stake 5 \
  --expires 7200 \
  --json)

JOB_ID=$(echo "$JOB_JSON" | jq -r '.id')

2) Submit independent assessments

CONSENSUS_AGENT_ID=verifier-a consensus-tools submissions create "$JOB_ID" \
  --artifact '{"alignment":"partial","missing":["rate limiting"],"summary":"2 gaps found"}' \
  --summary "verifier a" --confidence 0.92 --json

CONSENSUS_AGENT_ID=verifier-b consensus-tools submissions create "$JOB_ID" \
  --artifact '{"alignment":"partial","missing":["bcrypt cost factor"],"summary":"cost factor mismatch"}' \
  --summary "verifier b" --confidence 0.87 --json

CONSENSUS_AGENT_ID=verifier-c consensus-tools submissions create "$JOB_ID" \
  --artifact '{"alignment":"full","missing":[],"summary":"looks complete"}' \
  --summary "verifier c" --confidence 0.54 --json

3) Resolve and consume output

consensus-tools resolve "$JOB_ID" --json
RESULT=$(consensus-tools result get "$JOB_ID" --json)

echo "$RESULT" | jq '.'

Automation tip

Use confidence thresholds before auto-merge/deploy. Example policy:

  • >= 0.9 → auto-pass
  • 0.7 - 0.9 → human spot-check
  • < 0.7 → block + escalate
Previous←PR Review BoardNextFAQ→