naive-framework 0.2.0 → 0.3.0

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,7 +33,7 @@ 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;
@@ -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");

package/schema/check-ready.mjs

@@ -13,19 +13,20 @@
 import { execSync } from "node:child_process";
 import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 const [dir, id] = process.argv.slice(2);
 if (!dir || !id) { console.error("usage: node schema/check-ready.mjs <venture dir> <handoff id> [--record --by <who>]"); process.exit(2); }
 const opt = (k) => process.argv.includes(k) ? process.argv[process.argv.indexOf(k) + 1] : undefined;
 const root = new URL("..", import.meta.url).pathname;
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
-const hPath = join(dir, "operations/handoffs", `${id}.json`);
+const hPath = join(ventureFile(dir, "operations/handoffs"), `${id}.json`);
 const h = load(hPath);
 const items = [];
 const item = (name, ok, why = "") => items.push({ name, ok, why });
 
 // 1. The brief says what done looks like and what to do, with no placeholders left.
-const bPath = join(dir, "operations/handoffs", h.brief);
+const bPath = join(ventureFile(dir, "operations/handoffs"), h.brief);
 const brief = existsSync(bPath) ? readFileSync(bPath, "utf8") : "";
 item("brief exists", !!brief, bPath);
 const section = (name) => { const m = brief.match(new RegExp(`^##\\s+(?:\\d+\\.\\s*)?${name}\\b[^\\n]*\\n([\\s\\S]*?)(?=^##\\s|$(?![\\s\\S]))`, "mi")); return m ? m[1].trim() : null; };
@@ -34,10 +35,10 @@ const holes = brief.match(/\b(TBD|TODO|FIXME)\b|\?\?\?|<(?:title|role|entity|out
 item("brief has no placeholders left", !holes.length, holes.slice(0, 3).join(", "));
 
 // 2. Everything it names exists.
-const products = new Set(["products", "product"].flatMap((folder) => existsSync(join(dir, folder)) ? readdirSync(join(dir, folder)).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)) : []));
+const products = new Set(["products", "product"].flatMap((folder) => existsSync(ventureFile(dir, folder)) ? readdirSync(ventureFile(dir, folder)).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)) : []));
 const missingProducts = (h.products ?? []).filter((p) => !products.has(p));
 item("every product it serves exists", !missingProducts.length, missingProducts.join(", "));
-const logs = [join(root, "docs/decisions/decisions.json"), join(dir, "knowledge/decisions.json")].filter(existsSync).flatMap((f) => load(f).decisions);
+const logs = [join(root, "docs/decisions/decisions.json"), join(ventureFile(dir, "knowledge/decisions.json"))].filter(existsSync).flatMap((f) => load(f).decisions);
 const decisions = new Map(logs.map((d) => [d.id, d]));
 const badDecisions = (h.governed_by ?? []).filter((d) => !decisions.has(d) || ["withdrawn", "superseded"].includes(decisions.get(d).status));
 item("every governing decision exists and is in force or proposed", !badDecisions.length, badDecisions.join(", "));
@@ -49,7 +50,7 @@ item("every input it needs exists", !missingInputs.length, missingInputs.join(",
 // 3. The holder can act inside its rights.
 const roles = new Set(load(join(root, "governance/venture-template/roles/agent-roles.json")).roles.map((r) => r.id));
 const classes = new Map(load(join(root, "governance/venture-template/decision-rights.json")).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) classes.set(c.id, { ...classes.get(c.id), ...c });
 item(`role ${h.role} exists`, roles.has(h.role));
 const foreign = h.decision_classes.filter((c) => classes.get(c)?.owner !== h.role);

package/schema/check-sources.mjs

@@ -11,6 +11,7 @@ import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 import { LOCAL, MAP, registry } from "../knowledge/connectors/index.mjs";
 import { ANY, CONTEXT, specificity } from "../knowledge/connectors/resolve.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const dir = process.argv[2];
 if (!dir) { console.error("usage: node schema/check-sources.mjs <workspace or venture dir>"); process.exit(2); }
@@ -27,7 +28,7 @@ const errors = [];
 let maps = 0;
 
 for (const v of walk(dir)) {
-  const f = join(v, MAP);
+  const f = ventureFile(v, MAP);
   if (!existsSync(f)) continue;
   maps++;
   const id = JSON.parse(readFileSync(join(v, "venture.json"), "utf8")).id;

package/schema/check-where-used.mjs

@@ -10,6 +10,7 @@ import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { connect, sourceFor, sourcesOf } from "../knowledge/connectors/index.mjs";
 import { resolve } from "../interface/router.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const dir = process.argv[2];
 if (!dir) { console.error("usage: node schema/check-where-used.mjs <workspace or venture dir> [--json]"); process.exit(2); }
@@ -21,18 +22,18 @@ const at = (obj, pointer) => pointer.split("/").slice(1).map((k) => k.replace(/~
 const errors = [], drift = [], unchecked = [];
 let lists = 0, checked = 0;
 for (const v of walk(dir)) {
-  if (!existsSync(join(v, FILE))) continue;
+  if (!existsSync(ventureFile(v, FILE))) continue;
   lists++;
   const id = JSON.parse(readFileSync(join(v, "venture.json"), "utf8")).id;
   const ids = new Map(sourcesOf(v).sources.map((s) => [s.id, s]));
-  for (const fact of JSON.parse(readFileSync(join(v, FILE), "utf8")).facts) {
+  for (const fact of JSON.parse(readFileSync(ventureFile(v, FILE), "utf8")).facts) {
     const where = `${id}: ${fact.id}`;
     const { r, params } = resolve(fact.parent.route);
     if (!r || r.kind !== "record" || r.collection === "list") { errors.push(`${where}: parent ${fact.parent.route} is not a record route`); continue; }
     const context = r.collection === "item" && (r.record === "product" || r.record === "account") ? { [r.record]: params.id } : {};
     const src = sourceFor(v, r.record, context);
     const cands = (r.collection === "item" ? r.files.map((f) => f.replace("*", params.id)) : r.files).filter((f) => !f.includes("*"));
-    const path = cands.find((f) => existsSync(join(v, f))) ?? cands[0];
+    const path = cands.find((f) => existsSync(ventureFile(v, f))) ?? cands[0];
     if (src.connector !== "filesystem") { unchecked.push(`${where}: parent is in ${src.id}`); continue; }
     const parent = await (await connect(src, v)).read(path);
     const value = parent && at(JSON.parse(parent.content), fact.parent.pointer);

package/schema/decision-analytics.mjs

@@ -19,6 +19,7 @@ import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { decisions } from "./decisions.mjs";
 import { HOME, PACKAGES, TITLES } from "./packages.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const load = (f) => JSON.parse(readFileSync(f, "utf8"));
 const titleOf = (t) => ({ icp: "ICP", "venture-core": "Core product" })[t] ?? TITLES[t] ?? t.replace(/^validation-/, "").replace(/-/g, " ").replace(/^./, (c) => c.toUpperCase());
@@ -30,7 +31,7 @@ const OPEN = new Set(["now", "overdue", "waiting", "stale", "later"]);
 export function analytics(dir, now) {
   const r = decisions(dir, now);
   const rows = r.decisions.filter((d) => d.source !== "root").map((d) => {
-    const raw = d.file ? load(join(dir, d.file)) : {};
+    const raw = d.file ? load(ventureFile(dir, d.file)) : {};
     const record = d.decides?.record ?? null;
     // A foundation statement belongs to the strategic foundation whatever record holds it; so does a
     // decision about venture.json itself (the core product, the team).