naive-framework 0.1.0 → 0.3.0

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/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/northstar/portfolio/kilnworks/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/northstar/portfolio/kilnworks/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/northstar/portfolio/kilnworks/operations/departments/products/department.json

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

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/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/northstar/portfolio/kilnworks/operations/departments/strategy/department.json

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

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/brand.md

@@ -0,0 +1,5 @@
+# Brand pillar
+
+How the venture is known: its name, voice, promise wording and visual identity.
+
+Guide: [brand pillar](../../../../../../../../governance/venture-template/pillars/brand.md)

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/business.md

@@ -0,0 +1,5 @@
+# Business pillar
+
+How the venture sustains itself: business models, pricing, costs, legal form and funding.
+
+Guide: [business pillar](../../../../../../../../governance/venture-template/pillars/business.md)

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/pillars/product.md

@@ -0,0 +1,5 @@
+# Product pillar
+
+What the venture makes: its core product (in venture.json), its products (in products/), and what each needs to be specified, built, shipped and operated.
+
+Guide: [product pillar](../../../../../../../../governance/venture-template/pillars/product.md)

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.core-product.decision.json

@@ -0,0 +1,28 @@
+{
+  "id": "core-product",
+  "parent": "product-exists",
+  "question": "What is the core product: what anyone can claim from this venture, who it is promised to, what it must never deliver, and the competence that makes it deliverable?",
+  "decides": {
+    "record": "venture",
+    "path": "venture.json"
+  },
+  "unlocks": [
+    {
+      "activity": "Judge the products against the core (Product Anatomy)",
+      "routes": [
+        "purpose/anatomy-input/*",
+        "purpose/anatomy-answers"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "discovery",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.exists.decision.json

@@ -0,0 +1,32 @@
+{
+  "id": "product-exists",
+  "question": "Does a product already exist (in use, for sale, a prototype or a pilot), or is the venture still an idea?",
+  "decides": {
+    "record": "product",
+    "path": "products/"
+  },
+  "statement": "products",
+  "options": [
+    "Yes: one or more products exist",
+    "Partly: a prototype or pilot exists",
+    "No: it is still an idea"
+  ],
+  "unlocks": [
+    {
+      "activity": "Write product cards for what exists or is planned",
+      "routes": [
+        "purpose/product/*"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "discovery",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/products/decisions/product.flagship.decision.json

@@ -0,0 +1,27 @@
+{
+  "id": "flagship",
+  "parent": "core-product",
+  "question": "Which product is the flagship now: the one that best delivers the core promise?",
+  "decides": {
+    "record": "product",
+    "path": "products/"
+  },
+  "unlocks": [
+    {
+      "activity": "Plan how to validate the flagship",
+      "routes": [
+        "purpose/validation/solution"
+      ]
+    }
+  ],
+  "layer": "purpose",
+  "boundary": "fail-closed",
+  "needed_in": "discovery",
+  "status": "open",
+  "provenance": {
+    "drafted_by": {
+      "kind": "framework",
+      "id": "naive"
+    }
+  }
+}

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/profile.md

@@ -0,0 +1,5 @@
+# kilnworks
+
+What this venture is, in a few sentences. Its machine fields are in venture.json (EE-011).
+
+## Changelog

package/schema/examples/workspace/ventures/northstar/portfolio/kilnworks/venture.json

@@ -0,0 +1,27 @@
+{
+  "id": "kilnworks",
+  "name": "kilnworks",
+  "type": "software-startup",
+  "parent": "northstar",
+  "phase": "discovery",
+  "owner": "self",
+  "status": "active",
+  "profile": "profile.md",
+  "layers": {
+    "purpose": false,
+    "knowledge": {
+      "location": "knowledge/"
+    },
+    "operations": false,
+    "evidence": false
+  },
+  "departments": [
+    "strategy",
+    "products",
+    "marketing-and-sales",
+    "customer-service",
+    "human-capital",
+    "it",
+    "finance"
+  ]
+}

package/schema/examples/workspace/ventures/northstar/profile.md

@@ -0,0 +1,5 @@
+# northstar
+
+What this venture is, in a few sentences. Its machine fields are in venture.json (EE-011).
+
+## Changelog

package/schema/examples/workspace/ventures/northstar/provenance.jsonl

@@ -0,0 +1,3 @@
+{"at":"2026-10-29T05:51:45.173Z","entity":"people/founders/ana-ruiz.json","route":"people/founders/ana-ruiz","activity":"write","agent":{"kind":"person","via":"cli","id":"ana-ruiz"},"note":"Ana Ruiz, general-partner, as answered at create-venture","sha256":"d7c4f1ba5608dc88a46a08c6a65efe7de090cf41875fbe990a8ea4974a13ef7d","prev":"genesis","hash":"da61087eaffa48394c6c4aa1bf22492c66f618fc088be798c05732e1e42a5e4b"}
+{"at":"2026-10-29T05:51:45.174Z","entity":"people/founders/ben-okafor.json","route":"people/founders/ben-okafor","activity":"write","agent":{"kind":"person","via":"cli","id":"ana-ruiz"},"note":"Ben Okafor, general-partner, as answered at create-venture","sha256":"f7a91c21c45ed11b0f2444d9cbdef6b63d2078ed59808e00c0797097d4a0d631","prev":"da61087eaffa48394c6c4aa1bf22492c66f618fc088be798c05732e1e42a5e4b","hash":"04db571364b36d0d2b1a9dda24145e1718688106f3ed8f94d681efb60c398f6d"}
+{"at":"2026-10-29T05:51:45.174Z","entity":"people/people.json","route":"people","activity":"write","agent":{"kind":"person","via":"cli","id":"ana-ruiz"},"note":"team: Ana Ruiz (general-partner), Ben Okafor (general-partner)","sha256":"55b93788772996b7c077d62e23c0c3adde60f8d999dafb559c0c2602709d9a13","prev":"04db571364b36d0d2b1a9dda24145e1718688106f3ed8f94d681efb60c398f6d","hash":"4acf7b3e96494b22e222bd9dd4b0b021103c0aab2432a122db0b926f478a279b"}

package/schema/examples/workspace/ventures/northstar/purpose/README.md

@@ -0,0 +1,3 @@
+# purpose
+
+Why this venture exists: its core product, products and the Product Anatomy matrix.

package/schema/examples/workspace/ventures/northstar/venture.json

@@ -0,0 +1,49 @@
+{
+  "id": "northstar",
+  "name": "Northstar Climate Fund",
+  "type": "vc-fund",
+  "parent": null,
+  "phase": "validation",
+  "form": {
+    "funding": "mixed"
+  },
+  "core": {
+    "promise": "",
+    "promised_to": "",
+    "must_not": "",
+    "competence": ""
+  },
+  "owner": "self",
+  "status": "active",
+  "profile": "profile.md",
+  "layers": {
+    "purpose": {
+      "location": "purpose/"
+    },
+    "knowledge": {
+      "location": "knowledge/"
+    },
+    "operations": {
+      "location": "operations/"
+    },
+    "evidence": {
+      "location": "evidence/"
+    },
+    "governance": {
+      "location": "governance/"
+    }
+  },
+  "departments": [
+    "strategy",
+    "finance",
+    "external-relationships",
+    "risk-and-compliance",
+    "human-capital"
+  ],
+  "members": [
+    {
+      "role": "partner",
+      "kind": "person"
+    }
+  ]
+}

package/schema/foundation.mjs

@@ -15,6 +15,7 @@
 
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 const repo = new URL("..", import.meta.url).pathname;
 const load = (f) => JSON.parse(readFileSync(f, "utf8"));
@@ -30,15 +31,15 @@ export function filesOf(dir, type) {
   const gs = (r?.paths ?? []).filter((p) => p.startsWith("instance/**/")).map((p) => p.slice("instance/**/".length));
   const found = [];
   for (const g of gs) {
-    if (!g.includes("*")) { if (existsSync(join(dir, g))) found.push(g); continue; }
+    if (!g.includes("*")) { if (existsSync(ventureFile(dir, g))) found.push(g); continue; }
     const star = g.indexOf("*");
     const folder = g.slice(0, star), rest = g.slice(star + 1);
     if (rest.includes("*")) continue;
-    const d = join(dir, folder);
+    const d = ventureFile(dir, folder);
     if (existsSync(d)) for (const f of readdirSync(d)) if (f.endsWith(rest)) found.push(folder + f);
   }
   if (found.length) return found;
-  const drafted = gs.filter((g) => !g.includes("*") && existsSync(join(dir, `_drafts/${g.replace(/\//g, "__")}.draft`)));
+  const drafted = gs.filter((g) => !g.includes("*") && existsSync(ventureFile(dir, `_drafts/${g.replace(/\//g, "__")}.draft`)));
   return drafted.length ? drafted : gs.slice(0, 1);
 }
 
@@ -47,7 +48,7 @@ export function filesOf(dir, type) {
 export function confirmedIn(dir, file, id, seen = new Set()) {
   if (seen.has(file)) return false;
   seen.add(file);
-  const log = join(dir, "provenance.jsonl");
+  const log = join(ventureFile(dir, "provenance.jsonl"));
   if (!existsSync(log)) return false;
   const draft = `_drafts/${file.replace(/\//g, "__")}.draft`;
   const es = readFileSync(log, "utf8").split("\n").filter(Boolean).map((l) => JSON.parse(l)).filter((e) => e.entity === file || e.entity === draft);
@@ -64,8 +65,8 @@ export function foundation(dir) {
     if (!s.record) return { id: s.id, status: "planned", note: s.note ?? null };
     const files = filesOf(dir, s.record);
     // A retired product no longer answers for the venture.
-    const values = files.filter((f) => existsSync(join(dir, f)) && load(join(dir, f)).status !== "retired").map((f) => ({ f, v: get(load(join(dir, f)), s.attribute) })).filter((x) => filled(x.v));
-    const drafts = files.filter((f) => existsSync(join(dir, `_drafts/${f.replace(/\//g, "__")}.draft`)));
+    const values = files.filter((f) => existsSync(ventureFile(dir, f)) && load(ventureFile(dir, f)).status !== "retired").map((f) => ({ f, v: get(load(ventureFile(dir, f)), s.attribute) })).filter((x) => filled(x.v));
+    const drafts = files.filter((f) => existsSync(ventureFile(dir, `_drafts/${f.replace(/\//g, "__")}.draft`)));
     if (!values.length) return { id: s.id, record: s.record, attribute: s.attribute, status: drafts.length ? "draft" : "missing" };
     // A record with no log entry existed before the log; a person's baseline or write confirms it.
     const confirmed = values.every(({ f }) => confirmedIn(dir, f, s.id));
@@ -87,7 +88,7 @@ export function foundation(dir) {
 
 export function problems(dir) {
   const out = FRAME.questions.flatMap((q) => q.statements).filter((s) => s.record && !MODEL.records.some((r) => r.id === s.record)).map((s) => `frame: ${s.id} names record type ${s.record}, which the data model lacks`);
-  const there = (...fs) => fs.map((f) => join(dir, f)).find((p) => existsSync(p));
+  const there = (...fs) => fs.map((f) => ventureFile(dir, f)).find((p) => existsSync(p));
   const icp = there("foundation/icp.json", "purpose/icp.json"), prob = there("foundation/problem.json", "purpose/validation/problem.json");
   if (icp) {
     const forms = new Set(existsSync(prob) ? (load(prob).forms ?? []).map((f) => f.id) : []);

package/schema/founder.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "founder.schema.json",
+  "title": "Founder",
+  "description": "One founder of the venture (people/founders/<id>.json): role, the functions they own, when they joined, and where their founder agreement is. One file per founder, so each founder's record changes on its own.",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "role",
+    "joined"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "name": {
+      "type": "string"
+    },
+    "role": {
+      "enum": [
+        "founder",
+        "co-founder",
+        "general-partner"
+      ]
+    },
+    "hats": {
+      "type": "array",
+      "items": {
+        "enum": [
+          "strategy",
+          "products",
+          "marketing-and-sales",
+          "supply-chain",
+          "service-delivery",
+          "customer-service",
+          "human-capital",
+          "it",
+          "finance",
+          "assets",
+          "risk-and-compliance",
+          "external-relationships",
+          "capabilities"
+        ]
+      },
+      "uniqueItems": true,
+      "description": "The functions this founder owns, in the flat layout. In the structured layout (EE-086) they are read from venture.json"
+    },
+    "joined": {
+      "type": "string",
+      "format": "date"
+    },
+    "agreement": {
+      "type": "object",
+      "required": [
+        "path",
+        "signed"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "signed": {
+          "type": "boolean"
+        }
+      }
+    }
+  }
+}

package/schema/frame.schema.json

@@ -0,0 +1,240 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "frame.schema.json",
+  "title": "Frame (decision library)",
+  "description": "One recurring venture problem, as a shape, at packages/<function>/frames/<id>.frame.json. A frame is to Naive what a component is to a React component library. It holds the goal, the decisions hidden in the founder's sentence, the premises that sentence assumes and the moves to attack them, and what current information a lookup must supply. It never holds an answer: no instrument, vendor, term or market norm, because those go stale and can be wrong. schema/frames.mjs matches a frame to the founder's words, reads the props from the venture's records, has a model judge each premise yes, no or unknown, and proposes the frame's decisions with open options for the founder to decide.",
+  "type": "object",
+  "required": [
+    "id",
+    "title",
+    "functions",
+    "triggers",
+    "goal",
+    "premises",
+    "attacks",
+    "reframe",
+    "props",
+    "freshness",
+    "reasoning",
+    "emits"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "title": {
+      "type": "string"
+    },
+    "functions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9-]+$"
+      },
+      "description": "The venture functions the problem belongs to; the first is the package the frame lives in"
+    },
+    "triggers": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string"
+      },
+      "description": "Sentences a founder says when they have this problem, in a founder's words"
+    },
+    "goal": {
+      "type": "string",
+      "description": "The end the decisions serve; {prop} placeholders are filled from the venture"
+    },
+    "premises": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "claim",
+          "attack"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "claim": {
+            "type": "string",
+            "description": "What the founder's sentence assumes, as a yes/no proposition about this venture"
+          },
+          "attack": {
+            "type": "string",
+            "description": "The premise attack applied to it, one of schema/frames.mjs ATTACKS"
+          },
+          "reads": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The props the judgment of this premise needs"
+          }
+        }
+      },
+      "description": "The chain the founder's sentence assumes, in order"
+    },
+    "attacks": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string"
+      },
+      "description": "The premise attacks the frame uses (the hooks of the library)"
+    },
+    "dichotomy": {
+      "type": "string",
+      "description": "The trade the founder's sentence forces, asked as: is it false, a real trade-off, or a sequence?"
+    },
+    "reframe": {
+      "type": "string",
+      "description": "The better question the frame leaves the founder with; {prop} placeholders are filled from the venture"
+    },
+    "composes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Smaller frames this one is built from"
+    },
+    "props": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "The venture facts the frame reads, never stores: phase, goal, runway, revenue, cap_table, jurisdiction, control_rights"
+    },
+    "freshness": {
+      "type": "object",
+      "required": [
+        "look_for",
+        "max_age_days",
+        "cite"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "look_for": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          },
+          "description": "What a lookup must find, described as a problem, never as a named answer"
+        },
+        "filter_by": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "max_age_days": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "cite": {
+          "type": "boolean",
+          "const": true
+        }
+      },
+      "description": "What current information the frame needs and how fresh it must be. The lookup itself is a kit's skill; the frame says only what to look for."
+    },
+    "reasoning": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string"
+      },
+      "description": "What a model that fetches the frame must do, in order"
+    },
+    "emits": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "question"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "question": {
+            "type": "string"
+          },
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Options that describe the problem's own parts, never a named answer; options from a lookup are added at run time with their date and source"
+          },
+          "options_from": {
+            "enum": [
+              "frame",
+              "lookup"
+            ],
+            "default": "frame"
+          },
+          "layer": {
+            "enum": [
+              "purpose",
+              "knowledge",
+              "operations",
+              "evidence",
+              "governance",
+              "interface"
+            ]
+          },
+          "needed_in": {
+            "enum": [
+              "discovery",
+              "validation",
+              "beachhead",
+              "scale",
+              "platform"
+            ]
+          }
+        }
+      },
+      "description": "The decisions the frame proposes, each open for the founder to decide"
+    },
+    "cases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "facts",
+          "expect"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "facts": {
+            "type": "object",
+            "description": "The props of a worked venture"
+          },
+          "expect": {
+            "type": "object",
+            "description": "The premise verdicts and dichotomy a good judgment reaches for these facts"
+          }
+        }
+      },
+      "description": "Worked cases, to evaluate a model's judgments against"
+    }
+  }
+}