docs: log current CLI test-harness import blocker

.github/workflows/ci.yml

@@ -1,26 +1,96 @@
 name: CI
+
 on:
   push: {}
+  pull_request: {}
 
 jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - run: corepack enable
-      - run: npm install -g @microsoft/rush
-      - run: git clone https://github.com/arkenrealms/arken.git
-      - run: cd arken
-      - run: rush install
-      - run: rush update
-      - run: rushx build
-      - run: rushx lint
-      - run: rushx test
+      - name: Checkout cli repo
+        uses: actions/checkout@v4
+        with:
+          path: cli
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.11.1
+
+      - name: Enable corepack
+        run: corepack enable
+
+      - name: Install Rush
+        run: npm install -g @microsoft/rush
+
+      - name: Clone arken monorepo
+        run: git clone --depth=1 https://github.com/arkenrealms/arken.git arken
+
+      - name: Sync cli sources into monorepo app path
+        run: |
+          rsync -a --delete \
+            --exclude '.git' \
+            --exclude 'node_modules' \
+            --exclude '.rush' \
+            --exclude '.github' \
+            cli/ arken/cli/
+
+      - name: Install dependencies
+        run: rush install
+        working-directory: arken
+
+      - name: Build cli
+        run: rushx build
+        working-directory: arken/cli
+
+      - name: Lint cli
+        run: rushx lint
+        working-directory: arken/cli
+
+      - name: Test cli
+        run: rushx test
+        working-directory: arken/cli
+
   test_trpc_vnext:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - run: corepack enable
-      - run: npm install -g @microsoft/rush
-      - run: rush add -p @trpc/server@next
-      - run: rushx test e2e
+      - name: Checkout cli repo
+        uses: actions/checkout@v4
+        with:
+          path: cli
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.11.1
+
+      - name: Enable corepack
+        run: corepack enable
+
+      - name: Install Rush
+        run: npm install -g @microsoft/rush
+
+      - name: Clone arken monorepo
+        run: git clone --depth=1 https://github.com/arkenrealms/arken.git arken
+
+      - name: Sync cli sources into monorepo app path
+        run: |
+          rsync -a --delete \
+            --exclude '.git' \
+            --exclude 'node_modules' \
+            --exclude '.rush' \
+            --exclude '.github' \
+            cli/ arken/cli/
+
+      - name: Install dependencies
+        run: rush install
+        working-directory: arken
+
+      - name: Upgrade tRPC server (next)
+        run: rush add -p @trpc/server@next --make-consistent
+        working-directory: arken/cli
+
+      - name: Run tests with tRPC next
+        run: rushx test
+        working-directory: arken/cli

README.md

@@ -3,15 +3,18 @@
 Run `rush update`
 
 ## Local test-gate note (rotation automation)
-In this checkout, test execution is currently blocked until dependencies/workspace links are restored:
-- `rushx test` may fail if Rush cannot resolve all workspace packages.
-- `npm test` requires local `vitest` to be installed and available.
+Use Node 20 and Rush scripts in this workspace:
+- `source ~/.nvm/nvm.sh && nvm use 20`
+- `rushx test`
 
 ## Using Commands
 
 Try out:
 
 ```bash
+source ~/.nvm/nvm.sh
+nvm use 20
+
 rushx dev
 
 # OR
@@ -23,6 +26,26 @@ rushx cli config.list
 ./bin/arken config.list
 ```
 
+### Cerebro link over tRPC websocket
+
+Start `@arken/cerebro-link` first (in this workspace, prefer an auto-selected free port):
+
+```bash
+# from arken/cerebro/link
+source ~/.nvm/nvm.sh
+nvm use 20
+PORT=0 rushx dev
+```
+
+Then run CLI commands against the websocket URI printed by cerebro-link (`ws://localhost:<port>`):
+
+```bash
+CEREBRO_SERVICE_URI=ws://127.0.0.1:<port> rushx cli cerebro.info
+CEREBRO_SERVICE_URI=ws://127.0.0.1:<port> ./bin/arken cerebro.info
+```
+
+If you want to pin a port (for scripts/automation), set `PORT=<fixed-port>` and make sure that port is free first.
+
 ## Usage
 
 ### Commands
@@ -69,12 +92,20 @@ cerebro.exec Gon.ask("calculate 1+1", "you always reply with a smile")
 Gon.ask("calculate 1+1", "you always reply with a smile")
 ```
 
+For list-style flags, spaced, equals, and repeated short-alias forms are accepted:
+
+```bash
+rushx cli some.command --values a b c
+rushx cli some.command --values=a --values=b --values=c
+rushx cli some.command -v a -v b -v c
+```
+
 Run the individual module CLI:
 
 ```
-npx tsx src/modules/config/config.cli.ts list
-npx tsx src/modules/config/config.cli.ts set metaverse Arken
-npx tsx src/modules/application/application.cli.ts create ABC
-npx tsx src/modules/math/math.cli.ts add 1 1
-npx tsx src/modules/help/help.cli.ts man cerebro
+npx tsx modules/config/config.cli.ts list
+npx tsx modules/config/config.cli.ts set metaverse Arken
+npx tsx modules/application/application.cli.ts create ABC
+npx tsx modules/math/math.cli.ts add 1 1
+npx tsx modules/help/help.cli.ts man cerebro
 ```

bin/arken

@@ -1,3 +1,4 @@
-#!/usr/bin/env ts-node
+#!/usr/bin/env node
 
-require('../cli');
+require('tsx/cjs');
+require('../cli.ts');