Skip to content

Record what shipped across plans, specs and reference docs (steward cycle 1) - #292

Merged
BunsDev merged 7 commits into
mainfrom
docs-steward-20261018
Oct 18, 2026
Merged

BunsDev merged 7 commits into
mainfrom
docs-steward-20261018

Conversation

@BunsDev

@BunsDev BunsDev commented Oct 18, 2026 •

Copy link
Copy Markdown
Contributor

Docs and plans steward, cycle 1 (#290). Docs only. Each change cites a merged PR, a release, a review or code on main at d3711c6.

Plans and specs

Each ledger now opens with one status line saying what delivered it. Unticked boxes stay as history rather than being ticked after the fact.

Plan or spec State Evidence
plans/2026-10-08-workos-oauth delivered #141, v0.0.9 (production sign-in passed)
plans/2026-10-09-browser-extensions delivered #152, v0.0.11; Touch ID still off as planned
plans/2026-10-09-knowledge-agents, pages-agents delivered #150, v0.0.10; Pages now on the notes folder (#222)
plans/2026-10-11-desktop-roadmap delivered except Cloud tasks #164, #181/#200/#201, #173/#186; Cloud tasks out of scope
plans/2026-10-11-worktree-hygiene delivered #171
plans/2026-10-12-release-candidates delivered #186; v0.1.0 published Windows/Linux
plans/2026-10-12-sticky-auto-routing + spec delivered #180, #183, v0.0.11
plans/2026-10-15-images-plugins delivered #236, v0.1.0
mac-store-preview-plan partial #119; two open items, no open PR
specs/…-routines-spec Phases 0 (most) and 1 on main #206, #253, #257, #267; gate decision open
specs/…-approval-rules-spec parts 1–2 shipped, gate off #54, #107, #185

Reference docs and README

Statements that read as pending though they shipped:

  • README: app-owned sign-in, self-updating Macs, Windows/Linux installers, Images and Plugins.
  • approval-rules, modex-signin, browser-tools, notes, release-signing, update-recovery, native-platforms, analytics.

Statements that contradicted the code:

  • Windows and Linux show no update banner (engine/updates.ts).
  • Auto's judge sends a placeholder for assistant replies and runs jev … --attempts 1 (routing/judge.ts, routing/jev.ts).
  • Claude's model list is a fixed alias list (backends/claude.ts).
  • Settings section and transport labels.
  • Space options → Agent notes.
  • The companion's policy route and its version, 0.2.0 (7).
  • The knowledge fence covers overlapping folders (Keep agents in their project's notes wherever the knowledge base points #246).
  • CI's e2e runs the unpackaged build.
  • The Store record and processed 0.0.8 package, under gate 5.

status.md

Verification

  • A relative-link and anchor check over every Markdown file passes. Three hits are example paths inside inline code.
  • pnpm build && pnpm test ran locally on this tree at load average 74–229, with about 20 other agent sessions running. The build passed. The root suites passed (109 and 16). The desktop suite hit 20 failures, 1 in knowledge.test and then 19 in a row in runner.test, before the process exited. Run alone, both files pass (63/63 and 11/11), and the desktop .mjs suites pass (21/21). This tree differs from d3711c6 only in .md files, and unit + e2e (macOS) passed on d3711c6. CI decides.

Docs and plans steward, cycle 1 (#290).

- Plans: a status line on each ledger under docs/superpowers/plans/ and on
  docs/mac-store-preview-plan.md, naming the PRs and release that delivered it.
  Unticked boxes stay as history rather than being ticked after the fact.
- Specs: routines (Phases 0 and 1 on main), sticky Auto routing (shipped in
  v0.0.11) and approval rules (parts 1 and 2 shipped, gate off).
- README: app-owned sign-in, self-updating Macs from v0.0.12, Windows and Linux
  installers from v0.1.0, Images and Plugins no longer marked unreleased.
- status.md: the site's static fallback follows apps/site/release.json; the
  delivered release-candidates entry leaves In flight for a pointer to tracker
  #273; Next 3 points to #286.

Coven-Harness: Claude Code / claude-opus-5-5
Docs and plans steward, cycle 1 (#290). Each change was checked against the
code on main, a release section of status.md or a review.

- Shipped work no longer reads as pending: the approval rules editor (v0.0.7),
  Modex sign-in (v0.0.9), 1Password filling (v0.0.11), the notes folder
  (v0.1.0), the hosted native updater scenarios and the first
  published-to-published upgrade, and Windows/Linux publication.
- Behaviour matches the code: Windows and Linux show no update banner; Auto's
  judge sees a placeholder for assistant replies and runs `jev` with one
  attempt; Claude's model list is Modex's fixed aliases; the Settings sections
  and transport labels; Space options → Agent notes; the companion's policy
  route and current version; the knowledge fence for overlapping folders; CI's
  e2e runs the unpackaged build.
- The Store record and processed 0.0.8 package are recorded under gate 5.

Coven-Harness: Claude Code / claude-opus-5-5
@vercel

vercel Bot commented Oct 18, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
modex Ready Ready Preview Oct 18, 2026 11:54am UTC

Request Review

@BunsDev BunsDev added the documentation Improvements or additions to documentation label Oct 18, 2026
Val decided on #290: the local work recovery and retired worktrees entries
are done, so they leave In flight. The recovery audit and the archive
READMEs keep their record. Their one open item, repository authorization
through a GitHub App, becomes Next 4, ahead of the out-of-scope Cloud tasks.

Coven-Harness: Claude Code / claude-opus-5-5
Brings in #289 (CF-7, first part) before the next steward commit.

Coven-Harness: Claude Code / claude-opus-5-5
Val decided on #290: Known rough edges keeps only open problems. Six fixed
incidents move, word for word, to docs/reviews/2026-10-18-resolved-rough-edges.md,
each under the PR that fixed it (#153, #189, #190, #197, #204, #265 and #271).
The section now links to them.

Entries with an open part stay: the layout e2e note, the demo-thread and sizing
test corrections whose causes are unproven, and the poisoned ChatGPT threads.
Also: node-pty's line says Modex still ships the beta, the demo-thread note no
longer waits on a merge that happened (#189), and the tracker pointers list the
open CF PRs after #289 landed.

Coven-Harness: Claude Code / claude-opus-5-5
Val decided on #290: status.md keeps the Shipped table as the index, and each
release's details live in its review. The v0.0.6 to v0.1.0 sections (651 lines)
move unchanged to a "Status summary" section at the end of each review. Only link
targets change, so they resolve from docs/reviews/. status.md drops from 1,060 to
388 lines.

The Shipped rows now link their reviews. Four links that pointed at the old
release anchors now point at the reviews. A new convention and step 1 of the
release procedure say where a release's details go from now on.

Coven-Harness: Claude Code / claude-opus-5-5
Val decided on #290. The 52-line In flight entry becomes 15 lines: what Apple
shows, what signed acceptance covered, and what is open, each linked to its
receipt. The old entry moves unchanged to a "Status summary" section of the
October 11 signed-acceptance review, with links re-based to docs/reviews/.

The short entry drops two statements that no longer hold. The iPhone CI failures
have been diagnosed (resolved rough edges), and the Store recovery changes are
on main (edf52fc, #173).

Coven-Harness: Claude Code / claude-opus-5-5
@github-code-quality

Copy link
Copy Markdown

Code coverage overview

Languages: TypeScript

TypeScript / code-coverage-agent

main f6976df docs-steward-2026101... 8933037 +/-
63% 63% 0%

ℹ️ Calculations represent line coverage. Results may change as calculations are updated.

@BunsDev
BunsDev merged commit 04b7ec7 into main Oct 18, 2026
11 checks passed
@BunsDev
BunsDev deleted the docs-steward-20261018 branch October 18, 2026 12:18
BunsDev added a commit that referenced this pull request Oct 18, 2026
Only docs/status.md conflicted. CF-2 stays in In flight, now naming
#286 and the stacked repair #291. The duplicate Next item for #250's
lifecycle fixes is dropped, and the remaining items are renumbered.
No code changes.

Refs #275

Coven-Harness: Claude Code / claude-opus-5-5
BunsDev added a commit that referenced this pull request Oct 18, 2026
Coven-Harness: Claude Code / claude-opus-5-5
BunsDev added a commit that referenced this pull request Oct 18, 2026
Coven-Harness: Claude Code / claude-opus-5-5

This branch was successfully deployed

1 active deployment
Preview — 8933037c Deployed Oct 18, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant