motifcode 0.2.0 → 0.3.0

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,
-  "node": "v24.13.0"
+  "version": "0.3.0",
+  "bytes": 445102,
+  "node": "v22.23.2"
 }

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 = { "{": "}", "[": "]" };
@@ -831,6 +831,32 @@ function looksLikeLeakedToolCall(result) {
   if (result.unrecoverable.length > 0) return true;
   return /<tool_call>|<\/tool_call>/.test(result.content);
 }
+function stripLoneFence(s) {
+  const m = /^```(?:json|tool_call)?\s*([\s\S]*?)\s*```$/.exec(s.trim());
+  return m ? (m[1] ?? "").trim() : s.trim();
+}
+function recoverBareToolCall(content, ctx) {
+  const body = stripLoneFence(content);
+  if (!body.startsWith("{") || !body.endsWith("}")) return null;
+  const strict = strictLoad(body);
+  const outcome = strict !== null ? { value: coerceArgumentsWrapper(strict), info: CLEAN } : repairBlockDetailed(body, ctx);
+  if (outcome.value === null) return null;
+  const name = typeof outcome.value["name"] === "string" ? outcome.value["name"] : "";
+  if (name === "" || !ctx.specs.has(name)) return null;
+  return {
+    name,
+    arguments: asArguments(outcome.value["arguments"]),
+    repaired: true,
+    repair: { kind: "detag", lossy: outcome.info.lossy, complete: outcome.info.complete }
+  };
+}
+function contentLeaksToolCall(content, ctx) {
+  if (/<\/?tool_call>/.test(content)) return true;
+  for (const m of content.matchAll(/\{[^{}]*"name"\s*:\s*"([a-z_]+)"[\s\S]*?\}/g)) {
+    if (ctx.specs.has(m[1])) return true;
+  }
+  return false;
+}
 
 // packages/protocol/src/scrubber.ts
 var MARKERS = [THINK_OPEN, THINK_CLOSE];
@@ -969,6 +995,24 @@ var ToolCallChannel = class {
         ...c.repair ? { repair: c.repair } : {}
       }
     );
+    if (actions.length === 0) {
+      const bare = recoverBareToolCall(r.content, ctx);
+      if (bare) {
+        const action = bare.name === "done" ? {
+          kind: "done",
+          summary: String(bare.arguments["summary"] ?? ""),
+          ...typeof bare.arguments["confirm"] === "boolean" ? { confirm: bare.arguments["confirm"] } : {},
+          ...bare.repair ? { repair: bare.repair } : {}
+        } : {
+          kind: "tool",
+          name: bare.name,
+          arguments: bare.arguments,
+          repaired: true,
+          ...bare.repair ? { repair: bare.repair } : {}
+        };
+        return { actions: [action], content: "", unrecoverable: [], truncated: false };
+      }
+    }
     return {
       actions,
       content: r.content.trim(),
@@ -2931,7 +2975,7 @@ async function runLoop(opts) {
       } : { id: nextId(), name: a.name, arguments: a.arguments }
     );
     if (parsed.actions.length === 0) {
-      const leaked = parsed.unrecoverable.length > 0 || parsed.truncated || (parsed.invalidArguments?.length ?? 0) > 0 || channel === "toolcall" && looksLikeLeakedToolCall(parseToolCalls(split.content, ctx));
+      const leaked = parsed.unrecoverable.length > 0 || parsed.truncated || (parsed.invalidArguments?.length ?? 0) > 0 || channel === "toolcall" && (looksLikeLeakedToolCall(parseToolCalls(split.content, ctx)) || contentLeaksToolCall(split.content, ctx));
       if (replyEnds && !leaked && response.finishReason !== "length") {
         session.appendAll(codec.serializeAssistant(split.content, split.reasoning, parsed));
         checkpoint();
@@ -2960,7 +3004,8 @@ async function runLoop(opts) {
         leaked ? "Your last turn did not produce a usable action. It looks like action syntax that failed to parse." : "Your last turn produced no action.",
         channel,
         consecutiveNoAction,
-        lastObservation
+        lastObservation,
+        !leaked
       );
       if (consecutiveNoAction === 1) {
         handBack(nudge);
@@ -3160,8 +3205,8 @@ function refusalPrompt(refusals, channel) {
     repairPrompt("", channel).trim()
   ].join("\n");
 }
-function repairPrompt(problem, channel, attempt = 1, lastObservation = "") {
-  const how = channel === "toolcall" ? "Emit a well-formed `<tool_call>` block. Watch backslashes: inside JSON strings, shell `$` and regex metacharacters must be escaped or avoided." : channel === "object" ? "Reply with a single well-formed JSON object matching the schema you were given." : "Reply with the XML shape you were given. Command bodies are verbatim \u2014 do not escape anything inside them.";
+function repairPrompt(problem, channel, attempt = 1, lastObservation = "", cleanReply = false) {
+  const how = cleanReply ? "If the task is already complete, or the message only needs an answer, call `done` now with that answer as the summary. Otherwise take the next concrete step toward the task above \u2014 do not read files or run commands looking for unrelated work to do." : channel === "toolcall" ? "Emit a well-formed `<tool_call>` block. Watch backslashes: inside JSON strings, shell `$` and regex metacharacters must be escaped or avoided." : channel === "object" ? "Reply with a single well-formed JSON object matching the schema you were given." : "Reply with the XML shape you were given. Command bodies are verbatim \u2014 do not escape anything inside them.";
   const parts = [problem, "", how];
   if (attempt >= 2) {
     parts.push(
@@ -3698,7 +3743,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 +6262,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 +6392,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 +6828,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 +6919,7 @@ function detectSandbox() {
   return cached;
 }
 function makeScratch() {
-  return mkdtempSync(join5(tmpdir(), "motif-scratch-"));
+  return mkdtempSync(join6(tmpdir(), "motif-scratch-"));
 }
 
 // packages/cli/src/doctor.ts
@@ -6967,22 +7030,23 @@ async function doctor(opts) {
       }
     );
   }
+  const probeBody = JSON.stringify({
+    model: opts.model,
+    temperature: SAMPLING_DEFAULTS.temperature,
+    top_p: SAMPLING_DEFAULTS.top_p,
+    stream: false,
+    max_tokens: 256,
+    messages: [
+      { role: "system", content: "You are a coding agent. Finish by calling the `done` tool." },
+      { role: "user", content: 'Call `done` now with the summary "ok". Do nothing else.' }
+    ],
+    tools: [PROBE_TOOL]
+  });
   try {
     const res = await fetchImpl(`${endpoint}/v1/chat/completions`, {
       method: "POST",
       headers,
-      body: JSON.stringify({
-        model: opts.model,
-        temperature: SAMPLING_DEFAULTS.temperature,
-        top_p: SAMPLING_DEFAULTS.top_p,
-        stream: false,
-        max_tokens: 256,
-        messages: [
-          { role: "system", content: "You are a coding agent. Finish by calling the `done` tool." },
-          { role: "user", content: 'Call `done` now with the summary "ok". Do nothing else.' }
-        ],
-        tools: [PROBE_TOOL]
-      })
+      body: probeBody
     });
     if (res.status === 401 || res.status === 403) {
       const text = (await res.text().catch(() => "")).trim().slice(0, 200);
@@ -7029,12 +7093,31 @@ async function doctor(opts) {
           fix: "the harness splits it client-side; that is a fallback, not the design"
         } : { name: "reasoning parser", state: "unknown", detail: "no reasoning in the probe response" }
       );
-      const cached2 = json.usage?.prompt_tokens_details?.cached_tokens;
+      let cached2 = json.usage?.prompt_tokens_details?.cached_tokens;
+      const reports = cached2 !== void 0;
+      try {
+        const again = await fetchImpl(`${endpoint}/v1/chat/completions`, {
+          method: "POST",
+          headers,
+          body: probeBody
+        });
+        if (again.ok) {
+          const json2 = await again.json();
+          const c2 = json2.usage?.prompt_tokens_details?.cached_tokens;
+          if (typeof c2 === "number") cached2 = c2;
+        }
+      } catch {
+      }
       checks.push(
-        typeof cached2 === "number" ? {
+        typeof cached2 === "number" && cached2 > 0 ? {
           name: "prefix caching",
           state: "ok",
-          detail: `the endpoint reports cached prompt tokens (${cached2} on this probe)`
+          detail: `the endpoint served ${cached2} prompt tokens from its prefix cache on a repeated request`
+        } : reports ? {
+          name: "prefix caching",
+          state: "unknown",
+          detail: "the endpoint reports cached tokens but served none on this probe",
+          fix: "a two-request probe cannot always warm the cache; in a real session the frozen tool order keeps the prefix alive across turns"
         } : {
           name: "prefix caching",
           state: "unknown",
@@ -7096,7 +7179,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 +7442,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 +7759,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 +7837,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 +7856,10 @@ var Chat = class {
       this.answerSecret(key);
       return;
     }
+    if (this.pendingChoice) {
+      this.answerChoice(key);
+      return;
+    }
     if (this.pendingConfirm) {
       this.answerConfirm(key);
       return;
@@ -8030,6 +8120,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 +8313,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 +8438,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 +8466,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 +8825,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 +8888,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 +8944,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 +8966,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 +8983,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 +9011,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 +9027,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 +9047,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 +9061,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 +9080,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 +9099,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 +9115,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 +9174,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 +9194,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 +9209,7 @@ function saveUserSetting(key, value, home = homedir4()) {
 }
 
 // packages/cli/src/main.ts
-var VERSION = "0.2.0";
+var VERSION = "0.3.0";
 var SHORT_FLAGS = { p: "print", c: "continue", i: "interactive", v: "verbose", h: "help" };
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "print",
@@ -9147,13 +9291,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 +9309,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 +9348,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 +9378,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 +9389,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 +9631,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 +9692,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 +9710,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 +9728,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 +9750,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 +9856,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 +9934,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.3.0",
   "type": "module",
   "description": "Unofficial coding agent harness built for Motif-3: a Claude Code-style terminal session over the hosted endpoint",
   "keywords": [