johba/harb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request 'chore: gardener housekeeping 2026-03-25' (#1162) from chore/gardener-20260325-1805 into master

Browse source
This commit is contained in:
johba 2026-03-25 19:36:02 +01:00
commit 4dedc72375
11 changed files with 37 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

2
AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 491755592a86b34f7761347cd8cc299652b02942 -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Agent Brief: Harb Stack
## What is KRAIKEN?

2
formulas/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 209e0c798ea85204c5fe466ba7b54b874095e08f -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Agent Brief: Formulas
Formulas are TOML files that declare automated pipeline jobs for the harb evaluator.

2
gardener/dust.jsonl
View file

@ -1,2 +0,0 @@
{"issue":1086,"group":"evidence","title":"Update evidence/README.md schema with candidate_commit and methodology fields","reason":"Small schema addition to README.md","ts":"2026-03-22T06:05:49Z"}
{"issue":1083,"group":"evidence","title":"Document snapshot-isolation methodology for lm_eth fields","reason":"Schema clarification in evidence/README.md","ts":"2026-03-22T06:05:49Z"}

18
gardener/pending-actions.json
View file

@ -1 +1,17 @@
[]
[
{
"action": "remove_label",
"issue": 1155,
"label": "underspecified"
},
{
"action": "add_label",
"issue": 1155,
"label": "backlog"
},
{
"action": "comment",
"issue": 1155,
"body": "Promoting to backlog: body already has acceptance criteria and affected files. Well-specified for dev-agent pickup."
}
]

2
kraiken-lib/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 209e0c798ea85204c5fe466ba7b54b874095e08f -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Kraiken Library - Agent Guide
Shared TypeScript helpers used by the landing app, txnBot, and other services to talk to KRAIKEN contracts and the Ponder GraphQL API.

2
landing/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 491755592a86b34f7761347cd8cc299652b02942 -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Landing Interface - Agent Guide
Vue 3 + Vite application that delivers the public marketing site and forthcoming staking UI.

2
onchain/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 209e0c798ea85204c5fe466ba7b54b874095e08f -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Agent Brief: Kraiken Protocol
## Protocol Philosophy & Business Logic

14
scripts/harb-evaluator/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 209e0c798ea85204c5fe466ba7b54b874095e08f -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Agent Brief: harb-evaluator
The evaluator runtime executes formula-defined pipelines. Scripts in this
@ -18,7 +18,7 @@ and the adversarial agent harness.
| `export-attacks.py` | Extract cast send commands from agent stream log into `.jsonl` attack files |
| `red-team-program.md` | System prompt for the adversarial Claude agent |
| `holdout.config.ts` | Playwright config for holdout scenario execution |
| `helpers/` | TypeScript helpers: RPC, assertions, swap, stake, floor, market, reporting |
| `helpers/` | TypeScript helpers: RPC, assertions, swap, stake, floor, market, reporting, wallet |
| `scenarios/` | Holdout scenario scripts and the passive-confidence suite |
## Exit Code Convention
@ -52,6 +52,16 @@ Every script writes its evidence file to `evidence/{category}/{date}.json`
conforming to the schema in `evidence/README.md`. The `deliver` step in each
formula handles committing and posting an issue comment.
## Wallet Connection Helper
`helpers/wallet.ts` — `connectWallet(page)` handles the Playwright wallet
connection flow. Key behaviours:
- Detects auto-reconnect: if wagmi already reconnected from storage
(`.connect-button--connected` visible within 1 s), returns immediately.
- Opens the connectors panel via `.connect-button--disconnected` (10 s
timeout — wagmi needs time to settle into disconnected state after page load).
- Falls back to mobile hamburger menu if desktop button not found.
## Adding a New Evaluator Script
1. Place the script in this directory. Use `#!/usr/bin/env bash` and `set -euo pipefail`.

2
services/ponder/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 209e0c798ea85204c5fe466ba7b54b874095e08f -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Ponder Indexer - Agent Guide
Ponder-based indexer that records Kraiken protocol activity and exposes the GraphQL API consumed by the app and automation bot.

2
services/txnBot/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 209e0c798ea85204c5fe466ba7b54b874095e08f -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Transaction Bot - Agent Guide
Automation service that maintains liquidity alignment and tax enforcement for the KRAIKEN protocol.

2
web-app/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 209e0c798ea85204c5fe466ba7b54b874095e08f -->
<!-- last-reviewed: 358f719e2143ed0f99c738c61f1af9b544b03422 -->
# Web App - Agent Guide
Vue 3 + TypeScript staking interface for KRAIKEN, enabling users to stake tokens, manage positions, and interact with Harberger-tax mechanics.