@dreb/coding-agent 2.38.1 → 2.40.0

package/docs/dashboard.md

@@ -74,6 +74,47 @@ agents, running commands through them, browsing the whole host filesystem
 pairing screen states this before the PIN is entered. Every file operation is
 logged server-side.
 
+## WSL2 gotcha — intermittent "access denied" / pairing screen on localhost
+
+<a id="wsl2-gotcha"></a>
+
+If you run the dashboard inside **WSL2** and reach it from a Windows browser at
+`http://127.0.0.1:5343`, you may intermittently get an **access-denied /
+pairing screen even in local mode** — typically right after the WSL VM has been
+idle, clearing once WSL is "warm" again (e.g. after you open a WSL terminal,
+which is itself slow to start because the VM is resuming).
+
+**Cause.** With WSL's `networkingMode=mirrored`, host→guest loopback traffic can
+reach the server with a source address of `10.255.255.254` — the mirrored
+host-loopback address WSL assigns to `lo` — instead of `127.0.0.1`, during the
+window after a cold boot / resume before the loopback relay settles. Local-mode
+auth only treats `127.x.x.x`/`::1` as loopback, so those requests fail the
+loopback check and are denied; the client renders that denial as the
+access-denied / pairing screen. No actual Tailscale/pairing is involved.
+
+**Why it correlates with WSL idling.** WSL tears the VM down when idle, and a
+dashboard running as a background service does **not** keep it alive: WSL's
+instance watchdog only counts processes it launches directly (interactive
+`wsl.exe` sessions or `wsl --exec`), and a `systemd`-managed service lives under
+PID 1 where the watchdog never sees it. So an always-on dashboard still lets the
+VM idle out, and the first request after resume can land in the transitional
+networking window above.
+
+**Workarounds** (host-side — no dreb changes needed):
+
+- **Keep a WSL terminal open.** Simplest and most reliable: an attached
+  interactive session is exactly the signal WSL uses to keep the VM alive, which
+  also avoids the post-resume networking window entirely.
+- **Headless keep-alive.** Run `wsl --exec dbus-launch true` (e.g. as a logon
+  Scheduled Task): it leaves a lingering background daemon that holds the VM open
+  with no terminal window. Re-run after each Windows reboot — it does not
+  persist. See [microsoft/WSL#10138](https://github.com/microsoft/WSL/issues/10138).
+  A `sleep infinity` session via Task Scheduler works too. (`vmIdleTimeout=-1`
+  in `.wslconfig` is Windows-11-only and reported unreliable for keeping the
+  *instance* — not just the VM — alive.)
+- **Access via the WSL VM's own IP** instead of localhost, if that path is
+  loopback-clean for your setup.
+
 ## Screens
 
 | Screen | What it does |

package/docs/mach6.md

@@ -105,7 +105,7 @@ Pre-merge checks, version bump, docs update, merge, tag, and release.
 ```
 
 - Verifies CI passing, no merge conflicts, all findings addressed
-- Runs pre-merge checklist (version bump, changelog, tests)
+- Runs pre-merge checklist (version bump, tests)
 - Applies version bump on the feature branch
 - Proactively reviews and updates ALL documentation affected by the PR's changes
 - Merges with `--squash --delete-branch`

package/docs/settings.md

@@ -85,7 +85,6 @@ current model supports adaptive thinking).
 |---------|------|---------|-------------|
 | `theme` | string | `"dark"` | Theme name (`"dark"`, `"light"`, or custom) |
 | `quietStartup` | boolean | `false` | Hide startup header |
-| `collapseChangelog` | boolean | `false` | Show condensed changelog after updates |
 | `doubleEscapeAction` | string | `"tree"` | Action for double-escape: `"tree"`, `"fork"`, or `"none"` |
 | `treeFilterMode` | string | `"default"` | Default filter for `/tree`: `"default"`, `"no-tools"`, `"user-only"`, `"labeled-only"`, `"all"` |
 | `editorPaddingX` | number | `0` | Horizontal padding for input editor (0-3) |

package/docs/version-history.md

@@ -0,0 +1,9 @@
+# Version History
+
+dreb does not maintain `CHANGELOG.md` files. All version history is tracked in git. Use [GitHub Releases](https://github.com/aebrer/dreb/releases) and `git log` for the canonical changelog.
+
+## Finding Changes
+
+- **Recent releases**: Browse the [Releases page](https://github.com/aebrer/dreb/releases) for release notes and associated commits
+- **Specific version**: `git log v2.38.0..v2.38.1` shows changes between versions
+- **Detailed history**: `git log --oneline` for a compact view of all changes

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dreb/coding-agent",
-	"version": "2.38.1",
+	"version": "2.40.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"drebConfig": {
@@ -38,8 +38,7 @@
 		"agents",
 		"skills",
 		"docs",
-		"examples",
-		"CHANGELOG.md"
+		"examples"
 	],
 	"scripts": {
 		"clean": "shx rm -rf dist",
@@ -47,7 +46,7 @@
 		"build": "tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js && npm run copy-assets",
 		"build:binary": "npm --prefix ../tui run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm run build && bun build --compile ./dist/bun/cli.js --outfile dist/dreb && npm run copy-binary-assets",
 		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
-		"copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx cp CHANGELOG.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
+		"copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
 		"test": "vitest --run",
 		"prepublishOnly": "npm run clean && npm run build"
 	},