@scribed/cli 0.1.40 → 0.1.41

package/README.md

@@ -9,6 +9,33 @@ option audit are recorded in the maintainers' offline audit inventories, which
 are not part of this package (in the source tree, see
 `scripts/refine-route-changes.ts --routes/--coverage`).
 
+## Financial models and simulated 409A
+
+The modeling tools read accounting actuals directly from your live QuickBooks or
+Puzzle connection through Scribed API. Select an explicit workspace for your
+company baseline and Scribed Capital cap table/investor context. Saved Financials
+entries, imported history, Drive/Vault documents and general workspace knowledge
+are not model sources. `financials_model_sources` returns live account metadata
+and workspace company choices; `capitalCompanyId` selects a workspace company,
+while `companyId` selects a Puzzle provider company.
+
+Use `financials_model_prepare`, review the editable assumptions, then run
+`financials_model_preview` or `financials_model_valuation`. Their `report.token`
+is a private, short-lived reference to that exact result. Save it with the same
+`workspaceId` in a local input JSON file, then download the PDF:
+
+```bash
+scribed call financials_model_report --input report.json --out forecast.pdf
+```
+
+`financials_model_report_to_vault` accepts that same token plus `confirmed: true`,
+one stable UUID `requestId` and an optional `folder`. It saves the PDF privately
+without repeating model calculation or AI; the returned `vault_download`
+descriptor retrieves the saved bytes. Read-only MCP grants exclude this save.
+`financials_model_export` still provides an optional formula XLSX. All model
+tools are interactive only and keep the existing workspace/export permissions.
+Simulated 409A results are not an independent appraisal or an option strike price.
+
 ## Install
 
 Requires Node.js 20 or newer; users do not need Bun.