stackVersion frontmatter — see Documentation index below.
The repository changelog is the canonical technical source:
stack/CHANGELOG.md.
Private launch gates, dogfood evidence, internal waivers, and operator-only
incident notes live outside the public docs.Channels
| Channel | What to expect |
|---|---|
dev / nightly | Latest usable Stack from main. Good for dogfood and early feedback. May carry known limitations with rollback notes. |
| release candidate | Short freeze before stable. Fixes, docs, packaging, and evidence only. |
| stable | Supported public release with documented install, update, support, and rollback or migration posture. |
Public Entry Format
Each public entry should include:- version or nightly id;
- release channel;
- install or update instructions when they changed;
- user-visible additions, changes, fixes, and removed behavior;
- breaking changes with migration steps;
- known limitations that affect first-run or hosted-feature use;
- links to docs, GitHub Release, or issue threads when public.
Documentation index
Each Stack doc page declaresstackVersion (and stackIntroduced when new) in
frontmatter and links here. Use this table to find which release first documented
a page or last updated it.
| Page | Slug | Introduced | Current as of |
|---|---|---|---|
| Overview | /stack | 0.1.0 | 0.2.0-dev.20260703.2 |
| Quickstart | /stack/quickstart | 0.1.0 | 0.2.0-dev.20260703.2 |
| Local-only mode | /stack/local-only | 0.2.0-dev.20260702.1 | 0.2.0-dev.20260702.3 |
| Connect Synth | /stack/connect-synth | 0.2.0-dev.20260702.1 | 0.2.0-dev.20260702.3 |
| Hosted ops | /stack/hosted-ops | 0.2.0-dev.20260702.1 | 0.2.0-dev.20260702.3 |
| Cockpit | /stack/cockpit | 0.1.0 | 0.2.0-dev.20260703.2 |
| Goal mode & monitor | /stack/goal-mode | 0.2.0-dev.20260701.1 | 0.2.0-dev.20260703.2 |
| stackd | /stack/stackd | 0.1.0 | 0.2.0-dev.20260701.1 |
| Stack MCP | /stack/mcp | 0.1.0 | 0.2.0-dev.20260703.2 |
| Configuration | /stack/configuration | 0.1.0 | 0.2.0-dev.20260701.1 |
| Hosted inference | /stack/inference | 0.1.0 | 0.2.0-dev.20260702.3 |
| Optimizers (GEPA) | /stack/optimizers | 0.1.0 | 0.1.0 |
Entries
Stack nightly
0.2.0-dev.20260703.2 — Monitor Gardener Goal release on
the nightly channel.- Lights panel:
/lights onopens a right-panel cockpit with scrollable and filterable threads, gardener status, actor status, cloud state, local runtime, and usage./lights offcloses it without changing the active worker or gardener view. - Slash commands: the slash menu now documents
/help,/exit,/goal,/gardener//g,/monitor//m,/lights,/threads//p,/mode//work_mode,/provider//harness,/profile,/model,/effort,/efforts,/subagents,/usage,/experimental,/ops,/actors,/agent,/agent-view//a,/permissions//perm,/settings telemetry,/config,/details//d,/rails//b, and/clear//c. - Gardener workflow:
/gardeneropens in the core panel; Stack MCP now gives gardeners owner-route tools for durable worker/meta-thread creation and goal assignment. - Effort evidence capture:
stack effort captureandstack_effort_record_capturepreserve terminal, browser, screenshot, monitor, benchmark, optimizer, and other ad hoc evidence with capture-oriented receipt metadata. - Optimizer candidate evidence:
stack effort optimizer-candidateandstack_effort_record_optimizer_candidatepreserve candidate id, score, split, optimizer run id, and artifact provenance for GEPA or hosted optimizer candidates; task-classifier audits verify the typed optimizer-candidate activity receipt and source sidecar. - Engineering Effort packets:
stack effort engineering-packetandstack_effort_write_engineering_packetcreate change summaries with changed files, diff stat, validation, skipped gates, risks, and next action. - Effort acceptance receipts:
stack effort acceptanceandstack_effort_record_acceptanceupdate one A-level section infindings/results/acceptance-summary.md, append typed acceptance activity, and let generated handoffs derive open risk bullets from remaining acceptance work and the latest blocker. - Effort blocker receipts:
stack effort resolve-blockerandstack_effort_resolve_blockerpreserve resolution evidence for cleared or superseded blockers while keeping Efforts out of a blocked lifecycle state. - Efforts panel controls:
/effortssupportsj/kselection,nnew Effort drafting,hhandoff refresh,aarchive/activate,bcurrent-thread binding, andrrefresh;/efforts new,/efforts archive, and/efforts activateexpose the same lifecycle actions from slash input. - Goal mode: worker chat and slash commands stay available while the monitor sidecar is visible.
- Fixes: repaired transcript blackspace/input placement, blank resumed goal first-paint, terminal exit cleanup, and Lights panel focus stealing.
- Distribution packet: nightly
aarch64-apple-darwinartifact prepared with SHA256b8a86789405831809683747f85083511e982678c1aadb92d4e3e3fff0c31d526; hosted release-site contract proof installed the generated manifest and verified version, doctor, demo receipt, and update-check behavior.
CHANGELOG.md
for the full nightly technical entry.Stack nightly
0.2.0-dev.20260703.1 — artifact round-trip, hosted-run
watching, per-task preflight, and papercut capture on the nightly channel.- Round-trip verbs:
stack pull,stack apply, andstack pushmove optimizer artifacts between hosted runs and the local workspace, recording a typed receipt (sha256 digest, git SHA, backend target) for every transfer. Astack_list_hosted_artifactsMCP tool enumerates what a hosted run produced. - Hosted run watch:
stack watchfollows a hosted optimizer run from the CLI, and the TUI gains a hosted-watch panel; both support--oncesnapshots and--replayover finished runs. - Per-task doctor:
stack doctor --task <task.toml>preflights a single task pack and classifies failures as auth, quota, config, or transient. - Papercut capture:
ctrl+f(or/papercut) records a papercut into the ledger without leaving the session. - Fixed:
/profilenow cycles through all four seeded profiles. - Backfill: the repository changelog now carries the previously missing
0.2.0-dev.20260702.4hotfix section (hosted optimizer artifact-name projection fix).
CHANGELOG.md
for the full nightly technical entry.Stack nightly
0.2.0-dev.20260702.3 — local-only, hosted ops, remote sync,
and Synth inference guidance shipped on the nightly channel.- Added docs: Local-only mode, Connect Synth, and Hosted ops.
- Updated docs: Hosted inference now distinguishes free
aux (
nemotron-3-ultra) from billed GLM (glm-5.2) and states the worker opt-in invariant. - Updated docs: Overview and Quickstart now point to local-only and hosted-connect flows instead of treating auth as an install prerequisite.
- Nightly refresh:
0.2.0-dev.20260702.3carries the Stack telemetry flush endpoint fix used by the activation funnel usage-stage proof. - Known limitation: this is a nightly, not a stable
0.3.0cut. Stable promotion remains a separate operator decision.
CHANGELOG.md
for the full nightly technical entry.Stack sidecar monitor (
0.2.0-dev.20260701.1, dev / nightly) — goal mode now
runs a monitor agent that gives you a separate, higher-level stream for long runs.- Added:
/goalmode defaults to a Sidecar events feed instead of the worker’s raw tool tape. Pressafor the agent tape,tfor the monitor’s own thread,efor events. - Added: a monitor agent paired 1:1 with the worker narrates meaningful
progress, steers the worker when it stalls, and posts typed updates via
stack_monitor_goal_status(headline, note, metric) rendered as a headline strip and milestone timeline. - Added: completion audit — the monitor flips a goal to done with
goal_metonly after it checks the worker’s claim against cited proof; an unproven claim is surfaced asblockedorgoal_failed, not accepted. - Added: quiet monitor passes leave a dim check-in row (
no change · reviewed N events) so the feed shows the monitor is watching without inventing progress. - Scope: this covers one goal run. Multi-goal portfolio rollups, ETA / progress-per-hour, and pause-before-irreversible are not yet wired.
CHANGELOG.md.Stack nightly channel planning — release lifecycle, local-first activation,
terminal auth, and handoff launch bar.
- Planned: Stack will use separate
dev/nightly, release-candidate, and stable channels. - Added planning surface:
stack doctor,stack demo, and read-onlystack update --checkare the first local support, receipt, and manifest proof commands for Nightly 1. - Planned: local Stack should run without Synth signup; Synth sign-in will unlock hosted features.
- Planned: public changelog entries will stay user-facing, while private evidence and launch gates remain in internal release ledgers.
- Docs (planning): Overview, Quickstart.
- Current status: Stack is still internal alpha. Public package-manager installation and stable support expectations will be added when those channels are live.
CHANGELOG.md.Stack
0.1.0 internal alpha — first distributable Stack release for Synth
operators.- Added: OpenTUI cockpit with Codex agent pane, session history, transcript tooling, and environment-aware Synth operations.
- Added:
stack-mcpfor local agent access to configured Synth operations. - Added: local GEPA and dev-slot setup helpers for internal Synth research engineering workflows.
- Added: bundled Codex skills for Stack setup, Synth workflows, and Stack agent bridge usage.
- Docs: Overview, Hosted inference, Optimizers (GEPA).
- Status: internal alpha only. Public GitHub Release and Homebrew install paths are not live yet.