Merge 0.4.5 into master

.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": []
+}

.github/workflows/changeset-check.yml

@@ -0,0 +1,119 @@
+name: Changeset Check
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize, ready_for_review, labeled]
+    branches: [master, develop]
+
+jobs:
+  verify:
+    name: Verify Changeset
+    if: ${{ !contains(github.event.pull_request.labels.*.name, 'skip-changeset') && !contains(github.event.pull_request.labels.*.name, 'dependencies') }}
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      contents: read
+
+    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
+        id: check
+        run: |
+          if pnpm changeset status --since=origin/${{ github.base_ref }}; then
+            echo "has_changeset=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_changeset=false" >> $GITHUB_OUTPUT
+            exit 1
+          fi
+
+      - name: Comment on PR (success)
+        if: steps.check.outputs.has_changeset == 'true'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const marker = '<!-- changeset-check -->';
+            const body = marker + '\n✅ Changeset file detected.';
+
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number
+            });
+
+            const existing = comments.find(c => c.body.includes(marker));
+            if (existing) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: existing.id,
+                body
+              });
+            }
+
+      - name: Comment on PR (failure)
+        if: failure()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const marker = '<!-- changeset-check -->';
+            const body = [
+              marker,
+              '❌ **Missing Changeset**',
+              '',
+              'Please add a changeset describing your changes:',
+              '```bash',
+              'pnpm changeset',
+              '```',
+              '',
+              'If your changes do not need a version bump (docs, CI, refactoring),',
+              'add the `skip-changeset` label to this PR.',
+              '',
+              'For dependency updates, use the `dependencies` label.'
+            ].join('\n');
+
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number
+            });
+
+            const existing = comments.find(c => c.body.includes(marker));
+            if (existing) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: existing.id,
+                body
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body
+              });
+            }
+
+  skipped:
+    name: Changeset Check (Skipped)
+    if: ${{ contains(github.event.pull_request.labels.*.name, 'skip-changeset') || contains(github.event.pull_request.labels.*.name, 'dependencies') }}
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "⏭️ Changeset check skipped via label"

.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,47 @@
+# @offckb/cli
+
+## 0.4.5
+
+### Patch Changes
+
+- 37189f7: fix(devnet): only show init hint for InitializationError
+
+  The `offckb devnet config` command was showing the "run `offckb node` once to initialize devnet config files first" hint for ALL errors, including user input errors like invalid `--set` syntax or validation failures.
+
+  Now the hint is only shown for actual initialization errors (missing config path, ckb.toml, or miner.toml), making error messages clearer and less misleading.
+
+  - Added `InitializationError` class to distinguish initialization errors from user input errors
+  - Updated `createDevnetConfigEditor()` to throw `InitializationError` for missing files/paths
+  - Modified `devnetConfig()` catch block to only show hint for `InitializationError`
+  - Added type safety guard for error handling
+
+  Fixes #406
+
+- e90cfe5: fix(ckb-debugger): lazy-load WASI module to suppress ExperimentalWarning
+
+  Convert static import of node:wasi to dynamic import with caching.
+  This prevents the ExperimentalWarning from being emitted when running
+  non-debugger commands like 'offckb accounts' or 'offckb config list'.
+
+  The WASI module is now only loaded when debugger functionality is
+  actually executed.
+
+  Fixes #405
+
+- 4a88eb6: fix(install): force x86_64 architecture on Windows
+
+  CKB only provides x86_64 binaries for Windows, not aarch64.
+  When Windows ARM devices reported 'arm64' via os.arch(), the code
+  tried to download a non-existent 'aarch64-pc-windows-msvc' binary,
+  resulting in a 404 error.
+
+  This fix forces all Windows systems to use x86_64, which:
+
+  - Works correctly on Windows x64
+  - Works via emulation on Windows ARM devices
+  - Matches the only Windows binary CKB provides
+
+## 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