From 5f3e4333f51cb81f203af0ab8b11507d5728768c Mon Sep 17 00:00:00 2001 From: tegwick Date: Sun, 26 Jul 2026 19:46:21 +0200 Subject: [PATCH] Close out statehub-register bootstrap housekeeping (REIN-OW-0001) Co-Authored-By: Claude Sonnet 5 --- AGENTS.md | 18 ++++++++ SCOPE.md | 43 ++++++++++++++------ workplans/REIN-OW-0001-statehub-bootstrap.md | 8 ++-- 3 files changed, 52 insertions(+), 17 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 8a22b15..1ddc5d3 100644 --- a/AGENTS.md +++ b/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 — diff --git a/SCOPE.md b/SCOPE.md index 6315a7f..15f5309 100644 --- a/SCOPE.md +++ b/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/` diff --git a/workplans/REIN-OW-0001-statehub-bootstrap.md b/workplans/REIN-OW-0001-statehub-bootstrap.md index d1038bf..57286d3 100644 --- a/workplans/REIN-OW-0001-statehub-bootstrap.md +++ b/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" ```