gstack/docs
Garry Tan eb066a4373
docs: fold the Codex accuracy review of the release docs
Six findings, all verified against source before fixing:

1. 'Every send writes a receipt' overclaimed — fail-open sinks proceed with
   a stderr warning when the receipt write fails, so a fail-open send can go
   unrecorded (lib/egress-receipt.ts:8-14). Descriptive prose now says so;
   the receipted framing keeps 'attempted'.
2. 'Receipts hash the request body' is wrong for subprocess-owned sends —
   git pushes record sha256: null (lib/egress-receipt.ts:71).
3. 'grants shows every consent in force' overclaimed — it reports the four
   standing config settings (bin/gstack-egress:139-181). Reworded in
   README, ARCHITECTURE, and the CHANGELOG entry.
4. 'Zero-exception scanner' vs reality: the new-sink scanner carries a
   reasoned SCANNER_EXEMPT list (user-directed fetches, probes, instruction
   strings, skill prose). CLAUDE.md now names it.
5. Error-catalog cause/fix for the receipt refusal: the writer mkdirs the
   ledger dir itself, so 'missing' isn't a cause and bare chmod fails when
   it is absent — cause reworded, fix is mkdir -p && chmod.
6. gbrain-sync first-run steps described the retired binary's behavior:
   default repo is gstack-artifacts-$USER, and init PRINTS the gbrain
   hookup command (never auto-executes; bin/gstack-artifacts-init:384-419).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-13 18:40:43 -07:00
..
designs docs: sweep drift that predates this release 2026-08-13 18:28:46 -07:00
evals v1.6.4.0: cut Haiku classifier FP from 44% to 23%, gate now enforced (#1135) 2026-04-23 10:23:40 -07:00
images feat: Completeness Principle — Boil the Lake (v0.6.1) (#140) 2026-03-17 16:34:08 -05:00
spikes v1.61.0.0 fix wave: guards failing open / silent failures (9 fixes, 4 community PRs absorbed) (#2472) 2026-08-08 09:28:45 -07:00
ADDING_A_HOST.md feat: declarative multi-host platform + OpenCode, Slate, Cursor, OpenClaw (v0.15.5.0) (#793) 2026-04-04 15:32:20 -07:00
ON_THE_LOC_CONTROVERSY.md feat: gstack v1 — simpler prompts + real LOC receipts (v1.0.0.0) (#1039) 2026-04-18 15:05:42 +08:00
OPENCLAW.md feat: native OpenClaw skills + ClaHub publishing (v0.15.10.0) (#832) 2026-04-05 10:07:03 -07:00
REMOTE_BROWSER_ACCESS.md docs: sync every doc surface with the v1.63 release 2026-08-13 18:28:36 -07:00
askuserquestion-cjk.md v1.56.0.0 Token-reduction Phase B + AUQ paranoid safety net (#1849) 2026-06-04 11:14:43 -07:00
askuserquestion-split.md v1.48.0.0 feat: AskUserQuestion split rule + runtime AUTO_DECIDE carve-out (#1740) 2026-05-26 23:43:07 -07:00
domain-skills.md v1.20.0.0 feat: browser-skills runtime + gbrain-support carryover (#1233) 2026-04-28 20:08:04 -07:00
explanation-diataxis-in-gstack.md v1.35.0.0 feat: add /document-generate skill + enhance /document-release with Diataxis coverage map (#1477) 2026-05-14 11:35:32 -04:00
gbrain-sync-errors.md docs: fold the Codex accuracy review of the release docs 2026-08-13 18:40:43 -07:00
gbrain-sync.md docs: fold the Codex accuracy review of the release docs 2026-08-13 18:40:43 -07:00
gbrain-write-surfaces.md v1.52.1.0 feat: brain-aware planning — 5 skills read structured gbrain context before asking (#1742) 2026-05-29 08:35:00 -07:00
howto-diagrams-and-formats.md v1.58.0.0 feat: diagram + multi-format document engine (mermaid, excalidraw, single-file HTML, DOCX) (#1990) 2026-06-12 15:38:53 -07:00
howto-document-a-shipped-feature.md v1.35.0.0 feat: add /document-generate skill + enhance /document-release with Diataxis coverage map (#1477) 2026-05-14 11:35:32 -04:00
howto-ios-testing-with-gstack.md docs(ios-qa): document regeneration and device verification flow 2026-07-14 16:35:30 -07:00
skills.md v1.62.0.0 feat: plan-mode auto-select at the review scope gate (#2533) 2026-08-12 11:12:28 -07:00
tutorial-document-generate.md v1.35.0.0 feat: add /document-generate skill + enhance /document-release with Diataxis coverage map (#1477) 2026-05-14 11:35:32 -04:00