@opennous/cli 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @opennous/cli changelog
 
+## 0.16.0
+
+### Added: your Intelligence report after `backfill`
+
+When the read is done, `backfill` writes your Intelligence report: private to you, built from what it
+read. Its executive summary, recommended next steps and objection responses are written by your own model, from the report's data only,
+with no tools. The command prints the link. If that step fails, the report is still there (GET-1199).
+
 ## 0.15.0
 
 ### Added: Slack in `backfill`

package/README.md

@@ -1,16 +1,16 @@
 # @opennous/cli
 
-Nous CLI — set Nous up, connect it to your coding agent, and read the Context API from your terminal.
+Ownable CLI — set Ownable up, connect it to your coding agent, and read the Context API from your terminal.
 
 ## Get started
 
-One command. It signs you in (creating your account if you don't have one), registers the Nous MCP server with the agent on your machine, and hands off. The same command on macOS, Linux, and Windows (needs [Node 18+](https://nodejs.org)):
+One command. It signs you in (creating your account if you don't have one), registers the Ownable MCP server with the agent on your machine, and hands off. The same command on macOS, Linux, and Windows (needs [Node 18+](https://nodejs.org)):
 
 ```bash
 npx @opennous/cli@latest init
 ```
 
-Then tell your agent *"set up my Nous workspace"* — it reads your project, finds your ICP (or drafts one), and syncs it. On self-host, add `--url https://api.yourdomain.com`.
+Then tell your agent *"set up my Ownable workspace"* — it reads your project, finds your ICP (or drafts one), and syncs it. On self-host, add `--url https://api.yourdomain.com`.
 
 ## Event tracking
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@opennous/cli",
-  "version": "0.15.0",
-  "description": "Nous CLI — set up Nous, connect it to your coding agent, and read the Context API from your terminal",
+  "version": "0.16.0",
+  "description": "Ownable CLI — set up Ownable, connect it to your coding agent, and read the Context API from your terminal",
   "type": "module",
   "bin": {
     "nous": "src/index.js"

package/src/backfill.js

@@ -105,12 +105,41 @@ export function estimateLine(days, counts) {
   return `Last ${days} days: about ${counts?.email_thread ?? 0} email threads, ${counts?.meeting ?? 0} meetings, ${counts?.call ?? 0} calls${slack}.`;
 }
 
+/**
+ * "5 to review: https://…/review (12 not on file)", or null when there is nothing to decide. Pure.
+ * To review is Probably mentions plus open groups (GET-1152); a mention nothing on file could be is
+ * not on file and never counted. An older server sends only `mentions`.
+ */
+export function reviewLine(review) {
+  const n = Number(review?.to_review ?? review?.mentions ?? 0);
+  if (!Number.isFinite(n) || n <= 0) return null;
+  const quiet = Number(review?.not_on_file ?? 0);
+  return `${n} to review${review?.url ? `: ${review.url}` : ""}${quiet > 0 ? ` (${quiet} not on file)` : ""}`;
+}
+
+/**
+ * Who each person is, before anything is read (GET-1159): the people worth a look, as a short table,
+ * with where to confirm them. Null when there is nothing to show. Pure.
+ */
+export function proposalsLines(rel) {
+  if (!rel || !(rel.judged > 0)) return null;
+  const pct = (c) => `${Math.round(Number(c ?? 0) * 100)}%`;
+  const lines = [`Who's who: ${rel.judged} people judged, ${rel.to_confirm ?? 0} worth a look.`];
+  const top = (rel.top ?? []).slice(0, 15);
+  const w = Math.min(28, Math.max(4, ...top.map((p) => String(p.name ?? "Unknown").length)));
+  for (const p of top) lines.push(`  ${String(p.name ?? "Unknown").slice(0, w).padEnd(w)}  ${String(p.group ?? "").padEnd(14)} ${pct(p.confidence).padStart(4)}  ${p.reason ?? ""}`.trimEnd());
+  if (rel.url) lines.push(`Confirm or fix them: ${rel.url}`);
+  lines.push(rel.waiting ? "Waiting for you to confirm before reading (or Ctrl-C and run with --yes)." : rel.mode === "yes" ? "Accepted as proposed." : "Reading now; fixing someone later re-reads their calls.");
+  return lines;
+}
+
 /** Nothing to read in this window. Pure. */
 export const emptyEstimate = (counts) => !Object.values(counts ?? {}).some((n) => n > 0);
 
 /** One line on how far the job is, or null when there is nothing to say yet. Pure. */
 export function progressLine(reading, answered, rerun = RERUN) {
   if (reading?.finished) return "Wrapping up: last summaries for your accounts.";
+  if (reading?.kind === "relationships") return `Working out who each person is, before reading. ${`Stop any time with Ctrl-C; run \`${rerun}\` again to carry on.`}`;
   const stop = `Stop any time with Ctrl-C; run \`${rerun}\` again to carry on.`;
   const what = { meetings: "meetings", slack: "Slack conversations" }[reading?.kind] ?? "email threads";
   if (reading?.total) return `Read ${reading.done} of ${reading.total} ${what}. ${stop}`;
@@ -124,7 +153,7 @@ export function progressLine(reading, answered, rerun = RERUN) {
  * is saved, and unanswered calls come back to the next run.
  */
 export async function runBackfill({ api, agent, jobId, run, sleep, log, now = Date.now, workers = WORKERS, limitWaitMs = LIMIT_WAIT_MS, pollMs = POLL_MS, progressMs = PROGRESS_MS, rerun = RERUN }) {
-  let waitUntil = 0, answered = 0, lastLine = null, lastAt = -Infinity;
+  let waitUntil = 0, answered = 0, lastLine = null, lastAt = -Infinity, shownProposals = false;
   const say = (line) => {
     if (!line || (line === lastLine && now() - lastAt < progressMs) || now() - lastAt < Math.min(progressMs, 1000)) return;
     lastLine = line; lastAt = now(); log(line);
@@ -149,10 +178,15 @@ export async function runBackfill({ api, agent, jobId, run, sleep, log, now = Da
   };
   for (;;) {
     const page = await api.calls(jobId, workers);
-    if (page.status === "done") return { status: "done", answered, read: page.reading?.read ?? 0, failed: page.reading?.failed ?? 0 };
+    if (page.status === "done") return { status: "done", answered, read: page.reading?.read ?? 0, failed: page.reading?.failed ?? 0, ...(page.memory_review ? { memoryReview: page.memory_review } : {}) };
     if (page.status === "failed") throw new Error(page.error || "The backfill failed on our side.");
     // The server gave up waiting for us (a long sleep, say). We're back, so pick it up.
     if (page.status === "paused_own_model") { await api.resume?.(); await sleep(pollMs); continue; }
+    // Phase 1's proposals (GET-1159), once, as soon as they are in.
+    if (!shownProposals && page.relationships?.judged > 0) {
+      shownProposals = true;
+      for (const l of proposalsLines(page.relationships) ?? []) log(l);
+    }
     say(progressLine(page.reading, answered, rerun));
     if (!page.calls.length) { await sleep(pollMs); continue; }
     await Promise.all(page.calls.map((c) => answerOne(c, page.models)));
@@ -164,3 +198,21 @@ export function liveRun() {
   const cwd = mkdtempSync(join(tmpdir(), "nous-backfill-"));
   return (command) => runCommand(command, cwd);
 }
+
+/**
+ * The Intelligence report (GET-1199), once the read is done. The server builds it from what was
+ * filed; its Summary and Recommended actions are then written by your own model, from the report's
+ * data only, with no tools. If that fails the report keeps the ones code wrote. Returns its link,
+ * or null. Injected like runBackfill: `api` ({ report, writing }), `run`.
+ */
+export async function writeReport({ api, agent, jobId, run }) {
+  const r = await api.report(jobId);
+  const models = r?.models?.[agent];
+  if (r?.writing && models) {
+    try {
+      const { text } = parseAnswer(agent, await run(commandFor(agent, models, r.writing)));
+      await api.writing(jobId, { answer: text, model: models.model });
+    } catch { /* the report stands as code wrote it */ }
+  }
+  return r?.url ?? null;
+}

package/src/certHint.js

@@ -1,4 +1,4 @@
-// A self-hosted Nous on a laptop serves https://api.localhost with Caddy's own local CA, which
+// A self-hosted Ownable on a laptop serves https://api.localhost with Caddy's own local CA, which
 // Node does not trust. fetch then rejects with a bare "fetch failed" whose cause carries one of
 // these codes. Name the fix in one line instead of printing a stack trace (GET-1011).
 const UNTRUSTED_CERT_CODES = new Set([

package/src/hooks/icp-sync-reminder.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-// Nous ICP auto-sync reminder (installed by `npx @opennous/cli init`).
+// Ownable ICP auto-sync reminder (installed by `npx @opennous/cli init`).
 //
-// A Claude Code PostToolUse hook. After the agent edits a Nous context file, it
+// A Claude Code PostToolUse hook. After the agent edits an Ownable context file, it
 // reminds the agent that the file is INERT until synced: the app, the ICP tab, and
-// the ICP scoring model read the Nous GRAPH, not the repo file, so an edit does
+// the ICP scoring model read the Ownable GRAPH, not the repo file, so an edit does
 // nothing until mcp__nous__sync_icp runs. Standalone Node (no bash/jq) so it behaves
 // identically on Windows, macOS, and Linux.
 
@@ -25,8 +25,8 @@ process.stdin.on("end", () => {
     const base = norm.split("/").pop().toLowerCase();
 
     const ctx = base === "icp.md"
-      ? `You just edited ${rel}, your Nous ICP file. It is INERT until synced: the app, the ICP tab, and the ICP scoring model read the Nous graph, not this file. Call the mcp__nous__sync_icp tool THIS TURN with section "ICP" and source_path "${rel}", passing the file body as the section content, so the graph and the scoring model rebuild from your edit. Do not end the turn with the ICP file edited but unsynced.`
-      : `You edited a Nous context file (${rel}). It stays inert until synced into the Nous graph. If it is an ICP, positioning, pricing, competitors, or market file, call mcp__nous__sync_icp this turn with the matching section and its source_path so the graph updates.`;
+      ? `You just edited ${rel}, your Ownable ICP file. It is INERT until synced: the app, the ICP tab, and the ICP scoring model read the Ownable graph, not this file. Call the mcp__nous__sync_icp tool THIS TURN with section "ICP" and source_path "${rel}", passing the file body as the section content, so the graph and the scoring model rebuild from your edit. Do not end the turn with the ICP file edited but unsynced.`
+      : `You edited an Ownable context file (${rel}). It stays inert until synced into the Ownable graph. If it is an ICP, positioning, pricing, competitors, or market file, call mcp__nous__sync_icp this turn with the matching section and its source_path so the graph updates.`;
 
     process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: ctx } }));
   } catch { /* never block a tool call */ }

package/src/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// OpenNous CLI — the setup + auth utility. NOT a data surface.
+// Ownable CLI — the setup + auth utility. NOT a data surface.
 //
 // It signs you in (browser device flow → key in ~/.nous/config.json) and installs the
 // opennous plugin into your agent (`init`). All data work happens in the agent through
@@ -120,7 +120,8 @@ function apiClient(key) {
     process.exit(1);
   }
 
-  async function request(method, path, { body, query } = {}) {
+  // soft: a failure throws instead of ending the process, for a step that may fail on its own.
+  async function request(method, path, { body, query, soft = false } = {}) {
     const url = new URL(path, apiUrl);
     if (query) {
       for (const [k, v] of Object.entries(query)) {
@@ -135,11 +136,13 @@ function apiClient(key) {
         body: body ? JSON.stringify(body) : undefined,
       });
     } catch (e) {
+      if (soft) throw e;
       console.error(certHint(e) || `Couldn't reach ${apiUrl}: ${e.message}`);
       process.exit(1);
     }
     if (!res.ok) {
       const err = await res.json().catch(() => ({ message: res.statusText }));
+      if (soft) throw new Error(err.message || err.error || `HTTP ${res.status}`);
       console.error(`Error: ${err.message || err.error}`);
       process.exit(1);
     }
@@ -150,6 +153,7 @@ function apiClient(key) {
   return {
     get: (path, query) => request("GET", path, { query }),
     post: (path, body) => request("POST", path, { body }),
+    softPost: (path, body) => request("POST", path, { body, soft: true }),
   };
 }
 
@@ -163,7 +167,7 @@ program
   .addCommand(
     new Command("login")
       .description("Save your API key")
-      .requiredOption("--key <key>", "Your Nous API key")
+      .requiredOption("--key <key>", "Your Ownable API key")
       .option("--url <url>", "API base URL (default: https://api.opennous.cloud)")
       .action(({ key, url }) => {
         const cfg = readConfig();
@@ -205,7 +209,7 @@ program
 // ---------------------------------------------------------------------------
 // You're already signed in (the saved key identifies you), so there's no device-code
 // dance — we start a Composio consent, open it in your browser, and poll until the
-// account goes ACTIVE. Composio holds the OAuth token; Nous never sees it.
+// account goes ACTIVE. Composio holds the OAuth token; Ownable never sees it.
 const CONNECT_ALIASES = {
   gmail: "gmail_oauth",
   gmail_oauth: "gmail_oauth",
@@ -329,11 +333,11 @@ program
   });
 
 // ---------------------------------------------------------------------------
-// Connect OpenNous to whatever agent is on this machine — host-aware.
+// Connect Ownable to whatever agent is on this machine — host-aware.
 //
 // The MCP server (7 primitives) is the universal capability: any MCP host runs `npx @opennous/mcp`.
 // But the SKILLS + routing are the product surface, and those are delivered per host:
-//   • Claude Code  → the OpenNous PLUGIN (skills + routing hooks + the trimmed MCP, one install).
+//   • Claude Code  → the Ownable PLUGIN (skills + routing hooks + the trimmed MCP, one install).
 //   • Any other host (Cursor, Codex, Claude Desktop, …) → the trimmed MCP via a `.mcp.json`;
 //     each host's skills pack ships as we light it up.
 // So `init` installs the plugin on Claude Code, and writes the MCP config everywhere else — one
@@ -388,7 +392,7 @@ function writeJsonMcp(path, apiUrl) {
 const PLUGIN_MARKETPLACE = "NousC/revenue-plugin";
 const PLUGIN_ID = "opennous@opennous";
 
-// Claude Code → install the OpenNous PLUGIN (skills + routing hooks + the trimmed MCP, in one).
+// Claude Code → install the Ownable PLUGIN (skills + routing hooks + the trimmed MCP, in one).
 // We try the plugin CLI; if this Claude build has no `plugin` subcommand it returns null and the
 // caller prints the two slash-commands instead. We deliberately do NOT fall back to a bare
 // `claude mcp add` — a standalone MCP server would duplicate the plugin's and drop the skills.
@@ -404,11 +408,11 @@ function installClaudePlugin() {
 function registerMcpServer(apiUrl) {
   const path = join(process.cwd(), ".mcp.json");
   writeJsonMcp(path, apiUrl);
-  return `Wrote ${path} — your agent will pick up OpenNous (7 primitives) from it.`;
+  return `Wrote ${path} — your agent will pick up Ownable (7 primitives) from it.`;
 }
 
 // Install the ICP auto-sync hook into the project's Claude Code config. Once in place,
-// editing a Nous context file (context/**/icp.md, etc.) reminds the agent to call
+// editing an Ownable context file (context/**/icp.md, etc.) reminds the agent to call
 // sync_icp that turn — because an edited ICP file is INERT until synced into the graph.
 // Copies our packaged hook script into .claude/hooks/ and merges the PostToolUse entry
 // into .claude/settings.json WITHOUT clobbering any existing hooks or settings.
@@ -447,7 +451,7 @@ function installIcpSyncHook() {
 // This is the command the install script and the marketing site point to.
 program
   .command("init")
-  .description("Get started — sign in and connect Nous to your agent")
+  .description("Get started — sign in and connect Ownable to your agent")
   .option("--url <url>", "API base URL (default: https://api.opennous.cloud)")
   .option("--no-register", "Skip registering the MCP server (just sign in)")
   .action(async ({ url, register }) => {
@@ -460,41 +464,41 @@ program
         let installed = false;
         try { installed = installClaudePlugin(); } catch { /* fall through to instructions */ }
         if (installed) {
-          console.log("\n✓ Installed the OpenNous plugin into Claude Code — skills, routing, and the 8 primitives.");
-          console.log("  Open Claude Code and OpenNous starts onboarding automatically.");
+          console.log("\n✓ Installed the Ownable plugin into Claude Code — skills, routing, and the 8 primitives.");
+          console.log("  Open Claude Code and Ownable starts onboarding automatically.");
           console.log(dim("  (Already have it open? Start a new session so the skills load.)"));
         } else {
-          console.log("\nDetected Claude Code. Install the OpenNous plugin (skills + hooks + tools):");
+          console.log("\nDetected Claude Code. Install the Ownable plugin (skills + hooks + tools):");
           console.log("  /plugin marketplace add NousC/revenue-plugin");
           console.log("  /plugin install opennous@opennous");
-          console.log(dim("  Then open Claude Code — OpenNous starts onboarding on its own."));
+          console.log(dim("  Then open Claude Code — Ownable starts onboarding on its own."));
         }
       } else {
         try {
           console.log(`\n${registerMcpServer(apiUrl)}`);
         } catch {
-          console.log("\nCouldn't write .mcp.json automatically. Add OpenNous to your host's MCP config:");
+          console.log("\nCouldn't write .mcp.json automatically. Add Ownable to your host's MCP config:");
           console.log(`  command: ${MCP_CMD}  args: ${MCP_ARGS.join(" ")}  env: NOUS_SURFACE=plugin`);
         }
       }
 
       // Auto-sync the ICP: a Claude Code hook so editing your ICP file reminds the
-      // agent to sync it into Nous (the file is inert until synced). Best-effort —
+      // agent to sync it into Ownable (the file is inert until synced). Best-effort —
       // a convenience, never a reason to fail setup.
       try {
         const already = installIcpSyncHook();
-        if (!already) console.log("Installed the ICP auto-sync hook — edits to your ICP file now sync to Nous automatically.");
+        if (!already) console.log("Installed the ICP auto-sync hook — edits to your ICP file now sync to Ownable automatically.");
       } catch { /* non-fatal */ }
     }
 
-    console.log("\n✅ Signed in. Open Claude Code — OpenNous will walk you through onboarding on its own.");
+    console.log("\n✅ Signed in. Open Claude Code — Ownable will walk you through onboarding on its own.");
     console.log("\n" + dim("Docs: https://docs.opennous.cloud/mcp/introduction"));
   });
 
 // nous pull — write the Vault into ./context/*.md and hand authorship to the repo.
 //
 // The bridge for the Google road. A user who set up in the browser has a Vault whose author
-// is Nous (source 'nous', no file). The day they open a repo and connect an agent, that
+// is Ownable (source 'nous', no file). The day they open a repo and connect an agent, that
 // arrangement is backwards: they now live in files, and the Vault should mirror the files,
 // not the other way round. `pull` flips it — it writes each context doc to disk and re-syncs
 // it WITH its path, which sets source='claude_code'. From then on their repo is the author,
@@ -506,7 +510,7 @@ const PULL_KINDS = { icp: "icp.md" };
 
 program
   .command("pull")
-  .description("Write your Nous context docs into ./context and let your repo own them")
+  .description("Write your Ownable context docs into ./context and let your repo own them")
   .option("--dir <path>", "Where to write the context/ folder (default: cwd)", process.cwd())
   .option("--force", "Overwrite files that already exist", false)
   .action(async ({ dir, force }) => {
@@ -542,7 +546,7 @@ program
 
     console.log(`\n✓ ${written} written${skipped ? `, ${skipped} skipped` : ""}. Your repo now owns your context.`);
     if (synced < written) console.log(dim("  (some didn't sync back — re-run `nous pull` to finish)"));
-    console.log(dim("Edit these files and your agent syncs them with sync_foundation. Nous mirrors them."));
+    console.log(dim("Edit these files and your agent syncs them with sync_foundation. Ownable mirrors them."));
   });
 
 // nous logout — top-level alias of `auth logout`. Removes the saved API key.
@@ -552,10 +556,11 @@ program
   .option("--agent <agent>", "claude or codex (default: whichever you're signed in to)")
   .option("--days <days>", "how many days back to read, 1 to 730", "180")
   .option("--workspace <id>", "the workspace to read; the app's command fills this in")
-  .option("--yes", "start without asking")
+  .option("--yes", "start without asking, and accept who each person is as proposed")
+  .option("--confirm", "wait until you confirm who each person is in Routing before reading")
   .option("--url <url>", "API base URL (default: https://api.opennous.cloud)")
   .action(async (opts) => {
-    const { detectAgents, runBackfill, liveRun, emptyEstimate, estimateLine, rerunCommand, NO_AGENT } = await import("./backfill.js");
+    const { detectAgents, runBackfill, liveRun, emptyEstimate, estimateLine, rerunCommand, reviewLine, writeReport, NO_AGENT } = await import("./backfill.js");
     const days = Number(opts.days);
     if (!Number.isInteger(days) || days < 1 || days > 730) {
       console.error("--days must be a whole number from 1 to 730.");
@@ -602,7 +607,7 @@ program
     }
     console.log(`\nWorkspace: ${workspace}`);
     console.log(estimateLine(days, est.counts));
-    console.log(`They're filtered first, then read on your ${agent} plan. None of it uses your OpenNous credits.`);
+    console.log(`They're filtered first, then read on your ${agent} plan. None of it uses your Ownable credits.`);
     console.log("You can stop at any time and run this again: it carries on where it stopped.\n");
     if (!opts.yes) {
       const { createInterface } = await import("node:readline/promises");
@@ -611,23 +616,38 @@ program
       rl.close();
       if (!ok) return;
     }
-    const job = await api.post("/v2/backfill/own", { days });
+    // Who each person is (GET-1159): read with the proposals by default; --confirm waits for you, --yes accepts them.
+    const confirm = opts.confirm ? "wait" : opts.yes ? "yes" : "proceed";
+    const job = await api.post("/v2/backfill/own", { days, confirm });
     console.log(job.resumed ? "Picking up where you left off. Stop any time with Ctrl-C." : `Started. Stop any time with Ctrl-C; run \`${rerun}\` again to carry on.`);
     process.once("SIGINT", () => {
       console.log(`\nStopped. Everything read so far is saved. Run \`${rerun}\` to carry on.`);
       process.exit(130);
     });
+    const run = liveRun();
     const result = await runBackfill({
-      agent, jobId: job.job_id, run: liveRun(), log: console.log, rerun,
+      agent, jobId: job.job_id, run, log: console.log, rerun,
       sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
       api: {
         calls: (id, limit) => api.get(`/v2/backfill/own/${id}/calls`, { limit }),
         answer: (id, body) => api.post(`/v2/backfill/own/calls/${id}`, body),
-        resume: () => api.post("/v2/backfill/own", { days }),
+        resume: () => api.post("/v2/backfill/own", { days, confirm }),
       },
     });
     console.log(`Done. This run: ${result.read} conversations read, ${result.answered} model calls on your ${agent} plan.`);
     if (result.failed) console.log(`${result.failed} conversations couldn't be read. Run \`${rerun}\` again to retry them.`);
+    const review = reviewLine(result.memoryReview);
+    if (review) console.log(review);
+    // The Intelligence report (GET-1199): private to you, its summary written on your plan.
+    console.log("Writing your Intelligence report…");
+    const reportUrl = await writeReport({
+      agent, jobId: job.job_id, run,
+      api: {
+        report: (id) => api.softPost(`/v2/backfill/own/${id}/report`, {}),
+        writing: (id, body) => api.softPost(`/v2/backfill/own/${id}/report/writing`, body),
+      },
+    }).catch(() => null);
+    if (reportUrl) console.log(`Your Intelligence report is ready: ${reportUrl}`);
   });
 
 program