naive-framework 0.2.0 → 0.3.0

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",