coulomb/rein-aharness
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Agent harness component in the glas-harness framework of the helix-forge software factory ecosystem.
5 commits 1 branch 0 tags 1.3 MiB
Find a file
tegwick 4144eba160 feat: instance manifest, tool profiles, metrics, and budget enforcement 
Land HARNESS-WP-0001 T01/T02/T04/T05: extend ADR-005 schedule.yml with
harness fields, named tool-profile registry, ADR-004 metrics writes, and
BudgetTracker wiring. CLI gains validate/profiles; task-file path kept.
2026-07-17 23:49:03 +02:00
agent_harness feat: instance manifest, tool profiles, metrics, and budget enforcement 2026-07-17 23:49:03 +02:00
docs feat: instance manifest, tool profiles, metrics, and budget enforcement 2026-07-17 23:49:03 +02:00
examples feat: instance manifest, tool profiles, metrics, and budget enforcement 2026-07-17 23:49:03 +02:00
tests feat: instance manifest, tool profiles, metrics, and budget enforcement 2026-07-17 23:49:03 +02:00
workplans feat: instance manifest, tool profiles, metrics, and budget enforcement 2026-07-17 23:49:03 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-07-17 23:36:05 +02:00
.gitignore Initial commit 2026-07-17 21:30:39 +00:00
INTENT.md Harness foundation: INTENT, ADR-001, architecture, prototype adoption 2026-07-17 23:35:27 +02:00
LICENSE Initial commit 2026-07-17 21:30:39 +00:00
pyproject.toml feat: instance manifest, tool profiles, metrics, and budget enforcement 2026-07-17 23:49:03 +02:00
README.md feat: instance manifest, tool profiles, metrics, and budget enforcement 2026-07-17 23:49:03 +02:00

README.md

agent-harness

The single shared runtime for unattended agent instances in the Coulomb / Operational Knowledge ecosystem. Projects declare agents (manifest + .kaizen/ state); this harness runs them — blueprint via kaizen-agentic, tasks via activity-core, compute via llm-connect, credentials via OpenBao/ops-warden, reporting to the Custodian State Hub.

Usage

# Validate a consuming repo's instance manifest (.kaizen/schedule.yml)
agent-harness validate --target ~/binky-control
agent-harness validate --target ~/binky-control --strict   # require harness fields

# List named tool profiles
agent-harness profiles

# Run exactly one task (local JSON task-file path)
agent-harness run --task-file examples/task-hello-sandbox.json [--no-hub] [--no-metrics]

# Deterministic mailbox scan (no LLM session)
agent-harness mail-scan --target-repo ~/binky-control

Each run resolves the agent's tool profile + budget from the target repo's instance manifest (default green-commit-only), loads a persona bundle (kaizen-agentic schedule prepare), runs a bounded agentic session (cwd-pinned, hard allow-list, never pushes), verifies a local commit, writes .kaizen/metrics, and posts a State Hub progress event.

Instance manifest contract: docs/instance-manifest.md. Example: examples/schedule.harness.yml.

Tests: PYTHONPATH=".:$HOME/llm-connect" python3 -m pytest tests/ -q