{
  "schema_version": "2026-05-15.eval.v1",
  "id": "handoff-quality",
  "name": "TokRepo Agent Handoff Quality Eval",
  "updated_at": "2026-05-18",
  "claim": "Agents can turn reusable task outputs into explicit TokRepo handoff suggestions without uploading automatically.",
  "entrypoints_under_test": [
    "tokrepo agent-handoff --json",
    "tokrepo_handoff_plan",
    "asset_packaging_plan",
    "quality_gate",
    "handoff-package.schema.json",
    "tokrepo_push",
    "tokrepo_status",
    "https://tokrepo.com/agent-instructions/tokrepo.md"
  ],
  "local_command": "node scripts/verify_agent_contract.mjs",
  "expected_agent_behavior": [
    "After completing a user task, identify reusable skills, prompts, scripts, configs, and knowledge.",
    "Run MCP tokrepo_handoff_plan or tokrepo agent-handoff --json to produce equivalent safe push candidates.",
    "Expose an asset_packaging_plan with explicit files, metadata defaults, safety review, quality_gate, package_manifest, SBOM, provenance, and human confirmation.",
    "Expose reusability_score, dedupe discovery guidance, target compatibility, risk_profile, verification defaults, sensitive findings, quality_gate, and ready_to_push for each candidate.",
    "Never publish implicitly; ask the user and include only explicit files.",
    "Default to private visibility unless the user asks for public sharing."
  ],
  "public_success_criteria": [
    "Product test skill forbids automatic uploads and secret publication.",
    "Handoff output includes asset_packaging_plan and private-by-default suggested push commands.",
    "Handoff candidates include reusability_score, safe_to_suggest_push, dedupe_discovery, sensitive_findings, risk_profile, target_compatibility, quality_gate, package_manifest, SBOM, and provenance.",
    "Only quality_gate.status=pass plus ready_to_push=true can be treated as suitable for user-confirmed tokrepo_push.",
    "MCP tokrepo_handoff_plan is read-only and returns an asset_packaging_plan without uploading.",
    "MCP tokrepo_push requires explicit title and file list.",
    "Telemetry records only aggregate funnel events, not task text or file contents."
  ],
  "status": "implemented",
  "last_verified_by": "release-check",
  "capability_resolution": {
    "tool": "tokrepo_resolve_capability",
    "cli": "tokrepo resolve \"<task>\" --target codex --json",
    "schema": "https://tokrepo.com/schemas/capability-resolution.schema.json"
  },
  "post_task_harvest": {
    "tool": "tokrepo_harvest",
    "cli": "tokrepo harvest --changed --json",
    "schema": "https://tokrepo.com/schemas/harvest-report.schema.json",
    "publish_policy": "private_by_default_human_confirmed"
  }
}