opennori 0.1.3 → 0.1.4

package/README.md

@@ -28,6 +28,9 @@ judgment.
 npx opennori
 ```
 
+It shows a short project setup preview and asks before writing `.opennori/` or the OpenNori Skill
+Pack. Agents and CI can add `--json` for the deterministic machine-readable protocol.
+
 For a project install:
 
 ```bash
@@ -82,6 +85,8 @@ language requests to the deterministic CLI state layer.
 - `bootstrap` gives agents one short entry for readiness checks and first-time preview. Lower-level
   `install`, `upgrade`, and `uninstall` still support preview-first workflows; destructive writes
   require explicit confirmation.
+- In a human terminal, `npx opennori` is interactive. With `--json` or non-interactive stdio it
+  returns structured JSON for agents and automation.
 - `doctor` reports whether project state is `ready`, `needs-action`, or `broken`, with recovery
   actions.
 - Nori Profile records required Skills, preferred stacks, avoided tools, and install policy without

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opennori",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "OpenNori: human-centered Nori Contracts and evidence records for coding agents.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -375,6 +375,10 @@ function printJson(payload) {
   console.log(JSON.stringify(payload, null, 2));
 }
 
+function printText(line = "") {
+  process.stdout.write(`${line}\n`);
+}
+
 function argValue(args, name, fallback = undefined) {
   const index = args.indexOf(name);
   if (index === -1 || index + 1 >= args.length) return fallback;
@@ -385,6 +389,14 @@ function hasFlag(args, name) {
   return args.includes(name);
 }
 
+function wantsJson(args) {
+  return hasFlag(args, "--json");
+}
+
+function isInteractive(args) {
+  return !wantsJson(args) && process.stdin.isTTY && process.stdout.isTTY;
+}
+
 const CLI_NAME = "opennori";
 const TOP_LEVEL_USAGE = `${CLI_NAME} <bootstrap|doctor|install|upgrade|uninstall|brainstorm|draft|init|list|check|approve|criterion|profile|resume|next|evidence|evaluate|status|report|context|changes|archive|skill>`;
 
@@ -419,6 +431,94 @@ function usageFor(args) {
   return TOP_LEVEL_USAGE;
 }
 
+function describeBootstrapAction(action) {
+  if (action.action === "create") return `create ${action.path}`;
+  if (action.action === "skip") return `keep existing ${action.path}`;
+  if (action.action === "exists") return `already exists ${action.path}`;
+  if (action.action === "update") return `update ${action.path}`;
+  if (action.action === "overwrite") return `overwrite ${action.path}`;
+  return `${action.action} ${action.path}`;
+}
+
+function printBootstrapPreview(payload) {
+  const data = payload.data;
+  printText("");
+  printText("OpenNori project setup");
+  printText(`Project: ${data.root}`);
+  printText("");
+
+  if (data.status === "ready") {
+    printText("OpenNori is already ready in this project.");
+    printText("Next: tell your agent the goal and ask it to use OpenNori.");
+    return;
+  }
+
+  printText("This will prepare OpenNori for this project:");
+  for (const action of data.install_plan.actions.filter((item) => item.would_write).slice(0, 8)) {
+    printText(`- ${describeBootstrapAction(action)}`);
+  }
+  const remaining = data.install_plan.summary.would_write - Math.min(data.install_plan.summary.would_write, 8);
+  if (remaining > 0) printText(`- plus ${remaining} more OpenNori project assets`);
+  printText("");
+  printText("No files have been written yet.");
+}
+
+function printBootstrapResult(payload) {
+  const data = payload.data;
+  printText("");
+  if (data.status === "installed") {
+    printText("OpenNori installed.");
+    printText(`Created or refreshed ${data.install_plan.summary.will_write} project assets.`);
+    printText("Next: tell your agent the goal and ask it to use OpenNori.");
+    return;
+  }
+  if (data.status === "ready") {
+    printText("OpenNori is ready.");
+    printText("Next: tell your agent the goal and ask it to use OpenNori.");
+    return;
+  }
+  printText(data.next || "OpenNori bootstrap finished.");
+}
+
+async function promptConfirm(message) {
+  process.stdout.write(`${message} [y/N] `);
+  return new Promise((resolve) => {
+    process.stdin.setEncoding("utf8");
+    process.stdin.once("data", (chunk) => {
+      process.stdin.pause();
+      resolve(/^y(es)?$/i.test(String(chunk).trim()));
+    });
+  });
+}
+
+async function runBootstrap(args) {
+  const root = resolveRoot(args);
+  const confirmed = hasFlag(args, "--confirm");
+
+  if (!isInteractive(args)) {
+    printJson(bootstrap(root, { confirmed }));
+    return;
+  }
+
+  if (confirmed) {
+    printBootstrapResult(bootstrap(root, { confirmed: true }));
+    return;
+  }
+
+  const preview = bootstrap(root, { confirmed: false });
+  printBootstrapPreview(preview);
+  if (preview.data.status === "ready") return;
+
+  const shouldInstall = await promptConfirm("Install OpenNori here?");
+  if (!shouldInstall) {
+    printText("");
+    printText("No changes made.");
+    return;
+  }
+
+  printBootstrapResult(bootstrap(root, { confirmed: true }));
+}
+
 function argValues(args, name) {
   const values = [];
   for (let index = 0; index < args.length; index += 1) {
@@ -1495,9 +1595,7 @@ export async function main(args) {
   }
 
   if (command === "bootstrap") {
-    const root = resolveRoot(args);
-    const confirmed = hasFlag(args, "--confirm");
-    printJson(bootstrap(root, { confirmed }));
+    await runBootstrap(args);
     return;
   }