Skip to content

STABILITY: promote 13 packages experimental → mostly stable - #51

Open
pequalsnp wants to merge 1 commit into
mainfrom
stability-promotions
Open

STABILITY: promote 13 packages experimental → mostly stable#51
pequalsnp wants to merge 1 commit into
mainfrom
stability-promotions

Conversation

@pequalsnp

Copy link
Copy Markdown
Contributor

Summary

  • Walked the STABILITY.md package matrix against the v1-prep CHANGELOG entries (which closed a string of explicit STABILITY rows) plus the integration / e2e test coverage that landed alongside them.
  • Promotes 13 packages whose feature surface is now tested end-to-end and whose notes column carries no open sharp edge.
  • Documents the holdouts explicitly so the next promotion pass has a checklist instead of a hunt.

Promoted

Layer Packages
State pkg/state/dynamodb, pkg/state/valkey
Streaming runtime pkg/exec/streaming, pkg/exec/bootstrap, pkg/exec/replay
Snapshot sources pkg/source/snapshot/jsonl, pkg/source/snapshot/s3
Replay pkg/replay/s3
Query pkg/query/grpc, pkg/query/typed
Admin pkg/admin
Algebra pkg/monoid/compose
Tools cmd/murmur-codegen-typed

Held back on purpose

  • pkg/source/kafka — per-partition concurrency is fresh, needs soak.
  • pkg/exec/processor + pkg/exec/lambda/{kinesis,dynamodbstreams,sqs} — processor's docstring ties its stability to the Lambda runtimes, which haven't been exercised against real (non-local) AWS yet. Promote the four together post real-AWS soak.
  • pkg/source/snapshot/mongo, pkg/source/snapshot/dynamodb — open sharp edges still documented.
  • pkg/monoid/sketch/{hll,topk,bloom} — cross-runtime encoding portability not yet proven.
  • pkg/projection, pkg/observability/autoscale — too new.
  • pkg/pipeline, pkg/murmur — author-flagged "expect renames before v1."
  • pkg/exec/batch/sparkconnectreplace-directive gotcha.
  • cmd/murmur-ui — explicitly demo-grade.

Test plan

  • Skim the new CHANGELOG entry — does the holdout-rationale read accurately?
  • Skim each promoted row in STABILITY.md — confirm the notes column is still accurate for a "mostly stable" reader.
  • CI green (this is docs-only — golangci-lint / unit / integration shouldn't care).

🤖 Generated with Claude Code

The recent v1-prep waves closed every STABILITY row tracked against
this batch (Valkey-Bloom, Kafka DLQ + per-partition concurrency aside,
admin auth, Parquet replay, typed-client parity, codegen lifts).
Their notes columns no longer carry an open sharp edge, and the
underlying feature surface is exercised by either integration tests
under test/integration/ or e2e tests under test/e2e/.

Holdouts:
- pkg/source/kafka — per-partition concurrency is fresh; needs soak.
- pkg/exec/processor + pkg/exec/lambda/{kinesis,dynamodbstreams,sqs}
  — processor's docstring ties its stability to the Lambda runtimes,
  which haven't been exercised against real (non-local) AWS yet.
  Promote the four together after the real-AWS soak.
- snapshot/mongo + snapshot/dynamodb — open sharp edges.
- monoid/sketch/* — cross-runtime encoding portability not yet proven.
- projection + observability/autoscale — too new.
- pipeline + murmur — author-flagged "expect renames before v1."
- exec/batch/sparkconnect — replace-directive gotcha.
- cmd/murmur-ui — explicitly demo-grade.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant