scriptonia 0.8.0 → 0.9.0-rc.1

package/README.md

@@ -36,7 +36,7 @@ npx scriptonia comment plan/<slug> "default to all actors, and gate behind the a
 | **PLAN** | `npx scriptonia plan "<issue>"` | Retrieve the relevant signal, check prior decisions, and write **PLAN.md** — every claim cites a signal id; contradictions are gated **UNRESOLVED** until a human approves. |
 | **BUILD** | `claude "execute PLAN.md"` | Your agent implements against the plan's cited criteria and Non-goals fence. |
 | **REFINE** | `npx scriptonia comment plan/<slug> "…"` | A note regenerates the plan (v+1). A comment approving an override flips a contradiction to **RESOLVED**. |
-| **VERIFY** | `npx scriptonia verify` | Check the git diff, unresolved constraints, repo checks, and test coverage. Writes `.scriptonia/evals/<plan>.yaml`; exits 1 on BLOCK. |
+| **VERIFY** | `npx scriptonia verify` | Freeze the Git/product-memory snapshot and consume declared CI/JUnit/static evidence. It never executes repository commands. |
 
 ## Commands
 
@@ -46,7 +46,14 @@ signal    add <files>               (--source, --segment, or  cat x | npx script
 plan      plan "<issue>"            (--out <file>, --refresh <slug>)
           plans                     list plans + their slugs
           comment plan/<slug> "…"   refine → regenerates PLAN.md
-verify    verify [--base <ref>]       PLAN.md + git diff → PASS / WARN / BLOCK
+capture   run -- <agent-command>      capture exactly the command supplied
+          runs | run show <id>        inspect captured agent sessions
+verify    diff-check [--base <ref>]   sub-second deterministic policy pass
+          verify [--base <ref>]       complete evidence report
+          gate [--base <ref>]         CI-compatible aggregate exit status
+learn     learn <finding-id>          confirmed finding → draft eval
+          eval run [id] | eval doctor run and maintain regression cases
+memory    decide | pulse | why | recall local-first product/codebase memory
 inspect   scriptonia                the loop + what's next
           contexts | query "<topic>" | link "<id>" | sync
 account   status | logout | skill | mcp
@@ -58,9 +65,10 @@ account   status | logout | skill | mcp
 `~/.scriptonia/projects/<slug>/`, scans the code into a repo map (so plan steps
 name real files), and writes an `AGENTS.md` section. Customer signal you submit
 is stored and embedded on Scriptonia's servers; it is not written into the
-repository. The local brain is a human-readable working surface. Initialization
-does not upload the full codebase. When you explicitly run `verify`, the selected
-PLAN.md and git diff are sent for analysis; the YAML regression case stays local.
+repository. V2 policies, eval definitions, and operational brain data are
+local-first. Deterministic verification does not upload the codebase. When
+semantic evaluation is explicitly enabled, only the bounded evidence bundle is
+sent through the authenticated Scriptonia gateway.
 
 Skip `init` if you have one product — `login → add → plan` uses your default
 brain and scans whatever repo you run `plan` in.
@@ -76,4 +84,5 @@ Exposes `get_context`, `link_back`, `flag_contradiction` from your stored login.
 ## Self-hosting
 
 Defaults to `https://scriptonia.dev`. Point elsewhere with
-`SCRIPTONIA_URL=https://your.host npx scriptonia login` (or `--url`). Node 18+.
+`SCRIPTONIA_URL=https://your.host npx scriptonia login` (or `--url`). Node 24 LTS
+is the V2 release baseline; Node 22 remains in the compatibility matrix.