@jacques-ai/cli 0.0.7-alpha.1

package/dist/hooks/useUsageLimits.test.js

@@ -0,0 +1,136 @@
+/**
+ * useUsageLimits Tests
+ *
+ * Tests usage data processing and dot visualization logic.
+ */
+import { describe, it, expect } from "@jest/globals";
+import { SUCCESS_COLOR, WARNING_COLOR, ERROR_COLOR } from "../components/layout/theme.js";
+function makeUsagePeriod(overrides = {}) {
+    return {
+        label: "current",
+        used: 50,
+        total: 100,
+        percentage: 50,
+        resetsAt: "2026-02-09T15:00:00Z",
+        ...overrides,
+    };
+}
+describe("usage data mapping", () => {
+    it("maps API response to UsageLimits", () => {
+        const data = {
+            current: { label: "current", used: 42, total: 100, percentage: 42, resetsAt: "3:42pm" },
+            weekly: { label: "weekly", used: 18, total: 100, percentage: 18, resetsAt: "feb 14" },
+        };
+        const limits = {
+            current: data.current || null,
+            weekly: data.weekly || null,
+        };
+        expect(limits.current).not.toBeNull();
+        expect(limits.current?.percentage).toBe(42);
+        expect(limits.weekly?.percentage).toBe(18);
+    });
+    it("handles missing current period", () => {
+        const data = {
+            weekly: makeUsagePeriod({ label: "weekly", percentage: 20 }),
+        };
+        const limits = {
+            current: data.current || null,
+            weekly: data.weekly || null,
+        };
+        expect(limits.current).toBeNull();
+        expect(limits.weekly).not.toBeNull();
+    });
+    it("handles missing weekly period", () => {
+        const data = {
+            current: makeUsagePeriod({ label: "current", percentage: 60 }),
+        };
+        const limits = {
+            current: data.current || null,
+            weekly: data.weekly || null,
+        };
+        expect(limits.current).not.toBeNull();
+        expect(limits.weekly).toBeNull();
+    });
+    it("handles both periods missing", () => {
+        const data = {};
+        const limits = {
+            current: data.current || null,
+            weekly: data.weekly || null,
+        };
+        expect(limits.current).toBeNull();
+        expect(limits.weekly).toBeNull();
+    });
+});
+describe("usage dot visualization logic", () => {
+    const TOTAL_DOTS = 10;
+    function renderUsageDots(percentage) {
+        const filled = Math.round((percentage / 100) * TOTAL_DOTS);
+        const empty = TOTAL_DOTS - filled;
+        const color = percentage >= 80 ? ERROR_COLOR : percentage >= 50 ? WARNING_COLOR : SUCCESS_COLOR;
+        return { filled, empty, color };
+    }
+    it("renders 0% as all empty dots", () => {
+        const result = renderUsageDots(0);
+        expect(result.filled).toBe(0);
+        expect(result.empty).toBe(10);
+        expect(result.color).toBe(SUCCESS_COLOR);
+    });
+    it("renders 50% as 5 filled, 5 empty, yellow", () => {
+        const result = renderUsageDots(50);
+        expect(result.filled).toBe(5);
+        expect(result.empty).toBe(5);
+        expect(result.color).toBe(WARNING_COLOR);
+    });
+    it("renders 80% as 8 filled, 2 empty, red", () => {
+        const result = renderUsageDots(80);
+        expect(result.filled).toBe(8);
+        expect(result.empty).toBe(2);
+        expect(result.color).toBe(ERROR_COLOR);
+    });
+    it("renders 100% as all filled dots, red", () => {
+        const result = renderUsageDots(100);
+        expect(result.filled).toBe(10);
+        expect(result.empty).toBe(0);
+        expect(result.color).toBe(ERROR_COLOR);
+    });
+    it("renders 25% as green", () => {
+        const result = renderUsageDots(25);
+        expect(result.color).toBe(SUCCESS_COLOR);
+    });
+    it("renders 49% as green", () => {
+        const result = renderUsageDots(49);
+        expect(result.color).toBe(SUCCESS_COLOR);
+    });
+    it("renders 79% as yellow", () => {
+        const result = renderUsageDots(79);
+        expect(result.color).toBe(WARNING_COLOR);
+    });
+    it("rounds dot count correctly for 33%", () => {
+        const result = renderUsageDots(33);
+        expect(result.filled).toBe(3);
+        expect(result.empty).toBe(7);
+    });
+    it("rounds dot count correctly for 67%", () => {
+        const result = renderUsageDots(67);
+        expect(result.filled).toBe(7);
+        expect(result.empty).toBe(3);
+    });
+});
+describe("usage period validation", () => {
+    it("validates percentage is between 0 and 100", () => {
+        const period = makeUsagePeriod({ percentage: 42 });
+        expect(period.percentage).toBeGreaterThanOrEqual(0);
+        expect(period.percentage).toBeLessThanOrEqual(100);
+    });
+    it("validates used does not exceed total", () => {
+        const period = makeUsagePeriod({ used: 50, total: 100 });
+        expect(period.used).toBeLessThanOrEqual(period.total);
+    });
+    it("calculates percentage from used/total", () => {
+        const used = 75;
+        const total = 200;
+        const percentage = Math.round((used / total) * 100);
+        expect(percentage).toBe(38);
+    });
+});
+//# sourceMappingURL=useUsageLimits.test.js.map

package/dist/hooks/useUsageLimits.test.js.map

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

package/dist/hooks/useWorktrees.d.ts

@@ -0,0 +1,28 @@
+/**
+ * useWorktrees Hook
+ *
+ * Data provider for worktree list. Fetches worktrees via WebSocket
+ * and enriches with session counts. Used by useSessionsExperiment.
+ */
+import type { WorktreeWithStatus } from "@jacques-ai/core";
+import type { ListWorktreesResult } from "./useJacquesClient.js";
+export interface WorktreeItem extends WorktreeWithStatus {
+    sessionCount: number;
+}
+export interface UseWorktreesParams {
+    listWorktreesWs: (repoRoot: string) => void;
+    listWorktreesResult: ListWorktreesResult | null;
+    sessions: Array<{
+        cwd?: string;
+        git_worktree?: string;
+    }>;
+}
+export interface UseWorktreesReturn {
+    worktrees: WorktreeItem[];
+    repoRoot: string | null;
+    open: (repoRoot: string | null) => void;
+    reset: () => void;
+}
+export declare function validateWorktreeName(name: string): string | null;
+export declare function useWorktrees({ listWorktreesWs, listWorktreesResult, sessions, }: UseWorktreesParams): UseWorktreesReturn;
+//# sourceMappingURL=useWorktrees.d.ts.map

package/dist/hooks/useWorktrees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorktrees.d.ts","sourceRoot":"","sources":["../../src/hooks/useWorktrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,mBAAmB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACxC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,wBAAgB,YAAY,CAAC,EAC3B,eAAe,EACf,mBAAmB,EACnB,QAAQ,GACT,EAAE,kBAAkB,GAAG,kBAAkB,CAyCzC"}

package/dist/hooks/useWorktrees.js

@@ -0,0 +1,57 @@
+/**
+ * useWorktrees Hook
+ *
+ * Data provider for worktree list. Fetches worktrees via WebSocket
+ * and enriches with session counts. Used by useSessionsExperiment.
+ */
+import { useState, useCallback, useEffect } from "react";
+export function validateWorktreeName(name) {
+    if (!name)
+        return "Name cannot be empty";
+    if (!/^[a-zA-Z0-9_-]+$/.test(name))
+        return "Only letters, numbers, hyphens, underscores";
+    if (name.length > 50)
+        return "Name too long (max 50 chars)";
+    return null;
+}
+export function useWorktrees({ listWorktreesWs, listWorktreesResult, sessions, }) {
+    const [worktrees, setWorktrees] = useState([]);
+    const [repoRoot, setRepoRoot] = useState(null);
+    // Handle list_worktrees_result
+    useEffect(() => {
+        if (!listWorktreesResult)
+            return;
+        // Only process results for our own repo (ignore other projects' results)
+        if (listWorktreesResult.repoRoot && repoRoot && listWorktreesResult.repoRoot !== repoRoot)
+            return;
+        if (listWorktreesResult.success && listWorktreesResult.worktrees) {
+            const items = listWorktreesResult.worktrees.map((wt) => {
+                const count = sessions.filter((s) => (s.cwd && (s.cwd === wt.path || s.cwd.startsWith(wt.path + '/'))) || s.git_worktree === wt.name).length;
+                return { ...wt, sessionCount: count };
+            });
+            // Main worktree first, then alphabetical
+            items.sort((a, b) => {
+                if (a.isMain && !b.isMain)
+                    return -1;
+                if (!a.isMain && b.isMain)
+                    return 1;
+                return a.name.localeCompare(b.name);
+            });
+            setWorktrees(items);
+        }
+    }, [listWorktreesResult, sessions]);
+    const open = useCallback((root) => {
+        if (!root) {
+            setRepoRoot(null);
+            setWorktrees([]);
+            return;
+        }
+        setRepoRoot(root);
+        listWorktreesWs(root);
+    }, [listWorktreesWs]);
+    const reset = useCallback(() => {
+        // No-op — keep worktree data across view transitions
+    }, []);
+    return { worktrees, repoRoot, open, reset };
+}
+//# sourceMappingURL=useWorktrees.js.map

package/dist/hooks/useWorktrees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorktrees.js","sourceRoot":"","sources":["../../src/hooks/useWorktrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAqBzD,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,sBAAsB,CAAC;IACzC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,6CAA6C,CAAC;IACzF,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,8BAA8B,CAAC;IAC5D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAC3B,eAAe,EACf,mBAAmB,EACnB,QAAQ,GACW;IACnB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAiB,EAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE9D,+BAA+B;IAC/B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,mBAAmB;YAAE,OAAO;QACjC,yEAAyE;QACzE,IAAI,mBAAmB,CAAC,QAAQ,IAAI,QAAQ,IAAI,mBAAmB,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO;QAClG,IAAI,mBAAmB,CAAC,OAAO,IAAI,mBAAmB,CAAC,SAAS,EAAE,CAAC;YACjE,MAAM,KAAK,GAAmB,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,KAAK,EAAE,CAAC,IAAI,CACvG,CAAC,MAAM,CAAC;gBACT,OAAO,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC;YACH,yCAAyC;YACzC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAClB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM;oBAAE,OAAO,CAAC,CAAC,CAAC;gBACrC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM;oBAAE,OAAO,CAAC,CAAC;gBACpC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;YACH,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEpC,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,IAAmB,EAAE,EAAE;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,eAAe,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAEtB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,qDAAqD;IACvD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC"}

package/dist/hooks/useWorktrees.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * useWorktrees Tests
+ *
+ * Tests validateWorktreeName and worktree data processing logic.
+ */
+export {};
+//# sourceMappingURL=useWorktrees.test.d.ts.map

package/dist/hooks/useWorktrees.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorktrees.test.d.ts","sourceRoot":"","sources":["../../src/hooks/useWorktrees.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/hooks/useWorktrees.test.js

@@ -0,0 +1,119 @@
+/**
+ * useWorktrees Tests
+ *
+ * Tests validateWorktreeName and worktree data processing logic.
+ */
+import { describe, it, expect } from "@jest/globals";
+import { validateWorktreeName } from "./useWorktrees.js";
+describe("validateWorktreeName", () => {
+    it("returns null for valid name with letters", () => {
+        expect(validateWorktreeName("feature")).toBeNull();
+    });
+    it("returns null for valid name with hyphens", () => {
+        expect(validateWorktreeName("my-feature")).toBeNull();
+    });
+    it("returns null for valid name with underscores", () => {
+        expect(validateWorktreeName("my_feature")).toBeNull();
+    });
+    it("returns null for valid name with numbers", () => {
+        expect(validateWorktreeName("feature123")).toBeNull();
+    });
+    it("returns null for valid mixed name", () => {
+        expect(validateWorktreeName("cli-worktrees_v2")).toBeNull();
+    });
+    it("rejects empty string", () => {
+        const result = validateWorktreeName("");
+        expect(result).toBe("Name cannot be empty");
+    });
+    it("rejects names with spaces", () => {
+        const result = validateWorktreeName("my feature");
+        expect(result).toBe("Only letters, numbers, hyphens, underscores");
+    });
+    it("rejects names with dots", () => {
+        const result = validateWorktreeName("my.feature");
+        expect(result).toBe("Only letters, numbers, hyphens, underscores");
+    });
+    it("rejects names with slashes", () => {
+        const result = validateWorktreeName("feature/branch");
+        expect(result).toBe("Only letters, numbers, hyphens, underscores");
+    });
+    it("rejects names with special characters", () => {
+        const result = validateWorktreeName("feat@#$");
+        expect(result).toBe("Only letters, numbers, hyphens, underscores");
+    });
+    it("rejects names longer than 50 characters", () => {
+        const longName = "a".repeat(51);
+        const result = validateWorktreeName(longName);
+        expect(result).toBe("Name too long (max 50 chars)");
+    });
+    it("accepts names exactly 50 characters long", () => {
+        const name = "a".repeat(50);
+        expect(validateWorktreeName(name)).toBeNull();
+    });
+});
+describe("worktree sorting logic", () => {
+    it("sorts main worktree first", () => {
+        const items = [
+            { name: "beta", isMain: false },
+            { name: "alpha", isMain: false },
+            { name: "main", isMain: true },
+        ];
+        items.sort((a, b) => {
+            if (a.isMain && !b.isMain)
+                return -1;
+            if (!a.isMain && b.isMain)
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+        expect(items[0].name).toBe("main");
+        expect(items[1].name).toBe("alpha");
+        expect(items[2].name).toBe("beta");
+    });
+    it("sorts non-main worktrees alphabetically", () => {
+        const items = [
+            { name: "cli-worktrees", isMain: false },
+            { name: "auth-feature", isMain: false },
+            { name: "dashboard", isMain: false },
+        ];
+        items.sort((a, b) => {
+            if (a.isMain && !b.isMain)
+                return -1;
+            if (!a.isMain && b.isMain)
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+        expect(items[0].name).toBe("auth-feature");
+        expect(items[1].name).toBe("cli-worktrees");
+        expect(items[2].name).toBe("dashboard");
+    });
+});
+describe("worktree session counting logic", () => {
+    it("counts sessions matching worktree path", () => {
+        const sessions = [
+            { cwd: "/repo/worktrees/feature/src", git_worktree: undefined },
+            { cwd: "/repo/worktrees/feature", git_worktree: undefined },
+            { cwd: "/repo/main", git_worktree: undefined },
+        ];
+        const wtPath = "/repo/worktrees/feature";
+        const count = sessions.filter((s) => s.cwd?.startsWith(wtPath) || s.git_worktree === "feature").length;
+        expect(count).toBe(2);
+    });
+    it("counts sessions matching worktree name", () => {
+        const sessions = [
+            { cwd: "/other/path", git_worktree: "feature" },
+            { cwd: "/another/path", git_worktree: "main" },
+        ];
+        const wtPath = "/repo/worktrees/feature";
+        const count = sessions.filter((s) => s.cwd?.startsWith(wtPath) || s.git_worktree === "feature").length;
+        expect(count).toBe(1);
+    });
+    it("returns zero when no sessions match", () => {
+        const sessions = [
+            { cwd: "/other/path", git_worktree: "main" },
+        ];
+        const wtPath = "/repo/worktrees/feature";
+        const count = sessions.filter((s) => s.cwd?.startsWith(wtPath) || s.git_worktree === "feature").length;
+        expect(count).toBe(0);
+    });
+});
+//# sourceMappingURL=useWorktrees.test.js.map

package/dist/hooks/useWorktrees.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorktrees.test.js","sourceRoot":"","sources":["../../src/hooks/useWorktrees.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,KAAK,GAAG;YACZ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;YAC/B,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;YAChC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;SAC/B,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAClB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC;YACpC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,KAAK,GAAG;YACZ,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE;YACxC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE;YACvC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE;SACrC,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAClB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC;YACpC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,QAAQ,GAAG;YACf,EAAE,GAAG,EAAE,6BAA6B,EAAE,YAAY,EAAE,SAAS,EAAE;YAC/D,EAAE,GAAG,EAAE,yBAAyB,EAAE,YAAY,EAAE,SAAS,EAAE;YAC3D,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE;SAC/C,CAAC;QACF,MAAM,MAAM,GAAG,yBAAyB,CAAC;QAEzC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,CACjE,CAAC,MAAM,CAAC;QAET,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,QAAQ,GAAG;YACf,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE;YAC/C,EAAE,GAAG,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE;SAC/C,CAAC;QACF,MAAM,MAAM,GAAG,yBAAyB,CAAC;QAEzC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,CACjE,CAAC,MAAM,CAAC;QAET,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,QAAQ,GAAG;YACf,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE;SAC7C,CAAC;QACF,MAAM,MAAM,GAAG,yBAAyB,CAAC;QAEzC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,CACjE,CAAC,MAAM,CAAC;QAET,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/templates/compact-prompt.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Compact Prompt Template
+ *
+ * The prompt to give to Claude to create a handoff document
+ * before context is automatically compacted.
+ */
+export declare const COMPACT_PROMPT = "Please create a comprehensive handoff document for continuing this work in a new session. \nSave it to `.jacques-handoff.md` in the project root.\n\nStructure it as follows:\n\n## Current Task\n[What we're working on and the end goal]\n\n## Progress Made\n[Bullet points of what's been accomplished]\n\n## Key Decisions\n[Important choices made and reasoning]\n\n## Current State\n[Exactly where we left off, any in-progress work]\n\n## Next Steps\n[Prioritized list of what needs to be done next]\n\n## Important Files\n[List of files that were modified or are critical to understand]\n- path/to/file.ts - description of changes/relevance\n\n## Essential Context\n[Any background info, constraints, or gotchas the next session needs to know]\n\nKeep it focused and actionable - this will be my starting context in a fresh session.";
+/**
+ * Get the handoff file path for a given session working directory
+ */
+export declare function getHandoffPath(cwd: string): string;
+/**
+ * Get a formatted version of the prompt for display
+ */
+export declare function getCompactPromptDisplay(): string;
+//# sourceMappingURL=compact-prompt.d.ts.map

package/dist/templates/compact-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-prompt.d.ts","sourceRoot":"","sources":["../../src/templates/compact-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,cAAc,o0BA2B2D,CAAC;AAEvF;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/dist/templates/compact-prompt.js

@@ -0,0 +1,47 @@
+/**
+ * Compact Prompt Template
+ *
+ * The prompt to give to Claude to create a handoff document
+ * before context is automatically compacted.
+ */
+export const COMPACT_PROMPT = `Please create a comprehensive handoff document for continuing this work in a new session. 
+Save it to \`.jacques-handoff.md\` in the project root.
+
+Structure it as follows:
+
+## Current Task
+[What we're working on and the end goal]
+
+## Progress Made
+[Bullet points of what's been accomplished]
+
+## Key Decisions
+[Important choices made and reasoning]
+
+## Current State
+[Exactly where we left off, any in-progress work]
+
+## Next Steps
+[Prioritized list of what needs to be done next]
+
+## Important Files
+[List of files that were modified or are critical to understand]
+- path/to/file.ts - description of changes/relevance
+
+## Essential Context
+[Any background info, constraints, or gotchas the next session needs to know]
+
+Keep it focused and actionable - this will be my starting context in a fresh session.`;
+/**
+ * Get the handoff file path for a given session working directory
+ */
+export function getHandoffPath(cwd) {
+    return `${cwd}/.jacques-handoff.md`;
+}
+/**
+ * Get a formatted version of the prompt for display
+ */
+export function getCompactPromptDisplay() {
+    return COMPACT_PROMPT;
+}
+//# sourceMappingURL=compact-prompt.js.map

package/dist/templates/compact-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-prompt.js","sourceRoot":"","sources":["../../src/templates/compact-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;sFA2BwD,CAAC;AAEvF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,GAAG,sBAAsB,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/templates/context-skill.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Context Skill Template
+ *
+ * Template for the skill file that helps Claude find and use context files.
+ */
+export declare const CONTEXT_SKILL_CONTENT = "# Jacques Context\n\nWhen answering questions, check `.jacques/index.json` for relevant context files.\n\n## How to Use\n\n1. Read `.jacques/index.json` to see available context\n2. If a file's name/description matches the topic, read it from `.jacques/context/`\n3. Use the content to inform your response\n4. Only load files when relevant (token efficiency)\n\n## Index Structure\n\n```json\n{\n  \"files\": [\n    {\n      \"id\": \"unique-id\",\n      \"name\": \"Human-readable name\",\n      \"path\": \".jacques/context/filename.md\",\n      \"source\": \"obsidian\",\n      \"description\": \"Optional description of content\",\n      \"addedAt\": \"ISO timestamp\"\n    }\n  ]\n}\n```\n\n## Best Practices\n\n- Check index first before loading files\n- Match file names/descriptions to user query\n- Load only relevant files to conserve tokens\n- Reference the source when using context\n";
+export declare const CONTEXT_SKILL_FILENAME = "context.skill.md";
+//# sourceMappingURL=context-skill.d.ts.map

package/dist/templates/context-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-skill.d.ts","sourceRoot":"","sources":["../../src/templates/context-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,qBAAqB,s4BAkCjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,qBAAqB,CAAC"}

package/dist/templates/context-skill.js

@@ -0,0 +1,42 @@
+/**
+ * Context Skill Template
+ *
+ * Template for the skill file that helps Claude find and use context files.
+ */
+export const CONTEXT_SKILL_CONTENT = `# Jacques Context
+
+When answering questions, check \`.jacques/index.json\` for relevant context files.
+
+## How to Use
+
+1. Read \`.jacques/index.json\` to see available context
+2. If a file's name/description matches the topic, read it from \`.jacques/context/\`
+3. Use the content to inform your response
+4. Only load files when relevant (token efficiency)
+
+## Index Structure
+
+\`\`\`json
+{
+  "files": [
+    {
+      "id": "unique-id",
+      "name": "Human-readable name",
+      "path": ".jacques/context/filename.md",
+      "source": "obsidian",
+      "description": "Optional description of content",
+      "addedAt": "ISO timestamp"
+    }
+  ]
+}
+\`\`\`
+
+## Best Practices
+
+- Check index first before loading files
+- Match file names/descriptions to user query
+- Load only relevant files to conserve tokens
+- Reference the source when using context
+`;
+export const CONTEXT_SKILL_FILENAME = "context.skill.md";
+//# sourceMappingURL=context-skill.js.map

package/dist/templates/context-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-skill.js","sourceRoot":"","sources":["../../src/templates/context-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCpC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Dashboard Types
+ *
+ * Shared types for the Jacques dashboard client.
+ * Mirrors server types needed by the dashboard.
+ */
+/**
+ * Auto-compact status for Claude Code sessions
+ *
+ * Known Bug (Issue #18264): Even with autoCompact: false, compaction
+ * still triggers at ~78% context usage.
+ */
+export interface AutoCompactStatus {
+    enabled: boolean;
+    threshold: number;
+    bug_threshold: number | null;
+}
+export interface TerminalIdentity {
+    tty: string | null;
+    terminal_pid: number;
+    term_program: string | null;
+    iterm_session_id: string | null;
+    term_session_id: string | null;
+    kitty_window_id: string | null;
+    wezterm_pane: string | null;
+    vscode_injection: string | null;
+    windowid: string | null;
+    term: string | null;
+}
+export interface ContextMetrics {
+    used_percentage: number;
+    remaining_percentage: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    context_window_size: number;
+    total_cost_usd?: number;
+    total_duration_ms?: number;
+    /** True if this is an estimate (not actual from preCompact) */
+    is_estimate?: boolean;
+}
+export interface ModelInfo {
+    id: string;
+    display_name: string;
+}
+export interface WorkspaceInfo {
+    current_dir: string;
+    project_dir: string;
+}
+export type SessionStatus = 'active' | 'working' | 'idle';
+export interface Session {
+    session_id: string;
+    session_title: string | null;
+    transcript_path: string | null;
+    cwd: string;
+    project: string;
+    model: ModelInfo | null;
+    workspace: WorkspaceInfo | null;
+    terminal: TerminalIdentity | null;
+    terminal_key: string;
+    status: SessionStatus;
+    last_activity: number;
+    registered_at: number;
+    context_metrics: ContextMetrics | null;
+    source?: 'startup' | 'resume' | 'clear' | 'compact';
+    autocompact: AutoCompactStatus | null;
+}
+export interface InitialStateMessage {
+    type: 'initial_state';
+    sessions: Session[];
+    focused_session_id: string | null;
+}
+export interface SessionUpdateMessage {
+    type: 'session_update';
+    session: Session;
+}
+export interface SessionRemovedMessage {
+    type: 'session_removed';
+    session_id: string;
+}
+export interface FocusChangedMessage {
+    type: 'focus_changed';
+    session_id: string | null;
+    session: Session | null;
+}
+export interface ServerStatusMessage {
+    type: 'server_status';
+    status: 'connected' | 'disconnected';
+    session_count: number;
+}
+export interface AutoCompactToggledMessage {
+    type: 'autocompact_toggled';
+    enabled: boolean;
+    warning?: string;
+}
+export interface HandoffReadyMessage {
+    type: 'handoff_ready';
+    session_id: string;
+    path: string;
+}
+export interface FocusTerminalResultMessage {
+    type: 'focus_terminal_result';
+    session_id: string;
+    success: boolean;
+    method: string;
+    error?: string;
+}
+export type ServerMessage = InitialStateMessage | SessionUpdateMessage | SessionRemovedMessage | FocusChangedMessage | ServerStatusMessage | AutoCompactToggledMessage | HandoffReadyMessage | FocusTerminalResultMessage;
+export interface SelectSessionRequest {
+    type: 'select_session';
+    session_id: string;
+}
+export interface TriggerActionRequest {
+    type: 'trigger_action';
+    session_id: string;
+    action: 'smart_compact' | 'new_session' | 'save_snapshot';
+    options?: Record<string, unknown>;
+}
+export interface ToggleAutoCompactRequest {
+    type: 'toggle_autocompact';
+    session_id?: string;
+}
+export interface FocusTerminalRequest {
+    type: 'focus_terminal';
+    session_id: string;
+}
+export type ClientMessage = SelectSessionRequest | TriggerActionRequest | ToggleAutoCompactRequest | FocusTerminalRequest;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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