humanish 0.57.0 → 0.58.0

package/docs/contracts/schemas.md

@@ -3,7 +3,7 @@
 Date: 2026-06-02 (current-state note updated 2026-07-14)
 
 Status: reference map for the major contracts shipped through source version
-`0.57.0`; it is not an exhaustive inventory of command/result envelopes. Exported types,
+`0.58.0`; it is not an exhaustive inventory of command/result envelopes. Exported types,
 schema constants, parsers, and validators in `src/` are authoritative. Rows
 marked "reserved" name layering intent only — no code emits or validates them
 yet. Do not emit a reserved schema.

package/docs/goals/current.md

@@ -29,7 +29,7 @@ study completed, reproduced, and produced a real accessibility finding via a
 keyboard-first participant
 ([docs/goals/email-gated-signup/receipts/](email-gated-signup/receipts/)).
 
-## Current Program Truth (source `0.57.0`)
+## Current Program Truth (source `0.58.0`)
 
 The package source and repository implementation in this tree agree on these
 points:

package/docs/ramp/README.md

@@ -2,7 +2,7 @@
 
 Status: public-safe contributor and agent ramp.
 
-Package/source version in this tree: `0.57.0` (2026-08-22). The Observer is phone-usable as a stated requirement (observer/AGENTS.md); interactive primitives start from Base UI. The Observer renderer is the observer/ workspace artifact only; the legacy string-concat renderer was deleted at cutover (#426), and rollback is a version pin to 0.42.0. The containment boundary introduced in
+Package/source version in this tree: `0.58.0` (2026-08-31). The Observer is phone-usable as a stated requirement (observer/AGENTS.md); interactive primitives start from Base UI. The Observer renderer is the observer/ workspace artifact only; the legacy string-concat renderer was deleted at cutover (#426), and rollback is a version pin to 0.42.0. The containment boundary introduced in
 `0.15.1` remains in force: managed run and output paths bind to validated
 physical filesystem identities, and stored provider IDs are evidence, not
 cleanup authority. The bundled OSS meta-lab is dry-run only until
@@ -191,6 +191,7 @@ Do not close a change on narrative alone.
 Useful proof includes:
 
 - `pnpm release:check`;
+- `pnpm release:dogfood` before a tag — see below;
 - focused unit or contract tests;
 - a generated run bundle under ignored `.humanish/`;
 - Observer screenshots or health output;
@@ -242,3 +243,30 @@ End substantial work with:
 
 Future agents should be able to continue from the repo, not from the previous
 chat transcript.
+
+
+## Before you tag: send a participant to meet the build
+
+```bash
+pnpm release:dogfood     # needs OPENAI_API_KEY + E2B_API_KEY; costs about a dollar
+```
+
+`release:check` proves the code is internally consistent. It cannot tell you whether
+someone landing on this build can get anywhere with it, and that gap is not
+theoretical: `0.56.0` passed every check and shipped a regression that hid a run's
+price at exactly the moment a person was deciding whether to set keys up. A
+synthetic participant found it hours later.
+
+So the last gate before a tag is the product's own first-contact study, pointed at
+the release candidate. It packs the tarball, uploads it into the sandbox, and has a
+real autonomous agent install THAT — not `humanish@latest`, which would measure the
+last release, the one artifact we already know about.
+
+It prints the participant's report and fails the gate if they could not get there.
+**Read the report even when it passes.** The verdict is a marker the participant
+sets; the paragraph underneath it is the finding, and it has twice repeated an
+adoption problem we already knew about in words no test could produce.
+
+This spends money and needs keys, so it is deliberately NOT part of `release:check`
+and never runs in CI. The lab's caps hold product spend to `$0`; what it costs is
+the agent's own tokens and a few sandbox-minutes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanish",
-  "version": "0.57.0",
+  "version": "0.58.0",
   "description": "Open-source-safe CLI for persona simulation, observer review, and public-safe feedback drafts.",
   "author": "Daniel G Wilson <daniel@danielgwilson.com>",
   "keywords": [
@@ -72,7 +72,8 @@
     "humanish:lab:oss:smoke": "pnpm humanish -- lab run oss-smoke",
     "tui:typecheck": "pnpm --filter humanish-tui typecheck",
     "tui:smoke": "node scripts/tui-smoke.mjs",
-    "tui:test": "pnpm --filter humanish-tui test"
+    "tui:test": "pnpm --filter humanish-tui test",
+    "release:dogfood": "node scripts/release-dogfood.mjs"
   },
   "repository": {
     "type": "git",