🐍 M141-3 — PyPI scaffold (orchestkit-hook-contract)

📦 Package surface

from orchestkit_hook_contract import (
    HOOK_EVENT_NAMES,         # tuple of 19 event names
    HookEvent,                 # Pydantic v2 envelope (event, timestamp, ...)
    HookEventName,             # Literal[...] type
    PAYLOAD_MAP,               # event name -> payload class
    HOOK_EVENT_SCHEMAS,        # per-event JSON Schema (draft-07)
    validate_hook_event,       # structural validator
    is_hook_event_name,        # type guard

    # Per-event payload classes (13 of 19 events covered)
    PreToolUsePayload, PostToolUsePayload, PostToolUseFailurePayload,
    UserPromptSubmitPayload, NotificationPayload, PermissionRequestPayload,
    SubagentStartPayload, SubagentStopPayload, StopPayload,
    SessionStartPayload, PreCompactPayload, TeammateIdlePayload,
    TaskCompletedPayload,
)

🔮 What's deferred (still under M141)

• #1807 (M141-6): Cross-language parity gate CI — diff npm + PyPI emits field-by-field
• #1809 (M141-8): Migrate yonatan-hq/platform consumer to use this package (separate-repo PR)
• PyPI publish workflow (test-pypi on tag → prod) — deferred to follow-up commit on this branch or a sibling PR
• The 6 envelope-only events (SessionEnd, Setup, Worktree*, ConfigChange, InstructionsLoaded) — same as the npm side, CC docs need to catch up

✅ Verified locally

$ python scripts/codegen-py.py
[codegen-py] wrote src/orchestkit_hook_contract/events.py
[codegen-py] wrote src/orchestkit_hook_contract/schemas.py

$ python scripts/codegen-py.py --check
[codegen-py --check] OK: events.py + schemas.py match spec.

$ pytest -v
============================== 82 passed in 0.93s ==============================

$ python -c 'from orchestkit_hook_contract import PreToolUsePayload; PreToolUsePayload(tool_name="Bash", tool_input={"cmd": "ls"})'
# typed Pydantic v2 model ✓