# runway-calculator (startup-runway)

> Deterministic personal startup runway calculator for AI Agents. JSON in, JSON out. No human UI required.

## Discovery

- agents.json: agents.json
- Agent guide: agent.md
- Input schema: schemas/input.json
- Output schema: schemas/output.json
- Fixtures (golden tests): fixtures.json
- Health: /health (local preview server)

## Compute

- POST /compute  Content-Type: application/json
- GET  /compute?rent=1000&emergency_fund=12000&...
- Or require('./compute.js').computeRunway(input) in Node

## Formula

formula_id: runway-1 (deterministic)

- monthly_burn = rent + food + utilities + insurance + transportation + other
- project_costs = domain + software + ads
- total_monthly_burn = monthly_burn + project_costs
- total_funds = emergency_fund + investments
- runway_months = floor(total_funds / total_monthly_burn) if burn > 0 else 0
- status: >=12 safe / >=6 caution / else danger
- recommendation_code: SAFE_SOLID | CAUTION_KEEP_JOB | DANGER_DO_NOT_QUIT
- target: required = burn * target_months; additional = max(0, required - funds); months_to_save = ceil(additional / savings_rate)

## Response envelope

Success: { ok: true, result, human_summary, meta: { tool, version, formula_id, inputs_normalized } }
Error:   { ok: false, code, message, hint? }

## Use when

An Agent needs a verifiable runway number and a clear quit/keep-job signal from numeric burn and funds — not a chat estimate.