spec-kitty-events
Event log library with Lamport clocks and systematic error tracking
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is MIT-licensed. Install it if you are building or migrating to a Spec Kitty event system that requires canonical envelope contracts with fail-closed cutover semantics and legacy shape normalization. The conformance validation and Lamport clock support are production-grade for mission state tracking.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >=3.10
- Low friction: pure Python wheel with only pydantic and python-ulid as runtime dependencies.
- Active maintenance with latest release 61 days ago.
License · maintenance · safety
permissive license (permissive) — MIT License permits unrestricted use, modification, and distribution with only copyright notice and license text preservation required.
last release 2026-06-14 (61 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 139,042 downloads/mo, #11,311 on PyPI
Alternatives
Verify before relying
pip install spec-kitty-events
from spec_kitty_events import Event
from datetime import datetime
import uuid
event = Event(
event_id="01ARZ3NDEKTSV4RRFFQ69G5FAV",
event_type="WPStatusChanged",
aggregate_id="mission/WP01",
payload={"mission_slug": "mission-001"},
timestamp=datetime.now(),
build_id="build-001",
node_id="runner-01",
lamport_clock=1,
project_uuid=uuid.uuid4(),
correlation_id="01ARZ3NDEKTSV4RRFFQ69G5FAV",
schema_version="3.0.0"
)- Whether conformance validation fixtures for TeamSpace migration are production-ready or development-only
- Performance characteristics under high-volume event emission
- Whether legacy_envelope_v1 normalization covers all known pre-cutover shapes in production use
What it is and what it does
spec-kitty-events is a Python event contract library that defines canonical envelope schemas for mission state, runtime, and conformance events. It enforces a fail-closed cutover policy where live ingestion rejects legacy mission-domain field names (like `feature_slug`, `mission_key`) and requires modern canonical fields (`mission_slug`, `mission_number`, `mission_type`) plus envelope metadata (`build_id`, `node_id`, `schema_version="3.0.0"`). The package uses Pydantic models for validation and includes Lamport clock support for distributed event ordering.
The library serves teams migrating from legacy event shapes to canonical 3.x contracts. It provides conformance validation combining Pydantic validation, committed JSON Schemas, and cutover artifact checks. A legacy normalizer can promote known pre-cutover envelope shapes to canonical form with deterministic UUID5 minting and audit preservation, while surfacing un-normalizable rows as structured diagnostics rather than silent passes. The package also exports `LOCAL_ONLY_EVENT_TYPES` for downstream consumers to identify event types not routed through SaaS-bound producer paths.
Use it for
- Emit and validate canonical event envelopes with build/node identity and Lamport clock ordering in mission tracking systems
- Validate incoming event payloads against canonical contracts to enforce fail-closed cutover policy during TeamSpace migration
- Normalize legacy pre-3.0 event shapes to canonical form with audit trail preservation and deterministic UUID generation
- Run conformance gates combining Pydantic validation, JSON Schema drift checks, and cutover artifact verification in CI/CD
- Classify event types for routing decisions (e.g., identify events that do not cross SaaS boundaries)
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has low install friction, carries no known vulnerabilities, and is MIT-licensed. Install it if you are building or migrating to a Spec Kitty event system that requires canonical envelope contracts with fail-closed cutover semantics and legacy shape normalization. The conformance validation and Lamport clock support are production-grade for mission state tracking.
Install
spec-kitty-events on PyPI
Before you install
Low friction: pure Python wheel with only pydantic and python-ulid as runtime dependencies. Active maintenance with latest release 61 days ago.
Requires Python >=3.10
License in practice
MIT License permits unrestricted use, modification, and distribution with only copyright notice and license text preservation required.
Quickstart
pip install spec-kitty-events
from spec_kitty_events import Event
from datetime import datetime
import uuid
event = Event(
event_id="01ARZ3NDEKTSV4RRFFQ69G5FAV",
event_type="WPStatusChanged",
aggregate_id="mission/WP01",
payload={"mission_slug": "mission-001"},
timestamp=datetime.now(),
build_id="build-001",
node_id="runner-01",
lamport_clock=1,
project_uuid=uuid.uuid4(),
correlation_id="01ARZ3NDEKTSV4RRFFQ69G5FAV",
schema_version="3.0.0"
)Verify before relying
- Whether conformance validation fixtures for TeamSpace migration are production-ready or development-only
- Performance characteristics under high-volume event emission
- Whether legacy_envelope_v1 normalization covers all known pre-cutover shapes in production use
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespydanticpython-ulid |
| Maintenance | Actively maintained 61 days since the last release |
| First released | |
| Downloads | 139,042 / month, #11,311 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3 |
Evidence: spec_kitty_events-6.1.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “event envelope contracts”
- spec-kitty-eventsProvides canonical event envelope contracts and validation for Spec…
- omnibase-compatProvides shared structural types—enums, DTOs, event envelopes, and…
- aws-cryptographic-material-providersProvides cryptographic material management and key derivation for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also spec-kitty-tracker · protovalidate · agentrust-trace · flex · ciris-edge · agent-governance-toolkit-core · kubernetes-validate · omnibase_core · agent_governance_toolkit · deal