Merge develop into v4

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "develop",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.changeset/perky-rooms-tan.md

@@ -0,0 +1,2 @@
+---
+---

.github/workflows/changeset-check.yml

@@ -0,0 +1,36 @@
+name: Changeset Check
+
+on:
+  pull_request:
+    branches: [master, develop]
+
+jobs:
+  changeset:
+    name: Require changeset
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Check for changeset
+        run: |
+          echo "Checking for changeset files in this PR..."
+          echo "If this fails, run 'pnpm changeset' to add a changeset describing your changes."
+          echo "For changes that don't need a changelog entry (docs, CI, refactoring), use 'pnpm changeset --empty'."
+          pnpm changeset status --since=origin/${{ github.base_ref }}

.github/workflows/node.js.yml

@@ -16,13 +16,30 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "20"
 
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        run: echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_OUTPUT
+
+      - name: Cache pnpm store
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
       - name: Install dependencies
-        run: npm install -g pnpm && pnpm i
+        run: pnpm install --frozen-lockfile
 
       - name: Linting
         run: pnpm lint

.github/workflows/publish.yml

@@ -21,6 +21,17 @@ jobs:
       - name: Install dependencies
         run: npm install -g pnpm && pnpm i 
 
+      - name: Verify changesets are consumed
+        if: startsWith(github.ref, 'refs/tags/')
+        run: |
+          pnpm changeset version
+          if ! git diff --quiet; then
+            echo "Error: 'pnpm changeset version' produced uncommitted changes on a tag build."
+            echo "Please run 'pnpm changeset version' locally, commit the resulting changes, and re-create the tag."
+            git diff
+            exit 1
+          fi
+
       - name: Build
         run: pnpm build
 

.github/workflows/test.yml

@@ -50,8 +50,8 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Run tests
-        run: pnpm test
+      - name: Run tests with coverage threshold
+        run: pnpm test:ci
 
       - name: Build project
         run: pnpm build

.husky/pre-commit

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+pnpm lint-staged
+pnpm typecheck

CHANGELOG.md

@@ -0,0 +1,6 @@
+# @offckb/cli
+
+## Changelog
+
+All notable changes to this project will be documented in this file.
+This file is automatically updated by [changesets](https://github.com/changesets/changesets).

README.md

@@ -276,8 +276,38 @@ offckb system-scripts --output <output-file-path>
 
 By default, OffCKB use a fixed Devnet config. You can customize it, for example by modifying the default log level (`warn,ckb-script=debug`).
 
-1. Locate your Devnet config folder:
-
+1. Open the interactive Devnet config editor:
+
+```sh
+offckb devnet config
+```
+
+The editor uses a three-column layout: first-column file switcher (`ckb.toml` / `ckb-miner.toml`), a middle primary editing pane, and a smaller right read-only reference pane that shows the full built-in template for the currently selected file.
+
+The left editing pane supports full key browsing/editing, including primitive value edits, object key add, array append/insert/move, search filter, and path delete.
+
+Common shortcuts: `Enter` edit primitive, `a` add key/item, `i` insert array item, `m` move array item, `d` delete path, `/` search filter, `n`/`N` next/previous search match, `c` add custom value in fixed-array dialog (when allowed), `s` save, `q` quit.
+
+Note: saving rewrites `ckb.toml` / `ckb-miner.toml` into canonical TOML format; upstream comments and original formatting are not preserved after save.
+
+You can also update the same fields non-interactively (useful for scripts/CI):
+
+```sh
+offckb devnet config --set ckb.logger.filter=info
+offckb devnet config --set ckb.rpc.enable_deprecated_rpc=true --set miner.client.poll_interval=1500
+```
+
+If your terminal is non-interactive (no TTY, e.g. CI/remote pipeline), use `--set` mode directly instead of the full-screen editor.
+
+1. Save changes and restart devnet:
+
+```sh
+offckb clean -d
+offckb node
+```
+
+1. (Advanced) Locate your Devnet config folder for manual edits:
+
 ```sh
 offckb config list
 ```
@@ -293,12 +323,12 @@ Example result:
   }
 }
 ```
+
 Pay attention to the `devnet.configPath` and `devnet.dataPath`.
-
-2. `cd` into the `devnet.configPath` . Modify the config files as needed. See [Custom Devnet Setup](https://docs.nervos.org/docs/node/run-devnet-node#custom-devnet-setup) and [Configure CKB](https://github.com/nervosnetwork/ckb/blob/develop/docs/configure.md) for details.
-3. After modifications, run `offckb clean -d` to remove the chain data if needed while keeping the updated config files.
-4. Restart local blockchain by running `offckb node`
 
+1. `cd` into the `devnet.configPath` . Modify the config files as needed. See [Custom Devnet Setup](https://docs.nervos.org/docs/node/run-devnet-node#custom-devnet-setup) and [Configure CKB](https://github.com/nervosnetwork/ckb/blob/develop/docs/configure.md) for details.
+2. After modifications, run `offckb clean -d` to remove the chain data if needed while keeping the updated config files.
+3. Restart local blockchain by running `offckb node`
 
 ## Config Setting