HyperAgent-SDK

Builds, tests, versions, and publishes the HyperAgent-SDK package. Use when updating the shared agent interface, bumping versions, publishing to npm, or syncing SDK changes across the 5-repo ecosystem.

Keep the cross-repo contracts (hyper-agent-spec.json + awardFromCourse + graduate trigger) aligned across HyperAgent-SDK, HyperCode-V2.4, and Hyper-Vibe-Coding-Course. Use when changing manifest schema, adding/changing fields, modifying the Course→V2.4 token sync payload, the graduate API shape, or whenever the user says "spec change", "sync with V2.4", "update Course", or "the three repos drifted".

HyperAgent-SDK development, publishing, and spec validation. Use when working on the SDK CLI, adding new commands, publishing to npm, updating the hyper-agent-spec.json schema, adding new templates, or debugging SDK validation errors. Latest shipped: v0.3.0 — Phase 3 token sync client (awardFromCourse).

Build, extend, and debug the Phase 4 graduation flagship — the `hyper-agent graduate <discord_id>` CLI command, its V2.4 trigger endpoint, BROski$ token award, badge assignment, portfolio URL, and Discord role/DM. Use when the user says "phase 4", "graduate command", "graduation flow", "graduate failing", or wants to extend the 8-step graduation pipeline.

Ship a new version of @w3lshdog/hyper-agent to npm. Walks the gated test → commit → version-bump → push → publish → smoke-test flow with safety refusals. Use when the user says "publish", "ship the SDK", "release 0.x.0", "cut a patch/minor/major", or asks how to push a new version live.

Run the SDK test suite and produce a structured status report (per-file pass/fail, totals, duration, failure summaries). Use when the user says "test report", "status report", "are tests green", "run the suite and report", "what's the test state", or before/after publishing.

Triage failures in the Phase 3 awardFromCourse() helper — 401 secret mismatches, 409 idempotent replays, timeouts, network errors, BROWSER_FORBIDDEN, MISSING_SECRET, validation rejections. Use when the user says "awardFromCourse failing", "401 from V2.4", "token sync broken", "course not awarding tokens", "duplicate replay", or hits any AwardFromCourseError.