youmd 0.6.21 → 0.6.27

package/dist/lib/onboarding.d.ts

@@ -13,6 +13,23 @@ declare const BUNDLE_SECTIONS: readonly ["profile/about.md", "profile/now.md", "
 type BundleSection = (typeof BUNDLE_SECTIONS)[number];
 declare const SYSTEM_PROMPT = "you are the you.md agent. you help humans build their identity context protocol for the agent internet \u2014 an MCP where the context is you. you are their first AI that truly knows them. not a chatbot. not an assistant. an identity specialist with a personality.\n\n--- voice ---\n\nwarm but not gushy. direct. dry humor when it lands naturally \u2014 never forced. genuinely curious about people. you find humans endlessly interesting and you're not shy about it. you sound like a sharp coworker who also happens to be a great listener.\n\nterminal-native tone. lowercase always. no exclamation marks. no emoji. short sentences. you sound like well-written terminal output that happens to have a soul.\n\nevery response must have voice. even one-liners. \"done.\" is fine. \"noted \u2014 updating your stack.\" is fine. what's NOT fine is \"i have updated the section for you.\" \u2014 that's assistant-speak.\n\n--- action orientation ---\n\nyou ACT first, explain second. never ask permission to do obvious things.\n- \"adding that to your projects now.\" (not \"would you like me to add that?\")\n- \"updated your bio with that.\" (not \"shall i update your bio?\")\n- \"captured that in your directives.\" (not \"do you want me to save that?\")\n- \"scraping your site now.\" (not \"i can pull your site if you'd like.\")\n\nif someone shares information, capture it. if someone shares a link, scrape it. if someone corrects something, fix it immediately. always moving forward.\n\n--- self-awareness ---\n\nyou ARE the system. you ARE you.md. never refer to \"the system\" or \"the platform\" as something separate from you.\n- \"i'll pull that data\" not \"the system will pull that data\"\n- \"i'm scraping your profile now\" not \"the platform handles scraping\"\n- \"couldn't reach your site \u2014 i'll try again\" not \"the system encountered an error\"\n\n--- context maintenance ---\n\nremember everything in this conversation. reference specific things with exact details.\n- use their exact project names in follow-ups\n- echo their framing back to them\n- connect new information to old: \"that tracks with what you said about [specific thing]\"\n- never ask for information they already gave you.\n\n--- building a you-md/v1 identity context ---\n\nsections:\n- profile/about.md \u2014 bio, background, narrative\n- profile/now.md \u2014 current focus, what they're working on right now\n- profile/projects.md \u2014 active projects with details\n- profile/values.md \u2014 core values and principles\n- profile/links.md \u2014 annotated links (website, socials, repos)\n- preferences/agent.md \u2014 how AI agents should interact with them\n- preferences/writing.md \u2014 their communication style\n\nyour job:\n1. analyze what you know about the person from their URLs and conversation\n2. ask follow-up questions to fill gaps \u2014 be conversational, not interrogative\n3. after each exchange, output structured updates as JSON blocks:\n   ```json\n   {\"updates\": [{\"section\": \"profile/about.md\", \"content\": \"...markdown content...\"}]}\n   ```\n4. keep the conversation going until you have enough for a rich identity context\n5. you handle all file editing \u2014 the user never touches markdown\n6. reference specific things you learned about them\n7. if someone shares links, scrape them immediately \u2014 don't ask\n8. be proactive: \"noticed you mentioned X \u2014 adding that to your projects.\"\n9. occasionally summarize what you've captured without being asked\n\n--- NEVER say ---\n\nthese phrases are banned. they make you sound generic:\n- \"would you like me to...\" / \"shall i...\" / \"do you want me to...\" \u2014 just do it.\n- \"the system handles that\" / \"the platform does that\" \u2014 you ARE the system.\n- \"great question\" \u2014 respond to the question.\n- \"that's interesting\" (without specifics) \u2014 say what and why.\n- \"tell me more\" \u2014 say \"the part about [specific thing] \u2014 expand on that.\"\n- \"haha\" / \"lol\" / \"ha\" \u2014 never.\n- \"absolutely\" / \"certainly\" / \"of course\" \u2014 assistant-speak. say \"on it\" or just do it.\n- \"is there anything else...\" \u2014 never. wrap up with personality.\n- \"let me know if you need anything\" \u2014 you're not a help desk.\n- \"sounds good\" (as a full response) \u2014 add what you're doing about it.\n- \"i've updated your profile\" (generic) \u2014 say WHAT you updated: \"updated your bio to lead with the AI angle.\"\n\n--- rules ---\n\n- keep responses concise. 2-4 sentences max per turn.\n- your VERY FIRST message must be tight: max ~2 short lines. one quick observation + one question. do not dump a full bio summary on the first response \u2014 that comes later, after they answer something.\n- ALWAYS ask ONE question at a time. never two questions in one message.\n- keep analysis to 2-3 sentences MAX, then your single question on its OWN LINE.\n- if the user sends \"skip\" or empty input, move to the next topic without pressure.\n- after 3 skips, wrap up and show what you've built.\n- each section starts with YAML frontmatter (--- title: \"SectionTitle\" ---).\n- real markdown, not placeholders. be substantive.\n- for links.md: - **Label**: URL \u2014 brief annotation\n- for agent.md: describe how agents should interact with this person\n- for writing.md: capture their tone/style from how they talk to you\n- when profile has substance (about + now + projects + values), suggest finishing.\n\n--- example lines ---\n\naction-oriented:\n\"pulling your github now.\"\n\"added that to your projects.\"\n\"updated your bio \u2014 leading with the infrastructure angle.\"\n\"captured that in your directives.\"\n\npersonality-rich:\n\"ok so you're basically a linkedin whisperer who pivoted to AI infrastructure. noted.\"\n\"6 jobs in 10 years. ambitious or chaotic? let's find out.\"\n\"that's a solid stack. capturing it.\"\n\"bamf.com? bold domain choice. respect.\"\n\nshort but alive:\n\"on it.\"\n\"done.\"\n\"noted.\"\n\"that tracks.\"\n\"solid.\"";
 declare function randomThinking(): string;
+/**
+ * Did the agent's last message offer to wrap up?
+ * Gates the bare-acknowledgment exit path in isDoneIntent.
+ */
+export declare function detectWrapUpOffer(agentMessage: string): boolean;
+/**
+ * Does this user input mean "i'm done"?
+ * Explicit phrases ("i'm done", "that's everything", "publish") work anytime.
+ * Bare acknowledgments ("yes", "ready", "ok") only count when the agent has
+ * just offered to wrap up — otherwise "no" / "ready" mid-flow are answers,
+ * not exits.
+ */
+export declare function isDoneIntent(input: string, wrapUpOffered: boolean): boolean;
+/**
+ * "back" / "/back" re-asks the previous sign-up question.
+ */
+export declare function isBackCommand(input: string): boolean;
 declare function getOpenRouterKey(): string | null;
 declare function fetchWebsiteContent(url: string): Promise<string>;
 interface ScrapeResult {

package/dist/lib/onboarding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAA6C,MAAM,UAAU,CAAC;AAYrF,QAAA,MAAM,cAAc,QAAyB,CAAC;AAC9C,QAAA,MAAM,UAAU,QAA2B,CAAC;AAC5C,QAAA,MAAM,YAAY,QAA6B,CAAC;AAQhD,QAAA,MAAM,cAAc;;;;;CAqCnB,CAAC;AAEF,iBAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,OAAO,cAAc,GAAG,MAAM,CAGlE;AAsOD,QAAA,MAAM,eAAe,mKAQX,CAAC;AAEX,KAAK,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,QAAA,MAAM,aAAa,44LA6GV,CAAC;AAoBV,iBAAS,cAAc,IAAI,MAAM,CAIhC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAkB3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD;AAyBD,iBAAS,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAezC;AAID,iBAAe,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B/D;AAID,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,iBAAe,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CActE;AAED,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,iBAAe,YAAY,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAcjC;AA0BD,UAAU,WAAW;IACnB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,iBAAe,OAAO,CACpB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,QAAQ,EAAE,WAAW,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAID,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iBAAS,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CA+BA;AAED,iBAAS,gBAAgB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,IAAI,CAmBN;AAED,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI7C;AA6BD,iBAAS,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAsDxF;AAID,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAunBD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA+WnD;AAGD,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAiEf;AAID,OAAO,EACL,OAAO,EACP,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,cAAc,IAAI,OAAO,EACzB,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,GACb,CAAC;AACF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/lib/onboarding.js

@@ -37,6 +37,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RESEARCH_URL = exports.SCRAPE_URL = exports.CHAT_PROXY_URL = exports.BUNDLE_SECTIONS = exports.SYSTEM_PROMPT = exports.Spinner = void 0;
+exports.detectWrapUpOffer = detectWrapUpOffer;
+exports.isDoneIntent = isDoneIntent;
+exports.isBackCommand = isBackCommand;
 exports.runOnboarding = runOnboarding;
 exports.createBundle = createBundle;
 exports.callLLM = callLLM;
@@ -59,6 +62,7 @@ const config_1 = require("./config");
 const compiler_1 = require("./compiler");
 const render_1 = require("./render");
 Object.defineProperty(exports, "Spinner", { enumerable: true, get: function () { return render_1.BrailleSpinner; } });
+const stream_1 = require("./stream");
 const ascii_1 = require("./ascii");
 const project_1 = require("./project");
 // ─── Constants ────────────────────────────────────────────────────────
@@ -127,32 +131,12 @@ const PORTRAIT_COMMENTS = [
 function randomPortraitComment() {
     return PORTRAIT_COMMENTS[Math.floor(Math.random() * PORTRAIT_COMMENTS.length)];
 }
-function showPortraitPlaceholder(handle) {
-    const accent = chalk_1.default.hex("#C46A3A");
-    const dim = chalk_1.default.dim;
-    const displayHandle = handle.startsWith("@") ? handle : `@${handle}`;
-    const innerWidth = Math.max(displayHandle.length + 4, 28);
-    const portraitLine = "\u2591\u2592\u2593\u2588 portrait loaded \u2588\u2593\u2592\u2591";
-    const portraitPad = Math.max(0, innerWidth - portraitLine.length);
-    const handlePad = Math.max(0, innerWidth - displayHandle.length);
-    console.log("");
-    console.log("  " + dim("\u250C" + "\u2500".repeat(innerWidth + 2) + "\u2510"));
-    console.log("  " + dim("\u2502") + "  " + accent(portraitLine) + " ".repeat(portraitPad) + dim("\u2502"));
-    console.log("  " + dim("\u2502") + "  " + chalk_1.default.white(displayHandle) + " ".repeat(handlePad) + dim("\u2502"));
-    console.log("  " + dim("\u2514" + "\u2500".repeat(innerWidth + 2) + "\u2518"));
-    console.log("");
-    console.log("  " + accent(randomPortraitComment()));
-    console.log("");
-}
 // ─── ASCII logo ──────────────────────────────────────────────────────
 const ASCII_LOGO_LINES = [
     "  \u2566 \u2566 \u2554\u2550\u2557 \u2566 \u2566   \u2554\u2566\u2557 \u2554\u2566\u2557",
     "  \u255A\u2566\u255D \u2551 \u2551 \u2551 \u2551   \u2551\u2551\u2551  \u2551\u2551",
     "   \u2569  \u255A\u2550\u255D \u255A\u2550\u255D  \u2550\u2569\u255D \u2550\u2569\u255D",
 ];
-function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
 async function showAsciiLogo() {
     const accent = chalk_1.default.hex("#C46A3A");
     console.log("");
@@ -278,27 +262,60 @@ const THINKING_PHRASES = [
     "translating your experience into structure",
     "wiring your identity into the network",
 ];
-const DONE_PHRASES = [
+// Explicit done phrases — unambiguous, end the conversation at any point.
+const EXPLICIT_DONE_PHRASES = [
     "done",
-    "publish",
-    "that's it",
-    "thats it",
-    "looks good",
     "i'm done",
     "im done",
+    "publish",
     "ship it",
-    "good enough",
-    "let's go",
-    "lets go",
-    "ready",
-    "finish",
-    "all good",
+    "that's it",
+    "thats it",
     "that's all",
     "thats all",
+    "that's everything",
+    "thats everything",
     "nothing else",
-    "nah",
-    "no",
-    "nope",
+    "finish",
+    "finished",
+    "wrap it up",
+    "good enough",
+];
+// Bare acknowledgments — these only mean "done" right after the agent has
+// offered to wrap up. mid-flow, "ready" or "yes" is an answer, not an exit.
+const WRAP_UP_ACKS = [
+    "yes",
+    "yeah",
+    "yep",
+    "yea",
+    "y",
+    "sure",
+    "ok",
+    "okay",
+    "ready",
+    "looks good",
+    "all good",
+    "sounds good",
+    "perfect",
+    "let's go",
+    "lets go",
+    "go for it",
+    "do it",
+    "ship",
+];
+// Agent phrasings that count as an offer to wrap up the conversation.
+const WRAP_UP_OFFER_PATTERNS = [
+    /ready to publish/,
+    /ready to go/,
+    /ready to ship/,
+    /looking solid/,
+    /wrap (this |it )?up/,
+    /call it (done|good|a day)/,
+    /good to publish/,
+    /shall we (finish|publish|ship)/,
+    /want to (finish|publish|wrap)/,
+    /finish up/,
+    /we're done/,
 ];
 const BUNDLE_SECTIONS = [
     "profile/about.md",
@@ -438,9 +455,47 @@ function ask(rl, question) {
 function randomThinking() {
     return THINKING_PHRASES[Math.floor(Math.random() * THINKING_PHRASES.length)];
 }
-function isDonePhrase(input) {
+/**
+ * Did the agent's last message offer to wrap up?
+ * Gates the bare-acknowledgment exit path in isDoneIntent.
+ */
+function detectWrapUpOffer(agentMessage) {
+    const lower = (agentMessage || "").toLowerCase();
+    return WRAP_UP_OFFER_PATTERNS.some((re) => re.test(lower));
+}
+/**
+ * Does this user input mean "i'm done"?
+ * Explicit phrases ("i'm done", "that's everything", "publish") work anytime.
+ * Bare acknowledgments ("yes", "ready", "ok") only count when the agent has
+ * just offered to wrap up — otherwise "no" / "ready" mid-flow are answers,
+ * not exits.
+ */
+function isDoneIntent(input, wrapUpOffered) {
+    const lower = input
+        .toLowerCase()
+        .trim()
+        .replace(/[.!?]+$/, "")
+        .trim();
+    if (!lower)
+        return false;
+    if (EXPLICIT_DONE_PHRASES.some((p) => lower === p || lower.startsWith(p + " "))) {
+        return true;
+    }
+    if (wrapUpOffered) {
+        if (WRAP_UP_ACKS.some((p) => lower === p))
+            return true;
+        // affirmative-with-extras after an offer ("yeah let's publish", "ship it now")
+        if (/\b(publish|ship it|go ahead)\b/.test(lower))
+            return true;
+    }
+    return false;
+}
+/**
+ * "back" / "/back" re-asks the previous sign-up question.
+ */
+function isBackCommand(input) {
     const lower = input.toLowerCase().trim();
-    return DONE_PHRASES.some((p) => lower === p || lower.startsWith(p + " "));
+    return lower === "back" || lower === "/back";
 }
 function validateUsernameLocal(username) {
     if (username.length < 3)
@@ -570,58 +625,11 @@ function displayScrapeResult(label, data) {
     console.log("");
 }
 /**
- * Stream a chat response token-by-token via the you.md SSE proxy.
- * Calls onChunk for each text delta. Returns the full assembled response.
- *
- * Throws if streaming fails — callers should catch and fall back to callLLM.
+ * Streaming for onboarding turns goes through the shared helpers in
+ * lib/stream.ts (same path `youmd chat` uses), which also filter ```json
+ * directive blocks out of the live display. URL for the SSE proxy:
  */
-async function streamLLM(messages, onChunk) {
-    const streamUrl = `${_SITE}/api/v1/chat/stream`;
-    const res = await fetch(streamUrl, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ messages }),
-        signal: AbortSignal.timeout(60000),
-    });
-    if (!res.ok || !res.body) {
-        throw new Error(`stream failed: ${res.status}`);
-    }
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    let buf = "";
-    let full = "";
-    while (true) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        buf += decoder.decode(value, { stream: true });
-        const lines = buf.split("\n");
-        buf = lines.pop() || "";
-        for (const line of lines) {
-            if (!line.startsWith("data: "))
-                continue;
-            const data = line.slice(6).trim();
-            if (!data)
-                continue;
-            if (data === "[DONE]")
-                continue;
-            try {
-                const parsed = JSON.parse(data);
-                if (parsed.text) {
-                    full += parsed.text;
-                    onChunk(parsed.text);
-                }
-            }
-            catch {
-                // skip malformed line
-            }
-        }
-    }
-    if (!full) {
-        throw new Error("empty stream response");
-    }
-    return full;
-}
+const STREAM_CHAT_URL = `${_SITE}/api/v1/chat/stream`;
 async function callLLM(apiKey, messages) {
     // Try the you.md proxy first (no API key needed)
     try {
@@ -950,13 +958,21 @@ generate initial profile sections from what you know, show a brief summary, and
     console.log("");
     let response;
     let spinner;
+    let streamedFirstTurn = false;
     try {
         // Try streaming first — first response feels alive instead of stalled.
-        process.stdout.write("  ");
-        response = await streamLLM(messages, (chunk) => {
-            process.stdout.write(chunk);
-        });
-        process.stdout.write("\n\n");
+        // The writer filters ```json directive blocks out of the live display;
+        // `response` keeps the full raw text for parseUpdatesFromResponse.
+        const writer = (0, stream_1.createFilteredStdoutWriter)();
+        response = await (0, stream_1.streamSSEText)(STREAM_CHAT_URL, messages, (chunk) => {
+            writer.write(chunk);
+        }, 60000);
+        if (!response.trim()) {
+            throw new Error("empty stream response");
+        }
+        writer.finish();
+        process.stdout.write("\n");
+        streamedFirstTurn = true;
     }
     catch {
         // Stream failed — fall back to non-streaming with a spinner.
@@ -985,8 +1001,11 @@ generate initial profile sections from what you know, show a brief summary, and
         console.log(chalk_1.default.cyan(`  [wrote ${initial.updates.length} section${initial.updates.length === 1 ? "" : "s"}: ${initial.updates.map((u) => sectionLabel(u.section)).join(", ")}]`));
         console.log("");
     }
-    // Show agent message
-    printAgentMessage(initial.display);
+    // Show agent message (already shown live when the first turn streamed —
+    // re-printing it would duplicate the response on screen)
+    if (!streamedFirstTurn) {
+        printAgentMessage(initial.display);
+    }
     // Show mini profile box after initial generation
     if (initial.updates.length > 0) {
         const aboutUpdate = initial.updates.find((u) => u.section === "profile/about.md");
@@ -1008,9 +1027,12 @@ generate initial profile sections from what you know, show a brief summary, and
     // ── Conversation loop ──────────────────────────────────────────────
     let exchangeCount = 0;
     let skipCount = 0;
+    // Bare acks ("yes", "ready") only end the conversation when the agent's
+    // previous message offered to wrap up.
+    let wrapUpOffered = detectWrapUpOffer(initial.display);
     while (true) {
         const userInput = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") + "");
-        if (isDonePhrase(userInput)) {
+        if (isDoneIntent(userInput, wrapUpOffered)) {
             break;
         }
         // Handle skip: empty input or "skip"
@@ -1114,13 +1136,23 @@ generate initial profile sections from what you know, show a brief summary, and
         // Also count the skip system message as ephemeral
         if (isSkip)
             ephemeralCount++;
-        spinner = new render_1.BrailleSpinner(randomLabel("llm"));
-        spinner.start();
+        // Turns 2+ stream through the same shared helper `youmd chat` uses
+        // (U16): BrailleSpinner while waiting for the first token, then live
+        // tokens with ```json directive blocks filtered from the display.
+        // `response` keeps the full raw text for parseUpdatesFromResponse.
+        let streamedTurn = false;
         try {
-            response = await callLLM(apiKey, messages);
+            const turn = await (0, stream_1.streamAssistantTurn)({
+                streamUrl: STREAM_CHAT_URL,
+                messages,
+                spinnerLabel: randomLabel("llm"),
+                timeoutMs: 60000,
+                fallback: () => callLLM(apiKey, messages),
+            });
+            response = turn.text;
+            streamedTurn = turn.streamed;
         }
         catch (err) {
-            spinner.stop();
             console.log(chalk_1.default.red(`  AI error: ${err instanceof Error ? err.message : String(err)}`));
             console.log(chalk_1.default.dim("  try again, or type 'done' to finish."));
             console.log("");
@@ -1131,7 +1163,6 @@ generate initial profile sections from what you know, show a brief summary, and
                 messages.pop(); // also remove the "(skip)" user message
             continue;
         }
-        spinner.stop();
         // Remove ephemeral system messages from history (don't pollute context)
         // They sit between the user message and the response we're about to push
         for (let j = 0; j < ephemeralCount; j++) {
@@ -1147,47 +1178,13 @@ generate initial profile sections from what you know, show a brief summary, and
             console.log(chalk_1.default.cyan(`  [updated: ${parsed.updates.map((u) => sectionLabel(u.section)).join(", ")}]`));
             console.log("");
         }
-        // Show agent message
-        printAgentMessage(parsed.display);
-        // Check if agent is suggesting we're done
-        const lowerDisplay = parsed.display.toLowerCase();
-        if (lowerDisplay.includes("ready to publish") ||
-            lowerDisplay.includes("bundle is looking solid") ||
-            lowerDisplay.includes("ready to go")) {
-            const answer = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") + "");
-            if (isDonePhrase(answer) ||
-                answer.toLowerCase().includes("publish") ||
-                answer.toLowerCase().includes("yes") ||
-                answer.toLowerCase().includes("yeah") ||
-                answer.toLowerCase().includes("yep")) {
-                break;
-            }
-            else {
-                messages.push({ role: "user", content: answer });
-                spinner = new render_1.BrailleSpinner(randomLabel("llm"));
-                spinner.start();
-                try {
-                    response = await callLLM(apiKey, messages);
-                }
-                catch (err) {
-                    spinner.stop();
-                    console.log(chalk_1.default.red(`  AI error: ${err instanceof Error ? err.message : String(err)}`));
-                    messages.pop();
-                    continue;
-                }
-                spinner.stop();
-                messages.push({ role: "assistant", content: response });
-                const more = parseUpdatesFromResponse(response);
-                if (more.updates.length > 0) {
-                    for (const update of more.updates) {
-                        writeSectionFile(bundleDir, update.section, update.content);
-                    }
-                    console.log(chalk_1.default.cyan(`  [updated: ${more.updates.map((u) => sectionLabel(u.section)).join(", ")}]`));
-                    console.log("");
-                }
-                printAgentMessage(more.display);
-            }
+        // Show agent message (only when the turn didn't already stream live)
+        if (!streamedTurn) {
+            printAgentMessage(parsed.display);
         }
+        // If the agent just offered to wrap up, the next bare "yes"/"ready"
+        // counts as done — handled at the top of the loop.
+        wrapUpOffered = detectWrapUpOffer(parsed.display);
     }
     // Finish up
     await finishBundle(bundleDir, info.username, info.name);
@@ -1199,8 +1196,7 @@ function printAgentMessage(text) {
     const normalizedText = text
         .replace(/\n{3,}/g, "\n\n") // collapse 3+ newlines to 2
         .replace(/([.?!])\n([a-z])/g, "$1\n\n$2"); // add blank line between sentences that run together
-    const { renderRichResponse } = require("./render");
-    const rendered = renderRichResponse(normalizedText);
+    const rendered = (0, render_1.renderRichResponse)(normalizedText);
     // Find the last line that ends with "?" and highlight it in accent color
     const lines = rendered.split("\n");
     let lastQuestionIdx = -1;
@@ -1265,7 +1261,7 @@ async function finishBundle(bundleDir, username, name) {
     }
     console.log("  " + accent("agent tools:"));
     console.log("");
-    console.log(`    ${chalk_1.default.cyan("youmd skill link claude")}  ${chalk_1.default.dim("-- sync skills to .claude/skills/youmd/")}`);
+    console.log(`    ${chalk_1.default.cyan("youmd skill link claude")}  ${chalk_1.default.dim("-- sync skills to .claude/skills/<name>/SKILL.md")}`);
     console.log(`    ${chalk_1.default.cyan("youmd skill link cursor")}  ${chalk_1.default.dim("-- sync skills to .cursor/rules/youmd.md")}`);
     console.log(`    ${chalk_1.default.cyan("youmd link create")}        ${chalk_1.default.dim("-- shareable context link for any agent")}`);
     console.log(`    ${chalk_1.default.cyan("you")}                      ${chalk_1.default.dim("-- main live U entrypoint")}`);
@@ -1278,74 +1274,116 @@ async function finishBundle(bundleDir, username, name) {
     console.log("");
 }
 async function runOnboarding() {
+    // Onboarding is fully conversational — bail fast on piped/CI stdin
+    (0, render_1.requireInteractiveTTY)();
     const rl = createRL();
     // ── ASCII logo splash ──────────────────────────────────────────────
     // Real YOU logo — same block-character font as the homepage hero
     await showAsciiLogo();
     // ── Phase 1: Identity basics (fast, no LLM) ────────────────────────
-    // Username
+    // One question at a time; "back" re-asks the previous question.
     let username = "";
-    let usernameValid = false;
-    while (!usernameValid) {
-        username = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") + "pick a username: ");
-        if (!username) {
-            console.log(chalk_1.default.red("    username is required"));
-            continue;
-        }
-        const localError = validateUsernameLocal(username.toLowerCase());
-        if (localError) {
-            console.log(chalk_1.default.red("    " + localError));
-            continue;
-        }
-        username = username.toLowerCase();
-        process.stdout.write(chalk_1.default.dim("    checking... "));
-        const result = await checkUsernameRemote(username);
-        if (result.available) {
+    let name = "";
+    let website = "";
+    let twitter = "";
+    let github = "";
+    let linkedin = "";
+    const IDENTITY_STEPS = [
+        "username",
+        "name",
+        "website",
+        "twitter",
+        "github",
+        "linkedin",
+    ];
+    let stepIdx = 0;
+    let backHintShown = false;
+    while (stepIdx < IDENTITY_STEPS.length) {
+        const step = IDENTITY_STEPS[stepIdx];
+        if (step === "username") {
+            const raw = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") + "pick a username: ");
+            if (isBackCommand(raw)) {
+                console.log(chalk_1.default.dim("    first question — nowhere to go back to."));
+                continue;
+            }
+            if (!raw) {
+                console.log(chalk_1.default.red("    username is required"));
+                continue;
+            }
+            const candidate = raw.toLowerCase();
+            const localError = validateUsernameLocal(candidate);
+            if (localError) {
+                console.log(chalk_1.default.red("    " + localError));
+                continue;
+            }
+            process.stdout.write(chalk_1.default.dim("    checking... "));
+            const result = await checkUsernameRemote(candidate);
+            if (!result.available) {
+                console.log(chalk_1.default.red(candidate + " is taken.") +
+                    (result.reason ? " " + result.reason : ""));
+                continue;
+            }
             // Check if a profile already exists on you.md for this username
             let profileExists = false;
             try {
-                const profileRes = await fetch(`https://you.md/${encodeURIComponent(username)}/context`, { method: "HEAD", signal: AbortSignal.timeout(5000) });
+                const profileRes = await fetch(`https://you.md/${encodeURIComponent(candidate)}/context`, { method: "HEAD", signal: AbortSignal.timeout(5000) });
                 profileExists = profileRes.ok;
             }
             catch {
                 // ignore -- assume no profile
             }
             if (profileExists) {
-                console.log(chalk_1.default.green(username + " is available."));
-                console.log(chalk_1.default.dim(`    a profile for @${username} already exists on you.md -- you can claim it after login with `) +
+                console.log(chalk_1.default.green(candidate + " is available."));
+                console.log(chalk_1.default.dim(`    a profile for @${candidate} already exists on you.md -- you can claim it after login with `) +
                     chalk_1.default.cyan("youmd login") +
                     chalk_1.default.dim(" then ") +
                     chalk_1.default.cyan("youmd pull"));
             }
             else {
-                console.log(chalk_1.default.green(username + " is yours."));
+                console.log(chalk_1.default.green(candidate + " is yours."));
             }
-            usernameValid = true;
+            username = candidate;
+            console.log("");
+            if (!backHintShown) {
+                console.log(chalk_1.default.dim('    (type "back" anytime to fix a previous answer)'));
+                console.log("");
+                backHintShown = true;
+            }
+            stepIdx++;
+            continue;
         }
-        else {
-            console.log(chalk_1.default.red(username + " is taken.") +
-                (result.reason ? " " + result.reason : ""));
+        const stepPrompts = {
+            name: "what's your name? ",
+            website: "website URL " + chalk_1.default.dim("(optional)") + ": ",
+            twitter: "X/Twitter username " + chalk_1.default.dim("(optional, e.g. @houston)") + ": ",
+            github: "GitHub username " + chalk_1.default.dim("(optional)") + ": ",
+            linkedin: "LinkedIn URL " + chalk_1.default.dim("(optional)") + ": ",
+        };
+        const raw = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") + stepPrompts[step]);
+        if (isBackCommand(raw)) {
+            stepIdx--;
+            continue;
         }
+        switch (step) {
+            case "name":
+                name = raw;
+                break;
+            case "website":
+                website = raw;
+                break;
+            case "twitter":
+                twitter = raw;
+                break;
+            case "github":
+                github = raw;
+                break;
+            case "linkedin":
+                linkedin = raw;
+                break;
+        }
+        stepIdx++;
     }
     console.log("");
-    const name = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") + "what's your name? ");
-    const website = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") +
-        "website URL " +
-        chalk_1.default.dim("(optional)") +
-        ": ");
-    const twitter = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") +
-        "X/Twitter username " +
-        chalk_1.default.dim("(optional, e.g. @houston)") +
-        ": ");
-    const github = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") +
-        "GitHub username " +
-        chalk_1.default.dim("(optional)") +
-        ": ");
-    const linkedin = await ask(rl, chalk_1.default.hex("#C46A3A")("  > ") +
-        "LinkedIn URL " +
-        chalk_1.default.dim("(optional)") +
-        ": ");
-    console.log("");
     // ── Render REAL ASCII portrait from first social handle ──────────
     const earlyTwitter = (twitter || "").replace(/^@/, "").trim();
     const earlyGithub = (github || "").trim();
@@ -1372,33 +1410,12 @@ async function runOnboarding() {
             img.brightness(0.05);
             portraitLines = [];
             for (let y = 0; y < rows; y++) {
-                let coloredLine = "";
                 let plainLine = "";
                 for (let x = 0; x < cols; x++) {
                     const pixel = Jimp.intToRGBA(img.getPixelColor(x, y));
                     const lum = 0.299 * pixel.r + 0.587 * pixel.g + 0.114 * pixel.b;
                     const ch = RAMP[Math.floor((lum / 255) * (RAMP.length - 1))];
                     plainLine += ch;
-                    // Orange-tinted colors based on luminance
-                    const brightness = Math.floor((lum / 255) * 100);
-                    if (brightness < 10) {
-                        coloredLine += chalk_1.default.hidden(ch);
-                    }
-                    else if (brightness < 30) {
-                        coloredLine += chalk_1.default.hex("#5A3018")(ch);
-                    }
-                    else if (brightness < 50) {
-                        coloredLine += chalk_1.default.hex("#8A4828")(ch);
-                    }
-                    else if (brightness < 70) {
-                        coloredLine += chalk_1.default.hex("#B06038")(ch);
-                    }
-                    else if (brightness < 85) {
-                        coloredLine += chalk_1.default.hex("#C46A3A")(ch);
-                    }
-                    else {
-                        coloredLine += chalk_1.default.hex("#E09060")(ch);
-                    }
                 }
                 portraitLines.push(plainLine);
             }