v0.2.0 (alpha)

Experimental alpha. ADR-0009 is accepted: use native decorators for a few functions and explicit registration for existing services. The wire schema remains 0.1.0. Human comfort/preference is still unmeasured.

Install the validated GitHub wheel (Python 3.11+; local sessions support macOS/Linux):

python -m pip install "melampus[session] @ https://github.com/melampus-org/melampus-python/releases/download/v0.2.0/melampus-0.2.0-py3-none-any.whl"

SDK setup and scope · Registration demo · Participant pilot · Visual walkthrough and videos

PyPI publication uses a separate Trusted Publisher workflow; the GitHub assets can be tried independently.

v0.2.0

Changelog:

Added

• Explicit instrument(target, namespace=..., contracts=...) registration for
  ordinary Python class instances, modules and grouped function boundaries.
  Selected methods preserve binding, signatures, sync/async behavior and target
  typing; shared classes are untouched and unsupported descriptors fail explicitly.
• Optional stable path= on existing function decorators; the inferred path
  and experimental 0.1.0 wire schema remain compatible.
• Three-style registration/repair demo, Claude session example, official-source
  SDK/decorator research and documented scope/bypass tradeoffs.
• Local timed, resumable pilot covering all seven worksheet measures, six task
  order rotations and Markdown/CSV/JSON reports. Synthetic runs are labeled;
  human preference and comfort remain unmeasured.

Changed

• Permit matching declarations from multiple instances sharing reviewed paths;
  conflicts remain incomplete and passing calls do not erase drift.
• Recommend explicit registration for existing services while retaining native
  decorators as an equal supported choice for small function integrations.

Commits:

• release: 0.2.0 alpha SDK registration and onboarding pilot (#8) (301d8f9)
• docs: publish 0.1.0 walkthrough and demo videos (0cd3bfe)
• Add unit test comparison demo (47016fb)
• docs: record live Claude drift repair and visual walkthrough (a9d9dee)
• feat: center 0.1.0 on local agent drift and repair sessions (58abe49)
• docs: distinguish SDK overhead from declaration telemetry cost (0b4d4f5)
• feat: prepare 0.1.0 runtime contract SDK and OTLP watcher (948ba33)
• docs: define first-release wire and execution contracts (49a81c0)
• docs: add founding spec and ADRs 0001-0005 (039719c)
• chore: add CLAUDE.md with worktree-per-task ground rule (00aa9ce)
• chore: ignore local AI-assistant config (Claude Code, Cursor) (d933648)
• chore: add Python .gitignore (95bb779)
• chore: add [0.0.0] changelog entry to satisfy version guard (99e56f8)
• chore: add semver release automation (simple mode) (878d8a2)
• chore: harden repo to team standard (codeowners, pr template, pages) (6c53678)
• chore: initial commit (ae2781b)

Pin this version: git clone --branch v0.2.0 <repo>

v0.1.0 (alpha)

v0.1.0

Changelog:

Added

• Local AI coding-session supervisor, reviewed SDK Contract objects, fresh-process
  scenario execution, required-check coverage, and revision-bound repair evidence.
• Agent-neutral gate and synchronous Claude Code hooks that restrict progression
  and completion during drift/incomplete evidence while permitting scoped repair.
• Runnable generation/drift/repair example and setup guide; local coding is the
  first-release focus, with broader service monitoring reserved for expansion.
• Experimental code_artifact schema, generated constants and compatibility fixtures.
• OTel API-only instrumented decorator for synchronous and async functions.
• Hash-only declarations, predicate results, deterministic check sampling, shared
  per-process execution limits, and runtime path disabling.
• Optional OTLP/HTTP protobuf watcher with finite sessions, bounded ingestion,
  duplicate suppression and explicit incomplete-evidence exit codes.
• Direct and stock collector demos, test suite, typing, package checks, CI, and
  separate Trusted Publishing workflow for TestPyPI/PyPI.
• Apache-2.0 license, quickstart, contribution and release documentation.

Known limitations

• Alpha wire/API stability; no content capture, gRPC/JSON receiver, or durable backend.
• Local sessions support macOS/Linux and reviewed executable claims on exercised
  inputs; they do not infer arbitrary intent or detect all generated-code defects.
• The founding spec's <3% overhead target remains unmet; see docs/RELEASE.md.

Commits:

• Add unit test comparison demo (47016fb)
• docs: record live Claude drift repair and visual walkthrough (a9d9dee)
• feat: center 0.1.0 on local agent drift and repair sessions (58abe49)
• docs: distinguish SDK overhead from declaration telemetry cost (0b4d4f5)
• feat: prepare 0.1.0 runtime contract SDK and OTLP watcher (948ba33)
• docs: define first-release wire and execution contracts (49a81c0)
• docs: add founding spec and ADRs 0001-0005 (039719c)
• chore: add CLAUDE.md with worktree-per-task ground rule (00aa9ce)
• chore: ignore local AI-assistant config (Claude Code, Cursor) (d933648)
• chore: add Python .gitignore (95bb779)
• chore: add [0.0.0] changelog entry to satisfy version guard (99e56f8)
• chore: add semver release automation (simple mode) (878d8a2)
• chore: harden repo to team standard (codeowners, pr template, pages) (6c53678)
• chore: initial commit (ae2781b)

Pin this version: git clone --branch v0.1.0 <repo>

v0.0.0

v0.0.0

Changelog:

Added

• Release automation (version guard + auto-tag on merge)

Commits:

• chore: add [0.0.0] changelog entry to satisfy version guard (99e56f8)
• chore: add semver release automation (simple mode) (878d8a2)
• chore: harden repo to team standard (codeowners, pr template, pages) (6c53678)
• chore: initial commit (ae2781b)

Pin this version: git clone --branch v0.0.0 <repo>