# Way Forward

A private planning workspace for a legal and financial situation: the known debts, the questions that decide what actually blocks a departure, and a budget calculator for testing a realistic monthly payment. Entries stay in the browser instead of on the server, and the same calculations ship as a small CLI and a stateless MCP server.

**Status:** Private · Projects · 2026

- **Local checkout:** `/Users/simon/Developer/way-forward` (branch `main`)
- **On my tailnet:** http://ubuntu03:30111/
- **Where it runs:** namespace way-forward · NodePort 30111 · ubuntu03
- **Note:** Private · tailnet only

## Stack

Single-file HTML, Python stdlib, MCP stdio server, Kubernetes

## Start here

- `index.html` — the whole worksheet: known balances, legal review steps, budget calculator; entries in localStorage
- `way_forward.py` — static server, budget CLI and stateless MCP server
- `kubernetes.yaml` — namespace, ConfigMap-backed Deployment and NodePort 30111
- `deploy.sh` — builds the ConfigMap from the two files and rolls out on ubuntu03

## Commands

- **Run locally:** `python3 way_forward.py serve --port 8080`
- **Budget scenario:** `echo '{"debt_total":10000,"monthly_payment":1000}' | python3 way_forward.py budget`
- **MCP server:** `python3 way_forward.py mcp`
- **Deploy:** `sh deploy.sh`

## Deploy and where it runs

- Namespace way-forward, NodePort 30111 on ubuntu03, reachable at http://ubuntu03:30111/ over Tailscale.
- The pod runs python:3.12-alpine as a non-root user with a read-only root filesystem; the app files come from a ConfigMap.
- Deploy with sh deploy.sh, which rebuilds the ConfigMap and restarts the Deployment.

## Current state

Live and private. A personal planning worksheet; it was never given real case data and cannot read government systems.

## Watch out

- Treat the whole workspace as private personal material: it sits next to a real debt and travel situation, so never seed balances, case numbers or identity details into the repo, the ConfigMap, screenshots or this brief.
- The site is plain HTTP on a NodePort with no authentication; anyone on the cluster network or tailnet who knows the port can load the page. Entries persist in the browser profile, not on the server.
- The calculator is a straight-line illustration only; it ignores interest, fees and allocation and says nothing about legal permission to travel.
- The MCP tools are stateless calculation and reference helpers, not a legal agent and not case data access.

## Tags

Kubernetes, MCP, CLI, Local-first

---

Brief generated 2026-11-08 from `~/Developer/my-projects/context/`. Canonical URL: https://projects.navonsimon.com/context/way-forward.md
