snapreq 0.0.10 → 0.0.12

package/README.md

@@ -167,6 +167,66 @@ connection.sendMessage({text: "hi"})
 
 Optional adapters: `networkMonitor` (gate reconnects on online state), `sessionStore` (persist the session id across reloads) and `deserialize` (a `(value) => value` transform applied inside `response.json()` so an app can re-hydrate its own wire format).
 
+## Hermes Compose development
+
+The repository includes a task-isolated Node 24 development environment for
+Hermes/Threadwire work. It mounts one exact worktree into `/workspace`; the
+dependency, npm-cache, and Codex state volumes are scoped by the required
+Compose project name. There are no support services, host ports, or fixed
+container names. The development-only `@kaspernj/hermes-compose` package owns
+the lifecycle, provider, process and signal handling, bootstrap, proof, smoke
+acceptance, and exact cleanup. SnapReq owns only `hermes.config.js` and its
+checked-in Compose/Dockerfile wiring.
+
+From the outer Hermes Docker host, allocate a self-contained Git checkout
+(with its own `.git` directory) directly below
+`/opt/hermes-dind-shared/worktrees/snapreq` and keep its task name identical to
+the Compose suffix:
+
+```sh
+export HERMES_SOURCE_PATH=/opt/hermes-dind-shared/worktrees/snapreq/10575
+export HERMES_COMPOSE_PROJECT=snapreq-10575
+
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose validate
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose config
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose build --pull
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose up
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose exec npm ci
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose proof
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose down
+```
+
+Codex authentication is initialized into the task-owned volume from one
+explicit, existing Docker volume in the private DinD daemon. That source
+volume must contain `/auth.json`; it is mounted read-only only for the one-off
+initializer and never attached to the long-running service:
+
+```sh
+export HERMES_CODEX_AUTH_VOLUME=<existing-auth-volume>
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose init-codex
+```
+
+Threadwire remains on the outer host. The package launches it through its
+provider, which runs Codex in the `dev` service at `/workspace`:
+
+```sh
+export THREADWIRE_TARGET=telegram:-1001234567890:42
+npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose threadwire --prompt 'Inspect the project.'
+```
+
+Use the pinned `npm exec` `down` command above for ordinary teardown; it
+preserves task state. Volume/image deletion requires the separate, exact
+confirmation:
+
+```sh
+HERMES_PURGE_PROJECT="$HERMES_COMPOSE_PROJECT" npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose purge
+```
+
+The two-stack acceptance entry point is
+`npm exec --yes --package=@kaspernj/hermes-compose@0.0.0 -- hermes-compose smoke`.
+See [AGENTS.md](AGENTS.md) for the authoritative boundary, parallel-allocation,
+verification, smoke-test, and non-Hermes workflow rules.
+
 ## License
 
 ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snapreq",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "Cross-platform HTTP and WebSocket client with one API across Node, web, Expo and React Native",
   "type": "module",
   "main": "./build/snap-req.js",
@@ -21,6 +21,7 @@
   "scripts": {
     "all-checks": "npm run typecheck && npm run lint && npm run test",
     "build": "rm -rf build && tsc",
+    "hermes:check": "node --test spec/hermes-compose-spec.js",
     "lint": "npm run eslint && npm run typecheck",
     "prepare": "npm run build",
     "prepublishOnly": "npm run build",
@@ -45,6 +46,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@kaspernj/hermes-compose": "0.0.0",
     "@types/node": "^26.0.1",
     "@types/ws": "^8.18.1",
     "eslint": "^10.3.0",