youmd 0.13.11 → 0.13.14

package/dist/commands/chat.d.ts

@@ -1,2 +1,7 @@
+/**
+ * Render a failed You Agent turn with the real reason. Billing / key
+ * problems get the fix line; transient outages get "try again".
+ */
+export declare function printChatFailure(err: unknown): void;
 export declare function chatCommand(): Promise<void>;
 //# sourceMappingURL=chat.d.ts.map

package/dist/commands/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AA+gEA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqlBjD"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AA2sBA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAUnD;AAy7CD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAklBjD"}

package/dist/commands/chat.js

@@ -36,6 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.printChatFailure = printChatFailure;
 exports.chatCommand = chatCommand;
 const readline = __importStar(require("readline"));
 const fs = __importStar(require("fs"));
@@ -57,6 +58,8 @@ const version_1 = require("../lib/version");
 const machine_bootstrap_prompt_1 = require("../lib/machine-bootstrap-prompt");
 // ─── URL Detection + Scraping (mirrors web useYouAgent) ──────────────
 const config_2 = require("../lib/config");
+const chat_errors_1 = require("../lib/chat-errors");
+const workspace_brief_1 = require("../lib/workspace-brief");
 const CONVEX_SITE_URL = (0, config_2.getConvexSiteUrl)();
 const STREAM_URL = `${CONVEX_SITE_URL}/api/v1/chat/stream`;
 const CURRENT_VERSION = (0, version_1.readCliVersion)();
@@ -401,6 +404,10 @@ your job:
 
 rules: each section starts with YAML frontmatter. real markdown, not placeholders. output FULL section content each time. be substantive — write from what you actually know.
 
+--- fresh workspace block ---
+
+the user message may carry a "fresh local workspace" block: git branch, recent commits, uncommitted files, current-state and open items per repo, plus machine-level agent directives. it was read from disk seconds ago. treat it as ground truth over anything in the stored profile, now.md, or private projects. when the stored profile says one thing and the fresh block says another, say so plainly and offer to update the stale section. reference real commit subjects and file names, never invent activity. when asked what the user is working on, answer from this block first.
+
 --- project context updates ---
 
 if the user is working in a project (you'll see a [PROJECT CONTEXT] block), you can update project files. when you learn something about the project — a decision made, a task completed, a feature shipped, a new requirement — output:
@@ -595,6 +602,23 @@ async function handlePublish(bundleDir) {
         console.log("");
     }
 }
+/**
+ * Render a failed You Agent turn with the real reason. Billing / key
+ * problems get the fix line; transient outages get "try again".
+ */
+function printChatFailure(err) {
+    const [headline, ...why] = (0, chat_errors_1.explainChatError)(err);
+    console.log(chalk_1.default.red(`  ${headline}`));
+    for (const line of why)
+        console.log(chalk_1.default.dim(`    ${line}`));
+    if (err instanceof chat_errors_1.ChatServiceError && err.operatorActionable) {
+        console.log(chalk_1.default.dim("  fix that, then send your message again. ") + chalk_1.default.cyan("you doctor") + chalk_1.default.dim(" shows live provider status."));
+    }
+    else {
+        console.log(chalk_1.default.dim("  try again. ") + chalk_1.default.cyan("you doctor") + chalk_1.default.dim(" shows live provider status."));
+    }
+    console.log("");
+}
 function handleRebuild(bundleDir) {
     console.log("");
     const result = (0, compiler_1.compileBundle)(bundleDir);
@@ -812,6 +836,32 @@ async function printUpdateHint() {
     console.log("  " + chalk_1.default.dim("or: ") + chalk_1.default.cyan(`npm install -g youmd@${latest}`));
     console.log("");
 }
+function insightFromBrief(b) {
+    return {
+        name: b.name,
+        slug: b.name,
+        projectDir: b.projectDir,
+        updatedAt: b.freshness || Date.now(),
+        signals: [b.headline],
+        summary: `${b.name}: ${b.headline}`,
+        suggestedCommand: `cd ${b.projectDir} && you`,
+    };
+}
+/**
+ * Build the fresh workspace brief for the launch: the current repo first,
+ * then the most recently touched workspace projects. Read-only and bounded.
+ */
+function buildLaunchBrief(projectCtx, limit = 6) {
+    const candidates = [];
+    if (projectCtx)
+        candidates.push({ name: projectCtx.name, projectDir: projectCtx.root });
+    for (const item of [...scanRecentWorkspaceProjects(limit * 2), ...(0, project_1.getRecentProjectInsights)(process.cwd(), limit * 2)]) {
+        if (fs.existsSync(path.join(item.projectDir, ".git")) || fs.existsSync(path.join(item.projectDir, "project-context"))) {
+            candidates.push({ name: item.name, projectDir: item.projectDir });
+        }
+    }
+    return (0, workspace_brief_1.buildWorkspaceBrief)(candidates, { maxProjects: limit });
+}
 function countMarkdownFiles(dir) {
     if (!fs.existsSync(dir))
         return 0;
@@ -1022,6 +1072,27 @@ async function runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects)
         }
         const homeSignals = collectHomeAgentSignals();
         findings.push(...homeSignals.slice(0, 2));
+        // Ground everything in what git says is actually moving. This replaces
+        // "already looks pretty well-shaped" and first-TODO-line guesses with the
+        // latest commit, branch, and uncommitted work of the freshest repo.
+        let brief;
+        try {
+            spinner.update("reading recent commits across your repos");
+            brief = buildLaunchBrief(projectCtx);
+            if (brief.strongestProject) {
+                const top = brief.strongestProject;
+                findings.unshift(`freshest repo: ${top.name} — ${top.headline}.`);
+                const inProjectWithBootstrapNeed = projectCtx && repoNeedsBootstrap(projectCtx.root);
+                if (!inProjectWithBootstrapNeed && brief.strongestMove) {
+                    strongestMove = brief.strongestMove;
+                    strongestProject = insightFromBrief(top);
+                    strongestCommand = `cd ${top.projectDir} && you`;
+                }
+            }
+        }
+        catch {
+            // brief is best-effort; keep the marker-based findings
+        }
         spinner.stop("looked through local context");
         return {
             findings: findings.slice(0, 3),
@@ -1029,6 +1100,7 @@ async function runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects)
             strongestCommand,
             strongestProject,
             recentProjects: recentProjects.slice(0, 3),
+            brief,
         };
     }
     finally {
@@ -1100,9 +1172,15 @@ function buildYouLaunchIntro(projectCtx, bundleDir, investigation) {
     }
     else if (recentProjects.length > 0) {
         lines.push(`recent orbit: ${recentProjects.slice(0, 3).join(", ")}.`);
-        const topOpportunity = (0, project_1.getTopProjectOpportunity)(recentInsights);
-        if (topOpportunity) {
-            lines.push(`strongest opening: ${topOpportunity.summary}`);
+        const briefTop = investigation.brief?.strongestProject;
+        if (briefTop) {
+            lines.push(`freshest: ${briefTop.name} — ${briefTop.headline}.`);
+        }
+        else {
+            const topOpportunity = (0, project_1.getTopProjectOpportunity)(recentInsights);
+            if (topOpportunity) {
+                lines.push(`strongest opening: ${topOpportunity.summary}`);
+            }
         }
     }
     else {
@@ -1117,10 +1195,13 @@ function buildYouLaunchIntro(projectCtx, bundleDir, investigation) {
             : null)
         || (0, project_1.getTopProjectOpportunity)(recentInsights)?.summary
         || null;
-    if (strongestMove) {
+    if (strongestMove && !lines.some((line) => line.includes(strongestMove))) {
         lines.push(`next strongest move: ${strongestMove}`);
         lines.push("say \"start there\" and i'll take it.");
     }
+    else if (strongestMove) {
+        lines.push("say \"start there\" and i'll pick that thread up.");
+    }
     else {
         lines.push("point me at the next thing and i'll move first.");
     }
@@ -1520,9 +1601,12 @@ function formatProjectReadToolResult(project) {
         .slice(0, 5);
     const managedContext = (0, project_1.readProjectContext)(project.projectDir);
     const actionItems = extractProjectActionItems(project.projectDir);
-    const recommendedMove = actionItems.length > 0
-        ? actionItems[0]
-        : `tighten ${project.name}'s current-state and TODO docs from actual repo context.`;
+    const brief = (0, workspace_brief_1.buildProjectBrief)({ name: project.name, projectDir: project.projectDir });
+    const recommendedMove = brief.activity.commits.length > 0 || brief.currentState || brief.openItems.length > 0
+        ? (0, workspace_brief_1.buildStrongestMove)(brief)
+        : actionItems.length > 0
+            ? actionItems[0]
+            : `tighten ${project.name}'s current-state and TODO docs from actual repo context.`;
     return [
         "tool: read_project_context",
         "status: ok",
@@ -1532,6 +1616,9 @@ function formatProjectReadToolResult(project) {
         managedContext ? `managed_project_context: ${managedContext.meta.name}` : "managed_project_context: none",
         actionItems.length > 0 ? `action_items: ${actionItems.join(" | ")}` : "action_items: none found in TODO/current-state files",
         "",
+        "--- git activity (read just now) ---",
+        (0, workspace_brief_1.formatProjectActivityForTool)(brief),
+        "",
         snippets.length > 0 ? snippets.join("\n\n---\n\n") : "no readable project-context or agent entrypoint files found yet.",
         "",
         `recommended_next_move: ${recommendedMove}`,
@@ -1737,7 +1824,19 @@ async function handleLocalChatIntent(args) {
             `next strongest move: ${recommended || "continue from the local result above."}`,
         ].join("\n");
     };
-    const recordLocalToolResult = (toolResult) => {
+    // The tool result is ground truth; the model turns it into an actual read
+    // of the project. Before this, the CLI printed a canned template and never
+    // asked the model at all, so "start there" twice produced the same lines.
+    const recordLocalToolResult = async (toolResult, toolName) => {
+        const projectLine = toolResult.match(/^project:\s*(.+)$/m)?.[1]?.trim()
+            ?? toolResult.match(/^recommended_next_project:\s*(.+)$/m)?.[1]?.trim()
+            ?? "";
+        const toolKey = `${toolName}:${projectLine}`;
+        const repeats = args.launchInvestigation.lastToolKey === toolKey
+            ? (args.launchInvestigation.lastToolRepeats ?? 0) + 1
+            : 0;
+        args.launchInvestigation.lastToolKey = toolKey;
+        args.launchInvestigation.lastToolRepeats = repeats;
         args.messages.push({ role: "user", content: args.userInput });
         args.messages.push({
             role: "user",
@@ -1751,14 +1850,31 @@ async function handleLocalChatIntent(args) {
                 "Do not ask the user what the local project is if the tool result already names it.",
                 "State what the local host actually found, make one concrete recommendation, and end with the exact phrase `next strongest move: ...`.",
                 "For workspace scans, reuse recommended_next_move as the final next strongest move. The supported follow-up command is `start there`; do not invent commands like `open PROJECT`.",
-                "For read_project_context results, summarize what you actually saw and recommend the next concrete local tool action.",
+                "For read_project_context results: lead with what the git activity says is in motion (latest commits, branch, uncommitted work), then what the agent docs and current-state say, then one sharp observation about drift between the stored profile and this reality. Name real commit subjects and files. Do not list every file you were shown.",
                 "For sync_identity results, state whether local compile or remote publish happened.",
-                "Do not end with a question. Keep it under 8 lines. No generic help-desk closer.",
-            ].join("\n"),
+                repeats > 0
+                    ? `The user already saw this ${toolName} result ${repeats} time${repeats === 1 ? "" : "s"} in this session. Do not repeat the file list or the same recommendation. Go deeper: what changed most recently, what is half-finished, what the next concrete action is, and offer to update the stale profile or private project entry if the stored picture is behind.`
+                    : "",
+                "Do not end with a question. Keep it under 10 lines. No generic help-desk closer.",
+            ].filter(Boolean).join("\n"),
         });
-        const summary = summarizeLocalToolResult(toolResult);
-        args.messages.push({ role: "assistant", content: summary });
-        printAgentMessage(summary);
+        try {
+            const result = await callLLMWithStreaming(args.apiKey, args.messages, repeats > 0 ? "reading it properly this time" : "making sense of what i found");
+            const parsed = (0, onboarding_1.parseUpdatesFromResponse)(result.text);
+            args.messages.push({ role: "assistant", content: result.text });
+            if (!result.streamed)
+                printAgentMessage(parsed.display);
+        }
+        catch (err) {
+            // Model unavailable: fall back to the deterministic summary so the
+            // user still sees what the host found, plus the real reason.
+            const summary = summarizeLocalToolResult(toolResult);
+            args.messages.push({ role: "assistant", content: summary });
+            printAgentMessage(summary);
+            const [headline] = (0, chat_errors_1.explainChatError)(err);
+            console.log(chalk_1.default.dim(`  (model unavailable — ${headline})`));
+            console.log("");
+        }
     };
     if (isLocalToolLoopCandidate(args.userInput)) {
         const routeSpinner = new render_1.BrailleSpinner("choosing local tool");
@@ -1780,7 +1896,7 @@ async function handleLocalChatIntent(args) {
             const toolResult = await executeLocalHostTool(toolCall, args);
             const statusLine = toolResult.match(/^status: (.+)$/m)?.[1] || "done";
             spinner.stop(statusLine);
-            recordLocalToolResult(toolResult);
+            await recordLocalToolResult(toolResult, toolCall.tool);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : "local tool failed";
@@ -1890,11 +2006,14 @@ async function chatCommand() {
     if (projectCtx && repoNeedsBootstrap(projectCtx.root)) {
         greetingInstruction += " i am inside a repo that is missing some agent/project wiring. briefly mention that you noticed it and that you can set it up if i want, but do not derail the opening message into a long checklist.";
     }
+    const workspaceBriefBlock = launchInvestigation.brief?.text
+        ? `\n\n${launchInvestigation.brief.text}`
+        : "";
     const messages = [
         { role: "system", content: CHAT_SYSTEM_PROMPT },
         {
             role: "user",
-            content: `here is my current identity bundle:\n\n${currentBundle}${directivesContext}${projectContextBlock}\n\n${greetingInstruction}`,
+            content: `here is my current identity bundle:\n\n${currentBundle}${directivesContext}${projectContextBlock}${workspaceBriefBlock}\n\n${greetingInstruction}`,
         },
     ];
     // Initial greeting is local and action-aware. The remote model should not invent
@@ -2047,8 +2166,7 @@ async function chatCommand() {
                 streamed = result.streamed;
             }
             catch (err) {
-                console.log(chalk_1.default.red(`  AI error: ${err instanceof Error ? err.message : String(err)}`));
-                console.log(chalk_1.default.dim("  try again."));
+                printChatFailure(err);
                 console.log("");
                 messages.pop();
                 continue;
@@ -2215,9 +2333,7 @@ async function chatCommand() {
             streamed = result.streamed;
         }
         catch (err) {
-            console.log(chalk_1.default.red(`  ${err instanceof Error ? err.message : "failed"}`));
-            console.log(chalk_1.default.dim("  try again."));
-            console.log("");
+            printChatFailure(err);
             messages.pop();
             if (newSources.length > 0)
                 messages.pop(); // remove scrape context too