youmd 0.6.11 → 0.6.19

package/dist/commands/chat.js

@@ -46,6 +46,7 @@ const config_1 = require("../lib/config");
 const project_1 = require("../lib/project");
 const compiler_1 = require("../lib/compiler");
 const api_1 = require("../lib/api");
+const skills_1 = require("../lib/skills");
 const render_1 = require("../lib/render");
 const onboarding_1 = require("../lib/onboarding");
 const ascii_1 = require("../lib/ascii");
@@ -54,7 +55,7 @@ const update_1 = require("../lib/update");
 const config_2 = require("../lib/config");
 const CONVEX_SITE_URL = (0, config_2.getConvexSiteUrl)();
 const STREAM_URL = `${CONVEX_SITE_URL}/api/v1/chat/stream`;
-const CURRENT_VERSION = "0.6.11";
+const CURRENT_VERSION = "0.6.19";
 function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -915,6 +916,59 @@ function countMarkdownFiles(dir) {
         return 0;
     }
 }
+function formatRelativeTimeFromMs(ms) {
+    const diff = Date.now() - ms;
+    const hour = 60 * 60 * 1000;
+    const day = 24 * hour;
+    if (diff < hour)
+        return "within the last hour";
+    if (diff < day)
+        return `${Math.max(1, Math.floor(diff / hour))}h ago`;
+    return `${Math.max(1, Math.floor(diff / day))}d ago`;
+}
+function statMtimeMs(filePath) {
+    try {
+        return fs.statSync(filePath).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+function collectHomeAgentSignals() {
+    const findings = [];
+    const home = os.homedir();
+    const homeAgents = path.join(home, "AGENTS.md");
+    const homeClaude = path.join(home, "CLAUDE.md");
+    const claudeConfig = path.join(home, ".claude", "CLAUDE.md");
+    const claudeProjects = path.join(home, ".claude", "projects");
+    const codexProjects = path.join(home, ".codex", "projects");
+    const legacyCodexProjects = path.join(home, ".Codex", "projects");
+    const stackSyncSkill = path.join(home, ".claude", "skills", "agent-stack-sync");
+    const homeInstructionFiles = [homeAgents, homeClaude, claudeConfig].filter((filePath) => fs.existsSync(filePath));
+    if (homeInstructionFiles.length > 0) {
+        findings.push("your home-level agent instructions are present, so i can anchor on shared guidance instead of guessing.");
+    }
+    const recentHomeInstruction = homeInstructionFiles
+        .map((filePath) => statMtimeMs(filePath))
+        .filter((value) => typeof value === "number")
+        .sort((a, b) => b - a)[0];
+    if (recentHomeInstruction) {
+        findings.push(`your shared agent docs were touched ${formatRelativeTimeFromMs(recentHomeInstruction)}.`);
+    }
+    const recentSessionRoots = [claudeProjects, codexProjects, legacyCodexProjects]
+        .map((dir) => ({ dir, mtime: statMtimeMs(dir) }))
+        .filter((entry) => !!entry.mtime)
+        .sort((a, b) => b.mtime - a.mtime);
+    if (recentSessionRoots.length > 0) {
+        const freshest = recentSessionRoots[0];
+        const label = freshest.dir.includes(".claude") ? "claude" : "codex";
+        findings.push(`there's fresh ${label}-side session activity under ${freshest.dir} from ${formatRelativeTimeFromMs(freshest.mtime)}.`);
+    }
+    if (fs.existsSync(stackSyncSkill)) {
+        findings.push("your shared stack-sync skill is installed, so i can lean on mirrored cross-agent context too.");
+    }
+    return findings;
+}
 async function runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects) {
     const labels = [
         "sipping bitbucks frappaccino while i look around",
@@ -925,13 +979,16 @@ async function runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects)
     const spinner = new render_1.BrailleSpinner(labels[0]);
     let labelIndex = 1;
     const findings = [];
+    let strongestMove;
+    let strongestCommand;
+    let strongestProject;
     const rotation = setInterval(() => {
         spinner.update(labels[labelIndex % labels.length]);
         labelIndex += 1;
     }, 1100);
     spinner.start();
     try {
-        await delay(160);
+        await delay(600);
         try {
             const hasPreferences = fs.existsSync(path.join(bundleDir, "preferences", "agent.md"));
             const hasDirectives = fs.existsSync(path.join(bundleDir, "directives", "agent.md"));
@@ -945,6 +1002,8 @@ async function runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects)
         catch {
             // keep scanning other surfaces
         }
+        const homeSignals = collectHomeAgentSignals();
+        findings.push(...homeSignals.slice(0, 3));
         if (projectCtx) {
             try {
                 const hasAgents = fs.existsSync(path.join(projectCtx.root, "AGENTS.md"));
@@ -966,6 +1025,19 @@ async function runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects)
                 else {
                     findings.push(`${projectCtx.name} still wants a real project-context spine.`);
                 }
+                if (repoNeedsBootstrap(projectCtx.root)) {
+                    strongestMove = `${projectCtx.name} still wants cleaner agent wiring and project-context scaffolding.`;
+                    strongestCommand = "youmd skill init-project";
+                    strongestProject = {
+                        name: projectCtx.name,
+                        slug: projectCtx.name,
+                        projectDir: projectCtx.root,
+                        updatedAt: Date.now(),
+                        signals: ["still wants cleaner agent wiring and project-context scaffolding"],
+                        summary: `${projectCtx.name} still wants cleaner agent wiring and project-context scaffolding.`,
+                        suggestedCommand: "youmd skill init-project",
+                    };
+                }
             }
             catch {
                 findings.push(`${projectCtx.name} is open, but one of the local context probes tripped over itself.`);
@@ -982,13 +1054,25 @@ async function runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects)
             if (opportunities.length === 0 && insights.length > 0) {
                 findings.push(`${insights[0].name} already looks pretty well-shaped, so i can go deeper instead of scaffolding basics.`);
             }
+            else if (opportunities.length > 0) {
+                const strongest = opportunities[0];
+                strongestMove = strongest.summary;
+                strongestCommand = strongest.suggestedCommand;
+                strongestProject = strongest;
+            }
         }
         else {
             findings.push("i've got your home bundle loaded, even though we're not inside a project yet.");
         }
-        await delay(220);
+        await delay(900);
         spinner.stop("looked through local context");
-        return { findings: findings.slice(0, 4) };
+        return {
+            findings: findings.slice(0, 3),
+            strongestMove,
+            strongestCommand,
+            strongestProject,
+            recentProjects: recentProjects.slice(0, 3),
+        };
     }
     finally {
         clearInterval(rotation);
@@ -1003,7 +1087,7 @@ async function printChatOpening(bundleDir, projectCtx) {
     const recentInsights = (0, project_1.getRecentProjectInsights)(process.cwd(), 6);
     const recentProjects = (0, project_1.getFeaturedRecentProjectNames)(recentInsights, 6);
     const launchSurface = process.env.YOUMD_LAUNCH_SURFACE;
-    let investigation = { findings: [] };
+    let investigation = { findings: [], recentProjects: recentProjects.slice(0, 3) };
     (0, ascii_1.printYouLogo)();
     let didShowPortrait = false;
     if (launchSurface !== "you") {
@@ -1018,6 +1102,7 @@ async function printChatOpening(bundleDir, projectCtx) {
                 currentProject: projectCtx?.name,
                 recentProjects,
                 portraitLines,
+                compact: true,
             })
             : false;
     }
@@ -1025,78 +1110,289 @@ async function printChatOpening(bundleDir, projectCtx) {
         console.log("");
         console.log("  " + ACCENT("there you are.") + " " + DIM("your portrait is loaded."));
     }
-    if (launchSurface === "you") {
-        console.log("");
-        investigation = await runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects);
-        if (investigation.findings.length > 0) {
-            console.log("");
-            console.log("  " + ACCENT("i checked a few corners."));
-            for (const finding of investigation.findings) {
-                console.log("  " + DIM("· ") + chalk_1.default.white(finding));
-            }
-        }
-    }
     console.log("");
-    if (launchSurface === "you") {
-        console.log("  " + ACCENT("u is here.") + " " + DIM(`good to see you, ${displayName}.`));
-    }
-    else {
-        console.log("  " + ACCENT("u is here.") + " " + DIM(`good to see you, ${user}.`));
-    }
-    if (projectCtx) {
-        console.log("  " + DIM("current project: ") + chalk_1.default.white(projectCtx.name) + DIM(` (${projectCtx.root})`));
-        if (repoNeedsBootstrap(projectCtx.root)) {
-            console.log("  " + ACCENT("i spotted an opening.") + " " + DIM("this repo still wants AGENTS/project-context wiring."));
-            console.log("  " + DIM("say the word or run ") + chalk_1.default.cyan("youmd skill init-project") + DIM(" and i'll set it up."));
+    investigation = await runYouLaunchInvestigation(bundleDir, projectCtx, recentProjects);
+    if (investigation.findings.length > 0) {
+        console.log("");
+        console.log("  " + ACCENT("found:"));
+        for (const finding of investigation.findings.slice(0, 2)) {
+            console.log("  " + DIM("· ") + chalk_1.default.white(finding));
         }
     }
-    else {
-        console.log("  " + DIM("i don't see a repo context here yet, but i can still help with your identity, links, memories, and private context."));
-    }
-    if (recentProjects.length > 0) {
-        console.log("  " + DIM("recently active: ") + recentProjects.map((name) => chalk_1.default.cyan(name)).join(DIM(", ")));
-    }
-    const topOpportunity = !projectCtx ? (0, project_1.getTopProjectOpportunity)(recentInsights) : null;
-    if (topOpportunity) {
-        console.log("  " + ACCENT("next opening i see.") + " " + DIM(topOpportunity.summary));
-        console.log("  " + DIM("run:"));
-        console.log("    " + chalk_1.default.cyan(topOpportunity.suggestedCommand));
-        console.log("  " + DIM("then i'll help tighten it up."));
+    if (launchSurface !== "you") {
+        console.log("");
+        console.log("  " + chalk_1.default.bold("you.md chat"));
+        console.log("  " + DIM(`local context loaded for ${user}.`));
     }
     console.log("");
-    console.log("  " + chalk_1.default.bold("you.md chat"));
-    console.log("  " + DIM("talk naturally. i'll update your identity, spot useful structure, and suggest next moves."));
-    console.log("");
     return investigation;
 }
 function buildYouLaunchIntro(projectCtx, bundleDir, investigation) {
     const displayName = readDisplayName(bundleDir).split(" ")[0];
     const recentInsights = (0, project_1.getRecentProjectInsights)(process.cwd(), 6);
-    const recentProjects = (0, project_1.getFeaturedRecentProjectNames)(recentInsights, 6);
+    const recentProjects = investigation.recentProjects.length > 0
+        ? investigation.recentProjects
+        : (0, project_1.getFeaturedRecentProjectNames)(recentInsights, 3);
     const lines = [];
-    lines.push(`hi ${displayName}. i'm U — i help other agents know you.`);
+    lines.push(`hi ${displayName}. i'm U.`);
     if (projectCtx) {
-        lines.push(`i already clocked that you're inside ${projectCtx.name}.`);
+        lines.push(`i'm inside ${projectCtx.name}.`);
         if (repoNeedsBootstrap(projectCtx.root)) {
-            lines.push("this repo still wants cleaner agent wiring, so i can scaffold that whenever you want.");
+            lines.push("it still wants cleaner agent wiring.");
         }
     }
     else if (recentProjects.length > 0) {
-        lines.push(`recently you've been orbiting ${recentProjects.slice(0, 3).join(", ")}.`);
+        lines.push(`recent orbit: ${recentProjects.slice(0, 3).join(", ")}.`);
         const topOpportunity = (0, project_1.getTopProjectOpportunity)(recentInsights);
         if (topOpportunity) {
-            lines.push(`biggest opening i see: ${topOpportunity.summary}`);
+            lines.push(`strongest opening: ${topOpportunity.summary}`);
         }
     }
     else {
-        lines.push("clean slate. we can still shape your identity, private context, or project structure from here.");
+        lines.push("clean slate. we can shape identity, private context, or project structure from here.");
+    }
+    const strongestMove = investigation.strongestMove
+        || (projectCtx && repoNeedsBootstrap(projectCtx.root)
+            ? `${projectCtx.name} still wants cleaner agent wiring and project-context scaffolding.`
+            : null)
+        || (0, project_1.getTopProjectOpportunity)(recentInsights)?.summary
+        || null;
+    if (strongestMove) {
+        lines.push(`next strongest move: ${strongestMove}`);
+        lines.push("say \"start there\" and i'll take it.");
     }
-    if (investigation.findings.length > 0) {
-        lines.push(`quick read: ${investigation.findings.slice(0, 2).join(" ")}`);
+    else {
+        lines.push("point me at the next thing and i'll move first.");
     }
-    lines.push("what are we moving forward right now?");
     return lines.join("\n\n");
 }
+function isStartThereIntent(input) {
+    const lower = input.toLowerCase().trim().replace(/[.!?]+$/, "");
+    return [
+        "start there",
+        "start there please",
+        "do that",
+        "do it",
+        "take it",
+        "go",
+        "go ahead",
+        "yes",
+        "yep",
+        "start",
+    ].includes(lower);
+}
+function isLocalRecentProjectsIntent(input) {
+    const lower = input.toLowerCase();
+    const mentionsLocalWork = lower.includes("local director") ||
+        lower.includes("local directory") ||
+        lower.includes("local filesystem") ||
+        lower.includes("my local") ||
+        lower.includes("on my computer") ||
+        lower.includes("workspace") ||
+        lower.includes("workspaces");
+    const asksRecentWork = lower.includes("recently touched") ||
+        lower.includes("most recently") ||
+        lower.includes("what i've been working") ||
+        lower.includes("what ive been working") ||
+        lower.includes("working on lately") ||
+        lower.includes("recent projects");
+    return mentionsLocalWork && asksRecentWork;
+}
+function getLocalWorkspaceRoots() {
+    return (0, project_1.getWorkspaceRootCandidates)(process.cwd());
+}
+function getRecentFileMtime(projectDir, maxFiles = 1200) {
+    const skipDirs = new Set([
+        ".git",
+        "node_modules",
+        ".next",
+        "dist",
+        "build",
+        ".turbo",
+        ".vercel",
+        "coverage",
+        ".cache",
+    ]);
+    let latest = 0;
+    let visited = 0;
+    const stack = [{ dir: projectDir, depth: 0 }];
+    while (stack.length > 0 && visited < maxFiles) {
+        const current = stack.pop();
+        if (!current)
+            break;
+        let entries = [];
+        try {
+            entries = fs.readdirSync(current.dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (visited >= maxFiles)
+                break;
+            if (entry.name.startsWith(".") && entry.name !== ".youmd-project")
+                continue;
+            const fullPath = path.join(current.dir, entry.name);
+            try {
+                const stat = fs.statSync(fullPath);
+                latest = Math.max(latest, stat.mtimeMs);
+                visited += 1;
+                if (entry.isDirectory() && current.depth < 3 && !skipDirs.has(entry.name)) {
+                    stack.push({ dir: fullPath, depth: current.depth + 1 });
+                }
+            }
+            catch {
+                // keep scanning; one unreadable file should not break the local read.
+            }
+        }
+    }
+    return latest;
+}
+function scanRecentWorkspaceProjects(limit = 8) {
+    const insights = [];
+    const seen = new Set();
+    for (const root of getLocalWorkspaceRoots()) {
+        let entries = [];
+        try {
+            entries = fs.readdirSync(root, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith("."))
+                continue;
+            const projectDir = path.join(root, entry.name);
+            let realDir = projectDir;
+            try {
+                realDir = fs.realpathSync.native(projectDir);
+            }
+            catch {
+                // use unresolved path below
+            }
+            if (seen.has(realDir))
+                continue;
+            seen.add(realDir);
+            const markerSignals = (0, project_1.getProjectMarkerSignals)(projectDir);
+            if (markerSignals.length === 0)
+                continue;
+            const updatedAt = Math.max(getRecentFileMtime(projectDir), statMtimeMs(projectDir) || 0);
+            insights.push({
+                name: entry.name,
+                slug: entry.name,
+                projectDir,
+                updatedAt,
+                signals: markerSignals,
+                summary: `${entry.name} touched ${formatRelativeTimeFromMs(updatedAt)}${markerSignals.length > 0 ? `; found ${markerSignals.slice(0, 3).join(", ")}` : ""}.`,
+                suggestedCommand: `cd ${projectDir} && you`,
+            });
+        }
+    }
+    return insights.sort((a, b) => b.updatedAt - a.updatedAt).slice(0, limit);
+}
+function formatLocalRecentProjectsToolResult(insights) {
+    if (insights.length === 0) {
+        const roots = getLocalWorkspaceRoots();
+        return roots.length === 0
+            ? "tool: workspace_recent_projects\nstatus: empty\nresult: checked common local workspace roots and did not find one. users can set YOUMD_WORKSPACE_ROOTS to add explicit roots."
+            : "tool: workspace_recent_projects\nstatus: empty\nresult: found the workspace root, but no project folders showed up in the first scan.";
+    }
+    const lines = [
+        "tool: workspace_recent_projects",
+        "status: ok",
+        "projects:",
+        ...insights.slice(0, 6).map((item, index) => {
+            const markers = item.signals.length > 0 ? ` — ${item.signals.slice(0, 3).join(", ")}` : "";
+            return `${index + 1}. ${item.name} — ${item.projectDir} — touched ${formatRelativeTimeFromMs(item.updatedAt)}${markers}`;
+        }),
+        "",
+        `recommended_next_project: ${insights[0].name}`,
+        `recommended_next_project_dir: ${insights[0].projectDir}`,
+        `recommended_next_command: cd ${insights[0].projectDir} && you`,
+        `recommended_next_move: say "start there" to open ${insights[0].name} and tighten the agent entrypoint from actual files, not a guessed summary.`,
+    ];
+    return lines.join("\n");
+}
+function formatProjectBootstrapToolResult(project, result) {
+    const changed = result.steps
+        .filter((step) => step.ok && step.detail && !step.detail.includes("unchanged") && !step.detail.includes("already present"))
+        .map((step) => `${step.name}: ${step.detail}`);
+    const checked = result.steps.filter((step) => step.ok).length;
+    return [
+        "tool: project_bootstrap",
+        "status: ok",
+        `project: ${project.name}`,
+        `project_dir: ${project.projectDir}`,
+        changed.length > 0
+            ? `changed: ${changed.slice(0, 6).join("; ")}`
+            : `changed: none; checked ${checked} bootstrap steps; everything important was already present.`,
+        "",
+        `recommended_next_move: read ${project.name}'s project-context and turn the rough docs into a sharper current-state + TODO pass.`,
+    ].join("\n");
+}
+async function handleLocalChatIntent(args) {
+    const runToolResultThroughModel = async (toolResult, spinnerLabel) => {
+        args.messages.push({ role: "user", content: args.userInput });
+        args.messages.push({
+            role: "user",
+            content: [
+                "--- local host tool result ---",
+                toolResult,
+                "--- instructions ---",
+                "Use this local tool result as ground truth. Do not say you cannot access the filesystem; the CLI host just accessed it for you.",
+                "Use recommended_next_project exactly as the target unless the user explicitly asks for a different project.",
+                "Do not say you are scraping, pulling, reading, opening, or updating anything now unless that completed action appears in the tool result.",
+                "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`.",
+                "Do not end with a question. Keep it under 8 lines. No generic help-desk closer.",
+            ].join("\n"),
+        });
+        const result = await callLLMWithStreaming(args.apiKey, args.messages, spinnerLabel);
+        args.messages.push({ role: "assistant", content: result.text });
+        if (!result.streamed) {
+            printAgentMessage((0, onboarding_1.parseUpdatesFromResponse)(result.text).display);
+        }
+    };
+    if (isLocalRecentProjectsIntent(args.userInput)) {
+        const spinner = new render_1.BrailleSpinner("checking local workspaces");
+        spinner.start();
+        await delay(700);
+        const insights = scanRecentWorkspaceProjects(8);
+        spinner.stop("local workspace scanned");
+        args.launchInvestigation.strongestProject = insights[0] || args.launchInvestigation.strongestProject;
+        args.launchInvestigation.strongestMove = insights[0]?.summary || args.launchInvestigation.strongestMove;
+        await runToolResultThroughModel(formatLocalRecentProjectsToolResult(insights), "turning local project scan into a useful read");
+        return true;
+    }
+    if (isStartThereIntent(args.userInput)) {
+        const project = args.launchInvestigation.strongestProject ||
+            (0, project_1.getTopProjectOpportunity)((0, project_1.getRecentProjectInsights)(process.cwd(), 8));
+        if (!project || !fs.existsSync(project.projectDir)) {
+            const response = "i don't have a real local target for that yet. ask me to scan local workspaces and i'll pick from actual folders.\n\nnext strongest move: scan local recent projects first.";
+            args.messages.push({ role: "user", content: args.userInput });
+            args.messages.push({ role: "assistant", content: response });
+            printAgentMessage(response);
+            return true;
+        }
+        const spinner = new render_1.BrailleSpinner(`opening ${project.name} from local disk`);
+        spinner.start();
+        await delay(500);
+        const previousCwd = process.cwd();
+        let result;
+        try {
+            process.chdir(project.projectDir);
+            result = (0, skills_1.initProject)({ mode: "additive" });
+        }
+        finally {
+            process.chdir(previousCwd);
+        }
+        spinner.stop(`${project.name} updated`);
+        await runToolResultThroughModel(formatProjectBootstrapToolResult(project, result), `summarizing ${project.name} changes`);
+        return true;
+    }
+    return false;
+}
 // ─── Main chat command ────────────────────────────────────────────────
 async function chatCommand() {
     const bundleDir = resolveBundleDirForChat();
@@ -1193,41 +1489,11 @@ async function chatCommand() {
             content: `here is my current identity bundle:\n\n${currentBundle}${directivesContext}${projectContextBlock}\n\n${greetingInstruction}`,
         },
     ];
-    // Initial greeting from agent
-    if (process.env.YOUMD_LAUNCH_SURFACE === "you") {
-        const proactiveIntro = buildYouLaunchIntro(projectCtx, bundleDir, launchInvestigation);
-        messages.push({ role: "assistant", content: proactiveIntro });
-        printAgentMessage(proactiveIntro);
-    }
-    else {
-        let response;
-        let streamed = false;
-        try {
-            const result = await callLLMWithStreaming(apiKey, messages, (0, onboarding_1.randomThinking)());
-            response = result.text;
-            streamed = result.streamed;
-        }
-        catch (err) {
-            console.log(chalk_1.default.red(`  failed to connect: ${err instanceof Error ? err.message : String(err)}`));
-            console.log(chalk_1.default.dim("  chat requires the AI service. try again later."));
-            console.log("");
-            rl.close();
-            return;
-        }
-        messages.push({ role: "assistant", content: response });
-        const initial = (0, onboarding_1.parseUpdatesFromResponse)(response);
-        // Write any updates (unlikely on greeting, but handle it)
-        if (initial.updates.length > 0) {
-            for (const update of initial.updates) {
-                (0, onboarding_1.writeSectionFile)(bundleDir, update.section, update.content);
-            }
-            console.log(chalk_1.default.cyan(`  [updated: ${initial.updates.map((u) => (0, onboarding_1.sectionLabel)(u.section)).join(", ")}]`));
-            console.log("");
-        }
-        if (!streamed) {
-            printAgentMessage(initial.display);
-        }
-    }
+    // Initial greeting is local and action-aware. The remote model should not invent
+    // filesystem capabilities before the CLI has decided what it can actually do.
+    const proactiveIntro = buildYouLaunchIntro(projectCtx, bundleDir, launchInvestigation);
+    messages.push({ role: "assistant", content: proactiveIntro });
+    printAgentMessage(proactiveIntro);
     // ── Conversation loop ──────────────────────────────────────────────
     let response = "";
     let streamed = false;
@@ -1436,6 +1702,14 @@ async function chatCommand() {
             }
             continue;
         }
+        const handledLocally = await handleLocalChatIntent({
+            userInput,
+            messages,
+            launchInvestigation,
+            apiKey,
+        });
+        if (handledLocally)
+            continue;
         // ── Detect dragged/pasted file paths ──
         const detectedFile = detectFilePath(userInput);
         if (detectedFile) {