naive-framework 0.1.0 → 0.3.0

package/interface/cli/naive.mjs

@@ -3,17 +3,21 @@
 // venture.json in the current directory or its parents. mentura stays for platform commands and as an
 // alias, so `mentura typegen` and `mentura upgrade` run these same commands.
 //
-//   naive dev [--port 4331]                         the board, live: edit a record and it updates; each saved
+//   naive dev [--port 4331]                         the setup page at /setup and the board, live: edit a record and it updates; each saved
 //                                                   record is checked against its schema as you go (I-17, I-24)
 //   naive build                                     check every package and write a release (I-17)
 //   naive start                                     serve the latest release read-only (I-17)
 //   naive check                                     run every check that applies to the venture (I-9)
 //   naive info                                      versions, the venture, and which agents are connected (I-6)
 //   naive mcp                                       serve the venture to an agent over MCP (stdio)
+//   naive setup [state|artifact|answer|point|confirm]  set the venture up: the state, an artifact of it, and
+//                                                   confirming the answers the model relayed (EE-083)
+//   naive frame "<the founder's words>"             match the words to a frame in the decision library, judge its
+//                                                   premises against the venture and propose its decisions, open
 //   naive typegen                                   write .naive/types/ from the route table and the MCP tools
 //   naive upgrade [<venture dir>] [--framework]     move a venture onto the next Naive layout; --framework first
 //                                                   updates the installed framework with the venture's package manager (I-29)
-//   naive port --from <project> --venture <dir>     plan bringing a project in with its files as they are
+//   naive port <folder> --venture <dir> [--to <path>]  plan moving a folder into the venture as it is (repo/<name>)
 //   naive port --venture <dir> --apply --confirm port
 //                                                   carry out that plan (EE-076)
 //   naive migrate --from <project> --venture <dir>  an agent rewrites the project as Naive records, as a plan and decisions
@@ -26,6 +30,8 @@ import { existsSync, mkdirSync, readFileSync, watch, writeFileSync } from "node:
 import { createServer } from "node:net";
 import { basename, join, relative, resolve } from "node:path";
 import { asRouted, findVenture } from "./find-venture.mjs";
+import { logical } from "../../schema/venture-paths.mjs";
+import { ventureFile } from "../../schema/venture-paths.mjs";
 
 const repo = new URL("../..", import.meta.url).pathname;
 const [cmd, ...rest] = process.argv.slice(2);
@@ -62,21 +68,35 @@ async function dev(dir) {
   const { workspace, venture } = asRouted(dir);
   process.env.MENTURA_WORKSPACE = workspace;
   const port = await free(Number(opt("port") ?? 4331));
+  // One origin: /setup is the setup page (interface/dev/setup.mjs); everything else is the board, served
+  // on a port of its own and passed through.
   const { serve } = await import("../demo/board.mjs");
-  serve(port, venture);
+  const { handle } = await import("../dev/setup.mjs");
+  const boardPort = await free(port + 1000);
+  serve(boardPort, venture);
+  const { createServer: http, request } = await import("node:http");
+  http(async (req, res) => {
+    if (await handle(req, res, dir)) return;
+    const up = request({ host: "127.0.0.1", port: boardPort, path: req.url, method: req.method, headers: req.headers }, (r) => { res.writeHead(r.statusCode, r.headers); r.pipe(res); });
+    up.on("error", (e) => { res.writeHead(502); res.end(String(e.message)); });
+    req.pipe(up);
+  }).listen(port, "127.0.0.1");
   const name = JSON.parse(readFileSync(join(dir, "venture.json"), "utf8")).name ?? venture;
-  console.log(`\n  ▲ Naive ${version()}\n  - Venture:  ${name} (${relative(process.cwd(), dir) || "."})\n  - Board:    http://127.0.0.1:${port}/\n  - Map:      http://127.0.0.1:${port}/map\n\n  Watching for changes. Each saved record is checked against its schema. Ctrl-C to stop.\n`);
+  console.log(`\n  ▲ Naive ${version()}\n  - Venture:  ${name} (${relative(process.cwd(), dir) || "."})\n  - Setup:    http://127.0.0.1:${port}/setup\n  - Board:    http://127.0.0.1:${port}/\n  - Map:      http://127.0.0.1:${port}/map\n\n  Watching for changes. Each saved record is checked against its schema. Ctrl-C to stop.\n`);
   // Live feedback on save (I-24): a record that no longer matches its schema says so at once.
   const pending = new Map();
-  watch(dir, { recursive: true }, (_, f) => {
-    if (!f || !f.endsWith(".json") || f.startsWith("node_modules") || f.startsWith(".naive") || f.startsWith("_private")) return;
+  watch(dir, { recursive: true }, (_, raw) => {
+    if (!raw || !raw.endsWith(".json") || raw.startsWith("node_modules") || raw.startsWith(".naive")) return;
+    // The record's logical path (schema/venture-paths.mjs): knowledge/foundation/icp.json is foundation/icp.json.
+    const physicalPath = raw, f = logical(dir, raw);
+    if (f.startsWith("_private")) return;
     clearTimeout(pending.get(f));
     pending.set(f, setTimeout(async () => {
       pending.delete(f);
-      if (!existsSync(join(dir, f))) return;
+      if (!existsSync(ventureFile(dir, physicalPath))) return;
       const schema = await schemaFor(f);
       if (!schema) return;
-      const v = spawnSync("python3", [join(repo, "schema/validate.py"), "--schema", schema.replace(/^schema\//, ""), "--file", join(dir, f)], { encoding: "utf8" });
+      const v = spawnSync("python3", [join(repo, "schema/validate.py"), "--schema", schema.replace(/^schema\//, ""), "--file", ventureFile(dir, physicalPath)], { encoding: "utf8" });
       const out = (v.stdout + v.stderr).trim();
       if (v.status === 0) console.log(`  ✓ ${f}`);
       else if (/needs jsonschema/.test(out)) console.log(`  - ${f} changed (install python3's jsonschema package to check it as you save)`);
@@ -85,13 +105,12 @@ async function dev(dir) {
   });
 }
 
-// The checks that read a workspace, run on the folder that holds this venture.
-const CHECKS = ["check-ventures", "check-provenance", "check-sources", "check-data-packages", "check-governance", "check-telos", "check-publication", "check-private", "check-where-used"];
+// The checks that read a workspace, run on this venture: it and the ventures nested in it, not its neighbours.
+const CHECKS = ["check-ventures", "check-people", "check-provenance", "check-sources", "check-data-packages", "check-governance", "check-telos", "check-publication", "check-private", "check-where-used"];
 function check(dir) {
-  const { workspace } = asRouted(dir);
   let failed = 0;
   for (const c of CHECKS) {
-    const r = spawnSync("node", [join(repo, `schema/${c}.mjs`), workspace], { encoding: "utf8" });
+    const r = spawnSync("node", [join(repo, `schema/${c}.mjs`), dir], { encoding: "utf8" });
     const last = (r.stdout + r.stderr).trim().split("\n").filter(Boolean).at(-1) ?? "";
     if (r.status !== 0) failed++;
     console.log(`${r.status === 0 ? "pass" : "FAIL"}  ${c.replace("check-", "")}: ${last}`);
@@ -115,7 +134,7 @@ function info(dir) {
     `Platform     ${process.platform} ${process.arch}`,
     `python3      ${spawnSync("python3", ["-c", "import jsonschema; print('jsonschema ' + __import__('importlib.metadata').metadata.version('jsonschema'))"], { encoding: "utf8" }).stdout.trim() || "jsonschema missing (needed by schema checks)"}`,
     `Venture      ${v ? `${v.name ?? v.id} (${v.phase}) at ${dir}` : "none here"}`,
-    "Agents       " + agents.map(([name, f, ok]) => `${name}: ${dir && ok(read(join(dir, f))) ? "connected" : "not connected"}`).join(", "),
+    "Agents       " + agents.map(([name, f, ok]) => `${name}: ${dir && ok(read(ventureFile(dir, f))) ? "connected" : "not connected"}`).join(", "),
   ];
   console.log(lines.join("\n"));
 }
@@ -150,7 +169,18 @@ else if (cmd === "build" || cmd === "start") {
   // Outside a venture with none named, upgrade-venture.mjs prints its usage.
   const dir = rest[0] && !rest[0].startsWith("--") ? resolve(rest[0]) : (opt("venture") ? here() : findVenture());
   if (dir && rest.includes("--framework") && upgradeFramework(dir) !== 0) process.exit(1);
-  process.exit(run("schema/upgrade-venture.mjs", dir ? [dir] : []));
+  // Flags (--check, --guide, --adopt, --canary, --agent, --accept, --confirm) pass through to upgrade-venture.mjs; --framework and --venture are handled here.
+  const flags = rest.filter((a, i) => !(i === 0 && !a.startsWith("--")) && a !== "--framework" && a !== "--venture" && rest[i - 1] !== "--venture");
+  process.exit(run("schema/upgrade-venture.mjs", dir ? [dir, ...flags] : flags));
+} else if (cmd === "frame") {
+  // The decision library (schema/frames.mjs): naive frame "<the founder's words>" runs the frame those words fit.
+  const sub = rest[0];
+  if (["list", "match", "check", "eval"].includes(sub)) process.exit(run("schema/frames.mjs", rest));
+  const words = rest.filter((a, i) => a !== "--venture" && rest[i - 1] !== "--venture" && a !== "--frame" && rest[i - 1] !== "--frame" && a !== "--lookup" && rest[i - 1] !== "--lookup").join(" ");
+  process.exit(run("schema/frames.mjs", ["run", here(), ...(opt("frame") ? [opt("frame")] : []), ...(words ? ["--text", words] : []), ...(opt("lookup") ? ["--lookup", opt("lookup")] : [])]));
+} else if (cmd === "setup") {
+  // Setup in the model's harness (EE-083): the state, the artifact, and the founder confirming relayed answers.
+  process.exit(run("schema/setup.mjs", [here(), ...(rest.length ? rest.filter((a, i) => a !== "--venture" && rest[i - 1] !== "--venture") : ["state"])]));
 } else if (cmd === "port" || cmd === "migrate") {
   // Inside a venture, --venture defaults to it.
   const args = rest.includes("--venture") ? rest : [...rest, "--venture", here()];