Skip to content

evan-moon/firma

v0.14.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 1mo MCP Developer Tools
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

claude cli finnhub local-first mcp personal-finance
+4 more
portfolio sqlite stock typescript

Summary

AI summary

The transactions.memo field was renamed to transactions.reason, with automatic migration on first run.

Full changelog

Highlights

💭 Capture the why behind every trade

  • `transactions.memo` renamed to `transactions.reason` — DB migrates automatically on first run.
  • `firma add txn` and `add_txn` now prompt for "Reason (why this trade?)" on buy/sell. Optional — empty input is fine.
  • The analyst persona now cross-checks stated reasons against actual outcomes, surfacing validated theses, drift, and repeated mistakes.

🧠 Four reasoning-framework prompts

Type `/` in Claude Desktop:

  • `/pre-mortem` — Five concrete failure modes for a position over 12 months, each tied to data with dollar impact and a mitigation.
  • `/rebalance` — Current allocation vs your target, with specific trades, tax cost, and wash-sale checks.
  • `/tax-harvest` — Unrealized losses, 30-day wash-sale rule, replacement suggestions, tax savings by bracket.
  • `/scenario` — Shock modeling on your actual portfolio ("S&P -20%", "Fed cuts 100bp", "2008 repeat") with explicit beta assumptions.

Each prompt enforces a tool-call sequence so Claude can't shortcut to generic advice — every recommendation is anchored to your real holdings.

Migration note

If you're upgrading from 0.13.0, the `memo` column on `transactions` is renamed to `reason` automatically the first time you run any firma command. No data is lost.

Breaking Changes

  • Renamed database column `transactions.memo` to `transactions.reason`; migration occurs automatically on first execution.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track evan-moon/firma

Get notified when new releases ship.

Sign up free

About evan-moon/firma

Local-first CLI asset tracker for overseas stock investors with Claude Desktop MCP integration. 13 tools for portfolio tracking, net worth snapshots, cash flow analysis, and market research (earnings, insider trades, SEC filings)

All releases →

Related context

Earlier breaking changes

  • v0.20.0 Brief no longer returns 'projected_net_worth' or 'on_track'.
  • v0.20.0 `simulate_goal_projection` renamed to `project_net_worth`.

Beta — feedback welcome: [email protected]