prjct-cli 0.20.0 → 0.21.0

package/core/types/storage.ts

@@ -0,0 +1,148 @@
+/**
+ * Storage Types
+ * Types for data persistence layer.
+ */
+
+// =============================================================================
+// Core Storage Interface
+// =============================================================================
+
+/**
+ * Generic storage interface for granular data access
+ */
+export interface Storage {
+  write<T>(path: string[], data: T): Promise<void>
+  read<T>(path: string[]): Promise<T | null>
+  list(prefix: string[]): Promise<string[][]>
+  delete(path: string[]): Promise<void>
+  exists(path: string[]): Promise<boolean>
+}
+
+// =============================================================================
+// Shipped Storage Types
+// =============================================================================
+
+/**
+ * Shipped feature record (simple version used by shipped-storage.ts)
+ */
+export interface ShippedFeature {
+  id: string
+  name: string
+  shippedAt: string
+  version: string
+  description?: string
+  tasks?: string[]
+  duration?: string
+  type?: 'feature' | 'fix' | 'improvement' | 'refactor'
+  agent?: string
+  changes?: ShipChange[]
+  codeSnippets?: string[]
+  commit?: CommitInfo
+  codeMetrics?: CodeMetrics
+  qualityMetrics?: QualityMetrics
+  quantitativeImpact?: string
+  tasksCompleted?: number
+  featureId?: string
+}
+
+export interface ShipChange {
+  description: string
+  type: 'added' | 'changed' | 'fixed' | 'removed'
+}
+
+export interface CommitInfo {
+  hash: string
+  message: string
+  branch: string
+}
+
+export interface CodeMetrics {
+  filesChanged: number
+  linesAdded: number
+  linesRemoved: number
+  commits: number
+}
+
+export interface QualityMetrics {
+  lintStatus: 'pass' | 'warning' | 'fail' | 'skipped'
+  lintDetails?: string
+  testStatus: 'pass' | 'warning' | 'fail' | 'skipped'
+  testDetails?: string
+}
+
+export interface Duration {
+  hours: number
+  minutes: number
+  totalMinutes: number
+}
+
+/**
+ * Shipped items collection
+ */
+export interface ShippedJson {
+  shipped: ShippedFeature[]
+  lastUpdated: string
+}
+
+// =============================================================================
+// Ideas Storage Types
+// =============================================================================
+
+export type IdeaStatus = 'pending' | 'converted' | 'completed' | 'archived'
+export type IdeaPriority = 'low' | 'medium' | 'high'
+
+/**
+ * Idea record
+ */
+export interface Idea {
+  id: string
+  text: string
+  status: IdeaStatus
+  priority: IdeaPriority
+  tags: string[]
+  addedAt: string
+  convertedTo?: string
+  details?: string
+  painPoints?: string[]
+  solutions?: string[]
+  filesAffected?: string[]
+  impactEffort?: ImpactEffort
+  stack?: TechStack
+  modules?: IdeaModule[]
+  roles?: IdeaRole[]
+  risks?: string[]
+  risksCount?: number
+  createdAt?: string
+}
+
+export interface ImpactEffort {
+  impact: 'high' | 'medium' | 'low'
+  effort: 'high' | 'medium' | 'low'
+}
+
+export interface TechStack {
+  frontend?: string
+  backend?: string
+  payments?: string
+  ai?: string
+  deploy?: string
+  other?: string[]
+}
+
+export interface IdeaModule {
+  name: string
+  description: string
+}
+
+export interface IdeaRole {
+  name: string
+  description: string
+}
+
+/**
+ * Ideas collection
+ */
+export interface IdeasJson {
+  ideas: Idea[]
+  lastUpdated: string
+}

package/core/types/sync.ts

@@ -0,0 +1,121 @@
+/**
+ * Sync Types
+ * Types for sync and cloud modules.
+ */
+
+// =============================================================================
+// OAuth Types
+// =============================================================================
+
+/**
+ * Result of an authentication attempt
+ */
+export interface AuthResult {
+  success: boolean
+  email?: string
+  error?: string
+}
+
+/**
+ * Authentication configuration stored in ~/.prjct-cli/config/auth.json
+ */
+export interface AuthConfig {
+  apiKey: string | null
+  apiUrl: string
+  userId: string | null
+  email: string | null
+  lastAuth: string | null
+}
+
+// =============================================================================
+// Sync Manager Types
+// =============================================================================
+
+/**
+ * Result of a full sync operation (push + pull)
+ */
+export interface SyncManagerResult {
+  success: boolean
+  skipped: boolean
+  reason?: 'no_auth' | 'no_pending' | 'error'
+  pushed?: {
+    count: number
+    syncedAt: string
+  }
+  pulled?: {
+    count: number
+    syncedAt: string
+  }
+  error?: string
+}
+
+/**
+ * Result of pushing events to the server
+ */
+export interface PushResult {
+  success: boolean
+  skipped: boolean
+  reason?: 'no_auth' | 'no_pending' | 'error'
+  count?: number
+  syncedAt?: string
+  error?: string
+}
+
+/**
+ * Result of pulling events from the server
+ */
+export interface PullResult {
+  success: boolean
+  skipped: boolean
+  reason?: 'no_auth' | 'error'
+  count?: number
+  applied?: number
+  syncedAt?: string
+  error?: string
+}
+
+// =============================================================================
+// Sync Client Types
+// =============================================================================
+
+/**
+ * Result of batch push to API
+ */
+export interface SyncBatchResult {
+  success: boolean
+  processed: number
+  errors: Array<{ index: number; error: string }>
+  syncedAt: string
+}
+
+/**
+ * Result of pull from API
+ */
+export interface SyncPullResult {
+  events: Array<{
+    type: string
+    path: string[]
+    data: unknown
+    timestamp: string
+  }>
+  syncedAt: string
+}
+
+/**
+ * Project sync status from API
+ */
+export interface SyncStatus {
+  projectId: string
+  lastSync: string | null
+  pendingCount: number
+  hasConflicts: boolean
+}
+
+/**
+ * Error from sync client
+ */
+export interface SyncClientError {
+  code: 'AUTH_REQUIRED' | 'NETWORK_ERROR' | 'API_ERROR' | 'UNKNOWN'
+  message: string
+  status?: number
+}

package/core/types/task.ts

@@ -0,0 +1,72 @@
+/**
+ * Task Types
+ * Types for task tracking and analysis.
+ */
+
+export interface Task {
+  id: string
+  description: string
+  status: 'pending' | 'in_progress' | 'completed' | 'blocked'
+  createdAt: string
+  completedAt?: string
+  duration?: string
+  metadata?: TaskMetadata
+}
+
+export interface TaskMetadata {
+  domain?: string
+  complexity?: 'low' | 'medium' | 'high'
+  agent?: string
+  tags?: string[]
+}
+
+/**
+ * Result of analyzing a task to determine routing and complexity.
+ */
+export interface TaskAnalysis {
+  /** Primary domain detected (e.g., 'frontend', 'backend', 'devops') */
+  primaryDomain: string
+  /** Confidence score (0-1) */
+  confidence: number
+  /** Semantic analysis of task description */
+  semantic: SemanticAnalysis
+  /** Historical analysis from past similar tasks */
+  historical: HistoricalAnalysis
+  /** Complexity level */
+  complexity: 'low' | 'medium' | 'high'
+  /** Project-specific data used in analysis */
+  projectData: ProjectAnalysisData
+  /** Keywords that matched domain patterns */
+  matchedKeywords: string[]
+  /** Human-readable reason for domain assignment */
+  reason: string
+  /** Alternative domains considered */
+  alternatives: string[]
+}
+
+export interface SemanticAnalysis {
+  /** Detected intent */
+  intent: string
+  /** Key entities in the task */
+  entities: string[]
+  /** Sentiment score */
+  sentiment: number
+}
+
+export interface HistoricalAnalysis {
+  /** Similar past tasks count */
+  similarTasksCount: number
+  /** Average duration of similar tasks */
+  avgDuration: string | null
+  /** Success rate of similar tasks */
+  successRate: number
+}
+
+export interface ProjectAnalysisData {
+  /** Available agents */
+  availableAgents: string[]
+  /** Stack technologies */
+  stack: string[]
+  /** Recent activity domains */
+  recentDomains: string[]
+}

package/core/types/template.ts

@@ -0,0 +1,24 @@
+/**
+ * Template Types
+ * Types for command templates.
+ */
+
+export interface Template {
+  name: string
+  content: string
+  frontmatter: TemplateFrontmatter
+}
+
+export interface TemplateFrontmatter {
+  name: string
+  description?: string
+  category?: string
+  allowedTools?: string[]
+  validation?: ValidationRule[]
+}
+
+export interface ValidationRule {
+  type: string
+  field?: string
+  message?: string
+}

package/core/types/utils.ts

@@ -0,0 +1,90 @@
+/**
+ * Utility Types
+ * Common utility types and file system types.
+ */
+
+// Re-export file system types
+export {
+  NodeError,
+  isNotFoundError,
+  isPermissionError,
+  isDirNotEmptyError,
+  isFileExistsError,
+  isNodeError,
+} from './fs'
+
+export type AsyncFunction<T = unknown> = (...args: unknown[]) => Promise<T>
+
+export type MaybePromise<T> = T | Promise<T>
+
+export interface FileInfo {
+  path: string
+  content: string
+  mtime?: Date
+  size?: number
+}
+
+export interface LogLevel {
+  debug: 0
+  info: 1
+  warn: 2
+  error: 3
+}
+
+// =============================================================================
+// Date Helper Types
+// =============================================================================
+
+export interface DateComponents {
+  year: string
+  month: string
+  day: string
+}
+
+// =============================================================================
+// Cache Types
+// =============================================================================
+
+export interface CacheEntry<T> {
+  data: T
+  timestamp: number
+}
+
+export interface CacheOptions {
+  /** TTL in milliseconds (default: 5000) */
+  ttl?: number
+  /** Max entries before eviction (default: 50) */
+  maxSize?: number
+}
+
+export interface CacheStats {
+  size: number
+  maxSize: number
+  ttl: number
+}
+
+// =============================================================================
+// Project Commands Types
+// =============================================================================
+
+type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun'
+type DetectedStack = 'js' | 'python' | 'go' | 'rust' | 'dotnet' | 'java' | 'unknown'
+
+interface DetectedCommand {
+  command: string
+  tool: string
+}
+
+export interface DetectedProjectCommands {
+  stack: DetectedStack
+  packageManager?: PackageManager
+  lint?: DetectedCommand
+  typecheck?: DetectedCommand
+  test?: DetectedCommand
+}
+
+// =============================================================================
+// Runtime Types
+// =============================================================================
+
+export type Runtime = 'bun' | 'node'

package/core/utils/cache.ts

@@ -0,0 +1,195 @@
+/**
+ * Cache Utilities - Shared caching primitives for storage layers
+ *
+ * Provides two cache implementations:
+ * - TTLCache: Time-based cache with LRU eviction (for StorageManager)
+ * - LazyCache: Single-project lazy loading cache (for memory system)
+ */
+
+import type { CacheEntry, CacheOptions, CacheStats } from '../types'
+
+/**
+ * TTL Cache with LRU eviction
+ *
+ * Used by StorageManager for project-keyed caching.
+ * Automatically evicts expired entries and oldest entries when over capacity.
+ */
+export class TTLCache<T> {
+  private cache = new Map<string, CacheEntry<T>>()
+  private readonly ttl: number
+  private readonly maxSize: number
+
+  constructor(options: CacheOptions = {}) {
+    this.ttl = options.ttl ?? 5000
+    this.maxSize = options.maxSize ?? 50
+  }
+
+  /**
+   * Check if entry exists and is not expired
+   */
+  isValid(key: string): boolean {
+    const entry = this.cache.get(key)
+    if (!entry) return false
+    return Date.now() - entry.timestamp < this.ttl
+  }
+
+  /**
+   * Get entry if valid, otherwise null
+   */
+  get(key: string): T | null {
+    const entry = this.cache.get(key)
+
+    if (!entry) return null
+
+    if (!this.isValid(key)) {
+      this.cache.delete(key)
+      return null
+    }
+
+    return entry.data
+  }
+
+  /**
+   * Set entry with current timestamp
+   */
+  set(key: string, data: T): void {
+    this.cache.set(key, { data, timestamp: Date.now() })
+    this.evictOldEntries()
+  }
+
+  /**
+   * Delete entry
+   */
+  delete(key: string): void {
+    this.cache.delete(key)
+  }
+
+  /**
+   * Clear all entries
+   */
+  clear(): void {
+    this.cache.clear()
+  }
+
+  /**
+   * Check if key exists (may be expired)
+   */
+  has(key: string): boolean {
+    return this.cache.has(key)
+  }
+
+  /**
+   * Get number of entries (including expired)
+   */
+  get size(): number {
+    return this.cache.size
+  }
+
+  /**
+   * Evict oldest entries if over max size
+   */
+  private evictOldEntries(): void {
+    if (this.cache.size <= this.maxSize) return
+
+    const entries = Array.from(this.cache.entries()).sort(
+      (a, b) => a[1].timestamp - b[1].timestamp
+    )
+
+    const toRemove = entries.slice(0, this.cache.size - this.maxSize)
+    for (const [key] of toRemove) {
+      this.cache.delete(key)
+    }
+  }
+
+  /**
+   * Get cache statistics
+   */
+  stats(): CacheStats {
+    return {
+      size: this.cache.size,
+      maxSize: this.maxSize,
+      ttl: this.ttl,
+    }
+  }
+
+  /**
+   * Remove all expired entries
+   */
+  prune(): number {
+    let removed = 0
+    for (const key of this.cache.keys()) {
+      if (!this.isValid(key)) {
+        this.cache.delete(key)
+        removed++
+      }
+    }
+    return removed
+  }
+}
+
+/**
+ * Single-project lazy cache
+ *
+ * Used by CachedStore for memory system (one project at a time).
+ * Simpler than TTLCache - just tracks if data is loaded for current project.
+ */
+export class LazyCache<T> {
+  private data: T | null = null
+  private loaded = false
+  private projectId: string | null = null
+
+  /**
+   * Check if loaded for a specific project
+   */
+  isLoaded(projectId?: string): boolean {
+    if (projectId) {
+      return this.loaded && this.projectId === projectId
+    }
+    return this.loaded
+  }
+
+  /**
+   * Get cached data (may be null if not loaded)
+   */
+  get(): T | null {
+    return this.data
+  }
+
+  /**
+   * Set data for a project
+   */
+  set(projectId: string, data: T): void {
+    this.data = data
+    this.loaded = true
+    this.projectId = projectId
+  }
+
+  /**
+   * Reset cache
+   */
+  reset(): void {
+    this.data = null
+    this.loaded = false
+    this.projectId = null
+  }
+
+  /**
+   * Get current project ID
+   */
+  getProjectId(): string | null {
+    return this.projectId
+  }
+
+  /**
+   * Check if cache is empty
+   */
+  isEmpty(): boolean {
+    return !this.loaded || this.data === null
+  }
+}
+
+// Default export for CommonJS compatibility
+export default {
+  TTLCache,
+  LazyCache,
+}