naive-framework 0.1.0 → 0.2.0

package/operations/layer.json

@@ -23,7 +23,11 @@
     "marketing-matrix",
     "site-presence",
     "marketing-sitemap",
-    "marketing-content"
+    "marketing-content",
+    "people",
+    "founder",
+    "marketing-brand",
+    "public-assets"
   ],
   "reads": [
     "agent-capability",
@@ -37,7 +41,8 @@
     "publication-policy",
     "role",
     "telos",
-    "venture"
+    "venture",
+    "raw-source"
   ],
   "writes": [
     "evidence"
@@ -50,7 +55,9 @@
     "schema/check-departments.mjs",
     "operations/marketing/site/presence.mjs",
     "operations/marketing/site/plan.mjs",
-    "operations/marketing/check-public.mjs"
+    "operations/marketing/check-public.mjs",
+    "schema/check-brand.mjs",
+    "schema/check-assets.mjs"
   ],
   "gaps": [
     "No run-handoff skill: the handoff contract is prose (operations/handoff-v2.md) beside three scripts in schema/ (check-ready, run-handoff, check-execution)",

package/operations/templates/marketing-brand.md

@@ -0,0 +1,46 @@
+---
+type: template
+tags: [everything-ecosystem, operations, marketing, brand, template]
+ai-model: claude-opus-5.5
+created: 2026-10-29T06:04:07Z
+source: hybrid
+---
+
+# Template: brand
+
+Fills `<venture>/marketing/brand.json` (`schema/marketing-brand.schema.json`). The brand is the venture's global stylesheet: every agent's layout carries its voice and fonts, and `marketing/brand/tokens` renders it as design tokens and CSS for any interface. Check it with `mentura marketing/brand check`.
+
+```json
+{
+  "version": "0.1.0",
+  "venture": "<venture id>",
+  "name": "<the name as the brand writes it>",
+  "colors": { "accent": "#1d4e89", "ink": "#111111", "paper": "#ffffff" },
+  "typefaces": [
+    { "id": "inter", "family": "Inter", "source": "self-hosted", "license": "OFL-1.1", "files": ["public/fonts/inter.woff2"], "fallback": ["system-ui", "sans-serif"] }
+  ],
+  "fonts": { "body": "inter", "heading": "inter" },
+  "voice": {
+    "tone": ["plain", "warm"],
+    "rules": [{ "id": "no-jargon", "avoid": ["synergy", "leverage"], "use": "work with", "why": "our customers do not talk like this" }]
+  },
+  "marks": [
+    { "kind": "logo", "asset": "public/logo.svg" },
+    { "kind": "icon", "asset": "public/icon.svg" },
+    { "kind": "apple-icon", "asset": "public/apple-icon.png" },
+    { "kind": "favicon", "asset": "public/favicon.ico" }
+  ],
+  "design_systems": [{ "id": "radix", "name": "Radix Colors", "url": "https://www.radix-ui.com/colors", "version": "3.0.0", "license": "MIT", "uses": ["the blue scale"] }],
+  "scopes": [{ "for": "investors", "colors": { "accent": "#000000" }, "voice": { "tone": ["direct"] } }]
+}
+```
+
+## What each part means
+
+- **Colors** are hex values by token name.
+- **Typefaces** are defined once, each with its license. A self-hosted face names its files in `public/`, each registered in `public/assets.json` under the same license. A remote face fails the check: every reader's browser would call another host.
+- **Fonts** assign a typeface to a role everywhere. A scope can assign a different one under a route prefix.
+- **Voice** is the stylesheet for words: the tone, and phrases the venture never uses, with what to use instead.
+- **Marks** are the logo and icons. An apple-icon is a 180x180 PNG, an icon is square, a favicon is an ICO.
+- **Design systems** are linked, never copied in.
+- **Scopes** override the brand for a route prefix. The nearer scope wins.

package/operations/templates/public-assets.md

@@ -0,0 +1,39 @@
+---
+type: template
+tags: [everything-ecosystem, operations, marketing, assets, template]
+ai-model: claude-opus-5.5
+created: 2026-10-29T06:04:07Z
+source: hybrid
+---
+
+# Template: public assets
+
+Fills `<venture>/public/assets.json` (`schema/public-assets.schema.json`), the register of what the venture ships as it is. Do not write it by hand: `mentura assets add` registers a file and code fills its facts; `mentura assets fill` refreshes them. Check it with `mentura public/assets check`.
+
+```json
+{
+  "version": "0.1.0",
+  "remote_hosts": ["images.example.com"],
+  "assets": [
+    {
+      "path": "public/logo.svg",
+      "source": "Acme design",
+      "license": "owned",
+      "credit": "Acme",
+      "alt": { "text": "Acme wordmark", "by": "agent" },
+      "facts": { "type": "svg", "width": 200, "height": 60, "bytes": 812, "sha256": "<filled by code>" }
+    }
+  ],
+  "remote": [
+    { "id": "images-example-com-clinic", "url": "https://images.example.com/clinic.jpg", "license": "all-rights-reserved", "credit": "Ana Photo" }
+  ]
+}
+```
+
+## The rules the check holds
+
+- Every file in `public/` has an entry with a source, a license and a credit.
+- Facts are read from the file by code. An entry whose facts differ from the file fails.
+- An image needs alt text unless it is marked decorative. Alt text an agent wrote is pending until a person confirms it with `mentura assets confirm`.
+- A remote image is a link with a note in `raw/sources/<id>/`. A full copy in `public/` needs a license that allows one.
+- `remote_hosts` lists the hosts an agent may fetch from.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "naive-framework",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Naive, a venture development framework: conventions, routes, records, checks and an agent interface for building a venture.",
   "type": "module",
   "license": "MIT",
@@ -47,6 +47,8 @@
     "!**/*.pem",
     "!**/*.key",
     "!**/_private/",
+    "!**/_internal/",
+    "!platform/agents/",
     "!**/.DS_Store"
   ],
   "keywords": [

package/packages/catalog.json

@@ -74,6 +74,14 @@
         "marketing-sitemap"
       ]
     },
+    "public-assets": {
+      "after": []
+    },
+    "marketing-brand": {
+      "after": [
+        "public-assets"
+      ]
+    },
     "site-presence": {
       "after": []
     },

package/packages/customers/package.json

@@ -16,6 +16,26 @@
   "templates": [],
   "checks": ["schema/check-data-packages.mjs"],
   "skill": null,
-  "use_model": [],
+  "use_model": [
+    {
+      "step": "stage",
+      "kind": "choice",
+      "for_each": "customers",
+      "question": "Which buying stage do the notes {item.notes} put this customer at?",
+      "inputs": ["item.notes"],
+      "options": ["aware", "trying", "paying", "gone"],
+      "threshold": 0.7
+    },
+    {
+      "step": "summary",
+      "kind": "draft",
+      "for_each": "customers",
+      "after": ["stage"],
+      "question": "Write one plain sentence about this customer from the notes {item.notes} and the stage {steps.stage}, with the seat count written as {{seats}}.",
+      "inputs": ["item.notes"],
+      "computed": { "seats": { "item": "seats" } },
+      "keep": ["seats"]
+    }
+  ],
   "complete": false
 }

package/packages/deals/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "deals",
+  "title": "Deals",
+  "kind": "data",
+  "purpose": "A fund's pipeline: one [id].json per company, from sourced to invested or passed (EE-082). An investment becomes a nested venture under portfolio/. Never complete.",
+  "required": [],
+  "optional": [],
+  "refs": [
+    "fund-thesis"
+  ],
+  "gates": [
+    "coverage",
+    "freshness"
+  ],
+  "layer": "purpose",
+  "records": [
+    "deal"
+  ],
+  "schemas": [
+    "schema/deal.schema.json"
+  ],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": [],
+  "complete": false
+}

package/packages/decisions/package.json

@@ -13,5 +13,16 @@
   "templates": [],
   "checks": [],
   "skill": null,
-  "use_model": []
+  "use_model": [],
+  "use_cache": [
+    {
+      "route": "governance/decisions",
+      "level": "record",
+      "life": "minutes",
+      "vary": [
+        "hour",
+        "env:DECISIONS_NOW"
+      ]
+    }
+  ]
 }

package/packages/finance/frames/fund-without-ceding-control.frame.json

@@ -0,0 +1,177 @@
+{
+  "id": "fund-without-ceding-control",
+  "title": "Fund growth without ceding control",
+  "functions": [
+    "finance",
+    "governance"
+  ],
+  "triggers": [
+    "I need investors to scale but I don't want to give up control",
+    "I want to raise money without losing control of my company",
+    "I need funding but I don't want to give away equity",
+    "I don't want investors telling me what to do"
+  ],
+  "goal": "{goal}",
+  "premises": [
+    {
+      "id": "needs-outside-money",
+      "claim": "Reaching the venture's goal needs outside money now, beyond what revenue, customers or partners can fund within the current runway.",
+      "attack": "test-the-goal",
+      "reads": [
+        "goal",
+        "phase",
+        "revenue",
+        "runway"
+      ]
+    },
+    {
+      "id": "money-means-ownership",
+      "claim": "For this venture, taking outside money means selling ownership.",
+      "attack": "split-the-dimension",
+      "reads": [
+        "phase",
+        "revenue",
+        "jurisdiction"
+      ]
+    },
+    {
+      "id": "ownership-means-control",
+      "claim": "For this venture, giving up ownership means giving up control.",
+      "attack": "split-the-dimension",
+      "reads": [
+        "cap_table",
+        "control_rights"
+      ]
+    },
+    {
+      "id": "control-is-one-thing",
+      "claim": "The control the founder wants to keep is one thing, not several separate rights.",
+      "attack": "name-the-control",
+      "reads": [
+        "control_rights"
+      ]
+    }
+  ],
+  "attacks": [
+    "test-the-goal",
+    "split-the-dimension",
+    "name-the-control",
+    "false-dichotomy",
+    "sequence-not-choose"
+  ],
+  "dichotomy": "Take outside money and lose control, or keep control and grow more slowly.",
+  "reframe": "With the goal \"{goal}\", which ways of funding it keep the specific control rights the founder will not give up, in the {phase} phase?",
+  "composes": [
+    "which-control-matters",
+    "fund-growth-how"
+  ],
+  "props": [
+    "phase",
+    "goal",
+    "revenue",
+    "runway",
+    "cap_table",
+    "control_rights",
+    "jurisdiction"
+  ],
+  "freshness": {
+    "look_for": [
+      "funding structures that separate money from ownership",
+      "structures that separate ownership from votes, board seats or vetoes"
+    ],
+    "filter_by": [
+      "jurisdiction",
+      "phase",
+      "revenue"
+    ],
+    "max_age_days": 180,
+    "cite": true
+  },
+  "reasoning": [
+    "Restate the goal and the decisions hidden in the founder's sentence before proposing anything.",
+    "Test each premise as a yes/no proposition against the venture's facts; say unknown when the facts do not settle it.",
+    "Say whether the trade is false, a real trade-off, or a sequence.",
+    "Draw funding options only from a dated, cited lookup, never from memory.",
+    "Return decisions with open options. Do not pick one."
+  ],
+  "emits": [
+    {
+      "id": "which-control-matters",
+      "question": "Which control rights will the founder not give up?",
+      "options": [
+        "the product's direction",
+        "votes on major decisions",
+        "board seats",
+        "vetoes over a sale or new money",
+        "day-to-day authority to run the venture",
+        "the mission"
+      ],
+      "layer": "governance",
+      "needed_in": "discovery"
+    },
+    {
+      "id": "fund-growth-how",
+      "question": "Which way of funding the goal keeps the control rights the founder will not give up?",
+      "options_from": "lookup",
+      "layer": "governance",
+      "needed_in": "validation"
+    }
+  ],
+  "cases": [
+    {
+      "id": "solo-saas-pre-revenue",
+      "facts": {
+        "phase": "discovery",
+        "goal": "ten paying clinics by June",
+        "revenue": "none",
+        "runway": "4 months of the founder's savings",
+        "cap_table": "the founder owns 100%",
+        "control_rights": "the product's direction",
+        "jurisdiction": "Texas, USA"
+      },
+      "expect": {
+        "needs-outside-money": "unknown",
+        "money-means-ownership": "unknown",
+        "ownership-means-control": "no",
+        "control-is-one-thing": "yes",
+        "dichotomy": "sequence"
+      }
+    },
+    {
+      "id": "services-firm-profitable",
+      "facts": {
+        "phase": "beachhead",
+        "goal": "open a second office",
+        "revenue": "profitable, 30% margins",
+        "runway": "18 months from cash flow",
+        "cap_table": "two founders, 50/50",
+        "control_rights": "day-to-day authority and the timing of a sale",
+        "jurisdiction": "Ontario, Canada"
+      },
+      "expect": {
+        "needs-outside-money": "no",
+        "money-means-ownership": "unknown",
+        "ownership-means-control": "no",
+        "control-is-one-thing": "no",
+        "dichotomy": "false"
+      }
+    },
+    {
+      "id": "hardware-pre-revenue-board",
+      "facts": {
+        "phase": "validation",
+        "goal": "ship 500 units of a medical device through regulatory approval by 2028",
+        "revenue": "none",
+        "runway": "2 months",
+        "cap_table": "the founder owns 100%",
+        "control_rights": "a majority of the board and votes on every major decision",
+        "jurisdiction": "Delaware, USA"
+      },
+      "expect": {
+        "needs-outside-money": "yes",
+        "control-is-one-thing": "no",
+        "dichotomy": "trade-off"
+      }
+    }
+  ]
+}

package/packages/foundation/package.json

@@ -48,5 +48,12 @@
     "schema/foundation.mjs"
   ],
   "skill": null,
-  "use_model": []
+  "use_model": [],
+  "use_cache": [
+    {
+      "route": "purpose/foundation",
+      "level": "record",
+      "life": "hours"
+    }
+  ]
 }

package/packages/fund/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "fund",
+  "title": "Fund",
+  "kind": "core",
+  "purpose": "A fund's foundation: the thesis it invests on and the terms it raises under (EE-082). The VC fund venture type starts with it; a startup never needs it.",
+  "department": "finance",
+  "layer": "purpose",
+  "records": [
+    "fund-thesis",
+    "fund-terms"
+  ],
+  "required": [
+    "fund-thesis",
+    "fund-terms"
+  ],
+  "optional": [],
+  "refs": [],
+  "planned": [],
+  "base": {
+    "discovery": 0.0,
+    "validation": 0.0,
+    "beachhead": 0.0,
+    "scale": 0.0,
+    "platform": 0.0
+  },
+  "when": [
+    {
+      "if": "type:vc-fund",
+      "at_least": 0.9
+    }
+  ],
+  "why": "Only a fund or firm raises on a thesis and terms",
+  "unlocks": [
+    "raising from limited partners",
+    "screening deals against the thesis"
+  ],
+  "gates": [
+    "a person has confirmed the thesis and the terms"
+  ],
+  "schemas": [
+    "schema/fund-thesis.schema.json",
+    "schema/fund-terms.schema.json"
+  ],
+  "templates": [],
+  "checks": [],
+  "skill": null,
+  "use_model": []
+}

package/packages/marketing/package.json

@@ -9,14 +9,15 @@
   ],
   "optional": [
     "marketing-content",
-    "site-presence"
+    "site-presence",
+    "marketing-brand",
+    "public-assets"
   ],
   "refs": [
     "icp",
     "product"
   ],
   "planned": [
-    "brand voice and guidelines",
     "campaigns",
     "sales pipeline"
   ],
@@ -48,10 +49,15 @@
   ],
   "schemas": [
     "schema/marketing-sitemap.schema.json",
-    "schema/site-presence.schema.json"
+    "schema/site-presence.schema.json",
+    "schema/marketing-brand.schema.json",
+    "schema/public-assets.schema.json"
   ],
   "templates": [],
-  "checks": [],
+  "checks": [
+    "schema/check-brand.mjs",
+    "schema/check-assets.mjs"
+  ],
   "skill": null,
   "use_model": []
 }

package/packages/money/package.json

@@ -10,11 +10,32 @@
     "coverage",
     "freshness"
   ],
+  "gate_rules": [
+    {
+      "id": "money-to-finance",
+      "routes": [
+        "money/[id]"
+      ],
+      "actors": [
+        "agent"
+      ],
+      "then": "owner",
+      "note": "Money master data an agent writes goes to the finance function's owner before it is the record"
+    }
+  ],
   "layer": "purpose",
-  "records": ["money-account"],
-  "schemas": ["schema/data-master.schema.json"],
+  "records": [
+    "money-account",
+    "money-summary"
+  ],
+  "schemas": [
+    "schema/data-master.schema.json",
+    "schema/money-summary.schema.json"
+  ],
   "templates": [],
-  "checks": ["schema/check-data-packages.mjs"],
+  "checks": [
+    "schema/check-data-packages.mjs"
+  ],
   "skill": null,
   "use_model": [],
   "complete": false

package/packages/validation/package.json

@@ -42,6 +42,9 @@
   "gates": [
     "a person has confirmed every required record and every record this package reads"
   ],
+  "gate_rules": [
+    { "id": "validation-low-confidence", "routes": ["validation/**", "foundation/problem", "people/team"], "actors": ["agent"], "when": { "confidence_below": "confidence" }, "then": "owner", "note": "A validation record an agent is not confident in goes to its function owner" }
+  ],
   "schemas": [
     "schema/validation-problem.schema.json",
     "schema/validation-solution.schema.json",
@@ -72,6 +75,16 @@
     "path": "purpose/kits/validation/skills/problem-validation/SKILL.md"
   },
   "use_model": [],
+  "use_cache": [
+    {
+      "route": "purpose/validation/assess",
+      "level": "record",
+      "life": "hours",
+      "vary": [
+        "day"
+      ]
+    }
+  ],
   "layer": "purpose",
   "records": [
     "validation-problem",

package/platform/README.md

@@ -39,6 +39,12 @@ The framework can still load a platform connector by the module path in `knowled
 | `integrations/langsmith-docket.mjs` | The docket's evidence as a LangSmith experiment: the scenario states as a dataset, and one scored run of the docket and the judge (Jev) as an experiment over it (EE-075). Needs `LANGSMITH_API_KEY` |
 | `integrations/rho.mjs` | Rho, the founder's bank and spend suite, as the venture's money source: syncs `money/` (accounts, a sensitive append-only transactions stream, and a summary) over Rho's MCP server, calling only read-only tools (EE-070). Rho's sandbox by default; `--live` needs `RHO_API_TOKEN` |
 | `integrations/site.mjs` | Reads a venture's website: the home page and the pages it links to, as text, with where each sits (EE-062). Uses `FIRECRAWL_API_KEY` when set, a plain fetch otherwise |
+| `adapter.json` | Mentura as Naive's first adapter, as Vercel is for Next.js: `mentura adapters verify mentura` runs the connector contract suite, the webhooks and the kits (Z-4) |
+| `kits/agent-upgrade/` | The agent-run upgrade behind `naive upgrade --agent`: an agent does the guides' by-hand steps on a staged copy, and the framework's checks decide (U-3). `stand-in-agent.mjs` runs offline |
+| `kits/validation-kickoff/` | An automation over the validation package: once the foundation is complete, it proposes the decision to start validating (M-12) |
+| `kits/test.mjs` | Tests for the kits, with the stand-in agent |
+| `webhooks/server.mjs` | Signed webhooks from systems of record: a change marks the summaries that read it stale (V-9). Secrets come from `NAIVE_WEBHOOK_SECRET_<SOURCE>` |
+| `webhooks/test.mjs` | Tests for the webhooks, offline |
 
 ## Not yet moved
 

package/platform/adapter.json

@@ -0,0 +1,15 @@
+{
+  "name": "mentura",
+  "title": "Mentura",
+  "kind": "platform",
+  "reads": ["knowledge/sources.json", "naive.config.json"],
+  "files": [],
+  "skills": null,
+  "verify": [
+    "platform/connectors/eval.mjs",
+    "platform/webhooks/test.mjs",
+    "platform/kits/test.mjs"
+  ],
+  "sources": [],
+  "note": "Mentura is Naive's first adapter, as Vercel is for Next.js (Z-4): it runs the framework's record contract over vendor sources (GitHub), receives systems of record's change notifications (webhooks) and holds the kits. It is verified when it passes the framework's tests: the connector contract suite (knowledge/connectors/suite.mjs) and the router over a GitHub source, both run by platform/connectors/eval.mjs, and the platform's tests of the framework hooks it implements."
+}