Close out statehub-register bootstrap housekeeping (REIN-OW-0001)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

AGENTS.md

@@ -11,6 +11,24 @@
 
 ---
 
+## Developer Workflow
+
+```bash
+# Install
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e . pytest
+
+# Test — no network/OpenBao calls, everything mocked at the httpx/subprocess
+# boundary
+python3 -m pytest tests/ -q
+
+# Run — real OpenRouter call (needs OPENROUTER_API_KEY or OpenBao access)
+rein-openweights run --task-file examples/task-hello-sandbox.json --no-hub
+```
+
+No separate lint/build step — this is a plain library + CLI, no packaging
+pipeline beyond `pip install -e .`.
+
 ## State Hub Integration
 
 The Custodian State Hub tracks work across all domains. Interact via HTTP REST —

SCOPE.md

@@ -1,32 +1,49 @@
 # SCOPE
 
-> This file was generated by `statehub register`. Refine it as the repository
-> boundaries become clearer.
-
 ## One-liner
 
-Agentic tool-use harness driving open-weight models via OpenRouter
+Agentic tool-use harness driving current open-weight models via OpenRouter —
+an alternative to the frontier-vendor harnesses (Claude Code, Grok CLI, Codex).
 
 ## Core Idea
 
-rein-openweights exists to provide the capability described in INTENT.md.
+One agentic loop (plan → tool call → observe → repeat), own minimal OpenRouter
+client (not llm-connect's `OpenRouterAdapter` — it can't drive a multi-turn
+tool-calling loop; see `workplans/REIN-OW-WP-0001-bootstrap.md` T01), same
+starter tool surface as rein-aharness's `green-commit-only`, own OpenBao
+credential acquisition (glas-harness ADR-002, Option B).
 
 ## In Scope
 
-- Maintain the repository's primary implementation.
-- Keep docs, tests, and operational metadata current.
+- `openrouter_client.py`: thin chat-completions client, own transport,
+  not routed through llm-connect
+- `tools.py`: read/write/edit/glob/grep + git status/diff/log/add+commit,
+  path-traversal guarded
+- `loop.py`: the agentic loop itself, turn- and budget-bounded
+- `credentials.py`: own OpenBao AppRole/ambient-token acquisition
+- `runner.py`/`hub.py`: commit-verified success criterion + State Hub
+  reporting, mirroring rein-aharness's model
 
 ## Out of Scope
 
-- Own unrelated adjacent systems.
-- Make irreversible operational decisions without human approval.
+- Model routing/selection policy — caller-supplied `--model`, not owned here
+- Monitoring/evaluation/optimization as first-class capabilities — a
+  deliberately deferred question (glas-harness ADR-002 part 2, "composable
+  reins as middleware") rather than something this repo builds ad hoc
+- Scheduling/task intake beyond a task-file/caller-driven CLI — no
+  kaizen-agentic/issue-core-style coupling (glas-harness ADR-003)
+- Being the glas-harness meta-framework itself — this repo is one
+  concrete rein under it
 
 ## Current State
 
-- Status: active; implementation and stability should be verified by the repo agent.
+`REIN-OW-WP-0001` is done (5/5). Live-proven through glas-harness's gateway
+against the real OpenRouter API (`qwen/qwen-2.5-72b-instruct`), real
+tool-calling loop, real verified commit. Attached to its Forgejo remote and
+registered with State Hub.
 
 ## Getting Oriented
 
-- Start with: INTENT.md
-- Agent instructions: AGENTS.md
-- Workplans: workplans/
+- Start with: `INTENT.md`
+- Agent instructions: `AGENTS.md`
+- Workplans: `workplans/`

workplans/REIN-OW-0001-statehub-bootstrap.md

@@ -4,7 +4,7 @@ type: workplan
 title: "Bootstrap State Hub integration"
 domain: infotech
 repo: rein-openweights
-status: ready
+status: active
 owner: codex
 topic_slug: custodian
 created: "2026-07-26"
@@ -20,7 +20,7 @@ Agentic tool-use harness driving open-weight models via OpenRouter
 
 ```task
 id: REIN-OW-0001-T01
-status: todo
+status: done
 priority: high
 state_hub_task_id: "1254c1aa-a8c8-4e1e-9289-20f9de1b465e"
 ```
@@ -32,7 +32,7 @@ Replace generated placeholders with repo-specific facts where needed.
 
 ```task
 id: REIN-OW-0001-T02
-status: todo
+status: done
 priority: high
 state_hub_task_id: "b3e39838-9273-4d3c-9eac-b9fdf3c35fc2"
 ```
@@ -45,7 +45,7 @@ changes confidently.
 
 ```task
 id: REIN-OW-0001-T03
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "d7dc4378-09b1-459d-9fa5-f49980e294f4"
 ```