更新日誌

​

Code generation

• 別名為 JavaScript 保留字（class、default、return 等）的 brick、generator 或 animation 會編譯出可解析的產生專案。識別字會加上 _ 字尾，不再原樣輸出。請參閱 pull app。
• Generator LLM 的 Interrupted event 欄位（本版本為 OpenAI 與 Anthropic generator 新增）已宣告於產生的型別與文件中。請參閱 BRICKS Foundation。

​

安全性

• 新增 bricks-sast CLI — CTOR 應用程式的靜態安全檢查。它會掃描 application config 中的危險設定 — 內嵌明文密鑰、易受 SSRF 影響的請求、SQL 字串拼接、易致 ReDoS 的樣式等 — 並支援嚴重度門檻、baseline、自訂規則，以及供 CI 使用的 SARIF / JSON 輸出。

​

Automations

• match_screenshot 的參數文件與型別已改為與 runner 實際讀取的一致：[name, allowFailureMismatch?, threshold?]。

​

Code generation

• Subspace 的 exceed_boundary frame 旗標可透過 pull → push 往返而保留，並宣告於產生的型別中。詳見拉取應用程式。

​

Modules

• 在 Controller 中對連結 Module 公開 Data 所做的覆寫值，現在可通過 pull → push 往返而保留。先前這些值只存在於 Subspace 中，伺服器在每次 push 時都會填回 Module 預設值，等於無聲還原。詳見拉取應用程式。

​

Skills

• 新增 Items 與手動排版清單的取捨規則，依結構特徵而非項目數量判斷，並附上開發中途的升級判斷時機與手動排版 → Items 的轉換流程。詳見 Skills。
• bricks-design 新增 display-scale 參考文件，將實體螢幕尺寸、觀看距離與操作方式對應到具體的字級、間距與觸控目標數值。

​

驗證

• bricks app doctor 與 ctor 編譯檢查現在會驗證項目 Brick 的 event maps，標示格式錯誤的項目，以及舊版 Short Edit 寫入所留下的無效 key。詳見 BRICKS CLI。
• 編譯缺少 AUTOMATION_MAP_DEFAULT 的 automation map 現在會以明確訊息失敗，不再編譯成功卻沒有任何可執行的測試。

​

Code generation

• 使用 item_key_mapping 條件的項目 Brick state groups 可通過 pull → source → compile 的往返；無法識別的條件現在會明確報錯，不再被無聲移除。
• 測試案例的 jump conditions 統一為單一的 data / status 契約：非 status 的條件跳轉現在會確實觸發，subspace_id / property_bank_id 會被保留，舊有的 data condition 也能通過往返。

​

MCP server

• MCP 編輯工具與 Simulator 截圖都限制在專案目錄內。詳見 MCP server。

​

重大變更

• 專案工具鏈移至 BRICKS CLI — @fugood/bricks-ctor 不再內含專案工具，改由 @fugood/bricks-cli 的 bricks ctor 指令群取代。既有專案會在 bricks ctor postinstall 時自動遷移，一併更新 package scripts、相依套件與 .mcp.json。詳見 BRICKS CLI。

​

MCP server

• 實驗性編輯工具 — 提供編輯 entry、事件、canvas 項目、switch 與 DataCalculationScript 檔案的專用工具，常見操作不必再直接修改原始程式碼。詳見 MCP server。
• Subspace 參照 — 在內嵌、事件 handler 與連結 metadata 中，改以 () => subspace1 getter 取代手寫的 SUBSPACE_<uuid> 字串，並新增 new_subspace 工具直接建立 Subspace 骨架。
• MCP Server 與 HTTP Server 沙盒指令碼支援型別化的 script members。

​

Skills

• bricks-ctor skill 新增多 Subspace 設計指南。

​

Code generation

• Generated Items Brick projects 現在會將 item Outlets 綁定至預期的 Data properties。

​

Code generation

• Generated projects 會在 bricks ctor pull-app 後保留 collapsed editor state 與 Data Bank property IDs。
• Project code generation 會保留值為 zero 的 Data bounds 與 zero/false frame standby settings。

​

Skills

• bricks-ctor skill 會引導 agents 使用支援的 native 與 Google font-family choices。

​

MCP server

• MCP config validation 接受 fan out 至多個 Data nodes 的 DataCalculationScript outputs。詳見 MCP server。

​

Code generation

• 生成的 projects 現在預設會收合 canvases、Bricks 與 Data，同時保留 explicit expanded-state settings。
• 生成的 Items Brick projects 會保留 frame type 與 detail/list press behaviors 等 item fields。

​

MCP server

• Simulator MCP output 現在會在 successful compiles 後指向 Preview DevTools / bricks devtools inspection loop。詳見 MCP server。

​

Code generation

• 生成的 projects 會正確 serialize array data values。
• Data Calculation sandbox output 不再於每次 compile 後累積額外的 { } blocks。
• 其他 generated-project 穩定性修正。

​

Pull app

• bricks ctor pull-app — 會建立缺少的 parent directories，並尊重選擇的 starting branch。

​

Code generation

• 生成的 projects 會保留 target case id 為 dynamic 的 conditional jumps，不再在 compile 時默默丟棄。
• Generator code generation 在 entity aliases 衝突時不再產生重複的 variable declarations。
• 生成的 projects 不再在某個 alias 與另一個的 fallback file name 衝突時遺失 Data Calculation。

​

Automation tests

• Legacy automation tests 現在會 migrate 成 per-test files，不再被丟棄並以空的 placeholders 取代。

​

MCP

• 格式錯誤的 MCP config 在 project setup 期間不再清除你其他已設定的 MCP servers。

​

Codex

• 生成 projects 會為 Codex 預先 approve bricks-ctor MCP tools，讓 Codex CLI sessions 不會卡在 approval prompts。

​

Claude Code

• Claude Code projects 會 seed local auto-mode trusted BRICKS infrastructure，但不會自動啟用 auto mode。

​

編譯驗證

• 生成 project compile checks 會更早抓出 Data Calculation cycles 與壞掉的 PROPERTY_BANK_EXPRESSION strings。

​

編譯驗證

• bricks app check-config --validate-automation — 在編譯期就揭露失效的 automation_map／test_map 參照（缺漏的 Subspace、Brick、Canvas、Bank、動態 sender／handler，以及格式錯誤的 PROPERTY_BANK_* input_to_receiver 前綴）。專案代理的 compile 流程預設啟用。

​

Automation

• Method steps 的 subspaceId 可省略 — brick_press、execute_action、wait_until_*、delay 等 method steps 可省略 subspaceId，執行時自動解析為 Root Subspace。Config Editor 將空值選項標示為「Root (default)」。

​

型別系統

• Animation Event 處理欄位 改為支援 getter 形式（() => Animation），讓 Animation 之間的延遲或前向引用能通過型別檢查，與其他實體參照一致。
• Data 型別欄位接受 boolean 作為 bool 的別名，便於 TypeScript 使用者撰寫；編譯輸出不變。

​

MCP

• MCP 工具輸出不再混入來自 tsc／bun／bricks 子程序的 ANSI 顏色碼；終端機呼叫端仍保留顏色。

​

自動編譯與 Pull

• 背景自動編譯 — 專案 Session 啟用時於背景自動編譯（Hash gate 控制是否實際執行），內嵌錯誤橫幅，以及偵測伺服器較新／本地較前狀態的 Pull／Update Config Pill 流程。
• 非強制 Pull — Pull 對話框新增非強制 Pull：在伺服器 last commit 上分支、套用新檔案後再將 main 合併回來。Force Pull 保留原本的覆寫行為。

​

Deploy 與重新命名

• Deploy／Update Config 會將 application.json 中的名稱一併送出，本地改名同時也會在伺服器更名。搭配 bricks app/module release --name 使用。

​

產生檔案

• Automation Test 與 Data Calculation 的生成檔名改以 alias 推導的 kebab-case slug，避免重新排序後檔名飄移；Pull 時會清掉孤兒 .ts 檔案。

​

Skills

• 新增 bricks-design／bricks-ux skills，包含視覺設計與互動設計的完整規範供專案代理使用。

​

改進項目

• 產生的專案新增 bun update-app 腳本，可在不變更 release 版本的情況下推送設定變更，搭配 BRICKS CLI 中 bricks app update --last-commit-id／--validate 的衝突防護機制使用。
• 更新代理使用的 Buttress 整合說明參考。

​

改進項目

• 自動產生的 Commit（deploy、pull force-commit、遷移／更新）改以 CTOR（Desktop）作者署名。
• Generator 在格式化產生專案時，會略過點開頭目錄與 markdown 檔案。

​

重大變更

• 從 bricks-project 重新命名 — @fugood/bricks-project 現為 @fugood/bricks-ctor；bricks-project-generator 現為 bricks-ctor-generator。
• 新的專案結構 — 新產生的專案使用 from 'bricks-ctor' 匯入與 ./ctor/ 目錄。
• 自動遷移 — 舊版 project/ 目錄與 MCP 設定鍵會在首次執行時自動遷移。最新的設定方式請參考入門指南。