{
  "name": "timeback-events-alpha",
  "module": "events",
  "surface": "alpha",
  "deliverable": "skill_pack",
  "attempt": 1,
  "generated_at": "2026-06-10T12:24:31Z",
  "canonical_base": "https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/skill_pack",
  "canonical_docs": {
    "architecture": "https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/architecture/",
    "data_dictionary": "https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/data_dictionary/",
    "customer_website": "https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/customer_website/",
    "implementation_api": "https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/implementation/api",
    "surface_qc": "https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/surface_qc",
    "integration": "https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/integration",
    "people_and_orgs_implementation_api": "https://platform3-andymontgomery-9773s-projects.vercel.app/people_and_orgs/alpha/implementation/api"
  },
  "benchmark_alignment": {
    "benchmark": "Peer caliper/1edtech/skill_pack plus Anthropic Agent Skills / Claude Code skills docs",
    "evidence": [
      "SKILL.md has required name and description frontmatter only.",
      "SKILL.md body is concise and organized as Instructions, Examples, and Guidelines.",
      "Endpoint and producer-registration reference, worked example, runnable check, and leak check are loaded on demand.",
      "Landing page provides one-line install commands and one first live call before policy detail."
    ]
  },
  "install": {
    "claude_code_one_line": "sh -c 'd=\"$HOME/.claude/skills/timeback-events-alpha\"; b=\"https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/skill_pack\"; mkdir -p \"$d/references\" \"$d/agents\"; for f in SKILL.md references/canonical-surface.md references/worked-example.md references/runnable-check.md references/leak-check.md agents/openai.yaml; do curl --max-time 20 --retry 3 --retry-all-errors --retry-delay 2 -fsSL \"$b/pack/$f\" -o \"$d/$f\"; done'",
    "codex_one_line": "sh -c 'd=\"${CODEX_HOME:-$HOME/.codex}/skills/timeback-events-alpha\"; b=\"https://platform3-andymontgomery-9773s-projects.vercel.app/events/alpha/skill_pack\"; mkdir -p \"$d/references\" \"$d/agents\"; for f in SKILL.md references/canonical-surface.md references/worked-example.md references/runnable-check.md references/leak-check.md agents/openai.yaml; do curl --max-time 20 --retry 3 --retry-all-errors --retry-delay 2 -fsSL \"$b/pack/$f\" -o \"$d/$f\"; done'",
    "required_files": [
      "SKILL.md",
      "agents/openai.yaml",
      "references/canonical-surface.md",
      "references/worked-example.md",
      "references/runnable-check.md",
      "references/leak-check.md"
    ]
  },
  "pack_files": [
    {
      "path": "pack/SKILL.md",
      "kind": "skill_manifest",
      "notes": "Concise Instructions / Examples / Guidelines skill entry point."
    },
    {
      "path": "pack/agents/openai.yaml",
      "kind": "agent_metadata",
      "notes": "Runtime display metadata."
    },
    {
      "path": "pack/references/canonical-surface.md",
      "kind": "reference",
      "notes": "Endpoint, credential, query, status, source-import, attendance, discipline, and deferred-behavior details."
    },
    {
      "path": "pack/references/worked-example.md",
      "kind": "reference",
      "notes": "Single copy-paste teacher activity workflow with expected step statuses."
    },
    {
      "path": "pack/references/runnable-check.md",
      "kind": "reference",
      "notes": "Live acceptance check that compares returned platform facts only."
    },
    {
      "path": "pack/references/leak-check.md",
      "kind": "reference",
      "notes": "Binary checklist for avoiding local platform-owned logic."
    }
  ],
  "regenerates_by_surface_calls_only": [
    "read one student activity stream through GET /events using the Events demo tenant",
    "teacher-facing activity report from returned Events fields; real/reviewer tenants may resolve returned studentId through People & Orgs for display only",
    "source-shaped TimeBack processed-facts import through POST /source-imports followed by GET /events materialization proof",
    "tenant activity-source registration through POST /activity-sources with a platform-generated UUID",
    "read-only attendance and discipline moment lists through Events Alpha"
  ],
  "leak_check": {
    "passed_static_scan": true,
    "contains_surface_owned_logic": false,
    "forbidden_logic_absent": [
      "event-kind map",
      "Caliper tuple map",
      "source-import adapter map",
      "source-row pre-normalizer or caller-provided activity_kind",
      "dedupe or canonical hash logic",
      "Ed-Fi descriptor table",
      "soft-delete or draft reconciliation",
      "Results, mastery, score, content-effectiveness, NWEA, XP, or minutes math",
      "direct database or implementation-source access"
    ]
  },
  "runnable_check": {
    "reference": "pack/references/runnable-check.md",
    "expected_healthy_result": {
      "result": "pass",
      "studentId": "student-ada-001",
      "contentId": "content-fractions-video-01",
      "listedCreatedEvent": true,
      "listedImportedEvent": true,
      "checkedBySurfaceCallsOnly": true
    },
    "no_local_answer_table": true,
    "no_surface_owned_logic": true,
    "latest_live_proof": {
      "status": "passed_live_2026-06-10T12:24:31Z",
      "evidence": {
        "studentId": "student-ada-001",
        "contentId": "content-fractions-video-01",
        "createdEventId": "cf22cbc9-7156-434a-95ae-a42215634067",
        "importedEventId": "5991132e-790a-4a5d-825d-fa9fa8f3cf52",
        "sourceImportKind": "question_answered",
        "listedCreatedEvent": true,
        "listedImportedEvent": true,
        "detailMatches": true,
        "sourceName": "TimeBack Caliper Sensor",
        "attendanceRows": 7,
        "disciplineRows": 6,
        "checkedBySurfaceCallsOnly": true
      }
    }
  },
  "link_gate": {
    "requires_root_absolute_or_full_absolute_links": true,
    "page_relative_links_allowed": false,
    "hierarchical_pack_mirror_present": true,
    "paths_to_verify_after_driver_deploy": [
      "/events/alpha/skill_pack",
      "/events/alpha/skill_pack/",
      "/events/alpha/skill_pack/pack/SKILL.md",
      "/events/alpha/skill_pack/pack/agents/openai.yaml",
      "/events/alpha/skill_pack/pack/references/canonical-surface.md",
      "/events/alpha/skill_pack/pack/references/worked-example.md",
      "/events/alpha/skill_pack/pack/references/runnable-check.md",
      "/events/alpha/skill_pack/pack/references/leak-check.md",
      "/events/alpha/skill_pack/skill-pack.json",
      "/events/alpha/skill_pack/search-index.json",
      "/events/alpha/skill_pack/route-verification.json"
    ]
  }
}
