umbrella-context 0.1.36 → 0.1.38

package/README.md

@@ -8,10 +8,23 @@ Use this CLI to connect a laptop or IDE to an Umbrella company context space.
 npm install -g umbrella-context
 ```
 
-For local testing from a tarball:
+Or install it inside the current project:
 
 ```bash
-npm install -g ./umbrella-context-0.1.1.tgz
+npm i umbrella-context
+```
+
+For local testing from a tarball built from this repo:
+
+```bash
+pnpm pack:umbrella-context:local
+npm install -g ./.artifacts/umbrella-context-local/umbrella-context-<version>.tgz
+```
+
+If you want to pack it and launch the packed copy immediately without publishing:
+
+```bash
+pnpm run:umbrella-context:local
 ```
 
 ## First-time setup
@@ -20,6 +33,12 @@ npm install -g ./umbrella-context-0.1.1.tgz
 umbrella-context setup
 ```
 
+If you installed it locally instead of globally:
+
+```bash
+npx umbrella-context setup
+```
+
 The setup flow will:
 - connect to your Umbrella server
 - sign you in when needed
@@ -33,9 +52,12 @@ The setup flow will:
 ```bash
 umbrella-context query "What do we already know?"
 umbrella-context curate "We learned that..."
+umbrella-context push
+umbrella-context pull
 umbrella-context fix "ETIMEDOUT"
 umbrella-context mcp
 umbrella-context
 ```
 
 The old `agent-memory` command still works as a compatibility alias.
+The short `um` command works too.

package/dist/adapters/byterover-context-runtime-store.d.ts

@@ -1,15 +1,34 @@
-import { type VendorBridgeRuntimeSnapshot } from "./byterover-runtime-bridge.js";
-export declare const useUmbrellaContextRuntimeBridgeStore: any;
+import { type VendorBridgeConnectorsState, type VendorBridgeContextTreeState, type VendorBridgeHubState, type VendorBridgeModelState, type VendorBridgeProviderState, type VendorBridgeRuntimeSnapshot, type VendorBridgeSpaceState } from "./byterover-runtime-bridge.js";
+type UmbrellaContextRuntimeBridgeState = {
+    company: VendorBridgeRuntimeSnapshot["company"];
+    connectorsStore: VendorBridgeConnectorsState | null;
+    generatedAt: string | null;
+    hubStore: VendorBridgeHubState | null;
+    isHydrated: boolean;
+    modelStore: VendorBridgeModelState | null;
+    providerStore: VendorBridgeProviderState | null;
+    repo: VendorBridgeRuntimeSnapshot["repo"] | null;
+    services: VendorBridgeRuntimeSnapshot["services"] | null;
+    space: VendorBridgeRuntimeSnapshot["space"];
+    spaceStore: VendorBridgeSpaceState | null;
+    treeStore: VendorBridgeContextTreeState | null;
+};
+type UmbrellaContextRuntimeBridgeActions = {
+    hydrateFromSnapshot: (snapshot: VendorBridgeRuntimeSnapshot) => void;
+    reset: () => void;
+};
+export declare const useUmbrellaContextRuntimeBridgeStore: import("zustand").UseBoundStore<import("zustand").StoreApi<UmbrellaContextRuntimeBridgeActions & UmbrellaContextRuntimeBridgeState>>;
 export declare function hydrateUmbrellaContextRuntimeBridgeFromSnapshot(snapshot: VendorBridgeRuntimeSnapshot): void;
 export declare function hydrateUmbrellaContextRuntimeBridge(cwd?: string): Promise<VendorBridgeRuntimeSnapshot>;
 export declare function getUmbrellaContextRuntimeSummary(): {
-    companyName: any;
-    generatedAt: any;
-    isHydrated: any;
-    modelName: any;
-    providerName: any;
-    runtimeStatus: any;
-    spaceCount: any;
-    spaceName: any;
-    treeNodes: any;
+    companyName: string | null;
+    generatedAt: string | null;
+    isHydrated: boolean;
+    modelName: string | null;
+    providerName: string | null;
+    runtimeStatus: "failure" | "warning" | "running" | "idle";
+    spaceCount: number;
+    spaceName: string | null;
+    treeNodes: number;
 };
+export {};

package/dist/adapters/byterover-runtime-bridge.js

@@ -211,7 +211,7 @@ async function buildConnectorsSnapshot(cwd = process.cwd()) {
         installed,
         installedSources: installed.map((entry) => entry.source),
         isLoading: false,
-        recentRunSource: runs[0]?.source ?? null,
+        recentRunSource: runs[0]?.connectorId ?? null,
         recentSource: sessionState?.recentConnectorSources?.[0] ?? null,
         runs,
     };

package/dist/adapters/byterover-transport-task-store.d.ts

@@ -1,13 +1,24 @@
-import { type VendorBridgeRuntimeSnapshot } from "./byterover-runtime-bridge.js";
-export declare const useUmbrellaTransportTaskBridgeStore: any;
+import { type VendorBridgeRuntimeSnapshot, type VendorBridgeTasksState, type VendorBridgeTransportState } from "./byterover-runtime-bridge.js";
+type UmbrellaTransportTaskBridgeState = {
+    generatedAt: string | null;
+    isHydrated: boolean;
+    taskStore: VendorBridgeTasksState;
+    transportStore: VendorBridgeTransportState | null;
+};
+type UmbrellaTransportTaskBridgeActions = {
+    hydrateFromSnapshot: (snapshot: VendorBridgeRuntimeSnapshot) => void;
+    reset: () => void;
+};
+export declare const useUmbrellaTransportTaskBridgeStore: import("zustand").UseBoundStore<import("zustand").StoreApi<UmbrellaTransportTaskBridgeActions & UmbrellaTransportTaskBridgeState>>;
 export declare function hydrateUmbrellaTransportTaskBridgeFromSnapshot(snapshot: VendorBridgeRuntimeSnapshot): void;
 export declare function hydrateUmbrellaTransportTaskBridge(cwd?: string): Promise<VendorBridgeRuntimeSnapshot>;
 export declare function getUmbrellaTransportTaskBridgeSummary(): {
-    activeTaskId: any;
-    generatedAt: any;
-    isHydrated: any;
-    queueDepth: any;
-    recentTaskCount: any;
-    startedTasks: any;
-    transportStatus: any;
+    activeTaskId: string | null;
+    generatedAt: string | null;
+    isHydrated: boolean;
+    queueDepth: number;
+    recentTaskCount: number;
+    startedTasks: number;
+    transportStatus: "failure" | "warning" | "running" | "idle";
 };
+export {};

package/dist/adapters/umbrella-onboarding.js

@@ -1,5 +1,5 @@
 import { configManager } from "../config.js";
-import { ensureRepoContext } from "../repo-state.js";
+import { ensureRepoContext, findRepoRoot } from "../repo-state.js";
 import { createContextSpace, createUmbrellaCompany, getCliSetup, getCompanyContextSummary, getUmbrellaHealth, listUmbrellaCompanies, signInToUmbrella, toContextSpaces, } from "../umbrella.js";
 export function normalizeUmbrellaServerUrl(value) {
     return value.trim().replace(/\/+$/, "");
@@ -50,6 +50,7 @@ export async function createUmbrellaOnboardingSpace(serverUrl, companyId, name,
     };
 }
 export async function saveUmbrellaDeviceLink(setup, umbrellaUrl, cwd = process.cwd()) {
+    const repoRoot = await findRepoRoot(cwd);
     configManager.set({
         umbrellaUrl,
         serverUrl: setup.baseUrl,
@@ -62,7 +63,7 @@ export async function saveUmbrellaDeviceLink(setup, umbrellaUrl, cwd = process.c
         apiKey: setup.apiKey,
     });
     configManager.upsertLocation({
-        repoRoot: cwd,
+        repoRoot,
         companyId: setup.companyId,
         companyName: setup.companyName,
         projectId: setup.activeSpaceId,
@@ -74,6 +75,9 @@ export async function saveUmbrellaDeviceLink(setup, umbrellaUrl, cwd = process.c
 export async function connectUmbrellaDevice(serverUrl, companyId, spaceId, cookie, cwd = process.cwd()) {
     const normalizedServerUrl = normalizeUmbrellaServerUrl(serverUrl);
     const setup = await getCliSetup(normalizedServerUrl, companyId, spaceId, cookie);
+    if (!setup.apiKey || setup.apiKey.trim().length === 0) {
+        throw new Error("Umbrella returned a Context setup response without an API key. The live deployment is likely out of date for this CLI.");
+    }
     await saveUmbrellaDeviceLink(setup, normalizedServerUrl, cwd);
     return setup;
 }

package/dist/commands/bridge.js

@@ -10,7 +10,7 @@ export async function bridgeCommandAction(action) {
         return;
     }
     const summary = await buildVendorRuntimeBridgeSummary();
-    console.log(chalk.bold("\n ByteRover Runtime Bridge\n"));
+    console.log(chalk.bold("\n Umbrella Runtime Bridge\n"));
     console.log(` Company: ${summary.company}`);
     console.log(` Space: ${summary.space}`);
     console.log(` Repo: ${summary.repoRoot}`);
@@ -29,11 +29,11 @@ export async function bridgeCommandAction(action) {
     console.log(`  nodes=${summary.tree.nodes} transport=${summary.tree.runtimeStatus}`);
     console.log(`  provider=${summary.tree.runtimeProvider ?? "none"}`);
     console.log("");
-    console.log(chalk.gray(" Use `umbrella-context bridge json` to inspect the full projected upstream-shaped snapshot."));
+    console.log(chalk.gray(" Use `umbrella-context bridge json` to inspect the full projected runtime snapshot."));
 }
 export function bridgeCommand(cli) {
     cli
-        .command("bridge [action]", "Project the local .um runtime into ByteRover-shaped store snapshots")
+        .command("bridge [action]", "Project the local .um runtime into the internal bridge snapshot")
         .action(async (action) => {
         await bridgeCommandAction(action);
     });

package/dist/commands/catalog.js

@@ -178,7 +178,7 @@ export const COMMAND_SPECS = [
     {
         key: "bridge",
         usage: "/bridge [summary|json]",
-        description: "Show the ByteRover-shaped runtime bridge for parity work",
+        description: "Show the internal runtime bridge snapshot",
         action: async (args) => {
             await bridgeCommandAction(args[0] ?? "summary");
         },

package/dist/commands/connect.js

@@ -1,6 +1,6 @@
 import chalk from "chalk";
 import { configManager } from "../config.js";
-import { ensureRepoContext } from "../repo-state.js";
+import { ensureRepoContext, findRepoRoot } from "../repo-state.js";
 export function connectCommand(cli) {
     cli
         .command("connect", "Connect this device directly to a company context space without the interactive setup flow")
@@ -29,6 +29,7 @@ export function connectCommand(cli) {
             return;
         }
         try {
+            const repoRoot = await findRepoRoot(process.cwd());
             const res = await fetch(`${serverUrl}/api/memories?limit=1`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
@@ -51,7 +52,7 @@ export function connectCommand(cli) {
                 apiKey,
             });
             configManager.upsertLocation({
-                repoRoot: process.cwd(),
+                repoRoot,
                 companyId,
                 companyName,
                 projectId: spaceId,

package/dist/commands/connectors.js

@@ -130,6 +130,9 @@ async function applyConnectorRunEffects(entry, cwd = process.cwd()) {
         const staged = await addPendingMemory({
             content: "Slack growth hook captured a reusable campaign note. Replace this placeholder with the real signal before pushing.",
             tags: ["slack", "growth", "draft"],
+            keywords: ["slack", "growth", "campaign"],
+            category: "team",
+            accessLevel: "space",
             systemType: "connector_capture",
             source: "slack-growth-hook",
         }, cwd);

package/dist/commands/curate.d.ts

@@ -1,6 +1,18 @@
+type OutputFormat = "text" | "json";
+type CurateViewStatus = "pending";
 export declare function curateCommandAction(content: string, opts?: {
+    format?: OutputFormat;
     tag?: string | string[];
     type?: string;
 }): Promise<void>;
-export declare function curateViewCommandAction(): Promise<void>;
+export declare function curateViewCommandAction(opts?: {
+    before?: string;
+    detail?: boolean;
+    format?: OutputFormat;
+    id?: string;
+    limit?: number;
+    since?: string;
+    status?: CurateViewStatus | CurateViewStatus[];
+}): Promise<void>;
 export declare function curateCommand(cli: any): void;
+export {};

package/dist/commands/curate.js

@@ -1,14 +1,78 @@
 import chalk from "chalk";
 import { configManager } from "../config.js";
 import { addPendingMemory, completeTask, createTask, ensureRepoContext, getPendingMemories, getRepoContext, recordSessionCuration, recordSessionEvent, setSessionPanel, } from "../repo-state.js";
+const RELATIVE_TIME_PATTERN = /^(\d+)(m|h|d|w)$/;
+function printCurateResult(format, payload) {
+    if (format === "json") {
+        console.log(JSON.stringify(payload, null, 2));
+    }
+}
+function parseTimeFilter(value) {
+    if (!value?.trim())
+        return null;
+    const relative = RELATIVE_TIME_PATTERN.exec(value.trim());
+    if (relative) {
+        const amount = Number(relative[1]);
+        const unit = relative[2];
+        const multipliers = {
+            m: 60_000,
+            h: 3_600_000,
+            d: 86_400_000,
+            w: 604_800_000,
+        };
+        return Date.now() - amount * multipliers[unit];
+    }
+    const timestamp = new Date(value).getTime();
+    return Number.isNaN(timestamp) ? null : timestamp;
+}
+function normalizeStatuses(status) {
+    if (!status)
+        return ["pending"];
+    return Array.isArray(status) ? status : [status];
+}
+function filterCurations(entries, opts) {
+    const after = parseTimeFilter(opts.since);
+    const before = parseTimeFilter(opts.before);
+    const statuses = normalizeStatuses(opts.status);
+    if ((opts.since && after === null) || (opts.before && before === null)) {
+        return {
+            error: 'Invalid time filter. Use ISO date (2026-04-07 or 2026-04-07T09:30:00Z) or relative time like "1h", "24h", "7d", or "2w".',
+            filtered: [],
+        };
+    }
+    let filtered = [...entries]
+        .filter(() => statuses.includes("pending"))
+        .filter((entry) => {
+        const createdAt = new Date(entry.createdAt).getTime();
+        if (after !== null && createdAt < after)
+            return false;
+        if (before !== null && createdAt > before)
+            return false;
+        return true;
+    });
+    if (opts.id) {
+        filtered = filtered.filter((entry) => entry.id === opts.id);
+    }
+    const limit = typeof opts.limit === "number" && Number.isFinite(opts.limit) && opts.limit > 0 ? opts.limit : 10;
+    return { error: null, filtered: filtered.slice(0, limit) };
+}
 export async function curateCommandAction(content, opts = {}) {
     const config = configManager.config;
+    const format = opts.format === "json" ? "json" : "text";
     if (!config) {
+        if (format === "json") {
+            console.log(JSON.stringify({ ok: false, error: "Not configured. Run: umbrella-context setup" }, null, 2));
+            return;
+        }
         console.log(chalk.red("Not configured. Run: umbrella-context setup"));
         return;
     }
     if (!content?.trim()) {
-        console.log(chalk.red("\n Usage: umbrella-context curate \"What we learned\""));
+        if (format === "json") {
+            console.log(JSON.stringify({ ok: false, error: 'Usage: umbrella-context curate "What we learned"' }, null, 2));
+            return;
+        }
+        console.log(chalk.red('\n Usage: umbrella-context curate "What we learned"'));
         return;
     }
     await ensureRepoContext(config);
@@ -21,9 +85,13 @@ export async function curateCommandAction(content, opts = {}) {
         panel: "curate",
         focus: content.trim(),
     });
+    const tags = opts.tag ? (Array.isArray(opts.tag) ? opts.tag : [opts.tag]) : [];
     const entry = await addPendingMemory({
         content: content.trim(),
-        tags: opts.tag ? (Array.isArray(opts.tag) ? opts.tag : [opts.tag]) : [],
+        tags,
+        keywords: tags,
+        category: null,
+        accessLevel: "space",
         source: "cli",
         systemType: opts.type || "system1_knowledge",
     });
@@ -38,41 +106,109 @@ export async function curateCommandAction(content, opts = {}) {
         status: "success",
     });
     await completeTask(task.id, "completed", `Saved local draft ${entry.id} in .um.`);
+    printCurateResult(format, {
+        ok: true,
+        action: "curate",
+        companyName: config.companyName,
+        spaceName: config.projectName,
+        pendingEntryId: entry.id,
+        tags: entry.tags,
+        type: entry.systemType,
+        accessLevel: entry.accessLevel,
+        umDir,
+    });
+    if (format === "json") {
+        return;
+    }
     console.log(chalk.green(`\n Saved locally to ${config.companyName} / ${config.projectName}`));
     console.log(chalk.gray(`   Pending entry: ${entry.id}`));
     console.log(chalk.gray(`   Repo context folder: ${umDir}`));
     console.log(chalk.gray('   Run "umbrella-context push" when you want to sync this to the server.'));
 }
-export async function curateViewCommandAction() {
+export async function curateViewCommandAction(opts = {}) {
     const config = configManager.config;
+    const format = opts.format === "json" ? "json" : "text";
     if (!config) {
+        if (format === "json") {
+            console.log(JSON.stringify({ ok: false, error: "Not configured. Run: umbrella-context setup" }, null, 2));
+            return;
+        }
         console.log(chalk.red("Not configured. Run: umbrella-context setup"));
         return;
     }
     await ensureRepoContext(config);
-    await setSessionPanel("curate", "view");
+    await setSessionPanel("curate", opts.id ?? "view");
     const entries = await getPendingMemories();
+    const { error, filtered } = filterCurations(entries, opts);
+    if (error) {
+        if (format === "json") {
+            console.log(JSON.stringify({ ok: false, action: "curate.view", error }, null, 2));
+            return;
+        }
+        console.log(chalk.red(error));
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify({
+            ok: true,
+            action: "curate.view",
+            companyName: config.companyName,
+            spaceName: config.projectName,
+            total: filtered.length,
+            statuses: normalizeStatuses(opts.status),
+            detail: Boolean(opts.detail || opts.id),
+            entries: filtered,
+        }, null, 2));
+        return;
+    }
     console.log(chalk.bold(`\n Local Curations for ${config.companyName} / ${config.projectName}\n`));
-    if (entries.length === 0) {
-        console.log(chalk.yellow(" No local curations staged yet."));
+    if (filtered.length === 0) {
+        console.log(chalk.yellow(" No local curations matched this view."));
         console.log(chalk.gray(' Try: umbrella-context curate "What you learned"'));
         return;
     }
-    entries.forEach((entry, index) => {
+    filtered.forEach((entry, index) => {
         const tags = entry.tags.length > 0 ? ` [${entry.tags.join(", ")}]` : "";
         console.log(` ${index + 1}. ${entry.content}${tags}`);
-        console.log(chalk.gray(`    ${entry.systemType} • ${entry.createdAt} • ${entry.id}`));
+        console.log(chalk.gray(`    pending • ${entry.systemType} • ${entry.createdAt} • ${entry.id}`));
+        if (opts.detail || opts.id) {
+            const keywords = entry.keywords.length > 0 ? entry.keywords.join(", ") : "none";
+            console.log(chalk.gray(`    access: ${entry.accessLevel} • category: ${entry.category ?? "uncategorized"} • source: ${entry.source}`));
+            console.log(chalk.gray(`    keywords: ${keywords}`));
+        }
     });
 }
 export function curateCommand(cli) {
     cli
-        .command("curate [...content]", "Save context locally in this repo so it can be pushed later")
+        .command("curate [...content]", `Save context locally in this repo so it can be pushed later
+
+Good examples:
+- "Auth uses JWT with 24h expiry in httpOnly cookies via auth middleware"
+- "Rate limit is 100 req/min per user using Redis sliding windows"
+Bad examples:
+- "Authentication"
+- "Rate limiting"`)
         .option("--tag <tag>", "Add tags (repeatable)")
         .option("--type <type>", "system1_knowledge or system2_reasoning")
+        .option("--format <format>", "Output format (text or json)")
+        .option("--detail", "When used with curate view, show richer entry detail")
+        .option("--limit <limit>", "When used with curate view, limit the number of entries returned")
+        .option("--since <time>", "When used with curate view, show entries after a time like 1h, 24h, 7d, or an ISO date")
+        .option("--before <time>", "When used with curate view, show entries before a time like 1h, 24h, 7d, or an ISO date")
+        .option("--status <status>", "When used with curate view, filter by status (currently: pending)")
+        .example('curate "JWT auth uses httpOnly cookies"')
+        .example('curate "Auth middleware" --tag auth --tag cookies --format json')
+        .example("curate view")
+        .example("curate view --since 1h --detail")
+        .example("curate view 123e4567-e89b-12d3-a456-426614174000 --format json")
         .action(async (content, opts) => {
         const parts = Array.isArray(content) ? content : [content];
         if (parts.length === 1 && parts[0] === "view") {
-            await curateViewCommandAction();
+            await curateViewCommandAction(opts);
+            return;
+        }
+        if (parts[0] === "view") {
+            await curateViewCommandAction({ ...opts, id: parts[1] });
             return;
         }
         await curateCommandAction(parts.join(" "), opts);

package/dist/commands/fix.js

@@ -1,6 +1,6 @@
 import chalk from "chalk";
 import { configManager } from "../config.js";
-import { addTaskReasoningContent, addTaskToolCall, appendTaskStreamingContent, completeTask, createTask, patchTaskLifecycle, recordSessionEvent, setSessionPanel, } from "../repo-state.js";
+import { addTaskReasoningContent, addTaskToolCall, appendTaskStreamingContent, completeTask, createTask, patchTaskLifecycle, removeTask, recordSessionEvent, setSessionPanel, } from "../repo-state.js";
 export function fixCommand(cli) {
     cli.command("fix <error>", "Search for known fixes to an error").action(async (error) => {
         const config = configManager.config;
@@ -54,15 +54,7 @@ export function fixCommand(cli) {
             });
             await addTaskReasoningContent(task.id, `Server returned ${data.results.length} known fix candidate${data.results.length === 1 ? "" : "s"}.`);
             if (data.results.length === 0) {
-                await completeTask(task.id, "completed", `No known fixes found for "${error}".`);
-                await recordSessionEvent({
-                    kind: "query",
-                    title: `No known fixes found for "${error}"`,
-                    detail: "The shared fixes store did not contain this error signal.",
-                    panel: "fix",
-                    focus: error,
-                    status: "warning",
-                });
+                await removeTask(task.id);
                 console.log(chalk.yellow(`\n No known fixes for "${error}"`));
                 return;
             }

package/dist/commands/interactive.js

@@ -46,7 +46,7 @@ function printWelcomeHeader(providerLabel, modelLabel) {
     console.log(`  ${chalk.yellow("/reset")}        Reset this repo's local Context state`);
     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(`  ${chalk.gray("Shortcuts:")} start with ${chalk.yellow("?")} to query, or start with ${chalk.yellow("+")} to curate quickly.`);
     console.log("");
 }
 async function printRuntimeSnapshot() {
@@ -794,7 +794,7 @@ export async function interactiveCommand(_args) {
     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"));
+    console.log(chalk.gray(" Type / to see commands. Use ? to query or + to curate.\n"));
     while (true) {
         const currentConfig = configManager.config;
         if (!currentConfig) {
@@ -837,21 +837,32 @@ export async function interactiveCommand(_args) {
             }
             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}`);
+        if (raw.startsWith("?")) {
+            const query = raw.slice(1).trim();
+            if (!query) {
+                console.log(chalk.yellow("Use ? followed by a real question, for example ? what do we already know about auth timeouts"));
+                continue;
+            }
+            commandHistory.push(`/query ${query}`);
+            await recordSessionCommand(`/query ${query}`);
+            await recordSessionQuery(query);
+            await setSessionSummary(`Queried Context: ${query.length > 48 ? `${query.slice(0, 48)}...` : query}`);
             try {
-                await searchCommandAction(raw);
+                await searchCommandAction(query);
             }
             catch (err) {
                 console.log(chalk.red(`Command failed: ${err.message}`));
             }
             continue;
         }
+        const { command, args } = parseInteractiveInput(raw);
+        const spec = resolveCommand(command);
+        if (!raw.startsWith("/") && !spec) {
+            console.log(chalk.yellow("That text was not run automatically."));
+            console.log(chalk.gray("Use /query <question> or start with ? to search Context."));
+            console.log(chalk.gray("Use /curate <note> or start with + to save something locally."));
+            continue;
+        }
         if (!spec) {
             console.log(chalk.yellow(`Unknown command: ${raw}. Type / to see available commands.`));
             continue;

package/dist/commands/locations.d.ts

@@ -1,2 +1,7 @@
-export declare function locationsCommandAction(): Promise<void>;
+type OutputFormat = "text" | "json";
+export declare function locationsCommandAction(opts?: {
+    format?: OutputFormat;
+    detail?: boolean;
+}): Promise<void>;
 export declare function locationsCommand(cli: any): void;
+export {};