Skip to content

KafScale 2.0 (preview): kafscale-2-3b, pause_broker / resume_broker (BP/BU codes, v2.2) - #10

Merged
mmatloka merged 1 commit into
mainfrom
ai/kafscale-2-preview
Nov 16, 2026
Merged

mmatloka merged 1 commit into
mainfrom
ai/kafscale-2-preview

Conversation

@mmatloka

Copy link
Copy Markdown
Contributor

What

Simulator v2.2 ships a second KafScale version next to 1.6.3: KafScale 2.0 (preview), modeled from KafScale/platform main at d6c4d42 (website PRs #931-#935, #946, #949, all merged). sim-link now knows all of it, so its MCP tools can open and build it.

MCP input Wire form What it opens
cluster: "kafscale-2-3b" ?cluster=kafscale-2-3b "Diskless · KafScale 2.0 (preview)": the kafscale-3b cluster on KafScale 2.0 (lease fencing, a proxy with a 60 s etcd cache TTL)
pause_broker + brokerId BP:<broker> freezes a KafScale broker (SIGSTOP); its leases expire after the 10 s TTL
resume_broker + brokerId BU:<broker> wakes it (SIGCONT): 1.6.3 keeps stale logs (KafScale issue #324, 08.1.5), 2.0 drops them (08.2.7)
open_scenario 08.1.5, 08.2.1-08.2.7 ?scenario=08.2.4 already accepted (ids are format-checked only); now pinned by a test, and the tool description names tracks 00-26 (it said 00-13) and the 08.1 / 08.2 split
  • mcpserver/shape.go: kafscale-2-3b topology, the same as kafscale-3b (3x3x1 default, caps 9 brokers / 6 partitions, RF 1, no compaction, uploadMs only). The website sizes both by implementation, not version (clampFreePlaySize / encodeFreePlaySize give identical output for both).
  • mapping/testdata/ts-fixtures.txt: 7 SIZE-IMPL kafscale-2-3b lines dumped from the website's TypeScript codec (main d524fa16) with a throwaway tsx script, not checked in. The same script reproduced the existing kafscale-3b lines byte for byte.
  • actionlog: PauseBroker (BP) / ResumeBroker (BU), matching actionLog.ts encodeOne/decodeOne; an empty broker id is an error (the playground drops it).
  • mcpserver/actions.go: pause_broker / resume_broker (they need brokerId), the echo, and the kind lists.
  • v2.3 → v2.2 labels: the website folded v2.3 into v2.2 (manifest: freeplay.inkless/kafscale/automq and the DB/ET/OS codes are all '2.2'; mcp-tools.mdx already says "From v2.2"). Comments, tool descriptions, README and docs/mapping.md said v2.3 and now say v2.2.

Files changed

README.md, docs/mapping.md, actionlog/{actionlog,actions,decode}.go, actionlog/{actionlog,property}_test.go, mapping/testdata/ts-fixtures.txt, mcpserver/{actions,mcpserver,shape}.go, mcpserver/{mcpserver,shape}_test.go.

Commands run

  • go vet ./..., go vet -tags e2e ./e2e/, go test ./...: all pass locally.
  • gofmt -l on the changed files: clean.
  • e2e (e2e/run.sh, Docker): not run locally; left to this PR's CI matrix.

Tests added

  • codec: round-trip, wire form pinned to the playground's output (BP:broker-2@1500, BU:broker-2@9000), malformed BP: / BU:, both property generators.
  • shape: 23 SIZE-IMPL fixtures (was 16), kafscale-2-3b presets and refusals (RF 3, commit interval, compaction, broker cap), unknown-cluster message.
  • MCP: TestBuildURLPauseBroker on both KafScale clusters, ET and OS actions on kafscale-2-3b, open_scenario for 08.1.5 and 08.2.1-08.2.7.

Known risks

  • KafScale 2.0 is a preview of an untagged release. If upstream changes before tagging, the simulator changes first and sim-link follows; nothing here depends on the 2.0 behaviour beyond the slug.
  • A playground older than v2.2 falls back to single-dc for kafscale-2-3b and drops BP/BU.

Follow-up (not in this PR)

🤖 Generated with Claude Code

…BP/BU codes, v2.2)

Simulator v2.2 ships a second KafScale version next to 1.6.3: KafScale 2.0
(preview), modeled from KafScale/platform main at d6c4d42. sim-link learns:

- the free-play cluster kafscale-2-3b ("Diskless · KafScale 2.0 (preview)"),
  sized exactly like kafscale-3b (the playground's size rules key on the
  implementation, not the version). Pinned by seven new SIZE-IMPL fixtures
  dumped from the website's TypeScript codec (main d524fa16);
- the action kinds pause_broker / resume_broker (BP:<broker> / BU:<broker>),
  KafScale only, in the codec, the MCP tools and the echo;
- the open_scenario description: tracks 00-26 (was 00-13) and the 08.1.x /
  08.2.x split; 08.1.5 and 08.2.1-08.2.7 are pinned in TestOpenScenario.

The diskless implementations, their control-plane and object storage codes
ship in simulator v2.2 (v2.3 was folded into it), so the "v2.3" labels in
comments, tool descriptions, README and docs/mapping.md now say v2.2.
@mmatloka
mmatloka merged commit 4af042a into main Nov 16, 2026
10 checks passed
@mmatloka
mmatloka deleted the ai/kafscale-2-preview branch November 16, 2026 18:17
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