total-recall-brain 3.44.0 → 3.46.0

package/scaffold/.agent/skills/total-recall/plugins/ssss/ui/card.js

@@ -1,182 +0,0 @@
-const card = `
-  <style>
-    :host {
-      --face-ink: #1b1814; --face-panel: #27211a; --face-line: #564636; --face-paper: #f7ebd6;
-      --face-quiet: #c2b59f; --face-gold: #f4c97a; --face-danger: #ffaaa1; --face-good: #c2e4ad;
-      --ink:var(--face-ink); --panel:var(--face-panel); --line:var(--border,var(--face-line));
-      --paper:var(--text-primary,var(--face-paper)); --quiet:var(--face-quiet);
-      --gold:var(--face-gold); --danger:var(--face-danger); --good:var(--face-good);
-      display:block; color:var(--paper); font:14px/1.45 system-ui,sans-serif;
-    }
-    * { box-sizing:border-box; }
-    .workbench { background:var(--ink); border:1px solid var(--line); border-radius:10px; overflow:hidden; }
-    .head { display:flex; align-items:center; gap:12px; padding:14px 18px; border-bottom:1px solid var(--line); }
-    .mark { width:32px; height:32px; flex:none; color:var(--gold); }
-    h2,h3,p { margin:0; }
-    h2 { font-size:18px; }
-    h3 { font-size:14px; margin-bottom:6px; }
-    .subtle, label, dt { color:var(--quiet); }
-    .rack { display:grid; grid-template-columns:repeat(auto-fit,minmax(min(100%,160px),1fr)); gap:1px; background:var(--line); }
-    .slot { background:var(--panel); min-width:0; padding:13px 16px; border-left:3px solid var(--gold); }
-    dl,dd { margin:0; }
-    dd { margin-top:5px; font-size:16px; font-weight:650; overflow-wrap:anywhere; }
-    small { display:block; color:var(--quiet); margin-top:4px; overflow-wrap:anywhere; }
-    .controls, .tasks { display:grid; gap:10px; padding:12px 16px; }
-    .controls { display:flex; flex-wrap:wrap; align-items:end; border-bottom:1px solid var(--line); }
-    .tasks { grid-template-columns:repeat(auto-fit,minmax(min(100%,245px),1fr)); }
-    form { padding:10px; border-top:1px solid var(--line); min-width:0; }
-    label { display:grid; gap:4px; margin-bottom:8px; }
-    button,input,select {
-      border:1px solid var(--line); background:var(--panel); color:var(--paper); min-height:44px;
-      border-radius:5px; padding:6px 9px; font:inherit; max-width:100%;
-    }
-    input[type=text] { width:100%; min-width:0; }
-    input[type=checkbox] { min-height:auto; width:17px; height:17px; }
-    .choice { display:flex; align-items:center; gap:6px; min-height:44px; }
-    .scope { margin:0; }
-    button { cursor:pointer; }
-    .primary { border-color:var(--gold); color:var(--gold); }
-    button:disabled { opacity:.55; cursor:wait; }
-    :focus-visible { outline:2px solid var(--gold); outline-offset:2px; }
-    [data-tone=pass] { color:var(--good); }
-    [data-tone=fail] { color:var(--danger); }
-    .evidence { border-top:1px solid var(--line); padding:12px 16px; }
-    .evidence p { display:flex; flex-wrap:wrap; justify-content:space-between; gap:8px; }
-    pre { margin:6px 0 0; white-space:pre-wrap; overflow-wrap:anywhere; max-height:240px; overflow:auto; }
-    .changed { animation:readout .2s ease-out; }
-    @keyframes readout { from { transform:translateY(3px); opacity:.75; } to { transform:none; opacity:1; } }
-    @media(prefers-reduced-motion:reduce) { .changed { animation:none; } }
-  </style>
-  <section class="workbench" aria-label="SSSS workbench">
-    <header class="head">
-      <svg class="mark" viewBox="0 0 40 40" aria-hidden="true">
-        <path d="M10 8h17l3 3M10 16h14l6-5M10 24h14l6-5M10 32h17l3-5M10 8v24"
-          fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"/>
-      </svg>
-      <div><h2>SSSS</h2><p class="subtle">Installation and contract checks</p></div>
-    </header>
-    <dl class="rack">
-      <div class="slot"><dt>Engine / spec</dt><dd id="engine">—</dd><small id="engine-detail"></small></div>
-      <div class="slot"><dt>Portable skill</dt><dd id="skill">—</dd><small id="skill-detail"></small></div>
-      <div class="slot"><dt>Project scaffold</dt><dd id="scaffold">—</dd><small id="scaffold-detail"></small></div>
-    </dl>
-    <div class="controls">
-      <label class="scope">Installation scope <select id="scope">
-        <option value="auto">Current brain</option><option value="project">Project</option><option value="global">Shared</option>
-      </select></label>
-      <button type="button" id="refresh" class="primary">Check installation</button>
-      <button type="button" id="repair">Repair managed files</button>
-      <button type="button" id="suite">Run engine conformance</button>
-    </div>
-    <div class="tasks">
-      <form id="validate"><h3>Document contract</h3>
-        <label>Document path <input type="text" name="file" required></label>
-        <label>Extension registry path <input type="text" name="extension"></label>
-        <button>Validate document</button>
-      </form>
-      <form id="registry"><h3>Registry integrity</h3>
-        <label>Lock file path <input type="text" name="lock" required></label>
-        <label>Extension registry path <input type="text" name="extension"></label>
-        <button>Verify registry</button>
-      </form>
-      <form id="new-project"><h3>New SSSS project</h3>
-        <label>New directory <input type="text" name="directory" required></label>
-        <label>Extension name <input type="text" name="extension"></label>
-        <label class="choice"><input type="checkbox" name="with-total-recall"> Include Total Recall wiring</label>
-        <button>Create project</button>
-      </form>
-    </div>
-    <div class="evidence" aria-live="polite">
-      <p><strong id="verdict">Awaiting inspection</strong><time id="attempt"></time></p>
-      <pre id="result" tabindex="0"></pre>
-    </div>
-  </section>`;
-
-export class SsssCard extends HTMLElement {
-  set host(value) {
-    this.bridge = value;
-    if (this.isConnected && this.shadowRoot && value) this.inspect();
-  }
-  get host() { return this.bridge; }
-
-  connectedCallback() {
-    if (!this.shadowRoot) {
-      this.attachShadow({ mode: 'open' }).innerHTML = card;
-      this.find('refresh').onclick = () => this.inspect();
-      this.find('scope').onchange = () => this.inspect();
-      this.find('repair').onclick = () => this.inspect('repair');
-      this.find('suite').onclick = () => this.perform('conformance');
-      this.bindForm('validate', 'validate');
-      this.bindForm('registry', 'registry');
-      this.bindForm('new-project', 'scaffold');
-    }
-    if (this.host) this.inspect();
-  }
-
-  find(id) { return this.shadowRoot.getElementById(id); }
-
-  bindForm(id, operation) {
-    const form = this.find(id);
-    form.onsubmit = event => {
-      event.preventDefault();
-      const args = [];
-      for (const [name, value] of new FormData(form)) {
-        if (value === 'on' && name === 'with-total-recall') args.push('--with-total-recall');
-        else if (String(value).trim()) args.push('--' + name, String(value).trim());
-      }
-      this.perform(operation, args);
-    };
-  }
-
-  inspect(operation = 'status') {
-    return this.perform(operation, ['--scope', this.find('scope').value]);
-  }
-
-  paintInstallation(result) {
-    this.find('engine').textContent = result?.version ? result.version + ' / ' + result.specVersion : '—';
-    this.find('engine-detail').textContent = result?.error || '';
-    for (const part of ['skill', 'scaffold']) {
-      const item = result?.[part];
-      this.find(part).textContent = item ? (item.ok ? item.files + ' files verified' : 'Needs attention') : '—';
-      this.find(part).dataset.tone = item ? (item.ok ? 'pass' : 'fail') : '';
-      this.find(part + '-detail').textContent = item?.error || item?.path || '';
-    }
-  }
-
-  async perform(operation, args = []) {
-    if (!this.host || this.busy) return;
-    const installation = operation === 'status' || operation === 'repair';
-    this.busy = true;
-    const controls = [...this.shadowRoot.querySelectorAll('button,select')];
-    controls.forEach(control => { control.disabled = true; });
-    const verdict = this.find('verdict');
-    verdict.textContent = 'Checking…';
-    verdict.dataset.tone = '';
-    const output = this.find('result');
-    output.textContent = '';
-    output.classList.remove('changed');
-    if (installation) this.paintInstallation(null);
-    const attempt = new Date().toISOString();
-    this.find('attempt').textContent = attempt;
-    this.find('attempt').dateTime = attempt;
-    try {
-      const reply = await this.host.run(operation, [...args, '--json']);
-      const result = typeof reply === 'string' ? JSON.parse(reply) : reply;
-      if (typeof result?.ok !== 'boolean') throw new Error('SSSS returned no verdict');
-      if (installation) this.paintInstallation(result);
-      verdict.textContent = result.ok ? (operation === 'scaffold' ? 'Project created' : 'Verified') : 'Check failed';
-      verdict.dataset.tone = result.ok ? 'pass' : 'fail';
-      output.textContent = installation ? (result.error || '') : (result.output || JSON.stringify(result, null, 2));
-    } catch (error) {
-      verdict.textContent = 'Check failed';
-      verdict.dataset.tone = 'fail';
-      output.textContent = error.message;
-    } finally {
-      this.busy = false;
-      controls.forEach(control => { control.disabled = false; });
-      output.classList.add('changed');
-    }
-  }
-}
-
-if (!customElements.get('tr-ssss-card')) customElements.define('tr-ssss-card', SsssCard);

package/src/core/append-log.mjs

@@ -1,131 +0,0 @@
-/**
- * Append-only JSONL log with last-write-wins semantics and compaction.
- *
- * Write: O(1) — fs.appendFileSync one line
- * Read: O(n) on cold load, cached after first read
- * Compact: Rewrites only latest version of each key
- *
- * File format: One JSON object per line, each with a mandatory `_key` field.
- * Later entries for the same `_key` shadow earlier ones.
- * Tombstones: { "_key": "slug", "_deleted": true }
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { atomicWrite } from './vault.mjs';
-import { logger } from './logger.mjs';
-
-/** @type {Map<string, AppendLog>} Registry of all active AppendLog instances */
-const activeAppendLogs = new Map();
-
-export class AppendLog {
-  #filePath;
-  #cache; // Map<string, object> — latest value per key
-  #dirty; // number of appended lines since last compact
-  #compactThreshold;
-
-  constructor(filePath, { compactThreshold = 500 } = {}) {
-    this.#filePath = filePath;
-    this.#cache = null;
-    this.#dirty = 0;
-    this.#compactThreshold = compactThreshold;
-    activeAppendLogs.set(filePath, this);
-  }
-
-  /** Read the full index. Returns Map<key, value>. Cached after first call. */
-  entries() {
-    if (this.#cache) return this.#cache;
-    this.#cache = new Map();
-    if (!fs.existsSync(this.#filePath)) return this.#cache;
-    const raw = fs.readFileSync(this.#filePath, 'utf8');
-    for (const line of raw.split('\n')) {
-      if (!line.trim()) continue;
-      try {
-        const entry = JSON.parse(line);
-        if (entry._deleted) this.#cache.delete(entry._key);
-        else this.#cache.set(entry._key, entry);
-      } catch { /* skip corrupt lines */ }
-    }
-    return this.#cache;
-  }
-
-  /** Get a single entry by key. */
-  get(key) {
-    return this.entries().get(key) ?? null;
-  }
-
-  /** Append a single entry. O(1) I/O. */
-  append(key, value) {
-    const dir = path.dirname(this.#filePath);
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-    const entry = { _key: key, ...value };
-    fs.appendFileSync(this.#filePath, JSON.stringify(entry) + '\n');
-    // Update in-memory cache
-    this.entries().set(key, entry);
-    this.#dirty++;
-    if (this.#dirty >= this.#compactThreshold) {
-      this.compact();
-    }
-  }
-
-  /** Write a tombstone for a key. O(1) I/O. */
-  remove(key) {
-    const dir = path.dirname(this.#filePath);
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-    fs.appendFileSync(this.#filePath, JSON.stringify({ _key: key, _deleted: true }) + '\n');
-    this.entries().delete(key);
-    this.#dirty++;
-  }
-
-  /** Number of live entries. */
-  get size() {
-    return this.entries().size;
-  }
-
-  /** Convert to plain object (for JSON.stringify compatibility). */
-  toObject() {
-    const obj = {};
-    for (const [key, value] of this.entries()) {
-      const { _key, ...rest } = value;
-      obj[key] = rest;
-    }
-    return obj;
-  }
-
-  /** Compact: rewrite file with only latest versions. */
-  compact() {
-    const entries = this.entries();
-    const lines = [];
-    for (const [, value] of entries) {
-      lines.push(JSON.stringify(value));
-    }
-    atomicWrite(this.#filePath, lines.join('\n') + '\n');
-    this.#dirty = 0;
-    logger.info('append-log', `Compacted ${this.#filePath}: ${lines.length} entries`);
-  }
-
-  /** Invalidate the in-memory cache (force reload on next read). */
-  invalidate() {
-    this.#cache = null;
-    this.#dirty = 0;
-  }
-}
-
-/**
- * Compact all active AppendLog instances.
- * Returns summary with number of logs compacted and total entries.
- */
-export function compactAppendLogs() {
-  let logsCompacted = 0;
-  let totalEntries = 0;
-  for (const [filePath, log] of activeAppendLogs) {
-    try {
-      log.compact();
-      logsCompacted++;
-      totalEntries += log.size;
-    } catch (err) {
-      logger.warn('append-log', `Failed to compact ${filePath}: ${err.message}`);
-    }
-  }
-  return { logs_compacted: logsCompacted, total_entries: totalEntries };
-}

package/src/core/plugin-tasks.mjs

@@ -1,173 +0,0 @@
-/**
- * Scheduled plugin tasks.
- *
- * A manifest task `{ intent, schedule: "<5-field cron>", command }` runs the
- * plugin's own CLI subcommand on that schedule, out of process. Tasks are per
- * node by default, regardless of leadership. Tasks with selected-node placement
- * require an explicit matching node in plugin_record.task_nodes[command].
- *
- * The last minute-slot each command ran in is kept in the plugin_record, so a
- * restart neither repeats a slot nor loses one: when the daemon was busy or
- * down, the most recent matching slot since the last run (within a day) runs
- * once. A task never runs just because it was installed — the first run is the
- * first matching slot after the scheduler first sees it.
- */
-import { discoverPlugins } from './plugin-loader.mjs';
-import { readPluginRecord, patchPluginRecord, ensurePluginRecord } from './plugin-store.mjs';
-import { pluginExecutionEnabled } from './plugin-state.mjs';
-import { runPluginCommand } from './plugin-runner.mjs';
-import { appendVfsEvent } from './ssss-operation-service.mjs';
-import { vaultForPluginsDir } from './plugin-loader.mjs';
-import { logger } from './logger.mjs';
-import { getMeshSelf, meshNodeKey } from './mesh.mjs';
-
-const TASK_TIMEOUT_MS = 60_000;
-const MAX_CATCHUP_MINUTES = 24 * 60;
-import { parseCron, cronMatches } from './plugin-cron.mjs';
-export { parseCron, cronMatches } from './plugin-cron.mjs';
-const pad = (n) => String(n).padStart(2, '0');
-
-/** A selected-node task stays idle until this node's plugin record selects it. */
-export function taskRunsOnNode(task, record, self) {
-  if (task.placement !== 'selected-node') return true;
-  const selected = String(record?.task_nodes?.[task.command] || '').trim();
-  if (!selected || !self?.hostname) return false;
-  return selected === self.ip || meshNodeKey(selected) === meshNodeKey(self.hostname);
-}
-
-/** Local minute-slot key, e.g. 2026-09-22T14:05. */
-export function minuteSlot(date) {
-  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}T${pad(date.getHours())}:${pad(date.getMinutes())}`;
-}
-
-function slotToDate(slot) {
-  const m = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})$/.exec(String(slot || ''));
-  return m ? new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]), Number(m[4]), Number(m[5])) : null;
-}
-
-/**
- * The most recent slot matching `cron` in (lastSlot, now], or null.
- * @returns {string|null}
- */
-export function latestDueSlot(cron, lastSlot, now = new Date()) {
-  const floorNow = new Date(now.getFullYear(), now.getMonth(), now.getDate(), now.getHours(), now.getMinutes());
-  const last = slotToDate(lastSlot);
-  for (let i = 0; i < MAX_CATCHUP_MINUTES; i++) {
-    const candidate = new Date(floorNow.getTime() - i * 60_000);
-    if (last && candidate <= last) return null;
-    if (cronMatches(cron, candidate)) return minuteSlot(candidate);
-  }
-  return null;
-}
-
-/**
- * Run every task that is due. Tasks run sequentially so a slow plugin cannot
- * multiply into concurrent processes on a constrained host.
- * @param {{ projectRoot?: string, now?: Date, runner?: Function, selfNode?: object }} [options]
- * @returns {Promise<Array<{ plugin: string, command: string, slot: string, ok: boolean, exitCode: number|null }>>}
- */
-export async function runDuePluginTasks(options = {}) {
-  const { projectRoot = process.cwd(), now = new Date(), runner = runPluginCommand } = options;
-  const selfNode = options.selfNode === undefined ? getMeshSelf() : options.selfNode;
-  const results = [];
-
-  for (const plugin of discoverPlugins(projectRoot)) {
-    if (!plugin.valid || !Array.isArray(plugin.manifest.tasks) || plugin.manifest.tasks.length === 0) continue;
-
-    let record = readPluginRecord(plugin);
-    if (!record) record = await ensurePluginRecord(plugin);
-    // Scheduled work follows the repository's own setting for a shared plugin.
-    if (!pluginExecutionEnabled(plugin, { projectRoot })) continue;
-    const runs = { ...(record?.task_runs || {}) };
-    let changed = false;
-
-    for (const task of plugin.manifest.tasks) {
-      if (!taskRunsOnNode(task, record, selfNode)) continue;
-      let cron;
-      try {
-        cron = parseCron(task.schedule);
-      } catch (err) {
-        logger.warn('plugin-tasks', `Skipping ${plugin.id}:${task.command} — ${err.message}`);
-        continue;
-      }
-
-      if (!runs[task.command]) {
-        // First sighting: mark the present so the first run is the next real slot.
-        runs[task.command] = minuteSlot(now);
-        changed = true;
-        continue;
-      }
-
-      const slot = latestDueSlot(cron, runs[task.command], now);
-      if (!slot) continue;
-
-      const result = await runner(plugin, { subcommand: task.command, cwd: projectRoot, timeoutMs: task.timeout_ms || TASK_TIMEOUT_MS })
-        .catch((err) => ({ ok: false, exitCode: null, output: err.message, durationMs: 0, timedOut: false }));
-      runs[task.command] = slot;
-      changed = true;
-      results.push({ plugin: plugin.id, command: task.command, slot, ok: result.ok, exitCode: result.exitCode });
-
-      try {
-        await appendVfsEvent(
-          `plugins/${plugin.id}/task-${Date.now()}`,
-          {
-            kind: 'plugin.task_run',
-            plugin_id: plugin.id,
-            command: task.command,
-            intent: task.intent,
-            slot,
-            ok: result.ok,
-            exit_code: result.exitCode,
-            timed_out: !!result.timedOut,
-            duration_ms: result.durationMs,
-            output_tail: String(result.output || '').slice(-2000)
-          },
-          { actorRole: 'system', intent: 'Record plugin task run', vaultRoot: vaultForPluginsDir(plugin.pluginsDir) }
-        );
-      } catch (err) {
-        logger.warn('plugin-tasks', `Could not record task run for ${plugin.id}: ${err.message}`);
-      }
-    }
-
-    if (changed) {
-      try {
-        await patchPluginRecord(plugin, { task_runs: runs });
-      } catch (err) {
-        logger.warn('plugin-tasks', `Could not update task runs for ${plugin.id}: ${err.message}`);
-      }
-    }
-  }
-
-  return results;
-}
-
-let timer = null;
-let running = false;
-
-/** Check for due plugin tasks once a minute. Returns a stop function. */
-export function startPluginTaskScheduler(options = {}) {
-  if (timer) return () => stopPluginTaskScheduler();
-  const tick = async () => {
-    if (running) return;
-    running = true;
-    try {
-      const results = await runDuePluginTasks(options);
-      for (const r of results) {
-        logger.info('plugin-tasks', `${r.plugin}:${r.command} slot ${r.slot} ${r.ok ? 'ok' : `failed (exit ${r.exitCode})`}`);
-      }
-    } catch (err) {
-      logger.warn('plugin-tasks', `Scheduler tick failed: ${err.message}`);
-    } finally {
-      running = false;
-    }
-  };
-  timer = setInterval(tick, 60_000);
-  timer.unref?.();
-  tick();
-  return () => stopPluginTaskScheduler();
-}
-
-export function stopPluginTaskScheduler() {
-  if (timer) clearInterval(timer);
-  timer = null;
-}

package/templates/onboarding-interview.md

@@ -1,82 +0,0 @@
----
-type: task
-slug: onboarding-interview
-category: onboarding
-title: "Conduct portable-memory onboarding interview"
-status: pending
-priority: 1
-created: {{CREATED_AT}}
-updated: {{CREATED_AT}}
----
-
-## Objective
-
-Conduct a warm, practical onboarding interview so Total Recall can store durable preferences and facts as Markdown memory nodes. This is personal portable memory — not an operating system takeover. Keep the tone helpful and concrete.
-
-## Instructions for the Agent
-
-When the user starts their next chat session (and they have no `user-profile` yet), conduct this interview BEFORE unrelated work. Do NOT dump all questions at once. Ask one at a time. Acknowledge each answer before the next.
-
-Once the user has answered (or skipped any), write their answers into the vault using tools / CLI (`remember` or direct vault writes). Prefer CLI when available:
-
-```bash
-npx total-recall remember preference "..." --tags "user,profile,onboarding" --importance 5
-```
-
-## Interview Questions (ask one at a time)
-
-1. **Who are you?** — "Quick intro: what do you do, and what are you most focused on right now?"
-
-2. **What should I remember?** — "What kinds of things matter most for me to keep: decisions, preferences, project facts, people, or something else?"
-
-3. **Which tools do you use?** — "Which IDEs or agents should share this memory? (Claude Code, Cursor, Codex, Gemini, Aider, Obsidian, HTTP, etc.) I can guide you with `npx total-recall connect …`."
-
-4. **How should I talk?** — "Prefer short answers or detailed ones? Should I push back or mostly support?"
-
-5. **Hard rules** — "Any absolute do's or don'ts I must always follow (style, tools, safety)?"
-
-6. **Background work** — "Want dream consolidation and optional daemon tasks running in the background, or on-demand only?"
-
-7. **Secrets** — "API keys never go in the vault. Use `npx total-recall auth secret set`. Any keys you want to set up next?"
-
-8. **Notifications (optional)** — "Want Telegram pings when background tasks finish? If yes, BotFather token + chat ID."
-
-## Product context to reinforce (lightly, not as a lecture)
-
-- **Write** → `remember` / session ingest  
-- **Sleep** → `dream` (consolidate, conflict-check, recompile)  
-- **Read** → `recall` + compiled surfaces in any connected IDE  
-- **Async** → open task queue / daemon under policy  
-- Hosts are equal — track any repo; no product-specific hardcoding
-
-## After the Interview
-
-Write (or update) these files:
-
-**`.agent/config/notifications.yml`** — only if they provided Telegram details:
-```yaml
-telegram_bot_token: "their-token-here"
-telegram_chat_id: "their-chat-id-here"
-```
-
-**`.agent/memory-vault/preferences/user-profile.md`** — identity + communication style  
-**`.agent/memory-vault/preferences/user-priorities.md`** — goals and what they want from memory  
-**`.agent/memory-vault/preferences/user-interests.md`** — topics worth tracking
-
-Frontmatter template:
-```yaml
----
-type: memory
-slug: user-profile
-category: preferences
-title: "User Profile"
-status: active
-confidence: 1.0
-importance: 5
-created: <ISO timestamp>
-updated: <ISO timestamp>
-tags: [user, profile, onboarding]
----
-```
-
-Then mark this task `status: done` and confirm the profile was saved. Point them at the dashboard **Onboarding** page or `init → connect → remember → dream` if they prefer CLI-only.