naive-framework 0.2.0 → 0.4.0

package/schema/migrate-venture.mjs

@@ -21,6 +21,7 @@ import { fileURLToPath } from "node:url";
 import { call, routes } from "../interface/router.mjs";
 import { agentFromEnv, record as prov } from "../interface/provenance.mjs";
 import { propose } from "./decisions.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 export const PLAN = ".release/migrate-plan.json";
 const MAX_FILE = 512 * 1024;
@@ -117,7 +118,7 @@ Files: ${JSON.stringify(Object.fromEntries(given.map((f) => [f.path, f.text])))}
 /** Writes the plan into the venture and proposes one open decision per function it touches. */
 export function proposeDecisions(dir, p) {
   mkdirSync(join(dir, dirname(PLAN)), { recursive: true });
-  writeFileSync(join(dir, PLAN), JSON.stringify(p, null, 2) + "\n");
+  writeFileSync(ventureFile(dir, PLAN), JSON.stringify(p, null, 2) + "\n");
   prov(dir, { entity: PLAN, activity: "draft", agent: agentFromEnv("agent", "migrate", { id: "naive-migrate" }), note: `migrate plan from ${p.from}: ${p.items.length} records, ${p.left_behind.length} left behind` });
   const groups = new Map();
   for (const it of p.items) groups.set(functionOf(it.route), [...(groups.get(functionOf(it.route)) ?? []), it]);
@@ -139,8 +140,8 @@ const answerOf = (d) => { const a = String(d?.answer ?? "").toLowerCase(); retur
 
 /** Writes what a person decided, through the router. Open decisions wait. */
 export async function apply(dir) {
-  const p = load(join(dir, PLAN));
-  const decisionOf = (fn) => { const f = join(dir, "decisions", `migrate-${fn}.decision.json`); return existsSync(f) ? load(f) : null; };
+  const p = load(ventureFile(dir, PLAN));
+  const decisionOf = (fn) => { const f = join(ventureFile(dir, "decisions"), `migrate-${fn}.decision.json`); return existsSync(f) ? load(f) : null; };
   const done = { brought: 0, drafted: 0, pointed: 0, left: 0, waiting: 0, failed: 0 };
   let pointed = false;
   for (const it of p.items.filter((x) => x.status === "planned")) {
@@ -157,7 +158,7 @@ export async function apply(dir) {
     done[it.status]++;
   }
   if (pointed) {
-    const f = join(dir, "knowledge/sources.json");
+    const f = join(ventureFile(dir, "knowledge/sources.json"));
     const s = existsSync(f) ? load(f) : { sources: [], records: {} };
     const id = slug(basename(p.from));
     if (!s.sources.some((x) => x.id === id)) s.sources.push({ id, connector: "filesystem", writes: "none", root: p.from, note: "migrate: a person chose to point to these files rather than rewrite them" });
@@ -165,7 +166,7 @@ export async function apply(dir) {
     writeFileSync(f, JSON.stringify(s, null, 2) + "\n");
     prov(dir, { entity: "knowledge/sources.json", activity: "write", agent: agentFromEnv("agent", "migrate", { id: "naive-migrate" }), note: `points to ${p.from}, read-only` });
   }
-  writeFileSync(join(dir, PLAN), JSON.stringify(p, null, 2) + "\n");
+  writeFileSync(ventureFile(dir, PLAN), JSON.stringify(p, null, 2) + "\n");
   return done;
 }
 
@@ -176,7 +177,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   if (!dir || !existsSync(join(dir, "venture.json"))) { console.error("usage: node schema/migrate-venture.mjs --from <project> --venture <dir> | --venture <dir> --apply"); process.exit(2); }
   try {
     if (args.includes("--apply")) {
-      if (!existsSync(join(dir, PLAN))) { console.error(`no plan at ${join(dir, PLAN)}: run with --from first`); process.exit(1); }
+      if (!existsSync(ventureFile(dir, PLAN))) { console.error(`no plan at ${ventureFile(dir, PLAN)}: run with --from first`); process.exit(1); }
       const d = await apply(dir);
       console.log(Object.entries(d).filter(([, n]) => n).map(([k, n]) => `${n} ${k}`).join(", ") || "nothing to do");
     } else {
@@ -186,7 +187,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
       for (const i of p.items) console.log(`${i.id}  ${i.from.join(", ")}  ->  ${i.route}   (${i.reshaping})`);
       for (const l of p.left_behind) console.log(`left  ${l.from}   (${l.why})`);
       console.log(`\n${p.items.length} records planned, ${p.left_behind.length} left behind. Nothing is written yet.`);
-      if (decisions.length) console.log(`Read ${relative(process.cwd(), join(dir, PLAN))}, then decide ${decisions.join(", ")} with mentura decide (answer "bring in", "point to them" or "leave them"), then run with --apply.`);
+      if (decisions.length) console.log(`Read ${relative(process.cwd(), ventureFile(dir, PLAN))}, then decide ${decisions.join(", ")} with mentura decide (answer "bring in", "point to them" or "leave them"), then run with --apply.`);
     }
   } catch (e) { console.error(e.message); process.exit(1); }
 }

package/schema/migrations/kit-to-package.mjs

@@ -14,6 +14,7 @@
 
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "../venture-paths.mjs";
 
 export const id = "kit-to-package";
 export const describe = "Moves Naive packages out of naive.config.json kits into packages, and rewrites layer and kit routes inside records (decision unlocks, team-plan access, where-used parents) to package routes";
@@ -67,15 +68,15 @@ export function apply(dir, ctx) {
     return r.to;
   };
   const rewriteFile = (file, fn) => {
-    if (!existsSync(join(dir, file))) return;
-    const before = readFileSync(join(dir, file), "utf8");
+    if (!existsSync(ventureFile(dir, file))) return;
+    const before = readFileSync(ventureFile(dir, file), "utf8");
     const rec = JSON.parse(before);
     fn(rec);
     const after = JSON.stringify(rec, null, 2) + "\n";
     if (after.trim() !== before.trim()) ctx.write(file, after, { note: "routes renamed from layer and kit routes to package routes (EE-071)" });
   };
 
-  const decisionFiles = (sub = "") => readdirSync(join(dir, sub), { withFileTypes: true }).flatMap((e) => {
+  const decisionFiles = (sub = "") => readdirSync(ventureFile(dir, sub), { withFileTypes: true }).flatMap((e) => {
     const rel = sub ? `${sub}/${e.name}` : e.name;
     if (e.isDirectory()) return e.name.startsWith(".") || e.name.startsWith("_") || existsSync(join(dir, rel, "venture.json")) ? [] : decisionFiles(rel);
     return e.name.endsWith(".decision.json") ? [rel] : [];

package/schema/migrations/package-layout.mjs

@@ -8,16 +8,20 @@
 
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "../venture-paths.mjs";
+import { layoutOf } from "../venture-paths.mjs";
 
 export const id = "package-layout";
 export const describe = "Moves records from the layer folders (purpose/, pillars/, products/, knowledge/) into package folders (foundation/, validation/, product/, marketing/, people/, decisions/)";
 
 export function apply(dir, ctx) {
+  // A venture in the structured layout (EE-086) is already past this layout: nothing to move.
+  if (layoutOf(dir) === "structured") return;
   const load = (p) => JSON.parse(readFileSync(p, "utf8"));
   // A decision file infers its target from the folder it sits in. Stamp that path before the file
   // moves, so the decision still points at the same record.
   const stampDecisions = (folder) => {
-    const d = join(dir, folder);
+    const d = ventureFile(dir, folder);
     if (!existsSync(d)) return;
     for (const f of readdirSync(d).filter((x) => x.endsWith(".decision.json"))) {
       const rec = load(join(d, f));
@@ -45,7 +49,7 @@ export function apply(dir, ctx) {
   ];
   for (const [a, b] of pairs) ctx.mv(a, b);
 
-  const list = (rel, ext) => existsSync(join(dir, rel)) ? readdirSync(join(dir, rel)).filter((f) => f.endsWith(ext)) : [];
+  const list = (rel, ext) => existsSync(ventureFile(dir, rel)) ? readdirSync(ventureFile(dir, rel)).filter((f) => f.endsWith(ext)) : [];
   for (const f of list("products", ".json")) ctx.mv(`products/${f}`, `product/${f}`);
   for (const f of list("purpose/anatomy", ".json")) ctx.mv(`purpose/anatomy/${f}`, `product/anatomy/${f}`);
 
@@ -55,7 +59,7 @@ export function apply(dir, ctx) {
   }
 
   for (const f of ["product.md", "business.md"]) {
-    if (existsSync(join(dir, "pillars", f))) {
+    if (existsSync(join(ventureFile(dir, "pillars"), f))) {
       ctx.mv(`pillars/${f}`, `_private/pillars/${f}`);
       ctx.escalate(`${f.replace(".md", "")} pillar: the brief names a home only for brand (marketing/). Archived at _private/pillars/${f} rather than guessed.`);
     }
@@ -68,8 +72,8 @@ export function apply(dir, ctx) {
   for (const gone of ["purpose", "pillars", "knowledge", "products"]) ctx.removeEmpty(gone);
 
   const policy = "governance/publication-policy.json";
-  if (existsSync(join(dir, policy))) {
-    const text = readFileSync(join(dir, policy), "utf8");
+  if (existsSync(ventureFile(dir, policy))) {
+    const text = readFileSync(ventureFile(dir, policy), "utf8");
     if (text.includes("pillars/brand.md")) ctx.write(policy, text.replaceAll("pillars/brand.md", "marketing/brand.md"), { note: "the brand pillar moved to marketing/brand.md (EE-070)" });
   }
 

package/schema/model-steps.mjs

@@ -47,6 +47,7 @@ import { call as routerCall, files as ventureFiles, glob, routes } from "../inte
 import { agentFromEnv, entries as provEntries, record as prov } from "../interface/provenance.mjs";
 import { decisions as decisionsOf, propose } from "./decisions.mjs";
 import { loadPackages } from "./load-packages.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const repo = new URL("..", import.meta.url).pathname;
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
@@ -264,7 +265,7 @@ async function context(dir, { call = routerCall, workspace } = {}) {
   let byId = null;
   const recordById = (id) => {
     byId ??= new Map(ventureFiles(dir).filter((f) => f.endsWith(".json") && !f.startsWith("knowledge/judgments/")).flatMap((f) => {
-      try { const r = load(join(dir, f)); return r && typeof r.id === "string" ? [[r.id, { file: f, record: r }]] : []; } catch { return []; }
+      try { const r = load(ventureFile(dir, f)); return r && typeof r.id === "string" ? [[r.id, { file: f, record: r }]] : []; } catch { return []; }
     }));
     return byId.get(id) ?? null;
   };
@@ -583,8 +584,8 @@ function confirmedBy(dir, file) {
   return c ? c.agent.id ?? "a person" : null;
 }
 const isModelJudgment = (dir, f) => {
-  if (!glob(`${JUDGMENTS}/*.json`).test(f) || !existsSync(join(dir, f))) return false;
-  try { return load(join(dir, f)).by?.kind === "model"; } catch { return false; }
+  if (!glob(`${JUDGMENTS}/*.json`).test(f) || !existsSync(ventureFile(dir, f))) return false;
+  try { return load(ventureFile(dir, f)).by?.kind === "model"; } catch { return false; }
 };
 
 /**
@@ -603,12 +604,12 @@ export async function provenanceOf(dir, file, { checks = false, call = routerCal
   if (last.agent.kind === "person" || confirmed) return { entity: file, status: "person", model: false, downstream_of_model: [],
     why: confirmed ? `confirmed by ${confirmed.agent.id ?? "a person"}` : `${last.activity === "accept" ? "accepted" : "written"} by ${last.agent.id ?? "a person"}` };
   const upstream = [];
-  for (const d of (last.derived_from ?? []).map((x) => x.split("#")[0]).filter((x) => !seen.has(x) && existsSync(join(dir, x)))) {
+  for (const d of (last.derived_from ?? []).map((x) => x.split("#")[0]).filter((x) => !seen.has(x) && existsSync(ventureFile(dir, x)))) {
     const u = await provenanceOf(dir, d, { seen });
     if (u.model) upstream.push(d); else upstream.push(...u.downstream_of_model);
   }
   const res = { entity: file, status: "agent", model, downstream_of_model: [...new Set(upstream)], why: model ? `a model's judgment (${last.note ?? "use model"}); a person confirms it` : upstream.length ? "an agent wrote it from a model's output" : "an agent wrote it" };
-  if (checks && !(model && load(join(dir, file)).kind === "draft") && last.route) {
+  if (checks && !(model && load(ventureFile(dir, file)).kind === "draft") && last.route) {
     const venture = load(join(dir, "venture.json")).id;
     const r = await call({ venture, workspace: workspace ?? dirname(dir), route: last.route, action: "check" });
     if (r.ok && r.result?.length) return { ...res, status: "clear", why: `${res.why}; its checks pass (${r.result.map((x) => x.check).join(", ")})` };
@@ -620,8 +621,8 @@ export async function provenanceOf(dir, file, { checks = false, call = routerCal
 export function confirm(dir, id, { by, note } = {}) {
   if (!by) throw new Expected("confirming needs the person's name (--by)", "refused");
   const file = `${JUDGMENTS}/${id}.json`;
-  if (!existsSync(join(dir, file))) throw new Expected(`no judgment ${id}`, "missing record");
-  const j = load(join(dir, file));
+  if (!existsSync(ventureFile(dir, file))) throw new Expected(`no judgment ${id}`, "missing record");
+  const j = load(ventureFile(dir, file));
   if (j.outcome === "uncertain") throw new Expected(`${id} is uncertain: answer its decision ${j.decision} instead`, "refused");
   const e = prov(dir, { entity: file, route: `knowledge/judgment/${id}`, activity: "confirm", agent: agentFromEnv("person", "cli", { id: by }), note: note ?? `confirmed ${j.package}/${j.step}${j.item ? ` for ${j.item}` : ""}` });
   return { confirmed: id, by, provenance: e.hash };

package/schema/naive-config.mjs

@@ -10,6 +10,7 @@
 
 import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 const repo = new URL("..", import.meta.url).pathname;
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
@@ -36,7 +37,7 @@ function merge(base, over) {
 
 /** The venture's naive.config.json as written, or {} when it has none. A file that is not JSON throws, naming the file. */
 export function rawConfig(dir) {
-  const f = dir && join(dir, CONFIG);
+  const f = dir && ventureFile(dir, CONFIG);
   if (!f || !existsSync(f)) return {};
   try { return load(f); } catch (e) { throw new Error(`${CONFIG} is not valid JSON: ${e.message}`); }
 }
@@ -139,7 +140,7 @@ export function pinsBlocking(config, recordType) {
 
 /** The venture's naive.config.json, or {} when it has none. A file that is not JSON throws. */
 export function readConfig(dir) {
-  const f = join(dir, CONFIG);
+  const f = ventureFile(dir, CONFIG);
   if (!existsSync(f)) return {};
   try { return JSON.parse(readFileSync(f, "utf8")); }
   catch (e) { throw new Error(`${CONFIG} is not valid JSON: ${e.message}`); }
@@ -149,7 +150,7 @@ export function readConfig(dir) {
 export function writeConfig(dir, cfg) {
   const order = ["naive", "packages", "kits", "triggers", "gate"];
   const out = Object.fromEntries([...order.filter((k) => cfg[k] !== undefined).map((k) => [k, cfg[k]]), ...Object.entries(cfg).filter(([k]) => !order.includes(k))]);
-  writeFileSync(join(dir, CONFIG), JSON.stringify(out, null, 2) + "\n");
+  writeFileSync(ventureFile(dir, CONFIG), JSON.stringify(out, null, 2) + "\n");
   return out;
 }
 

package/schema/need-now.mjs

@@ -15,6 +15,7 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 import { catalog } from "./departments.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const root = new URL("..", import.meta.url).pathname;
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
@@ -27,14 +28,14 @@ const glob = (g) => new RegExp("^" + g.replace(/[.+^${}()|[\]\\]/g, "\\$&").repl
 /** Facts about a venture that the need-now conditions test. */
 export function factsOf(dir) {
   const v = load(join(dir, "venture.json"));
-  const json = (p) => existsSync(join(dir, p)) ? load(join(dir, p)) : null;
-  const products = existsSync(join(dir, "products")) ? readdirSync(join(dir, "products")).filter((f) => f.endsWith(".json")).map((f) => load(join(dir, "products", f))) : [];
+  const json = (p) => existsSync(ventureFile(dir, p)) ? load(ventureFile(dir, p)) : null;
+  const products = existsSync(join(ventureFile(dir, "products"))) ? readdirSync(join(ventureFile(dir, "products"))).filter((f) => f.endsWith(".json")).map((f) => load(join(ventureFile(dir, "products"), f))) : [];
   const members = (v.members ?? []).map((m) => typeof m === "string" ? { kind: "person", role: m } : m);
   const own = json("governance/ownership.json");
-  const hDir = join(dir, "operations/handoffs");
+  const hDir = join(ventureFile(dir, "operations/handoffs"));
   const handoffs = existsSync(hDir) ? readdirSync(hDir).filter((f) => f.endsWith(".json")).map((f) => load(join(hDir, f))) : [];
   // The founding team, as the founder answered Naive's team question (EE-060): solo, cofounders or looking.
-  const teamFile = join(dir, "decisions/venture.team.decision.json");
+  const teamFile = join(ventureFile(dir, "decisions/venture.team.decision.json"));
   const td = existsSync(teamFile) ? load(teamFile) : null;
   const team = td?.status === "decided" ? ["solo", "cofounders", "looking"].find((t) => (td.answer ?? "").toLowerCase().startsWith(t)) ?? null : null;
   return {

package/schema/packages.mjs

@@ -31,6 +31,7 @@ import { route } from "../purpose/frameworks/idea-map/route.mjs";
 import { loadPackages } from "./load-packages.mjs";
 // Upgrades hook (U-5): packages a venture adopted early in naive.config.json open now.
 import { adopted } from "./naive-config.mjs";
+import { ventureFile } from "./venture-paths.mjs";
 
 const repo = new URL("..", import.meta.url).pathname;
 const load = (p) => JSON.parse(readFileSync(p, "utf8"));
@@ -39,7 +40,7 @@ export const OUT = "package";
 const MODEL = load(join(repo, "schema/data-model.json"));
 const PHASES = ["discovery", "validation", "beachhead", "scale", "platform"];
 const r2 = (x) => Math.round(x * 100) / 100;
-const json = (dir, f) => existsSync(join(dir, f)) ? load(join(dir, f)) : null;
+const json = (dir, f) => existsSync(ventureFile(dir, f)) ? load(ventureFile(dir, f)) : null;
 
 /** The facts the packages test: need-now's, the founder's flags, and the question matrix's answers. */
 export function situation(dir, { flags = {}, answers = null } = {}) {
@@ -52,7 +53,7 @@ export function situation(dir, { flags = {}, answers = null } = {}) {
   const settled = {
     raising: flags.raising != null ? !!flags.raising : f.funding === "bootstrapped" ? false : undefined,
     // A site read by site presence; a planned sitemap does not count, since the pipeline plans one for every venture.
-    site: existsSync(join(dir, "operations/marketing/site-presence.json")) || undefined,
+    site: existsSync(join(ventureFile(dir, "operations/marketing/site-presence.json"))) || undefined,
     partner_led: profiles.some((p) => p.reached_through?.length) || products.some((p) => (p.offered_to ?? []).some((id) => profiles.some((y) => y.reached_through?.includes(id)))) || undefined,
     hiring: flags.hiring != null ? !!flags.hiring : f.team === "looking" ? true : undefined,
     regulated: undefined,
@@ -60,7 +61,7 @@ export function situation(dir, { flags = {}, answers = null } = {}) {
   };
   const Q = PACKAGES.questions;
   // Jev's answers from the last written package stand, unless new answers replace them.
-  const last = existsSync(join(dir, OUT, "venture-package.json")) ? Object.fromEntries(load(join(dir, OUT, "venture-package.json")).situation.questions.filter((q) => q.p != null).map((q) => [`q:${q.id}`, { noul: q.p }])) : {};
+  const last = existsSync(join(ventureFile(dir, OUT), "venture-package.json")) ? Object.fromEntries(load(join(ventureFile(dir, OUT), "venture-package.json")).situation.questions.filter((q) => q.p != null).map((q) => [`q:${q.id}`, { noul: q.p }])) : {};
   answers = { ...last, ...(answers ?? {}) };
   const questions = Q.items.filter((q) => q.phases.includes(phase)).map((q) => {
     if (settled[q.id] !== undefined) return { ...q, value: settled[q.id], by: "records" };
@@ -77,8 +78,8 @@ export function request(dir) {
   const { questions } = situation(dir);
   const v = load(join(dir, "venture.json"));
   const say = (o) => o ? JSON.stringify(o).slice(0, 1200) : null;
-  const dumpFile = ["raw/dump.md", "purpose/ideas/dump.md"].find((f) => existsSync(join(dir, f)));
-  const dump = dumpFile ? readFileSync(join(dir, dumpFile), "utf8").slice(0, 2500) : null;
+  const dumpFile = ["raw/dump.md", "purpose/ideas/dump.md"].find((f) => existsSync(ventureFile(dir, f)));
+  const dump = dumpFile ? readFileSync(ventureFile(dir, dumpFile), "utf8").slice(0, 2500) : null;
   const problem = json(dir, "foundation/problem.json") ?? json(dir, "purpose/validation/problem.json");
   const icpRec = json(dir, "foundation/icp.json") ?? json(dir, "purpose/icp.json");
   return { state: { venture: say({ name: v.name, phase: v.phase, ambition: v.ambition, form: v.form, core: v.core }), problem: say(problem), icp: say(icpRec),
@@ -89,9 +90,9 @@ export function request(dir) {
 
 /** A record's state in this venture: confirmed by a person, written by an agent, waiting as a draft, or missing. */
 function stateOf(dir, type) {
-  const files = filesOf(dir, type).filter((f) => existsSync(join(dir, f)) && !(f.endsWith(".json") && ["retired", "archived"].includes(json(dir, f)?.status)));
+  const files = filesOf(dir, type).filter((f) => existsSync(ventureFile(dir, f)) && !(f.endsWith(".json") && ["retired", "archived"].includes(json(dir, f)?.status)));
   const drafts = (filesOf(dir, type).length ? filesOf(dir, type) : [MODEL.records.find((r) => r.id === type)?.paths?.find((p) => p.startsWith("instance/**/"))?.slice(12)].filter(Boolean))
-    .filter((f) => !f.includes("*") && existsSync(join(dir, `_drafts/${f.replace(/\//g, "__")}.draft`)));
+    .filter((f) => !f.includes("*") && existsSync(ventureFile(dir, `_drafts/${f.replace(/\//g, "__")}.draft`)));
   if (!files.length) return { status: drafts.length ? "draft" : "missing", files: [], drafts };
   const confirmed = files.every((f) => confirmedIn(dir, f, null));
   return { status: drafts.length ? "draft" : confirmed ? "confirmed" : "agent", files, drafts };
@@ -174,7 +175,7 @@ const LEAD = ["name", "title", "who", "statement", "question", "label", "id"];
 const lead = (o) => { const k = LEAD.find((k) => typeof o[k] === "string"); return k ? o[k] : ""; };
 const rest = (o) => { const k = LEAD.find((k) => typeof o[k] === "string"); return Object.fromEntries(Object.entries(o).filter(([x]) => x !== k)); };
 const body = (dir, f) => {
-  const t = readFileSync(join(dir, f), "utf8");
+  const t = readFileSync(ventureFile(dir, f), "utf8");
   if (f.endsWith(".json")) return md(JSON.parse(t));
   return t.replace(/^---\n[\s\S]*?\n---\n/, "").replace(/^#\s.*\n/, "").trim();
 };
@@ -183,7 +184,7 @@ const STATE = { complete: "complete: its automation may run", review: "every rec
 
 /** A new version each time a package completes or the phase changes; earlier versions are kept. */
 export function versions(dir, r) {
-  const f = join(dir, OUT, "venture-package.json");
+  const f = join(ventureFile(dir, OUT), "venture-package.json");
   const before = existsSync(f) ? load(f) : null;
   const list = before?.versions ?? [];
   const last = list.at(-1);
@@ -196,7 +197,7 @@ export function versions(dir, r) {
 
 /** Write the readable view: the manifest, the index, and one document per open core package. */
 export function write(dir, r) {
-  const out = join(dir, OUT);
+  const out = ventureFile(dir, OUT);
   mkdirSync(out, { recursive: true });
   r.versions = versions(dir, r);
   writeFileSync(join(out, "venture-package.json"), JSON.stringify(r, null, 2) + "\n");

package/schema/payouts.mjs

@@ -16,6 +16,7 @@
 
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { ventureFile } from "./venture-paths.mjs";
 
 export function payouts(own, value) {
   const classes = new Map(own.classes.map((c) => [c.id, c]));
@@ -74,8 +75,8 @@ export function payouts(own, value) {
 if (import.meta.url === `file://${process.argv[1]}`) {
   const [dir, arg] = process.argv.slice(2);
   if (!dir) { console.error("usage: node schema/payouts.mjs <venture dir> [value] [--json]"); process.exit(2); }
-  const own = JSON.parse(readFileSync(join(dir, "governance/ownership.json"), "utf8"));
-  const exitFile = join(dir, "governance/exit.json");
+  const own = JSON.parse(readFileSync(join(ventureFile(dir, "governance/ownership.json")), "utf8"));
+  const exitFile = join(ventureFile(dir, "governance/exit.json"));
   const scenarios = arg && !arg.startsWith("--") ? [{ id: "given", value: Number(arg) }]
     : existsSync(exitFile) ? JSON.parse(readFileSync(exitFile, "utf8")).scenarios ?? [] : [];
   if (!scenarios.length) { console.error("no scenarios: pass a value or add scenarios to governance/exit.json"); process.exit(2); }

package/schema/people.schema.json

@@ -29,8 +29,7 @@
         "required": [
           "id",
           "name",
-          "role",
-          "hats"
+          "role"
         ],
         "additionalProperties": false,
         "properties": {
@@ -65,7 +64,7 @@
               ]
             },
             "uniqueItems": true,
-            "description": "The functions this person owns (operations/departments.json)"
+            "description": "The functions this person owns. In the structured layout (EE-086) hats are read from the org chart in venture.json and not stored here"
           },
           "founder_file": {
             "type": "string",