grov 0.5.2 → 0.5.4

package/dist/lib/store/types.d.ts

@@ -0,0 +1,167 @@
+export type TaskStatus = 'complete' | 'question' | 'partial' | 'abandoned';
+export type TriggerReason = 'complete' | 'threshold' | 'abandoned';
+export interface Task {
+    id: string;
+    project_path: string;
+    user?: string;
+    original_query: string;
+    goal?: string;
+    reasoning_trace: string[];
+    files_touched: string[];
+    decisions: Array<{
+        choice: string;
+        reason: string;
+    }>;
+    constraints: string[];
+    status: TaskStatus;
+    trigger_reason?: TriggerReason;
+    linked_commit?: string;
+    parent_task_id?: string;
+    turn_number?: number;
+    tags: string[];
+    created_at: string;
+    synced_at?: string | null;
+    sync_error?: string | null;
+}
+export interface CreateTaskInput {
+    project_path: string;
+    user?: string;
+    original_query: string;
+    goal?: string;
+    reasoning_trace?: string[];
+    files_touched?: string[];
+    decisions?: Array<{
+        choice: string;
+        reason: string;
+    }>;
+    constraints?: string[];
+    status: TaskStatus;
+    trigger_reason?: TriggerReason;
+    linked_commit?: string;
+    parent_task_id?: string;
+    turn_number?: number;
+    tags?: string[];
+}
+export type SessionStatus = 'active' | 'completed' | 'abandoned';
+export type SessionMode = 'normal' | 'drifted' | 'forced';
+export type TaskType = 'main' | 'subtask' | 'parallel';
+export interface RecoveryPlan {
+    steps: Array<{
+        file?: string;
+        action: string;
+    }>;
+}
+export interface DriftEvent {
+    timestamp: string;
+    score: number;
+    level: string;
+    prompt_summary: string;
+}
+interface SessionStateBase {
+    session_id: string;
+    user_id?: string;
+    project_path: string;
+    original_goal?: string;
+    expected_scope: string[];
+    constraints: string[];
+    keywords: string[];
+    escalation_count: number;
+    last_checked_at: number;
+    start_time: string;
+    last_update: string;
+    status: SessionStatus;
+}
+interface HookFields {
+    success_criteria?: string[];
+    last_drift_score?: number;
+    pending_recovery_plan?: RecoveryPlan;
+    drift_history?: DriftEvent[];
+    actions_taken?: string[];
+    files_explored?: string[];
+    current_intent?: string;
+    drift_warnings?: string[];
+}
+interface ProxyFields {
+    token_count?: number;
+    session_mode?: SessionMode;
+    waiting_for_recovery?: boolean;
+    last_clear_at?: number;
+    completed_at?: string;
+    parent_session_id?: string;
+    task_type?: TaskType;
+    pending_correction?: string;
+    pending_forced_recovery?: string;
+    pending_clear_summary?: string;
+    cached_injection?: string;
+    final_response?: string;
+}
+export interface SessionState extends SessionStateBase, HookFields, ProxyFields {
+}
+export interface CreateSessionStateInput {
+    session_id: string;
+    user_id?: string;
+    project_path: string;
+    original_goal?: string;
+    expected_scope?: string[];
+    constraints?: string[];
+    keywords?: string[];
+    success_criteria?: string[];
+    parent_session_id?: string;
+    task_type?: TaskType;
+}
+export type StepActionType = 'edit' | 'write' | 'bash' | 'read' | 'glob' | 'grep' | 'task' | 'other';
+export type DriftType = 'none' | 'minor' | 'major' | 'critical';
+export type CorrectionLevel = 'nudge' | 'correct' | 'intervene' | 'halt';
+export interface StepRecord {
+    id: string;
+    session_id: string;
+    action_type: StepActionType;
+    files: string[];
+    folders: string[];
+    command?: string;
+    reasoning?: string;
+    drift_score?: number;
+    drift_type?: DriftType;
+    is_key_decision: boolean;
+    is_validated: boolean;
+    correction_given?: string;
+    correction_level?: CorrectionLevel;
+    keywords: string[];
+    timestamp: number;
+}
+export interface CreateStepInput {
+    session_id: string;
+    action_type: StepActionType;
+    files?: string[];
+    folders?: string[];
+    command?: string;
+    reasoning?: string;
+    drift_score?: number;
+    drift_type?: DriftType;
+    is_key_decision?: boolean;
+    is_validated?: boolean;
+    correction_given?: string;
+    correction_level?: CorrectionLevel;
+    keywords?: string[];
+}
+export interface DriftLogEntry {
+    id: string;
+    session_id: string;
+    timestamp: number;
+    action_type?: string;
+    files: string[];
+    drift_score: number;
+    drift_reason?: string;
+    correction_given?: string;
+    recovery_plan?: Record<string, unknown>;
+}
+export interface CreateDriftLogInput {
+    session_id: string;
+    action_type?: string;
+    files?: string[];
+    drift_score: number;
+    drift_reason?: string;
+    correction_given?: string;
+    recovery_plan?: Record<string, unknown>;
+}
+export {};

package/dist/lib/store/types.js

@@ -0,0 +1,2 @@
+// Store types and interfaces
+export {};

package/dist/lib/store.d.ts

@@ -1,436 +1 @@
-import Database from 'better-sqlite3';
-import type { ClaudeAction } from './session-parser.js';
-export type TaskStatus = 'complete' | 'question' | 'partial' | 'abandoned';
-export type TriggerReason = 'complete' | 'threshold' | 'abandoned';
-export interface Task {
-    id: string;
-    project_path: string;
-    user?: string;
-    original_query: string;
-    goal?: string;
-    reasoning_trace: string[];
-    files_touched: string[];
-    decisions: Array<{
-        choice: string;
-        reason: string;
-    }>;
-    constraints: string[];
-    status: TaskStatus;
-    trigger_reason?: TriggerReason;
-    linked_commit?: string;
-    parent_task_id?: string;
-    turn_number?: number;
-    tags: string[];
-    created_at: string;
-    synced_at?: string | null;
-    sync_error?: string | null;
-}
-export interface CreateTaskInput {
-    project_path: string;
-    user?: string;
-    original_query: string;
-    goal?: string;
-    reasoning_trace?: string[];
-    files_touched?: string[];
-    decisions?: Array<{
-        choice: string;
-        reason: string;
-    }>;
-    constraints?: string[];
-    status: TaskStatus;
-    trigger_reason?: TriggerReason;
-    linked_commit?: string;
-    parent_task_id?: string;
-    turn_number?: number;
-    tags?: string[];
-}
-export type SessionStatus = 'active' | 'completed' | 'abandoned';
-export type SessionMode = 'normal' | 'drifted' | 'forced';
-export type TaskType = 'main' | 'subtask' | 'parallel';
-export interface RecoveryPlan {
-    steps: Array<{
-        file?: string;
-        action: string;
-    }>;
-}
-export interface DriftEvent {
-    timestamp: string;
-    score: number;
-    level: string;
-    prompt_summary: string;
-}
-interface SessionStateBase {
-    session_id: string;
-    user_id?: string;
-    project_path: string;
-    original_goal?: string;
-    expected_scope: string[];
-    constraints: string[];
-    keywords: string[];
-    escalation_count: number;
-    last_checked_at: number;
-    start_time: string;
-    last_update: string;
-    status: SessionStatus;
-}
-interface HookFields {
-    success_criteria?: string[];
-    last_drift_score?: number;
-    pending_recovery_plan?: RecoveryPlan;
-    drift_history?: DriftEvent[];
-    actions_taken?: string[];
-    files_explored?: string[];
-    current_intent?: string;
-    drift_warnings?: string[];
-}
-interface ProxyFields {
-    token_count?: number;
-    session_mode?: SessionMode;
-    waiting_for_recovery?: boolean;
-    last_clear_at?: number;
-    completed_at?: string;
-    parent_session_id?: string;
-    task_type?: TaskType;
-    pending_correction?: string;
-    pending_forced_recovery?: string;
-    pending_clear_summary?: string;
-    cached_injection?: string;
-    final_response?: string;
-}
-export interface SessionState extends SessionStateBase, HookFields, ProxyFields {
-}
-export interface CreateSessionStateInput {
-    session_id: string;
-    user_id?: string;
-    project_path: string;
-    original_goal?: string;
-    expected_scope?: string[];
-    constraints?: string[];
-    keywords?: string[];
-    success_criteria?: string[];
-    parent_session_id?: string;
-    task_type?: TaskType;
-}
-export type StepActionType = 'edit' | 'write' | 'bash' | 'read' | 'glob' | 'grep' | 'task' | 'other';
-export type DriftType = 'none' | 'minor' | 'major' | 'critical';
-export type CorrectionLevel = 'nudge' | 'correct' | 'intervene' | 'halt';
-export interface StepRecord {
-    id: string;
-    session_id: string;
-    action_type: StepActionType;
-    files: string[];
-    folders: string[];
-    command?: string;
-    reasoning?: string;
-    drift_score?: number;
-    drift_type?: DriftType;
-    is_key_decision: boolean;
-    is_validated: boolean;
-    correction_given?: string;
-    correction_level?: CorrectionLevel;
-    keywords: string[];
-    timestamp: number;
-}
-export interface CreateStepInput {
-    session_id: string;
-    action_type: StepActionType;
-    files?: string[];
-    folders?: string[];
-    command?: string;
-    reasoning?: string;
-    drift_score?: number;
-    drift_type?: DriftType;
-    is_key_decision?: boolean;
-    is_validated?: boolean;
-    correction_given?: string;
-    correction_level?: CorrectionLevel;
-    keywords?: string[];
-}
-export interface DriftLogEntry {
-    id: string;
-    session_id: string;
-    timestamp: number;
-    action_type?: string;
-    files: string[];
-    drift_score: number;
-    drift_reason?: string;
-    correction_given?: string;
-    recovery_plan?: Record<string, unknown>;
-}
-export interface CreateDriftLogInput {
-    session_id: string;
-    action_type?: string;
-    files?: string[];
-    drift_score: number;
-    drift_reason?: string;
-    correction_given?: string;
-    recovery_plan?: Record<string, unknown>;
-}
-export type ChangeType = 'read' | 'write' | 'edit' | 'create' | 'delete';
-export interface FileReasoning {
-    id: string;
-    task_id?: string;
-    file_path: string;
-    anchor?: string;
-    line_start?: number;
-    line_end?: number;
-    code_hash?: string;
-    change_type?: ChangeType;
-    reasoning: string;
-    created_at: string;
-}
-export interface CreateFileReasoningInput {
-    task_id?: string;
-    file_path: string;
-    anchor?: string;
-    line_start?: number;
-    line_end?: number;
-    code_hash?: string;
-    change_type?: ChangeType;
-    reasoning: string;
-}
-/**
- * Initialize the database connection and create tables
- */
-export declare function initDatabase(): Database.Database;
-/**
- * Close the database connection
- */
-export declare function closeDatabase(): void;
-/**
- * Create a new task
- */
-export declare function createTask(input: CreateTaskInput): Task;
-/**
- * Get tasks for a project
- */
-export declare function getTasksForProject(projectPath: string, options?: {
-    status?: TaskStatus;
-    limit?: number;
-}): Task[];
-export declare function getTasksByFiles(projectPath: string, files: string[], options?: {
-    status?: TaskStatus;
-    limit?: number;
-}): Task[];
-/**
- * Get a task by ID
- */
-export declare function getTaskById(id: string): Task | null;
-/**
- * Update a task's status
- */
-export declare function updateTaskStatus(id: string, status: TaskStatus): void;
-/**
- * Get task count for a project
- */
-export declare function getTaskCount(projectPath: string): number;
-/**
- * Get unsynced tasks for a project (synced_at is NULL)
- */
-export declare function getUnsyncedTasks(projectPath: string, limit?: number): Task[];
-/**
- * Mark a task as synced and clear any previous sync error
- */
-export declare function markTaskSynced(id: string): void;
-/**
- * Record a sync error for a task
- */
-export declare function setTaskSyncError(id: string, error: string): void;
-/**
- * Create a new session state.
- * FIXED: Uses INSERT OR IGNORE to handle race conditions safely.
- */
-export declare function createSessionState(input: CreateSessionStateInput): SessionState;
-/**
- * Get a session state by ID
- */
-export declare function getSessionState(sessionId: string): SessionState | null;
-/**
- * Update a session state.
- * SECURITY: Uses transaction for atomic updates to prevent race conditions.
- */
-export declare function updateSessionState(sessionId: string, updates: Partial<Omit<SessionState, 'session_id' | 'start_time'>>): void;
-/**
- * Delete a session state
- */
-export declare function deleteSessionState(sessionId: string): void;
-/**
- * Get active sessions for a project
- */
-export declare function getActiveSessionsForProject(projectPath: string): SessionState[];
-/**
- * Get child sessions (subtasks and parallel tasks) for a parent session
- */
-export declare function getChildSessions(parentSessionId: string): SessionState[];
-/**
- * Get active session for a specific user in a project
- */
-export declare function getActiveSessionForUser(projectPath: string, userId?: string): SessionState | null;
-/**
- * Get all active sessions (for proxy-status command)
- */
-export declare function getActiveSessionsForStatus(): SessionState[];
-/**
- * Update session drift metrics after a prompt check
- */
-export declare function updateSessionDrift(sessionId: string, driftScore: number, correctionLevel: CorrectionLevel | null, promptSummary: string, recoveryPlan?: RecoveryPlan): void;
-/**
- * Check if a session should be flagged for review
- * Returns true if: status=drifted OR warnings>=3 OR avg_score<6
- */
-export declare function shouldFlagForReview(sessionId: string): boolean;
-/**
- * Get drift summary for a session (used by capture)
- */
-export declare function getDriftSummary(sessionId: string): {
-    totalEvents: number;
-    resolved: boolean;
-    finalScore: number | null;
-    hadHalt: boolean;
-};
-/**
- * Create a new file reasoning entry
- */
-export declare function createFileReasoning(input: CreateFileReasoningInput): FileReasoning;
-/**
- * Get file reasoning entries for a task
- */
-export declare function getFileReasoningForTask(taskId: string): FileReasoning[];
-/**
- * Get file reasoning entries by file path
- */
-export declare function getFileReasoningByPath(filePath: string, limit?: number): FileReasoning[];
-/**
- * Get file reasoning entries matching a pattern (for files in a project).
- * SECURITY: Uses escaped LIKE patterns to prevent injection.
- */
-export declare function getFileReasoningByPathPattern(pathPattern: string, limit?: number): FileReasoning[];
-/**
- * Get the database path
- */
-export declare function getDatabasePath(): string;
-/**
- * Create a new step record (proxy version)
- */
-export declare function createStep(input: CreateStepInput): StepRecord;
-/**
- * Get steps for a session
- */
-export declare function getStepsForSession(sessionId: string, limit?: number): StepRecord[];
-/**
- * Get recent steps for a session (most recent N)
- */
-export declare function getRecentSteps(sessionId: string, count?: number): StepRecord[];
-/**
- * Get validated steps only (for summary generation)
- */
-export declare function getValidatedSteps(sessionId: string): StepRecord[];
-/**
- * Get key decision steps for a session (is_key_decision = 1)
- * Used for user message injection - important decisions with reasoning
- */
-export declare function getKeyDecisions(sessionId: string, limit?: number): StepRecord[];
-/**
- * Get edited files for a session (action_type IN ('edit', 'write'))
- * Used for user message injection - prevent re-work
- */
-export declare function getEditedFiles(sessionId: string): string[];
-/**
- * Delete steps for a session
- */
-export declare function deleteStepsForSession(sessionId: string): void;
-/**
- * Update reasoning for recent steps that don't have reasoning yet
- * Called at end_turn to backfill reasoning from Claude's text response
- */
-export declare function updateRecentStepsReasoning(sessionId: string, reasoning: string, limit?: number): number;
-/**
- * Get relevant steps (key decisions and write/edit actions) - proxy version
- * Reference: plan_proxy_local.md Section 2.2
- */
-export declare function getRelevantStepsSimple(sessionId: string, limit?: number): StepRecord[];
-/**
- * Save a Claude action as a step (hook version - uses ClaudeAction)
- */
-export declare function saveStep(sessionId: string, action: ClaudeAction, driftScore: number, isKeyDecision?: boolean, keywords?: string[]): void;
-/**
- * Update last_checked_at timestamp for a session
- */
-export declare function updateLastChecked(sessionId: string, timestamp: number): void;
-/**
- * Get steps that touched specific files
- */
-export declare function getStepsByFiles(sessionId: string, files: string[], limit?: number): StepRecord[];
-/**
- * Get steps that touched specific folders
- */
-export declare function getStepsByFolders(sessionId: string, folders: string[], limit?: number): StepRecord[];
-/**
- * Get steps matching keywords
- */
-export declare function getStepsByKeywords(sessionId: string, keywords: string[], limit?: number): StepRecord[];
-/**
- * Get key decision steps
- */
-export declare function getKeyDecisionSteps(sessionId: string, limit?: number): StepRecord[];
-/**
- * Get steps reasoning by file path (for proxy team memory injection)
- * Searches across sessions, returns file-level reasoning from steps table
- * @param excludeSessionId - Optional session ID to exclude (for filtering current session)
- */
-export declare function getStepsReasoningByPath(filePath: string, limit?: number, excludeSessionId?: string): Array<{
-    file_path: string;
-    reasoning: string;
-    anchor?: string;
-}>;
-/**
- * Combined retrieval: runs all 4 queries and deduplicates (hook version)
- * Priority: key decisions > files > folders > keywords
- */
-export declare function getRelevantSteps(sessionId: string, currentFiles: string[], currentFolders: string[], keywords: string[], limit?: number): StepRecord[];
-/**
- * Log a drift event (for rejected actions)
- */
-export declare function logDriftEvent(input: CreateDriftLogInput): DriftLogEntry;
-/**
- * Get drift log for a session
- */
-export declare function getDriftLog(sessionId: string, limit?: number): DriftLogEntry[];
-/**
- * Update token count for a session
- */
-export declare function updateTokenCount(sessionId: string, tokenCount: number): void;
-/**
- * Update session mode
- */
-export declare function updateSessionMode(sessionId: string, mode: SessionMode): void;
-/**
- * Mark session as waiting for recovery
- */
-export declare function markWaitingForRecovery(sessionId: string, waiting: boolean): void;
-/**
- * Increment escalation count
- */
-export declare function incrementEscalation(sessionId: string): void;
-/**
- * Update last clear timestamp and reset token count
- */
-export declare function markCleared(sessionId: string): void;
-/**
- * Mark session as completed (instead of deleting)
- * Session will be cleaned up after 1 hour
- */
-export declare function markSessionCompleted(sessionId: string): void;
-/**
- * Cleanup sessions completed more than 24 hours ago
- * Also deletes associated steps and drift_log entries
- * Skips sessions that have active children (RESTRICT approach)
- * Returns number of sessions cleaned up
- */
-export declare function cleanupOldCompletedSessions(maxAgeMs?: number): number;
-/**
- * Get completed session for project (for new_task detection)
- * Returns most recent completed session if exists
- */
-export declare function getCompletedSessionForProject(projectPath: string): SessionState | null;
-export {};
+export * from './store/index.js';