humanish 0.88.0 → 0.88.1

package/dist/stats.js

@@ -170,7 +170,7 @@ export function formatStatsHuman(result) {
         `humanish stats${scope.length === 0 ? "" : ` (${scope.join(", ")})`}`,
         `runs: ${t.runs} (${t.live} live, ${t.dryRun} dry-run${t.running > 0 ? `, ${t.running} running` : ""})`,
         `estimated spend: ${money(t.estimatedSpendUsd)} over ${t.runs - t.unpricedRuns} priced run(s); ${t.unpricedRuns} unpriced (counted, not $0)`,
-        `participants: ${t.participants.reachedGoal}/${t.participants.total} reached the goal, ${t.participants.reportedFriction} reported friction`,
+        `participants: ${t.participants.reachedGoal}/${t.participants.total} recorded goal completions, ${t.participants.reportedFriction} reported friction`,
         `verdicts: ${Object.entries(t.verdicts).map(([verdict, count]) => `${verdict} ${count}`).join(", ") || "none recorded"}`
     ];
     if (result.labs.length > 0) {

package/dist/stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats.js","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"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"}

package/docs/architecture/examples/state-driven-local-app/README.md

@@ -0,0 +1,75 @@
+# Run a local app through its state contract
+
+This complete library example starts a synthetic loopback HTTP app, reads its
+state with a `CuaExecutor`, sends a greeting through its action endpoint, and
+verifies the resulting Humanish run. It uses a deterministic `CuaProvider` with
+no model calls, API keys, browser, screenshots or E2B resources. It demonstrates
+the integration; it does not test persona behavior or the quality of an app's UI.
+
+## Run from an npm installation
+
+Use Node.js 20.3 or later (`AbortSignal.any`), in a new directory:
+
+```bash
+npm init -y
+npm install humanish
+node node_modules/humanish/docs/architecture/examples/state-driven-local-app/runner.mjs
+```
+
+The package includes both [runner.mjs](runner.mjs) and [app.mjs](app.mjs).
+No checkout, TypeScript loader or initialization command is needed. Each
+invocation starts a fresh app and writes a new run under `.humanish/runs/` in
+your current directory. Run the last command again for an independent repeat.
+Add `.humanish/` to your project's `.gitignore` before adapting this example to
+real app data; running the library directly does not create that ignore rule.
+
+Expected output includes `goal_satisfied`, `sandboxCreated: false`, zero
+screenshots, a successful `verification`, and a synthetic app receipt with
+`greeted: true` and `messages: 1`. The final cleanup line shows
+`serverClosed: true`; `finally` closes the server even when the run or verification
+fails. The evidence remains on disk.
+
+Review the bundle and its sharing grade:
+
+```bash
+npx humanish verify --run latest --json
+npx humanish review --run latest --json
+```
+
+`appState` drives the loop in memory and is not persisted in the actor trace.
+This example separately prints only its own synthetic counters. A successful
+verification describes the evidence bundle, not persona efficacy or human
+task completion. The reported cost basis comes from executing only local code
+and loopback requests; absent model usage is not treated as a billing receipt.
+
+## Adapt the two ports
+
+In `runner.mjs`, replace `createAppContractExecutor` with your trusted bridge to
+your app's `getState()` and actions. Here those calls use `GET /state` and
+`POST /chat`; a browser bridge could call `window.app` through `page.evaluate`.
+Map supported actions explicitly and reject unsupported ones. Forward the
+optional execution signal and check it before dispatching an input.
+
+Replace the deterministic provider if you want a model to choose actions from
+`request.observation.appState`. Keep `requiresFrame: false` for a state-only
+provider. Your replacement owns its model credentials and costs. The
+`openai-computer-use` actor id selects the registered CUA route; the injected
+`buildProvider` chooses the actual provider, so this example never invokes OpenAI.
+
+The runner shows both required discriminant checks: `parseLabConfig` receives
+an object containing `schema: LAB_CONFIG_SCHEMA` and is narrowed on `.ok`;
+`runLab` is narrowed on `backend === "cua"` before inspecting its result.
+Supplying both `buildExecutor` and `buildProvider` selects the library-assisted
+route. It is not a config-only CLI actor or an out-of-tree actor registration API.
+
+Both JavaScript files carry JSDoc types against the public `humanish` exports.
+To check an installed copy against its packaged declarations:
+
+```bash
+npm install --save-dev typescript @types/node@20
+npx tsc --allowJs --checkJs --noEmit --strict --skipLibCheck --types node --target ES2022 --module NodeNext --moduleResolution NodeNext node_modules/humanish/docs/architecture/examples/state-driven-local-app/*.mjs
+```
+
+See the [state-driven executor guide](../../state-driven-executor.md) for progress
+projection limits, runtime-only state, unpinned local-app provenance, and the
+fail-closed guards on this route.

package/docs/architecture/examples/state-driven-local-app/app.mjs

@@ -0,0 +1,48 @@
+// @ts-check
+import { once } from "node:events";
+import { createServer } from "node:http";
+
+/** A synthetic app with a real loopback HTTP state/action contract. */
+export async function startLocalApp() {
+  let greeted = false;
+  let messages = 0;
+  let stateReads = 0;
+  const server = createServer(async (request, response) => {
+    if (request.method === "GET" && request.url === "/state") {
+      stateReads += 1;
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(JSON.stringify({ greeted, messages }));
+    } else if (request.method === "POST" && request.url === "/chat") {
+      // The demo accepts only a short synthetic message; it stores no raw text.
+      let text = "";
+      for await (const chunk of request) {
+        text += chunk.toString();
+        if (text.length > 1024) {
+          response.writeHead(413).end();
+          return;
+        }
+      }
+      messages += 1;
+      if (text.toLowerCase().includes("hello")) greeted = true;
+      response.writeHead(204).end();
+    } else {
+      response.writeHead(404).end();
+    }
+  });
+  server.listen(0, "127.0.0.1");
+  await once(server, "listening");
+  const address = server.address();
+  if (!address || typeof address === "string") throw new Error("No loopback port");
+
+  return {
+    appUrl: `http://127.0.0.1:${address.port}/`,
+    // These counters make real HTTP reads and state-changing writes inspectable.
+    getReceipt: () => ({ greeted, messages, stateReads, serverClosed: !server.listening }),
+    async close() {
+      await new Promise((resolve, reject) => {
+        server.close((error) => error ? reject(error) : resolve(undefined));
+        server.closeAllConnections();
+      });
+    }
+  };
+}

package/docs/architecture/examples/state-driven-local-app/runner.mjs

@@ -0,0 +1,104 @@
+// @ts-check
+import { LAB_CONFIG_SCHEMA, parseLabConfig, runLab, stableProgressKey, verifyRun } from "humanish";
+import { startLocalApp } from "./app.mjs";
+
+/** @param {string} appUrl @returns {import("humanish").CuaExecutor} */
+function createAppContractExecutor(appUrl) {
+  return {
+    async observe() {
+      const response = await fetch(new URL("state", appUrl), { signal: AbortSignal.timeout(5000) });
+      if (!response.ok) throw new Error(`State read failed: HTTP ${response.status}`);
+      const state = await response.json();
+      if (typeof state?.greeted !== "boolean" || !Number.isInteger(state?.messages)) {
+        throw new Error("Unexpected app state");
+      }
+      const appState = { greeted: state.greeted, messages: state.messages };
+      return { stateSignature: stableProgressKey(appState), appState };
+    },
+    async execute(action, signal) {
+      signal?.throwIfAborted();
+      if (action.kind !== "type") throw new Error(`Unsupported app action: ${action.kind}`);
+      const response = await fetch(new URL("chat", appUrl), {
+        method: "POST",
+        body: action.text,
+        signal: AbortSignal.any([AbortSignal.timeout(5000), ...(signal ? [signal] : [])])
+      });
+      if (!response.ok) throw new Error(`Chat write failed: HTTP ${response.status}`);
+    }
+  };
+}
+
+// A deterministic rule, not an AI participant: no model SDK, requests or credentials.
+/** @type {import("humanish").CuaProvider} */
+const provider = {
+  id: "local-app-deterministic-example",
+  version: "1.0.0",
+  requiresFrame: false,
+  capabilities: {
+    headless: true,
+    structuredTrace: true,
+    lanes: ["computer-use"],
+    producesScreenshots: false,
+    byoModel: true,
+    preGrantableApprovals: false,
+    inProcessTools: false,
+    license: "open"
+  },
+  async nextTurn(request, signal) {
+    signal.throwIfAborted();
+    const greeted = request.observation.appState?.greeted;
+    if (typeof greeted !== "boolean") throw new Error("Missing greeted observation");
+    return {
+      actions: greeted ? [] : [{ kind: "type", text: "hello there" }],
+      pendingSafetyChecks: [],
+      done: greeted,
+      message: greeted ? "The app accepted the greeting." : "Sending a greeting."
+    };
+  }
+};
+
+const app = await startLocalApp();
+try {
+  // parseLabConfig accepts a decoded OBJECT, not a YAML string.
+  const parsed = parseLabConfig({
+    schema: LAB_CONFIG_SCHEMA,
+    id: "state-driven-local-app-example",
+    title: "Deterministic local-app integration example",
+    subject: { source: "local-app", appUrl: app.appUrl },
+    // This registry id selects the CUA loop. buildProvider supplies the actual provider.
+    actors: [{ type: "openai-computer-use", persona: "pixel-pat", mission: "Greet the app." }],
+    scenario: { mode: "live" },
+    execution: { timeoutMs: 15_000 }
+  });
+  if (!parsed.ok) throw new Error(parsed.error.message);
+  const outcome = await runLab(parsed.config, {
+    cwd: process.cwd(),
+    dryRun: false,
+    cuaHooks: {
+      buildExecutor: async ({ appUrl }) => createAppContractExecutor(appUrl),
+      buildProvider: async () => provider
+    }
+  });
+  if (outcome.backend !== "cua") throw new Error(`Unexpected backend: ${outcome.backend}`);
+  const { result } = outcome;
+  const verified = await verifyRun(process.cwd(), result.runId);
+  console.log(JSON.stringify({
+    runId: result.runId,
+    ok: result.ok,
+    completionReason: result.session?.completionReason,
+    provider: provider.id,
+    sandboxCreated: result.sandbox !== undefined,
+    screenshots: result.session?.screenshots,
+    verification: verified,
+    app: app.getReceipt(),
+    // A mechanism statement, not an inference from missing provider usage/rates.
+    costBasis: "No model calls or hosted resources; only this process and loopback HTTP."
+  }, null, 2));
+  if (!result.ok || !verified.ok || result.session?.completionReason !== "goal_satisfied"
+    || result.sandbox !== undefined || !app.getReceipt().greeted) {
+    throw new Error(result.error?.message ?? "Local-app example did not complete and verify");
+  }
+} finally {
+  await app.close();
+  console.log(JSON.stringify({ cleanup: app.getReceipt() }));
+}

package/docs/architecture/state-driven-executor.md

@@ -52,8 +52,9 @@ wait and does not cache a previous action's position.
   `redaction.screenshots` resolves to `"n/a"`. No fabricated `Buffer.alloc(0)`
   ever reaches disk. (A vision executor still returns a frame, exactly as before.)
 - **`stateSignature` is still required.** Derive it from your own state — e.g.
-  `JSON.stringify({ route, turn, modal })`. It is the canonical fallback progress
-  key when `appState` is absent. It is never written to the trace as text.
+  `stableProgressKey({ route, turn, modal })` (exported from `humanish`). It is the
+  canonical fallback progress key when `appState` is absent. It is never written
+  to the trace as text.
 - **`appState` is the preferred progress input.** When present, the loop's
   friction / no-progress detection keys off a deterministic, sorted-key,
   depth/length-capped projection of it (`stableProgressKey`) rather than the
@@ -168,33 +169,25 @@ from your own state, pair it with a non-vision `CuaProvider`, and call
 
 ### 2. `runLab` + `buildExecutor` / `buildProvider` (keeps the composition)
 
-The supported library path. It keeps personas, the Observer, the evidence
-bundle, redaction, and the friction loop, while skipping E2B entirely:
+The supported library path keeps personas, the Observer, the evidence bundle,
+redaction, and the friction loop, while skipping E2B entirely. Start with the
+[complete runnable example](examples/state-driven-local-app/README.md), which
+ships in the npm package:
 
-```ts
-import { runLab, parseLabConfig, type CuaExecutor, type CuaProvider } from "humanish";
-
-// local-app YAML (shareable; fails closed without hooks):
-//   schema: humanish.lab.v2
-//   id: downstream-local-app-state
-//   subject: { source: local-app, appUrl: http://localhost:5173 }
-//   actors: [{ type: openai-computer-use, persona: curious-tester, mission: "…" }]
-//   scenario: { mode: live }
-const parsed = parseLabConfig(yaml);
-if (!parsed.ok) throw new Error(parsed.error.message);
-
-const outcome = await runLab(parsed.config, {
-  cwd: process.cwd(),
-  dryRun: false,
-  cuaHooks: {
-    buildExecutor: async ({ appUrl }) => createAppContractExecutor(bridge, appUrl),
-    buildProvider: async () => createStateBrain(),
-  },
-});
-// outcome.backend === "cua"; outcome.result.sandbox === undefined (NO E2B); the
-// trace's provider id is the injected brain's id.
+```bash
+npm install humanish
+node node_modules/humanish/docs/architecture/examples/state-driven-local-app/runner.mjs
 ```
 
+The example includes a real loopback app, HTTP state/action bridge, full config
+object (`schema: LAB_CONFIG_SCHEMA`), deterministic non-vision provider,
+`stableProgressKey`, `runLab`, verification, a printed report and `finally`
+cleanup. It makes no model calls and does not demonstrate persona efficacy.
+`parseLabConfig` accepts a decoded object, not a YAML string; narrow its result
+on `.ok`, then narrow `runLab`'s result on `backend === "cua"` before accessing
+the CUA result. The example defines all helpers rather than requiring a consumer
+to reconstruct them.
+
 When `cuaHooks.buildExecutor` is set, `runCuaActorLab` takes a branch that NEVER
 loads the E2B module, creates a sandbox, runs `prepareDesktop`, provisions a
 clone, opens a browser, or starts a stream. `sandboxId`/`streamUrl` stay

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.88.0`; it is not an exhaustive inventory of command/result envelopes. Exported types,
+`0.88.1`; 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.
@@ -210,7 +210,11 @@ A lab is a composition over code primitives, not a hardcoded kind:
   template actually used is recorded in the run bundle as `desktopTemplate`
   (public-safe — a template name is not a secret). Inert (warned) on every route
   that creates no desktop, incl. the in-process `local-app` cua route and the
-  meta route — never silently ignored (invariant 6);
+  meta route — never silently ignored (invariant 6). Custom images need the
+  Desktop SDK's `xdotool` input support and `xclip` or `xsel` on `PATH` for
+  clipboard recovery when direct typing fails. If both clipboard utilities are
+  absent, recovery fails with `clipboard-utility-missing`; a dry-run does not
+  inspect the image's installed tools;
 - `execution.desktop.browser` (e2b-desktop computer-use/fan-out routes, plus
   sequential and concurrent shared-world actor seats): optional browser family
   preference: `default`, `chrome`, `chromium`, or `firefox`. Absent/default
@@ -1228,6 +1232,16 @@ the stream shape, the meaningful-use rubric, and hard-failure rules.
 Review summarizes whether evidence supports the claim. It does not replace
 verification or maintainer acceptance.
 
+`verdict` is the run gate result. `participants.reachedGoal` retains the count of
+recorded successful sessions; it is not an independent adjudication of their
+claims. Computer-use review and Observer labels distinguish a participant's
+reported completion from a recorded `stopWhen` or dwell condition match. A
+condition match establishes that condition, not every aspect of the mission.
+Missing or malformed completion evidence is labeled unavailable. Other actor
+routes retain their own completion semantics. Re-reading a historical review
+refreshes these labels without rewriting the original bundle or actor trace.
+Share-safety verification does not establish task success.
+
 Core-owned fields:
 
 - `schema`

package/docs/goals/current.md

@@ -1,9 +1,9 @@
 # Current Goals
 
-Status date: 2026-09-11. Published baseline: `0.88.0`.
+Status date: 2026-09-12. Published baseline: `0.88.1`.
 
 This page guides work on current merged source. Published behavior is described
-in the [release notes](../release/0.88.0-study-diagnostics.md).
+in the [release notes](../release/0.88.1-completion-evidence-and-local-app.md).
 The [September 9 history](https://github.com/danielgwilson/humanish/blob/main/docs/goals/current-history-2026-09-09.md)
 preserves the former status log; its queues do not supersede this page.
 
@@ -88,7 +88,7 @@ requires decision-equivalent retained evidence and a real deletion branch.
 No first-party deletion branch has met that gate. Public demonstrations do not
 substitute for it.
 
-## Current Program Truth (source `0.88.0`)
+## Current Program Truth (source `0.88.1`)
 
 | Surface | Available in merged source | Remaining boundary |
 | --- | --- | --- |
@@ -98,7 +98,7 @@ substitute for it.
 | Task protocol | Hidden criteria and per-task outcomes on supported per-lane CUA paths, including local-agent and desktop-cli | Shared-world, terminal-product, scripted and synthetic routes reject `tasks` before execution |
 | Shared state | Sequential and concurrent single-origin shared-world studies with retained evidence | Multi-origin implementation remains gated; concurrent state change does not establish per-action causation |
 | Observer | Live/recorded views, participant assignments, action-specific links, saved moments, zoom, comparison and phone-width review | Sparse captures cannot prove every action's effect; visual comparison alone is not a controlled experiment |
-| Review and feedback | Verification grades, feedback drafts, portable HTML and redacted bundle derivatives | Sharing requires the appropriate grade; generated findings still need adjudication |
+| Review and feedback | Verification grades, feedback drafts, portable HTML, redacted bundle derivatives and computer-use completion-source labels | Sharing requires the appropriate grade; participant reports and condition matches still need task adjudication |
 | TUI and serving | Detached starts, run stopping, reclamation, Observer attachment, loopback serving and run library | Stopping a process does not itself prove sandbox cleanup; TUI views over CLI `stats`/`export` remain follow-ups |
 | Off-app communication | In-sandbox email/SMS catch and digest-only thread evidence | This does not establish real-provider delivery |
 | Mobile and media | Hosted viewport/emulation, desktop geometry checks, bounded dwell and declared camera feed | Physical-device and touch fidelity remain unproven; unsupported microphone declarations are rejected |
@@ -108,6 +108,11 @@ Use the [task support matrix](../architecture/task-protocol-support.md),
 and [CLI reference](https://humanish.dev/docs/cli) when choosing a concrete path.
 Source behavior and required tests outrank stale status prose.
 
+The library-assisted `local-app` route now includes a
+[runnable npm example](../architecture/examples/state-driven-local-app/README.md).
+Its deterministic provider demonstrates the integration with a real loopback
+app; it does not establish persona effectiveness or independent adoption.
+
 ## Gates And Deferred Work
 
 - Live OSS meta-lab execution remains disabled until repository-derived

package/docs/ramp/README.md

@@ -2,7 +2,7 @@
 
 Status: public-safe contributor and agent ramp.
 
-Package/source version in this tree: `0.88.0` (2026-09-11). 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.88.1` (2026-09-12). 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
@@ -47,6 +47,12 @@ If a change does not improve one of those loops, it probably belongs elsewhere.
 
 ## Current State
 
+The [0.88.1 release note](../release/0.88.1-completion-evidence-and-local-app.md)
+describes computer-use labels that distinguish participant reports from
+recorded condition matches. It also covers the complete npm local-app example
+and public `stableProgressKey` export, plus the clipboard fallback correction
+for inherited output pipes.
+
 The [0.88.0 release note](../release/0.88.0-study-diagnostics.md) describes
 computer-use CLI diagnostics, explicit local admission limits and retained
 uncertainty when an earlier provider request did not report usage.

package/docs/release/0.88.1-completion-evidence-and-local-app.md

@@ -0,0 +1,79 @@
+# Humanish 0.88.1: distinguish reported completion from condition matches
+
+When a computer-use participant says it finished, review and Observer now
+label that completion as **participant-reported**. A recorded `stopWhen` match
+or completed dwell window identifies a **recorded completion condition** instead.
+Missing, malformed or conflicting completion evidence is labeled unavailable.
+Zero-completion counts use **0/N recorded completions**, and aggregate stats use
+**recorded goal completions**.
+
+A matched condition establishes only that condition, not every aspect of the
+mission. The run gate and share-safety verification remain separate from task
+adjudication. This release adds no automatic semantic evaluator.
+
+Existing actor statuses, `participants.reachedGoal`, verdict values and
+denominators stay unchanged. Current review commands, Observer rendering and
+newly generated feedback drafts apply these labels to older runs while
+preserving original bundles and actor traces. Existing HTML exports keep their
+original renderer. Other actor routes retain their own completion semantics.
+
+## Run a local app from npm
+
+To connect your local app's state and actions to Humanish, start with the
+[complete npm example](../architecture/examples/state-driven-local-app/README.md):
+
+```bash
+npm install humanish@0.88.1
+node node_modules/humanish/docs/architecture/examples/state-driven-local-app/runner.mjs
+```
+
+It starts a synthetic loopback app, reads its state, sends a greeting through
+its HTTP action endpoint and verifies the recorded run. A `finally` block closes
+the app. The provider follows a deterministic rule, so the example needs no
+model credentials or E2B desktop. Use Node.js 20.3 or later.
+
+The runner supplies both `CuaExecutor` and `CuaProvider`, passes a decoded object
+to `parseLabConfig`, and checks the config and backend discriminants. The
+existing `stableProgressKey` utility is now exported from `humanish`, so callers
+can use the same bounded state projection as the loop. Replace the two ports
+with your app bridge and provider; the example guide explains the responsibilities
+that remain with them.
+
+## Clipboard fallback returns after the write
+
+When direct desktop typing fails, Humanish can write the text to the X clipboard
+and paste it. `xclip` and `xsel` fork a process to keep the selection available;
+inherited output pipes could leave the command runner waiting until timeout.
+Both clipboard-write commands now detach their output while preserving the
+existing exit checks, temporary-file cleanup and paste dispatch.
+
+Custom desktop images still need a working `xclip` or `xsel`. Missing utilities
+continue to report `clipboard-utility-missing`. This patch adds no typing retry,
+and recovery after a primary write inserted an unknown partial prefix remains
+unproven. [Issue #340](https://github.com/danielgwilson/humanish/issues/340) remains
+open for that broader typing problem.
+
+## Verification and limits
+
+[Completion label checks](https://github.com/danielgwilson/humanish/pull/765)
+cover participant reports, recorded condition matches, zero completions and
+unavailable legacy detail. They preserve recorded counts and statuses while
+refreshing historical review and feedback projections. Existing adapter
+narrative remains available.
+
+[The packaged example](https://github.com/danielgwilson/humanish/pull/762) completed
+two independent local runs on Node 20.20.2 and 24.12.0. Each made two HTTP state
+reads and one state-changing request, reached `goal_satisfied`, verified as
+`share_ready` and closed its server. These checks used locally packed candidate
+source labeled 0.88.0, distinct from the registry release with that version.
+
+[The clipboard correction](https://github.com/danielgwilson/humanish/pull/761)
+passed two real desktop conformance cases, one with explicitly installed `xclip`
+and one with `xsel`. Each preserved the exact Unicode/newline/quoted text with
+one paste and removed its transfer file. Both cases refused the primary write
+before it could type anything. They do not establish default-image clipboard
+availability or recovery from partial typing.
+
+Both checks were model-free. They establish the tested integration and executor
+behavior; persona effectiveness and independent maintainer adoption remain
+separate questions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanish",
-  "version": "0.88.0",
+  "version": "0.88.1",
   "description": "Open-source-safe CLI for persona simulation, observer review, and public-safe feedback drafts.",
   "author": "Daniel G Wilson <daniel@danielgwilson.com>",
   "keywords": [