youmd 0.6.21 → 0.6.26

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);
             }