{
  "module": "results",
  "surface": "alpha",
  "deliverable": "skill_pack",
  "name": "timeback-results-alpha",
  "canonical_url": "https://platform3-andymontgomery-9773s-projects.vercel.app/results/alpha/skill_pack",
  "implementation_url": "https://platform3-andymontgomery-9773s-projects.vercel.app/results/alpha/implementation/api",
  "benchmark_url": "https://github.com/stripe/agent-toolkit",
  "generated_at": "2026-07-22T22:31:17.424Z",
  "endpoint_count": 53,
  "endpoint_perimeter": {
    "source": "descriptor.body.endpoints",
    "assertion": "bidirectional set diff; no literal endpoint-count assertion",
    "documented_endpoint_count": 53,
    "live_endpoint_count": 53,
    "documented_endpoints": [
      "POST /dev/mint?tenantId=demo",
      "GET /alpha/results/v1/result-records",
      "GET /alpha/results/v1/result-records/{resultRecordId}",
      "GET /alpha/results/v1/test-result-components",
      "GET /alpha/results/v1/missed-item-kc-attribution?resultRecordId={resultRecordId}",
      "GET /alpha/results/v1/ai-grading-audit",
      "GET /alpha/results/v1/students/{studentId}/results",
      "GET /alpha/results/v1/students/{studentId}/test-result-components",
      "GET /alpha/results/v1/students/{studentId}/ai-grading-audit",
      "GET /alpha/results/v1/assessment-finalizations",
      "GET /alpha/results/v1/students/{studentId}/assessment-finalizations",
      "GET /alpha/results/v1/students/{studentId}/kc-state",
      "GET /alpha/results/v1/students/{studentId}/track-state",
      "GET /alpha/results/v1/next-task",
      "GET /alpha/results/v1/students/{studentId}/xp-ledger",
      "GET /alpha/results/v1/content-effectiveness",
      "GET /alpha/results/v1/item-calibrations",
      "GET /alpha/results/v1/source-adapters",
      "GET /alpha/results/v1/policy-config",
      "GET /alpha/results/v1/academic-records",
      "GET /alpha/results/v1/course-transcripts",
      "GET /alpha/results/v1/course-grades",
      "GET /alpha/results/v1/transcript-results",
      "GET /alpha/results/v1/students/{studentId}/map-scores",
      "GET /alpha/results/v1/students/{studentId}/map-sittings",
      "GET /alpha/results/v1/students/{studentId}/current-map",
      "GET /alpha/results/v1/students/{studentId}/map-goal-strands",
      "GET /alpha/results/v1/students/{studentId}/growth-windows",
      "GET /alpha/results/v1/map-percentile-translations",
      "GET /alpha/results/v1/map-r90-norm-points",
      "GET /alpha/results/v1/students/{studentId}/highest-mastered-grade",
      "GET /alpha/results/v1/students/{studentId}/working-grade",
      "GET /alpha/results/v1/students/{studentId}/grades-mastered",
      "GET /alpha/results/v1/students/{studentId}/advancement",
      "GET /alpha/results/v1/students/{studentId}/course-progress",
      "GET /alpha/results/v1/students/{studentId}/grade-level-progress",
      "GET /alpha/results/v1/students/{studentId}/report-card",
      "GET /alpha/results/v1/students/{studentId}/gate-passes",
      "POST /alpha/results/v1/assessment-finalizations/finalize",
      "POST /alpha/results/v1/component-xp-awards",
      "POST /alpha/results/v1/imports",
      "GET /alpha/results/v1/imports/{importId}",
      "POST /alpha/results/v1/result-records",
      "PATCH /alpha/results/v1/result-records/{resultRecordId}",
      "GET /alpha/results/v1/reports/map-quadrants",
      "GET /alpha/results/v1/reports/retake-audit",
      "GET /alpha/results/v1/reports/growth-over-time",
      "GET /alpha/results/v1/reports/norms-isolation",
      "GET /alpha/results/v1/reports/growth-breakdown",
      "GET /alpha/results/v1/reports/group-growth-x",
      "GET /alpha/results/v1/reports/student-progress-animation",
      "GET /alpha/results/v1/reports/closed-loop-reconciliation",
      "GET /alpha/results/v1/reports/answer-key"
    ],
    "missing_from_live": [],
    "extra_in_live": []
  },
  "verification": {
    "command": "node pack/checks/verify-skill-pack.mjs --write-evidence",
    "evidence_path": "/results/alpha/skill_pack/pack/evidence/verification-latest.json",
    "checked_at": "2026-07-22T22:31:31.886Z",
    "result": "pass",
    "live_check_count": 29,
    "platform_answers": {
      "qti_attempt_result": {
        "qti_attempt_id": "qti-attempt-alex-001",
        "result_record_id": "018f4b4e-9c7a-7d3d-8b2f-2f673a000101",
        "representation_version": "results.qti_attempt_result.v1",
        "test_kind": "mastery_gate",
        "component_count": 4
      },
      "map_quadrants_2025": {
        "count": 2,
        "result_hash": "sha256:6785e967c1e5f6f4e4923a208dceb2fb5cf50b7bdd06b9d4cdd40ca0ad5d5ec3",
        "answer_key_example": "map_quadrants_2025_math_demo"
      },
      "closed_loop": {
        "count": 2,
        "result_hash": "sha256:7df8e2e7c9b30d17825f799a149ac0347c8143d4668071fa88154ea692828d70",
        "answer_key_example": "closed_loop_demo"
      },
      "test_result_components": {
        "count": 4,
        "component_roles": [
          "test",
          "section",
          "part",
          "question_response"
        ],
        "question_response": {
          "question_id": "question_linear_equations_solve_x",
          "response_identifier": "RESPONSE",
          "is_correct": true
        }
      },
      "missed_item_kc_attribution": {
        "attribution_ready": true,
        "missed_question_count": 0,
        "unattributed_missed_question_count": 0
      },
      "ai_grading_audit": {
        "count": 3,
        "grading_stages": [
          "overall",
          "overall",
          "question"
        ],
        "question_feedback": {
          "test_result_component_id": "trc_alex_unit_1_q_response",
          "ai_model": "gpt-5.5",
          "prompt_hash": "sha256:seed-ai-question-prompt",
          "grading_status": "accepted"
        },
        "human_override": {
          "revision_number": 2,
          "supersedes_ai_grading_audit_id": "ai_grade_audit_alex_unit_1_overall_v1",
          "human_override_by": "teacher_alpha_math_001",
          "human_override_reason": "Teacher reviewed the scratch work and credited the orally explained inverse operation."
        }
      },
      "time_commitment": {
        "count": 1,
        "metric_kind": "minutes",
        "alpha_value": "84",
        "activity_date": "2026-06-03"
      },
      "xp_goal_progress": {
        "fields": [
          "growth_x_target",
          "on_track_for_growth_x_target",
          "projected_gap",
          "awarded_xp",
          "expected_xp_ref"
        ],
        "growth_window_rows": 1,
        "xp_ledger_rows": 1
      },
      "map_translation": {
        "percentile_to_rit_rows": 1,
        "r90_norm_rows": 1
      },
      "named_grade_movement": {
        "student_id": "stu_timeback_10018",
        "subject_id": "science",
        "as_of_date": "2026-07-17",
        "current_working_grade": 8,
        "sy_start_working_grade": 6,
        "map_baseline_placement_grade": 7,
        "grades_mastered_sytd": 2,
        "map_baseline_grade_delta_not_grades_mastered": 1,
        "grades_mastered_sytd_formula_version": "alpha.policy.grades_mastered_sytd_formula:2026.07.17.11",
        "map_baseline_grade_delta_not_grades_mastered_formula_version": "alpha.policy.map_baseline_grade_delta_not_grades_mastered_formula:2026.07.17.11",
        "source_evidence_refs": [
          {
            "source_adapter_id": "adapter_timeback_migration",
            "producer_result_id": "mg10-regression-current-8-systart-6-map-7",
            "source_rule": "TimeBack 2026.07.17.11 MG-10"
          }
        ],
        "deprecated_route_matches": true
      },
      "descriptor_endpoint_count": 53
    }
  },
  "installable": {
    "root": "pack/",
    "files": [
      "pack/SKILL.md",
      "pack/agents/openai.yaml",
      "pack/checks/verify-skill-pack.mjs",
      "pack/evidence/verification-latest.json",
      "pack/references/canonical-surface.md",
      "pack/references/report-recipes.md",
      "pack/references/worked-example.md",
      "pack/references/runnable-check.md",
      "pack/references/leak-check.md"
    ]
  },
  "canonical_docs": {
    "architecture": "https://platform3-andymontgomery-9773s-projects.vercel.app/results/alpha/architecture",
    "dataDictionary": "https://platform3-andymontgomery-9773s-projects.vercel.app/results/alpha/data_dictionary",
    "customerWebsite": "https://platform3-andymontgomery-9773s-projects.vercel.app/results/alpha/customer_website",
    "implementation": "https://platform3-andymontgomery-9773s-projects.vercel.app/results/alpha/implementation/api",
    "surfaceQc": "https://platform3-andymontgomery-9773s-projects.vercel.app/results/alpha/surface_qc",
    "integration": "https://platform3-andymontgomery-9773s-projects.vercel.app/results/alpha/integration"
  },
  "regenerates": [
    "Per-student Alpha Learning Report sections: placement and progress, course completion, MAP results, grade levels mastered, XP goals/progress evidence, time commitment, and accuracy",
    "MAP Quadrants report under 2025 and 2020 norms by changing only normsSet",
    "Retake audit report using surface-selected test-of-record evidence",
    "Growth-over-time report using ordered surface rows",
    "Norms-isolation, growth-breakdown, and group Growth X reports",
    "Percentile/RIT translations and legacy R90 norm-point fixtures from versioned surface rows; GOALS grade2RIT/R90 uses NWEAMAP or Analytics",
    "Student-progress-animation report frames including levels_above_99",
    "Closed-loop reconciliation rows for RIT, Growth X, mastery, and time commitment minutes keys",
    "Four-state student knowledge state with initial mastery, retention, durable mastery, and fluency kept separate",
    "Student track state, test-result components, next-task selection, XP ledger, XP goal/progress projection evidence from growth-window fields, and content-effectiveness reads",
    "Report-card, gate-pass, working-grade, mastery-pure grades-mastered, and explicitly non-grades-mastered MAP placement-delta views",
    "Academic records, course transcripts, course grades, and transcript answer views without Ed-Fi payload parsing"
  ],
  "report_targets": [
    "learning_report",
    "map_quadrants",
    "retake_audit",
    "growth_over_time",
    "norms_isolation",
    "growth_breakdown",
    "group_growth_x",
    "map_percentile_translations",
    "map_r90_norm_points",
    "student_progress_animation",
    "closed_loop_reconciliation",
    "student_kc_state",
    "student_track_state",
    "next_task",
    "xp_ledger",
    "content_effectiveness",
    "report_card",
    "gate_passes",
    "working_grade",
    "grades_mastered_sytd",
    "academic_records",
    "course_transcripts",
    "course_grades",
    "transcript_results"
  ],
  "polling_guidance": {
    "status": "poll_only_no_webhook_sse_push_or_notifications_module",
    "primary_query": "GET endpoints with modifiedSince, typed filters, and returned opaque cursor",
    "foreground_interval_seconds": 15,
    "background_interval_seconds": 60,
    "idle_interval_seconds": 300,
    "post_write_readback_seconds": [
      0,
      2,
      5,
      10
    ],
    "post_write_timeout_seconds": 30,
    "transient_failure_backoff_seconds": [
      15,
      30,
      60,
      120,
      300
    ],
    "jitter": "10 to 20 percent",
    "cursor_rule": "Drain returned cursors before advancing modifiedSince; de-duplicate replayed rows by returned row id."
  },
  "live_surface_calls_only": true,
  "no_surface_logic": {
    "no_norms_table": true,
    "no_map_sitting_dedupe": true,
    "no_growth_window_switches": true,
    "no_term_parsing": true,
    "no_growth_x_formula": true,
    "no_group_growth_x_formula": true,
    "no_percentile_rit_translation": true,
    "no_rit_effective_grade_calculator": true,
    "no_local_r90_table": true,
    "no_transcript_source_precedence_logic": true,
    "no_blended_mastery_state": true,
    "no_mastery_decay_math": true,
    "no_track_definition_copy": true,
    "no_next_task_ranking": true,
    "no_xp_award_formula": true,
    "no_xp_goal_projection_math": true,
    "no_content_effectiveness_counter": true,
    "no_closed_loop_reconciliation_logic": true,
    "no_local_time_commitment_aggregation": true,
    "no_private_database_access": true,
    "no_pack_scripts_directory": true,
    "only_executable_is_surface_verifier": true
  },
  "route_verification_paths": [
    "/results/alpha/skill_pack",
    "/results/alpha/skill_pack/",
    "/results/alpha/skill_pack/pack/SKILL.md",
    "/results/alpha/skill_pack/pack/agents/openai.yaml",
    "/results/alpha/skill_pack/pack/checks/verify-skill-pack.mjs",
    "/results/alpha/skill_pack/pack/evidence/verification-latest.json",
    "/results/alpha/skill_pack/pack/references/canonical-surface.md",
    "/results/alpha/skill_pack/pack/references/report-recipes.md",
    "/results/alpha/skill_pack/pack/references/worked-example.md",
    "/results/alpha/skill_pack/pack/references/runnable-check.md",
    "/results/alpha/skill_pack/pack/references/leak-check.md",
    "/results/alpha/skill_pack/skill-pack.json"
  ]
}
