ci: bootstrap opencode submodule across setup and workflows

Author: pRizz

.dockerignore

@@ -0,0 +1,16 @@
+# VCS / CI metadata
+.git
+.github
+
+# Local dependencies and build outputs
+node_modules
+target
+.pnpm-store
+.pnpm-debug.log*
+
+# OS noise
+.DS_Store
+
+# Submodule checkout is not needed in Docker build context
+packages/opencode
+packages/opencode/**

.github/workflows/cargo-updates.yml

@@ -16,6 +16,12 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
+      - name: Initialize opencode submodule
+        run: |
+          git submodule sync --recursive
+          git -c url."https://github.com/".insteadOf=git@github.com: submodule update --init --recursive packages/opencode
+          git submodule status --recursive
+
       - name: Install Rust
         uses: dtolnay/rust-toolchain@master
         with:

.github/workflows/cargo-upgrades.yml

@@ -17,6 +17,12 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
+      - name: Initialize opencode submodule
+        run: |
+          git submodule sync --recursive
+          git -c url."https://github.com/".insteadOf=git@github.com: submodule update --init --recursive packages/opencode
+          git submodule status --recursive
+
       - name: Install Rust
         uses: dtolnay/rust-toolchain@master
         with:

.github/workflows/ci-pre-publish.yml

@@ -26,8 +26,12 @@ jobs:
         with:
           # If ref is not provided, checkout defaults to the commit that triggered the workflow
           ref: ${{ inputs.ref }}
-          # Required for just targets that validate/build/test packages/opencode.
-          submodules: recursive
+
+      - name: Initialize opencode submodule
+        run: |
+          git submodule sync --recursive
+          git -c url."https://github.com/".insteadOf=git@github.com: submodule update --init --recursive packages/opencode
+          git submodule status --recursive
 
       - name: Log version
         if: inputs.version != ''
@@ -50,12 +54,24 @@ jobs:
           node-version: '20'
           cache: 'pnpm'
 
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v2
+
       - name: Rust cache
         uses: Swatinem/rust-cache@v2
 
       - name: Install Node dependencies
         run: pnpm install --frozen-lockfile --ignore-scripts
 
+      - name: Lint opencode packages
+        run: just lint-opencode
+
+      - name: Build opencode packages
+        run: just build-opencode
+
+      - name: Lint opencode broker
+        run: just lint-opencode-broker
+
       - name: Check formatting
         run: cargo fmt --all -- --check
 

.github/workflows/ci.yml

@@ -70,6 +70,12 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
+      - name: Initialize opencode submodule
+        run: |
+          git submodule sync --recursive
+          git -c url."https://github.com/".insteadOf=git@github.com: submodule update --init --recursive packages/opencode
+          git submodule status --recursive
+
       - name: Install Rust
         uses: dtolnay/rust-toolchain@master
         with:
@@ -88,12 +94,24 @@ jobs:
           node-version: '20'
           cache: 'pnpm'
 
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v2
+
       - name: Rust cache
         uses: Swatinem/rust-cache@v2
 
       - name: Install Node dependencies
         run: pnpm install --frozen-lockfile --ignore-scripts
 
+      - name: Lint opencode packages
+        run: just lint-opencode
+
+      - name: Build opencode packages
+        run: just build-opencode
+
+      - name: Lint opencode broker
+        run: just lint-opencode-broker
+
       - name: Clippy
         run: cargo clippy --all-targets --all-features -- -D warnings
 

.github/workflows/update-opencode-commit.yml

@@ -18,6 +18,12 @@ jobs:
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: Initialize opencode submodule
+        run: |
+          git submodule sync --recursive
+          git -c url."https://github.com/".insteadOf=git@github.com: submodule update --init --recursive packages/opencode
+          git submodule status --recursive
+
       - name: Configure Git
         run: |
           git config user.name "github-actions[bot]"
@@ -37,6 +43,6 @@ jobs:
             exit 0
           fi
 
-          git add packages/core/src/docker/Dockerfile
+          git add packages/core/src/docker/Dockerfile packages/opencode
           git commit -m "chore: update opencode commit"
           git push

CONTRIBUTING.md

@@ -32,8 +32,15 @@ git clone https://github.com/pRizz/opencode-cloud.git
 git clone https://gitea.com/pRizz/opencode-cloud.git
 cd opencode-cloud
 
-# Install dependencies
-pnpm install
+# Initialize submodule checkout
+git submodule sync --recursive
+git submodule update --init --recursive packages/opencode
+
+# Bun is required for packages/opencode checks/builds
+bun --version
+
+# One-time setup (hooks + deps + submodule bootstrap)
+just setup
 
 # Build everything
 just build

README.md

@@ -161,6 +161,8 @@ git clone https://github.com/pRizz/opencode-cloud.git
 # Gitea (mirror)
 git clone https://gitea.com/pRizz/opencode-cloud.git
 cd opencode-cloud
+git submodule sync --recursive
+git submodule update --init --recursive packages/opencode
 cargo install --path packages/cli-rust
 ```
 
@@ -173,6 +175,13 @@ git clone https://github.com/pRizz/opencode-cloud.git
 # Gitea (mirror)
 git clone https://gitea.com/pRizz/opencode-cloud.git
 cd opencode-cloud
+git submodule sync --recursive
+git submodule update --init --recursive packages/opencode
+ 
+# Bun is required for packages/opencode checks/builds
+bun --version
+
+just setup
 just build
 cargo run -p opencode-cloud -- --version
 ```
@@ -401,11 +410,11 @@ Data (PID files, etc.) is stored at:
 ## Development
 
 ```bash
-# Install dependencies
-pnpm install
+# Bun is required for packages/opencode checks/builds
+bun --version
 
-# Configure git hooks (once after cloning)
-git config core.hooksPath .githooks
+# One-time setup (hooks + deps + submodule bootstrap)
+just setup
 
 # Build everything
 just build

justfile

@@ -10,6 +10,10 @@ list:
 # Setup development environment (run once after cloning)
 setup:
     git config core.hooksPath .githooks
+    git submodule sync --recursive
+    git -c url."https://github.com/".insteadOf=git@github.com: submodule update --init --recursive packages/opencode
+    @command -v bun >/dev/null 2>&1 || (echo "Error: bun is required for packages/opencode checks/builds. Install from https://bun.sh and rerun just setup." && exit 1)
+    bun install --cwd packages/opencode --frozen-lockfile
     pnpm install
     @echo "✓ Development environment ready!"
 
@@ -111,6 +115,10 @@ check-opencode-submodule-drift:
 update-opencode-commit:
     ./scripts/update-opencode-commit.sh
 
+# Format opencode-broker Rust crate
+fmt-opencode-broker: opencode-submodule-check
+    cargo fmt --manifest-path packages/opencode/packages/opencode-broker/Cargo.toml --all
+
 # --- Docker Sandbox Image ---
 
 # Build Docker sandbox image with BuildKit caching (amd64 only, for local dev)
@@ -233,7 +241,7 @@ pre-commit-full: fmt lint build test-all-fast build-docker
     @echo "✓ Full pre-commit checks passed (including Docker build)"
 
 # Format everything
-fmt:
+fmt: fmt-opencode-broker
     cargo fmt --all
     pnpm -r format
 

packages/core/README.md

@@ -161,6 +161,8 @@ git clone https://github.com/pRizz/opencode-cloud.git
 # Gitea (mirror)
 git clone https://gitea.com/pRizz/opencode-cloud.git
 cd opencode-cloud
+git submodule sync --recursive
+git submodule update --init --recursive packages/opencode
 cargo install --path packages/cli-rust
 ```
 
@@ -173,6 +175,13 @@ git clone https://github.com/pRizz/opencode-cloud.git
 # Gitea (mirror)
 git clone https://gitea.com/pRizz/opencode-cloud.git
 cd opencode-cloud
+git submodule sync --recursive
+git submodule update --init --recursive packages/opencode
+ 
+# Bun is required for packages/opencode checks/builds
+bun --version
+
+just setup
 just build
 cargo run -p opencode-cloud -- --version
 ```
@@ -401,11 +410,11 @@ Data (PID files, etc.) is stored at:
 ## Development
 
 ```bash
-# Install dependencies
-pnpm install
+# Bun is required for packages/opencode checks/builds
+bun --version
 
-# Configure git hooks (once after cloning)
-git config core.hooksPath .githooks
+# One-time setup (hooks + deps + submodule bootstrap)
+just setup
 
 # Build everything
 just build