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

chore: gardener housekeeping 2026-03-23

Browse source 
- Update all AGENTS.md watermarks to HEAD (224edcc)
- onchain/AGENTS.md: document VWAPTracker _hasRecenterTick guard (#609),
  overflow guard for slots 0-7 (#997), Floor Ratchet defeated (#1067),
  fee-income delta_bps audit trail (#1084)
- landing/AGENTS.md: document SecurityInfo.vue component (#147)

Issues actioned via API:
- Unblocked #1099, #1100, #1101 (all prereqs 1031/997/1067/1054 closed)
- Created #1134 bundled backlog: onchain source quality cleanup (4 dust items)
- Closed dust #601, #627, #739, #741 → bundled into #1134
This commit is contained in:
johba 2026-03-23 07:04:19 +00:00
parent 224edcc6d3
commit b276392e7a
9 changed files with 14 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

2
AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Agent Brief: Harb Stack # Agent Brief: Harb Stack
## What is KRAIKEN? ## What is KRAIKEN?

2
formulas/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 6b9dad5 --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Agent Brief: Formulas # Agent Brief: Formulas
Formulas are TOML files that declare automated pipeline jobs for the harb evaluator. Formulas are TOML files that declare automated pipeline jobs for the harb evaluator.

2
kraiken-lib/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Kraiken Library - Agent Guide # 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. Shared TypeScript helpers used by the landing app, txnBot, and other services to talk to KRAIKEN contracts and the Ponder GraphQL API.

3
landing/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Landing Interface - Agent Guide # Landing Interface - Agent Guide
Vue 3 + Vite application that delivers the public marketing site and forthcoming staking UI. Vue 3 + Vite application that delivers the public marketing site and forthcoming staking UI.
@ -14,6 +14,7 @@ Vue 3 + Vite application that delivers the public marketing site and forthcoming
## Key Views & Components ## Key Views & Components
- `HomeView.vue` - Launch countdown, feature overview, and staking CTA - `HomeView.vue` - Launch countdown, feature overview, and staking CTA
- `DocsView.vue` - Documentation portal with responsive navigation and generated table of contents - `DocsView.vue` - Documentation portal with responsive navigation and generated table of contents
- `SecurityInfo.vue` - Displays unaudited badge (planned Q3 2026), KRAIKEN Token and Stake contract addresses with copy-to-clipboard, BaseScan and source links (#147)
- Layout components (`KNavbar.vue`, `KFooter.vue`, `LeftRightComponent.vue`) manage shared chrome - Layout components (`KNavbar.vue`, `KFooter.vue`, `LeftRightComponent.vue`) manage shared chrome
- UI components (`KButton.vue`, `Countdown.vue`, `SocialButton.vue`, icon set) supply reusable primitives - UI components (`KButton.vue`, `Countdown.vue`, `SocialButton.vue`, icon set) supply reusable primitives

7
onchain/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Agent Brief: Kraiken Protocol # Agent Brief: Kraiken Protocol
## Protocol Philosophy & Business Logic ## Protocol Philosophy & Business Logic
@ -43,7 +43,7 @@ The staking system traces a triangle in (staking%, avgTax) space:
## System Snapshot ## System Snapshot
- Kraiken ERC20 with mint/burn via LiquidityManager. VERSION=2. - Kraiken ERC20 with mint/burn via LiquidityManager. VERSION=2.
- LiquidityManager.sol: ANCHOR + DISCOVERY + FLOOR positions with asymmetric slippage. - LiquidityManager.sol: ANCHOR + DISCOVERY + FLOOR positions with asymmetric slippage.
- VWAPTracker.sol: squared price in X96, compression, directional recording (price-fall / ETH-outflow events only — buy-only cycles must NOT update VWAP or the floor tracks the inflated price, crystallising IL; see issue #543). - VWAPTracker.sol: squared price in X96, compression, directional recording (price-fall / ETH-outflow events only — buy-only cycles must NOT update VWAP or the floor tracks the inflated price, crystallising IL; see issue #543). Uses `_hasRecenterTick` boolean guard to decouple bootstrap detection from VWAP recording — prevents tick-0 ambiguity when `lastRecenterTick==0` after bootstrap (#609).
- OptimizerV3.sol: UUPS upgradeable, direct 2D binary mapping. - OptimizerV3.sol: UUPS upgradeable, direct 2D binary mapping.
- Stake.sol: self-assessed tax, snatching auctions, discrete brackets, UBI redistribution. - Stake.sol: self-assessed tax, snatching auctions, discrete brackets, UBI redistribution.
@ -71,3 +71,6 @@ The staking system traces a triangle in (staking%, avgTax) space:
- Outstanding supply excludes LM position balances and KRK held by `feeDestination` (only when `feeDestination != address(0) && feeDestination != address(this)`) and `stakingPool` (only when `stakingPoolAddr != address(0) && stakingPoolAddr != feeDestination`). - Outstanding supply excludes LM position balances and KRK held by `feeDestination` (only when `feeDestination != address(0) && feeDestination != address(this)`) and `stakingPool` (only when `stakingPoolAddr != address(0) && stakingPoolAddr != feeDestination`).
- `recenterAccess` is removed — `recenter()` always enforces cooldown and TWAP stability. No bypass path exists. - `recenterAccess` is removed — `recenter()` always enforces cooldown and TWAP stability. No bypass path exists.
- `feeDestinationLocked` prevents CREATE2 bypass: once `feeDestination` is set to a contract address, it cannot be changed. `setFeeDestination` checks `.code.length > 0` to detect contract addresses. - `feeDestinationLocked` prevents CREATE2 bypass: once `feeDestination` is set to a contract address, it cannot be changed. `setFeeDestination` checks `.code.length > 0` to detect contract addresses.
- Optimizer input slots 0-7 all require `<= 1e18` — the overflow guard previously only applied to slot 0 (`percentageStaked`); slots 1-7 (including `averageTaxRate`) are now also validated (#997).
- Floor Ratchet attack (buy→stake→recenter oscillation) is defeated — evidence in `evidence/red-team/2026-03-22-floor-ratchet-oscillation.json` shows floor holds under 2000-trade oscillation (#1067).
- Fee-income delta_bps calculation is documented in `evidence/README.md`; `LmTotalEth.s.sol` now captures the auditable snapshot methodology (#1084).

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

@ -1,4 +1,4 @@
<!-- last-reviewed: 6b9dad5 --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Agent Brief: harb-evaluator # Agent Brief: harb-evaluator
The evaluator runtime executes formula-defined pipelines. Scripts in this The evaluator runtime executes formula-defined pipelines. Scripts in this

2
services/ponder/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Ponder Indexer - Agent Guide # Ponder Indexer - Agent Guide
Ponder-based indexer that records Kraiken protocol activity and exposes the GraphQL API consumed by the app and automation bot. 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: 5f01d55cc7ce0f3499967536971878ef968d59ba --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Transaction Bot - Agent Guide # Transaction Bot - Agent Guide
Automation service that maintains liquidity alignment and tax enforcement for the KRAIKEN protocol. 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: 5f01d55cc7ce0f3499967536971878ef968d59ba --> <!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Web App - Agent Guide # Web App - Agent Guide
Vue 3 + TypeScript staking interface for KRAIKEN, enabling users to stake tokens, manage positions, and interact with Harberger-tax mechanics. Vue 3 + TypeScript staking interface for KRAIKEN, enabling users to stake tokens, manage positions, and interact with Harberger-tax mechanics.