umbrella-context 0.1.2 → 0.1.20

package/dist/commands/interactive.js

@@ -1,96 +1,945 @@
 import chalk from "chalk";
 import prompts from "prompts";
 import { configManager } from "../config.js";
-import { getCompanyContextSummary, toContextSpaces } from "../umbrella.js";
-import { curateCommandAction } from "./curate.js";
-import { pushCommandAction } from "./push.js";
-import { pullCommandAction } from "./pull.js";
+import { ensureSessionState, getConnectorRuns, getInstalledConnectors, getInstalledHubEntries, getPendingMemories, getPulledFixes, getPulledMemories, recordSessionEvent, recordSessionCommand, recordSessionCuration, recordSessionQuery, setSessionPanel, resetSessionState, setSessionSummary, } from "../repo-state.js";
+import { createContextSpace, getCompanyContextSummary, toContextSpaces } from "../umbrella.js";
+import { parseInteractiveInput, renderCommandList, resolveCommand } from "./catalog.js";
 import { searchCommandAction } from "./search.js";
-import { statusCommandAction } from "./status.js";
-export async function interactiveCommand(_args) {
+import { curateCommandAction } from "./curate.js";
+import { spaceCommandAction } from "./space.js";
+import { getProviderReadinessSummary, providersCommandAction } from "./providers.js";
+import { getModelsForActiveProvider, modelCommandAction } from "./model.js";
+import { hubCommandAction } from "./hub.js";
+import { connectorsCommandAction } from "./connectors.js";
+import { getStatusSnapshot } from "./status.js";
+import { debugCommandAction } from "./debug.js";
+import { logoutCommandAction } from "./logout.js";
+import { restartCommandAction } from "./restart.js";
+function divider() {
+    return chalk.gray("----------------------------------------------------------------");
+}
+function labelValue(label, value) {
+    return `  ${chalk.cyan(label.padEnd(18))} ${value}`;
+}
+function printWelcomeHeader(providerLabel, modelLabel) {
+    const timeLabel = new Date().toLocaleTimeString([], { hour: "numeric", minute: "2-digit" });
+    console.log(chalk.cyan("UMBRELLA CONTEXT") + chalk.gray(`  ${timeLabel}`));
+    console.log(divider());
+    console.log(chalk.bold("  Command-first local Context for this repo"));
+    console.log(chalk.gray(`  Runtime: ${providerLabel}${modelLabel ? ` (${modelLabel})` : ""}`));
+    console.log(chalk.gray("  Save to .um first. Push only when you want the team to share it."));
+    console.log(divider());
+    console.log(`  ${chalk.yellow("/home")}         Current repo and sync overview`);
+    console.log(`  ${chalk.yellow("/query")}        Ask Context a question`);
+    console.log(`  ${chalk.yellow("/curate")}       Save a reusable note locally`);
+    console.log(`  ${chalk.yellow("/recent")}       Show recent local activity`);
+    console.log(`  ${chalk.yellow("/timeline")}     Show the recent session event timeline`);
+    console.log(`  ${chalk.yellow("/session")}      Current terminal session summary`);
+    console.log(`  ${chalk.yellow("/panel")}        Show the active panel and focus`);
+    console.log(`  ${chalk.yellow("/continue")}     Re-open the last active panel`);
+    console.log(`  ${chalk.yellow("/status")}       Inspect sync, provider, and MCP state`);
+    console.log(`  ${chalk.yellow("/restart")}      Refresh this live terminal session`);
+    console.log(`  ${chalk.yellow("/debug")}        Show config paths and local runtime details`);
+    console.log(`  ${chalk.yellow("/logout")}       Disconnect this device from Umbrella Context`);
+    console.log(`  ${chalk.yellow("/")}             Full command list`);
+    console.log(divider());
+    console.log(`  ${chalk.gray("Shortcuts:")} type plain text to query, or start with ${chalk.yellow("+")} to curate quickly.`);
+    console.log("");
+}
+async function printRuntimeSnapshot() {
     const config = configManager.config;
-    if (!config) {
-        console.log(chalk.red("Not configured. Run: umbrella-context setup"));
+    if (!config)
+        return;
+    const activeProvider = configManager.providers.find((entry) => entry.id === config.activeProvider) ?? null;
+    const providerLabel = activeProvider ? activeProvider.name : "No provider connected";
+    const modelLabel = config.activeModel ?? "";
+    printWelcomeHeader(providerLabel, modelLabel);
+}
+async function printHomeView(config) {
+    await setSessionPanel("home", config.projectName);
+    const snapshot = await getStatusSnapshot();
+    const pending = await getPendingMemories();
+    const hubEntries = await getInstalledHubEntries();
+    const connectors = await getInstalledConnectors();
+    const connectorRuns = await getConnectorRuns();
+    const session = await ensureSessionState();
+    const latestConnectorRun = connectorRuns[0] ?? null;
+    console.log(chalk.bold(` ${config.companyName} / ${config.projectName}`));
+    console.log(divider());
+    console.log(chalk.bold(" Sync"));
+    console.log(labelValue("Pending drafts", String(snapshot.pendingCount)));
+    console.log(labelValue("Pulled context", String(snapshot.pulledContextCount)));
+    console.log(labelValue("Known fixes", String(snapshot.pulledFixCount)));
+    console.log("");
+    console.log(chalk.bold(" Repo"));
+    console.log(labelValue("Hub installs", String(hubEntries.length)));
+    console.log(labelValue("Connectors", String(connectors.length)));
+    console.log(labelValue("Last connector run", latestConnectorRun ? `${latestConnectorRun.connectorName} (${latestConnectorRun.status})` : "Never"));
+    console.log("");
+    console.log(chalk.bold(" Runtime"));
+    console.log(labelValue("Provider", snapshot.providerLabel));
+    console.log(labelValue("Model", snapshot.modelLabel));
+    console.log(labelValue("Repo MCP", snapshot.mcpConfigured ? "Ready" : "Needs setup"));
+    console.log(labelValue("Current panel", session.currentPanel ?? "Home"));
+    console.log(labelValue("Current focus", session.currentFocus ?? "None"));
+    console.log(labelValue("Latest event", session.events?.[0]?.title ?? "Nothing yet"));
+    console.log("");
+    console.log(chalk.bold(" Suggested next steps"));
+    if (snapshot.nextSteps.length > 0) {
+        snapshot.nextSteps.forEach((step) => console.log(`  - ${step}`));
+    }
+    else if (pending.length > 0) {
+        console.log(`  - ${chalk.yellow("/push")} to share ${pending.length} local draft${pending.length === 1 ? "" : "s"}`);
+    }
+    else {
+        console.log(`  - ${chalk.yellow('/curate "What you learned"')} to stage a new local note`);
+        console.log(`  - ${chalk.yellow("/query What do we already know about this?")} to search local and server memory`);
+    }
+    console.log(`  - ${chalk.yellow("/recent")} to inspect the latest repo activity`);
+    console.log("");
+}
+function printSessionHint(title, lines) {
+    console.log("");
+    console.log(chalk.bold(` ${title}`));
+    lines.forEach((line) => console.log(`  - ${line}`));
+    console.log("");
+}
+function printRecentSection(title, items, render) {
+    console.log(chalk.bold(` ${title}`));
+    if (items.length === 0) {
+        console.log(chalk.gray("  Nothing recent yet."));
+        console.log("");
+        return;
+    }
+    items.forEach((item, index) => {
+        console.log(render(item, index));
+    });
+    console.log("");
+}
+async function printSessionView() {
+    await setSessionPanel("session", "summary");
+    const session = await ensureSessionState();
+    console.log("");
+    console.log(chalk.bold(" Current Session"));
+    console.log(divider());
+    console.log(labelValue("Session ID", session.id));
+    console.log(labelValue("Started", session.startedAt));
+    console.log(labelValue("Updated", session.updatedAt));
+    console.log(labelValue("Commands", String(session.commandHistory.length)));
+    console.log(labelValue("Queries", String(session.recentQueries.length)));
+    console.log(labelValue("Curations", String(session.recentCurations.length)));
+    console.log(labelValue("Last summary", session.lastSummary ?? "Nothing recorded yet"));
+    console.log(labelValue("Current panel", session.currentPanel ?? "None"));
+    console.log(labelValue("Current focus", session.currentFocus ?? "None"));
+    console.log(labelValue("Events", String(session.events?.length ?? 0)));
+    console.log("");
+    if (session.panelHistory.length > 0) {
+        console.log(chalk.bold(" Panel history"));
+        session.panelHistory.slice(0, 5).forEach((entry, index) => console.log(`  ${index + 1}. ${entry}`));
+        console.log("");
+    }
+    if (session.recentQueries.length > 0) {
+        console.log(chalk.bold(" Recent Queries"));
+        session.recentQueries.slice(0, 3).forEach((entry, index) => console.log(`  ${index + 1}. ${entry}`));
+        console.log("");
+    }
+    if (session.recentCurations.length > 0) {
+        console.log(chalk.bold(" Recent Curations"));
+        session.recentCurations.slice(0, 3).forEach((entry, index) => console.log(`  ${index + 1}. ${entry}`));
+        console.log("");
+    }
+    if (session.recentProviderIds.length > 0 || session.recentModels.length > 0) {
+        console.log(chalk.bold(" Runtime recents"));
+        if (session.recentProviderIds.length > 0) {
+            const names = session.recentProviderIds
+                .map((id) => configManager.providers.find((entry) => entry.id === id)?.name ?? id)
+                .join(", ");
+            console.log(`  Providers: ${names}`);
+        }
+        if (session.recentModels.length > 0) {
+            console.log(`  Models: ${session.recentModels.join(", ")}`);
+        }
+        console.log("");
+    }
+    if (session.recentHubSlugs.length > 0 || session.recentConnectorSources.length > 0) {
+        console.log(chalk.bold(" Ecosystem recents"));
+        if (session.recentHubSlugs.length > 0) {
+            console.log(`  Hub: ${session.recentHubSlugs.join(", ")}`);
+        }
+        if (session.recentConnectorSources.length > 0) {
+            console.log(`  Connectors: ${session.recentConnectorSources.join(", ")}`);
+        }
+        console.log("");
+    }
+    if ((session.events?.length ?? 0) > 0) {
+        console.log(chalk.bold(" Recent timeline"));
+        session.events.slice(0, 5).forEach((entry, index) => {
+            console.log(`  ${index + 1}. [${entry.kind}] ${entry.title}`);
+            if (entry.detail) {
+                console.log(chalk.gray(`     ${entry.detail}`));
+            }
+        });
+        console.log("");
+    }
+}
+async function printProviderOverview() {
+    const readiness = getProviderReadinessSummary();
+    const providerCount = configManager.providers.length;
+    console.log("");
+    console.log(chalk.bold(" Provider Runtime"));
+    console.log(divider());
+    console.log(labelValue("Connected", String(providerCount)));
+    console.log(labelValue("Active provider", readiness.activeProvider?.name ?? "Not connected"));
+    console.log(labelValue("Active model", readiness.activeModel ?? "Not selected"));
+    console.log(labelValue("Runtime state", !readiness.providerReady
+        ? "Needs provider"
+        : !readiness.modelReady
+            ? "Needs model"
+            : "Ready"));
+    console.log("");
+}
+async function printModelOverview() {
+    const readiness = getProviderReadinessSummary();
+    const models = getModelsForActiveProvider();
+    console.log("");
+    console.log(chalk.bold(" Model Runtime"));
+    console.log(divider());
+    console.log(labelValue("Provider", readiness.activeProvider?.name ?? "Not connected"));
+    console.log(labelValue("Active model", readiness.activeModel ?? "Not selected"));
+    console.log(labelValue("Available models", String(models.length)));
+    if (models.length > 0) {
+        console.log("");
+        console.log(chalk.bold(" Available Models"));
+        models.forEach((model, index) => {
+            const active = readiness.activeModel === model ? " (active)" : "";
+            console.log(`  ${index + 1}. ${model}${active}`);
+        });
+        console.log("");
+    }
+}
+async function printHubOverview() {
+    const installed = await getInstalledHubEntries();
+    console.log("");
+    console.log(chalk.bold(" Hub Overview"));
+    console.log(divider());
+    console.log(labelValue("Catalog entries", "3"));
+    console.log(labelValue("Installed", String(installed.length)));
+    if (installed.length > 0) {
+        console.log("");
+        console.log(chalk.bold(" Installed Bundles"));
+        installed.slice(0, 5).forEach((entry, index) => {
+            console.log(`  ${index + 1}. ${entry.name} [${entry.type}]`);
+        });
+        console.log("");
+    }
+}
+async function printConnectorOverview() {
+    const connectors = await getInstalledConnectors();
+    const connectorRuns = await getConnectorRuns();
+    const latest = connectorRuns[0] ?? null;
+    console.log("");
+    console.log(chalk.bold(" Connector Overview"));
+    console.log(divider());
+    console.log(labelValue("Installed", String(connectors.length)));
+    console.log(labelValue("Last run", latest ? `${latest.connectorName} (${latest.status})` : "Never"));
+    if (connectors.length > 0) {
+        console.log("");
+        console.log(chalk.bold(" Installed Connectors"));
+        connectors.forEach((entry, index) => {
+            console.log(`  ${index + 1}. ${entry.name} [${entry.type}]`);
+        });
+        console.log("");
+    }
+}
+async function printCurrentPanelView() {
+    const session = await ensureSessionState();
+    const latestPanelEvent = (session.events ?? []).find((entry) => entry.panel === session.currentPanel);
+    console.log("");
+    console.log(chalk.bold(" Live Panel"));
+    console.log(divider());
+    console.log(labelValue("Panel", session.currentPanel ?? "None"));
+    console.log(labelValue("Focus", session.currentFocus ?? "None"));
+    console.log(labelValue("Last panel event", latestPanelEvent?.title ?? "Nothing panel-specific yet"));
+    if (session.panelHistory.length > 0) {
+        console.log("");
+        console.log(chalk.bold(" Recent panels"));
+        session.panelHistory.slice(0, 5).forEach((entry, index) => console.log(`  ${index + 1}. ${entry}`));
+    }
+    console.log("");
+}
+async function printTimelineView() {
+    await setSessionPanel("timeline", "events");
+    const session = await ensureSessionState();
+    console.log("");
+    console.log(chalk.bold(" Session Timeline"));
+    console.log(divider());
+    if ((session.events?.length ?? 0) === 0) {
+        console.log(chalk.gray("  No session events yet."));
+        console.log("");
+        return;
+    }
+    session.events.slice(0, 12).forEach((entry, index) => {
+        const badge = entry.status === "success" ? chalk.green(`[${entry.kind}]`)
+            : entry.status === "warning" ? chalk.yellow(`[${entry.kind}]`)
+                : entry.status === "failure" ? chalk.red(`[${entry.kind}]`)
+                    : chalk.cyan(`[${entry.kind}]`);
+        const focusSuffix = entry.focus ? ` -> ${entry.focus}` : "";
+        console.log(`  ${index + 1}. ${badge} ${entry.title}${focusSuffix}`);
+        console.log(chalk.gray(`     ${new Date(entry.at).toLocaleString()}`));
+        if (entry.detail) {
+            console.log(chalk.gray(`     ${entry.detail}`));
+        }
+    });
+    console.log("");
+}
+async function continueLastPanel(config) {
+    const session = await ensureSessionState();
+    const panel = session.currentPanel;
+    const focus = session.currentFocus ?? undefined;
+    if (!panel) {
+        console.log(chalk.yellow("\n No current panel to continue yet."));
+        return;
+    }
+    if (panel === "home") {
+        await printHomeView(config);
+        return;
+    }
+    if (panel === "providers") {
+        if (focus) {
+            await providersCommandAction("inspect", focus);
+            return;
+        }
+        await openProvidersMenu();
+        return;
+    }
+    if (panel === "model") {
+        if (focus) {
+            await modelCommandAction("inspect", focus);
+            return;
+        }
+        await openModelMenu();
         return;
     }
-    console.log(chalk.bold(`\n Umbrella Context - ${config.companyName} / ${config.projectName}\n`));
-    console.log(chalk.gray(" Commands: curate, query, push, pull, fix, record, spaces, status, exit\n"));
+    if (panel === "hub") {
+        if (focus && !focus.startsWith("registry:") && focus !== "list" && focus !== "installed") {
+            await hubCommandAction("inspect", focus);
+            return;
+        }
+        if (focus?.startsWith("registry:")) {
+            await hubCommandAction("registry", "list");
+            return;
+        }
+        await openHubMenu();
+        return;
+    }
+    if (panel === "connectors") {
+        if (focus && focus !== "list") {
+            await connectorsCommandAction("inspect", focus);
+            return;
+        }
+        await openConnectorsMenu();
+        return;
+    }
+    if (panel === "space" || panel === "spaces" || panel === "projects") {
+        await openSpaceMenu(config);
+        return;
+    }
+    if (panel === "session") {
+        await printSessionView();
+        return;
+    }
+    if (panel === "recent") {
+        await handleRecent(config);
+        return;
+    }
+    if (panel === "timeline") {
+        await printTimelineView();
+        return;
+    }
+    if (panel === "status") {
+        await import("./status.js").then((mod) => mod.statusCommandAction());
+        return;
+    }
+    console.log(chalk.yellow(`\n No resume handler yet for panel "${panel}".`));
+}
+async function openSpaceMenu(config) {
     while (true) {
-        const input = await prompts({
-            type: "text",
+        await setSessionPanel("space", config.projectName);
+        const summary = await getCompanyContextSummary(config.umbrellaUrl, config.companyId);
+        const spaces = toContextSpaces(summary);
+        const answer = await prompts({
+            type: "select",
             name: "value",
-            message: ">",
+            message: `Context spaces for ${config.companyName}`,
+            choices: [
+                { title: "Overview", description: "See the current company and space summary", value: "overview" },
+                { title: "List spaces", description: "Show all spaces for this company", value: "list" },
+                { title: "Switch space", description: "Move this repo to another space", value: "switch" },
+                { title: "Create space", description: "Add a new team lane like Growth or Engineering", value: "create" },
+                { title: "Back", value: "back" },
+            ],
         });
-        if (!input.value)
+        if (!answer.value || answer.value === "back")
+            return;
+        if (answer.value === "overview") {
+            await handleSpaces(config);
+            continue;
+        }
+        if (answer.value === "list") {
+            await spaceCommandAction("list");
             continue;
-        const parts = input.value.trim().split(/\s+/);
-        const cmd = parts[0].toLowerCase();
-        const rest = parts.slice(1).join(" ");
-        if (cmd === "exit" || cmd === "quit")
-            break;
-        if (cmd === "curate") {
-            await curateCommandAction(rest);
         }
-        else if (cmd === "push") {
-            await pushCommandAction();
+        if (answer.value === "switch") {
+            if (spaces.length === 0) {
+                console.log(chalk.yellow("\n No spaces found for this company."));
+                continue;
+            }
+            await spaceCommandAction("switch");
+            continue;
+        }
+        if (answer.value === "create") {
+            const createAnswer = await prompts({
+                type: "text",
+                name: "name",
+                message: "Name the new context space",
+                validate: (value) => (value.trim().length > 1 ? true : "Use at least 2 characters."),
+            });
+            const nextName = String(createAnswer.name ?? "").trim();
+            if (!nextName) {
+                console.log(chalk.yellow("\n No space name provided."));
+                continue;
+            }
+            await createContextSpace(config.umbrellaUrl, config.companyId, nextName);
+            await recordSessionEvent({
+                kind: "space",
+                title: `Created space ${nextName}`,
+                detail: `A new Context space was created inside ${config.companyName}.`,
+                panel: "space",
+                focus: nextName,
+                status: "success",
+            });
+            console.log(chalk.green(`\n Created ${nextName}.`));
+            const switchNow = await prompts({
+                type: "confirm",
+                name: "value",
+                message: `Switch this repo to ${nextName} now?`,
+                initial: true,
+            });
+            if (switchNow.value) {
+                await spaceCommandAction("switch", nextName);
+            }
+            continue;
         }
-        else if (cmd === "pull") {
-            await pullCommandAction();
+    }
+}
+async function openProvidersMenu() {
+    while (true) {
+        const readiness = getProviderReadinessSummary();
+        const activeProvider = readiness.activeProvider;
+        await setSessionPanel("providers", activeProvider?.id ?? null);
+        const answer = await prompts({
+            type: "select",
+            name: "value",
+            message: activeProvider ? `Provider flow (active: ${activeProvider.name})` : "Provider flow",
+            choices: [
+                { title: "Overview", description: "See provider runtime readiness for this device", value: "overview" },
+                { title: "List providers", description: "See providers already saved on this device", value: "list" },
+                { title: "Inspect provider", description: "Read the details and next steps for one provider", value: "inspect" },
+                { title: "Inspect recent provider", description: "Open the provider you touched most recently", value: "recent" },
+                { title: "Test runtime", description: "Check whether the active provider is actually ready to run", value: "test" },
+                { title: "Connect provider", description: "Add a new provider API key on this device", value: "connect" },
+                { title: "Switch provider", description: "Choose the active provider", value: "switch" },
+                { title: "Disconnect provider", description: "Remove a saved provider from this device", value: "disconnect" },
+                { title: "Choose model", description: "Pick the active model for the current provider", value: "model" },
+                { title: "Back", value: "back" },
+            ],
+        });
+        if (!answer.value || answer.value === "back")
+            return;
+        if (answer.value === "overview") {
+            await printProviderOverview();
+            continue;
         }
-        else if (cmd === "search" || cmd === "query") {
-            await searchCommandAction(rest);
+        if (answer.value === "model") {
+            await openModelMenu();
+            continue;
         }
-        else if (cmd === "fix") {
-            await handleFix(rest, config);
+        const result = await providersCommandAction(answer.value);
+        if (result?.activeProvider) {
+            const lines = [`Active provider: ${result.activeProvider.name}`];
+            if (result.activeProvider.baseUrl) {
+                lines.push(`Base URL: ${result.activeProvider.baseUrl}`);
+            }
+            lines.push(result.needsModelSelection
+                ? "No model is selected yet, so the runtime is only partially ready."
+                : "Provider and model are both ready for terminal work.");
+            printSessionHint("Provider Session Summary", lines);
         }
-        else if (cmd === "record") {
-            await handleRecord(parts.slice(1), config);
+        if ((answer.value === "connect" || answer.value === "switch") && result?.needsModelSelection) {
+            const chooseModel = await prompts({
+                type: "confirm",
+                name: "value",
+                message: "Choose a model now?",
+                initial: true,
+            });
+            if (chooseModel.value) {
+                const modelResult = await modelCommandAction("switch");
+                if (modelResult?.activeModel) {
+                    printSessionHint("Runtime Ready", [
+                        `Provider: ${modelResult.providerName ?? "Unknown"}`,
+                        `Model: ${modelResult.activeModel}`,
+                        'You can now type a plain question or use "/query ..." directly.',
+                    ]);
+                }
+            }
         }
-        else if (cmd === "projects" || cmd === "spaces") {
-            await handleSpaces(config);
+    }
+}
+async function openModelMenu() {
+    while (true) {
+        const currentConfig = configManager.config;
+        const provider = configManager.providers.find((entry) => entry.id === currentConfig?.activeProvider) ?? null;
+        const models = getModelsForActiveProvider();
+        await setSessionPanel("model", currentConfig?.activeModel ?? provider?.id ?? null);
+        const answer = await prompts({
+            type: "select",
+            name: "value",
+            message: provider ? `Model flow (${provider.name})` : "Model flow",
+            choices: [
+                { title: "Overview", description: "See active provider, model, and available choices", value: "overview" },
+                { title: "List models", description: `See models for the active provider (${models.length})`, value: "list" },
+                { title: "Inspect model", description: "Read details and the next step for a specific model", value: "inspect" },
+                { title: "Inspect recent model", description: "Open the model you touched most recently", value: "recent" },
+                { title: "Show readiness", description: "Check whether the model runtime is fully ready", value: "ready" },
+                { title: "Switch model", description: "Choose the active model", value: "switch" },
+                { title: "Back", value: "back" },
+            ],
+        });
+        if (!answer.value || answer.value === "back")
+            return;
+        if (answer.value === "overview") {
+            await printModelOverview();
+            continue;
+        }
+        const result = await modelCommandAction(answer.value);
+        if (result?.action === "switch" && result.activeModel) {
+            printSessionHint("Model Session Summary", [
+                `Provider: ${result.providerName ?? "Unknown"}`,
+                `Active model: ${result.activeModel}`,
+                'The runtime is ready. Try a plain question or run "/query ...".',
+            ]);
+        }
+    }
+}
+async function openHubMenu() {
+    while (true) {
+        const session = await ensureSessionState();
+        await setSessionPanel("hub", session.currentFocus);
+        const answer = await prompts({
+            type: "select",
+            name: "value",
+            message: "Hub flow",
+            choices: [
+                { title: "Overview", description: "See installed bundles and the local hub state", value: "overview" },
+                { title: "Browse catalog", description: "See available bundles, skills, and connector packs", value: "list" },
+                { title: "Install hub entry", description: "Install a bundle into this repo", value: "install" },
+                { title: "Inspect bundle", description: "Pick a hub entry and read what it includes", value: "inspect" },
+                { title: "Inspect recent bundle", description: "Open the last hub entry you touched in this session", value: "recent" },
+                { title: "Installed hub entries", description: "See what this repo already has", value: "installed" },
+                { title: "Registries", description: "See configured hub registries", value: "registry" },
+                { title: "Back", value: "back" },
+            ],
+        });
+        if (!answer.value || answer.value === "back")
+            return;
+        if (answer.value === "overview") {
+            await printHubOverview();
+            continue;
+        }
+        if (answer.value === "registry") {
+            await hubCommandAction("registry", "list");
+            continue;
+        }
+        if (answer.value === "recent") {
+            const recent = session.recentHubSlugs[0];
+            if (!recent) {
+                console.log(chalk.yellow("\n No recent hub entry in this session yet."));
+                continue;
+            }
+            await hubCommandAction("inspect", recent);
+            continue;
+        }
+        if (answer.value === "inspect") {
+            const inspectAnswer = await prompts({
+                type: "select",
+                name: "value",
+                message: "Choose a hub entry to inspect",
+                choices: [
+                    { title: "Quick Ping Growth Bundle", value: "quick-ping-growth-bundle" },
+                    { title: "Engineering Debug Skill Pack", value: "engineering-debug-skill-pack" },
+                    { title: "Umbrella Context MCP Connector", value: "umbrella-context-mcp-connector" },
+                ],
+            });
+            if (!inspectAnswer.value) {
+                console.log(chalk.yellow("\n No hub entry selected."));
+                continue;
+            }
+            await hubCommandAction("inspect", inspectAnswer.value);
+            continue;
+        }
+        const result = await hubCommandAction(answer.value);
+        if (result?.action === "install" && result.installedEntry) {
+            const lines = [`Installed: ${result.installedEntry.name}`];
+            if (result.assetPath)
+                lines.push(`Asset file: ${result.assetPath}`);
+            if (result.filePaths && result.filePaths.length > 0) {
+                lines.push(`${result.filePaths.length} repo file${result.filePaths.length === 1 ? "" : "s"} added or refreshed`);
+            }
+            if (result.recommendedConnector) {
+                lines.push(`Recommended connector: ${result.recommendedConnector}`);
+            }
+            printSessionHint("Hub Install Summary", lines);
+            const next = await prompts({
+                type: "confirm",
+                name: "value",
+                message: "Open connectors now to run anything that bundle installed?",
+                initial: true,
+            });
+            if (next.value) {
+                await openConnectorsMenu();
+            }
+        }
+    }
+}
+async function openConnectorsMenu() {
+    while (true) {
+        const session = await ensureSessionState();
+        await setSessionPanel("connectors", session.currentFocus);
+        const answer = await prompts({
+            type: "select",
+            name: "value",
+            message: "Connector flow",
+            choices: [
+                { title: "Overview", description: "See installed connectors and the latest run state", value: "overview" },
+                { title: "List connectors", description: "See repo connectors already installed", value: "list" },
+                { title: "Inspect connector", description: "Read connector details and recommended next steps", value: "inspect" },
+                { title: "Inspect recent connector", description: "Open the connector you touched most recently", value: "recent" },
+                { title: "View outputs", description: "See connector-written files and the latest run summary", value: "outputs" },
+                { title: "Install connector", description: "Add a connector into this repo", value: "install" },
+                { title: "Run connector", description: "Execute a connector inside this repo", value: "run" },
+                { title: "Back", value: "back" },
+            ],
+        });
+        if (!answer.value || answer.value === "back")
+            return;
+        if (answer.value === "overview") {
+            await printConnectorOverview();
+            continue;
         }
-        else if (cmd === "status") {
-            await statusCommandAction();
+        let target;
+        if (answer.value === "run" || answer.value === "inspect" || answer.value === "outputs") {
+            const installed = await getInstalledConnectors();
+            if (installed.length === 0) {
+                console.log(chalk.yellow("\n No connectors installed in this repo yet."));
+                continue;
+            }
+            const runAnswer = await prompts({
+                type: "select",
+                name: "value",
+                message: answer.value === "outputs" ? "Choose a connector to inspect outputs for" : "Choose a connector to run",
+                choices: installed.map((entry) => ({
+                    title: `${entry.name} (${entry.type})`,
+                    value: entry.source,
+                })),
+            });
+            target = runAnswer.value;
+            if (!target) {
+                console.log(chalk.yellow("\n No connector selected."));
+                continue;
+            }
         }
-        else if (cmd === "help") {
-            console.log(chalk.gray(`
-  curate <content>   Save a local context note into .um
-  query <query>      Search local and server context
-  push               Sync local .um notes to the server
-  pull               Refresh the local snapshot from the server
-  fix <error>        Search known fixes
-  record <id> <outcome>  Record success/failure
-  spaces             Show the current company and active space
-  status             Show current sync status
-  exit               Quit
-`));
+        const result = await connectorsCommandAction(answer.value, target);
+        if (result?.action === "install" && result.connectorName) {
+            const lines = [`Connector: ${result.connectorName}`];
+            if (result.repoConfigPath)
+                lines.push(`Repo MCP wiring: ${result.repoConfigPath}`);
+            if (result.filePaths && result.filePaths.length > 0) {
+                lines.push(`${result.filePaths.length} connector file${result.filePaths.length === 1 ? "" : "s"} added or refreshed`);
+            }
+            lines.push('Running the connector will verify repo wiring and save a local run report in ".um".');
+            printSessionHint("Connector Install Summary", lines);
+            const runNow = await prompts({
+                type: "confirm",
+                name: "value",
+                message: "Run a connector now?",
+                initial: true,
+            });
+            if (runNow.value) {
+                const runResult = await connectorsCommandAction("run");
+                if (runResult?.connectorName) {
+                    const lines = [
+                        `Connector: ${runResult.connectorName}`,
+                        `Status: ${runResult.status ?? "unknown"}`,
+                    ];
+                    if (runResult.summary)
+                        lines.push(runResult.summary);
+                    if (runResult.stagedMemoryId)
+                        lines.push(`Staged local draft: ${runResult.stagedMemoryId}`);
+                    if (runResult.reportPath)
+                        lines.push(`Run report: ${runResult.reportPath}`);
+                    if (runResult.status === "success")
+                        lines.push('Next move: run "/status" to review the updated repo state.');
+                    printSessionHint("Connector Run Summary", lines);
+                }
+            }
         }
-        else {
-            console.log(chalk.yellow(`Unknown command: ${cmd}. Type 'help' for commands.`));
+        else if (result?.action === "run" && result.connectorName) {
+            const lines = [
+                `Connector: ${result.connectorName}`,
+                `Status: ${result.status ?? "unknown"}`,
+            ];
+            if (result.summary)
+                lines.push(result.summary);
+            if (result.stagedMemoryId)
+                lines.push(`Staged local draft: ${result.stagedMemoryId}`);
+            if (result.reportPath)
+                lines.push(`Run report: ${result.reportPath}`);
+            printSessionHint("Connector Run Summary", lines);
         }
     }
 }
+async function maybeHandleNativeMenu(command, args, config) {
+    if (args.length > 0)
+        return false;
+    if (command === "space" || command === "spaces" || command === "projects") {
+        await openSpaceMenu(config);
+        return true;
+    }
+    if (command === "providers") {
+        await openProvidersMenu();
+        return true;
+    }
+    if (command === "model") {
+        await openModelMenu();
+        return true;
+    }
+    if (command === "hub") {
+        await openHubMenu();
+        return true;
+    }
+    if (command === "connectors") {
+        await openConnectorsMenu();
+        return true;
+    }
+    return false;
+}
+export async function interactiveCommand(_args) {
+    if (!configManager.config) {
+        console.log(chalk.red("Not configured. Run: umbrella-context setup"));
+        return;
+    }
+    const commandHistory = [];
+    await ensureSessionState();
+    await setSessionPanel("home", configManager.config.projectName);
+    await printRuntimeSnapshot();
+    await printHomeView(configManager.config);
+    console.log(chalk.gray(" Type / to see commands. Use plain text to query or start with + to curate.\n"));
+    while (true) {
+        const currentConfig = configManager.config;
+        if (!currentConfig) {
+            console.log(chalk.red("Config was cleared. Run umbrella-context setup again."));
+            break;
+        }
+        const input = await prompts({
+            type: "text",
+            name: "value",
+            message: chalk.cyan(`${currentConfig.companyName.toLowerCase().replace(/\s+/g, "-")}:${currentConfig.projectName.toLowerCase()}`),
+            initial: "/",
+        });
+        if (typeof input.value !== "string")
+            break;
+        const raw = input.value.trim();
+        if (!raw)
+            continue;
+        if (raw === "/" || raw === "help" || raw === "/help") {
+            console.log(chalk.gray(`\n${renderCommandList()}\n`));
+            continue;
+        }
+        if (raw === "exit" || raw === "/exit" || raw === "quit" || raw === "/quit") {
+            break;
+        }
+        if (raw.startsWith("+")) {
+            const content = raw.slice(1).trim();
+            if (!content) {
+                console.log(chalk.yellow("Use + followed by what you learned, for example +We learned the CTA must name the next step."));
+                continue;
+            }
+            commandHistory.push(`/curate ${content}`);
+            await recordSessionCommand(`/curate ${content}`);
+            await recordSessionCuration(content);
+            await setSessionSummary(`Curated a new local note: ${content.length > 48 ? `${content.slice(0, 48)}...` : content}`);
+            try {
+                await curateCommandAction(content);
+            }
+            catch (err) {
+                console.log(chalk.red(`Command failed: ${err.message}`));
+            }
+            continue;
+        }
+        const { command, args } = parseInteractiveInput(raw);
+        const spec = resolveCommand(command);
+        if (!raw.startsWith("/") && !spec) {
+            commandHistory.push(`/query ${raw}`);
+            await recordSessionCommand(`/query ${raw}`);
+            await recordSessionQuery(raw);
+            await setSessionSummary(`Queried Context: ${raw.length > 48 ? `${raw.slice(0, 48)}...` : raw}`);
+            try {
+                await searchCommandAction(raw);
+            }
+            catch (err) {
+                console.log(chalk.red(`Command failed: ${err.message}`));
+            }
+            continue;
+        }
+        if (!spec) {
+            console.log(chalk.yellow(`Unknown command: ${raw}. Type / to see available commands.`));
+            continue;
+        }
+        commandHistory.push(raw.startsWith("/") ? raw : `/${command} ${args.join(" ")}`.trim());
+        await recordSessionCommand(raw.startsWith("/") ? raw : `/${command} ${args.join(" ")}`.trim());
+        try {
+            const handledByMenu = await maybeHandleNativeMenu(command, args, currentConfig);
+            if (handledByMenu) {
+                continue;
+            }
+            await spec.action(args, {
+                config: currentConfig,
+                handleFix,
+                handleRecord,
+                handleSpaces,
+                handleHome: async (config) => printHomeView(config),
+                handleRecent,
+                handleTimeline: async () => printTimelineView(),
+                handleHistory: async () => printHistory(commandHistory),
+                handleSession: async () => printSessionView(),
+                handleNewSession: async () => {
+                    const next = await resetSessionState();
+                    commandHistory.length = 0;
+                    await recordSessionEvent({
+                        kind: "session",
+                        title: "Started a fresh shell session",
+                        detail: `Session ID: ${next.id}`,
+                        panel: "session",
+                        focus: next.id,
+                        status: "info",
+                    });
+                    printSessionHint("Fresh Session Started", [
+                        `Session ID: ${next.id}`,
+                        "Your repo context and .um data were kept.",
+                        "Your command history for this shell was reset.",
+                    ]);
+                },
+                handleRestart: async () => {
+                    await restartCommandAction();
+                    commandHistory.length = 0;
+                },
+                handleDebug: async () => {
+                    await debugCommandAction();
+                },
+                handleLogout: async () => {
+                    await logoutCommandAction();
+                    commandHistory.length = 0;
+                },
+                handlePanel: async () => {
+                    await printCurrentPanelView();
+                },
+                handleContinue: async () => {
+                    await continueLastPanel(currentConfig);
+                },
+            });
+        }
+        catch (err) {
+            console.log(chalk.red(`Command failed: ${err.message}`));
+        }
+    }
+}
+async function handleRecent(_config) {
+    await setSessionPanel("recent", "activity");
+    const pending = await getPendingMemories();
+    const pulled = await getPulledMemories();
+    const runs = await getConnectorRuns();
+    const session = await ensureSessionState();
+    console.log("");
+    printRecentSection("Recent session queries", session.recentQueries.slice(0, 3), (item, index) => {
+        return `  ${index + 1}. ${item}`;
+    });
+    printRecentSection("Recent session curations", session.recentCurations.slice(0, 3), (item, index) => {
+        return `  ${index + 1}. ${item}`;
+    });
+    printRecentSection("Recent local drafts", pending.slice(-3).reverse(), (item, index) => {
+        const preview = item.content.length > 72 ? `${item.content.slice(0, 72)}...` : item.content;
+        return `  ${index + 1}. ${preview} ${chalk.gray(`[${item.source}]`)}`;
+    });
+    printRecentSection("Recent pulled context", pulled.slice(-3).reverse(), (item, index) => {
+        const preview = item.content.length > 72 ? `${item.content.slice(0, 72)}...` : item.content;
+        return `  ${index + 1}. ${preview}`;
+    });
+    printRecentSection("Recent connector runs", runs.slice(0, 3), (item, index) => {
+        return `  ${index + 1}. ${item.connectorName} ${chalk.gray(`(${item.status})`)} - ${item.summary}`;
+    });
+}
+async function printHistory(commandHistory) {
+    const session = await ensureSessionState();
+    console.log("");
+    console.log(chalk.bold(" Session command history"));
+    const history = session.commandHistory.length > 0 ? session.commandHistory : commandHistory;
+    if (history.length === 0) {
+        console.log(chalk.gray("  No commands yet."));
+        console.log("");
+        return;
+    }
+    history.slice(-10).forEach((entry, index) => {
+        console.log(`  ${index + 1}. ${entry}`);
+    });
+    console.log("");
+}
 async function handleFix(error, config) {
     if (!error) {
-        console.log(chalk.red("Usage: fix <error>"));
+        console.log(chalk.red("Usage: /fix <error>"));
         return;
     }
     try {
+        const localFixes = await getPulledFixes();
+        const localMatches = localFixes.filter((entry) => [entry.errorSignal, entry.solution].join(" ").toLowerCase().includes(error.toLowerCase()));
+        if (localMatches.length > 0) {
+            console.log(chalk.cyan("\n Local cached fixes\n"));
+            localMatches.forEach((result, index) => {
+                const pct = Math.round(result.confidence * 100);
+                console.log(chalk.cyan(`  ${index + 1}. [${pct}%] ${result.errorSignal}`));
+                console.log(`     ${result.solution}`);
+            });
+            console.log("");
+        }
         const res = await fetch(`${config.serverUrl}/api/evolutions/search?error=${encodeURIComponent(error)}`, { headers: { Authorization: `Bearer ${config.apiKey}` } });
-        if (!res.ok)
+        if (!res.ok) {
+            console.log(chalk.red("Server search failed."));
             return;
+        }
         const data = await res.json();
-        if (data.results.length === 0) {
+        if (data.results.length === 0 && localMatches.length === 0) {
             console.log(chalk.yellow("No known fixes"));
             return;
         }
-        data.results.forEach((result, index) => {
-            const pct = Math.round(result.confidence * 100);
-            console.log(chalk.cyan(`  ${index + 1}. [${pct}%]`));
-            console.log(`     ${result.solution}`);
-            console.log(chalk.gray(`     ${result.timesSucceeded}/${result.timesApplied} successes | ID: ${result.id}`));
-            console.log("");
-        });
+        if (data.results.length > 0) {
+            console.log(chalk.cyan(" Server results\n"));
+            data.results.forEach((result, index) => {
+                const pct = Math.round(result.confidence * 100);
+                console.log(chalk.cyan(`  ${index + 1}. [${pct}%]`));
+                console.log(`     ${result.solution}`);
+                console.log(chalk.gray(`     ${result.timesSucceeded}/${result.timesApplied} successes | ID: ${result.id}`));
+                console.log("");
+            });
+        }
     }
     catch (err) {
         console.log(chalk.red(`Error: ${err.message}`));
@@ -99,7 +948,7 @@ async function handleFix(error, config) {
 async function handleRecord(parts, config) {
     const [id, outcome] = parts;
     if (!id || !["success", "failure"].includes(outcome)) {
-        console.log(chalk.red("Usage: record <id> <success|failure>"));
+        console.log(chalk.red("Usage: /record <id> <success|failure>"));
         return;
     }
     try {
@@ -111,8 +960,10 @@ async function handleRecord(parts, config) {
             },
             body: JSON.stringify({ outcome }),
         });
-        if (!res.ok)
+        if (!res.ok) {
+            console.log(chalk.red("Could not record the fix outcome."));
             return;
+        }
         const data = await res.json();
         const pct = Math.round(data.confidence * 100);
         console.log(chalk.green(`Recorded ${outcome} - confidence: ${pct}%`));
@@ -122,8 +973,12 @@ async function handleRecord(parts, config) {
     }
 }
 async function handleSpaces(config) {
+    const pending = await getPendingMemories();
+    const pulled = await getPulledMemories();
     console.log(chalk.cyan(`  Current company: ${config.companyName}`));
     console.log(chalk.cyan(`  Current space: ${config.projectName}`));
+    console.log(chalk.gray(`  Local context notes waiting to push: ${pending.length}`));
+    console.log(chalk.gray(`  Local pulled snapshot size: ${pulled.length}`));
     if (!config.umbrellaUrl) {
         console.log(chalk.gray("  Run setup again if you want this terminal to list all company spaces."));
         return;
@@ -137,9 +992,10 @@ async function handleSpaces(config) {
             const core = space.isPrimary ? " [core]" : "";
             console.log(chalk.gray(`  ${index + 1}. ${space.name}${core}${active}`));
         });
-        console.log(chalk.gray('\n  To switch spaces, run "umbrella-context space switch".'));
+        console.log(chalk.gray('\n  Run "/space switch" to move this repo to another space.'));
     }
     catch (err) {
         console.log(chalk.red(`  Could not load spaces: ${err.message}`));
     }
 }
+export { renderCommandList };