naive-framework 0.1.0 → 0.2.0

package/schema/deal.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "deal.schema.json",
+  "title": "Deal",
+  "description": "One company in the fund's pipeline (deals/<id>.json), from sourced to invested or passed. An investment it makes becomes a nested venture under portfolio/.",
+  "type": "object",
+  "required": [
+    "id",
+    "company",
+    "round",
+    "status"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "company": {
+      "type": "string"
+    },
+    "round": {
+      "enum": [
+        "pre-seed",
+        "seed",
+        "series-a",
+        "series-b",
+        "growth",
+        "late"
+      ],
+      "description": "The financing round the company is raising"
+    },
+    "status": {
+      "enum": [
+        "sourced",
+        "screening",
+        "diligence",
+        "term-sheet",
+        "invested",
+        "passed"
+      ]
+    },
+    "sector": {
+      "type": "string"
+    },
+    "source": {
+      "type": "string"
+    },
+    "check": {
+      "type": "object",
+      "required": [
+        "amount",
+        "currency"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "amount": {
+          "type": "number",
+          "minimum": 0
+        },
+        "currency": {
+          "type": "string",
+          "pattern": "^[A-Z]{3}$"
+        }
+      }
+    },
+    "thesis_fit": {
+      "type": "string",
+      "description": "How the company fits fund/thesis.json, in a sentence"
+    },
+    "portfolio": {
+      "type": "string",
+      "pattern": "^portfolio/[a-z0-9-]+$",
+      "description": "The nested venture, once invested"
+    },
+    "note": {
+      "type": "string"
+    }
+  }
+}

package/schema/decisions.mjs

@@ -30,6 +30,8 @@ import { dirname, join, relative } from "node:path";
 import { FRAME, foundation } from "./foundation.mjs";
 import { agentFromEnv, record as prov } from "../interface/provenance.mjs";
 import { glob as routeFileGlob, routes } from "../interface/router.mjs";
+// Caching hook (F-12): the decision list is computed once per router action (schema/caching.mjs).
+import { memo } from "./caching.mjs";
 
 const repo = new URL("..", import.meta.url).pathname;
 const load = (f) => JSON.parse(readFileSync(f, "utf8"));
@@ -53,7 +55,11 @@ function decisionFiles(dir, sub = "") {
 }
 
 /** Every decision of a venture, resolved: boundary, render state and what holds it. */
-export function decisions(dir, now = Date.parse(process.env.DECISIONS_NOW ?? "") || Date.now()) {
+// Caching hook (F-12): without an explicit now, one action shares one decision list; now is the action's.
+export function decisions(dir, now) {
+  return now === undefined ? memo("decisions", () => decisionsAt(dir), { dir }) : decisionsAt(dir, now);
+}
+function decisionsAt(dir, now = Date.parse(process.env.DECISIONS_NOW ?? "") || Date.now()) {
   const venture = load(join(dir, "venture.json"));
   const phase = PHASES.indexOf(venture.phase);
   const productOnly = venture.kind === "product";

package/schema/examples/frames/judge.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+// A stand-in judge for the frames test (the Jev protocol): reads one request on stdin and answers every
+// noul question from the facts it was given, without a model. A premise is unknown (0.5) when a fact it
+// could rest on says "not on record", else no (0.1); the trade reads as a sequence.
+let input = "";
+for await (const c of process.stdin) input += c;
+const req = JSON.parse(input);
+const unknown = Object.values(req.state.venture ?? {}).some((v) => v === "not on record");
+const answers = Object.fromEntries(Object.keys(req.questions).map((k) => [k, { noul: k.startsWith("dichotomy:") ? (k === "dichotomy:sequence" ? 0.9 : 0.1) : k === "premise:needs-outside-money" && unknown ? 0.5 : 0.1 }]));
+console.log(JSON.stringify({ model: "stand-in", answers }));

package/schema/examples/venture-type/jev.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// A stand-in for Jev in tests (MENTURA_TYPE_CMD="node schema/examples/venture-type/jev.mjs"): reads the
+// typed request on stdin and answers each type:<id> question yes when the description uses one of that
+// type's examples, so the classifier's ranking and its uncertain path can be tested offline.
+import { readFileSync } from "node:fs";
+let input = "";
+for await (const c of process.stdin) input += c;
+const req = JSON.parse(input);
+const words = req.state.venture.description.toLowerCase();
+const types = JSON.parse(readFileSync(new URL("../../venture-types.json", import.meta.url), "utf8")).types;
+const answers = Object.fromEntries(types.map((t) => [`type:${t.id}`, { noul: t.examples.some((e) => words.includes(e.toLowerCase())) ? 0.92 : 0.04 }]));
+console.log(JSON.stringify({ model: "stand-in", answers }));

package/schema/examples/workspace/ventures/acme-labs/AGENTS.md

@@ -0,0 +1,17 @@
+# AGENTS.md: acme-labs
+
+The map of this venture for agents. Read it, then a route's layout, before writing anything here.
+
+## How to work here
+
+- List the routes with `mentura routes`. Read a route's `layout` and `template` before you write to it.
+- Write through the router (the CLI or the MCP server), not by editing files. Every write is checked against its schema and recorded in provenance.jsonl.
+- A write that fails closed comes back as a draft in `_drafts/`. A person accepts it with `mentura accept`.
+- Never read or send anything under `_private/` to a model.
+- A deeper AGENTS.md (for example `marketing/AGENTS.md`) adds to this one for the routes under it; the nearer one wins.
+
+## Instructions
+
+phase: discovery
+voice: plain words, in the founder's own terms
+private: _private/

package/schema/examples/workspace/ventures/acme-labs/decisions/discovery-goal.decision.json

@@ -0,0 +1,23 @@
+{
+  "id": "discovery-goal",
+  "question": "What must be true for the venture to leave discovery? Name the goal this phase works toward.",
+  "decides": {
+    "record": "telos",
+    "path": "foundation/telos.json"
+  },
+  "layer": "purpose",
+  "needed_in": "discovery",
+  "boundary": "fail-open",
+  "status": "decided",
+  "provenance": {
+    "drafted_by": {
+      "kind": "agent"
+    },
+    "approved_by": "Maya Chen",
+    "approved_at": "2026-10-29T06:29:13Z",
+    "phase": "discovery",
+    "wording": "own",
+    "via": "api"
+  },
+  "answer": "Ten cafe owners confirm the reordering problem in interviews, and three agree to pilot the app, by the end of December."
+}

package/schema/examples/workspace/ventures/acme-labs/decisions/statement-icp.decision.json

@@ -0,0 +1,22 @@
+{
+  "id": "statement-icp",
+  "question": "Write the icp statement",
+  "statement": "icp",
+  "decides": {
+    "record": "icp"
+  },
+  "layer": "purpose",
+  "needed_in": "discovery",
+  "status": "decided",
+  "provenance": {
+    "drafted_by": {
+      "kind": "agent"
+    },
+    "approved_by": "Maya Chen",
+    "approved_at": "2026-10-29T06:29:12Z",
+    "phase": "discovery",
+    "wording": "own",
+    "via": "api"
+  },
+  "answer": "Owner-operators of one to three independent cafes in one city, who order from three or more suppliers."
+}

package/schema/examples/workspace/ventures/acme-labs/decisions/statement-problem.decision.json

@@ -0,0 +1,22 @@
+{
+  "id": "statement-problem",
+  "question": "Write the problem statement",
+  "statement": "problem",
+  "decides": {
+    "record": "validation-problem"
+  },
+  "layer": "purpose",
+  "needed_in": "discovery",
+  "status": "decided",
+  "provenance": {
+    "drafted_by": {
+      "kind": "agent"
+    },
+    "approved_by": "Maya Chen",
+    "approved_at": "2026-10-29T06:29:12Z",
+    "phase": "discovery",
+    "wording": "own",
+    "via": "api"
+  },
+  "answer": "Independent cafe owners lose three to five hours a week reordering supplies by hand, and still run out of best-sellers."
+}

package/schema/examples/workspace/ventures/acme-labs/decisions/venture.team.decision.json

@@ -0,0 +1,37 @@
+{
+  "id": "founding-team",
+  "question": "Who is founding this venture: you alone, you with cofounders, or you looking for cofounders?",
+  "decides": {
+    "record": "founder-agreement",
+    "path": "governance/founder-agreement.json"
+  },
+  "layer": "governance",
+  "boundary": "fail-open",
+  "needed_in": "discovery",
+  "status": "decided",
+  "options": [
+    "Solo: I am founding it alone",
+    "Cofounders: we are founding it together",
+    "Looking: I want cofounders"
+  ],
+  "unlocks": [
+    {
+      "activity": "Draft the founder agreement with the founding-agreement kit",
+      "routes": [
+        "governance/founder-agreement"
+      ]
+    }
+  ],
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    },
+    "approved_by": "Maya Chen",
+    "approved_at": "2026-10-29T06:29:12Z",
+    "phase": "discovery",
+    "wording": "own",
+    "via": "api"
+  },
+  "answer": "Solo: I am founding it alone"
+}

package/schema/examples/workspace/ventures/acme-labs/knowledge/README.md

@@ -0,0 +1,3 @@
+# knowledge
+
+Memory: every record the venture keeps, including notes, specs, decisions and references.

package/schema/examples/workspace/ventures/acme-labs/knowledge/sources.json

@@ -0,0 +1,46 @@
+{
+  "sources": [],
+  "records": {},
+  "truth": "local",
+  "functions": {
+    "products": {
+      "systems": [
+        {
+          "system": "local-repo",
+          "address": "../acme-app",
+          "status": "pointed"
+        },
+        {
+          "system": "github",
+          "address": "acme-labs/app",
+          "status": "pointed"
+        },
+        {
+          "system": "vercel",
+          "address": "acme-labs/web",
+          "status": "pointed"
+        }
+      ]
+    },
+    "marketing-and-sales": {
+      "systems": [
+        {
+          "system": "vercel",
+          "address": "acme-labs/web",
+          "status": "pointed"
+        }
+      ]
+    },
+    "finance": {
+      "systems": [
+        {
+          "system": "rho",
+          "status": "connected",
+          "synced": "2026-10-29T06:28:55Z",
+          "fixture": true,
+          "address": "saved sandbox answer"
+        }
+      ]
+    }
+  }
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000001.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000001",
+  "name": "Reserve Checking",
+  "type": "checking",
+  "last_4": "0106",
+  "balance": {
+    "amount": 1046,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000001",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000002.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000002",
+  "name": "Cash (Checking)",
+  "type": "checking",
+  "last_4": "9508",
+  "balance": {
+    "amount": 876138,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000002",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000003.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000003",
+  "name": "Cash (Checking)",
+  "type": "checking",
+  "last_4": "4609",
+  "balance": {
+    "amount": 8711697,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000003",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000004.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000004",
+  "name": "Treasury Checking",
+  "type": "checking",
+  "last_4": "7301",
+  "balance": {
+    "amount": 15460929,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000004",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000005.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000005",
+  "name": "Inventory Checking",
+  "type": "checking",
+  "last_4": "3608",
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000005",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000006.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000006",
+  "name": "Primary Checking",
+  "type": "checking",
+  "last_4": "5702",
+  "balance": {
+    "amount": 811970,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000006",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000007.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000007",
+  "name": "Credit Account",
+  "type": "credit",
+  "last_4": null,
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000007",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000008.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000008",
+  "name": "Credit Account",
+  "type": "credit",
+  "last_4": null,
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000008",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000009.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000009",
+  "name": "Credit Account",
+  "type": "credit",
+  "last_4": null,
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000009",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000010.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000010",
+  "name": "Credit Account",
+  "type": "credit",
+  "last_4": null,
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000010",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000011.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000011",
+  "name": "Rewards",
+  "type": "rewards",
+  "last_4": null,
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000011",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000012.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000012",
+  "name": "Rewards",
+  "type": "rewards",
+  "last_4": null,
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000012",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000013.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000013",
+  "name": "Savings",
+  "type": "savings",
+  "last_4": "3214",
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000013",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/30000000-0000-4000-8000-000000000014.json

@@ -0,0 +1,12 @@
+{
+  "id": "30000000-0000-4000-8000-000000000014",
+  "name": "Savings",
+  "type": "savings",
+  "last_4": "2513",
+  "balance": {
+    "amount": 0,
+    "currency": "USD"
+  },
+  "source": "rho-sandbox:account:30000000-0000-4000-8000-000000000014",
+  "synced_at": "2026-10-29T06:34:34.210Z"
+}

package/schema/examples/workspace/ventures/acme-labs/money/_streams/transactions/stream.json

@@ -0,0 +1,5 @@
+{
+  "id": "transactions",
+  "sensitive": true,
+  "summary": "Every transaction rho-sandbox posted, one file each, as Rho returned it; Rho is the system of record. The versioned view is money/_summary.json."
+}

package/schema/examples/workspace/ventures/acme-labs/money/_summary.json

@@ -0,0 +1,30 @@
+{
+  "source": "rho-sandbox",
+  "business": "Acme Corporation",
+  "synced_at": "2026-10-29T06:34:34.210Z",
+  "as_of": "2026-06-27T19:13:15Z",
+  "window": {
+    "from": "2026-03-29T19:13:15.000Z",
+    "to": "2026-06-27T19:13:15Z"
+  },
+  "cash": {
+    "amount": 25861780,
+    "currency": "USD"
+  },
+  "monthly_inflow": {
+    "amount": 3423939,
+    "currency": "USD"
+  },
+  "monthly_outflow": {
+    "amount": 716423,
+    "currency": "USD"
+  },
+  "monthly_net": {
+    "amount": 2707516,
+    "currency": "USD"
+  },
+  "runway_months": null,
+  "accounts": 14,
+  "transactions": 72,
+  "note": "Net cash flow is not negative in the window, so runway is not limited by burn."
+}

package/schema/examples/workspace/ventures/acme-labs/operations/departments/customer-service/README.md

@@ -0,0 +1,5 @@
+# Customer service: operations
+
+Holds: Support channels, help content, customer feedback.
+
+APQC 6.0 Manage Customer Service; value chain: primary (service).

package/schema/examples/workspace/ventures/acme-labs/operations/departments/customer-service/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "customer-service",
+  "value_chain": "primary",
+  "apqc": "6.0"
+}

package/schema/examples/workspace/ventures/acme-labs/operations/departments/finance/README.md

@@ -0,0 +1,5 @@
+# Finance and accounting: operations
+
+Holds: Books, invoices, budgets and tax.
+
+APQC 9.0 Manage Financial Resources; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/acme-labs/operations/departments/finance/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "finance",
+  "value_chain": "support",
+  "apqc": "9.0"
+}

package/schema/examples/workspace/ventures/acme-labs/operations/departments/human-capital/README.md

@@ -0,0 +1,5 @@
+# Human capital (HR): operations
+
+Holds: Recruiting, onboarding, payroll runs.
+
+APQC 7.0 Develop and Manage Human Capital; value chain: support (human resource management).

package/schema/examples/workspace/ventures/acme-labs/operations/departments/human-capital/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "human-capital",
+  "value_chain": "support",
+  "apqc": "7.0"
+}

package/schema/examples/workspace/ventures/acme-labs/operations/departments/it/README.md

@@ -0,0 +1,5 @@
+# Information technology: operations
+
+Holds: Accounts, integrations, devices and access.
+
+APQC 8.0 Manage Information Technology (IT); value chain: support (technology development).

package/schema/examples/workspace/ventures/acme-labs/operations/departments/it/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "it",
+  "value_chain": "support",
+  "apqc": "8.0"
+}

package/schema/examples/workspace/ventures/acme-labs/operations/departments/marketing-and-sales/README.md

@@ -0,0 +1,5 @@
+# Marketing and sales: operations
+
+Holds: The marketing website (EE-044), campaigns, marketing assets, the sales pipeline.
+
+APQC 3.0 Market and Sell Products and Services; value chain: primary (marketing and sales).

package/schema/examples/workspace/ventures/acme-labs/operations/departments/marketing-and-sales/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "marketing-and-sales",
+  "value_chain": "primary",
+  "apqc": "3.0"
+}

package/schema/examples/workspace/ventures/acme-labs/operations/departments/products/README.md

@@ -0,0 +1,5 @@
+# Products and services: operations
+
+Holds: Specs, roadmaps and the work of building (MAD, for software).
+
+APQC 2.0 Develop and Manage Products and Services; value chain: primary (technology development).

package/schema/examples/workspace/ventures/acme-labs/operations/departments/products/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "products",
+  "value_chain": "primary",
+  "apqc": "2.0"
+}

package/schema/examples/workspace/ventures/acme-labs/operations/departments/strategy/README.md

@@ -0,0 +1,5 @@
+# Strategy: operations
+
+Holds: Planning cadence, market research.
+
+APQC 1.0 Develop Vision and Strategy; value chain: support (firm infrastructure).

package/schema/examples/workspace/ventures/acme-labs/operations/departments/strategy/department.json

@@ -0,0 +1,5 @@
+{
+  "department": "strategy",
+  "value_chain": "support",
+  "apqc": "1.0"
+}