Skip to content

feat(L5): cost-of-debt pricing engine + financing instruments (ADR-0013, #616) #641

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
PipFoweraker merged 1 commit into from
Jul 15, 2026
Merged

feat(L5): cost-of-debt pricing engine + financing instruments (ADR-0013, #616) #641

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions godot/data/actions/financing.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,33 @@
"action_points": 1
},
"category": "financing"
},
{
"id": "seek_financing",
"name": "Seek Financing",
"description": "Run a raise (ADR-0013): the cost-of-debt engine quotes 2-3 concurrent offers priced by org type, counterparty, reputation and leverage. Offers stand until they expire; accept at plan speed.",
"costs": {
"action_points": 1
},
"category": "financing"
},
{
"id": "accept_financing_offer",
"name": "Accept Offer",
"description": "Accept a standing financing offer by id (from Seek Financing) — cash now, its quoted terms mint a ledger entry.",
"costs": {
"action_points": 1
},
"category": "financing"
},
{
"id": "pay_bills",
"name": "Pay the Bill",
"description": "Settle the soonest-due affordable loan early from cash (#566), retiring its balloon before it bills.",
"costs": {
"action_points": 1
},
"category": "financing"
}
]
}
112 changes: 112 additions & 0 deletions godot/data/balance/defaults.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,5 +93,117 @@
"easy": { "money_multiplier": 1.5, "max_action_points": 4 },
"standard": { "money_multiplier": 1.0, "max_action_points": 3 },
"hard": { "money_multiplier": 0.75, "max_action_points": 2 }
},
"financing": {
"_description": "Cost-of-debt pricing engine + financing instruments (ADR-0013, lane L5/#616). FinanceEngine.price() computes terms from org_type + counterparty + typed reputation + current leverage; generate_offers() mints 2-3 concurrent STANDING offers with an expiry (ADR-0012 — expiry mints no ledger entry). Engine: godot/scripts/core/finance_engine.gd. GOTCHA: computed interest rates are snapped to 0.001 (JSON save-safe, probe-verified against the real full-precision save path) and principals to whole units before entering a Ledger.Entry, so minted offers survive save/load (calibration open-Q #2). Baseline continuity: bank_loan at default context reproduces the calibrated ledger.loan terms (rate 0.008, ~77-tick fuse, 1.2x balloon); the sweep's take_loan path is UNCHANGED (routes Ledger.loan directly), so this block is additive and does not move the L1 medians.",
"ticks_per_month": 22.0,
"offer_ttl_turns": 44,
"leverage_scale": 120000.0,
"rate_floor": 0.002,
"rate_ceiling": 0.05,
"rep_rate_relief": 0.004,
"leverage_rate_penalty": 0.004,
"org_factors": {
"_description": "Multiply the base interest (ADR-0013: org type is the pricing engine's biggest input). >1 = worse cost of capital; <1 = cheaper. for_profit borrows cheapest (equity as collateral); independent/solo pays a premium.",
"nonprofit": 1.0,
"for_profit": 0.9,
"academic": 1.05,
"independent": 1.15
},
"counterparty_factors": {
"_description": "Who you owe changes what it costs (ADR-0013 major input; ADR-0007 counterparty dread). philanthropist = 0.0 => a gift, not a debt. shadow (desperation) = the punitive last resort.",
"bank": 1.0,
"vc": 0.85,
"government": 0.75,
"foundation": 0.8,
"philanthropist": 0.0,
"shadow": 2.2
},
"offer_tiers": {
"_description": "Reputation-gated menu quality (ADR-0013: better standing => better menus). The instrument's rep_channel picks safety- or finance-rep; that value selects the highest threshold it clears; counts[tier] caps concurrent offers.",
"thresholds": [0, 30, 60],
"counts": [2, 3, 3]
},
"instruments": {
"bank_loan": {
"name": "Bank term loan",
"factory": "loan",
"counterparty": "bank",
"rep_channel": "finance",
"principal_min": 30000,
"principal_max": 80000,
"principal_multiplier": 1.2,
"term_months": 3.5,
"base_rate": 0.008,
"non_cash": {},
"availability": { "min_rep": 15, "max_leverage": 3.0, "org_types": [] }
},
"credit_line": {
"name": "Revolving credit line",
"factory": "loan",
"counterparty": "bank",
"rep_channel": "finance",
"principal_min": 60000,
"principal_max": 160000,
"principal_multiplier": 1.15,
"term_months": 4.0,
"base_rate": 0.010,
"non_cash": {},
"availability": { "min_rep": 45, "max_leverage": 1.5, "org_types": [] }
},
"vc_equity": {
"name": "VC equity round",
"factory": "equity",
"counterparty": "vc",
"rep_channel": "finance",
"principal_min": 120000,
"principal_max": 400000,
"principal_multiplier": 1.0,
"term_months": 0.0,
"base_rate": 0.0,
"non_cash": { "equity_dilution": 0.12, "board_seat": true },
"availability": { "min_rep": 30, "min_hype": 25, "max_leverage": 5.0, "org_types": ["for_profit"] }
},
"grant_strings": {
"name": "Directed grant (agenda strings)",
"factory": "funding_strings",
"counterparty": "government",
"rep_channel": "safety",
"principal_min": 25000,
"principal_max": 70000,
"principal_multiplier": 0.10,
"term_months": 4.0,
"base_rate": 0.0025,
"non_cash": { "agenda_narrowing": true },
"availability": { "min_rep": 25, "org_types": [] }
},
"philanthropy": {
"name": "Philanthropic gift",
"factory": "philanthropy",
"counterparty": "philanthropist",
"rep_channel": "safety",
"principal_min": 15000,
"principal_max": 45000,
"principal_multiplier": 1.0,
"term_months": 0.0,
"base_rate": 0.0,
"appearance_chance": 0.35,
"non_cash": {},
"availability": { "min_rep": 30, "org_types": [] }
},
"desperation": {
"name": "Desperation payroll lever",
"factory": "desperation_payroll",
"counterparty": "shadow",
"rep_channel": "finance",
"principal_min": 0,
"principal_max": 0,
"principal_multiplier": 1.0,
"term_months": 2.5,
"base_rate": 0.008,
"non_cash": { "secret": true },
"availability": { "min_rep": 0, "org_types": [] }
}
}
}
}
40 changes: 40 additions & 0 deletions godot/scripts/core/actions.gd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -370,6 +370,46 @@ static func execute_action(action_id: String, state: GameState) -> Dictionary:
state.ledger.add(Ledger.staff_rider("Contractor"))
result["message"] = "Brought on a contractor (+2 AP; a governance rider bills later)"

# --- ADR-0013 cost-of-debt engine (L5 #616): the raise-as-campaign flow ---
"seek_financing":
# Run a purpose-tagged raise: the pricing engine quotes a menu of standing offers
# (ADR-0012 expiry). They persist on state.financing_offers for accept at plan speed.
var rng: RandomNumberGenerator = state.rng if ("rng" in state and state.rng != null) else RandomNumberGenerator.new()
var ctx: Dictionary = FinanceEngine.context_from_state(state)
state.financing_offers = FinanceEngine.generate_offers(ctx, "general", rng)
if state.financing_offers.is_empty():
result["message"] = "No financiers are interested right now (reputation/standing too low)."
else:
var lines: Array = []
for o in state.financing_offers:
lines.append("%s ($%d @ %.1f%%/mo)" % [o["name"], int(o["principal"]), float(o["interest_rate"]) * FinanceEngine.ticks_per_month() * 100.0])
result["message"] = "Offers on the table: " + "; ".join(lines)

"accept_financing_offer":
# Accept the first still-live standing offer (the UI selects a specific one via
# FinanceEngine.accept_offer(offer, state); the headless/action default is best-first).
var accepted := false
for o in state.financing_offers:
if FinanceEngine.offer_live(o, int(state.turn)):
var ar: Dictionary = FinanceEngine.accept_offer(o, state)
result["message"] = ar.get("message", "")
result["success"] = bool(ar.get("success", false))
accepted = ar.get("success", false)
if accepted:
state.financing_offers.erase(o)
break
if not accepted:
result["message"] = "No live offer to accept (seek financing first, or offers expired)."

"pay_bills":
# The "pay the bill" interaction (#566): settle the soonest-due affordable loan early.
if state.ledger:
var pr: Dictionary = state.ledger.pay_soonest_payable(state)
result["message"] = pr.get("message", "")
result["success"] = bool(pr.get("success", false))
else:
result["message"] = "No ledger to pay against."

"submit_paper":
# Paper submission action (Issue #468)
# This is handled by UI - creates paper and adds to state
Expand Down
Loading
Loading