Skip to content

R4 Pilot Run 1: real DJ evidence collection #150

Description

@nulleimy

Purpose

Execute the first governed real-DJ pilot against canonical APPLAYLIST after Bundle 64.

This is an operational evidence run, not a feature bundle and not an authorization for merge, release, deploy, production activation, optimizer/ranking activation, or Personal DJ Model training.

Canonical checkpoint

  • branch: feature/bundle-0-bootstrap
  • canonical SHA: b8ad056e34be27db5ff2dd09e71814e01e2c70bf
  • Bundle 63 Human DJ Review Execution R1: merged
  • Bundle 64 R4 Bounded DJ Pilot Evidence R1: merged

Pilot objective

Answer with genuine DJ evidence:

  1. Does APPLAYLIST reduce time from import to a usable set?
  2. Do DJs inspect recommendations?
  3. Do they accept/reject them rather than ignore them?
  4. How often must they reorder, replace, or lock tracks?
  5. Can they complete export successfully?
  6. Do they return in a later ISO week?
  7. Would they pay?
  8. Do they trust and understand the system?
  9. Does blinded Human DJ Review evidence support continuing the current intelligence direction?

No answer may be inferred from CI, test fixtures, or synthetic submissions.

Required real inputs

A. Bundle 63 Human DJ Review

Private/trusted local inputs:

  • APPLAYLIST_REAL_LIBRARY_RUNTIME_EVIDENCE_R1.private.json
  • APPLAYLIST_BLINDED_HUMAN_DJ_REVIEW_PACKET_R1.json

Reviewer artifact:

  • APPLAYLIST_HUMAN_DJ_REVIEW_WORKSPACE_R1.html

Per real reviewer:

  • reviewer reference
  • blinded Plan A/B review
  • all six required dimensions
  • confidence
  • observed timestamp
  • algorithm_identity_was_hidden=true

Append-only ledger:

  • APPLAYLIST_HUMAN_DJ_REVIEW_R1.sqlite

Aggregate:

  • APPLAYLIST_HUMAN_DJ_REVIEW_AGGREGATE_R1.json

B. Bundle 64 workflow evidence

Append-only ledger:

  • APPLAYLIST_R4_PILOT_EVIDENCE_R1.sqlite

Required real event vocabulary:

  • import_started
  • usable_set_reached
  • recommendation_presented
  • recommendation_inspected
  • recommendation_accepted
  • recommendation_rejected
  • manual_reorder
  • manual_replace
  • manual_lock
  • export_completed

C. Explicit human exit survey

For each participating DJ where possible:

  • willingness_to_pay = yes | no | unsure
  • optional stated monthly price + explicit currency
  • trust score 1–5
  • explainability score 1–5
  • optional bounded note/reason codes

Local execution commands

Generate blinded reviewer workspace

python scripts/applaylist_human_dj_review.py workspace \
  --packet APPLAYLIST_BLINDED_HUMAN_DJ_REVIEW_PACKET_R1.json \
  --output APPLAYLIST_HUMAN_DJ_REVIEW_WORKSPACE_R1.html

Ingest one genuine reviewer submission

python scripts/applaylist_human_dj_review.py ingest \
  --packet APPLAYLIST_BLINDED_HUMAN_DJ_REVIEW_PACKET_R1.json \
  --submission reviewer-01.json \
  --ledger APPLAYLIST_HUMAN_DJ_REVIEW_R1.sqlite \
  --receipt reviewer-01.receipt.json

Build Human DJ Review aggregate

python scripts/applaylist_human_dj_review.py report \
  --packet APPLAYLIST_BLINDED_HUMAN_DJ_REVIEW_PACKET_R1.json \
  --private-manifest APPLAYLIST_REAL_LIBRARY_RUNTIME_EVIDENCE_R1.private.json \
  --ledger APPLAYLIST_HUMAN_DJ_REVIEW_R1.sqlite \
  --output APPLAYLIST_HUMAN_DJ_REVIEW_AGGREGATE_R1.json

Record a real workflow event

python scripts/applaylist_r4_pilot.py event \
  --ledger APPLAYLIST_R4_PILOT_EVIDENCE_R1.sqlite \
  --input event.json \
  --receipt event.receipt.json

Record explicit exit survey

python scripts/applaylist_r4_pilot.py survey \
  --ledger APPLAYLIST_R4_PILOT_EVIDENCE_R1.sqlite \
  --input survey.json \
  --receipt survey.receipt.json

Build R4 pilot report

python scripts/applaylist_r4_pilot.py report \
  --ledger APPLAYLIST_R4_PILOT_EVIDENCE_R1.sqlite \
  --human-review-aggregate APPLAYLIST_HUMAN_DJ_REVIEW_AGGREGATE_R1.json \
  --output APPLAYLIST_R4_PILOT_REPORT_R1.json

Pilot boundaries

  • local-first evidence only
  • no analytics SaaS
  • no hidden/background telemetry
  • no cloud upload of review/audio/private runtime evidence without separate authorization
  • no fabricated reviewer ratings
  • no synthetic workflow evidence presented as product evidence
  • no identity unblinding in reviewer workspace
  • no destructive ledger edits
  • no implicit currency conversion
  • no PDM training
  • no optimizer/ranking activation
  • no production activation

Readiness / decision semantics

INCOMPLETE until all required product metric categories are assessable and Bundle 63 review evidence is complete.

READY_FOR_HUMAN_DECISION means evidence is sufficiently complete for a separate governed human decision. It does not mean GO.

Separate later decision vocabulary:

  • CONTINUE
  • ADJUST
  • STOP-PIVOT

STOP conditions

Stop the run and preserve evidence if:

  • algorithm identity becomes exposed during blinded review,
  • packet/private-manifest fingerprint binding fails,
  • event correlation fails,
  • immutable ledger rejects a conflicting retry,
  • private paths/evidence are about to be published,
  • participant evidence would need to be fabricated to complete a metric,
  • an operation would require production/release/deploy authority.

Completion gate

This issue closes only after genuine evidence exists and the generated R4 report has been inspected. Until then the correct product state is INCOMPLETE.

RELEASE_AUTHORIZATION=NO
DEPLOY_AUTHORIZATION=NO
PRODUCTION_EFFECTS=NO
PDM_TRAINING=NO

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions