InvestmentPlan Server

Version-controlled org-mode investment plan, readable and writable by AI agents anywhere. Every write is optimistic-concurrency-checked (expectedVersion) — a stale write gets HTTP 409, never a silent overwrite.

• Format: org-mode (plain text, GNU/Emacs Org format)
• Auth: none required right now (temporary, do not assume this stays open)

Concurrency

Every write (POST /update, GET /update-line) requires expectedVersion equal to the plan's current version (read it from GET /plan's X-Plan-Version header, or GET /changelog[0].version). A mismatch returns 409 {ok:false, conflict:true, currentVersion} — refetch and retry with the new version.

Routes

GET /plan

Fetch the current plan content.
Response: text/plain org content; headers X-Plan-Version, X-Plan-Sha256, Last-Modified.

GET /view

Same content as /plan, wrapped as an HTML page for clients that only render HTML (e.g. some AI browsing tools).
Response: text/html; same X-Plan-Version/X-Plan-Sha256/Last-Modified headers as /plan.

GET /changelog

Recent version history, newest first.
Query: limit — optional integer, default 50.
Response: JSON array of {version, at, author, note}.

GET /version/:id

Fetch one historical version by its version number.
Response: JSON {version, createdAt, author, note, sha256, content}.

POST /update

Full-content replace.
Body:

• content — string, the complete new org document
• expectedVersion — integer, current version, see concurrency note above
• note — optional string
• author — optional string

GET /update-line

Small line-range patch — cheaper than a full replace for a targeted edit.
Query:

• version — required integer, expectedVersion, see concurrency note above
• op — replace | insert | remove (default replace)
• line_start — required integer, 1-indexed
• line_end — required for replace/remove; ignored for insert
• text — required for replace/insert; ignored for remove
• note — optional string
• author — optional string

Examples

curl https://info.calculateit.dev/plan
curl https://info.calculateit.dev/changelog?limit=5
curl -X POST https://info.calculateit.dev/update -H 'Content-Type: application/json' -d '{"content":"...","expectedVersion":5}'
curl -G https://info.calculateit.dev/update-line --data-urlencode 'version=5' --data-urlencode 'op=insert' --data-urlencode 'line_start=120' --data-urlencode 'text=* New heading'