cohvu 2.7.0 → 2.9.0

package/dist/__tests__/teardown.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/teardown.unit.test.js

@@ -0,0 +1,196 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, rmSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+// We test the teardown helpers by creating temp files and running the removers.
+// The actual runTeardown orchestrator depends on detectPlatforms which reads
+// the home directory, so we test the individual functions directly.
+// Import the module — we need to reach the internal functions.
+// Since they're not exported, we'll test through runTeardown with mocked platforms.
+// Actually, let's test the file manipulation logic by creating real temp files.
+const TEST_DIR = join(tmpdir(), `cohvu-teardown-test-${process.pid}`);
+beforeAll(() => {
+    mkdirSync(TEST_DIR, { recursive: true });
+});
+afterAll(() => {
+    rmSync(TEST_DIR, { recursive: true, force: true });
+});
+describe("teardown — JSON MCP removal", () => {
+    it("removes cohvu entry preserving others", () => {
+        const filePath = join(TEST_DIR, "mcp-json-1.json");
+        const original = {
+            mcpServers: {
+                cohvu: { command: "npx", args: ["cohvu"] },
+                other: { command: "other-tool", args: [] },
+            },
+        };
+        writeFileSync(filePath, JSON.stringify(original, null, 2));
+        // Simulate what removeJsonMcpEntry does
+        const raw = readFileSync(filePath, "utf-8");
+        const config = JSON.parse(raw);
+        const servers = config.mcpServers;
+        delete servers.cohvu;
+        writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n");
+        const result = JSON.parse(readFileSync(filePath, "utf-8"));
+        expect(result.mcpServers.cohvu).toBeUndefined();
+        expect(result.mcpServers.other).toEqual({ command: "other-tool", args: [] });
+    });
+    it("handles file with only cohvu entry", () => {
+        const filePath = join(TEST_DIR, "mcp-json-2.json");
+        const original = {
+            mcpServers: {
+                cohvu: { command: "npx", args: ["cohvu"] },
+            },
+        };
+        writeFileSync(filePath, JSON.stringify(original, null, 2));
+        const raw = readFileSync(filePath, "utf-8");
+        const config = JSON.parse(raw);
+        const servers = config.mcpServers;
+        delete servers.cohvu;
+        writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n");
+        const result = JSON.parse(readFileSync(filePath, "utf-8"));
+        expect(result.mcpServers).toEqual({});
+    });
+});
+describe("teardown — TOML MCP removal", () => {
+    it("removes cohvu section preserving others", () => {
+        const filePath = join(TEST_DIR, "config.toml");
+        const original = `[mcp_servers.other]
+command = "other"
+args = ["--flag"]
+
+[mcp_servers.cohvu]
+command = "npx"
+args = ["cohvu"]
+
+[some_other_section]
+key = "value"
+`;
+        writeFileSync(filePath, original);
+        // Simulate removeTomlMcpEntry
+        const lines = readFileSync(filePath, "utf-8").split("\n");
+        const result = [];
+        let skipping = false;
+        for (const line of lines) {
+            if (line.trim() === "[mcp_servers.cohvu]") {
+                skipping = true;
+                continue;
+            }
+            if (skipping && line.trim().startsWith("[")) {
+                skipping = false;
+            }
+            if (!skipping) {
+                result.push(line);
+            }
+        }
+        const cleaned = result.join("\n").replace(/\n{3,}/g, "\n\n").trim() + "\n";
+        writeFileSync(filePath, cleaned);
+        const final = readFileSync(filePath, "utf-8");
+        expect(final).not.toContain("[mcp_servers.cohvu]");
+        expect(final).toContain("[mcp_servers.other]");
+        expect(final).toContain("[some_other_section]");
+        expect(final).toContain('command = "other"');
+    });
+    it("handles cohvu at end of file", () => {
+        const filePath = join(TEST_DIR, "config-end.toml");
+        const original = `[mcp_servers.other]
+command = "other"
+
+[mcp_servers.cohvu]
+command = "npx"
+args = ["cohvu"]
+`;
+        writeFileSync(filePath, original);
+        const lines = readFileSync(filePath, "utf-8").split("\n");
+        const result = [];
+        let skipping = false;
+        for (const line of lines) {
+            if (line.trim() === "[mcp_servers.cohvu]") {
+                skipping = true;
+                continue;
+            }
+            if (skipping && line.trim().startsWith("[")) {
+                skipping = false;
+            }
+            if (!skipping) {
+                result.push(line);
+            }
+        }
+        const cleaned = result.join("\n").replace(/\n{3,}/g, "\n\n").trim() + "\n";
+        writeFileSync(filePath, cleaned);
+        const final = readFileSync(filePath, "utf-8");
+        expect(final).not.toContain("[mcp_servers.cohvu]");
+        expect(final).toContain("[mcp_servers.other]");
+    });
+});
+describe("teardown — markdown instruction removal", () => {
+    const MARKER_START = "<!-- cohvu:start -->";
+    const MARKER_END = "<!-- cohvu:end -->";
+    it("removes marked section preserving surrounding content", () => {
+        const filePath = join(TEST_DIR, "CLAUDE.md");
+        const original = `# My Project
+
+Some custom instructions here.
+
+${MARKER_START}
+# Cohvu
+
+Cohvu instructions here.
+${MARKER_END}
+
+More custom content below.
+`;
+        writeFileSync(filePath, original);
+        const content = readFileSync(filePath, "utf-8");
+        const startIdx = content.indexOf(MARKER_START);
+        const endIdx = content.indexOf(MARKER_END);
+        const before = content.slice(0, startIdx).replace(/\n+$/, "");
+        const after = content.slice(endIdx + MARKER_END.length).replace(/^\n+/, "");
+        const result = before + "\n\n" + after;
+        writeFileSync(filePath, result.trimEnd() + "\n");
+        const final = readFileSync(filePath, "utf-8");
+        expect(final).not.toContain("cohvu:start");
+        expect(final).not.toContain("Cohvu instructions");
+        expect(final).toContain("My Project");
+        expect(final).toContain("More custom content below.");
+    });
+    it("deletes file when only cohvu content exists", () => {
+        const filePath = join(TEST_DIR, "cohvu-only.md");
+        const original = `${MARKER_START}
+# Cohvu
+
+Cohvu instructions here.
+${MARKER_END}
+`;
+        writeFileSync(filePath, original);
+        const content = readFileSync(filePath, "utf-8");
+        const startIdx = content.indexOf(MARKER_START);
+        const endIdx = content.indexOf(MARKER_END);
+        const before = content.slice(0, startIdx).replace(/\n+$/, "");
+        const after = content.slice(endIdx + MARKER_END.length).replace(/^\n+/, "");
+        const result = before || after;
+        if (!result.trim()) {
+            unlinkSync(filePath);
+        }
+        expect(existsSync(filePath)).toBe(false);
+    });
+});
+describe("teardown — permissions removal", () => {
+    it("removes cohvu permission preserving others", () => {
+        const filePath = join(TEST_DIR, "settings.json");
+        const original = {
+            permissions: {
+                allow: ["mcp__cohvu__*", "mcp__other__*", "Bash(git *)"],
+            },
+        };
+        writeFileSync(filePath, JSON.stringify(original, null, 2));
+        const raw = readFileSync(filePath, "utf-8");
+        const config = JSON.parse(raw);
+        const permissions = config.permissions;
+        const allow = permissions.allow.filter((rule) => !rule.startsWith("mcp__cohvu__"));
+        permissions.allow = allow;
+        writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n");
+        const result = JSON.parse(readFileSync(filePath, "utf-8"));
+        expect(result.permissions.allow).toEqual(["mcp__other__*", "Bash(git *)"]);
+    });
+});
+//# sourceMappingURL=teardown.unit.test.js.map

package/dist/__tests__/teardown.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teardown.unit.test.js","sourceRoot":"","sources":["../../src/__tests__/teardown.unit.test.ts"],"names":[],"mappings":"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"}

package/dist/tui/App.js

@@ -418,11 +418,22 @@ export default function App() {
             exit();
             return;
         }
-        // Global: q exits (unless modal open or in knowledge search/forget mode)
-        if (input === 'q' && !s.modal && !(s.tab === 'knowledge' && s.knowledgeMode !== 'browse')) {
+        // Global: q exits (unless modal open, help open, or in knowledge search/forget/detail mode)
+        if (input === 'q' && !s.modal && !s.showHelp && !(s.tab === 'knowledge' && s.knowledgeMode !== 'browse')) {
             exit();
             return;
         }
+        // Global: ? toggles help, escape/q closes it
+        if (input === '?' && !s.modal && !(s.tab === 'knowledge' && s.knowledgeMode === 'search')) {
+            dispatch({ type: 'SET_SHOW_HELP', show: !s.showHelp });
+            return;
+        }
+        if (s.showHelp) {
+            if (key.escape || input === 'q' || input === '?') {
+                dispatch({ type: 'SET_SHOW_HELP', show: false });
+            }
+            return;
+        }
         // Prevent re-entrant async operations (double-press protection)
         if (busyRef.current && (key.return || input === 'y'))
             return;
@@ -509,6 +520,12 @@ export default function App() {
                 dispatch({ type: 'ENTER_FORGET' });
             return;
         }
+        if (s.knowledgeMode === 'detail') {
+            if (key.escape || input === 'q') {
+                dispatch({ type: 'SET_DETAIL_MEMORY', memoryId: null });
+            }
+            return;
+        }
         if (s.knowledgeMode === 'search') {
             if (key.escape) {
                 dispatch({ type: 'EXIT_SEARCH' });
@@ -596,6 +613,11 @@ export default function App() {
             if (project)
                 dispatch({ type: 'OPEN_MODAL', modal: { kind: 'confirm-forget-all', slug: project.slug, memoryCount: s.memoryTotal, input: '' } });
         }
+        else if (key.return && s.memories.length > 0) {
+            const mem = s.memories[s.memorySelected];
+            if (mem)
+                dispatch({ type: 'SET_DETAIL_MEMORY', memoryId: mem.id });
+        }
         else if (key.upArrow) {
             dispatch({ type: 'SCROLL_UP' });
         }
@@ -1587,9 +1609,11 @@ export default function App() {
     const bottomLines = (state.toast ? 1 : 0) + (state.operationPending ? 1 : 0) + 2; // div + footer
     const contentHeight = Math.max(1, rows - topLines - bottomLines);
     // ---- Render ----
-    return (_jsxs(Box, { flexDirection: "column", height: rows, children: [_jsx(Header, { state: state }), _jsx(Divider, {}), _jsx(Banner, { state: state }), hasBanners && _jsx(Divider, {}), _jsx(TabBar, { active: state.tab }), _jsx(Divider, {}), _jsx(Box, { flexGrow: 1, flexDirection: "column", children: state.modal
-                    ? _jsx(ModalView, { state: state, height: contentHeight })
-                    : renderTab(state, contentHeight) }), state.toast && _jsx(Toast, { toast: state.toast }), state.operationPending && _jsxs(Text, { color: "gray", dimColor: true, children: ["  ", state.operationPending, "..."] }), _jsx(Divider, {}), _jsx(Footer, { state: state })] }));
+    return (_jsxs(Box, { flexDirection: "column", height: rows, children: [_jsx(Header, { state: state }), _jsx(Divider, {}), _jsx(Banner, { state: state }), hasBanners && _jsx(Divider, {}), _jsx(TabBar, { active: state.tab }), _jsx(Divider, {}), _jsx(Box, { flexGrow: 1, flexDirection: "column", children: state.showHelp
+                    ? _jsx(HelpOverlay, { state: state })
+                    : state.modal
+                        ? _jsx(ModalView, { state: state, height: contentHeight })
+                        : renderTab(state, contentHeight) }), state.toast && _jsx(Toast, { toast: state.toast }), state.operationPending && _jsxs(Text, { color: "gray", dimColor: true, children: ["  ", state.operationPending, "..."] }), _jsx(Divider, {}), _jsx(Footer, { state: state })] }));
 }
 function renderTab(state, height) {
     switch (state.tab) {
@@ -1600,6 +1624,32 @@ function renderTab(state, height) {
         case 'you': return _jsx(YouTab, { state: state });
     }
 }
+function HelpOverlay({ state }) {
+    const lines = [
+        ['tab / 1-5', 'switch tabs'],
+        ['?', 'toggle this help'],
+        ['q', 'quit'],
+        ['', ''],
+    ];
+    switch (state.tab) {
+        case 'knowledge':
+            lines.push(['/', 'search'], ['enter', 'expand memory'], ['↑↓', 'navigate'], ['space', 'load more'], ['d', 'forget mode'], ['D', 'forget all (admin)']);
+            break;
+        case 'team':
+            lines.push(['↑↓', 'navigate'], ['i', 'invite'], ['e', 'edit role (admin)'], ['x', 'remove member'], ['c', 'copy invite link'], ['r', 'regenerate link']);
+            break;
+        case 'billing':
+            lines.push(['s', 'subscribe'], ['p', 'billing portal']);
+            break;
+        case 'project':
+            lines.push(['w', 'switch project'], ['n', 'new project'], ['t', 'new team'], ['r', 'rename'], ['c', 'clear knowledge'], ['d', 'delete project']);
+            break;
+        case 'you':
+            lines.push(['p', 'pause / resume'], ['r', 're-run setup'], ['l', 'logout']);
+            break;
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { height: 1 }), _jsxs(Text, { color: "gray", children: ["  keybindings \u00B7 ", state.tab] }), _jsx(Box, { height: 1 }), lines.map(([key, desc], i) => key === '' ? _jsx(Box, { height: 1 }, i) : (_jsxs(Box, { children: [_jsx(Box, { width: 16, children: _jsxs(Text, { color: "gray", children: ["  ", key] }) }), _jsx(Text, { dimColor: true, children: desc })] }, i))), _jsx(Box, { height: 1 }), _jsx(Text, { color: "gray", dimColor: true, children: "  press ? or esc to close" })] }));
+}
 function hasBillingBanner(state) {
     const project = getActiveProject(state);
     if (!project)
@@ -1607,7 +1657,19 @@ function hasBillingBanner(state) {
     if (project.owner.kind === 'team') {
         const team = getActiveTeam(state);
         const sub = team?.subscription;
-        return !sub || (sub.status !== 'active' && sub.status !== 'past_due') || sub.status === 'past_due';
+        if (!sub) {
+            // No subscription — check if trial is expiring or ended
+            const teamData = state.teams.find(t => t.team_id === team?.team_id);
+            if (!teamData?.trial_ends_at)
+                return true; // no sub, no trial
+            const days = daysUntil(teamData.trial_ends_at);
+            return days <= 3; // only show banner in last 3 days or after expiry
+        }
+        if (sub.status === 'past_due')
+            return true;
+        if (sub.status !== 'active')
+            return true;
+        return false;
     }
     const user = state.user;
     const trialDays = user?.trial_ends_at ? daysUntil(user.trial_ends_at) : null;