chore: bump to v1.1.5 — AMA refit, oversized-deal splitter, doc sync

froooze · froooze · commit 171d8d33f1aa · 2026-07-14T15:16:52.000+02:00
Two post-v1.1.4 changes packaged as a minor release plus a doc-sync
pass that closes stale references left behind when the splitter landed.

## Feat: AMA refit
Files: `modules/constants.ts`, `analysis/ama_fitting/optimizer_high_resolution.ts`
- Refit on 3yr pool 133 1h data (2023-07 → 2026-07) with per-AMA λ
  weights (0.0031/0.0025/0.00185/0.0013) and SMA-warmup-aligned
  optimizer.
- Slow periods: AMA1 73.3→62.1, AMA2 80.6→71.7, AMA3 88.7→82.7,
  AMA4 102.4→95.5. Default slow range narrowed 40-160→35-140.
- New `--fixEr` / `--fixFast` CLI flags fix ER=781 / Fast=5.2 and
  search Slow only. Stale references in market_adapter/README.md,
  TradingView README, and two test fixtures updated.

## Feat: maxBorrowAmountPerOperation + oversized-deal splitter
Files: `modules/types.ts`, `modules/bot_settings.ts`,
       `modules/credit_runtime.ts`, `modules/cr_planner.ts`,
       `tests/test_credit_runtime.ts`
- New per-op borrow cap on `LendingEntryBase`; rejected at
  `buildCreditOfferAcceptOperation` and clamped in the MPA planner.
- `_splitOversizedCreditDeals` runs as Phase 0 of credit maintenance:
  splits deals whose debt exceeds the cap into equal pieces via atomic
  repay+reborrow with 6s spacing, capped at
  `TIMING.CREDIT_DEAL_SPLIT_MAX_PIECES=48` per cycle. `_splitInFlight`
  concurrency guard prevents runMaintenance / runCreditWatchdog overlap.
- 6 new tests cover per-op rejection, offer-selection capping, correct
  split arithmetic, within-limit skip, no-limit skip, error-pattern match.

## Fix: Split settle-delay resolves from TIMING constant
File: `modules/credit_runtime.ts`
- `_doSplitOversizedCreditDeals` now reads `BLOCKCHAIN_SETTLE_DELAY_MS`
  from the imported `TIMING` constant, consistent with
  `dexbot_maintenance_runtime.ts`. Per-bot `bots.json` overrides for
  this field are no longer honoured for split pacing.

## Docs: Stale MPA/credit references closed
Files: `docs/MPA_CREDIT_USAGE.md`, `docs/developer_guide.md`
- Added `maxBorrowAmountPerOperation` to the Field Reference, the
  Amount Cap Semantics table, and the "Which section do I need?"
  quick-ref table.
- New "Oversized Credit Deal Splitter" subsection documents Phase 0
  behavior, `CREDIT_DEAL_SPLIT_MAX_PIECES`, `_splitInFlight`, the
  `min_deal_amount` guard, and shutdown abort.
- Runtime Timing now lists `CREDIT_DEAL_SPLIT_MAX_PIECES` and
  `BLOCKCHAIN_SETTLE_DELAY_MS`. Related Files adds `cr_planner.ts` and
  `types.ts` (`LendingEntryBase`).
- developer_guide.md Key Rules extended to mention the per-op cap with
  splitter.

## Version sync
Files: `package.json`, `package-lock.json`, `claw/package.json`,
       `claw/runtimes/openclaw-plugin/package.json`,
       `claw/runtimes/openclaw-plugin/openclaw.plugin.json`,
       `analysis/ama_fitting/package.json`,
       `claw/tests/test_claw_mcp_transport.ts`
- Version bumped 1.1.4 → 1.1.5 across all 7 manifests. `version:check`
  clean.

## Testing Notes
- `npm run version:check` — all manifests in sync
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,15 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.5] - 2026-07-14 - AMA Refit, Oversized Credit Deal Splitter & Per-op Borrow Cap
+
+### 2026-07-14
+
+- **Feat**: AMA refit on 3yr pool 133 1h data (2023-07 → 2026-07) with per-AMA λ weights (0.0031/0.0025/0.00185/0.0013) and SMA-warmup-aligned optimizer. Slow periods updated AMA1 73.3→62.1, AMA2 80.6→71.7, AMA3 88.7→82.7, AMA4 102.4→95.5. Default slow range narrowed 40-160→35-140. New `--fixEr` / `--fixFast` CLI flags fix ER=781 / Fast=5.2 and search Slow only. CLI validation adds `--ama1Cap`–`--ama4Weight` properties, removing 8 `(out as any)` casts. Stale references updated in market_adapter/README.md, TradingView README, and two test fixtures (`analysis/ama_fitting/optimizer_high_resolution.ts`, `modules/constants.ts`, `market_adapter/README.md`, `analysis/tradingview/README.md`, `tests/test_market_adapter_log_format.ts`, `tests/test_market_adapter_logic.ts`).
+- **Feat**: add `maxBorrowAmountPerOperation` config field and `_splitOversizedCreditDeals` — when a credit deal exceeds `maxBorrowAmountPerOperation`, maintenance splits it into equal pieces via repay+reborrow cycles with 6s spacing. Planner clamps debtDelta by per-op cap on top of the total `maxBorrowAmount` ceiling. `min_deal_amount` guard skips deals where any piece would be below the offer's minimum deal size. `MAX_PIECES_PER_CYCLE=48` (new `TIMING.CREDIT_DEAL_SPLIT_MAX_PIECES`) prevents unbounded cycles. `_splitInFlight` concurrency guard prevents `runMaintenance` / `runCreditWatchdog` collisions. 6 new tests cover per-op rejection, offer-selection capping, correct split arithmetic, within-limit skip, no-limit skip, and error-pattern match (`modules/types.ts`, `modules/bot_settings.ts`, `modules/credit_runtime.ts`, `modules/cr_planner.ts`, `tests/test_credit_runtime.ts`).
+- **Fix**: settle-delay resolution for credit splits now reads from the `TIMING` constant instead of `bot.config.TIMING.BLOCKCHAIN_SETTLE_DELAY_MS` — consistent with `dexbot_maintenance_runtime.ts`. Any per-bot `TIMING.BLOCKCHAIN_SETTLE_DELAY_MS` override in `bots.json` is no longer honoured for split pacing (`modules/credit_runtime.ts`).
+
 ## [1.1.4] - 2026-07-14 - AMA4 Slow Correction, Optimizer Range Tighten, Post-tag Doc Sync
 
 ### 2026-07-14
 
 - **Fix**: correct AMA4 slowPeriod from 107.4 to 102.4 — aligns AMA4 with the same λ=0.0025 refit applied to AMA1-3 in v1.1.3. Fixes stale slowPeriod references in market_adapter/README.md, test fixtures, and TradingView chart generator (`modules/constants.ts`, `market_adapter/README.md`, `tests/test_market_adapter_log_format.ts`, `tests/test_market_adapter_logic.ts`, `analysis/tradingview/tradingview_uplot_chart_generator.ts`).
 - **Feat**: narrow optimizer slow search range from 50-200 to 40-160 — focuses the geometric grid on the range where fitted winners consistently land, reducing wasted evaluations at uncompetitive extremes (`analysis/ama_fitting/optimizer_high_resolution.ts`).
 - **Docs**: sync v1.1.3 release notes with amaS% retune (0.085→0.08), update DYNAMIC_WEIGHT_RESEARCH.md knob table, correct EVOLUTION.md commit count for v1.1.3 (2→4) and summary to include the amaS% retune (`CHANGELOG.md`, `analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md`, `docs/EVOLUTION.md`).
-- **Feat**: add `maxBorrowAmountPerOperation` config field and `_splitOversizedCreditDeals` — when a credit deal exceeds `maxBorrowAmountPerOperation`, maintenance splits it into equal pieces via repay+reborrow cycles with 6s spacing (`modules/types.ts`, `modules/bot_settings.ts`, `modules/credit_runtime.ts`, `modules/cr_planner.ts`).
-- **Fix**: settle-delay resolution for credit splits now reads from the `TIMING` constant instead of `bot.config.TIMING.BLOCKCHAIN_SETTLE_DELAY_MS` — consistent with `dexbot_maintenance_runtime.ts`. Any per-bot `TIMING.BLOCKCHAIN_SETTLE_DELAY_MS` override in `bots.json` is no longer honoured for split pacing (`modules/credit_runtime.ts`).
 
 ## [1.1.3] - 2026-07-13 - AMA Refit λ=0.0025, amaS% Retune, tsx Compatibility, Doc Fixes
 
diff --git a/analysis/ama_fitting/package.json b/analysis/ama_fitting/package.json
@@ -1,6 +1,6 @@
 {
   "name": "ama_fitting",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Tools for fitting AMA parameters to market data",
   "main": "../../dist/analysis/ama_fitting/optimizer_high_resolution.js",
   "scripts": {
diff --git a/claw/package.json b/claw/package.json
@@ -1,6 +1,6 @@
 {
   "name": "dexbot2-claw",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "private": true,
   "description": "Claw bridge and runtime integration layer for BitShares and DEXBot2.",
   "type": "commonjs",
diff --git a/claw/runtimes/openclaw-plugin/openclaw.plugin.json b/claw/runtimes/openclaw-plugin/openclaw.plugin.json
@@ -2,7 +2,7 @@
   "id": "bitshares-claw",
   "name": "BitShares Claw",
   "description": "Native BitShares and DEXBot2 tools from the DEXBot2 claw integration",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "skills": [
     "skills"
   ],
diff --git a/claw/runtimes/openclaw-plugin/package.json b/claw/runtimes/openclaw-plugin/package.json
@@ -1,7 +1,7 @@
 {
   "name": "bitshares-claw-openclaw-plugin",
   "private": true,
-  "version": "1.1.4",
+  "version": "1.1.5",
   "type": "commonjs",
   "main": "index.js"
 }
diff --git a/claw/tests/test_claw_mcp_transport.ts b/claw/tests/test_claw_mcp_transport.ts
@@ -30,7 +30,7 @@ async function testParserAcceptsJsonlAcrossChunksAndSingleBuffer() {
       capabilities: {},
       clientInfo: {
         name: 'claw-mcp-transport-test',
-        version: '1.1.4'
+        version: '1.1.5'
       },
       protocolVersion: '2024-11-05'
     }
@@ -181,7 +181,7 @@ async function testMainEntrypointHandlesRealProcessInitialize() {
       capabilities: {},
       clientInfo: {
         name: 'claw-mcp-transport-test',
-        version: '1.1.4'
+        version: '1.1.5'
       },
       protocolVersion: '2024-11-05'
     }
diff --git a/docs/DEXBOT_COMPARISON.md b/docs/DEXBOT_COMPARISON.md
@@ -1,7 +1,7 @@
 # DEXBot vs DEXBot2 — Detailed Comparison Report
 
 > **Date:** 2026-07-11 *(metrics refreshed against local source trees)*
-> **Scope:** Full architectural, functional, and operational comparison between the original [DEXBot](https://github.com/Codaone/DEXBot) (Python, v1.0.0) and DEXBot2 (TypeScript, v1.1.4).
+> **Scope:** Full architectural, functional, and operational comparison between the original [DEXBot](https://github.com/Codaone/DEXBot) (Python, v1.0.0) and DEXBot2 (TypeScript, v1.1.5).
 > **Audience:** Developers, contributors, and operators evaluating or migrating between the two projects.
 
 ---
@@ -36,7 +36,7 @@
 
 | Attribute | DEXBot (original) | DEXBot2 |
 |---|---|---|
-| **Release Track** | 1.0.0 | v1.1.4 |
+| **Release Track** | 1.0.0 | v1.1.5 |
 | **Language** | Python 3.6+ | TypeScript 5.x |
 | **Status** | Released 1.0.0, unmaintained | Active development |
 | **Last Repo Activity** | May 23, 2020 | 2026-07-10 |
@@ -782,7 +782,7 @@ Where:
 
 | Metric | DEXBot | DEXBot2 |
 |---|---|---|
-| **Release Track** | 1.0.0 | v1.1.4 |
+| **Release Track** | 1.0.0 | v1.1.5 |
 | **Active Since** | ~2018 | December 2025 |
 | **Last Commit** | May 23, 2020 | 2026-07-10 |
 | **Total Commits** | 2281 | 1713 at current HEAD |
diff --git a/docs/EVOLUTION.md b/docs/EVOLUTION.md
@@ -2,14 +2,14 @@
 
 ## Executive Summary
 
-DEXBot2 is a sophisticated decentralized exchange trading bot for the BitShares blockchain. This report documents the complete evolution of the project from its inception in December 2025 through the current 1.1.4 stable release.
+DEXBot2 is a sophisticated decentralized exchange trading bot for the BitShares blockchain. This report documents the complete evolution of the project from its inception in December 2025 through the current 1.1.5 stable release.
 
 ### Key Milestones
 - **Project Inception**: December 2, 2025
-- **Growth Phase**: 1,724+ commits over ~7 active months
+- **Growth Phase**: 1,738+ commits over ~7 active months
 - **Code Maturity**: Evolution from basic utilities to a ~58,000+ LoC intelligent TypeScript system
 - **Stability**: Progression from manual testing to a suite of 200+ automated test files
-- **Releases**: 52 release entries (v0.1.0 to v1.1.4)
+- **Releases**: 53 release entries (v0.1.0 to v1.1.5)
 
 ---
 
@@ -127,12 +127,13 @@ Compact view; per-commit detail lives in [CHANGELOG.md](../CHANGELOG.md).
 | v1.1.1 → v1.1.2 | 1 | AMA refit (λ=0.0022/step=0.0002), optimizer chart output, constant tuning, doc sync |
 | v1.1.2 → v1.1.3 | 4 | AMA refit (λ=0.0025/step=0.0003), per-AMA distance weights, tsx-CJS export fix, amaS% retune 0.085→0.08, doc sync |
 | v1.1.3 → v1.1.4 | 3 | AMA4 slow correction 107.4→102.4, optimizer range 50-200→40-160, post-tag doc sync |
+| v1.1.4 → v1.1.5 | 2 | AMA refit (per-AMA λ weights, SMA-warmup optimizer, slow 62.1/71.7/82.7/95.5), `maxBorrowAmountPerOperation` + oversized-deal splitter |
 
 ---
 
 ## Development Statistics
 
-200+ automated test files (all TypeScript), 51 release entries. See **Version History** for commit breakdown by release.
+200+ automated test files (all TypeScript), 52 release entries. See **Version History** for commit breakdown by release.
 
 ---
 
@@ -178,7 +179,7 @@ DEXBot2 has matured from a basic grid bot into a signal-intelligent, production-
 ---
 
 **Report Originally Generated**: February 19, 2026
-**Last Updated**: July 14, 2026 (v1.1.4)
-**Total Commits**: 1,735
+**Last Updated**: July 14, 2026 (v1.1.5)
+**Total Commits**: 1,738
 **Date Range**: December 2, 2025 - July 14, 2026 (ongoing)
 **Repository**: DEXBot2 (BitShares DEX Trading Bot)
diff --git a/docs/FUND_MOVEMENT_AND_ACCOUNTING.md b/docs/FUND_MOVEMENT_AND_ACCOUNTING.md
@@ -806,4 +806,4 @@ To prevent "Time-of-Check to Time-of-Use" errors:
 3.  **Bootstrapping:** Fills arriving during startup (`isBootstrapping=true`) are queued until the grid is fully reconciled.
 
 ---
-*Technical Reference for DEXBot2 v1.1.4 release*
+*Technical Reference for DEXBot2 v1.1.5 release*
diff --git a/docs/MPA_CREDIT_USAGE.md b/docs/MPA_CREDIT_USAGE.md
@@ -23,6 +23,7 @@ DEXBot2 supports native BitShares debt workflows through the bot-level `debtPoli
 | Change how often the credit watchdog runs | [Runtime Timing](#runtime-timing) | `TIMING` in `constants.ts` |
 | Know what happens when MPA CR drops below minimum | [MPA Maintenance](#mpa-maintenance) | `minCollateralRatio` |
 | Know how credit deals are renewed and repaid | [Credit Offer Maintenance](#credit-offer-maintenance) | `autoReborrow` / `autoRepay` |
+| Cap the size of a single borrow, or split oversized deals | [Credit Offer Maintenance](#credit-offer-maintenance) | `maxBorrowAmountPerOperation` |
 | Use LP shares as credit-offer collateral | [LP-Backed Credit Collateral](#lp-backed-credit-collateral) | automatic valuation |
 | Diagnose pending reborrow or renewal issues | [State Files](#state-files) | `profiles/credit_runtime/<botKey>.json` |
 | Safe operating practices | [Operational Notes](#operational-notes) | — |
@@ -92,6 +93,7 @@ Add `debtPolicy` to a bot entry in `profiles/bots.json`:
 |-------|------|----------|-------------|
 | `outputWeight` | `number` | No | Output weight for this asset. Controls the proportion of debt value across lending items (not collateral). Defaults to `1`. See **Collateral Distribution** below. |
 | `maxBorrowAmount` | `number` | No | **Fixed** total debt ceiling. Must be a positive number (not a percentage). |
+| `maxBorrowAmountPerOperation` | `number` | No | **Per-operation borrow cap**. Any single credit-offer accept operation whose borrow amount exceeds this is rejected. For MPA, the planner clamps each `debtDelta` by this cap on top of `maxBorrowAmount`. When set, oversized credit deals are split into equal pieces via repay+reborrow cycles during maintenance (see [Credit Offer Maintenance](#credit-offer-maintenance)). Must be a positive number. |
 | `maxCollateralAmount` | `number \| percentage string` | No | Total collateral ceiling. Use a number for an absolute collateral amount, e.g. `5000`, or a percentage string of total available collateral, e.g. `"80%"`. |
 | `minCollateralIncreaseThreshold` | `number \| percentage string` | No | Minimum unused collateral allocation before increasing debt. Use a number for an absolute collateral amount, e.g. `25`, or a percentage string of assigned collateral budget, e.g. `"5%"`. `0` means no minimum. |
 | `maxCollateralRatio` | `number` | No\* | Behavior differs by type: MPA — hard CR ceiling above which debt is increased first; creditOffer — maximum effective ratio when accepting offers. **Required** for `creditOffer`. |
@@ -171,13 +173,17 @@ Timing defaults live in `modules/constants.ts`:
 {
   "TIMING": {
     "CREDIT_DEAL_CHECK_INTERVAL_MIN": 60,
-    "CREDIT_DEAL_EXPIRY_THRESHOLD_HOURS": 12
+    "CREDIT_DEAL_EXPIRY_THRESHOLD_HOURS": 12,
+    "CREDIT_DEAL_SPLIT_MAX_PIECES": 48,
+    "BLOCKCHAIN_SETTLE_DELAY_MS": 6000
   }
 }
 ```
 
 - `CREDIT_DEAL_CHECK_INTERVAL_MIN`: how often the credit watchdog runs. Set to `0` or negative to disable.
 - `CREDIT_DEAL_EXPIRY_THRESHOLD_HOURS`: how far before `latest_repay_time` the bot proactively repays and reborrows.
+- `CREDIT_DEAL_SPLIT_MAX_PIECES`: hard cap on pieces per `_splitOversizedCreditDeals` cycle (default 48; ~4.8min at 6s/piece). Prevents one maintenance run from exceeding the watchdog interval.
+- `BLOCKCHAIN_SETTLE_DELAY_MS`: pause between split pieces (default 6000ms). Resolved from the `TIMING` constant — per-bot `bots.json` overrides for this field are **not** honoured for split pacing.
 
 ## MPA Maintenance
 
@@ -196,19 +202,35 @@ For each `type: "mpa"` lending item:
 
 For each `type: "creditOffer"` lending item, the runtime:
 
+- **Phase 0 — Split oversized deals**: if `maxBorrowAmountPerOperation` is set, scans existing credit deals and splits any whose debt exceeds the per-op cap into equal pieces via repay+reborrow cycles (see [Oversized Credit Deal Splitter](#oversized-credit-deal-splitter)). This keeps each individual deal below the per-op cap and makes future renewals easier with less liquidity per operation.
 - Discovers active credit deals on-chain.
 - Validates deals against the per-item policy (`maxCollateralRatio`, `maxFeeRatePerDay`, `allowedOfferIds`, `disallowedDealIds`, etc.).
-- Gates increases on unused assigned collateral. If the collateral shortfall is at least `minCollateralIncreaseThreshold`, it accepts an additional credit deal from the cheapest acceptable offer; the selected offer's price derives the borrow amount, capped by `maxBorrowAmount`. A borrow-cap-capped increase is skipped if the actual collateral used would fall below `minCollateralIncreaseThreshold`.
+- Gates increases on unused assigned collateral. If the collateral shortfall is at least `minCollateralIncreaseThreshold`, it accepts an additional credit deal from the cheapest acceptable offer; the selected offer's price derives the borrow amount, capped by `maxBorrowAmount` and, when set, `maxBorrowAmountPerOperation`. A borrow-cap-capped increase is skipped if the actual collateral used would fall below `minCollateralIncreaseThreshold`.
 - Proactively repays deals nearing expiration (within `CREDIT_DEAL_EXPIRY_THRESHOLD_HOURS`) and reborrows when `autoReborrow` is enabled.
 - Ensures `auto_repay` on-chain matches the policy's `autoRepay` setting, updating local state after each successful broadcast.
 
+### Oversized Credit Deal Splitter
+
+When `maxBorrowAmountPerOperation` is set, each credit-maintenance cycle runs `_splitOversizedCreditDeals` as Phase 0. The splitter:
+
+- Discovers deals whose `debtAmount` exceeds `maxBorrowAmountPerOperation`.
+- Splits each oversized deal into `ceil(debt / maxPerOp)` equal pieces via atomic repay+reborrow transactions. Total debt across the new deals is preserved; only deal granularity changes.
+- Skips a deal if any piece would fall below the offer's `min_deal_amount` (the offer is cached for the runtime lifetime, so on-chain `min_deal_amount` changes mid-split are not re-read).
+- Pauses `BLOCKCHAIN_SETTLE_DELAY_MS` between pieces; aborts on shutdown.
+- Stops once `CREDIT_DEAL_SPLIT_MAX_PIECES` pieces have been emitted in the current cycle. Remaining oversized deals are deferred to the next maintenance cycle.
+- Uses an in-process `_splitInFlight` guard so `runMaintenance` and `runCreditWatchdog` cannot start overlapping splits.
+
+The split pieces are normal credit deals — they appear in `profiles/credit_runtime/<botKey>.json` alongside other deals and are subject to the usual renewal, `auto_repay`, and collateral-switching flows.
+
 ### Amount Cap Semantics
 
 | Policy | Field | Scope |
 |--------|-------|-------|
 | MPA | `maxBorrowAmount` | **Total debt ceiling** — call order debt cannot exceed this. |
+| MPA | `maxBorrowAmountPerOperation` | **Per-op borrow cap** — clamps each `debtDelta` increment during CR-band adjustments. Ignored on debt-reduction moves. |
 | MPA | `maxCollateralAmount` | **Total collateral ceiling** — call order collateral cannot exceed this. Withdrawals still allowed. |
 | Credit | `maxBorrowAmount` | **Total debt ceiling** — total credit debt for the asset cannot exceed this. |
+| Credit | `maxBorrowAmountPerOperation` | **Per-op borrow cap** — rejects any single `credit_offer_accept` whose borrow amount exceeds this. Oversized existing deals are split during maintenance (see [Oversized Credit Deal Splitter](#oversized-credit-deal-splitter)). |
 | Credit | `maxCollateralAmount` | **Total collateral ceiling** — total credit collateral for the asset cannot exceed this. |
 
 `maxBorrowAmount` is always a **fixed number** (no percentages). `maxCollateralAmount` may be a fixed number or a percentage.
@@ -281,7 +303,7 @@ The file tracks discovered chain state and pending work, including:
 - `positions` — per-position state map keyed as `debtAssetId:collateralAssetId`
 - Active MPA call-order state and credit deal IDs per position
 - `assignedCollateralBudget` per position
-- Pending reborrow requests
+- Pending reborrow requests (including deferred split pieces when an oversized-deal cycle hits `CREDIT_DEAL_SPLIT_MAX_PIECES`)
 - Last repay timestamp and grid reset request
 - Debt snapshot across all assets
 
@@ -300,12 +322,14 @@ Treat this file as runtime state, not primary configuration. The source of truth
 
 <details><summary>Source files and tests (click to expand)</summary>
 
-- `modules/credit_runtime.ts`: debt workflow executor
+- `modules/credit_runtime.ts`: debt workflow executor (Phase 0 oversized-deal splitter lives here)
+- `modules/cr_planner.ts`: MPA debt-first planner; clamps `debtDelta` by `maxBorrowAmountPerOperation`
+- `modules/types.ts`: `LendingEntryBase` — shared `mpa` / `creditOffer` type including `maxBorrowAmountPerOperation`
 - `modules/dexbot_class.ts`: runtime startup and watchdog lifecycle
 - `modules/bot_settings.ts`: `debtPolicy` validation
 - `market_adapter/README.md`: AMA pricing, grid triggers, and dynamic-weight runtime
 - `modules/credential_policy.ts`: signing constraints for credit and call-order operations
-- `tests/test_credit_runtime.ts`: credit runtime behavior coverage
+- `tests/test_credit_runtime.ts`: credit runtime behavior coverage (including 6 oversized-deal splitter tests)
 - `tests/test_multi_asset_distribution.ts`: collateral distribution and multi-asset state coverage
 
 </details>
diff --git a/docs/README.md b/docs/README.md
@@ -2,7 +2,7 @@
 
 This directory contains the comprehensive technical documentation for the DEXBot2 trading bot. It is designed to guide developers from high-level architecture down to the nuances of fund accounting and state management.
 
-**Version context:** v1.1.4 is the current release.
+**Version context:** v1.1.5 is the current release.
 
 ---
 
@@ -115,7 +115,7 @@ This directory contains the comprehensive technical documentation for the DEXBot
 
 ### 🧭 [Evolution Report](EVOLUTION.md)
 *Project timeline and major architecture phases.*
-- **Coverage**: Historical milestones from the initial December 2025 bootstrap through the v1.1.4 stable release (grid persistence safety, dust pipeline fix, net inventory lots); credit/debt runtime and maintenance hardening are covered under Phase 5 (Mar–Jun 2026)
+- **Coverage**: Historical milestones from the initial December 2025 bootstrap through the v1.1.5 stable release (grid persistence safety, dust pipeline fix, net inventory lots); credit/debt runtime and maintenance hardening are covered under Phase 5 (Mar–Jun 2026)
 - **Focus**: Architecture evolution, release history, test growth, and documentation changes
 
 ### 🗒️ [Changelog](../CHANGELOG.md)
diff --git a/docs/developer_guide.md b/docs/developer_guide.md
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "ama_fitting",`
`3`		`- "version": "1.1.4",`
	`3`	`+ "version": "1.1.5",`
`4`	`4`	`"description": "Tools for fitting AMA parameters to market data",`
`5`	`5`	`"main": "../../dist/analysis/ama_fitting/optimizer_high_resolution.js",`
`6`	`6`	`"scripts": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "dexbot2-claw",`
`3`		`- "version": "1.1.4",`
	`3`	`+ "version": "1.1.5",`
`4`	`4`	`"private": true,`
`5`	`5`	`"description": "Claw bridge and runtime integration layer for BitShares and DEXBot2.",`
`6`	`6`	`"type": "commonjs",`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "bitshares-claw-openclaw-plugin",`
`3`	`3`	`"private": true,`
`4`		`- "version": "1.1.4",`
	`4`	`+ "version": "1.1.5",`
`5`	`5`	`"type": "commonjs",`
`6`	`6`	`"main": "index.js"`
`7`	`7`	`}`