@parall/agent-core 1.34.0 → 1.35.0

package/dist/gateway-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-base.d.ts","sourceRoot":"","sources":["../src/gateway-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gateway-base.d.ts","sourceRoot":"","sources":["../src/gateway-base.ts"],"names":[],"mappings":"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"}

package/dist/gateway-base.js

@@ -1037,6 +1037,13 @@ export class ParallAgentGateway {
             this.dispatchState.mainCurrentTargetId = undefined;
             this.dispatchState.mainPreDispatchBranchPoint = undefined;
             if (!this.shuttingDown && this.dispatchState.mainBuffer.length > 0) {
+                // Opportunistic re-drain — best-effort, not a recovery deadline, so it
+                // must not be the sole handle keeping the event loop alive. In a live
+                // bridge the WS connection holds the loop open and this still fires;
+                // when nothing else is pending there is no runtime to drain to anyway,
+                // and an un-ref'd timer lets the process (or a test run) exit instead
+                // of idling out the 5s. The abort deadlines deliberately stay ref'd —
+                // firing as the sole handle IS their recovery job.
                 setTimeout(() => {
                     if (!this.draining &&
                         !this.dispatchState.mainDispatching &&
@@ -1044,7 +1051,7 @@ export class ParallAgentGateway {
                         this.dispatchState.mainDispatching = true;
                         void this.drainMainBuffer();
                     }
-                }, 5000);
+                }, 5000).unref();
             }
         }
     }

package/dist/skills/parall-wiki.d.ts

@@ -1,2 +1,2 @@
-export declare const PARALL_WIKI_SKILL = "# Parall Wiki\n\nManage organization wikis via the Parall CLI. Auth is pre-configured.\n\n## Browsing (no local state needed)\n\n```bash\nparall wiki list                       # List all wikis\nparall wiki tree <slug>                 # List files and directories\nparall wiki tree <slug> --path docs/    # List a subdirectory\n```\n\n## Editing\n\nWiki editing works on a **local workspace** \u2014 a directory on disk where wiki\nfiles are synced. You sync from the server, edit files locally, then propose\na changeset.\n\n### Step 1: Sync\n\n```bash\nparall wiki sync <slug>\n```\n\nThis downloads wiki files to a local directory. The output includes the\n**absolute mount path** for each wiki (e.g. `synced \u2192 /path/to/workspace/kb`).\n\n### Step 2: Find the mount path\n\nThe sync output JSON contains `synced[].path` \u2014 the absolute path where files\nlive. You can also check it anytime with:\n\n```bash\nparall wiki status <slug>\n```\n\nThe output includes `Mount: /absolute/path/to/<slug>`.\n\nUse this path with `read`, `write`, and `edit` tools. For example, if the mount\nis `/data/.openclaw/workspace/kb`, then `README.md` is at\n`/data/.openclaw/workspace/kb/README.md`.\n\n### Step 3: Edit files\n\nUse standard file tools (`read`, `write`, `edit`) on files under the mount path.\n\n### Step 4: Review changes\n\n```bash\nparall wiki diff <slug>       # Shows unified diff of all local changes\nparall wiki status <slug>     # Shows which files changed with +/- line counts\n```\n\nAlways review before proposing.\n\n### Step 5: Propose changeset\n\n```bash\nparall wiki changeset create <slug> --title \"Description of changes\"\n```\n\nThis uploads your local changes. Unprotected paths auto-merge immediately; the\nCLI prints `auto_merged: true` and refreshes the local manifest. Protected\npaths remain as a changeset for review; follow the returned `next_action`.\n\n## Changeset Management\n\n```bash\nparall wiki changeset list <slug>               # List all changesets\nparall wiki changeset show <changesetId> <slug> # Show detail + feedback\nparall wiki changeset diff <changesetId> <slug> # Show changeset diff\n```\n\nIf a changeset is rejected, fix the files locally and re-propose:\n\n```bash\nparall wiki changeset create <slug> --update <changesetId>\n```\n\nThe title is inherited from the original changeset \u2014 no need to repeat it.\n\n## Handling sync conflicts\n\n`wiki sync` runs a three-way merge. When both you and the server changed the\nsame file, sync **does not overwrite your work**. It leaves your file intact\nand drops the upstream version under `.parall-wiki/conflicts/`:\n\n| Marker | Meaning |\n|--------|---------|\n| `.parall-wiki/conflicts/<path>.remote` | Server has different content (concurrent edit, new file collision, or server changed a file you deleted) |\n| `.parall-wiki/conflicts/<path>.remote-deleted` | Server deleted the file; you still have edits |\n\nstderr prints one line per conflict. Recovery:\n\n**Accept upstream** (drop your edit):\n```bash\ncp .parall-wiki/conflicts/<path>.remote <path>\nparall wiki sync\n```\n\n**Keep yours** (or hand-merge, then propose):\n```bash\n# edit <path> to final content\nparall wiki diff <slug>\nparall wiki changeset create <slug> --title \"Reconcile <path>\"\nparall wiki sync   # fast-forwards after server merges\n```\n\n**Accept server delete** (`.remote-deleted` only):\n```bash\nrm <path>\nparall wiki sync\n```\n\nSync failures (`download`, `shape-conflict`) set exit code 1 and retry on\nnext sync. Conflicts exit 0 \u2014 they need your decision, not a retry.\n\n## Discarding local changes\n\n```bash\nparall wiki reset <slug>      # Restore all files to last synced state\n```\n\n## History\n\n```bash\nparall wiki log <slug>        # Recent wiki operations\n```\n\nCLI success output is JSON; errors may add a plain-text `Request approval:` line on a `PERMISSION_DENIED` \u2014 read both. Run `parall wiki --help` for full options.\n";
+export declare const PARALL_WIKI_SKILL = "# Parall Wiki\n\nManage organization wikis via the Parall CLI. Auth is pre-configured.\n\n## Mental model\n\nWiki editing works on a **local workspace**: `parall wiki sync` downloads the\nwiki into a directory on disk, you edit those files with your normal file\ntools, then `parall wiki changeset create` uploads the result as a proposal.\nThere is no git in the workspace \u2014 your edits are detected by diffing against\nthe synced baseline.\n\nKey facts the commands won't tell you:\n\n- **Workspace location is fixed.** Sync output and `parall wiki status` print\n  the absolute workspace path (`synced \u2192 /path/to/<slug>` / `Mount: ...`).\n  Always address wiki files by that absolute path \u2014 your shell cwd is usually\n  NOT inside the workspace.\n- **Text files only.** Changesets reject binary content. Don't put images or\n  archives in the workspace; binary uploads go through the web UI.\n- **`cat`, `search`, `query`, `outline`, and `section` read your local\n  workspace copy when it exists** \u2014 including your own unproposed edits. Add\n  `--remote` to `cat` to read the server version instead.\n- **`search`/`query` are keyword (lexical) matching**, not semantic search.\n  `query` additionally ranks whole documents \u2014 better for multi-word\n  questions; `search` for a single identifier.\n- The `<wiki>` argument is the slug or ID from `parall wiki list`; with a\n  single wiki in the org it can be omitted.\n\n## Core workflow\n\n```bash\nparall wiki sync                                  # 1. get/update files (prints workspace path)\n# 2. read + edit files under the workspace path with standard file tools\nparall wiki diff <wiki>                            # 3. review exactly what you'll propose\nparall wiki changeset create <wiki> --title \"...\"  # 4. submit\n```\n\nAlways sync before starting and always check `diff` before proposing \u2014 the\nchangeset uploads the full content of every changed file.\n\nUnprotected paths auto-merge immediately (`auto_merged: true`); protected\npaths stay open for human review. Follow the returned `next_action` either way.\n\n## Stale base (server moved since your sync)\n\nIf files changed on the server after your last sync, `changeset create` is\nrejected \u2014 both by a CLI precheck and by the server (409 `STALE_BASE`) \u2014 so\nyou can't silently overwrite someone's concurrent edit. Recovery:\n\n```bash\nparall wiki sync          # pull latest; your local edits are preserved\n# if a file conflicts, resolve it (see next section)\nparall wiki changeset create <wiki> --title \"...\"\n```\n\n## Sync conflicts\n\n`sync` three-way merges. When both you and the server changed the same file,\nyour file is left intact and the upstream copy lands under\n`<workspace>/.parall-wiki/conflicts/`:\n\n| Marker | Meaning |\n|--------|---------|\n| `conflicts/<path>.remote` | Server has different content for `<path>` |\n| `conflicts/<path>.remote-deleted` | Server deleted `<path>`; you still have edits |\n\nAll paths below are relative to the workspace root. Pick one:\n\n```bash\n# Accept upstream (drop your edit):\ncp <workspace>/.parall-wiki/conflicts/<path>.remote <workspace>/<path>\n\n# Keep yours / hand-merge: edit <workspace>/<path> to final content, then\nparall wiki changeset create <wiki> --title \"Reconcile <path>\"\n\n# Accept server delete (.remote-deleted only):\nrm <workspace>/<path>\n```\n\nThen re-run `parall wiki sync` and delete the used marker file. Conflicts\nexit 0 (they need your decision); `failed[]` entries (download error,\nshape-conflict) exit 1 and retry on the next sync.\n\n## Changesets\n\n```bash\nparall wiki changeset list <wiki>\nparall wiki changeset show <changesetId> <wiki>     # status + feedback\nparall wiki changeset diff <changesetId> <wiki>\nparall wiki changeset create <wiki> --update <id>   # re-propose after rejection (title inherited)\n```\n\nRejected: read the feedback (`show` / `status`), fix the files, re-propose\nwith `--update <id>`. Conflict status: `sync`, resolve, then `--update <id>`.\n\nRe-propose REPLACES the changeset's previous contents with your current\nworkspace diff \u2014 to withdraw a file from the proposal, revert it locally\n(restore the synced content) and re-propose; it drops out of the changeset.\n\n## Discovery & history\n\n```bash\nparall wiki query \"how is auth configured\" <wiki>   # multi-word lookup (query FIRST, wiki second)\nparall wiki search \"JWT\" <wiki>                     # single keyword (query FIRST, wiki second)\nparall wiki outline <wiki> --path docs/             # heading structure\nparall wiki cat docs/auth.md <wiki>                 # print a file (--remote for server version)\nparall wiki tree <wiki>                             # list files\nparall wiki log <wiki>                              # recent operations\nparall wiki log <wiki> docs/auth.md                 # per-file commit history\n```\n\n## Permissions\n\nReads and writes are ACL-checked server-side per path. `parall wiki access\n<path>` shows your level for a path. On a `PERMISSION_DENIED`, errors include\na `Request approval:` hint \u2014 use `parall wiki request-access <path> --reason\n\"...\"` to file an approval card for a maintainer, then re-sync after approval.\n\n## Recovery\n\n```bash\nparall wiki reset <wiki>    # discard ALL local edits, restore last-synced state\nparall wiki status <wiki>   # local changes + your changesets, anytime\n```\n\nCLI success output is JSON on stdout (human summary on stderr); errors state\nthe reason and the next step \u2014 follow them. `parall wiki --help` for the\nfull command list.\n";
 //# sourceMappingURL=parall-wiki.d.ts.map

package/dist/skills/parall-wiki.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parall-wiki.d.ts","sourceRoot":"","sources":["../../src/skills/parall-wiki.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,o4HAkI7B,CAAC"}
+{"version":3,"file":"parall-wiki.d.ts","sourceRoot":"","sources":["../../src/skills/parall-wiki.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,m/KAiI7B,CAAC"}

package/dist/skills/parall-wiki.js

@@ -2,130 +2,129 @@ export const PARALL_WIKI_SKILL = `# Parall Wiki
 
 Manage organization wikis via the Parall CLI. Auth is pre-configured.
 
-## Browsing (no local state needed)
+## Mental model
+
+Wiki editing works on a **local workspace**: \`parall wiki sync\` downloads the
+wiki into a directory on disk, you edit those files with your normal file
+tools, then \`parall wiki changeset create\` uploads the result as a proposal.
+There is no git in the workspace — your edits are detected by diffing against
+the synced baseline.
+
+Key facts the commands won't tell you:
+
+- **Workspace location is fixed.** Sync output and \`parall wiki status\` print
+  the absolute workspace path (\`synced → /path/to/<slug>\` / \`Mount: ...\`).
+  Always address wiki files by that absolute path — your shell cwd is usually
+  NOT inside the workspace.
+- **Text files only.** Changesets reject binary content. Don't put images or
+  archives in the workspace; binary uploads go through the web UI.
+- **\`cat\`, \`search\`, \`query\`, \`outline\`, and \`section\` read your local
+  workspace copy when it exists** — including your own unproposed edits. Add
+  \`--remote\` to \`cat\` to read the server version instead.
+- **\`search\`/\`query\` are keyword (lexical) matching**, not semantic search.
+  \`query\` additionally ranks whole documents — better for multi-word
+  questions; \`search\` for a single identifier.
+- The \`<wiki>\` argument is the slug or ID from \`parall wiki list\`; with a
+  single wiki in the org it can be omitted.
+
+## Core workflow
 
 \`\`\`bash
-parall wiki list                       # List all wikis
-parall wiki tree <slug>                 # List files and directories
-parall wiki tree <slug> --path docs/    # List a subdirectory
+parall wiki sync                                  # 1. get/update files (prints workspace path)
+# 2. read + edit files under the workspace path with standard file tools
+parall wiki diff <wiki>                            # 3. review exactly what you'll propose
+parall wiki changeset create <wiki> --title "..."  # 4. submit
 \`\`\`
 
-## Editing
+Always sync before starting and always check \`diff\` before proposing — the
+changeset uploads the full content of every changed file.
 
-Wiki editing works on a **local workspace** — a directory on disk where wiki
-files are synced. You sync from the server, edit files locally, then propose
-a changeset.
+Unprotected paths auto-merge immediately (\`auto_merged: true\`); protected
+paths stay open for human review. Follow the returned \`next_action\` either way.
 
-### Step 1: Sync
+## Stale base (server moved since your sync)
 
-\`\`\`bash
-parall wiki sync <slug>
-\`\`\`
-
-This downloads wiki files to a local directory. The output includes the
-**absolute mount path** for each wiki (e.g. \`synced → /path/to/workspace/kb\`).
-
-### Step 2: Find the mount path
-
-The sync output JSON contains \`synced[].path\` — the absolute path where files
-live. You can also check it anytime with:
+If files changed on the server after your last sync, \`changeset create\` is
+rejected — both by a CLI precheck and by the server (409 \`STALE_BASE\`) — so
+you can't silently overwrite someone's concurrent edit. Recovery:
 
 \`\`\`bash
-parall wiki status <slug>
+parall wiki sync          # pull latest; your local edits are preserved
+# if a file conflicts, resolve it (see next section)
+parall wiki changeset create <wiki> --title "..."
 \`\`\`
 
-The output includes \`Mount: /absolute/path/to/<slug>\`.
-
-Use this path with \`read\`, \`write\`, and \`edit\` tools. For example, if the mount
-is \`/data/.openclaw/workspace/kb\`, then \`README.md\` is at
-\`/data/.openclaw/workspace/kb/README.md\`.
+## Sync conflicts
 
-### Step 3: Edit files
+\`sync\` three-way merges. When both you and the server changed the same file,
+your file is left intact and the upstream copy lands under
+\`<workspace>/.parall-wiki/conflicts/\`:
 
-Use standard file tools (\`read\`, \`write\`, \`edit\`) on files under the mount path.
+| Marker | Meaning |
+|--------|---------|
+| \`conflicts/<path>.remote\` | Server has different content for \`<path>\` |
+| \`conflicts/<path>.remote-deleted\` | Server deleted \`<path>\`; you still have edits |
 
-### Step 4: Review changes
+All paths below are relative to the workspace root. Pick one:
 
 \`\`\`bash
-parall wiki diff <slug>       # Shows unified diff of all local changes
-parall wiki status <slug>     # Shows which files changed with +/- line counts
-\`\`\`
+# Accept upstream (drop your edit):
+cp <workspace>/.parall-wiki/conflicts/<path>.remote <workspace>/<path>
 
-Always review before proposing.
+# Keep yours / hand-merge: edit <workspace>/<path> to final content, then
+parall wiki changeset create <wiki> --title "Reconcile <path>"
 
-### Step 5: Propose changeset
-
-\`\`\`bash
-parall wiki changeset create <slug> --title "Description of changes"
+# Accept server delete (.remote-deleted only):
+rm <workspace>/<path>
 \`\`\`
 
-This uploads your local changes. Unprotected paths auto-merge immediately; the
-CLI prints \`auto_merged: true\` and refreshes the local manifest. Protected
-paths remain as a changeset for review; follow the returned \`next_action\`.
-
-## Changeset Management
-
-\`\`\`bash
-parall wiki changeset list <slug>               # List all changesets
-parall wiki changeset show <changesetId> <slug> # Show detail + feedback
-parall wiki changeset diff <changesetId> <slug> # Show changeset diff
-\`\`\`
+Then re-run \`parall wiki sync\` and delete the used marker file. Conflicts
+exit 0 (they need your decision); \`failed[]\` entries (download error,
+shape-conflict) exit 1 and retry on the next sync.
 
-If a changeset is rejected, fix the files locally and re-propose:
+## Changesets
 
 \`\`\`bash
-parall wiki changeset create <slug> --update <changesetId>
+parall wiki changeset list <wiki>
+parall wiki changeset show <changesetId> <wiki>     # status + feedback
+parall wiki changeset diff <changesetId> <wiki>
+parall wiki changeset create <wiki> --update <id>   # re-propose after rejection (title inherited)
 \`\`\`
 
-The title is inherited from the original changeset — no need to repeat it.
-
-## Handling sync conflicts
-
-\`wiki sync\` runs a three-way merge. When both you and the server changed the
-same file, sync **does not overwrite your work**. It leaves your file intact
-and drops the upstream version under \`.parall-wiki/conflicts/\`:
-
-| Marker | Meaning |
-|--------|---------|
-| \`.parall-wiki/conflicts/<path>.remote\` | Server has different content (concurrent edit, new file collision, or server changed a file you deleted) |
-| \`.parall-wiki/conflicts/<path>.remote-deleted\` | Server deleted the file; you still have edits |
-
-stderr prints one line per conflict. Recovery:
+Rejected: read the feedback (\`show\` / \`status\`), fix the files, re-propose
+with \`--update <id>\`. Conflict status: \`sync\`, resolve, then \`--update <id>\`.
 
-**Accept upstream** (drop your edit):
-\`\`\`bash
-cp .parall-wiki/conflicts/<path>.remote <path>
-parall wiki sync
-\`\`\`
+Re-propose REPLACES the changeset's previous contents with your current
+workspace diff — to withdraw a file from the proposal, revert it locally
+(restore the synced content) and re-propose; it drops out of the changeset.
 
-**Keep yours** (or hand-merge, then propose):
-\`\`\`bash
-# edit <path> to final content
-parall wiki diff <slug>
-parall wiki changeset create <slug> --title "Reconcile <path>"
-parall wiki sync   # fast-forwards after server merges
-\`\`\`
+## Discovery & history
 
-**Accept server delete** (\`.remote-deleted\` only):
 \`\`\`bash
-rm <path>
-parall wiki sync
+parall wiki query "how is auth configured" <wiki>   # multi-word lookup (query FIRST, wiki second)
+parall wiki search "JWT" <wiki>                     # single keyword (query FIRST, wiki second)
+parall wiki outline <wiki> --path docs/             # heading structure
+parall wiki cat docs/auth.md <wiki>                 # print a file (--remote for server version)
+parall wiki tree <wiki>                             # list files
+parall wiki log <wiki>                              # recent operations
+parall wiki log <wiki> docs/auth.md                 # per-file commit history
 \`\`\`
 
-Sync failures (\`download\`, \`shape-conflict\`) set exit code 1 and retry on
-next sync. Conflicts exit 0 — they need your decision, not a retry.
+## Permissions
 
-## Discarding local changes
-
-\`\`\`bash
-parall wiki reset <slug>      # Restore all files to last synced state
-\`\`\`
+Reads and writes are ACL-checked server-side per path. \`parall wiki access
+<path>\` shows your level for a path. On a \`PERMISSION_DENIED\`, errors include
+a \`Request approval:\` hint — use \`parall wiki request-access <path> --reason
+"..."\` to file an approval card for a maintainer, then re-sync after approval.
 
-## History
+## Recovery
 
 \`\`\`bash
-parall wiki log <slug>        # Recent wiki operations
+parall wiki reset <wiki>    # discard ALL local edits, restore last-synced state
+parall wiki status <wiki>   # local changes + your changesets, anytime
 \`\`\`
 
-CLI success output is JSON; errors may add a plain-text \`Request approval:\` line on a \`PERMISSION_DENIED\` — read both. Run \`parall wiki --help\` for full options.
+CLI success output is JSON on stdout (human summary on stderr); errors state
+the reason and the next step — follow them. \`parall wiki --help\` for the
+full command list.
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/agent-core",
-  "version": "1.34.0",
+  "version": "1.35.0",
   "description": "Shared agent runtime orchestration helpers for Parall",
   "license": "MIT",
   "repository": {
@@ -35,7 +35,7 @@
     "@opentelemetry/sdk-logs": "^0.57.0",
     "@opentelemetry/sdk-metrics": "^1.30.0",
     "@opentelemetry/sdk-trace-node": "^1.30.0",
-    "@parall/sdk": "1.34.0"
+    "@parall/sdk": "1.35.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/gateway-base.ts

@@ -1342,6 +1342,13 @@ export class ParallAgentGateway {
       this.dispatchState.mainCurrentTargetId = undefined;
       this.dispatchState.mainPreDispatchBranchPoint = undefined;
       if (!this.shuttingDown && this.dispatchState.mainBuffer.length > 0) {
+        // Opportunistic re-drain — best-effort, not a recovery deadline, so it
+        // must not be the sole handle keeping the event loop alive. In a live
+        // bridge the WS connection holds the loop open and this still fires;
+        // when nothing else is pending there is no runtime to drain to anyway,
+        // and an un-ref'd timer lets the process (or a test run) exit instead
+        // of idling out the 5s. The abort deadlines deliberately stay ref'd —
+        // firing as the sole handle IS their recovery job.
         setTimeout(() => {
           if (
             !this.draining &&
@@ -1351,7 +1358,7 @@ export class ParallAgentGateway {
             this.dispatchState.mainDispatching = true;
             void this.drainMainBuffer();
           }
-        }, 5000);
+        }, 5000).unref();
       }
     }
   }

package/src/skills/parall-wiki.ts

@@ -2,130 +2,129 @@ export const PARALL_WIKI_SKILL = `# Parall Wiki
 
 Manage organization wikis via the Parall CLI. Auth is pre-configured.
 
-## Browsing (no local state needed)
+## Mental model
+
+Wiki editing works on a **local workspace**: \`parall wiki sync\` downloads the
+wiki into a directory on disk, you edit those files with your normal file
+tools, then \`parall wiki changeset create\` uploads the result as a proposal.
+There is no git in the workspace — your edits are detected by diffing against
+the synced baseline.
+
+Key facts the commands won't tell you:
+
+- **Workspace location is fixed.** Sync output and \`parall wiki status\` print
+  the absolute workspace path (\`synced → /path/to/<slug>\` / \`Mount: ...\`).
+  Always address wiki files by that absolute path — your shell cwd is usually
+  NOT inside the workspace.
+- **Text files only.** Changesets reject binary content. Don't put images or
+  archives in the workspace; binary uploads go through the web UI.
+- **\`cat\`, \`search\`, \`query\`, \`outline\`, and \`section\` read your local
+  workspace copy when it exists** — including your own unproposed edits. Add
+  \`--remote\` to \`cat\` to read the server version instead.
+- **\`search\`/\`query\` are keyword (lexical) matching**, not semantic search.
+  \`query\` additionally ranks whole documents — better for multi-word
+  questions; \`search\` for a single identifier.
+- The \`<wiki>\` argument is the slug or ID from \`parall wiki list\`; with a
+  single wiki in the org it can be omitted.
+
+## Core workflow
 
 \`\`\`bash
-parall wiki list                       # List all wikis
-parall wiki tree <slug>                 # List files and directories
-parall wiki tree <slug> --path docs/    # List a subdirectory
+parall wiki sync                                  # 1. get/update files (prints workspace path)
+# 2. read + edit files under the workspace path with standard file tools
+parall wiki diff <wiki>                            # 3. review exactly what you'll propose
+parall wiki changeset create <wiki> --title "..."  # 4. submit
 \`\`\`
 
-## Editing
+Always sync before starting and always check \`diff\` before proposing — the
+changeset uploads the full content of every changed file.
 
-Wiki editing works on a **local workspace** — a directory on disk where wiki
-files are synced. You sync from the server, edit files locally, then propose
-a changeset.
+Unprotected paths auto-merge immediately (\`auto_merged: true\`); protected
+paths stay open for human review. Follow the returned \`next_action\` either way.
 
-### Step 1: Sync
+## Stale base (server moved since your sync)
 
-\`\`\`bash
-parall wiki sync <slug>
-\`\`\`
-
-This downloads wiki files to a local directory. The output includes the
-**absolute mount path** for each wiki (e.g. \`synced → /path/to/workspace/kb\`).
-
-### Step 2: Find the mount path
-
-The sync output JSON contains \`synced[].path\` — the absolute path where files
-live. You can also check it anytime with:
+If files changed on the server after your last sync, \`changeset create\` is
+rejected — both by a CLI precheck and by the server (409 \`STALE_BASE\`) — so
+you can't silently overwrite someone's concurrent edit. Recovery:
 
 \`\`\`bash
-parall wiki status <slug>
+parall wiki sync          # pull latest; your local edits are preserved
+# if a file conflicts, resolve it (see next section)
+parall wiki changeset create <wiki> --title "..."
 \`\`\`
 
-The output includes \`Mount: /absolute/path/to/<slug>\`.
-
-Use this path with \`read\`, \`write\`, and \`edit\` tools. For example, if the mount
-is \`/data/.openclaw/workspace/kb\`, then \`README.md\` is at
-\`/data/.openclaw/workspace/kb/README.md\`.
+## Sync conflicts
 
-### Step 3: Edit files
+\`sync\` three-way merges. When both you and the server changed the same file,
+your file is left intact and the upstream copy lands under
+\`<workspace>/.parall-wiki/conflicts/\`:
 
-Use standard file tools (\`read\`, \`write\`, \`edit\`) on files under the mount path.
+| Marker | Meaning |
+|--------|---------|
+| \`conflicts/<path>.remote\` | Server has different content for \`<path>\` |
+| \`conflicts/<path>.remote-deleted\` | Server deleted \`<path>\`; you still have edits |
 
-### Step 4: Review changes
+All paths below are relative to the workspace root. Pick one:
 
 \`\`\`bash
-parall wiki diff <slug>       # Shows unified diff of all local changes
-parall wiki status <slug>     # Shows which files changed with +/- line counts
-\`\`\`
+# Accept upstream (drop your edit):
+cp <workspace>/.parall-wiki/conflicts/<path>.remote <workspace>/<path>
 
-Always review before proposing.
+# Keep yours / hand-merge: edit <workspace>/<path> to final content, then
+parall wiki changeset create <wiki> --title "Reconcile <path>"
 
-### Step 5: Propose changeset
-
-\`\`\`bash
-parall wiki changeset create <slug> --title "Description of changes"
+# Accept server delete (.remote-deleted only):
+rm <workspace>/<path>
 \`\`\`
 
-This uploads your local changes. Unprotected paths auto-merge immediately; the
-CLI prints \`auto_merged: true\` and refreshes the local manifest. Protected
-paths remain as a changeset for review; follow the returned \`next_action\`.
-
-## Changeset Management
-
-\`\`\`bash
-parall wiki changeset list <slug>               # List all changesets
-parall wiki changeset show <changesetId> <slug> # Show detail + feedback
-parall wiki changeset diff <changesetId> <slug> # Show changeset diff
-\`\`\`
+Then re-run \`parall wiki sync\` and delete the used marker file. Conflicts
+exit 0 (they need your decision); \`failed[]\` entries (download error,
+shape-conflict) exit 1 and retry on the next sync.
 
-If a changeset is rejected, fix the files locally and re-propose:
+## Changesets
 
 \`\`\`bash
-parall wiki changeset create <slug> --update <changesetId>
+parall wiki changeset list <wiki>
+parall wiki changeset show <changesetId> <wiki>     # status + feedback
+parall wiki changeset diff <changesetId> <wiki>
+parall wiki changeset create <wiki> --update <id>   # re-propose after rejection (title inherited)
 \`\`\`
 
-The title is inherited from the original changeset — no need to repeat it.
-
-## Handling sync conflicts
-
-\`wiki sync\` runs a three-way merge. When both you and the server changed the
-same file, sync **does not overwrite your work**. It leaves your file intact
-and drops the upstream version under \`.parall-wiki/conflicts/\`:
-
-| Marker | Meaning |
-|--------|---------|
-| \`.parall-wiki/conflicts/<path>.remote\` | Server has different content (concurrent edit, new file collision, or server changed a file you deleted) |
-| \`.parall-wiki/conflicts/<path>.remote-deleted\` | Server deleted the file; you still have edits |
-
-stderr prints one line per conflict. Recovery:
+Rejected: read the feedback (\`show\` / \`status\`), fix the files, re-propose
+with \`--update <id>\`. Conflict status: \`sync\`, resolve, then \`--update <id>\`.
 
-**Accept upstream** (drop your edit):
-\`\`\`bash
-cp .parall-wiki/conflicts/<path>.remote <path>
-parall wiki sync
-\`\`\`
+Re-propose REPLACES the changeset's previous contents with your current
+workspace diff — to withdraw a file from the proposal, revert it locally
+(restore the synced content) and re-propose; it drops out of the changeset.
 
-**Keep yours** (or hand-merge, then propose):
-\`\`\`bash
-# edit <path> to final content
-parall wiki diff <slug>
-parall wiki changeset create <slug> --title "Reconcile <path>"
-parall wiki sync   # fast-forwards after server merges
-\`\`\`
+## Discovery & history
 
-**Accept server delete** (\`.remote-deleted\` only):
 \`\`\`bash
-rm <path>
-parall wiki sync
+parall wiki query "how is auth configured" <wiki>   # multi-word lookup (query FIRST, wiki second)
+parall wiki search "JWT" <wiki>                     # single keyword (query FIRST, wiki second)
+parall wiki outline <wiki> --path docs/             # heading structure
+parall wiki cat docs/auth.md <wiki>                 # print a file (--remote for server version)
+parall wiki tree <wiki>                             # list files
+parall wiki log <wiki>                              # recent operations
+parall wiki log <wiki> docs/auth.md                 # per-file commit history
 \`\`\`
 
-Sync failures (\`download\`, \`shape-conflict\`) set exit code 1 and retry on
-next sync. Conflicts exit 0 — they need your decision, not a retry.
+## Permissions
 
-## Discarding local changes
-
-\`\`\`bash
-parall wiki reset <slug>      # Restore all files to last synced state
-\`\`\`
+Reads and writes are ACL-checked server-side per path. \`parall wiki access
+<path>\` shows your level for a path. On a \`PERMISSION_DENIED\`, errors include
+a \`Request approval:\` hint — use \`parall wiki request-access <path> --reason
+"..."\` to file an approval card for a maintainer, then re-sync after approval.
 
-## History
+## Recovery
 
 \`\`\`bash
-parall wiki log <slug>        # Recent wiki operations
+parall wiki reset <wiki>    # discard ALL local edits, restore last-synced state
+parall wiki status <wiki>   # local changes + your changesets, anytime
 \`\`\`
 
-CLI success output is JSON; errors may add a plain-text \`Request approval:\` line on a \`PERMISSION_DENIED\` — read both. Run \`parall wiki --help\` for full options.
+CLI success output is JSON on stdout (human summary on stderr); errors state
+the reason and the next step — follow them. \`parall wiki --help\` for the
+full command list.
 `;