Skip to content

Commit abce0f6

Browse files
author
lpb-docs
committed
docs: pre-release audit — fix stale claims across site content
- README: pi fork baseline v0.84.2 -> v0.84.3; add :weekly-* image tag - lpb-cli: localpibox package path (~/.lpb-stack/devstack/localpibox/), complete CI tag list (:weekly-*, :sha-*) - lpb-devstack: docs verdicts (READY/MISSING/WRONG-VERSION/STALE), 0.0.N version placeholder - config-repo: remove deleted VERSION file from tree - fork-improvements: refresh to v0.84.3 (2 new lpb commits), drop subagents.json reference - lpb-memory-overview: generic main-session model - subagent-spawning-pattern: session-uuid install path (/opt/pi-support/)
1 parent 9c67a78 commit abce0f6

7 files changed

Lines changed: 21 additions & 16 deletions

File tree

‎README.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,8 @@ Two image flavours are published to `ghcr.io/lpb-stack/devstack`:
113113
- **`…-web`** — extends `-cli` with the VSCodium server
114114

115115
CI tags images per pipeline: `:0.0.x-lpb[-dev]-cli/web` (versioned),
116-
`:dev-cli/web`, `:main-cli/web`, `:latest-cli/web`, `:{sha}-cli/web`.
116+
`:dev-cli/web`, `:main-cli/web`, `:latest-cli/web`, `:weekly-cli/web`,
117+
`:{sha}-cli/web`.
117118

118119
> ⚠️ There is **no bare `:cli`, `:web`, or `:latest` tag** — pulling one
119120
> fails with `manifest unknown`. `lpb` always resolves a real tag for you,
@@ -198,7 +199,7 @@ merges, so the delta vs upstream can always be extracted as one patch.
198199

199200
| Repo | Upstream | LocalPibox work | Update policy |
200201
|---|---|---|---|
201-
| **pi** | `earendil-works/pi` (v0.84.2) | Qwen `reasoning_effort` + context-overflow patches | rebase onto new upstream releases |
202+
| **pi** | `earendil-works/pi` (v0.84.3) | Qwen `reasoning_effort` + context-overflow patches | rebase onto new upstream releases |
202203
| **lemonade-pi-plugin** | `lemonade-sdk/lemonade-pi-plugin` (no stable release) | Qwen thinking + vision support | follow upstream `main`, check periodically |
203204
| **pi-subagents** | `tintinweb/pi-subagents` (v0.16.1) | centralized local-first subagent model registry | follow upstream; merge + repair as needed |
204205
| **lpb-memory** | *(independent project)* | Pi memory extension (subprocess reviews) | no upstream to track |

‎doc/config-repo.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,6 @@ boot by `start.sh`.
1919
├── mcp.json → runtime MCP config (NOT git-tracked; wizard step 6 toggles servers)
2020
├── .env.example → template for bare-name env vars (EXA_API_KEY, …)
2121
├── install.sh → host install helper
22-
├── VERSION → config repo version
2322
├── skills/
2423
│ ├── agent-browser-mcp-integration/
2524
│ ├── browser-validation/

‎doc/fork-improvements.md‎

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# LocalPibox Fork Improvements
22

3-
> Last updated: 2026-08-18
3+
> Last updated: 2026-08-26
44
> Status: Qwen3.6 reasoning + vision fully operational
55
66
---
@@ -23,7 +23,7 @@ repos and their upstream origins:
2323

2424
### Upstream Baseline
2525

26-
**Based on:** `earendil-works/pi` v0.84.2 (merged into `lpb-dev` branch)
26+
**Based on:** `earendil-works/pi` v0.84.3 (merged into `lpb-dev` branch)
2727

2828
The original upstream repo is a **TypeScript monorepo** with 11 packages:
2929

@@ -42,9 +42,9 @@ The original upstream repo is a **TypeScript monorepo** with 11 packages:
4242

4343
For chat/workflows, see the companion project: [earendil-works/pi-chat](https://github.com/earendil-works/pi-chat).
4444

45-
### Fork Patches (on top of v0.84.2)
45+
### Fork Patches (original set, introduced on v0.84.1/v0.84.2)
4646

47-
The fork adds **6 lbp-specific commits** on top of the v0.84.2 merge:
47+
The fork adds **6 lbp-specific commits** on top of the upstream merge:
4848

4949
| Commit | What changed | Purpose |
5050
|---|---|---|
@@ -55,6 +55,10 @@ The fork adds **6 lbp-specific commits** on top of the v0.84.2 merge:
5555
| `8449290` | `chore`: install husky pre-commit hook, remove stale githooks wrapper | Dev tooling |
5656
| `3fc4978` | `Merge tag 'v0.84.2' into lbp-dev` | Upstream merge |
5757

58+
Since the v0.84.3 merge (`13c6d72`): **2 additional commits** —
59+
`3c307d0` (fix: cloudflare gateway type, include workers) and
60+
`6db652e` (style: numeric literal normalization in overflow.ts, biome).
61+
5862
The **critical commit** (`53c1dc2`) adds these surgical changes:
5963

6064
| File | Change | Purpose |
@@ -146,7 +150,7 @@ model source of truth:
146150
**Model resolution chain (after patch):**
147151
1. Explicit `model` param in `Agent()` call
148152
2. `model` field in agent `.md` frontmatter
149-
3. **`globalDefaultModel`** from `pi-defaults.json` / `subagents.json`
153+
3. **`globalDefaultModel`** from `pi-defaults.json`
150154
4. Parent session model (inherit)
151155

152156
**Configuration for local-first:**

‎doc/lpb-cli.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,9 @@ Installs (no sudo required) into `~/.local/bin`:
1414

1515
- `lpb` — bash wrapper
1616
- `lpb.py` — Python engine
17-
- `lpb-config`, `lpb-devstack` + the shared `localpibox` package
18-
(the setup wizard behind `lpb setup` / `lpb doctor`)
17+
- `lpb-config`, `lpb-devstack`
18+
- the shared `localpibox` package (the setup wizard behind `lpb setup` /
19+
`lpb doctor`) — installed to `~/.lpb-stack/devstack/localpibox/`
1920

2021
…and copies the stack config files (`lpb.stack.env`, `lpb.conf.env`,
2122
`VERSION`) to `~/.lpb-stack/devstack/`. Make sure `~/.local/bin` is on your
@@ -160,7 +161,7 @@ Two image flavours are published to `ghcr.io/lpb-stack/devstack`:
160161
publish them, so pulling them always fails with `manifest unknown`.
161162

162163
Tags CI publishes: `:{v}-cli/web`, `:dev-cli/web`, `:main-cli/web`,
163-
`:latest-cli/web`, `:{sha}-cli/web`.
164+
`:latest-cli/web`, `:weekly-cli/web`, `:{sha}-cli/web`.
164165

165166
### Resolution example
166167

‎doc/lpb-devstack.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,8 @@ promoting:
7878
`cd ~/.lpb-stack/docs-preview && mike serve`) commits
7979
`DOCS_READY=<stable-version>` on the `docs` branch and pushes it
8080
2. `release status` shows the docs verdict: `READY` / `MISSING` /
81-
`STALE` (stale = flag for another version, or doc content changed on dev
82-
after flagging)
81+
`WRONG-VERSION` (flag for another version) / `STALE` (doc content changed
82+
on dev after flagging)
8383
3. `release promote` **refuses** unless docs are `READY` for the version
8484
being released — `--force` overrides with a warning
8585
4. The main pipeline re-verifies the flag, then publishes the immutable
@@ -100,7 +100,7 @@ lemonade-pi-plugin):
100100
guidance — delete the local branch (`git branch -D <stable>`, only with
101101
explicit confirmation) and re-run
102102
- **devstack only**: strips the `-dev` VERSION suffix (e.g.
103-
`0.0.58-lpb-dev` → `0.0.58-lpb`) and commits it
103+
`0.0.N-lpb-dev` → `0.0.N-lpb`) and commits it
104104

105105
Flags: `--yes` (skip confirmation), `--dry-run` (plan only), `--rebase`
106106
(first-release mode), `--force` (promote even if docs are not flagged

‎doc/lpb-memory-overview.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ session model (so nothing extra to configure), or a small dedicated model
2222
## Architecture
2323

2424
```
25-
Main Session (Qwen3.6-35B)
25+
Main Session (main model)
2626
│
2727
├─ AI calls memory_search → SQLite FTS5 search
2828
│

‎support/docs/subagent-spawning-pattern.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ agent-browser --session "$SESSION_ID" close
7777

7878
| Path | Purpose |
7979
|---|---|
80-
| `session-uuid` (installed at `/opt/pi-support/bin/`) | Generate unique session IDs |
80+
| `session-uuid` (installed at `/opt/pi-support/`) | Generate unique session IDs |
8181
| `/opt/pi-support/schemas/browser-validation-schema.json` | Unified JSON schema (all fields) |
8282
| `/opt/pi-support/config/subagent-browser-prompt.txt` | System prompt template |
8383
| `/opt/pi-support/validate-subagent-output.ts` | Parent-side validation utility |

0 commit comments

Comments
 (0)