umbrella-context 0.1.37 → 0.1.39

package/dist/commands/pull.js

@@ -1,9 +1,70 @@
 import chalk from "chalk";
 import { configManager } from "../config.js";
 import { addTaskReasoningContent, addTaskToolCall, completeTask, createTask, ensureRepoContext, recordSessionEvent, setPulledFixes, setPulledMemories, setSessionPanel, } from "../repo-state.js";
-export async function pullCommandAction() {
+function printJson(payload) {
+    console.log(JSON.stringify(payload, null, 2));
+}
+function buildPullPreview(memories, fixes) {
+    const categories = {};
+    const accessLevels = {};
+    const tagCounts = new Map();
+    for (const entry of memories) {
+        const category = entry.category?.trim() || "uncategorized";
+        categories[category] = (categories[category] ?? 0) + 1;
+        const accessLevel = entry.accessLevel?.trim() || "space";
+        accessLevels[accessLevel] = (accessLevels[accessLevel] ?? 0) + 1;
+        for (const tag of entry.tags ?? []) {
+            const normalized = String(tag).trim().toLowerCase();
+            if (!normalized)
+                continue;
+            tagCounts.set(normalized, (tagCounts.get(normalized) ?? 0) + 1);
+        }
+    }
+    return {
+        remoteMemories: memories.length,
+        remoteFixes: fixes.length,
+        categories,
+        accessLevels,
+        topTags: [...tagCounts.entries()]
+            .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+            .slice(0, 5)
+            .map(([tag, count]) => ({ tag, count })),
+    };
+}
+function printPullPreviewText(preview, companyName, spaceName) {
+    console.log(chalk.bold(`\n Pull preview for ${companyName} / ${spaceName}`));
+    console.log(chalk.gray(` Shared memories: ${preview.remoteMemories}`));
+    console.log(chalk.gray(` Known fixes: ${preview.remoteFixes}`));
+    const accessLevels = Object.entries(preview.accessLevels);
+    if (accessLevels.length > 0) {
+        console.log(chalk.cyan("\n Access levels:"));
+        for (const [accessLevel, count] of accessLevels.sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))) {
+            console.log(chalk.gray(` - ${accessLevel}: ${count}`));
+        }
+    }
+    const categories = Object.entries(preview.categories);
+    if (categories.length > 0) {
+        console.log(chalk.cyan("\n Categories:"));
+        for (const [category, count] of categories.sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))) {
+            console.log(chalk.gray(` - ${category}: ${count}`));
+        }
+    }
+    if (preview.topTags.length > 0) {
+        console.log(chalk.cyan("\n Top tags:"));
+        for (const entry of preview.topTags) {
+            console.log(chalk.gray(` - ${entry.tag}: ${entry.count}`));
+        }
+    }
+}
+export async function pullCommandAction(opts = {}) {
     const config = configManager.config;
+    const format = opts.format === "json" ? "json" : "text";
+    const dryRun = Boolean(opts.dryRun);
     if (!config) {
+        if (format === "json") {
+            printJson({ ok: false, error: "Not configured. Run: umbrella-context setup" });
+            return;
+        }
         console.log(chalk.red("Not configured. Run: umbrella-context setup"));
         return;
     }
@@ -46,11 +107,16 @@ export async function pullCommandAction() {
                 error: err || memoriesRes.statusText,
             });
             await completeTask(task.id, "failed", err || memoriesRes.statusText);
+            if (format === "json") {
+                printJson({ ok: false, action: "pull", error: err || memoriesRes.statusText });
+                return;
+            }
             console.log(chalk.red(`\n Pull failed: ${err || memoriesRes.statusText}`));
             return;
         }
         const memoriesJson = await memoriesRes.json();
         const fixesJson = fixesRes.ok ? await fixesRes.json() : { results: [] };
+        const preview = buildPullPreview(memoriesJson.results ?? [], fixesJson.results ?? []);
         await addTaskToolCall(task.id, {
             toolName: "server.memory.list",
             status: "completed",
@@ -65,10 +131,38 @@ export async function pullCommandAction() {
             error: fixesRes.ok ? undefined : fixesRes.statusText,
         });
         await addTaskReasoningContent(task.id, `Pulled ${memoriesJson.results?.length ?? 0} context entr${(memoriesJson.results?.length ?? 0) === 1 ? "y" : "ies"} and ${fixesJson.results?.length ?? 0} known fix${(fixesJson.results?.length ?? 0) === 1 ? "" : "es"}.`);
+        if (dryRun) {
+            await completeTask(task.id, "completed", "Previewed the shared server snapshot without changing the local .um files.");
+            await recordSessionEvent({
+                kind: "pull",
+                title: "Previewed shared Context snapshot",
+                detail: `Looked at ${preview.remoteMemories} shared memor${preview.remoteMemories === 1 ? "y" : "ies"} and ${preview.remoteFixes} known fix${preview.remoteFixes === 1 ? "" : "es"} for ${config.companyName} / ${config.projectName}.`,
+                panel: "pull",
+                focus: config.projectName,
+                status: "info",
+            });
+            if (format === "json") {
+                printJson({
+                    ok: true,
+                    action: "pull",
+                    mode: "preview",
+                    companyName: config.companyName,
+                    spaceName: config.projectName,
+                    preview,
+                });
+                return;
+            }
+            printPullPreviewText(preview, config.companyName, config.projectName);
+            console.log(chalk.gray("\n Run `umbrella-context pull` when you are ready to refresh your local .um snapshot."));
+            return;
+        }
         await setPulledMemories((memoriesJson.results ?? []).map((entry) => ({
             id: entry.id,
             content: entry.content,
             tags: entry.tags ?? [],
+            keywords: entry.keywords ?? [],
+            category: entry.category ?? null,
+            accessLevel: entry.accessLevel ?? "space",
             source: entry.source ?? "server",
             systemType: entry.systemType ?? "system1_knowledge",
             createdAt: entry.createdAt ?? new Date().toISOString(),
@@ -92,6 +186,18 @@ export async function pullCommandAction() {
             status: "success",
         });
         await completeTask(task.id, "completed", `Pulled ${memoriesJson.results?.length ?? 0} context entr${(memoriesJson.results?.length ?? 0) === 1 ? "y" : "ies"} and ${fixesJson.results?.length ?? 0} known fix${(fixesJson.results?.length ?? 0) === 1 ? "" : "es"}.`);
+        if (format === "json") {
+            printJson({
+                ok: true,
+                action: "pull",
+                companyName: config.companyName,
+                spaceName: config.projectName,
+                pulledMemories: memoriesJson.results?.length ?? 0,
+                pulledFixes: fixesJson.results?.length ?? 0,
+                preview,
+            });
+            return;
+        }
         console.log(chalk.green(`\n Pulled ${memoriesJson.results?.length ?? 0} context entries from the server.`));
         console.log(chalk.gray(`   Company: ${config.companyName}`));
         console.log(chalk.gray(`   Space: ${config.projectName}`));
@@ -107,11 +213,21 @@ export async function pullCommandAction() {
             focus: config.projectName,
         });
         await completeTask(failedTask.id, "failed", err.message);
+        if (format === "json") {
+            printJson({ ok: false, action: "pull", error: err.message });
+            return;
+        }
         console.log(chalk.red(`\n Error: ${err.message}`));
     }
 }
 export function pullCommand(cli) {
-    cli.command("pull", "Refresh the local .um snapshot from the server").action(async () => {
-        await pullCommandAction();
+    cli
+        .command("pull", "Refresh the local .um snapshot from the server")
+        .option("--format <format>", "Output format (text or json)")
+        .option("--dry-run", "Preview what would be pulled without changing local files")
+        .example("pull --dry-run")
+        .example("pull --format json")
+        .action(async (opts) => {
+        await pullCommandAction(opts);
     });
 }

package/dist/commands/push.d.ts

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

package/dist/commands/push.js

@@ -1,9 +1,83 @@
 import chalk from "chalk";
 import { configManager } from "../config.js";
 import { addTaskReasoningContent, addTaskToolCall, clearPendingMemories, completeTask, createTask, ensureRepoContext, getPendingMemories, getPulledMemories, markPushCompleted, recordSessionEvent, setSessionPanel, setPulledMemories, } from "../repo-state.js";
-export async function pushCommandAction() {
+function printJson(payload) {
+    console.log(JSON.stringify(payload, null, 2));
+}
+function buildPushPreview(entries) {
+    const categoryCounts = {};
+    const accessLevelCounts = { space: 0, company: 0 };
+    const tagCounts = new Map();
+    const keywordCounts = new Map();
+    for (const entry of entries) {
+        const category = entry.category?.trim() || "uncategorized";
+        categoryCounts[category] = (categoryCounts[category] ?? 0) + 1;
+        accessLevelCounts[entry.accessLevel] += 1;
+        for (const tag of entry.tags) {
+            const normalized = tag.trim().toLowerCase();
+            if (!normalized)
+                continue;
+            tagCounts.set(normalized, (tagCounts.get(normalized) ?? 0) + 1);
+        }
+        for (const keyword of entry.keywords) {
+            const normalized = keyword.trim().toLowerCase();
+            if (!normalized)
+                continue;
+            keywordCounts.set(normalized, (keywordCounts.get(normalized) ?? 0) + 1);
+        }
+    }
+    const sortCounts = (counts) => [...counts.entries()]
+        .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+        .slice(0, 5)
+        .map(([value, count]) => ({ tag: value, count }));
+    return {
+        pendingCount: entries.length,
+        categoryCounts,
+        accessLevelCounts,
+        topTags: sortCounts(tagCounts),
+        topKeywords: [...keywordCounts.entries()]
+            .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+            .slice(0, 5)
+            .map(([keyword, count]) => ({ keyword, count })),
+        latestDraftAt: entries.length > 0 ? entries.map((entry) => entry.createdAt).sort().at(-1) ?? null : null,
+    };
+}
+function printPushPreviewText(preview, companyName, spaceName) {
+    console.log(chalk.bold(`\n Push preview for ${companyName} / ${spaceName}`));
+    console.log(chalk.gray(` Pending drafts: ${preview.pendingCount}`));
+    console.log(chalk.gray(` Access: ${preview.accessLevelCounts.space} space, ${preview.accessLevelCounts.company} company`));
+    const categories = Object.entries(preview.categoryCounts);
+    if (categories.length > 0) {
+        console.log(chalk.cyan("\n Categories:"));
+        for (const [category, count] of categories.sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))) {
+            console.log(chalk.gray(` - ${category}: ${count}`));
+        }
+    }
+    if (preview.topTags.length > 0) {
+        console.log(chalk.cyan("\n Top tags:"));
+        for (const entry of preview.topTags) {
+            console.log(chalk.gray(` - ${entry.tag}: ${entry.count}`));
+        }
+    }
+    if (preview.topKeywords.length > 0) {
+        console.log(chalk.cyan("\n Top keywords:"));
+        for (const entry of preview.topKeywords) {
+            console.log(chalk.gray(` - ${entry.keyword}: ${entry.count}`));
+        }
+    }
+    if (preview.latestDraftAt) {
+        console.log(chalk.gray(`\n Latest draft: ${new Date(preview.latestDraftAt).toLocaleString()}`));
+    }
+}
+export async function pushCommandAction(opts = {}) {
     const config = configManager.config;
+    const format = opts.format === "json" ? "json" : "text";
+    const dryRun = Boolean(opts.dryRun);
     if (!config) {
+        if (format === "json") {
+            printJson({ ok: false, error: "Not configured. Run: umbrella-context setup" });
+            return;
+        }
         console.log(chalk.red("Not configured. Run: umbrella-context setup"));
         return;
     }
@@ -19,6 +93,7 @@ export async function pushCommandAction() {
             focus: config.projectName,
         });
         const pending = await getPendingMemories();
+        const preview = buildPushPreview(pending);
         await addTaskReasoningContent(task.id, `Found ${pending.length} pending local draft${pending.length === 1 ? "" : "s"} ready for upload.`);
         if (pending.length === 0) {
             await completeTask(task.id, "completed", "Nothing was pending, so no push was needed.");
@@ -30,9 +105,46 @@ export async function pushCommandAction() {
                 focus: config.projectName,
                 status: "info",
             });
+            if (format === "json") {
+                printJson({
+                    ok: true,
+                    action: "push",
+                    companyName: config.companyName,
+                    spaceName: config.projectName,
+                    pushedCount: 0,
+                    pendingCount: 0,
+                    preview,
+                });
+                return;
+            }
             console.log(chalk.yellow("\n Nothing to push. Your local .um folder is already in sync."));
             return;
         }
+        if (dryRun) {
+            await completeTask(task.id, "completed", "Previewed pending local drafts without uploading them.");
+            await recordSessionEvent({
+                kind: "push",
+                title: "Previewed pending Context drafts",
+                detail: `Looked at ${pending.length} pending draft${pending.length === 1 ? "" : "s"} for ${config.companyName} / ${config.projectName} without pushing them.`,
+                panel: "push",
+                focus: config.projectName,
+                status: "info",
+            });
+            if (format === "json") {
+                printJson({
+                    ok: true,
+                    action: "push",
+                    mode: "preview",
+                    companyName: config.companyName,
+                    spaceName: config.projectName,
+                    preview,
+                });
+                return;
+            }
+            printPushPreviewText(preview, config.companyName, config.projectName);
+            console.log(chalk.gray("\n Run `umbrella-context push` when you are ready to upload these drafts."));
+            return;
+        }
         const synced = [];
         for (const entry of pending) {
             await addTaskToolCall(task.id, {
@@ -53,6 +165,9 @@ export async function pushCommandAction() {
                 body: JSON.stringify({
                     content: entry.content,
                     tags: entry.tags,
+                    keywords: entry.keywords,
+                    category: entry.category,
+                    accessLevel: entry.accessLevel,
                     source: entry.source,
                     systemType: entry.systemType,
                 }),
@@ -66,6 +181,10 @@ export async function pushCommandAction() {
                     error: err || res.statusText,
                 });
                 await completeTask(task.id, "failed", err || res.statusText);
+                if (format === "json") {
+                    printJson({ ok: false, action: "push", error: err || res.statusText });
+                    return;
+                }
                 console.log(chalk.red(`\n Push failed: ${err || res.statusText}`));
                 return;
             }
@@ -84,6 +203,9 @@ export async function pushCommandAction() {
                 id: entry.id,
                 content: entry.content,
                 tags: entry.tags ?? [],
+                keywords: entry.keywords ?? [],
+                category: entry.category ?? null,
+                accessLevel: entry.accessLevel ?? "space",
                 source: entry.source ?? "cli",
                 systemType: entry.systemType ?? "system1_knowledge",
                 createdAt: entry.createdAt ?? new Date().toISOString(),
@@ -101,6 +223,18 @@ export async function pushCommandAction() {
             status: "success",
         });
         await completeTask(task.id, "completed", `Pushed ${synced.length} entr${synced.length === 1 ? "y" : "ies"} to the server.`);
+        if (format === "json") {
+            printJson({
+                ok: true,
+                action: "push",
+                companyName: config.companyName,
+                spaceName: config.projectName,
+                pushedCount: synced.length,
+                preview,
+                ids: synced.map((entry) => entry.id),
+            });
+            return;
+        }
         console.log(chalk.green(`\n Pushed ${synced.length} local context entr${synced.length === 1 ? "y" : "ies"}.`));
         console.log(chalk.gray(`   Company: ${config.companyName}`));
         console.log(chalk.gray(`   Space: ${config.projectName}`));
@@ -115,11 +249,21 @@ export async function pushCommandAction() {
             focus: config.projectName,
         });
         await completeTask(failedTask.id, "failed", err.message);
+        if (format === "json") {
+            printJson({ ok: false, action: "push", error: err.message });
+            return;
+        }
         console.log(chalk.red(`\n Error: ${err.message}`));
     }
 }
 export function pushCommand(cli) {
-    cli.command("push", "Push pending local .um context to the server").action(async () => {
-        await pushCommandAction();
+    cli
+        .command("push", "Push pending local .um context to the server")
+        .option("--format <format>", "Output format (text or json)")
+        .option("--dry-run", "Preview what would be pushed without uploading anything")
+        .example("push --dry-run")
+        .example("push --format json")
+        .action(async (opts) => {
+        await pushCommandAction(opts);
     });
 }

package/dist/commands/restart.js

@@ -15,7 +15,12 @@ export async function restartCommandAction() {
     console.log(chalk.gray(" Local .um context files were kept. Only the live shell session was refreshed."));
 }
 export function restartCommand(cli) {
-    cli.command("restart", "Refresh the local repo session without deleting .um data").action(async () => {
+    cli
+        .command("restart", `Refresh the local repo session without deleting .um data
+
+Use this when the Context terminal feels stuck, panel state looks wrong, or you want a clean local session without losing saved notes in .um.`)
+        .example("restart")
+        .action(async () => {
         await restartCommandAction();
     });
 }

package/dist/commands/search.d.ts

@@ -1,2 +1,6 @@
-export declare function searchCommandAction(query: string): Promise<void>;
+type OutputFormat = "text" | "json";
+export declare function searchCommandAction(query: string, opts?: {
+    format?: OutputFormat;
+}): Promise<void>;
 export declare function searchCommand(cli: any): void;
+export {};