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

# Changelog

> Product updates and announcements for bricks-ctor

<Update label="July 8, 2026" description="v2.24.11" tags={["Release", "Preview"]}>
  ### Code generation

  * Generated projects now start with canvases, Bricks, and Data collapsed by default while preserving explicit expanded-state settings.
  * Generated Items Brick projects preserve item fields such as frame type and detail / list press behaviors.

  ### MCP server

  * Simulator MCP output now points agents to the Preview DevTools / `bricks devtools` inspection loop after successful compiles. See [MCP server](/ctor-pkg/mcp-server).
</Update>

<Update label="July 1, 2026" description="v2.24.10" tags={["Release", "Preview"]}>
  ### Code generation

  * Generated projects serialize array data values correctly.
  * Data Calculation sandbox output no longer accumulates extra `{ }` blocks on each compile.
  * Other generated-project stability fixes.

  ### Pull app

  * **`bricks ctor pull-app`** — creates missing parent directories and respects the selected starting branch.
</Update>

<Update label="June 24, 2026" description="v2.24.9" tags={["Release", "Preview"]}>
  ### Code generation

  * Generated projects preserve conditional jumps whose target case id is dynamic, instead of silently dropping them during compile.
  * Generator code generation no longer produces duplicate variable declarations when entity aliases collide.
  * Generated projects no longer lose a Data Calculation when one alias collides with another's fallback file name.

  ### Automation tests

  * Legacy automation tests now migrate into per-test files instead of being dropped and replaced with empty placeholders.

  ### MCP

  * A malformed MCP config no longer wipes your other configured MCP servers during project setup.
</Update>

<Update label="June 17, 2026" description="v2.24.8" tags={["Release", "Preview"]}>
  ### Codex

  * Generated projects pre-approve the bricks-ctor MCP tools for Codex, so Codex CLI sessions can call them without stalled approval prompts.

  ### Claude Code

  * Claude Code projects seed local auto-mode trusted BRICKS infrastructure without enabling auto mode automatically.

  ### Compile validation

  * Generated project compile checks catch Data Calculation cycles and broken PROPERTY\_BANK\_EXPRESSION strings earlier.
</Update>

<Update label="May 27, 2026" description="v2.24.5" tags={["Release", "Preview"]}>
  ### Compile validation

  * **`bricks app check-config --validate-automation`** — surfaces broken automation\_map / test\_map references (missing Subspaces, Bricks, Canvases, Banks, dynamic senders / handlers, malformed `PROPERTY_BANK_*` `input_to_receiver` prefixes) at compile time. The project agent's compile path enables this by default.

  ### Automation

  * **Optional `subspaceId` on method steps** — `brick_press`, `execute_action`, `wait_until_*`, `delay`, and other method steps can omit `subspaceId`; the runtime resolves it to the root subspace. The [Config Editor](/controller/config-editor) labels the empty option as "Root (default)".

  ### Type system

  * **Animation event handlers** now accept a getter form (`() => Animation`) so lazy or forward references between animations type-check, matching every other entity reference.
  * **`boolean` accepted as an alias for `bool`** on Data type fields for ergonomics with TypeScript-trained authors. Runtime output is unchanged.

  ### MCP

  * MCP tool output no longer carries ANSI escape sequences from `tsc` / `bun` / `bricks` child processes; terminal callers stay color-on.
</Update>

<Update label="May 20, 2026" description="v2.24.4" tags={["Release", "Preview"]}>
  ### Auto-compile and pull

  * **Background auto-compile** — hash-gated background builds while a project session is active, with an inline compile-error banner and a **Pull** / **Update Config** pill flow that detects server-newer / local-ahead state.
  * **Non-force Pull** — the Pull dialog gains a non-force option that branches at the server's last commit, applies the new files, and merges `main` back in. Force Pull keeps the previous in-place overwrite.

  ### Deploy and rename

  * **Deploy / Update Config** forward the `application.json` name so renaming a project locally renames it on the server in the same request. Pairs with [`bricks app/module release --name`](/cli/changelog).

  ### Generated files

  * Automation-test and data-calculation filenames now use a kebab-cased alias slug so they stay stable across reorders; orphan `.ts` files are cleaned up on pull.

  ### Skills

  * New **bricks-design** and **bricks-ux** [skills](/ctor-pkg/skills) bundle the visual-design and interaction-design disciplines for project agents.
</Update>

<Update label="May 13, 2026" description="v2.24.3" tags={["Release", "Preview"]}>
  ### Improvements

  * Generated projects ship a new `bun update-app` script that pushes config changes without bumping the release version. Pairs with the `bricks app update --last-commit-id` / `--validate` conflict guards in [BRICKS CLI](/cli/changelog).
  * Refresh the agent reference for Buttress integration.
</Update>

<Update label="April 29, 2026" description="v2.24.1" tags={["Release", "Preview"]}>
  ### Improvements

  * Auto-generated commits (deploy, pull force-commits, migration/update) are now attributed to a CTOR (Desktop) author.
  * Generator skips dot directories and markdown files when formatting generated projects.
</Update>

<Update label="April 22, 2026" description="v2.24.0" tags={["Release", "Breaking"]}>
  ### Breaking changes

  * **Renamed from `bricks-project`** — `@fugood/bricks-project` is now `@fugood/bricks-ctor`, and `bricks-project-generator` is now `bricks-ctor-generator`.
  * **New project layout** — generated projects use `from 'bricks-ctor'` imports and the `./ctor/` directory.
  * **Automatic migration** — legacy `project/` directories and MCP config keys are migrated on first run. See [getting started](/ctor-pkg/getting-started) for the current setup.
</Update>