opentasks 0.0.6 → 0.0.7

package/dist/sessionlog/agent/session-types.js

@@ -0,0 +1,50 @@
+/**
+ * Normalized Agent Session Type
+ *
+ * A shared, agent-agnostic representation of a coding session with typed
+ * entries. This provides a uniform interface for cross-agent operations.
+ *
+ * Ported from Go: agent/session.go
+ */
+// ============================================================================
+// Implementation
+// ============================================================================
+export function createAgentSession(agentType, sessionID, entries) {
+    return {
+        agentType,
+        sessionID,
+        entries,
+        getLastUserPrompt() {
+            for (let i = entries.length - 1; i >= 0; i--) {
+                if (entries[i].type === "user" /* EntryType.User */ && entries[i].text) {
+                    return entries[i].text;
+                }
+            }
+            return '';
+        },
+        getUserPrompts() {
+            return entries
+                .filter(e => e.type === "user" /* EntryType.User */ && e.text)
+                .map(e => e.text);
+        },
+        length() {
+            return entries.length;
+        },
+        truncateAtUUID(uuid) {
+            const idx = entries.findIndex(e => e.uuid === uuid);
+            if (idx === -1)
+                return createAgentSession(agentType, sessionID, entries);
+            return createAgentSession(agentType, sessionID, entries.slice(0, idx + 1));
+        },
+        findToolResultByUUID(uuid) {
+            return entries.find(e => e.type === "tool" /* EntryType.Tool */ && e.uuid === uuid);
+        },
+        getEntriesByType(type) {
+            return entries.filter(e => e.type === type);
+        },
+        slice(fromOffset) {
+            return entries.slice(fromOffset);
+        },
+    };
+}
+//# sourceMappingURL=session-types.js.map

package/dist/sessionlog/agent/session-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-types.js","sourceRoot":"","sources":["../../../src/sessionlog/agent/session-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwDH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAChC,SAAoB,EACpB,SAAiB,EACjB,OAAuB;IAEvB,OAAO;QACL,SAAS;QACT,SAAS;QACT,OAAO;QAEP,iBAAiB;YACf,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,gCAAmB,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC1D,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAK,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,cAAc;YACZ,OAAO,OAAO;iBACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,gCAAmB,IAAI,CAAC,CAAC,IAAI,CAAC;iBAChD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC,CAAC;QACvB,CAAC;QAED,MAAM;YACJ,OAAO,OAAO,CAAC,MAAM,CAAC;QACxB,CAAC;QAED,cAAc,CAAC,IAAY;YACzB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACpD,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,OAAO,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACzE,OAAO,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,oBAAoB,CAAC,IAAY;YAC/B,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,gCAAmB,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAClD,CAAC;QACJ,CAAC;QAED,gBAAgB,CAAC,IAAe;YAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,UAAkB;YACtB,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sessionlog/agent/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Agent Types
+ *
+ * Interfaces for AI agent integrations. Each supported agent
+ * (Claude Code, Cursor, Gemini CLI, OpenCode) implements these
+ * interfaces to participate in the Entire session tracking lifecycle.
+ */
+import type { AgentName, AgentType, HookInput, Event, TokenUsage } from '../types.js';
+/**
+ * Agent represents a supported AI coding agent
+ */
+export interface Agent {
+    /** Registry key (e.g., 'claude-code') */
+    readonly name: AgentName;
+    /** Human-readable type (e.g., 'Claude Code') */
+    readonly type: AgentType;
+    /** Description of the agent */
+    readonly description: string;
+    /** Whether this agent integration is in preview */
+    readonly isPreview: boolean;
+    /** Directories that should never be modified/deleted by Entire */
+    readonly protectedDirs: string[];
+    /** Check if this agent is present in the current environment */
+    detectPresence(cwd?: string): Promise<boolean>;
+    /** Get the session directory for this agent */
+    getSessionDir(repoPath: string): Promise<string>;
+    /** Get session ID from hook input */
+    getSessionID(input: HookInput): string;
+    /** Resolve transcript file path */
+    resolveSessionFile(sessionDir: string, agentSessionID: string): string;
+    /** Read the raw transcript for a session */
+    readTranscript(sessionRef: string): Promise<Buffer>;
+    /** Format a resume command for the user */
+    formatResumeCommand(sessionID: string): string;
+}
+/**
+ * Agent supports lifecycle hooks
+ */
+export interface HookSupport {
+    /** Hook names this agent supports */
+    hookNames(): string[];
+    /** Parse a hook event from stdin */
+    parseHookEvent(hookName: string, stdin: string): Event | null;
+    /** Install hooks for this agent in a repo */
+    installHooks(repoPath: string, force?: boolean): Promise<number>;
+    /** Remove hooks for this agent from a repo */
+    uninstallHooks(repoPath: string): Promise<void>;
+    /** Check if hooks are installed */
+    areHooksInstalled(repoPath: string): Promise<boolean>;
+}
+/**
+ * Agent supports file watching for session changes
+ */
+export interface FileWatcher {
+    /** Get paths to watch for changes */
+    getWatchPaths(repoPath: string): Promise<string[]>;
+    /** Handle a file change event */
+    onFileChange(filePath: string): Promise<SessionChangeEvent | null>;
+}
+/**
+ * Agent supports transcript analysis
+ */
+export interface TranscriptAnalyzer {
+    /** Get current position in the transcript */
+    getTranscriptPosition(transcriptPath: string): Promise<number>;
+    /** Extract modified files from a transcript segment */
+    extractModifiedFilesFromOffset(transcriptPath: string, startOffset: number): Promise<{
+        files: string[];
+        currentPosition: number;
+    }>;
+    /** Extract user prompts from a transcript segment */
+    extractPrompts(sessionRef: string, fromOffset: number): Promise<string[]>;
+    /** Extract a summary from the transcript */
+    extractSummary(sessionRef: string): Promise<string>;
+}
+/**
+ * Agent supports token usage calculation
+ */
+export interface TokenCalculator {
+    /** Calculate token usage from a transcript segment */
+    calculateTokenUsage(transcriptData: Buffer, fromOffset: number): Promise<TokenUsage>;
+}
+/**
+ * Agent supports transcript preparation (e.g., waiting for async flush).
+ *
+ * Some agents write transcripts asynchronously. Before reading the transcript
+ * for checkpoint creation, the agent can wait for a flush sentinel to ensure
+ * the transcript is complete.
+ */
+export interface TranscriptPreparer {
+    /** Wait for the transcript to be fully flushed before reading */
+    prepareTranscript(sessionRef: string): Promise<void>;
+}
+/**
+ * Agent supports subagent-aware extraction (e.g., Claude Code's Task tool).
+ * Aggregates files and tokens from both the main session and spawned subagents.
+ */
+export interface SubagentAwareExtractor {
+    /** Extract files modified by both the main agent and any spawned subagents */
+    extractAllModifiedFiles(transcriptData: Buffer, fromOffset: number, subagentsDir: string): Promise<string[]>;
+    /** Calculate token usage including all spawned subagents */
+    calculateTotalTokenUsage(transcriptData: Buffer, fromOffset: number, subagentsDir: string): Promise<TokenUsage>;
+}
+/**
+ * Agent supports transcript chunking for storage
+ */
+export interface TranscriptChunker {
+    /** Split a transcript into storage-safe chunks */
+    chunkTranscript(content: Buffer, maxSize: number): Promise<Buffer[]>;
+    /** Reassemble chunked transcripts */
+    reassembleTranscript(chunks: Buffer[]): Promise<Buffer>;
+}
+export interface SessionChangeEvent {
+    sessionID: string;
+    sessionRef: string;
+    eventType: string;
+    timestamp: Date;
+}
+export declare function hasHookSupport(agent: Agent): agent is Agent & HookSupport;
+export declare function hasFileWatcher(agent: Agent): agent is Agent & FileWatcher;
+export declare function hasTranscriptAnalyzer(agent: Agent): agent is Agent & TranscriptAnalyzer;
+export declare function hasTokenCalculator(agent: Agent): agent is Agent & TokenCalculator;
+export declare function hasTranscriptPreparer(agent: Agent): agent is Agent & TranscriptPreparer;
+export declare function hasSubagentAwareExtractor(agent: Agent): agent is Agent & SubagentAwareExtractor;
+export declare function hasTranscriptChunker(agent: Agent): agent is Agent & TranscriptChunker;
+//# sourceMappingURL=types.d.ts.map

package/dist/sessionlog/agent/types.d.ts.map

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

package/dist/sessionlog/agent/types.js

@@ -0,0 +1,39 @@
+/**
+ * Agent Types
+ *
+ * Interfaces for AI agent integrations. Each supported agent
+ * (Claude Code, Cursor, Gemini CLI, OpenCode) implements these
+ * interfaces to participate in the Entire session tracking lifecycle.
+ */
+// ============================================================================
+// Type Guards
+// ============================================================================
+export function hasHookSupport(agent) {
+    return 'hookNames' in agent && typeof agent.hookNames === 'function';
+}
+export function hasFileWatcher(agent) {
+    return 'getWatchPaths' in agent && typeof agent.getWatchPaths === 'function';
+}
+export function hasTranscriptAnalyzer(agent) {
+    return ('getTranscriptPosition' in agent &&
+        typeof agent.getTranscriptPosition === 'function');
+}
+export function hasTokenCalculator(agent) {
+    return ('calculateTokenUsage' in agent &&
+        typeof agent.calculateTokenUsage === 'function');
+}
+export function hasTranscriptPreparer(agent) {
+    return ('prepareTranscript' in agent &&
+        typeof agent.prepareTranscript === 'function');
+}
+export function hasSubagentAwareExtractor(agent) {
+    return ('extractAllModifiedFiles' in agent &&
+        typeof agent.extractAllModifiedFiles === 'function' &&
+        'calculateTotalTokenUsage' in agent &&
+        typeof agent.calculateTotalTokenUsage === 'function');
+}
+export function hasTranscriptChunker(agent) {
+    return ('chunkTranscript' in agent &&
+        typeof agent.chunkTranscript === 'function');
+}
+//# sourceMappingURL=types.js.map

package/dist/sessionlog/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sessionlog/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmKH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,OAAO,WAAW,IAAI,KAAK,IAAI,OAAQ,KAAgC,CAAC,SAAS,KAAK,UAAU,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,OAAO,eAAe,IAAI,KAAK,IAAI,OAAQ,KAAgC,CAAC,aAAa,KAAK,UAAU,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAY;IAChD,OAAO,CACL,uBAAuB,IAAI,KAAK;QAChC,OAAQ,KAAuC,CAAC,qBAAqB,KAAK,UAAU,CACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,OAAO,CACL,qBAAqB,IAAI,KAAK;QAC9B,OAAQ,KAAoC,CAAC,mBAAmB,KAAK,UAAU,CAChF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAY;IAChD,OAAO,CACL,mBAAmB,IAAI,KAAK;QAC5B,OAAQ,KAAuC,CAAC,iBAAiB,KAAK,UAAU,CACjF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAY;IACpD,OAAO,CACL,yBAAyB,IAAI,KAAK;QAClC,OAAQ,KAA2C,CAAC,uBAAuB,KAAK,UAAU;QAC1F,0BAA0B,IAAI,KAAK;QACnC,OAAQ,KAA2C,CAAC,wBAAwB,KAAK,UAAU,CAC5F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAC/C,OAAO,CACL,iBAAiB,IAAI,KAAK;QAC1B,OAAQ,KAAsC,CAAC,eAAe,KAAK,UAAU,CAC9E,CAAC;AACJ,CAAC"}

package/dist/sessionlog/commands/clean.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Clean Command
+ *
+ * Removes orphaned Entire data: shadow branches, stale session files,
+ * and temporary files that are no longer referenced.
+ */
+export interface CleanupItem {
+    type: 'shadow-branch' | 'session-file' | 'temp-file';
+    path: string;
+    reason: string;
+}
+export interface CleanResult {
+    items: CleanupItem[];
+    deletedCount: number;
+    errors: string[];
+}
+export interface CleanOptions {
+    cwd?: string;
+    /** Actually delete (default: preview only) */
+    force?: boolean;
+    /** Session directory name under .git/ */
+    sessionDirName?: string;
+    /** Git branch for committed checkpoints */
+    checkpointsBranch?: string;
+    /** Prefix for shadow branches */
+    shadowBranchPrefix?: string;
+}
+/**
+ * Find orphaned items
+ */
+export declare function findOrphaned(cwd?: string, options?: {
+    sessionDirName?: string;
+    checkpointsBranch?: string;
+    shadowBranchPrefix?: string;
+}): Promise<CleanupItem[]>;
+/**
+ * Clean orphaned items
+ */
+export declare function clean(options?: CleanOptions): Promise<CleanResult>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/sessionlog/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/commands/clean.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,GAAG,cAAc,GAAG,WAAW,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7F,OAAO,CAAC,WAAW,EAAE,CAAC,CA2DxB;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiC5E"}

package/dist/sessionlog/commands/clean.js

@@ -0,0 +1,105 @@
+/**
+ * Clean Command
+ *
+ * Removes orphaned Entire data: shadow branches, stale session files,
+ * and temporary files that are no longer referenced.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ENTIRE_TMP_DIR, SHADOW_BRANCH_PREFIX, CHECKPOINTS_BRANCH } from '../types.js';
+import { getWorktreeRoot, listBranches, deleteBranch } from '../git-operations.js';
+import { createSessionStore } from '../store/session-store.js';
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Find orphaned items
+ */
+export async function findOrphaned(cwd, options) {
+    const items = [];
+    const resolvedShadowPrefix = options?.shadowBranchPrefix ?? SHADOW_BRANCH_PREFIX;
+    const resolvedCheckpointsBranch = options?.checkpointsBranch ?? CHECKPOINTS_BRANCH;
+    const sessionStore = createSessionStore(cwd, options?.sessionDirName);
+    const sessions = await sessionStore.list();
+    const activeSessionIDs = new Set(sessions.map((s) => s.sessionID));
+    const activeBaseCommits = new Set(sessions.map((s) => s.baseCommit).filter(Boolean));
+    // 1. Orphaned shadow branches
+    const branches = await listBranches(`${resolvedShadowPrefix}*`, cwd);
+    for (const branch of branches) {
+        if (branch === resolvedCheckpointsBranch)
+            continue;
+        // Extract base commit from branch name
+        const hashPart = branch.slice(resolvedShadowPrefix.length);
+        const baseCommit = hashPart.split('-')[0];
+        // A shadow branch is orphaned if no active session references its base commit
+        if (!activeBaseCommits.has(baseCommit)) {
+            // Check against full base commits (the hash part is a short hash)
+            const isReferenced = sessions.some((s) => s.baseCommit && s.baseCommit.startsWith(baseCommit));
+            if (!isReferenced) {
+                items.push({
+                    type: 'shadow-branch',
+                    path: branch,
+                    reason: 'No active session references this branch',
+                });
+            }
+        }
+    }
+    // 2. Orphaned temp files
+    try {
+        const root = await getWorktreeRoot(cwd);
+        const tmpDir = path.join(root, ENTIRE_TMP_DIR);
+        const files = await fs.promises.readdir(tmpDir).catch(() => []);
+        for (const file of files) {
+            const filePath = path.join(tmpDir, file);
+            const stat = await fs.promises.stat(filePath);
+            // Consider temp files older than 24 hours as orphaned
+            if (Date.now() - stat.mtimeMs > 24 * 60 * 60 * 1000) {
+                items.push({
+                    type: 'temp-file',
+                    path: filePath,
+                    reason: 'Temporary file older than 24 hours',
+                });
+            }
+        }
+    }
+    catch {
+        // Temp dir may not exist
+    }
+    return items;
+}
+/**
+ * Clean orphaned items
+ */
+export async function clean(options = {}) {
+    const cwd = options.cwd;
+    const items = await findOrphaned(cwd, {
+        sessionDirName: options.sessionDirName,
+        checkpointsBranch: options.checkpointsBranch,
+        shadowBranchPrefix: options.shadowBranchPrefix,
+    });
+    const errors = [];
+    let deletedCount = 0;
+    if (!options.force) {
+        return { items, deletedCount: 0, errors: [] };
+    }
+    for (const item of items) {
+        try {
+            switch (item.type) {
+                case 'shadow-branch':
+                    await deleteBranch(item.path, true, cwd);
+                    deletedCount++;
+                    break;
+                case 'session-file':
+                case 'temp-file':
+                    await fs.promises.unlink(item.path);
+                    deletedCount++;
+                    break;
+            }
+        }
+        catch (e) {
+            errors.push(`Failed to delete ${item.path}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return { items, deletedCount, errors };
+}
+//# sourceMappingURL=clean.js.map

package/dist/sessionlog/commands/clean.js.map

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

package/dist/sessionlog/commands/disable.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Disable Command
+ *
+ * Disables Entire in a repository. Can optionally fully uninstall
+ * hooks and clean up all Entire data.
+ */
+export interface DisableOptions {
+    cwd?: string;
+    /** Fully uninstall hooks (not just disable) */
+    uninstall?: boolean;
+    /** Disable in local settings instead of project settings */
+    local?: boolean;
+}
+export interface DisableResult {
+    disabled: boolean;
+    uninstalled: boolean;
+    errors: string[];
+}
+/**
+ * Disable Entire in a repository
+ */
+export declare function disable(options?: DisableOptions): Promise<DisableResult>;
+//# sourceMappingURL=disable.d.ts.map

package/dist/sessionlog/commands/disable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/commands/disable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CA6ClF"}

package/dist/sessionlog/commands/disable.js

@@ -0,0 +1,57 @@
+/**
+ * Disable Command
+ *
+ * Disables Entire in a repository. Can optionally fully uninstall
+ * hooks and clean up all Entire data.
+ */
+import { getWorktreeRoot, isGitRepository } from '../git-operations.js';
+import { saveProjectSettings, saveLocalSettings } from '../config.js';
+import { uninstallGitHooks } from '../hooks/git-hooks.js';
+import { detectAgents } from '../agent/registry.js';
+import { hasHookSupport } from '../agent/types.js';
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Disable Entire in a repository
+ */
+export async function disable(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const errors = [];
+    if (!(await isGitRepository(cwd))) {
+        return { disabled: false, uninstalled: false, errors: ['Not a git repository'] };
+    }
+    const root = await getWorktreeRoot(cwd);
+    // Update settings
+    if (options.local) {
+        await saveLocalSettings({ enabled: false }, cwd);
+    }
+    else {
+        await saveProjectSettings({ enabled: false }, cwd);
+    }
+    let uninstalled = false;
+    if (options.uninstall) {
+        // Remove git hooks
+        try {
+            await uninstallGitHooks(root);
+        }
+        catch (e) {
+            errors.push(`Failed to uninstall git hooks: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        // Remove agent hooks
+        const agents = await detectAgents(cwd);
+        for (const agent of agents) {
+            if (hasHookSupport(agent)) {
+                try {
+                    await agent.uninstallHooks(root);
+                }
+                catch (e) {
+                    errors.push(`Failed to uninstall ${agent.name} hooks: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+        }
+        uninstalled = true;
+    }
+    return { disabled: true, uninstalled, errors };
+}
+//# sourceMappingURL=disable.js.map

package/dist/sessionlog/commands/disable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.js","sourceRoot":"","sources":["../../../src/sessionlog/commands/disable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAA4B,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAoBnD,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,UAA0B,EAAE;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC;IACnF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAExC,kBAAkB;IAClB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,iBAAiB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,MAAM,mBAAmB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,mBAAmB;QACnB,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,qBAAqB;QACrB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBACnC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC,IAAI,CACT,uBAAuB,KAAK,CAAC,IAAI,WAAW,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACzF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AACjD,CAAC"}

package/dist/sessionlog/commands/doctor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Doctor Command
+ *
+ * Identifies and fixes stuck sessions. A session is "stuck" if it's
+ * in ACTIVE phase with no recent interaction, or in ENDED phase with
+ * uncondensed checkpoint data.
+ */
+import type { SessionState } from '../types.js';
+export interface StuckSession {
+    sessionID: string;
+    reason: 'active-stale' | 'ended-uncondensed';
+    session: SessionState;
+    hasShadowBranch: boolean;
+    canCondense: boolean;
+}
+export interface DoctorResult {
+    stuckSessions: StuckSession[];
+    fixedCount: number;
+    discardedCount: number;
+    errors: string[];
+}
+export interface DoctorOptions {
+    cwd?: string;
+    /** Auto-fix without prompting */
+    force?: boolean;
+    /** Stale threshold in milliseconds (default: 1 hour) */
+    staleThresholdMs?: number;
+}
+/**
+ * Diagnose stuck sessions
+ */
+export declare function diagnose(options?: DoctorOptions): Promise<StuckSession[]>;
+/**
+ * Discard a stuck session (delete state + shadow branch)
+ */
+export declare function discardSession(sessionID: string, options?: {
+    cwd?: string;
+}): Promise<void>;
+/**
+ * Run doctor with auto-fix
+ */
+export declare function doctor(options?: DoctorOptions): Promise<DoctorResult>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/sessionlog/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAAC;IAC7C,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAoDnF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAqB/E"}

package/dist/sessionlog/commands/doctor.js

@@ -0,0 +1,97 @@
+/**
+ * Doctor Command
+ *
+ * Identifies and fixes stuck sessions. A session is "stuck" if it's
+ * in ACTIVE phase with no recent interaction, or in ENDED phase with
+ * uncondensed checkpoint data.
+ */
+import { createSessionStore } from '../store/session-store.js';
+import { createCheckpointStore } from '../store/checkpoint-store.js';
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Diagnose stuck sessions
+ */
+export async function diagnose(options = {}) {
+    const cwd = options.cwd;
+    const staleThreshold = options.staleThresholdMs ?? 60 * 60 * 1000; // 1 hour
+    const sessionStore = createSessionStore(cwd);
+    const checkpointStore = createCheckpointStore(cwd);
+    const sessions = await sessionStore.list();
+    const temporaryBranches = await checkpointStore.listTemporary();
+    const stuck = [];
+    for (const session of sessions) {
+        // Check for active stale sessions
+        if (session.phase === 'active') {
+            const lastInteraction = session.lastInteractionTime
+                ? new Date(session.lastInteractionTime).getTime()
+                : new Date(session.startedAt).getTime();
+            if (Date.now() - lastInteraction > staleThreshold) {
+                const hasShadow = temporaryBranches.some((b) => b.sessionID === session.sessionID);
+                stuck.push({
+                    sessionID: session.sessionID,
+                    reason: 'active-stale',
+                    session,
+                    hasShadowBranch: hasShadow,
+                    canCondense: hasShadow && session.filesTouched.length > 0,
+                });
+            }
+        }
+        // Check for ended sessions with uncondensed data
+        if (session.phase === 'ended') {
+            const hasShadow = temporaryBranches.some((b) => b.sessionID === session.sessionID);
+            if (hasShadow) {
+                stuck.push({
+                    sessionID: session.sessionID,
+                    reason: 'ended-uncondensed',
+                    session,
+                    hasShadowBranch: true,
+                    canCondense: session.filesTouched.length > 0,
+                });
+            }
+        }
+    }
+    return stuck;
+}
+/**
+ * Discard a stuck session (delete state + shadow branch)
+ */
+export async function discardSession(sessionID, options = {}) {
+    const cwd = options.cwd;
+    const sessionStore = createSessionStore(cwd);
+    const checkpointStore = createCheckpointStore(cwd);
+    const session = await sessionStore.load(sessionID);
+    if (!session)
+        return;
+    // Delete shadow branch if it exists
+    if (session.baseCommit) {
+        const branchName = checkpointStore.getShadowBranchName(session.baseCommit, session.worktreeID);
+        await checkpointStore.deleteShadowBranch(branchName);
+    }
+    // Delete session state
+    await sessionStore.delete(sessionID);
+}
+/**
+ * Run doctor with auto-fix
+ */
+export async function doctor(options = {}) {
+    const stuck = await diagnose(options);
+    const errors = [];
+    let fixedCount = 0;
+    let discardedCount = 0;
+    if (options.force) {
+        for (const s of stuck) {
+            try {
+                // For now, discard all stuck sessions
+                await discardSession(s.sessionID, { cwd: options.cwd });
+                discardedCount++;
+            }
+            catch (e) {
+                errors.push(`Failed to fix session ${s.sessionID}: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    }
+    return { stuckSessions: stuck, fixedCount, discardedCount, errors };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/sessionlog/commands/doctor.js.map

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