prjct-cli 0.45.0 → 0.45.4

package/core/storage/state-storage.ts

@@ -5,11 +5,17 @@
  * Generates context/now.md for Claude
  */
 
-import { StorageManager } from './storage-manager'
 import { generateUUID } from '../schemas'
-import { md } from '../utils/markdown-builder'
+import type {
+  CurrentTask,
+  PreviousTask,
+  StateJson,
+  Subtask,
+  SubtaskSummary,
+} from '../schemas/state'
 import { getTimestamp } from '../utils/date-helper'
-import type { StateJson, CurrentTask, PreviousTask, Subtask, SubtaskSummary } from '../schemas/state'
+import { md } from '../utils/markdown-builder'
+import { StorageManager } from './storage-manager'
 
 class StateStorage extends StorageManager<StateJson> {
   constructor() {
@@ -20,7 +26,7 @@ class StateStorage extends StorageManager<StateJson> {
     return {
       currentTask: null,
       previousTask: null,
-      lastUpdated: ''
+      lastUpdated: '',
     }
   }
 
@@ -51,17 +57,26 @@ class StateStorage extends StorageManager<StateJson> {
         if (task.subtasks && task.subtasks.length > 0) {
           m.blank()
             .h2('Subtasks Progress')
-            .raw(`**Progress**: ${task.subtaskProgress?.completed || 0}/${task.subtaskProgress?.total || 0} (${task.subtaskProgress?.percentage || 0}%)`)
+            .raw(
+              `**Progress**: ${task.subtaskProgress?.completed || 0}/${task.subtaskProgress?.total || 0} (${task.subtaskProgress?.percentage || 0}%)`
+            )
             .blank()
             .raw('| # | Domain | Description | Status | Agent |')
             .raw('|---|--------|-------------|--------|-------|')
 
           task.subtasks.forEach((subtask, index) => {
-            const statusIcon = subtask.status === 'completed' ? '✅' :
-                               subtask.status === 'in_progress' ? '▶️' :
-                               subtask.status === 'failed' ? '❌' : '⏳'
+            const statusIcon =
+              subtask.status === 'completed'
+                ? '✅'
+                : subtask.status === 'in_progress'
+                  ? '▶️'
+                  : subtask.status === 'failed'
+                    ? '❌'
+                    : '⏳'
             const isActive = index === task.currentSubtaskIndex ? ' **← Active**' : ''
-            m.raw(`| ${index + 1} | ${subtask.domain} | ${subtask.description} | ${statusIcon} ${subtask.status}${isActive} | ${subtask.agent} |`)
+            m.raw(
+              `| ${index + 1} | ${subtask.domain} | ${subtask.description} | ${statusIcon} ${subtask.status}${isActive} | ${subtask.agent} |`
+            )
           })
 
           // Current subtask details
@@ -80,7 +95,9 @@ class StateStorage extends StorageManager<StateJson> {
           }
 
           // Show last completed subtask summary if available
-          const completedSubtasks = task.subtasks.filter(s => s.status === 'completed' && s.summary)
+          const completedSubtasks = task.subtasks.filter(
+            (s) => s.status === 'completed' && s.summary
+          )
           if (completedSubtasks.length > 0) {
             const lastCompleted = completedSubtasks[completedSubtasks.length - 1]
             if (lastCompleted.summary) {
@@ -124,19 +141,16 @@ class StateStorage extends StorageManager<StateJson> {
   /**
    * Start a new task
    */
-  async startTask(
-    projectId: string,
-    task: Omit<CurrentTask, 'startedAt'>
-  ): Promise<CurrentTask> {
+  async startTask(projectId: string, task: Omit<CurrentTask, 'startedAt'>): Promise<CurrentTask> {
     const currentTask: CurrentTask = {
       ...task,
-      startedAt: getTimestamp()
+      startedAt: getTimestamp(),
     }
 
     await this.update(projectId, (state) => ({
       ...state,
       currentTask,
-      lastUpdated: getTimestamp()
+      lastUpdated: getTimestamp(),
     }))
 
     // Publish incremental event
@@ -144,7 +158,7 @@ class StateStorage extends StorageManager<StateJson> {
       taskId: currentTask.id,
       description: currentTask.description,
       startedAt: currentTask.startedAt,
-      sessionId: currentTask.sessionId
+      sessionId: currentTask.sessionId,
     })
 
     return currentTask
@@ -164,7 +178,7 @@ class StateStorage extends StorageManager<StateJson> {
     await this.update(projectId, () => ({
       currentTask: null,
       previousTask: null,
-      lastUpdated: getTimestamp()
+      lastUpdated: getTimestamp(),
     }))
 
     // Publish incremental event
@@ -172,7 +186,7 @@ class StateStorage extends StorageManager<StateJson> {
       taskId: completedTask.id,
       description: completedTask.description,
       startedAt: completedTask.startedAt,
-      completedAt: getTimestamp()
+      completedAt: getTimestamp(),
     })
 
     return completedTask
@@ -194,13 +208,13 @@ class StateStorage extends StorageManager<StateJson> {
       status: 'paused',
       startedAt: state.currentTask.startedAt,
       pausedAt: getTimestamp(),
-      pauseReason: reason
+      pauseReason: reason,
     }
 
     await this.update(projectId, () => ({
       currentTask: null,
       previousTask,
-      lastUpdated: getTimestamp()
+      lastUpdated: getTimestamp(),
     }))
 
     // Publish incremental event
@@ -208,7 +222,7 @@ class StateStorage extends StorageManager<StateJson> {
       taskId: previousTask.id,
       description: previousTask.description,
       pausedAt: previousTask.pausedAt,
-      reason
+      reason,
     })
 
     return previousTask
@@ -228,20 +242,20 @@ class StateStorage extends StorageManager<StateJson> {
       id: state.previousTask.id,
       description: state.previousTask.description,
       startedAt: getTimestamp(),
-      sessionId: generateUUID()
+      sessionId: generateUUID(),
     }
 
     await this.update(projectId, () => ({
       currentTask,
       previousTask: null,
-      lastUpdated: getTimestamp()
+      lastUpdated: getTimestamp(),
     }))
 
     // Publish incremental event
     await this.publishEvent(projectId, 'task.resumed', {
       taskId: currentTask.id,
       description: currentTask.description,
-      resumedAt: currentTask.startedAt
+      resumedAt: currentTask.startedAt,
     })
 
     return currentTask
@@ -254,7 +268,7 @@ class StateStorage extends StorageManager<StateJson> {
     await this.update(projectId, () => ({
       currentTask: null,
       previousTask: null,
-      lastUpdated: getTimestamp()
+      lastUpdated: getTimestamp(),
     }))
   }
 
@@ -314,7 +328,11 @@ class StateStorage extends StorageManager<StateJson> {
     await this.publishEvent(projectId, 'subtasks.created', {
       taskId: state.currentTask.id,
       subtaskCount: fullSubtasks.length,
-      subtasks: fullSubtasks.map(s => ({ id: s.id, description: s.description, domain: s.domain })),
+      subtasks: fullSubtasks.map((s) => ({
+        id: s.id,
+        description: s.description,
+        domain: s.domain,
+      })),
     })
   }
 
@@ -345,7 +363,7 @@ class StateStorage extends StorageManager<StateJson> {
     }
 
     // Calculate new progress
-    const completed = updatedSubtasks.filter(s => s.status === 'completed').length
+    const completed = updatedSubtasks.filter((s) => s.status === 'completed').length
     const total = updatedSubtasks.length
     const percentage = Math.round((completed / total) * 100)
 
@@ -425,7 +443,9 @@ class StateStorage extends StorageManager<StateJson> {
   /**
    * Get subtask progress
    */
-  async getSubtaskProgress(projectId: string): Promise<{ completed: number; total: number; percentage: number } | null> {
+  async getSubtaskProgress(
+    projectId: string
+  ): Promise<{ completed: number; total: number; percentage: number } | null> {
     const state = await this.read(projectId)
     return state.currentTask?.subtaskProgress || null
   }
@@ -444,7 +464,7 @@ class StateStorage extends StorageManager<StateJson> {
   async areAllSubtasksComplete(projectId: string): Promise<boolean> {
     const state = await this.read(projectId)
     if (!state.currentTask?.subtasks) return true
-    return state.currentTask.subtasks.every(s => s.status === 'completed')
+    return state.currentTask.subtasks.every((s) => s.status === 'completed')
   }
 
   /**

package/core/storage/storage-manager.ts

@@ -9,13 +9,13 @@
  * Subclasses implement specific data types (state, queue, ideas, shipped).
  */
 
-import fs from 'fs/promises'
-import path from 'path'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 import { eventBus, type SyncEvent } from '../events'
-import { getTimestamp } from '../utils/date-helper'
 import pathManager from '../infrastructure/path-manager'
-import { TTLCache } from '../utils/cache'
 import { isNotFoundError } from '../types/fs'
+import { TTLCache } from '../utils/cache'
+import { getTimestamp } from '../utils/date-helper'
 
 export abstract class StorageManager<T> {
   protected filename: string
@@ -143,7 +143,7 @@ export abstract class StorageManager<T> {
       path: [this.filename.replace('.json', '')],
       data: eventData,
       timestamp: getTimestamp(),
-      projectId
+      projectId,
     }
 
     await eventBus.publish(event)
@@ -167,7 +167,7 @@ export abstract class StorageManager<T> {
     const eventType = `${entity}.${action}`
     const eventData = {
       ...payload,
-      timestamp: getTimestamp()
+      timestamp: getTimestamp(),
     }
 
     await this.publishEvent(projectId, eventType, eventData)

package/core/storage/storage.ts

@@ -5,12 +5,12 @@
  * For future per-entity storage: data/{entity}s/{id}.json
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import os from 'os'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
 import { eventBus, inferEventType } from '../events'
-import { isNotFoundError } from '../types/fs'
 import type { Storage } from '../types'
+import { isNotFoundError } from '../types/fs'
 
 class FileStorage implements Storage {
   private projectId: string
@@ -32,9 +32,9 @@ class FileStorage implements Storage {
     }
 
     // Pluralize first segment for directory
-    const dir = pathArray[0] + 's'
+    const dir = `${pathArray[0]}s`
     const rest = pathArray.slice(1)
-    const filename = rest.join('/') + '.json'
+    const filename = `${rest.join('/')}.json`
 
     return path.join(this.basePath, dir, filename)
   }
@@ -54,7 +54,7 @@ class FileStorage implements Storage {
       path: pathArray,
       data,
       timestamp: new Date().toISOString(),
-      projectId: this.projectId
+      projectId: this.projectId,
     })
 
     // Update index if it's a collection item
@@ -78,13 +78,13 @@ class FileStorage implements Storage {
   }
 
   async list(prefix: string[]): Promise<string[][]> {
-    const dir = path.join(this.basePath, prefix[0] + 's')
+    const dir = path.join(this.basePath, `${prefix[0]}s`)
 
     try {
       const files = await fs.readdir(dir)
       return files
-        .filter(f => f.endsWith('.json') && f !== 'index.json')
-        .map(f => [...prefix, f.replace('.json', '')])
+        .filter((f) => f.endsWith('.json') && f !== 'index.json')
+        .map((f) => [...prefix, f.replace('.json', '')])
     } catch (error) {
       if (isNotFoundError(error)) {
         return []
@@ -105,7 +105,7 @@ class FileStorage implements Storage {
         path: pathArray,
         data: null,
         timestamp: new Date().toISOString(),
-        projectId: this.projectId
+        projectId: this.projectId,
       })
 
       // Update index if it's a collection item
@@ -137,8 +137,12 @@ class FileStorage implements Storage {
   /**
    * Update collection index
    */
-  private async updateIndex(collection: string, id: string, action: 'add' | 'remove'): Promise<void> {
-    const indexPath = path.join(this.basePath, collection + 's', 'index.json')
+  private async updateIndex(
+    collection: string,
+    id: string,
+    action: 'add' | 'remove'
+  ): Promise<void> {
+    const indexPath = path.join(this.basePath, `${collection}s`, 'index.json')
 
     let index: { ids: string[]; updatedAt: string } = { ids: [], updatedAt: '' }
 
@@ -155,7 +159,7 @@ class FileStorage implements Storage {
     if (action === 'add' && !index.ids.includes(id)) {
       index.ids.push(id)
     } else if (action === 'remove') {
-      index.ids = index.ids.filter(i => i !== id)
+      index.ids = index.ids.filter((i) => i !== id)
     }
 
     index.updatedAt = new Date().toISOString()
@@ -173,4 +177,3 @@ export function getStorage(projectId: string): Storage {
 }
 
 export default { getStorage }
-

package/core/sync/auth-config.ts

@@ -5,10 +5,10 @@
  * Used by SyncClient to authenticate with prjct API
  */
 
-import path from 'path'
-import * as fileHelper from '../utils/file-helper'
+import path from 'node:path'
 import pathManager from '../infrastructure/path-manager'
 import type { AuthConfig } from '../types'
+import * as fileHelper from '../utils/file-helper'
 
 const DEFAULT_API_URL = 'https://api.prjct.app'
 
@@ -121,7 +121,7 @@ class AuthConfigManager {
     return {
       authenticated: config.apiKey !== null,
       email: config.email,
-      apiKeyPrefix: config.apiKey ? config.apiKey.substring(0, 12) + '...' : null,
+      apiKeyPrefix: config.apiKey ? `${config.apiKey.substring(0, 12)}...` : null,
       lastAuth: config.lastAuth,
     }
   }

package/core/sync/index.ts

@@ -8,30 +8,24 @@
  * - OAuthHandler: Authentication flow management
  */
 
-// Auth
-export { authConfig } from './auth-config'
-
-// OAuth
-export { oauthHandler } from './oauth-handler'
-
-// Client
-export { syncClient } from './sync-client'
-
-// Manager
-export { syncManager } from './sync-manager'
-
-// Default export is the main sync manager
-export { syncManager as default } from './sync-manager'
-
 // Re-export types from canonical location
 export type {
   AuthConfig,
   AuthResult,
+  PullResult,
+  PushResult,
   SyncBatchResult,
-  SyncPullResult,
-  SyncStatus,
   SyncClientError,
   SyncManagerResult as SyncResult,
-  PushResult,
-  PullResult,
+  SyncPullResult,
+  SyncStatus,
 } from '../types'
+// Auth
+export { authConfig } from './auth-config'
+// OAuth
+export { oauthHandler } from './oauth-handler'
+// Client
+export { syncClient } from './sync-client'
+// Manager
+// Default export is the main sync manager
+export { syncManager, syncManager as default } from './sync-manager'

package/core/sync/oauth-handler.ts

@@ -6,9 +6,9 @@
  * 2. Browser (future): Full OAuth device flow
  */
 
+import type { AuthResult } from '../types'
 import { authConfig } from './auth-config'
 import { syncClient } from './sync-client'
-import type { AuthResult } from '../types'
 
 class OAuthHandler {
   /**
@@ -123,8 +123,8 @@ class OAuthHandler {
    * Open URL in default browser
    */
   async openBrowser(url: string): Promise<void> {
-    const { exec } = await import('child_process')
-    const { promisify } = await import('util')
+    const { exec } = await import('node:child_process')
+    const { promisify } = await import('node:util')
     const execAsync = promisify(exec)
 
     const platform = process.platform

package/core/sync/sync-client.ts

@@ -5,14 +5,9 @@
  * Uses native fetch API (available in Node 18+ and Bun).
  */
 
-import authConfig from './auth-config'
 import type { SyncEvent } from '../events'
-import type {
-  SyncBatchResult,
-  SyncPullResult,
-  SyncStatus,
-  SyncClientError,
-} from '../types'
+import type { SyncBatchResult, SyncClientError, SyncPullResult, SyncStatus } from '../types'
+import authConfig from './auth-config'
 
 // ============================================
 // Sync Client
@@ -167,7 +162,7 @@ class SyncClient {
       // Retry on server errors (5xx) but not client errors (4xx)
       if (response.status >= 500 && retryCount < this.retryConfig.maxRetries) {
         const delay = Math.min(
-          this.retryConfig.baseDelayMs * Math.pow(2, retryCount),
+          this.retryConfig.baseDelayMs * 2 ** retryCount,
           this.retryConfig.maxDelayMs
         )
         await this.sleep(delay)
@@ -179,7 +174,7 @@ class SyncClient {
       // Retry on network errors
       if (retryCount < this.retryConfig.maxRetries) {
         const delay = Math.min(
-          this.retryConfig.baseDelayMs * Math.pow(2, retryCount),
+          this.retryConfig.baseDelayMs * 2 ** retryCount,
           this.retryConfig.maxDelayMs
         )
         await this.sleep(delay)

package/core/sync/sync-manager.ts

@@ -5,23 +5,23 @@
  * Handles the coordination between local storage (EventBus) and remote API (SyncClient).
  */
 
-import { syncClient } from './sync-client'
-import authConfig from './auth-config'
-import eventBus, { type SyncEvent } from '../events'
-import { stateStorage } from '../storage/state-storage'
-import { queueStorage } from '../storage/queue-storage'
+import eventBus from '../events'
+import type { IdeaPriority } from '../schemas/ideas'
+import type { Priority, TaskSection, TaskType } from '../schemas/state'
 import { ideasStorage } from '../storage/ideas-storage'
+import { queueStorage } from '../storage/queue-storage'
 import { shippedStorage } from '../storage/shipped-storage'
-import type { TaskType, Priority, TaskSection } from '../schemas/state'
+import { stateStorage } from '../storage/state-storage'
 import type {
-  SyncManagerResult as SyncResult,
-  PushResult,
   PullResult,
+  PushResult,
   SyncBatchResult,
   SyncPullResult,
+  SyncManagerResult as SyncResult,
   SyncStatus,
 } from '../types'
-import type { IdeaPriority } from '../schemas/ideas'
+import authConfig from './auth-config'
+import { syncClient } from './sync-client'
 
 // ============================================
 // Sync Manager
@@ -293,11 +293,9 @@ class SyncManager {
   ): Promise<void> {
     switch (action) {
       case 'created':
-        await ideasStorage.addIdea(
-          projectId,
-          (data.title as string) || (data.text as string),
-          { priority: (data.priority as IdeaPriority) || 'medium' }
-        )
+        await ideasStorage.addIdea(projectId, (data.title as string) || (data.text as string), {
+          priority: (data.priority as IdeaPriority) || 'medium',
+        })
         break
       case 'archived':
         await ideasStorage.update(projectId, (ideas) => ({

package/core/types/commands.ts

@@ -131,6 +131,20 @@ export interface SetupOptions {
   nonInteractive?: boolean
 }
 
+/**
+ * Options for the uninstall command.
+ */
+export interface UninstallOptions {
+  /** Skip confirmation prompt */
+  force?: boolean
+  /** Create backup before deletion */
+  backup?: boolean
+  /** Show what would be deleted without actually deleting */
+  dryRun?: boolean
+  /** Keep the npm/homebrew package, only remove data */
+  keepPackage?: boolean
+}
+
 /**
  * Options for the analyze command.
  */
@@ -213,18 +227,39 @@ export interface HealthResult {
  * Type-safe command method names (for dynamic invocation)
  */
 export type CommandMethodName =
-  | 'work' | 'now' | 'done' | 'next' | 'pause' | 'resume'
-  | 'init' | 'feature' | 'bug' | 'idea' | 'spec'
+  | 'work'
+  | 'now'
+  | 'done'
+  | 'next'
+  | 'pause'
+  | 'resume'
+  | 'init'
+  | 'feature'
+  | 'bug'
+  | 'idea'
+  | 'spec'
   | 'ship'
-  | 'dash' | 'help'
-  | 'cleanup' | 'design' | 'recover' | 'undo' | 'redo' | 'history'
-  | 'analyze' | 'sync'
-  | 'start' | 'setup' | 'migrateAll'
+  | 'dash'
+  | 'help'
+  | 'cleanup'
+  | 'design'
+  | 'recover'
+  | 'undo'
+  | 'redo'
+  | 'history'
+  | 'analyze'
+  | 'sync'
+  | 'start'
+  | 'setup'
+  | 'migrateAll'
 
 /**
  * Function signature for standard command methods
  */
-export type StandardCommandFn = (param: string | null, projectPath?: string) => Promise<CommandResult>
+export type StandardCommandFn = (
+  param: string | null,
+  projectPath?: string
+) => Promise<CommandResult>
 
 // ============================================
 // Registry Types