fix(plugin): skip non-function exports in getLegacyPlugins

.github/workflows/ci.yml

@@ -0,0 +1,173 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  CI: true
+
+jobs:
+  typecheck:
+    name: Typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ./.github/actions/setup-bun
+      - name: Run typecheck
+        run: bun typecheck
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ./.github/actions/setup-bun
+      - name: Run oxlint
+        run: bun lint
+      - name: Check formatting
+        run: npx prettier --check "packages/opencode/src/**/*.ts" "packages/opencode/test/**/*.ts"
+
+  test:
+    name: Test (shard ${{ matrix.shard }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        shard: ["1/4", "2/4", "3/4", "4/4"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ./.github/actions/setup-bun
+      - name: Configure git identity
+        run: |
+          git config --global user.email "ci@mimo.ai"
+          git config --global user.name "mimo-ci"
+      - name: Run unit tests (shard ${{ matrix.shard }})
+        timeout-minutes: 8
+        working-directory: packages/opencode
+        run: bun run test:ci --shard ${{ matrix.shard }}
+      - name: Upload JUnit
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: junit-shard-${{ strategy.job-index }}
+          path: packages/opencode/.artifacts/unit/junit.xml
+
+  security:
+    name: Security Scan
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ./.github/actions/setup-bun
+      - name: Install skylos
+        run: pip install skylos
+      - name: Run skylos security scan
+        run: skylos suite packages/opencode/src/plugin --json || true
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: skylos-results
+          path: packages/opencode/.artifacts/security/
+
+  quality:
+    name: Code Quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ./.github/actions/setup-bun
+      - name: Install repowise
+        run: pip install repowise
+      - name: Run repowise health
+        run: repowise health packages/opencode/src/plugin --json || true
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: repowise-results
+          path: packages/opencode/.artifacts/quality/
+
+  # Multi-language support: detect and test additional languages
+  python:
+    name: Python (if present)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Check for Python files
+        id: check
+        run: |
+          if find . -name "pyproject.toml" -o -name "setup.py" -o -name "requirements.txt" | grep -v node_modules | head -1; then
+            echo "found=true" >> $GITHUB_OUTPUT
+          fi
+      - name: Setup Python
+        if: steps.check.outputs.found == 'true'
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Install Python deps
+        if: steps.check.outputs.found == 'true'
+        run: |
+          pip install ruff mypy pytest
+      - name: Run ruff
+        if: steps.check.outputs.found == 'true'
+        run: ruff check .
+      - name: Run mypy
+        if: steps.check.outputs.found == 'true'
+        run: mypy . --ignore-missing-imports
+      - name: Run pytest
+        if: steps.check.outputs.found == 'true'
+        run: python -m pytest tests/ -x --timeout=60 || true
+
+  rust:
+    name: Rust (if present)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Check for Cargo.toml
+        id: check
+        run: |
+          if find . -name "Cargo.toml" | grep -v node_modules | head -1; then
+            echo "found=true" >> $GITHUB_OUTPUT
+          fi
+      - name: Setup Rust
+        if: steps.check.outputs.found == 'true'
+        uses: dtolnay/rust-toolchain@stable
+      - name: Cargo check
+        if: steps.check.outputs.found == 'true'
+        run: cargo check
+      - name: Cargo test
+        if: steps.check.outputs.found == 'true'
+        run: cargo test --no-fail-fast || true
+
+  go:
+    name: Go (if present)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Check for go.mod
+        id: check
+        run: |
+          if find . -name "go.mod" | grep -v node_modules | head -1; then
+            echo "found=true" >> $GITHUB_OUTPUT
+          fi
+      - name: Setup Go
+        if: steps.check.outputs.found == 'true'
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+      - name: Go vet
+        if: steps.check.outputs.found == 'true'
+        run: go vet ./...
+      - name: Go test
+        if: steps.check.outputs.found == 'true'
+        run: go test ./... || true

.gitignore

@@ -53,4 +53,9 @@ Thumbs.db
 .playwright-cli/
 .mimocode/wiki
 .mimocode/wikis
-.mimocode/cache
+.mimocode/cache
+
+# SDK codegen scratch: script/build.ts writes it, consumes it, then removes it.
+# A failed generation leaves it behind, where it is easy to commit by accident.
+/packages/sdk/js/openapi.json
+/packages/sdk/js/openapi-ts-error-*.log

AGENTS.md

@@ -98,6 +98,29 @@ const table = sqliteTable("session", {
 })
 ```
 
+### Reading a nullable column
+
+Two independent absences meet in one expression, and only one of them is
+`undefined`. `.get()` yields `undefined` when no row matches — Drizzle normalises
+the driver's `null` there — while a nullable column's SQL `NULL` arrives as
+`null`. So `row?.some_column` is `T | null | undefined`.
+
+When a caller only asks "is there a value", flatten to `undefined`, and write the
+flattening as an annotation rather than an `as` cast:
+
+```ts
+// Good — the compiler enforces it; deleting the `?? undefined` is a type error
+const boundary: MessageID | undefined = row?.last_checkpoint_message_id ?? undefined
+
+// Bad — the cast removes `null` from the union without converting anything,
+// so the declared type is untrue at runtime
+return row?.last_checkpoint_message_id as MessageID | undefined
+```
+
+Discriminate a possibly-absent value with truthiness or `== null`, never with
+`=== undefined` / `!== undefined`. Because `null !== undefined` is `true`, such a
+guard typechecks, reads correctly in review, and does nothing.
+
 ## Testing
 
 - Avoid mocks as much as possible

README.md

@@ -55,6 +55,36 @@ sudo apt install xsel
 ```
 </details>
 
+<details>
+<summary><strong>macOS: rendering issues in the default terminal</strong></summary>
+
+MiMoCode does not support the built-in macOS Terminal (Terminal.app). If the interface is misaligned, flickers, or has other rendering issues, use [iTerm2](https://iterm2.com/) or the VS Code integrated terminal instead:
+
+```bash
+brew install --cask iterm2
+```
+</details>
+
+<details>
+<summary><strong>TUI lag and visual animation issues</strong></summary>
+
+If the TUI lags when run directly over SSH, render it locally and run only the MiMoCode server on the remote host. Start the server from the remote project directory:
+
+```bash
+# Remote host
+mimo serve --port 4096
+
+# Local host: create the SSH port forward
+ssh -N -L 4096:127.0.0.1:4096 user@remote-host
+
+# Local host: connect from another terminal
+mimo attach http://127.0.0.1:4096
+```
+
+If decorative animation is causing the lag, run `/vivid`, or configure **Vivid visuals** in the `ctrl+p` command palette, to switch between Vivid and Minimal visuals as needed.
+
+</details>
+
 <details>
 <summary><strong>Windows: garbled CJK (Chinese/Japanese/Korean) output in the shell</strong></summary>
 

README.zh.md

@@ -55,6 +55,36 @@ sudo apt install xsel
 ```
 </details>
 
+<details>
+<summary><strong>macOS：默认终端渲染异常</strong></summary>
+
+MiMoCode 不支持 macOS 自带的“终端”（Terminal.app）。如果界面出现错位、闪烁或其他渲染异常，请改用 [iTerm2](https://iterm2.com/) 或 VS Code 集成终端：
+
+```bash
+brew install --cask iterm2
+```
+</details>
+
+<details>
+<summary><strong>TUI 卡顿与视觉动画问题</strong></summary>
+
+如果通过 SSH 直接运行 TUI 时卡顿，可以让 TUI 在本地渲染，远端只运行 MiMoCode 服务。先在远端项目目录中启动服务：
+
+```bash
+# 远端主机
+mimo serve --port 4096
+
+# 本地主机：建立 SSH 端口转发
+ssh -N -L 4096:127.0.0.1:4096 user@remote-host
+
+# 本地主机：在另一个终端连接远端 MiMoCode
+mimo attach http://127.0.0.1:4096
+```
+
+如果卡顿来自装饰性动画，可以运行 `/vivid`，或在 `ctrl+p` 命令面板中设置“丰富显示”，根据实际情况在丰富视觉模式和简洁模式间切换。
+
+</details>
+
 <details>
 <summary><strong>Windows：shell 输出中文（CJK）乱码</strong></summary>