@fugood/bricks-project 2.23.3 → 2.23.5-1

package/compile/action-name-map.ts

@@ -786,6 +786,20 @@ export const templateActionNameMap = {
       documents: 'GENERATOR_RERANKER_DOCUMENTS',
     },
   },
+  GENERATOR_MLX_LLM: {
+    GENERATOR_MLX_LLM_LOAD_MODEL: {
+      modelId: 'GENERATOR_MLX_LLM_MODEL_ID',
+      vlm: 'GENERATOR_MLX_LLM_VLM',
+    },
+    GENERATOR_MLX_LLM_COMPLETION: {
+      messages: 'GENERATOR_MLX_LLM_MESSAGES',
+      tools: 'GENERATOR_MLX_LLM_TOOLS',
+      maxTokens: 'GENERATOR_MLX_LLM_MAX_TOKENS',
+      temperature: 'GENERATOR_MLX_LLM_TEMPERATURE',
+      topP: 'GENERATOR_MLX_LLM_TOP_P',
+      repetitionPenalty: 'GENERATOR_MLX_LLM_REPETITION_PENALTY',
+    },
+  },
   GENERATOR_QNN_LLM: {
     GENERATOR_QNN_LLM_PROCESS: {
       prompt: 'GENERATOR_QNN_LLM_PROMPT',

package/compile/index.ts

@@ -266,6 +266,7 @@ const compileApplicationSettings = (settings: Application['settings']) => ({
         use_gemini_api_key_system_data: settings.ai.useGeminiApiKeySystemData,
       }
     : undefined,
+  hide_short_refs: settings?.hideShortRefs,
 })
 
 const animationTypeMap = {
@@ -385,6 +386,7 @@ function compileRunArray(run: unknown[]): unknown[] {
 const compileTestCase = (testCase: TestCase) => ({
   id: testCase.id,
   name: testCase.name,
+  hide_short_ref: testCase.hideShortRef,
   run: compileRunArray(testCase.run),
   exit_on_failed: testCase.exit_on_failed,
   commented: testCase.commented,
@@ -449,6 +451,7 @@ const compileAutomationTest = (
   return {
     id: testId,
     title: test.title,
+    hide_short_ref: test.hideShortRef,
     timeout: test.timeout,
     trigger_type: test.trigger_type,
     cron: test.cron,
@@ -476,6 +479,7 @@ const compileAutomationTestMap = (testMap: AutomationTestMap, mapId: string) =>
 
   return {
     title: testMap.title,
+    hide_short_ref: testMap.hideShortRef,
     createdAt: testMap.createdAt,
     map: arrayToIdMap(
       testMap.tests,
@@ -519,6 +523,7 @@ export const compile = async (app: Application) => {
       subspaceMap[subspaceId] = {
         title: subspace.title,
         description: subspace.description,
+        hide_short_ref: subspace.hideShortRef,
         _expanded: subspace.unexpanded
           ? {
               brick: !subspace.unexpanded.brick,
@@ -556,8 +561,10 @@ export const compile = async (app: Application) => {
           if (animation.__typename === 'Animation') {
             const animationDef = animation as AnimationDef
             map[animationId] = {
+              alias: animationDef.alias,
               title: animationDef.title,
               description: animationDef.description,
+              hide_short_ref: animationDef.hideShortRef,
               animationRunType: animationDef.runType,
               property: animationDef.property,
               type: animationTypeMap[animationDef.config.__type],
@@ -569,8 +576,10 @@ export const compile = async (app: Application) => {
           } else if (animation.__typename === 'AnimationCompose') {
             const animationDef = animation as AnimationComposeDef
             map[animationId] = {
+              alias: animationDef.alias,
               title: animationDef.title,
               description: animationDef.description,
+              hide_short_ref: animationDef.hideShortRef,
               animationRunType: animationDef.runType,
               compose_type: animationDef.composeType,
               item_list: animationDef.items.map((item, index) => {
@@ -670,6 +679,8 @@ export const compile = async (app: Application) => {
                 buildList(item, index, 'brickList'),
               )
               property.brickList = brickList
+            } else if (!brickItems.brickList) {
+              property.brickList = []
             } else {
               // Not supported Data for brickList
               throw new TypeError('Not supported Data for brickList directly')
@@ -679,6 +690,8 @@ export const compile = async (app: Application) => {
                 buildList(item, index, 'brickDetails'),
               )
               property.brickDetails = brickDetails
+            } else if (!brickItems.brickDetails) {
+              property.brickDetails = []
             } else {
               // Not supported Data for brickList
               throw new TypeError('Not supported Data for brickList directly')
@@ -686,8 +699,10 @@ export const compile = async (app: Application) => {
           }
           map[brickId] = {
             template_key: brick.templateKey,
+            alias: brick.alias,
             title: brick.title,
             description: brick.description,
+            hide_short_ref: brick.hideShortRef,
             property,
             animation: compileAnimations(
               brick.templateKey,
@@ -754,8 +769,10 @@ export const compile = async (app: Application) => {
           )
 
           map[canvasId] = {
+            alias: canvas.alias,
             title: canvas.title,
             description: canvas.description,
+            hide_short_ref: canvas.hideShortRef,
             property: compileProperty(
               canvas.property,
               `(canvas: ${canvasId}, subspace ${subspaceId})`,
@@ -834,8 +851,10 @@ export const compile = async (app: Application) => {
 
           map[generatorId] = {
             template_key: generator.templateKey,
+            alias: generator.alias,
             title: generator.title,
             description: generator.description,
+            hide_short_ref: generator.hideShortRef,
             local_sync: generator.localSyncRunMode
               ? {
                   run_mode: generator.localSyncRunMode,
@@ -904,8 +923,10 @@ export const compile = async (app: Application) => {
           )
 
           map[dataId] = {
+            alias: data.alias,
             title: data.title,
             description: data.description,
+            hide_short_ref: data.hideShortRef,
             linked: data.metadata?.linked,
             linkedFrom: data.metadata?.linkedFrom,
             local_sync: data.localSyncUpdateMode
@@ -939,6 +960,7 @@ export const compile = async (app: Application) => {
           const calc: any = {
             title: dataCalc.title,
             description: dataCalc.description,
+            hide_short_ref: dataCalc.hideShortRef,
           }
           if (dataCalc.triggerMode) calc.trigger_type = dataCalc.triggerMode
           if (dataCalc.__typename === 'DataCalculationMap') {
@@ -1025,6 +1047,7 @@ export const compile = async (app: Application) => {
                 acc[getNodeId(dataNode, 'data node', nodeIndex)] = {
                   title: dataNode.title,
                   description: dataNode.description,
+                  hide_short_ref: dataNode.hideShortRef,
                   type: 'data-node',
                   properties: {},
                   in: generateInputPorts(dataNode.inputs),
@@ -1050,6 +1073,7 @@ export const compile = async (app: Application) => {
                 acc[getNodeId(commandNode, 'command node', nodeIndex)] = {
                   title: commandNode.title,
                   description: commandNode.description,
+                  hide_short_ref: commandNode.hideShortRef,
                   type: `command-node-${type}`,
                   properties: {
                     command: commandNode.__commandName,
@@ -1193,3 +1217,8 @@ export const compile = async (app: Application) => {
   }
   return config
 }
+
+export const checkConfig = async (configPath: string) => {
+  const { $ } = await import('bun')
+  await $`bricks app check-config ${configPath}`
+}

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.23.3",
+  "version": "2.23.5-1",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "bun scripts/build.js"
   },
   "dependencies": {
-    "@fugood/bricks-cli": "^2.23.2",
+    "@fugood/bricks-cli": "^2.23.5-1",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
     "@toon-format/toon": "^2.1.0",
-    "@types/escodegen": "^0.0.10",
     "@types/bun": "^1.3.9",
+    "@types/escodegen": "^0.0.10",
     "@types/lodash": "^4.17.12",
     "acorn": "^8.13.0",
     "escodegen": "2.1.0",

package/skills/bricks-project/rules/architecture-patterns.md

@@ -37,6 +37,13 @@ Built-in commands for direct state and UI changes.
 ### Data Calculation (Priority 4)
 ONLY for deriving, formatting, or aggregating values from other data. Not for orchestration, side effects, or flow control.
 
+## Entity Aliases
+
+Set `alias` on entities to give them a stable, human-readable name:
+- Code generation uses alias as the variable name (e.g., `alias: 'submitBtn'` → `export const submitBtn`)
+- At runtime, devtools MCP tools accept alias instead of short ID and selectors can match by alias. Note: bricks-project does not directly interact with devtools MCP — aliases here primarily affect code generation
+- Aliases must be unique across the application — duplicates are excluded from resolution
+
 ## Flow Decomposition
 
 When the user describes a complex flow, decompose it BEFORE writing code:

package/skills/bricks-project/rules/buttress.md

@@ -14,8 +14,9 @@ When mobile devices or embedded systems lack hardware for local AI inference (LL
 
 ## Supported Generators
 
-- [LLM (GGML)](generator_LLM) - Local Large Language Model inference
-- [Speech-to-Text (GGML)](generator_SpeechInference) - Local Speech-to-Text inference
+- LLM (GGML) (LlmMlx.ts) - Local Large Language Model inference with GGML
+- LLM (MLX) (LlmGgml.ts) - Local Large Language Model inference with MLX
+- Speech-to-Text (GGML) (SpeechToTextGgml.ts) - Local Speech-to-Text inference with GGML
 
 ## Client Configuration
 
@@ -50,10 +51,12 @@ const llmGenerator: GeneratorLLM = {
   property: {
     modelUrl: 'https://huggingface.co/ggml-org/gemma-3-12b-it-qat-GGUF/resolve/main/gemma-3-12b-it-qat-q4_0.gguf',
     contextSize: 8192,
-    buttressEnabled: true,
-    buttressUrl: 'http://192.168.1.100:2080',
-    buttressFallbackType: 'use-local',
-    buttressStrategy: 'prefer-best',
+    buttressConnectionSettings: {
+      enabled: true,
+      url: 'http://192.168.1.100:2080',
+      fallbackType: 'use-local',
+      strategy: 'prefer-best',
+    },
   },
   events: {},
   switches: [],