workflow updates; upgrade lilac

.github/workflows/tests.yaml

@@ -10,44 +10,44 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
-
-    - uses: actions/setup-node@v6
-      with:
-        node-version: 24
-
-    - name: Enable Corepack
-      run: |
-        corepack enable
-        corepack prepare yarn@4.12.0 --activate
-        yarn --version
-
-    - uses: calcit-lang/setup-cr@0.0.8
-
-    - name: "load deps"
-      run: caps --ci && yarn
-
-    - name: "test js"
-      run: >
-        cr --init-fn respo.test.main/main! js
-        && node test.mjs
-
-    - name: "build js"
-      run: >
-        cr js
-        && yarn vite build --base=./
-
-    - name: Deploy to server
-      id: deploy
-      uses: Pendect/action-rsyncer@v2.0.0
-      env:
-        DEPLOY_KEY: ${{secrets.rsync_private_key}}
-      with:
-        flags: '-avzr --progress'
-        options: ''
-        ssh_options: ''
-        src: 'dist/*'
-        dest: 'rsync-user@tiye.me:/web-assets/repo/${{ github.repository }}'
-
-    - name: Display status from deploy
-      run: echo "${{ steps.deploy.outputs.status }}"
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+
+      - name: Enable Corepack
+        run: |
+          corepack enable
+          corepack prepare yarn@4.12.0 --activate
+          yarn --version
+
+      - uses: calcit-lang/setup-cr@0.0.8
+
+      - name: "load deps"
+        run: caps --ci && yarn
+
+      - name: "test js"
+        run: >
+          cr --init-fn respo.test.main/main! js
+          && node test.mjs
+
+      - name: "build js"
+        run: >
+          cr js
+          && yarn vite build --base=./
+
+      - name: Deploy to server
+        id: deploy
+        uses: Pendect/action-rsyncer@v2.0.0
+        env:
+          DEPLOY_KEY: ${{secrets.rsync_private_key}}
+        with:
+          flags: "-avzr --progress"
+          options: ""
+          ssh_options: ""
+          src: "dist/*"
+          dest: "rsync-user@tiye.me:/web-assets/repo/${{ github.repository }}"
+
+      - name: Display status from deploy
+        run: echo "${{ steps.deploy.outputs.status }}"

.gitignore

@@ -11,3 +11,5 @@ tmp/
 draft/
 
 .yarn/*.gz
+
+.calcit-snippets/

Agents.md

@@ -29,6 +29,14 @@ cr docs agents --full
 - 若代码块是“示意片段”而非可独立运行程序，优先标记为 `cirru.no-check`。
 - 若需要在单个代码块里串联多个表达式并共享中间值，使用 `let` 显式绑定；默认不会把前面表达式自动注册为全局定义。
 
+Respo 特有约束（不要上推到 Calcit 主程序）:
+
+- `defstyle`、`:class-name`、DOM props、样式字符串等约定，只放在 Respo 文档或 Agent 文件中说明，不要要求 Calcit CLI/Rust 主程序内置这些领域知识。
+- 编辑 `defstyle` 时，selector 使用字符串叶子，如 `|&`、`|&:hover`、`|input&`；不要写裸符号 `&`。
+- 样式值只要带空格或特殊字符，优先按字符串处理，并尽量复用 CLI 已输出的序列化形式。例如 `"|4px 10px"`、`"|1px solid "`、`"|calc(100vh - 76px)"`。
+- 遇到这类字符串，不要期待 Calcit 主程序理解它们的前端语义；应通过 Respo 文档里的工作流来规避误写：先 `cr query def` 看当前序列化，再用 `cr edit def --overwrite -f ...` 覆盖。
+- 相关细节统一收敛到 `docs/guide/styles.md`，Agent 文件只保留高频提醒，避免重复扩写。
+
 CLI 查询速查(面向 Agent):
 
 - 列出命名空间: