prjct-cli 1.22.0 → 1.24.0

package/core/storage/storage-manager.ts

@@ -1,205 +0,0 @@
-/**
- * Storage Manager Base Class (PRJ-303: SQLite-backed)
- *
- * Write-through pattern:
- * 1. Write to SQLite kv_store (primary)
- * 2. Regenerate MD in context/
- * 3. Publish event for backend sync
- *
- * Read path: cache → SQLite → default
- *
- * Subclasses implement specific data types (state, queue, ideas, shipped).
- */
-
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import { eventBus, type SyncEvent } from '../events'
-import pathManager from '../infrastructure/path-manager'
-import { TTLCache } from '../utils/cache'
-import { getTimestamp } from '../utils/date-helper'
-import { prjctDb } from './database'
-
-export abstract class StorageManager<T> {
-  protected filename: string
-  protected cache: TTLCache<T>
-
-  constructor(filename: string, _schema?: unknown) {
-    this.filename = filename
-    this.cache = new TTLCache<T>({ ttl: 5000, maxSize: 50 })
-  }
-
-  /**
-   * Get the kv_store key for this storage type.
-   * Derived from filename: 'state.json' → 'state'
-   */
-  protected getStoreKey(): string {
-    return this.filename.replace('.json', '')
-  }
-
-  /**
-   * Get file path for context MD
-   * Uses layer-based paths to match MdBaseManager structure
-   */
-  protected getContextPath(projectId: string, mdFilename: string): string {
-    const layer = this.getLayer()
-    return pathManager.getFilePath(projectId, layer, mdFilename)
-  }
-
-  /**
-   * Get the layer for context MD files
-   * Override in subclasses: 'core' | 'planning' | 'progress'
-   */
-  protected abstract getLayer(): string
-
-  /**
-   * Get default data structure
-   */
-  protected abstract getDefault(): T
-
-  /**
-   * Convert data to markdown for Claude
-   */
-  protected abstract toMarkdown(data: T): string
-
-  /**
-   * Get MD filename for context generation
-   */
-  protected abstract getMdFilename(): string
-
-  /**
-   * Get event type for sync
-   */
-  protected abstract getEventType(action: 'update' | 'create' | 'delete'): string
-
-  /**
-   * Read data from storage.
-   * Path: cache → SQLite kv_store → default
-   */
-  async read(projectId: string): Promise<T> {
-    // Check cache first (with expiration)
-    const cached = this.cache.get(projectId)
-    if (cached !== null) {
-      return cached
-    }
-
-    // Try SQLite kv_store (primary store)
-    try {
-      const data = prjctDb.getDoc<T>(projectId, this.getStoreKey())
-      if (data !== null) {
-        this.cache.set(projectId, data)
-        return data
-      }
-    } catch {
-      // SQLite not available (e.g., DB dir doesn't exist yet)
-    }
-
-    return this.getDefault()
-  }
-
-  /**
-   * Write data to storage + regenerate context + publish event.
-   * SQLite primary + MD context regeneration.
-   */
-  async write(projectId: string, data: T): Promise<void> {
-    const contextPath = this.getContextPath(projectId, this.getMdFilename())
-
-    // Ensure context directory exists
-    await fs.mkdir(path.dirname(contextPath), { recursive: true })
-
-    // 1. Write to SQLite kv_store (primary)
-    prjctDb.setDoc(projectId, this.getStoreKey(), data)
-
-    // 2. Regenerate MD for Claude
-    const md = this.toMarkdown(data)
-    await fs.writeFile(contextPath, md, 'utf-8')
-
-    // 3. Update cache
-    this.cache.set(projectId, data)
-
-    // 4. Publish event for backend sync (NOT included in this call - subclass handles)
-  }
-
-  /**
-   * Update data with a transform function
-   */
-  async update(projectId: string, updater: (current: T) => T): Promise<T> {
-    const current = await this.read(projectId)
-    const updated = updater(current)
-    await this.write(projectId, updated)
-    return updated
-  }
-
-  /**
-   * Publish sync event to eventBus
-   */
-  protected async publishEvent(
-    projectId: string,
-    eventType: string,
-    eventData: unknown
-  ): Promise<void> {
-    const event: SyncEvent = {
-      type: eventType,
-      path: [this.filename.replace('.json', '')],
-      data: eventData,
-      timestamp: getTimestamp(),
-      projectId,
-    }
-
-    await eventBus.publish(event)
-  }
-
-  /**
-   * Publish an entity event with automatic type construction
-   * Convenience method that builds event type from entity and action
-   *
-   * @param projectId - Project identifier
-   * @param entity - Entity name (e.g., 'task', 'idea', 'queue', 'feature')
-   * @param action - Action name (e.g., 'started', 'completed', 'created')
-   * @param payload - Event data (timestamp added automatically)
-   */
-  protected async publishEntityEvent(
-    projectId: string,
-    entity: string,
-    action: string,
-    payload: Record<string, unknown>
-  ): Promise<void> {
-    const eventType = `${entity}.${action}`
-    const eventData = {
-      ...payload,
-      timestamp: getTimestamp(),
-    }
-
-    await this.publishEvent(projectId, eventType, eventData)
-  }
-
-  /**
-   * Check if storage exists for this project.
-   */
-  async exists(projectId: string): Promise<boolean> {
-    try {
-      return prjctDb.hasDoc(projectId, this.getStoreKey())
-    } catch {
-      return false
-    }
-  }
-
-  /**
-   * Clear cache for a project
-   */
-  clearCache(projectId?: string): void {
-    if (projectId) {
-      this.cache.delete(projectId)
-    } else {
-      this.cache.clear()
-    }
-  }
-
-  /**
-   * Get cache statistics
-   */
-  getCacheStats(): { size: number; maxSize: number; ttl: number } {
-    return this.cache.stats()
-  }
-}
-
-export default StorageManager

package/core/storage/storage.ts

@@ -1,177 +0,0 @@
-/**
- * Granular Storage (Legacy)
- *
- * OpenCode-style per-entity storage
- * For future per-entity storage: data/{entity}s/{id}.json
- */
-
-import fs from 'node:fs/promises'
-import os from 'node:os'
-import path from 'node:path'
-import { eventBus, inferEventType } from '../events'
-import type { Storage } from '../types'
-import { isNotFoundError } from '../types/fs'
-
-class FileStorage implements Storage {
-  private projectId: string
-  private basePath: string
-
-  constructor(projectId: string) {
-    this.projectId = projectId
-    this.basePath = path.join(os.homedir(), '.prjct-cli/projects', projectId, 'data')
-  }
-
-  /**
-   * Convert path array to file path
-   * ["task", "abc123"] → data/tasks/abc123.json
-   * ["project"] → data/project.json
-   */
-  private pathToFile(pathArray: string[]): string {
-    if (pathArray.length === 1) {
-      return path.join(this.basePath, `${pathArray[0]}.json`)
-    }
-
-    // Pluralize first segment for directory
-    const dir = `${pathArray[0]}s`
-    const rest = pathArray.slice(1)
-    const filename = `${rest.join('/')}.json`
-
-    return path.join(this.basePath, dir, filename)
-  }
-
-  async write<T>(pathArray: string[], data: T): Promise<void> {
-    const filePath = this.pathToFile(pathArray)
-
-    // Ensure directory exists
-    await fs.mkdir(path.dirname(filePath), { recursive: true })
-
-    // Write data
-    await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf-8')
-
-    // Publish event for sync
-    eventBus.publish({
-      type: inferEventType(pathArray, 'write'),
-      path: pathArray,
-      data,
-      timestamp: new Date().toISOString(),
-      projectId: this.projectId,
-    })
-
-    // Update index if it's a collection item
-    if (pathArray.length === 2) {
-      await this.updateIndex(pathArray[0], pathArray[1], 'add')
-    }
-  }
-
-  async read<T>(pathArray: string[]): Promise<T | null> {
-    const filePath = this.pathToFile(pathArray)
-
-    try {
-      const content = await fs.readFile(filePath, 'utf-8')
-      return JSON.parse(content) as T
-    } catch (error) {
-      if (isNotFoundError(error) || error instanceof SyntaxError) {
-        return null
-      }
-      throw error
-    }
-  }
-
-  async list(prefix: string[]): Promise<string[][]> {
-    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', '')])
-    } catch (error) {
-      if (isNotFoundError(error)) {
-        return []
-      }
-      throw error
-    }
-  }
-
-  async delete(pathArray: string[]): Promise<void> {
-    const filePath = this.pathToFile(pathArray)
-
-    try {
-      await fs.unlink(filePath)
-
-      // Publish event for sync
-      eventBus.publish({
-        type: inferEventType(pathArray, 'delete'),
-        path: pathArray,
-        data: null,
-        timestamp: new Date().toISOString(),
-        projectId: this.projectId,
-      })
-
-      // Update index if it's a collection item
-      if (pathArray.length === 2) {
-        await this.updateIndex(pathArray[0], pathArray[1], 'remove')
-      }
-    } catch (error) {
-      // File doesn't exist - ignore
-      if (!isNotFoundError(error)) {
-        throw error
-      }
-    }
-  }
-
-  async exists(pathArray: string[]): Promise<boolean> {
-    const filePath = this.pathToFile(pathArray)
-
-    try {
-      await fs.access(filePath)
-      return true
-    } catch (error) {
-      if (isNotFoundError(error)) {
-        return false
-      }
-      throw error
-    }
-  }
-
-  /**
-   * 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')
-
-    let index: { ids: string[]; updatedAt: string } = { ids: [], updatedAt: '' }
-
-    try {
-      const content = await fs.readFile(indexPath, 'utf-8')
-      index = JSON.parse(content)
-    } catch (error) {
-      // Index doesn't exist yet or is malformed
-      if (!isNotFoundError(error) && !(error instanceof SyntaxError)) {
-        throw error
-      }
-    }
-
-    if (action === 'add' && !index.ids.includes(id)) {
-      index.ids.push(id)
-    } else if (action === 'remove') {
-      index.ids = index.ids.filter((i) => i !== id)
-    }
-
-    index.updatedAt = new Date().toISOString()
-
-    await fs.mkdir(path.dirname(indexPath), { recursive: true })
-    await fs.writeFile(indexPath, JSON.stringify(index, null, 2), 'utf-8')
-  }
-}
-
-/**
- * Get storage instance for a project
- */
-export function getStorage(projectId: string): Storage {
-  return new FileStorage(projectId)
-}

package/core/storage/velocity-storage.ts

@@ -1,149 +0,0 @@
-/**
- * Velocity Storage (PRJ-296)
- *
- * Manages velocity metrics with write-through pattern:
- * - storage/velocity.json → source of truth
- * - context/velocity.md → Claude-readable summary
- *
- * Extends StorageManager for consistency with existing storage classes.
- */
-
-import type { VelocityMetrics } from '../schemas/velocity'
-import { DEFAULT_VELOCITY_METRICS } from '../schemas/velocity'
-import { StorageManager } from './storage-manager'
-
-// =============================================================================
-// Types
-// =============================================================================
-
-interface VelocityStoreData {
-  metrics: VelocityMetrics
-  lastUpdated: string
-}
-
-// =============================================================================
-// Velocity Storage
-// =============================================================================
-
-class VelocityStorage extends StorageManager<VelocityStoreData> {
-  constructor() {
-    super('velocity.json')
-  }
-
-  protected getDefault(): VelocityStoreData {
-    return {
-      metrics: DEFAULT_VELOCITY_METRICS,
-      lastUpdated: '',
-    }
-  }
-
-  protected getMdFilename(): string {
-    return 'velocity.md'
-  }
-
-  protected getLayer(): string {
-    return 'progress'
-  }
-
-  protected getEventType(action: 'update' | 'create' | 'delete'): string {
-    return `velocity.${action}d`
-  }
-
-  protected toMarkdown(data: VelocityStoreData): string {
-    const { metrics } = data
-    const lines = ['# Velocity', '']
-
-    if (metrics.sprints.length === 0) {
-      lines.push('_No velocity data yet. Complete tasks with estimates to build velocity history._')
-      lines.push('')
-      return lines.join('\n')
-    }
-
-    // Summary
-    lines.push(`**Average**: ${metrics.averageVelocity} pts/sprint`)
-    lines.push(`**Trend**: ${formatTrendIcon(metrics.velocityTrend)} ${metrics.velocityTrend}`)
-    lines.push(`**Estimation Accuracy**: ${metrics.estimationAccuracy}%`)
-    lines.push('')
-
-    // Sprint table
-    lines.push('## Sprint History')
-    lines.push('')
-    lines.push('| Sprint | Points | Tasks | Accuracy | Variance |')
-    lines.push('|--------|--------|-------|----------|----------|')
-
-    const recentSprints = metrics.sprints.slice(-6)
-    for (const sprint of recentSprints) {
-      lines.push(
-        `| ${sprint.sprintNumber} | ${sprint.pointsCompleted} | ${sprint.tasksCompleted} | ${sprint.estimationAccuracy}% | ${sprint.avgVariance > 0 ? '+' : ''}${sprint.avgVariance}% |`
-      )
-    }
-    lines.push('')
-
-    // Patterns
-    if (metrics.underEstimated.length > 0 || metrics.overEstimated.length > 0) {
-      lines.push('## Estimation Patterns')
-      lines.push('')
-
-      for (const p of metrics.underEstimated) {
-        lines.push(
-          `- ⚠ **${p.category}**: underestimated by avg ${p.avgVariance}% (${p.taskCount} tasks)`
-        )
-      }
-      for (const p of metrics.overEstimated) {
-        lines.push(
-          `- ✓ **${p.category}**: overestimated by avg ${p.avgVariance}% (${p.taskCount} tasks)`
-        )
-      }
-      lines.push('')
-    }
-
-    return lines.join('\n')
-  }
-
-  // ===========================================================================
-  // Domain Methods
-  // ===========================================================================
-
-  /**
-   * Save computed velocity metrics.
-   */
-  async saveMetrics(projectId: string, metrics: VelocityMetrics): Promise<void> {
-    await this.write(projectId, {
-      metrics,
-      lastUpdated: metrics.lastUpdated,
-    })
-
-    await this.publishEntityEvent(projectId, 'velocity', 'updated', {
-      averageVelocity: metrics.averageVelocity,
-      trend: metrics.velocityTrend,
-      sprintCount: metrics.sprints.length,
-    })
-  }
-
-  /**
-   * Get current velocity metrics.
-   */
-  async getMetrics(projectId: string): Promise<VelocityMetrics> {
-    const data = await this.read(projectId)
-    return data.metrics
-  }
-}
-
-// =============================================================================
-// Helpers
-// =============================================================================
-
-function formatTrendIcon(trend: string): string {
-  switch (trend) {
-    case 'improving':
-      return '↑'
-    case 'declining':
-      return '↓'
-    default:
-      return '→'
-  }
-}
-
-export const velocityStorage = new VelocityStorage()
-export default velocityStorage
-export type { VelocityStoreData }

package/core/sync/auth-config.ts

@@ -1,138 +0,0 @@
-/**
- * Auth Config - Manages API key storage for cloud sync
- *
- * Stores credentials in ~/.prjct-cli/config/auth.json
- * Used by SyncClient to authenticate with prjct API
- */
-
-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'
-
-const DEFAULT_CONFIG: AuthConfig = {
-  apiKey: null,
-  apiUrl: DEFAULT_API_URL,
-  userId: null,
-  email: null,
-  lastAuth: null,
-}
-
-class AuthConfigManager {
-  private configPath: string
-  private cachedConfig: AuthConfig | null = null
-
-  constructor() {
-    this.configPath = pathManager.getAuthConfigPath()
-  }
-
-  /**
-   * Get the auth config file path
-   */
-  getConfigPath(): string {
-    return this.configPath
-  }
-
-  /**
-   * Read auth config from disk
-   */
-  async read(): Promise<AuthConfig> {
-    if (this.cachedConfig) {
-      return this.cachedConfig
-    }
-
-    const config = await fileHelper.readJson<AuthConfig>(this.configPath)
-    this.cachedConfig = config ?? { ...DEFAULT_CONFIG }
-    return this.cachedConfig
-  }
-
-  /**
-   * Write auth config to disk
-   */
-  async write(config: Partial<AuthConfig>): Promise<void> {
-    const current = await this.read()
-    const updated: AuthConfig = {
-      ...current,
-      ...config,
-      lastAuth: new Date().toISOString(),
-    }
-
-    await fileHelper.ensureDir(path.dirname(this.configPath))
-    await fileHelper.writeJson(this.configPath, updated)
-    this.cachedConfig = updated
-  }
-
-  /**
-   * Check if user is authenticated (has valid API key)
-   */
-  async hasAuth(): Promise<boolean> {
-    const config = await this.read()
-    return config.apiKey !== null && config.apiKey.length > 0
-  }
-
-  /**
-   * Get the API key if available
-   */
-  async getApiKey(): Promise<string | null> {
-    const config = await this.read()
-    return config.apiKey
-  }
-
-  /**
-   * Get the API URL (allows override for dev/staging)
-   */
-  async getApiUrl(): Promise<string> {
-    const config = await this.read()
-    return config.apiUrl || DEFAULT_API_URL
-  }
-
-  /**
-   * Save API key and user info after successful auth
-   */
-  async saveAuth(apiKey: string, userId: string, email: string): Promise<void> {
-    await this.write({
-      apiKey,
-      userId,
-      email,
-    })
-  }
-
-  /**
-   * Clear all auth data (logout)
-   */
-  async clearAuth(): Promise<void> {
-    this.cachedConfig = { ...DEFAULT_CONFIG }
-    await fileHelper.writeJson(this.configPath, this.cachedConfig)
-  }
-
-  /**
-   * Get auth status for display
-   */
-  async getStatus(): Promise<{
-    authenticated: boolean
-    email: string | null
-    apiKeyPrefix: string | null
-    lastAuth: string | null
-  }> {
-    const config = await this.read()
-
-    return {
-      authenticated: config.apiKey !== null,
-      email: config.email,
-      apiKeyPrefix: config.apiKey ? `${config.apiKey.substring(0, 12)}...` : null,
-      lastAuth: config.lastAuth,
-    }
-  }
-
-  /**
-   * Clear cache (useful for testing)
-   */
-  clearCache(): void {
-    this.cachedConfig = null
-  }
-}
-
-export const authConfig = new AuthConfigManager()
-export default authConfig

package/core/sync/index.ts

@@ -1,31 +0,0 @@
-/**
- * Sync Module - Cloud synchronization for prjct-cli
- *
- * Provides:
- * - AuthConfig: API key storage and management
- * - SyncClient: HTTP client for prjct API
- * - SyncManager: Orchestrates push/pull operations
- * - OAuthHandler: Authentication flow management
- */
-
-// Re-export types from canonical location
-export type {
-  AuthConfig,
-  AuthResult,
-  PullResult,
-  PushResult,
-  SyncBatchResult,
-  SyncClientError,
-  SyncManagerResult as SyncResult,
-  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'