> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usesynth.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Stack Changelog

> Public release notes for Stack channels, install paths, handoffs, and operator-facing changes.

Public release notes for Stack. Use this page to understand what changed, what
may break, and which release channel a change belongs to. Every other Stack doc
page links here via `stackVersion` frontmatter — see **Documentation index** below.

<Note>
  The repository changelog is the canonical technical source:
  [`stack/CHANGELOG.md`](https://github.com/synth-laboratories/stack/blob/main/CHANGELOG.md).
  Private launch gates, dogfood evidence, internal waivers, and operator-only
  incident notes live outside the public docs.
</Note>

## 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.

Do not include private Linear ids, private eval data, secret names, internal
waiver details, customer-specific incidents, or raw proof transcripts here.

## Documentation index

Each Stack doc page declares `stackVersion` (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)                      | `/stack`               | `0.1.0`                | `0.2.0-dev.20260703.2` |
| [Quickstart](/stack/quickstart)         | `/stack/quickstart`    | `0.1.0`                | `0.2.0-dev.20260703.2` |
| [Local-only mode](/stack/local-only)    | `/stack/local-only`    | `0.2.0-dev.20260702.1` | `0.2.0-dev.20260702.3` |
| [Connect Synth](/stack/connect-synth)   | `/stack/connect-synth` | `0.2.0-dev.20260702.1` | `0.2.0-dev.20260702.3` |
| [Hosted ops](/stack/hosted-ops)         | `/stack/hosted-ops`    | `0.2.0-dev.20260702.1` | `0.2.0-dev.20260702.3` |
| [Cockpit](/stack/cockpit)               | `/stack/cockpit`       | `0.1.0`                | `0.2.0-dev.20260703.2` |
| [Goal mode & monitor](/stack/goal-mode) | `/stack/goal-mode`     | `0.2.0-dev.20260701.1` | `0.2.0-dev.20260703.2` |
| [stackd](/stack/stackd)                 | `/stack/stackd`        | `0.1.0`                | `0.2.0-dev.20260701.1` |
| [Stack MCP](/stack/mcp)                 | `/stack/mcp`           | `0.1.0`                | `0.2.0-dev.20260703.2` |
| [Configuration](/stack/configuration)   | `/stack/configuration` | `0.1.0`                | `0.2.0-dev.20260701.1` |
| [Hosted inference](/stack/inference)    | `/stack/inference`     | `0.1.0`                | `0.2.0-dev.20260702.3` |
| [Optimizers (GEPA)](/stack/optimizers)  | `/stack/optimizers`    | `0.1.0`                | `0.1.0`                |

## Entries

<Update label="2026-07-03" tags={["stack", "0.2.0-dev.20260703.2", "nightly"]}>
  **Stack nightly `0.2.0-dev.20260703.2`** — Monitor Gardener Goal release on
  the nightly channel.

  * **Lights panel:** `/lights on` opens a right-panel cockpit with scrollable and
    filterable threads, gardener status, actor status, cloud state, local runtime,
    and usage. `/lights off` closes 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:** `/gardener` opens 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 capture` and
    `stack_effort_record_capture` preserve terminal, browser, screenshot, monitor,
    benchmark, optimizer, and other ad hoc evidence with capture-oriented receipt
    metadata.
  * **Optimizer candidate evidence:** `stack effort optimizer-candidate` and
    `stack_effort_record_optimizer_candidate` preserve 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-packet` and
    `stack_effort_write_engineering_packet` create change summaries with changed
    files, diff stat, validation, skipped gates, risks, and next action.
  * **Effort acceptance receipts:** `stack effort acceptance` and
    `stack_effort_record_acceptance` update one A-level section in
    `findings/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-blocker` and
    `stack_effort_resolve_blocker` preserve resolution evidence for cleared or
    superseded blockers while keeping Efforts out of a blocked lifecycle state.
  * **Efforts panel controls:** `/efforts` supports `j/k` selection, `n` new
    Effort drafting, `h` handoff refresh, `a` archive/activate, `b`
    current-thread binding, and `r` refresh; `/efforts new`, `/efforts archive`,
    and `/efforts activate` expose 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-darwin` artifact prepared with
    SHA256 `b8a86789405831809683747f85083511e982678c1aadb92d4e3e3fff0c31d526`;
    hosted release-site contract proof installed the generated manifest and verified
    version, doctor, demo receipt, and update-check behavior.

  Known limitation: this is a nightly packet. Stable release signing and
  attestation remain outside this dev-channel ship.

  See the repository
  [`CHANGELOG.md`](https://github.com/synth-laboratories/stack/blob/main/CHANGELOG.md)
  for the full nightly technical entry.
</Update>

<Update label="2026-07-03" tags={["stack", "0.2.0-dev.20260703.1", "nightly"]}>
  **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`, and `stack push` move
    optimizer artifacts between hosted runs and the local workspace, recording a
    typed receipt (sha256 digest, git SHA, backend target) for every transfer.
    A `stack_list_hosted_artifacts` MCP tool enumerates what a hosted run
    produced.
  * **Hosted run watch:** `stack watch` follows a hosted optimizer run from the
    CLI, and the TUI gains a hosted-watch panel; both support `--once` snapshots
    and `--replay` over 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:** `/profile` now cycles through all four seeded profiles.
  * **Backfill:** the repository changelog now carries the previously missing
    `0.2.0-dev.20260702.4` hotfix section (hosted optimizer artifact-name
    projection fix).

  See the repository
  [`CHANGELOG.md`](https://github.com/synth-laboratories/stack/blob/main/CHANGELOG.md)
  for the full nightly technical entry.
</Update>

<Update label="2026-07-02" tags={["stack", "0.2.0-dev.20260702.3", "nightly"]}>
  **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](/stack/local-only), [Connect Synth](/stack/connect-synth),
    and [Hosted ops](/stack/hosted-ops).
  * **Updated docs:** [Hosted inference](/stack/inference) now distinguishes free
    aux (`nemotron-3-ultra`) from billed GLM (`glm-5.2`) and states the worker
    opt-in invariant.
  * **Updated docs:** [Overview](/stack) and [Quickstart](/stack/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.3` carries 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.0` cut. Stable
    promotion remains a separate operator decision.

  See the repository
  [`CHANGELOG.md`](https://github.com/synth-laboratories/stack/blob/dev/CHANGELOG.md)
  for the full nightly technical entry.
</Update>

<Update label="2026-07-01" tags={["stack", "0.2.0-dev", "nightly"]}>
  **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:** `/goal` mode defaults to a **Sidecar events** feed instead of the
    worker's raw tool tape. Press `a` for the agent tape, `t` for the monitor's own
    thread, `e` for 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_met` only after it checks the worker's claim against cited proof; an
    unproven claim is surfaced as `blocked` or `goal_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.

  See [Stack Overview](/stack) and the repository
  [`CHANGELOG.md`](https://github.com/synth-laboratories/stack/blob/main/CHANGELOG.md).
</Update>

<Update label="2026-06-29" tags={["stack", "nightly", "planning"]}>
  **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-only
    `stack update --check` are 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](/stack), [Quickstart](/stack/quickstart).
  * **Current status:** Stack is still internal alpha. Public package-manager
    installation and stable support expectations will be added when those channels
    are live.

  See [Stack Overview](/stack) and the repository
  [`CHANGELOG.md`](https://github.com/synth-laboratories/stack/blob/main/CHANGELOG.md).
</Update>

<Update label="2026-06-26" tags={["stack", "0.1.0", "internal-alpha"]}>
  **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-mcp` for 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](/stack), [Hosted inference](/stack/inference),
    [Optimizers (GEPA)](/stack/optimizers).
  * **Status:** internal alpha only. Public GitHub Release and Homebrew install
    paths are not live yet.
</Update>
