motifcode 0.2.0 → 0.2.1

package/README.md

@@ -13,11 +13,13 @@ failure handling follow from what is measurably true about Motif-3.
 > Technologies or by Infron. *Motif* and *Motif-3* are their names; this package is a client of the model.
 
 ```bash
-npm install -g motifcode     # or: npx motifcode
 cd your-project
-motif                        # the first session asks for your Infron API key and saves it to ~/.motif/.env
+npx motifcode                # asks for your Infron API key once, then offers to install the `motif` command
 ```
 
+Or `npm install -g motifcode` directly; either way `motif` (or `motifcode`) opens the session
+from any folder afterwards, with the key saved in `~/.motif/.env`.
+
 1. Sign in at [infron.ai/login](https://infron.ai/login), open [Dashboard → API Keys](https://infron.ai/dashboard/apiKeys), click **Add new key**.
 2. Run `motif` and paste the key when asked. It is checked against the endpoint, saved to
    `~/.motif/.env` (readable only by you), and never shown to the model. `motif login` does the

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.0",
-  "bytes": 436392,
+  "version": "0.2.1",
+  "bytes": 440653,
   "node": "v24.13.0"
 }

package/dist/motif.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 // packages/cli/src/main.ts
-import { existsSync as existsSync9, readFileSync as readFileSync9, readdirSync as readdirSync4 } from "node:fs";
+import { existsSync as existsSync10, readFileSync as readFileSync9, readdirSync as readdirSync4 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 
 // packages/tools/src/schemas.ts
 var CORE_TOOLS = Object.freeze([
@@ -470,7 +470,7 @@ function openStringArray(block, arrayKeys) {
   if (arrayKeys.size === 0) return block;
   const alt = [...arrayKeys].map((k) => k.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
   const re = new RegExp(`"(${alt})"(\\s*:\\s*)"`, "g");
-  return block.replace(re, (_m, key, sep2) => `"${key}"${sep2}["`);
+  return block.replace(re, (_m, key, sep3) => `"${key}"${sep3}["`);
 }
 function balanceBracketsDetailed(block) {
   const CLOSER = { "{": "}", "[": "]" };
@@ -3698,7 +3698,7 @@ var RULES = [
     // redact commit hashes, base64 test fixtures and half of a lockfile.
     name: "secret-assignment",
     pattern: /\b([A-Z0-9_]*(?:SECRET|TOKEN|PASSWORD|PASSWD|API_KEY|APIKEY|ACCESS_KEY|PRIVATE_KEY)[A-Z0-9_]*)(\s*[=:]\s*)(?:"([^"]*)"|'([^']*)'|(\S+))/g,
-    replace: (_m, name, sep2) => `${name}${sep2}${MASK}`
+    replace: (_m, name, sep3) => `${name}${sep3}${MASK}`
   }
 ];
 function redactText(text) {
@@ -6217,8 +6217,8 @@ var Screen = class {
 };
 
 // packages/cli/src/chat.ts
-import { appendFileSync as appendFileSync2, existsSync as existsSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync6, statSync as statSync3 } from "node:fs";
-import { dirname as dirname5, join as join6, resolve as resolve5 } from "node:path";
+import { appendFileSync as appendFileSync2, existsSync as existsSync7, mkdirSync as mkdirSync5, readFileSync as readFileSync6, statSync as statSync3 } from "node:fs";
+import { dirname as dirname5, join as join7, resolve as resolve5 } from "node:path";
 
 // packages/cli/src/files.ts
 import { execFileSync } from "node:child_process";
@@ -6347,6 +6347,24 @@ function expandMentions(text, mentions, opts) {
 ${blocks.join("\n\n")}`, attached };
 }
 
+// packages/cli/src/install.ts
+import { existsSync as existsSync5 } from "node:fs";
+import { delimiter, join as join5, sep as sep2 } from "node:path";
+function ranFromNpx(entry) {
+  if (!entry) return false;
+  return entry.split(/[\\/]/).includes("_npx");
+}
+function commandOnPath(name, pathEnv = process.env["PATH"] ?? "") {
+  for (const dir of pathEnv.split(delimiter)) {
+    if (dir === "" || dir.split(sep2).includes("_npx") || dir.includes(`${sep2}_npx${sep2}`) || dir.includes("/_npx/")) continue;
+    if (existsSync5(join5(dir, name)) || existsSync5(join5(dir, `${name}.cmd`))) return true;
+  }
+  return false;
+}
+function installCommand(version) {
+  return `npm install -g motifcode@${version}`;
+}
+
 // packages/cli/src/login.ts
 import { homedir as homedir3 } from "node:os";
 var KEY_PAGE = "https://infron.ai/dashboard/apiKeys";
@@ -6765,7 +6783,7 @@ async function runSlash(text, ctx) {
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { mkdtempSync, realpathSync as realpathSync2 } from "node:fs";
 import { platform, tmpdir } from "node:os";
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 function has(binary) {
   try {
     execFileSync2("/bin/sh", ["-c", `command -v ${binary}`], { stdio: "ignore" });
@@ -6856,7 +6874,7 @@ function detectSandbox() {
   return cached;
 }
 function makeScratch() {
-  return mkdtempSync(join5(tmpdir(), "motif-scratch-"));
+  return mkdtempSync(join6(tmpdir(), "motif-scratch-"));
 }
 
 // packages/cli/src/doctor.ts
@@ -7096,7 +7114,7 @@ function worstState(checks) {
 
 // packages/cli/src/executor.ts
 import { spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
 import { dirname as dirname4, resolve as resolve4 } from "node:path";
 
 // packages/cli/src/policy.ts
@@ -7359,7 +7377,7 @@ function writeFile(path, content, cwd) {
   try {
     const target = resolve4(cwd, path);
     mkdirSync4(dirname4(target), { recursive: true });
-    const existed = existsSync5(target);
+    const existed = existsSync6(target);
     writeFileSync3(target, content, "utf8");
     const lines = content === "" ? 0 : content.split("\n").length;
     return {
@@ -7676,6 +7694,8 @@ var Chat = class {
   shellBusy = false;
   /** A tool call waiting for the person's yes or no, and which of the three answers is selected. */
   pendingConfirm = null;
+  /** A question with numbered answers in place of the prompt, and which one is selected. */
+  pendingChoice = null;
   /** A secret being typed in place of the prompt — the API key at login. */
   pendingSecret = null;
   /** The credential for this session. Starts as the caller's; `/login` replaces it, `/logout` drops it. */
@@ -7752,6 +7772,7 @@ var Chat = class {
       this.screen.append({ kind: "system", title: "login", lines: await this.login("startup") });
       this.refresh();
     }
+    if (this.opts.offerInstall) await this.offerInstall();
     if (this.opts.continueFrom) {
       try {
         this.screen.append({ kind: "system", title: "continuing", lines: await this.resume(this.opts.continueFrom) });
@@ -7770,6 +7791,10 @@ var Chat = class {
       this.answerSecret(key);
       return;
     }
+    if (this.pendingChoice) {
+      this.answerChoice(key);
+      return;
+    }
     if (this.pendingConfirm) {
       this.answerConfirm(key);
       return;
@@ -8030,6 +8055,58 @@ var Chat = class {
   get needsLogin() {
     return this.opts.requireKey === true && this.apiKey === void 0;
   }
+  /** Take over the prompt for one question; resolves with the index chosen, or null on esc. */
+  askChoice(title, lines, options) {
+    return new Promise((resolve6) => {
+      this.pendingChoice = { title, lines, options, selected: 0, resolve: resolve6 };
+      this.refresh();
+    });
+  }
+  /** A number, or ↑↓ and Enter, picks an answer; Esc (and Ctrl-C, Ctrl-D) declines. Nothing else does anything. */
+  answerChoice(key) {
+    const pending = this.pendingChoice;
+    if (!pending) return;
+    const n = pending.options.length;
+    let choice;
+    if (key.type === "enter") choice = pending.selected;
+    else if (key.type === "escape" || key.type === "ctrl" && (key.key === "c" || key.key === "d")) choice = null;
+    else if (key.type === "up") pending.selected = (pending.selected + n - 1) % n;
+    else if (key.type === "down") pending.selected = (pending.selected + 1) % n;
+    else if (key.type === "text" && /^[1-9]$/.test(key.text) && Number(key.text) <= n) choice = Number(key.text) - 1;
+    if (choice !== void 0) {
+      this.pendingChoice = null;
+      pending.resolve(choice);
+    }
+    this.refresh();
+  }
+  /**
+   * `npx motifcode` runs the package without leaving a command behind, and
+   * the first person to try it typed `motif` afterwards and found nothing.
+   * So a run from npx, on a machine without `motif`, is offered the global
+   * install once — npm's own, of exactly the version that is running — and
+   * the session carries on either way.
+   */
+  async offerInstall() {
+    const command = installCommand(this.opts.version);
+    const choice = await this.askChoice(
+      "Install the motif command?",
+      ["This run came from npx, which leaves no command behind.", `${command} puts motif and motifcode on your PATH.`],
+      ["1. Yes, install it now", "2. Not now \u2014 npx motifcode keeps working"]
+    );
+    if (choice !== 0) return;
+    const id = `install-${++this.shellSequence}`;
+    this.screen.append({ kind: "tool", id, name: "bash", args: { command }, repaired: false, hooks: [] });
+    this.refresh();
+    const r = await (this.opts.installGlobal ?? ((c) => runShell(c, { cwd: this.settings.cwd, timeoutMs: 18e4, outputCap: 2e4 })))(command);
+    const ok2 = r.code === 0 && !r.timedOut;
+    const output = r.timedOut ? `${r.output.trim()}
+(killed after ${Math.round(r.ms / 1e3)}s)`.trim() : r.output.trim() || `(exit ${r.code})`;
+    this.screen.apply({ type: "tool_end", id, ok: ok2, output, ms: r.ms });
+    this.screen.append(
+      ok2 ? { kind: "notice", level: "info", text: "installed: from now on `motif` (or `motifcode`) opens this from any folder; this session carries on" } : { kind: "notice", level: "warn", text: `the install did not finish; run \`${command}\` yourself (with sudo if npm's global folder is not yours), or keep using npx motifcode` }
+    );
+    this.refresh();
+  }
   /** Take over the prompt for one secret; resolves with the text, or null when given up. */
   askSecret(title, lines, prompt, cancelHint) {
     return new Promise((resolve6) => {
@@ -8171,14 +8248,16 @@ var Chat = class {
       draft: this.composer.snapshot(),
       placeholder: PLACEHOLDER,
       ...this.pendingConfirm ? { confirm: this.confirmView(this.pendingConfirm.call, this.pendingConfirm.selected) } : {},
+      ...this.pendingChoice ? { confirm: { title: this.pendingChoice.title, lines: this.pendingChoice.lines, choices: this.pendingChoice.options.map((o, i) => `${i === this.pendingChoice.selected ? "\u276F" : " "} ${o}`) } } : {},
       ...this.pendingSecret ? { secret: { title: this.pendingSecret.title, lines: this.pendingSecret.lines, prompt: this.pendingSecret.prompt } } : {},
-      ...items.length > 0 && !this.pendingConfirm && !this.pendingSecret ? { menu: { items, selected: clampSelection(this.menuSelected, items.length), prefix: this.mentionOpen() ? "@" : "/" } } : {}
+      ...items.length > 0 && !this.pendingConfirm && !this.pendingSecret && !this.pendingChoice ? { menu: { items, selected: clampSelection(this.menuSelected, items.length), prefix: this.mentionOpen() ? "@" : "/" } } : {}
     };
     this.screen.setHint(this.hintText());
     this.screen.setComposer(view);
   }
   hintText() {
     if (this.pendingSecret) return this.pendingSecret.cancelHint;
+    if (this.pendingChoice) return "1 2 or \u2191\u2193 enter \xB7 esc leaves it";
     if (this.pendingConfirm) return "1 2 3 or \u2191\u2193 enter \xB7 esc declines";
     if (this.ctrlCArmedAt > 0 && this.now() - this.ctrlCArmedAt <= CTRL_C_WINDOW_MS) return "ctrl-c again to quit";
     if (this.queued.length > 0) {
@@ -8294,12 +8373,12 @@ ${output.slice(0, 8e3)}
    * is built per task.
    */
   addNote(note) {
-    const path = this.opts.notesPath ?? join6(this.settings.cwd, ".motif", "NOTES.md");
+    const path = this.opts.notesPath ?? join7(this.settings.cwd, ".motif", "NOTES.md");
     try {
       mkdirSync5(dirname5(path), { recursive: true, mode: 448 });
-      const existing = existsSync6(path) ? readFileSync6(path, "utf8") : "";
-      const sep2 = existing === "" || existing.endsWith("\n") ? "" : "\n";
-      appendFileSync2(path, `${sep2}- ${note}
+      const existing = existsSync7(path) ? readFileSync6(path, "utf8") : "";
+      const sep3 = existing === "" || existing.endsWith("\n") ? "" : "\n";
+      appendFileSync2(path, `${sep3}- ${note}
 `, "utf8");
       this.projectNotes = readFileSync6(path, "utf8");
       this.screen.append({ kind: "notice", level: "info", text: `noted in ${path}; the next task reads it` });
@@ -8322,7 +8401,7 @@ ${output.slice(0, 8e3)}
     this.tasks.push(task);
     const transport = (this.opts.makeTransport ?? defaultTransport)(this.settings, this.apiKey);
     const runId = new Date(this.now()).toISOString().replace(/[:.]/g, "-") + `-${String(this.totals.tasks + 1).padStart(2, "0")}`;
-    const journalPath = join6(this.opts.journalDir, `${runId}.jsonl`);
+    const journalPath = join7(this.opts.journalDir, `${runId}.jsonl`);
     const scope = { scopeId: "root", scopeKind: "root" };
     const journal = new Journal(
       journalPath,
@@ -8681,8 +8760,8 @@ ${output.slice(0, 8e3)}
       },
       compact: (focus) => this.compactNow(focus),
       notes: () => {
-        const path = this.opts.notesPath ?? join6(this.settings.cwd, ".motif", "NOTES.md");
-        if (!existsSync6(path)) return [`no notes yet; # <text> at the prompt writes ${path}`];
+        const path = this.opts.notesPath ?? join7(this.settings.cwd, ".motif", "NOTES.md");
+        if (!existsSync7(path)) return [`no notes yet; # <text> at the prompt writes ${path}`];
         return [path, "", ...readFileSync6(path, "utf8").replace(/\s+$/, "").split("\n")];
       },
       hooks: () => this.opts.hookLines ?? ["no hooks"],
@@ -8744,8 +8823,8 @@ ${output.slice(0, 8e3)}
     const lines = rows.map(([k, v, from]) => `${k.padEnd(16)} ${v.padEnd(40)} ${from}`);
     lines.push("");
     if (info) {
-      lines.push(`user file     ${info.userPath}${existsSync6(info.userPath) ? "" : " (absent)"}`);
-      const projectState = !existsSync6(info.projectPath) ? " (absent)" : info.projectApplied ? " (applied)" : " (present, not trusted \u2014 run `motif trust`)";
+      lines.push(`user file     ${info.userPath}${existsSync7(info.userPath) ? "" : " (absent)"}`);
+      const projectState = !existsSync7(info.projectPath) ? " (absent)" : info.projectApplied ? " (applied)" : " (present, not trusted \u2014 run `motif trust`)";
       lines.push(`project file  ${info.projectPath}${projectState}`);
     }
     lines.push("flags and MOTIF_* in the environment or .env outrank both files; /model and the rest save to the user file");
@@ -8800,7 +8879,7 @@ ${output.slice(0, 8e3)}
       file = picked.path;
     }
     const path = resolve5(this.settings.cwd, file);
-    if (!existsSync6(path)) throw new Error(`${path} does not exist`);
+    if (!existsSync7(path)) throw new Error(`${path} does not exist`);
     const state = loadResume(path);
     if (state.corruption !== void 0) throw new Error(`this journal is corrupt (${state.corruption})`);
     if (!state.checkpoint) throw new Error("no checkpoint was written in that session; there is nothing to continue");
@@ -8822,7 +8901,7 @@ ${output.slice(0, 8e3)}
   }
   setCwd(path) {
     const target = resolve5(this.settings.cwd, path);
-    if (!existsSync6(target) || !statSync3(target).isDirectory()) return [`not a directory: ${target}`];
+    if (!existsSync7(target) || !statSync3(target).isDirectory()) return [`not a directory: ${target}`];
     if (this.active) return ["a task is running; wait for it or interrupt it first"];
     this.executor.close();
     this.settings.cwd = target;
@@ -8839,7 +8918,7 @@ Input from the person:
 ${input}`;
 }
 function readHistory(path) {
-  if (!existsSync6(path)) return [];
+  if (!existsSync7(path)) return [];
   const entries = [];
   for (const line2 of readFileSync6(path, "utf8").split("\n")) {
     if (!line2.trim()) continue;
@@ -8867,11 +8946,11 @@ function defaultTransport(settings, apiKey) {
 }
 
 // packages/cli/src/plugins.ts
-import { existsSync as existsSync7, readFileSync as readFileSync7, readdirSync as readdirSync3, statSync as statSync4 } from "node:fs";
-import { join as join7 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync7, readdirSync as readdirSync3, statSync as statSync4 } from "node:fs";
+import { join as join8 } from "node:path";
 function readManifest(dir) {
-  const file = join7(dir, "plugin.json");
-  if (!existsSync7(file)) return null;
+  const file = join8(dir, "plugin.json");
+  if (!existsSync8(file)) return null;
   const raw = JSON.parse(readFileSync7(file, "utf8"));
   const name = typeof raw["name"] === "string" && raw["name"] !== "" ? raw["name"] : null;
   if (!name) throw new Error(`${file}: plugin.json needs a name`);
@@ -8883,10 +8962,10 @@ function readManifest(dir) {
 }
 function loadPluginsFrom(root, source) {
   const out = { plugins: [], skills: [], agents: [], problems: [] };
-  const dir = join7(root, "plugins");
-  if (!existsSync7(dir)) return out;
+  const dir = join8(root, "plugins");
+  if (!existsSync8(dir)) return out;
   for (const name of readdirSync3(dir).sort()) {
-    const path = join7(dir, name);
+    const path = join8(dir, name);
     let st;
     try {
       st = statSync4(path);
@@ -8903,11 +8982,11 @@ function loadPluginsFrom(root, source) {
     }
     if (!manifest) continue;
     const info = { ...manifest, path, source, skills: [], agents: [] };
-    const skillsDir = join7(path, "skills");
-    if (existsSync7(skillsDir)) {
+    const skillsDir = join8(path, "skills");
+    if (existsSync8(skillsDir)) {
       for (const s of readdirSync3(skillsDir).sort()) {
-        const file = join7(skillsDir, s, "SKILL.md");
-        if (!existsSync7(file)) continue;
+        const file = join8(skillsDir, s, "SKILL.md");
+        if (!existsSync8(file)) continue;
         try {
           const skill = parseSkill(readFileSync7(file, "utf8"), source);
           out.skills.push(skill);
@@ -8917,11 +8996,11 @@ function loadPluginsFrom(root, source) {
         }
       }
     }
-    const agentsDir = join7(path, "agents");
-    if (existsSync7(agentsDir)) {
+    const agentsDir = join8(path, "agents");
+    if (existsSync8(agentsDir)) {
       for (const a of readdirSync3(agentsDir).sort()) {
         if (!a.endsWith(".md")) continue;
-        const file = join7(agentsDir, a);
+        const file = join8(agentsDir, a);
         try {
           const agent = parseAgent(readFileSync7(file, "utf8"), source);
           out.agents.push(agent);
@@ -8936,8 +9015,8 @@ function loadPluginsFrom(root, source) {
   return out;
 }
 function loadPlugins(opts) {
-  const user = loadPluginsFrom(join7(opts.home, ".motif"), "user");
-  const project = loadPluginsFrom(join7(opts.cwd, ".motif"), "project");
+  const user = loadPluginsFrom(join8(opts.home, ".motif"), "user");
+  const project = loadPluginsFrom(join8(opts.cwd, ".motif"), "project");
   return {
     plugins: [...user.plugins, ...project.plugins],
     skills: [...user.skills, ...project.skills],
@@ -8955,9 +9034,9 @@ function describePlugins(loaded) {
 }
 
 // packages/cli/src/settings.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync9, mkdirSync as mkdirSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { dirname as dirname6, join as join8 } from "node:path";
+import { dirname as dirname6, join as join9 } from "node:path";
 var KEYS2 = [
   "model",
   "endpoint",
@@ -8971,10 +9050,10 @@ var KEYS2 = [
   "permissions"
 ];
 function userSettingsPath(home = homedir4()) {
-  return join8(home, ".motif", "settings.json");
+  return join9(home, ".motif", "settings.json");
 }
 function projectSettingsPath(cwd) {
-  return join8(cwd, ".motif", "settings.json");
+  return join9(cwd, ".motif", "settings.json");
 }
 function parseSettings(text) {
   const values = {};
@@ -9030,7 +9109,7 @@ function loadSettings(opts) {
   const sources = {};
   let projectApplied = false;
   const apply = (path, source, gate) => {
-    if (!existsSync8(path)) return false;
+    if (!existsSync9(path)) return false;
     const content = readFileSync8(path, "utf8");
     if (gate && !gate(content)) return false;
     const { values: found, problems } = parseSettings(content);
@@ -9050,7 +9129,7 @@ function loadSettings(opts) {
 function saveUserSetting(key, value, home = homedir4()) {
   const path = userSettingsPath(home);
   let current = {};
-  if (existsSync8(path)) {
+  if (existsSync9(path)) {
     try {
       const parsed = JSON.parse(readFileSync8(path, "utf8"));
       if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) current = parsed;
@@ -9065,7 +9144,7 @@ function saveUserSetting(key, value, home = homedir4()) {
 }
 
 // packages/cli/src/main.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.1";
 var SHORT_FLAGS = { p: "print", c: "continue", i: "interactive", v: "verbose", h: "help" };
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "print",
@@ -9147,13 +9226,13 @@ function loadSkills(cwd) {
   reg.registerAll(BUILTIN_SKILLS);
   reg.registerAll(plugins(cwd).skills);
   for (const [dir, source] of [
-    [join9(homedir5(), CONFIG_DIR, "skills"), "user"],
-    [join9(cwd, CONFIG_DIR, "skills"), "project"]
+    [join10(homedir5(), CONFIG_DIR, "skills"), "user"],
+    [join10(cwd, CONFIG_DIR, "skills"), "project"]
   ]) {
-    if (!existsSync9(dir)) continue;
+    if (!existsSync10(dir)) continue;
     for (const name of readdirSync4(dir)) {
-      const file = join9(dir, name, "SKILL.md");
-      if (!existsSync9(file)) continue;
+      const file = join10(dir, name, "SKILL.md");
+      if (!existsSync10(file)) continue;
       try {
         reg.register(parseSkill(readFileSync9(file, "utf8"), source));
       } catch (err) {
@@ -9165,8 +9244,8 @@ function loadSkills(cwd) {
   return reg;
 }
 function loadHooks(cwd, opts) {
-  const file = join9(cwd, CONFIG_DIR, "settings.json");
-  if (!existsSync9(file)) return DEFAULT_HOOKS;
+  const file = join10(cwd, CONFIG_DIR, "settings.json");
+  if (!existsSync10(file)) return DEFAULT_HOOKS;
   const content = readFileSync9(file, "utf8");
   let parsed;
   try {
@@ -9204,13 +9283,13 @@ function loadAgents(cwd) {
   reg.registerAll(BUILTIN_AGENTS);
   reg.registerAll(plugins(cwd).agents);
   for (const [dir, source] of [
-    [join9(homedir5(), CONFIG_DIR, "agents"), "user"],
-    [join9(cwd, CONFIG_DIR, "agents"), "project"]
+    [join10(homedir5(), CONFIG_DIR, "agents"), "user"],
+    [join10(cwd, CONFIG_DIR, "agents"), "project"]
   ]) {
-    if (!existsSync9(dir)) continue;
+    if (!existsSync10(dir)) continue;
     for (const name of readdirSync4(dir)) {
       if (!name.endsWith(".md")) continue;
-      const file = join9(dir, name);
+      const file = join10(dir, name);
       try {
         reg.register(parseAgent(readFileSync9(file, "utf8"), source));
       } catch (err) {
@@ -9234,8 +9313,8 @@ function describeHooks(cwd, hooks) {
     for (const d of defs ?? []) lines.push(`${event.padEnd(12)} ${d.matcher ? `[${d.matcher}] ` : ""}${d.command}${d.blocking ? "  (blocking)" : ""}`);
   }
   if (lines.length === 0) lines.push("no hooks configured");
-  const file = join9(cwd, CONFIG_DIR, "settings.json");
-  if (existsSync9(file)) {
+  const file = join10(cwd, CONFIG_DIR, "settings.json");
+  if (existsSync10(file)) {
     const content = readFileSync9(file, "utf8");
     const trusted = checkTrust(loadTrustStore(), cwd, content).trusted;
     lines.push("", `${file}: ${trusted ? "trusted" : "present but not trusted \u2014 its hooks and settings are not applied; run motif trust"}`);
@@ -9245,9 +9324,9 @@ function describeHooks(cwd, hooks) {
   return lines;
 }
 function loadProjectNotes(cwd) {
-  for (const name of ["AGENTS.md", "CLAUDE.md", join9(CONFIG_DIR, "NOTES.md")]) {
-    const file = join9(cwd, name);
-    if (existsSync9(file)) return readFileSync9(file, "utf8");
+  for (const name of ["AGENTS.md", "CLAUDE.md", join10(CONFIG_DIR, "NOTES.md")]) {
+    const file = join10(cwd, name);
+    if (existsSync10(file)) return readFileSync9(file, "utf8");
   }
   return void 0;
 }
@@ -9487,8 +9566,8 @@ async function main() {
       return 0;
     }
     case "trust": {
-      const file = join9(cwd, CONFIG_DIR, "settings.json");
-      if (!existsSync9(file)) {
+      const file = join10(cwd, CONFIG_DIR, "settings.json");
+      if (!existsSync10(file)) {
         process.stderr.write(`${file} does not exist; there is nothing to approve
 `);
         return 2;
@@ -9548,9 +9627,9 @@ ${"".padEnd(12)} tools: ${tools}
       for (const [k, v, from] of rows) process.stdout.write(`${k.padEnd(16)} ${v.padEnd(40)} ${from}
 `);
       process.stdout.write(`
-user file     ${stored.userPath}${existsSync9(stored.userPath) ? "" : " (absent)"}
+user file     ${stored.userPath}${existsSync10(stored.userPath) ? "" : " (absent)"}
 `);
-      const projectState = !existsSync9(stored.projectPath) ? " (absent)" : stored.projectApplied ? " (applied)" : " (present, not trusted \u2014 run `motif trust`)";
+      const projectState = !existsSync10(stored.projectPath) ? " (absent)" : stored.projectApplied ? " (applied)" : " (present, not trusted \u2014 run `motif trust`)";
       process.stdout.write(`project file  ${stored.projectPath}${projectState}
 `);
       return 0;
@@ -9566,7 +9645,7 @@ user file     ${stored.userPath}${existsSync9(stored.userPath) ? "" : " (absent)
       return worstState(checks) === "fail" ? 1 : 0;
     }
     case "sessions": {
-      const dir = join9(cwd, CONFIG_DIR, "sessions");
+      const dir = join10(cwd, CONFIG_DIR, "sessions");
       const sessions = listSessions(dir);
       if (sessions.length === 0) {
         process.stdout.write(`no sessions in ${dir}
@@ -9584,7 +9663,7 @@ user file     ${stored.userPath}${existsSync9(stored.userPath) ? "" : " (absent)
       return 0;
     }
     case "distil": {
-      const dir = args.rest[0] ?? join9(cwd, CONFIG_DIR, "sessions");
+      const dir = args.rest[0] ?? join10(cwd, CONFIG_DIR, "sessions");
       const format = flagEnum(args.flags, "format", DISTIL_FORMATS, "trajectory-jsonl");
       const filter = flagEnum(args.flags, "filter", DISTIL_FILTERS, "grader-passed");
       const includeChildren = args.flags["include-children"] === true;
@@ -9606,7 +9685,7 @@ user file     ${stored.userPath}${existsSync9(stored.userPath) ? "" : " (absent)
       return 0;
     }
     case "metrics": {
-      const dir = args.rest[0] ?? join9(cwd, CONFIG_DIR, "sessions");
+      const dir = args.rest[0] ?? join10(cwd, CONFIG_DIR, "sessions");
       for (const s of listSessions(dir)) {
         const parsed = parseJournal(readFile(s.path, "utf8"));
         for (const t of toTrajectories(parsed)) {
@@ -9712,22 +9791,23 @@ user file     ${stored.userPath}${existsSync9(stored.userPath) ? "" : " (absent)
       },
       settingsInfo: stored,
       persist: (key, value) => saveUserSetting(key, value),
-      historyPath: join9(cwd, CONFIG_DIR, "history.jsonl"),
+      historyPath: join10(cwd, CONFIG_DIR, "history.jsonl"),
       pluginLines: describePlugins(plugins(cwd)),
       hookLines: describeHooks(cwd, hooks),
-      notesPath: join9(cwd, CONFIG_DIR, "NOTES.md"),
-      ...args.flags["continue"] === true ? { continueFrom: listSessions(join9(cwd, CONFIG_DIR, "sessions"))[0]?.path ?? "" } : {},
+      notesPath: join10(cwd, CONFIG_DIR, "NOTES.md"),
+      ...args.flags["continue"] === true ? { continueFrom: listSessions(join10(cwd, CONFIG_DIR, "sessions"))[0]?.path ?? "" } : {},
       channelPolicy,
       ...apiKey !== void 0 ? { apiKey } : {},
       ...connection.sources.apiKey !== void 0 ? { apiKeySource: connection.sources.apiKey } : {},
       requireKey: keyRequired(endpoint),
       envPath: defaultEnvPath(),
+      offerInstall: ranFromNpx(process.argv[1]) && !commandOnPath("motif"),
       skills,
       agents,
       hooks,
       ...projectNotes !== void 0 ? { projectNotes } : {},
       tools: activeTools,
-      journalDir: join9(cwd, CONFIG_DIR, "sessions"),
+      journalDir: join10(cwd, CONFIG_DIR, "sessions"),
       version: VERSION,
       hero: args.flags["no-hero"] !== true,
       ...task ? { initialTask: task } : {}
@@ -9789,7 +9869,7 @@ user file     ${stored.userPath}${existsSync9(stored.userPath) ? "" : " (absent)
   const transport = new HttpTransport({ endpoint, model, ...sessionKey !== void 0 ? { apiKey: sessionKey } : {} });
   const screen = new Screen({ showThinking, verbose: args.flags["verbose"] === true, cwd });
   const runId = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  const journalPath = flagStr(args.flags, "journal", "") || join9(cwd, CONFIG_DIR, "sessions", `${runId}.jsonl`);
+  const journalPath = flagStr(args.flags, "journal", "") || join10(cwd, CONFIG_DIR, "sessions", `${runId}.jsonl`);
   const journal = new Journal(
     journalPath,
     newHeader({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "motifcode",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "Unofficial coding agent harness built for Motif-3: a Claude Code-style terminal session over the hosted endpoint",
   "keywords": [