@fugood/bricks-project 2.25.0-beta.39 → 2.25.0-beta.40

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.25.0-beta.39",
+  "version": "2.25.0-beta.40",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "bun scripts/build.js"
   },
   "dependencies": {
-    "@fugood/bricks-cli": "^2.25.0-beta.38",
+    "@fugood/bricks-cli": "^2.25.0-beta.40",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
@@ -24,5 +24,6 @@
   },
   "peerDependencies": {
     "oxfmt": "^0.36.0"
-  }
+  },
+  "gitHead": "4ad8588eed6f0161b0aa66d863a36e6c623c4a83"
 }

package/package.json.bak

@@ -1,13 +1,13 @@
 {
   "name": "@fugood/bricks-ctor",
-  "version": "2.25.0-beta.39",
+  "version": "2.25.0-beta.40",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "bun scripts/build.js"
   },
   "dependencies": {
-    "@fugood/bricks-cli": "^2.25.0-beta.38",
+    "@fugood/bricks-cli": "^2.25.0-beta.40",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
@@ -24,5 +24,6 @@
   },
   "peerDependencies": {
     "oxfmt": "^0.36.0"
-  }
+  },
+  "gitHead": "4ad8588eed6f0161b0aa66d863a36e6c623c4a83"
 }

package/skills/bricks-ctor/references/simulator.md

@@ -9,6 +9,23 @@ What the Simulator can and can't faithfully reproduce — so a passing Simulator
 
 A Simulator screenshot proves **layout, navigation, Standby Transitions, Data wiring, and generator/Automation wiring**. It does *not* prove anything that depends on real hardware, real models, or capabilities the preview runtime lacks.
 
+## Automation screenshots
+
+`match_screenshot` stores Simulator automation artifacts at the project level:
+
+```text
+.bricks/automation_screenshots/
+  last/
+  failed/
+  diff/
+```
+
+There is no application-id subdirectory; in CTOR the project is the application. Generated project `.gitignore` files exclude this directory.
+
+When a `match_screenshot` baseline is missing or updated, the baseline goes under `last/`. When a screenshot mismatch occurs, the current capture goes under `failed/` and the pixel diff goes under `diff/`. File names follow `<screenshotName>+local+<timestamp>.png`.
+
+In CTOR Desktop, `simulator_invoke` reports any automation screenshot files created or changed by the invocation in an `Automation screenshots:` section. It still separately reports the ordinary preview capture at `.bricks/simulator-screenshot.jpg`.
+
 ## What the Simulator can't reproduce
 
 Because it runs in a browser-class preview rather than on device hardware, the Simulator cannot exercise these — a green run says nothing about them. Verify on a real device (Path 2):

package/tools/simulator-main.mjs

@@ -1,8 +1,10 @@
 // eslint-disable-next-line import/no-extraneous-dependencies
-import { app, BrowserWindow } from 'electron'
-import { readFile, writeFile } from 'fs/promises'
+import { app, BrowserWindow, ipcMain } from 'electron'
+import { mkdir, readdir, readFile, rm, writeFile } from 'fs/promises'
 import { watchFile } from 'fs'
 import { createServer } from 'http'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
 import { parseArgs } from 'util'
 import * as TOON from '@toon-format/toon'
 
@@ -28,12 +30,70 @@ const { values } = parseArgs({
 })
 
 const cwd = process.cwd()
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const AUTOMATION_SCREENSHOT_PROJECT_DIR = path.join('.bricks', 'automation_screenshots')
 const DEFAULT_SIMULATOR_SECURITY_SETTINGS = Object.freeze({
   allowedInsecureHosts: [],
 })
 
 const isObject = (value) => !!value && typeof value === 'object' && !Array.isArray(value)
 
+const resolveAutomationScreenshotPath = (requestedPath = '') => {
+  const baseDir = path.resolve(cwd, AUTOMATION_SCREENSHOT_PROJECT_DIR)
+  const raw = String(requestedPath || AUTOMATION_SCREENSHOT_PROJECT_DIR)
+  const fromProject = path.resolve(cwd, raw)
+  const target =
+    fromProject === baseDir || fromProject.startsWith(`${baseDir}${path.sep}`)
+      ? fromProject
+      : path.resolve(baseDir, raw)
+
+  if (target !== baseDir && !target.startsWith(`${baseDir}${path.sep}`)) {
+    throw new Error('Automation screenshot path must stay inside the project screenshot directory.')
+  }
+  return target
+}
+
+const normalizeAutomationScreenshotEncoding = (encoding) =>
+  encoding === 'base64' ? 'base64' : 'utf8'
+
+const registerAutomationScreenshotIpc = () => {
+  ipcMain.handle('bricks-automation-screenshots:exists', async (_event, filePath) => {
+    try {
+      await readFile(resolveAutomationScreenshotPath(filePath))
+      return true
+    } catch {
+      return false
+    }
+  })
+  ipcMain.handle('bricks-automation-screenshots:readdir', async (_event, dirPath) => {
+    try {
+      return await readdir(resolveAutomationScreenshotPath(dirPath))
+    } catch {
+      return []
+    }
+  })
+  ipcMain.handle('bricks-automation-screenshots:mkdir', async (_event, dirPath) => {
+    await mkdir(resolveAutomationScreenshotPath(dirPath), { recursive: true })
+  })
+  ipcMain.handle('bricks-automation-screenshots:unlink', async (_event, filePath) => {
+    await rm(resolveAutomationScreenshotPath(filePath), { recursive: true, force: true })
+  })
+  ipcMain.handle('bricks-automation-screenshots:read-file', async (_event, filePath, encoding) =>
+    readFile(
+      resolveAutomationScreenshotPath(filePath),
+      normalizeAutomationScreenshotEncoding(encoding),
+    ),
+  )
+  ipcMain.handle(
+    'bricks-automation-screenshots:write-file',
+    async (_event, filePath, contents, encoding) => {
+      const target = resolveAutomationScreenshotPath(filePath)
+      await mkdir(path.dirname(target), { recursive: true })
+      await writeFile(target, contents, normalizeAutomationScreenshotEncoding(encoding))
+    },
+  )
+}
+
 const normalizeSimulatorSecuritySettings = (settings = {}) => {
   const source = isObject(settings) ? settings : {}
   const allowedHosts = Array.isArray(source.allowedInsecureHosts)
@@ -289,6 +349,7 @@ const startCdpServer = async (mainWindow, port) => {
 }
 
 app.on('ready', () => {
+  registerAutomationScreenshotIpc()
   let show = true
   if (takeScreenshotConfig && !takeScreenshotConfig.noHeadless) show = false
   const mainWindow = new BrowserWindow({
@@ -296,6 +357,11 @@ app.on('ready', () => {
     height: takeScreenshotConfig?.height || 768,
     frame: !takeScreenshotConfig,
     show,
+    webPreferences: {
+      preload: path.join(__dirname, 'simulator-preload.cjs'),
+      contextIsolation: true,
+      nodeIntegration: false,
+    },
   })
   mainWindow.setBackgroundColor('#333')
   mainWindow.webContents.session.webRequest.onBeforeRequest(

package/tools/simulator-preload.cjs

@@ -0,0 +1,16 @@
+const { contextBridge, ipcRenderer } = require('electron')
+
+const AUTOMATION_SCREENSHOT_ROOT = '.bricks/automation_screenshots'
+
+contextBridge.exposeInMainWorld('BRICKS_AUTOMATION_SCREENSHOTS', {
+  rootDir: AUTOMATION_SCREENSHOT_ROOT,
+  exists: (filePath) => ipcRenderer.invoke('bricks-automation-screenshots:exists', filePath),
+  readdir: (dirPath) => ipcRenderer.invoke('bricks-automation-screenshots:readdir', dirPath),
+  readDir: (dirPath) => ipcRenderer.invoke('bricks-automation-screenshots:readdir', dirPath),
+  mkdir: (dirPath) => ipcRenderer.invoke('bricks-automation-screenshots:mkdir', dirPath),
+  unlink: (filePath) => ipcRenderer.invoke('bricks-automation-screenshots:unlink', filePath),
+  readFile: (filePath, encoding) =>
+    ipcRenderer.invoke('bricks-automation-screenshots:read-file', filePath, encoding),
+  writeFile: (filePath, contents, encoding) =>
+    ipcRenderer.invoke('bricks-automation-screenshots:write-file', filePath, contents, encoding),
+})