Skip to content

Release Notes v0.1.0

workledger v0.1.0 is the first public release of the repository's local trace-to-work pipeline.

Summary

This release makes the project usable from source as an alpha Python CLI and local pipeline with:

  • normalized ObservationSpan
  • rolled WorkUnit
  • optional policy-backed ClassificationTrace
  • local DuckDB storage and report generation
  • a FastAPI wrapper over the same store and pipeline

Quick Install And Try

This release is set up to publish workledger to PyPI from the tagged GitHub release workflow. If the package is visible on PyPI, install it with:

python -m pip install workledger
wl demo coding --project-dir .workledger/coding --open-report

If the first publish has not completed yet, install from source from this repository:

git clone https://github.com/couscous18/workledger.git
cd workledger
uv sync --all-extras
uv run wl demo coding --project-dir .workledger/coding --open-report

Optional public-trace demos:

uv run wl demo hf-gaia --project-dir .workledger/hf-gaia --open-report
uv run wl demo hf-smoltrace --project-dir .workledger/hf-smoltrace --open-report

Release-linked demo artifacts:

What Ships In v0.1.0

  • Core models for ObservationSpan, WorkUnit, ClassificationTrace, PolicyDecision, EvidenceRef, PolicyPack, PolicyRun, ReviewOverride, and ReportArtifact
  • Ingestion for JSONL, OpenInference-like payloads, OTEL JSON, CloudEvents JSON, and SDK-shaped events
  • Hugging Face ingestion adapters for smolagents/gaia-traces and kshitijthakkar/smoltrace-traces-20260130_053009
  • Rollup that compresses low-level spans into reviewable work units
  • Declarative policy packs with explainable rule matches and review-required states
  • DuckDB-backed local store with JSON, CSV, and Parquet export plus terminal, Markdown, JSON, CSV, Parquet, and HTML reports
  • wl CLI, local FastAPI server, runnable demos, JSON Schema export, and published OpenAPI artifacts
  • Downstream comparative economics and software capex examples built on the same attributed-work layer

What is not implied by this release:

  • hosted infrastructure
  • a stable 1.0 interface
  • more public dataset adapters than the two implemented above

Alpha Status

workledger v0.1.0 is an alpha release. It is intended to make the project publicly usable and reviewable, not to promise stable interfaces yet.

Known Limitations

  • Alpha quality: rough edges are expected
  • Breaking changes may happen before a stable 1.0.0
  • PyPI availability still depends on the tagged release publish completing successfully; source install remains the fallback path
  • The public-trace demos do not classify by default; classification remains an explicit step
  • smolagents/codeagent-traces is a planned next adapter target, not implemented in v0.1.0