naive-framework 0.2.0 → 0.4.0

package/operations/marketing/site/plan.mjs

@@ -19,6 +19,7 @@
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { customerNeeds, factsOf, MATRIX, needs, typesOf, weights } from "./presence.mjs";
+import { ventureFile } from "../../../schema/venture-paths.mjs";
 
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
 export const SITEMAP = "operations/marketing/sitemap.json";
@@ -33,10 +34,10 @@ const RECORD_FILE = { venture: "venture.json", icp: "purpose/icp.json", "validat
 
 /** The offerings: each product, what kind of offering it is, whom it is offered to and whom it serves through them. */
 export function offeringsOf(dir) {
-  const icp = existsSync(join(dir, "purpose/icp.json")) ? load(join(dir, "purpose/icp.json")) : { profiles: [] };
+  const icp = existsSync(join(ventureFile(dir, "purpose/icp.json"))) ? load(join(ventureFile(dir, "purpose/icp.json"))) : { profiles: [] };
   const profiles = new Map(icp.profiles.map((p) => [p.id, p]));
   const primary = icp.profiles.find((p) => p.primary) ?? icp.profiles[0];
-  const pdir = join(dir, "products");
+  const pdir = join(ventureFile(dir, "products"));
   const products = existsSync(pdir) ? readdirSync(pdir).filter((f) => f.endsWith(".json")).map((f) => load(join(pdir, f))).filter((p) => !["retired", "archived", "idea"].includes(p.status)) : [];
   return { profiles, products: products.map((p) => {
     // Who it is offered to: the product says so; otherwise the profiles others are reached through
@@ -104,7 +105,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   if (!dir || !existsSync(join(dir, "venture.json"))) { console.error("usage: node plan.mjs <venture> [--raising] [--hiring] [--contributors] [--write] [--json]"); process.exit(2); }
   const has = (n) => process.argv.includes(`--${n}`);
   const r = plan(dir, { flags: Object.fromEntries(["raising", "hiring", "contributors"].filter(has).map((k) => [k, true])) });
-  if (has("write")) { mkdirSync(join(dir, dirname(SITEMAP)), { recursive: true }); writeFileSync(join(dir, SITEMAP), JSON.stringify(r, null, 2) + "\n"); }
+  if (has("write")) { mkdirSync(join(dir, dirname(SITEMAP)), { recursive: true }); writeFileSync(ventureFile(dir, SITEMAP), JSON.stringify(r, null, 2) + "\n"); }
   if (has("json")) console.log(JSON.stringify(r, null, 2));
   else {
     console.log(`${r.name}: site planned for ${r.audience.offered_to.map((p) => p.id).join(", ") || "no ICP yet"} (${r.audience.types.map((t) => t.label).join(", ") || "customers in general"})${r.audience.partner_led ? "; partner-led" : ""}`);

package/operations/marketing/site/presence.mjs

@@ -22,6 +22,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { ventureFile } from "../../../schema/venture-paths.mjs";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
@@ -34,7 +35,7 @@ const r2 = (x) => Math.round(x * 100) / 100;
 /** The venture's facts: flags the founder gave, else what its ICP record says about who it courts. */
 export function factsOf(dir, flags = {}) {
   const f = { raising: false, hiring: false, contributors: false };
-  const icpFile = dir && join(dir, "purpose/icp.json");
+  const icpFile = dir && join(ventureFile(dir, "purpose/icp.json"));
   if (icpFile && existsSync(icpFile)) {
     const said = JSON.stringify(load(icpFile)).toLowerCase();
     if (/investor|angel|\bvc\b/.test(said)) f.raising = true;
@@ -57,7 +58,7 @@ export function icpOf(dir, site) {
   const who = ok.filter((p) => /customer|solution|who|industr|use-case|about|for-/i.test(p.path));
   const says = [...new Set([home, ...who].filter(Boolean).flatMap((p) => (p.text ?? "").match(SAYS) ?? []).map((x) => x.trim()))].slice(0, 8);
   const opening = (home?.text ?? "").slice(0, 500);
-  const icpFile = dir && join(dir, "purpose/icp.json");
+  const icpFile = dir && join(ventureFile(dir, "purpose/icp.json"));
   const stated = icpFile && existsSync(icpFile) ? (load(icpFile).profiles ?? []).map((p) => p.who ?? p.description ?? p.name).filter(Boolean) : null;
   return { text: [says.join(" | "), opening].filter(Boolean).join(" || "), source: says.length ? "site" : "inferred", says,
     cite: says.length ? `what the site says about who it is for (${says.length} phrase${says.length > 1 ? "s" : ""}), with the home page's opening` : "the home page's opening text (inferred: the site does not say outright who it is for)",
@@ -237,7 +238,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
     const answers = opt("answers") ? (load(opt("answers")).answers ?? load(opt("answers"))) : null;
     const facts = factsOf(dir, Object.fromEntries(["raising", "hiring", "contributors"].filter(has).map((k) => [k, true])));
     const r = score(site, { answers, facts, icp: icpOf(dir, site), venture: dir ? load(join(dir, "venture.json")).id : null });
-    if (dir) { mkdirSync(join(dir, dirname(PRESENCE)), { recursive: true }); writeFileSync(join(dir, PRESENCE), JSON.stringify(r, null, 2) + "\n"); }
+    if (dir) { mkdirSync(join(dir, dirname(PRESENCE)), { recursive: true }); writeFileSync(ventureFile(dir, PRESENCE), JSON.stringify(r, null, 2) + "\n"); }
     console.log(JSON.stringify(r, null, 2));
   } else if (a && existsSync(join(a, "venture.json"))) {
     if (!existsSync(join(a, PRESENCE))) { console.error(`${PRESENCE} does not exist yet: read the site first (node interface/harness/site.mjs <url> --venture <dir>)`); process.exit(1); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "naive-framework",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Naive, a venture development framework: conventions, routes, records, checks and an agent interface for building a venture.",
   "type": "module",
   "license": "MIT",

package/platform/integrations/rho.mjs

@@ -21,6 +21,7 @@
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "../../schema/venture-paths.mjs";
 
 export const SANDBOX = "https://rhoapi-sandbox.rho.co/mcp/v1";
 export const LIVE = "https://rhoapi.rho.co/mcp/v1";
@@ -107,7 +108,7 @@ export function summarize(data, syncedAt) {
 const json = (f, v) => { mkdirSync(join(f, ".."), { recursive: true }); writeFileSync(f, `${JSON.stringify(v, null, 2)}\n`); };
 
 export function write(venture, data, syncedAt = new Date().toISOString()) {
-  const money = join(venture, "money");
+  const money = join(ventureFile(venture, "money"));
   const pointer = (kind, id) => `${data.source}:${kind}:${id}`;
   for (const a of data.accounts)
     json(join(money, `${a.id}.json`), { id: a.id, name: a.account_name, type: a.account_type, last_4: a.account_number_last_4 ?? null, balance: a.balance, source: pointer("account", a.id), synced_at: syncedAt });

package/purpose/frameworks/idea-map/route.mjs

@@ -25,6 +25,7 @@ import { CONVENTIONS, MAP, parse } from "./ideamap.mjs";
 import { GRAPH, ORDER } from "./graph.mjs";
 import { confirmedIn } from "../../../schema/foundation.mjs";
 import { loadPackages } from "../../../schema/load-packages.mjs";
+import { ventureFile } from "../../../schema/venture-paths.mjs";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
@@ -37,7 +38,7 @@ const HOME = { "venture-core": "foundation", brand: "marketing", ...Object.fromE
 /** Understand is a gate (EE-069): the founder confirms Mentura read the ideas right, after any
  *  corrections, before they are routed. A person's confirm of the map after its last agent write. */
 export function understood(dir) {
-  return existsSync(join(dir, MAP)) && confirmedIn(dir, MAP, "ideas");
+  return existsSync(ventureFile(dir, MAP)) && confirmedIn(dir, MAP, "ideas");
 }
 
 export const STAGES = [["routed", "Routed"], ["drafted", "Drafted"], ["yours", "Your decision"], ["waiting", "Waiting"], ["done", "Done"]];
@@ -62,13 +63,13 @@ function written(dir, key) {
   const rel = m?.paths?.[0]?.replace(/^instance\/\*\*\//, "");
   if (!rel) return null;
   if (rel.includes("*")) { const d = join(dir, dirname(rel)); return existsSync(d) && readdirSync(d).some((f) => f.endsWith(".json")); }
-  return existsSync(join(dir, rel));
+  return existsSync(ventureFile(dir, rel));
 }
 
 export function route(dir, { now } = {}) {
   const venture = load(join(dir, "venture.json"));
-  const g = existsSync(join(dir, GRAPH)) ? load(join(dir, GRAPH)) : null;
-  const nodes = g?.nodes ?? (existsSync(join(dir, MAP)) ? parse(readFileSync(join(dir, MAP), "utf8")).ideas.map((i) => ({ ...i, signal: null, lane: null })) : []);
+  const g = existsSync(ventureFile(dir, GRAPH)) ? load(ventureFile(dir, GRAPH)) : null;
+  const nodes = g?.nodes ?? (existsSync(ventureFile(dir, MAP)) ? parse(readFileSync(ventureFile(dir, MAP), "utf8")).ideas.map((i) => ({ ...i, signal: null, lane: null })) : []);
   if (!nodes.length) return { venture: venture.id, phase: venture.phase, waiting: "no idea map yet: map the idea dump first (purpose/ideas)" };
   const lanes = new Map((g?.lanes ?? []).map((l) => [l.id, l]));
   const m = decisions(dir, now);

package/purpose/frameworks/product-anatomy/anatomy.mjs

@@ -20,6 +20,7 @@
 import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { ventureFile } from "../../../schema/venture-paths.mjs";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const ENDPOINT = "https://api.typesafe.ai/v1/systemone";
@@ -39,7 +40,7 @@ function readVenture(path) {
   }
   const venture = load(join(path, "venture.json"));
   const dir = join(path, "products");
-  const cards = existsSync(dir) ? readdirSync(dir).filter((f) => f.endsWith(".json")).map((f) => load(join(dir, f))) : [];
+  const cards = existsSync(dir) ? readdirSync(dir).filter((f) => f.endsWith(".json")).map((f) => load(ventureFile(dir, f))) : [];
   const products = Object.fromEntries(cards.map((c) => [c.id, c]));
   const flows = cards.flatMap((c) => (c.flows_to ?? []).map((to) => ({ from: c.id, to })));
   return { venture, core: venture.core, products, flows };

package/schema/access.mjs

@@ -8,6 +8,7 @@
 
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 export const PLANS = ["people/team-plan.json", "operations/team-plan.json"];
 
@@ -16,7 +17,7 @@ export const routeGlob = (g) => new RegExp("^" + g.replace(/[.+^${}()|[\]\\]/g,
 
 /** The venture's team plan, or null. Read fresh on every call, so a changed plan is seen at once. */
 export function teamPlan(dir) {
-  const f = dir && PLANS.map((p) => join(dir, p)).find((p) => existsSync(p));
+  const f = dir && PLANS.map((p) => ventureFile(dir, p)).find((p) => existsSync(p));
   return f ? { path: f, ...JSON.parse(readFileSync(f, "utf8")) } : null;
 }
 

package/schema/add-department.mjs

@@ -11,6 +11,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { catalog, foldersOf } from "./departments.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const args = process.argv.slice(2);
 const group = args.includes("--group");
@@ -28,8 +29,8 @@ const tag = { department: d.id, value_chain: d.value_chain, apqc: d.apqc.id };
 const made = [];
 for (const layer of layersOn.filter((l) => !held.includes(l))) {
   const rel = join(layer, "departments", ...(group ? [d.value_chain] : []), d.id);
-  if (existsSync(join(dir, rel))) { console.error(`${rel} exists without a department.json; add the tag by hand`); process.exit(1); }
-  mkdirSync(join(dir, rel), { recursive: true });
+  if (existsSync(ventureFile(dir, rel))) { console.error(`${rel} exists without a department.json; add the tag by hand`); process.exit(1); }
+  mkdirSync(ventureFile(dir, rel), { recursive: true });
   writeFileSync(join(dir, rel, "department.json"), JSON.stringify(tag, null, 2) + "\n");
   const [file, title, what] = layer === "governance"
     ? ["charter.md", "charter", d.governance] : ["README.md", "operations", d.operations];

package/schema/assess-problem.mjs

@@ -26,6 +26,7 @@
 
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 export const ASSUMPTIONS = [
   { id: "exists", says: "the problem is real", field: "statement", test: "Find people already paying for or building a workaround (search, forums, competitors' customers)" },
@@ -97,7 +98,7 @@ export const ASK = "Some things the assessment reads are missing. Fill them in f
 
 /** The whole run: preflight first, then the assessment unless input is missing and as_is is not set. */
 export function assess(dir, { as_is = false, today = new Date() } = {}) {
-  const f = join(dir, "purpose/validation/problem.json");
+  const f = join(ventureFile(dir, "purpose/validation/problem.json"));
   const rec = existsSync(f) ? JSON.parse(readFileSync(f, "utf8")) : null;
   const missing = preflight(rec);
   if (missing.length && !as_is) return { needs_input: { ask: ASK, missing, options: [
@@ -117,7 +118,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   const dir = process.argv[2];
   if (!dir) { console.error("usage: node schema/assess-problem.mjs <venture dir> [--json] [--preflight] [--as-is]"); process.exit(2); }
   const flag = (f) => process.argv.includes(f);
-  const out = flag("--preflight") ? { missing: preflight(existsSync(join(dir, "purpose/validation/problem.json")) ? JSON.parse(readFileSync(join(dir, "purpose/validation/problem.json"), "utf8")) : null) } : assess(dir, { as_is: flag("--as-is") });
+  const out = flag("--preflight") ? { missing: preflight(existsSync(join(ventureFile(dir, "purpose/validation/problem.json"))) ? JSON.parse(readFileSync(join(ventureFile(dir, "purpose/validation/problem.json")), "utf8")) : null) } : assess(dir, { as_is: flag("--as-is") });
   if (flag("--json")) { console.log(JSON.stringify(out, null, 2)); process.exit(0); }
   const list = (m) => m.map((x) => `  - ${x.field}${x.items ? ` (${x.items.join(", ")})` : ""}: ${x.why}. As is: ${x.as_is}`).join("\n");
   if (out.needs_input) { console.log(`${out.needs_input.ask}\n${list(out.needs_input.missing)}\nFill in: ${out.needs_input.options[0].how}\nRun as is: ${out.needs_input.options[1].how}`); process.exit(0); }

package/schema/assets.mjs

@@ -22,6 +22,7 @@ import { createHash } from "node:crypto";
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { extname, join } from "node:path";
 import { entries } from "../interface/provenance.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 export const REGISTER = "public/assets.json";
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
@@ -124,11 +125,11 @@ export function publicFiles(dir) {
   return walk(root).map((f) => f.slice(dir.length + 1)).filter((f) => f !== REGISTER).sort();
 }
 
-export const registerOf = (dir) => existsSync(join(dir, REGISTER)) ? load(join(dir, REGISTER)) : null;
+export const registerOf = (dir) => existsSync(ventureFile(dir, REGISTER)) ? load(ventureFile(dir, REGISTER)) : null;
 
 /** The facts code reads from every file in public/. */
 export function facts(dir) {
-  return publicFiles(dir).map((path) => ({ path, ...factsOf(readFileSync(join(dir, path))) }));
+  return publicFiles(dir).map((path) => ({ path, ...factsOf(readFileSync(ventureFile(dir, path))) }));
 }
 
 /** Which alt texts a person has confirmed, from the provenance log. */
@@ -156,8 +157,8 @@ export function checkAssets(dir) {
   for (const a of reg.assets ?? []) {
     if (seen.has(a.path)) errors.push(`${a.path}: listed twice`);
     seen.add(a.path);
-    if (!existsSync(join(dir, a.path))) { errors.push(`${a.path}: listed in ${REGISTER} but the file is not there`); continue; }
-    const real = factsOf(readFileSync(join(dir, a.path)));
+    if (!existsSync(ventureFile(dir, a.path))) { errors.push(`${a.path}: listed in ${REGISTER} but the file is not there`); continue; }
+    const real = factsOf(readFileSync(ventureFile(dir, a.path)));
     if (String(a.license).trim().toLowerCase() === "unknown") errors.push(`${a.path}: the license is unknown; find it before the venture ships the file (J-2)`);
     if (!a.credit || !String(a.credit).trim()) errors.push(`${a.path}: no credit; say who made it (J-4)`);
     if (real.type !== "unknown" && !extensionFits(a.path, real.type)) errors.push(`${a.path}: the bytes are ${real.type}, the name says otherwise`);
@@ -181,7 +182,7 @@ export function checkAssets(dir) {
     }
   }
   for (const r of reg.remote ?? []) {
-    const src = join(dir, "raw/sources", r.id, "source.json");
+    const src = join(ventureFile(dir, "raw/sources"), r.id, "source.json");
     if (!existsSync(src)) errors.push(`remote ${r.url}: no note in raw/sources/${r.id}/ (J-3)`);
     else if (load(src).origin !== r.url) errors.push(`remote ${r.url}: raw/sources/${r.id}/source.json names another origin`);
     let host = null;

package/schema/brand.mjs

@@ -31,11 +31,12 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { allowsCopy, factsOf, registerOf, REGISTER } from "./assets.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 export const BRAND = "marketing/brand.json";
 export const SITEMAPS = ["marketing/sitemap.json", "operations/marketing/sitemap.json"];
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
-export const brandOf = (dir) => dir && existsSync(join(dir, BRAND)) ? load(join(dir, BRAND)) : null;
+export const brandOf = (dir) => dir && existsSync(ventureFile(dir, BRAND)) ? load(ventureFile(dir, BRAND)) : null;
 
 // ---------------------------------------------------------------------------------------------
 // Router hooks. interface/router.mjs spreads these into its tables; this module never imports the router.
@@ -110,7 +111,7 @@ const url = (path) => `/${path.replace(/^public\//, "")}`;
 /** The marks as head links: the file-based icons Next.js turns into <link> tags. */
 export function headLinks(dir, brand) {
   const reg = registerOf(dir);
-  const factsFor = (p) => reg?.assets?.find((a) => a.path === p)?.facts ?? (existsSync(join(dir, p)) ? factsOf(readFileSync(join(dir, p))) : null);
+  const factsFor = (p) => reg?.assets?.find((a) => a.path === p)?.facts ?? (existsSync(ventureFile(dir, p)) ? factsOf(readFileSync(ventureFile(dir, p))) : null);
   const out = [];
   for (const m of brand.marks ?? []) {
     if (m.kind === "logo") continue;
@@ -217,7 +218,7 @@ export function voiceCheck(text, rules) {
 /** The venture's marketing content files, venture-relative. */
 export function contentFiles(dir) {
   const walk = (d) => existsSync(d) ? readdirSync(d, { withFileTypes: true }).flatMap((e) => e.isDirectory() ? walk(join(d, e.name)) : /\.(mdx?|txt)$/.test(e.name) ? [join(d, e.name)] : []) : [];
-  return ["marketing/content", "operations/marketing/content"].flatMap((p) => walk(join(dir, p))).map((f) => f.slice(dir.length + 1)).sort();
+  return ["marketing/content", "operations/marketing/content"].flatMap((p) => walk(ventureFile(dir, p))).map((f) => f.slice(dir.length + 1)).sort();
 }
 
 /** Every marketing content file held to the voice rules in force at its path, and to other packages' local terms (warnings). */
@@ -225,7 +226,7 @@ export function voice(dir, brand = brandOf(dir)) {
   const violations = [], leaks = [];
   const local = [...glossaries(dir)].filter(([p]) => p !== "marketing").flatMap(([p, g]) => (g.terms ?? []).filter((t) => !t.export).map((t) => ({ ...t, from: p })));
   for (const f of contentFiles(dir)) {
-    const text = readFileSync(join(dir, f), "utf8");
+    const text = readFileSync(ventureFile(dir, f), "utf8");
     const route = f.replace(/^operations\//, "").replace(/\.(mdx?|txt)$/, "");
     if (brand) for (const v of voiceCheck(text, resolveBrand(brand, route).voice.rules)) violations.push({ file: f, ...v });
     for (const t of local) for (const v of voiceCheck(text, [{ id: t.term, avoid: t.term }])) leaks.push({ file: f, line: v.line, term: t.term, local_to: t.from });
@@ -258,11 +259,11 @@ export function checkBrand(dir) {
       if (!(t.files ?? []).length) errors.push(`typeface ${t.id}: self-hosted but names no files in public/ (T-1)`);
       for (const f of t.files ?? []) {
         if (!f.startsWith("public/")) { errors.push(`typeface ${t.id}: ${f} is not in public/ (T-1)`); continue; }
-        if (!existsSync(join(dir, f))) { errors.push(`typeface ${t.id}: ${f} is not there (T-1)`); continue; }
+        if (!existsSync(ventureFile(dir, f))) { errors.push(`typeface ${t.id}: ${f} is not there (T-1)`); continue; }
         const a = asset(f);
         if (!a) errors.push(`typeface ${t.id}: ${f} has no entry in ${REGISTER} (T-1, J-2)`);
         else if (String(a.license).toLowerCase() !== String(t.license).toLowerCase()) errors.push(`typeface ${t.id}: licensed ${t.license}, but ${REGISTER} says ${f} is ${a.license} (T-1)`);
-        const type = factsOf(readFileSync(join(dir, f))).type;
+        const type = factsOf(readFileSync(ventureFile(dir, f))).type;
         if (!["woff2", "woff", "ttf", "otf"].includes(type)) errors.push(`typeface ${t.id}: ${f} is ${type}, not a font file (T-1)`);
       }
     }
@@ -281,9 +282,9 @@ export function checkBrand(dir) {
   // Marks (P-24): registered assets of the right type and size.
   const KINDS = { favicon: ["ico"], icon: ["png", "svg", "ico"], "apple-icon": ["png"], logo: ["png", "svg", "jpeg", "webp"] };
   for (const m of brand.marks ?? []) {
-    if (!existsSync(join(dir, m.asset))) { errors.push(`mark ${m.kind}: ${m.asset} is not there (P-24)`); continue; }
+    if (!existsSync(ventureFile(dir, m.asset))) { errors.push(`mark ${m.kind}: ${m.asset} is not there (P-24)`); continue; }
     if (!asset(m.asset)) errors.push(`mark ${m.kind}: ${m.asset} has no entry in ${REGISTER}, so its source and license are unknown (P-24, J-2)`);
-    const f = factsOf(readFileSync(join(dir, m.asset)));
+    const f = factsOf(readFileSync(ventureFile(dir, m.asset)));
     if (!KINDS[m.kind].includes(f.type)) errors.push(`mark ${m.kind}: ${m.asset} is ${f.type}; a ${m.kind} is ${KINDS[m.kind].join(" or ")} (P-24)`);
     if (m.kind === "apple-icon" && f.type === "png" && (f.width !== 180 || f.height !== 180)) errors.push(`mark apple-icon: ${m.asset} is ${f.width}x${f.height}; an apple-icon is 180x180 (P-24)`);
     if (m.kind === "icon" && f.width && f.width !== f.height) errors.push(`mark icon: ${m.asset} is ${f.width}x${f.height}; an icon is square (P-24)`);
@@ -311,8 +312,8 @@ export function checkBrand(dir) {
 const xmlEscape = (s) => String(s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 
 export function sitemapOf(dir) {
-  const f = SITEMAPS.find((p) => existsSync(join(dir, p)));
-  return f ? { file: f, record: load(join(dir, f)) } : null;
+  const f = SITEMAPS.find((p) => existsSync(ventureFile(dir, p)));
+  return f ? { file: f, record: load(ventureFile(dir, f)) } : null;
 }
 
 /** sitemaps.org XML from a marketing sitemap record: one <url> per planned page, home first. */

package/schema/caching.mjs

@@ -38,6 +38,7 @@ import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { entries as provEntries } from "../interface/provenance.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const repo = new URL("..", import.meta.url).pathname;
 const load = (f) => JSON.parse(readFileSync(f, "utf8"));
@@ -127,7 +128,7 @@ export const DEFAULTS = { enabled: true, life: "default", judgment_life: "max",
 
 /** The venture's cache settings: the recommended defaults, then naive.config.json's cache, then NAIVE_CACHE. */
 export function configOf(dir) {
-  const f = dir && join(dir, "naive.config.json");
+  const f = dir && join(ventureFile(dir, "naive.config.json"));
   const own = f && existsSync(f) ? load(f).cache ?? {} : {};
   const off = /^(0|off|false|no)$/i.test(process.env.NAIVE_CACHE ?? "");
   return { ...DEFAULTS, ...own, routes: { ...(own.routes ?? {}) }, enabled: !off && own.enabled !== false };
@@ -372,7 +373,7 @@ function walkEntries(root) {
 
 /** The entries one actor may see: the shared ones and their own private ones, never another person's (C-7). */
 export function entries(dir, { identity = null, level } = {}) {
-  const base = join(dir, CACHE_DIR);
+  const base = ventureFile(dir, CACHE_DIR);
   const roots = [join(base, "shared"), ...(identity ? [join(base, scopeOf(true, identity))] : [])];
   return roots.flatMap(walkEntries).flatMap((f) => { try { const e = load(f); return [{ file: f.slice(dir.length + 1), bytes: statSync(f).size, ...e }]; } catch { return []; } })
     .filter((e) => !level || e.level === level);
@@ -392,7 +393,7 @@ export function stats(dir, { identity = null, now = Date.now() } = {}) {
 /** Removes expired entries in every scope. Returns how many. */
 export function prune(dir, { now = Date.now() } = {}) {
   let n = 0;
-  for (const f of walkEntries(join(dir, CACHE_DIR))) {
+  for (const f of walkEntries(ventureFile(dir, CACHE_DIR))) {
     try { const e = load(f); if (e.expires_at && Date.parse(e.expires_at) <= now) { rmSync(f); n++; } } catch { rmSync(f, { force: true }); n++; }
   }
   return n;
@@ -401,7 +402,7 @@ export function prune(dir, { now = Date.now() } = {}) {
 /** Removes entries, all or one level, in every scope. Returns how many. */
 export function clear(dir, { level } = {}) {
   let n = 0;
-  for (const f of walkEntries(join(dir, CACHE_DIR))) {
+  for (const f of walkEntries(ventureFile(dir, CACHE_DIR))) {
     let e = null;
     try { e = load(f); } catch {}
     if (!level || e?.level === level) { rmSync(f, { force: true }); n++; }

package/schema/check-config.mjs

@@ -23,13 +23,14 @@ import { evaluate, patternRe, rulesFor } from "./gate.mjs";
 import { teamPlan } from "./access.mjs";
 import { gateOf, repo, resolve, routes } from "../interface/router.mjs";
 import { agentFromEnv, record } from "../interface/provenance.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const FRAMEWORKS = ["idea-map"];
 
 /** Problems with a venture's naive.config.json: { errors, warnings }. */
 export function check(dir) {
   const errors = [], warnings = [];
-  const f = join(dir, CONFIG);
+  const f = ventureFile(dir, CONFIG);
   if (!existsSync(f)) return { errors, warnings, note: `no ${CONFIG}: every default applies` };
   let raw;
   try { raw = rawConfig(dir); } catch (e) { return { errors: [e.message], warnings }; }
@@ -66,7 +67,7 @@ export function explain(dir, route, { actor = "agent", role, confidence } = {})
   const concrete = r.collection === "item" ? r.route.replace("[id]", params.id) : r.route;
   const cls = gateOf(r, dir);
   const files = (r.collection === "item" ? r.files.map((x) => x.replace("*", params.id)) : r.files);
-  const exists = files.some((x) => existsSync(join(dir, x)));
+  const exists = files.some((x) => existsSync(ventureFile(dir, x)));
   const verdict = evaluate({ config: configFor(dir), dir, route: concrete, table: r.route, record: r.record, actor, role, confidence, exists, decisionOwner: cls?.owner ?? undefined });
   return { route: concrete, record: r.record, actor, role: role ?? null, confidence: confidence ?? null, decision_class: cls ? { class: cls.class, level: cls.level, drafts: cls.drafts && actor !== "person" } : null, gate: verdict };
 }
@@ -78,7 +79,7 @@ export function pin(dir, names) {
   const unknown = chosen.filter((n) => !have[n]);
   if (unknown.length) throw new Error(`not installed: ${unknown.join(", ")}`);
   raw.packages = { ...(raw.packages ?? {}), ...Object.fromEntries(chosen.map((n) => [n, have[n]])) };
-  writeFileSync(join(dir, CONFIG), JSON.stringify(raw, null, 2) + "\n");
+  writeFileSync(ventureFile(dir, CONFIG), JSON.stringify(raw, null, 2) + "\n");
   record(dir, { entity: CONFIG, route: "system/naive-config", activity: "write", agent: agentFromEnv("person", "cli"), note: `pinned ${chosen.join(", ")} at the installed versions` });
   return raw.packages;
 }

package/schema/check-data-model.mjs

@@ -17,6 +17,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, relative } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 // EE_ROOT points the check at another copy of the repository (used by schema/test.mjs).
 const root = process.env.EE_ROOT?.replace(/\/?$/, "/") ?? new URL("..", import.meta.url).pathname;
@@ -26,7 +27,7 @@ const errors = [];
 const warnings = [];
 
 const files = (dir) => readdirSync(join(root, dir), { withFileTypes: true }).flatMap((e) =>
-  [".git", "node_modules", ".naive"].includes(e.name) ? [] : e.isDirectory() ? files(join(dir, e.name)) : [join(dir, e.name)]);
+  [".git", "node_modules", ".naive"].includes(e.name) ? [] : e.isDirectory() ? files(ventureFile(dir, e.name)) : [ventureFile(dir, e.name)]);
 // The files git would track (so build output and installed packages under .gitignore are left out); a
 // copy outside git, as the tests use, is walked instead.
 const tracked = spawnSync("git", ["ls-files", "--cached", "--others", "--exclude-standard"], { cwd: root, encoding: "utf8" });

package/schema/check-data-packages.mjs

@@ -10,6 +10,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 const dir = process.argv[2];
 if (!dir) { console.error("usage: node schema/check-data-packages.mjs <workspace or venture dir>"); process.exit(2); }
@@ -32,10 +33,10 @@ for (const v of walk(dir)) {
   const id = load(join(v, "venture.json")).id;
   const git = inGit(v);
   for (const pack of PACKS) {
-    const base = join(v, pack);
+    const base = ventureFile(v, pack);
     if (!existsSync(base)) continue;
     for (const name of readdirSync(base)) {
-      if (name.startsWith("_") || name.startsWith(".")) continue;
+      if (name.startsWith("_") || name.startsWith(".") || name === "README.md" || name === "AGENTS.md") continue;
       const p = join(base, name);
       if (!statSync(p).isFile() || !name.endsWith(".json")) errors.push(`${id}/${pack}/${name}: a master record is <id>.json`);
     }
@@ -56,7 +57,7 @@ for (const v of walk(dir)) {
       }
     }
   }
-  const sources = join(v, "raw/sources");
+  const sources = join(ventureFile(v, "raw/sources"));
   if (existsSync(sources)) for (const s of readdirSync(sources)) {
     const sd = join(sources, s);
     if (!statSync(sd).isDirectory() || s.startsWith(".")) continue;
@@ -64,9 +65,9 @@ for (const v of walk(dir)) {
     if (!existsSync(join(sd, "text.md"))) errors.push(`${id}/raw/sources/${s}: missing text.md`);
     for (const f of readdirSync(sd)) if (f.startsWith("original.") && (!git || tracked(v, join("raw/sources", s, f)))) errors.push(`${id}/raw/sources/${s}/${f}: original.* stays out of git`);
   }
-  const map = ["ideas/map.mdx", "purpose/ideas/map.mdx"].map((f) => join(v, f)).find((p) => existsSync(p));
+  const map = ["ideas/map.mdx", "purpose/ideas/map.mdx"].map((f) => ventureFile(v, f)).find((p) => existsSync(p));
   const rawIds = new Set();
-  const dump = join(v, "raw/dump");
+  const dump = join(ventureFile(v, "raw/dump"));
   if (existsSync(dump)) for (const f of readdirSync(dump)) if (f !== ".gitkeep") rawIds.add(f.replace(/\.[^.]+$/, ""));
   if (existsSync(sources)) for (const s of readdirSync(sources)) if (!s.startsWith(".")) rawIds.add(s);
   if (map && rawIds.size) {

package/schema/check-execution.mjs

@@ -13,6 +13,7 @@
 
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 const dir = process.argv[2];
 if (!dir) { console.error("usage: node schema/check-execution.mjs <venture dir>"); process.exit(2); }
@@ -27,7 +28,7 @@ const template = load(join(root, "governance/venture-template/decision-rights.js
 const errors = [];
 
 const classes = new Map(template.classes.map((c) => [c.id, c]));
-const own = join(dir, "governance/decision-rights.json");
+const own = join(ventureFile(dir, "governance/decision-rights.json"));
 if (existsSync(own)) for (const c of load(own).classes) {
   const t = classes.get(c.id);
   if (t && RANK[c.level] < RANK[t.level] && !c.decision) errors.push(`decision-rights/${c.id}: loosens ${t.level} to ${c.level} without naming a decision`);
@@ -36,14 +37,14 @@ if (existsSync(own)) for (const c of load(own).classes) {
 for (const c of classes.values()) if (!roles.has(c.owner)) errors.push(`decision-rights/${c.id}: owner ${c.owner} is not a role`);
 
 const results = new Map();
-for (const f of jsonIn(join(dir, "evidence/results"))) {
+for (const f of jsonIn(join(ventureFile(dir, "evidence/results")))) {
   const e = load(f);
   if (e.passed !== e.results.every((r) => r.passed)) errors.push(`evidence/${e.id}: passed says ${e.passed} but its results disagree`);
   results.set(resolve(f), e);
 }
 
 let count = 0;
-for (const f of jsonIn(join(dir, "operations/handoffs"))) {
+for (const f of jsonIn(join(ventureFile(dir, "operations/handoffs")))) {
   const h = load(f), at = `handoff/${h.id}`;
   count++;
   if (h.venture !== venture.id) errors.push(`${at}: venture ${h.venture} is not ${venture.id}`);

package/schema/check-people.mjs

@@ -9,6 +9,7 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { roles as ROLES, types as TYPES } from "./venture-type.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const ws = process.argv[2];
 if (!ws || !existsSync(ws)) { console.error("usage: node schema/check-people.mjs <workspace>"); process.exit(2); }
@@ -26,28 +27,41 @@ for (const dir of walk(ws)) {
   const at = (m) => errors.push(`${v.id}: ${m}`);
   const type = v.type ? types.get(v.type) : null;
   if (v.type && !type) at(`type ${v.type} is not in schema/venture-types.json`);
-  const rosterFile = join(dir, "people/people.json");
-  const fdir = join(dir, "people/founders");
+  const rosterFile = join(ventureFile(dir, "people/people.json"));
+  const fdir = join(ventureFile(dir, "people/founders"));
   const files = existsSync(fdir) ? readdirSync(fdir).filter((f) => f.endsWith(".json")) : [];
   if (!existsSync(rosterFile)) { if (files.length) at("people/founders/ has files but there is no people/people.json"); continue; }
   rosters++;
   const roster = load(rosterFile);
-  const imported = new Set(v.departments ?? []);
+  // In the structured layout (EE-086) the org chart is venture.json's functions, and a person's hats are the
+  // functions they own there; in the flat layout, the departments venture.json imports, worn as hats in people/.
+  const structured = v.layout === "structured";
+  const imported = new Set(structured ? Object.keys(v.functions ?? {}) : v.departments ?? []);
+  const ids = new Set(roster.people.map((p) => p.id));
+  if (structured) {
+    for (const [fn, f] of Object.entries(v.functions ?? {})) {
+      if (f.owner && !ids.has(f.owner)) at(`venture.json says ${f.owner} owns ${fn}, but people/people.json has no ${f.owner}`);
+      for (const c of f.contributors ?? []) if (!ids.has(c) && !roles.has(c)) at(`${fn} names contributor ${c}, who is neither a person in people/ nor a role`);
+    }
+    for (const p of roster.people) p.hats = Object.entries(v.functions ?? {}).filter(([, f]) => f.owner === p.id).map(([fn]) => fn);
+  }
   for (const p of roster.people) {
     const role = roles.get(p.role);
     if (!role) { at(`${p.id} has role ${p.role}, which is not in governance/venture-template/roles/venture-roles.json`); continue; }
     if (type && !type.roles.includes(p.role)) at(`${p.id} is a ${p.role}, which a ${type.label.toLowerCase()} does not have (${type.roles.join(", ")})`);
-    for (const h of p.hats) if (imported.size && !imported.has(h)) at(`${p.id} wears the ${h} hat, but venture.json does not import ${h}`);
+    for (const h of p.hats ?? []) if (imported.size && !imported.has(h)) at(`${p.id} wears the ${h} hat, but venture.json does not import ${h}`);
+    p.hats ??= [];
     if (!role.owns_when_solo && p.hats.length) at(`${p.id} is a ${p.role}, who owns no function, but wears ${p.hats.join(", ")}`);
     if (role.founder) {
       const f = `people/founders/${p.id}.json`;
       if (p.founder_file !== f) at(`${p.id} is a founder, so founder_file is ${f}`);
-      else if (!existsSync(join(dir, f))) at(`${f} is missing`);
+      else if (!existsSync(ventureFile(dir, f))) at(`${f} is missing`);
       else {
-        const rec = load(join(dir, f));
+        const rec = load(ventureFile(dir, f));
         if (rec.id !== p.id || rec.role !== p.role) at(`${f} says ${rec.id} is a ${rec.role}; the roster says ${p.id} is a ${p.role}`);
-        if (JSON.stringify([...rec.hats].sort()) !== JSON.stringify([...p.hats].sort())) at(`${f} and the roster disagree on ${p.id}'s hats`);
-        if (rec.agreement && !existsSync(join(dir, rec.agreement.path))) at(`${f} links a founder agreement at ${rec.agreement.path}, which does not exist`);
+        if (!structured && JSON.stringify([...(rec.hats ?? [])].sort()) !== JSON.stringify([...p.hats].sort())) at(`${f} and the roster disagree on ${p.id}'s hats`);
+        if (structured && rec.hats) at(`${f} stores hats; in the structured layout they are read from venture.json`);
+        if (rec.agreement && !existsSync(ventureFile(dir, rec.agreement.path))) at(`${f} links a founder agreement at ${rec.agreement.path}, which does not exist`);
       }
     }
   }

package/schema/check-private.mjs

@@ -7,6 +7,7 @@
 
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 const dir = process.argv[2];
 if (!dir) { console.error("usage: node schema/check-private.mjs <venture dir>"); process.exit(2); }
@@ -49,7 +50,7 @@ for (const { package: name, input } of inputs) {
   if (privateTargets.has(input) || privateRecords.has(input.split(".")[0])) errors.push(`${name}: use_model input ${input} is private and must not reach a model`);
 }
 if (readsRelease) {
-  const release = join(dir, ".release");
+  const release = join(ventureFile(dir, ".release"));
   if (existsSync(release) && statSync(release).isDirectory()) {
     for (const f of walk(release).filter((p) => p.endsWith(".json"))) {
       const text = readFileSync(f, "utf8");