prjct-cli 0.20.0 → 0.20.1

package/core/types/bus.ts

@@ -0,0 +1,82 @@
+/**
+ * Event Bus Types
+ * Types for the lightweight Pub/Sub system.
+ */
+
+// =============================================================================
+// Event Types Constant
+// =============================================================================
+
+/**
+ * Event Types - All events that can be emitted
+ */
+export const EventTypes = {
+  // Session events
+  SESSION_STARTED: 'session.started',
+  SESSION_PAUSED: 'session.paused',
+  SESSION_RESUMED: 'session.resumed',
+  SESSION_COMPLETED: 'session.completed',
+
+  // Task events
+  TASK_CREATED: 'task.created',
+  TASK_COMPLETED: 'task.completed',
+  TASK_UPDATED: 'task.updated',
+
+  // Feature events
+  FEATURE_ADDED: 'feature.added',
+  FEATURE_SHIPPED: 'feature.shipped',
+  FEATURE_UPDATED: 'feature.updated',
+
+  // Idea events
+  IDEA_CAPTURED: 'idea.captured',
+  IDEA_PROMOTED: 'idea.promoted',
+
+  // Snapshot events
+  SNAPSHOT_CREATED: 'snapshot.created',
+  SNAPSHOT_RESTORED: 'snapshot.restored',
+
+  // Git events
+  COMMIT_CREATED: 'git.commit',
+  PUSH_COMPLETED: 'git.push',
+
+  // System events
+  PROJECT_INITIALIZED: 'project.init',
+  PROJECT_SYNCED: 'project.sync',
+  ANALYSIS_COMPLETED: 'analysis.completed',
+
+  // Wildcard
+  ALL: '*',
+} as const
+
+// =============================================================================
+// Bus Types
+// =============================================================================
+
+/**
+ * Event type union derived from EventTypes
+ */
+export type BusEventType = (typeof EventTypes)[keyof typeof EventTypes]
+
+/**
+ * Event data payload
+ */
+export interface EventData {
+  type: string
+  timestamp: string
+  projectId: string | null
+  [key: string]: unknown
+}
+
+/**
+ * Event callback handler
+ */
+export type EventCallback = (data: EventData) => void | Promise<void>
+
+/**
+ * Event subscription
+ */
+export interface EventSubscription {
+  id: string
+  type: BusEventType
+  callback: EventCallback
+}

package/core/types/commands.ts

@@ -0,0 +1,366 @@
+/**
+ * Command Types
+ * Types for the command system.
+ */
+
+// ============================================
+// Core Command Types
+// ============================================
+
+/**
+ * Command execution result with optional extra data.
+ * This is the EXTENDED version with command-specific fields.
+ */
+export interface CommandResult {
+  success: boolean
+  message?: string
+  error?: string
+  /** Duration of command execution */
+  duration?: string
+  /** Task that was affected */
+  task?: string
+  /** Feature that was affected */
+  feature?: string
+  /** Files that were modified */
+  filesModified?: string[]
+  /** Allow any additional properties for command-specific data */
+  [key: string]: unknown
+}
+
+/**
+ * Command usage - which interfaces support this command
+ */
+export interface CommandUsage {
+  human: string
+  claude: string
+}
+
+/**
+ * Command metadata for requirements and categorization
+ */
+export interface CommandMetadata {
+  requiresProject: boolean
+  requiresActiveTask: boolean
+  modifiesState: boolean
+  category: string
+}
+
+/**
+ * Feature status for a command
+ */
+export interface CommandFeature {
+  name: string
+  status: 'implemented' | 'planned' | 'deprecated'
+}
+
+/**
+ * Command definition
+ */
+export interface Command {
+  name: string
+  description: string
+  category: string
+  usage: CommandUsage
+  metadata: CommandMetadata
+  features: CommandFeature[]
+  implemented: boolean
+}
+
+/**
+ * Command registry interface
+ */
+export interface CommandRegistry {
+  getByName(name: string): Command | undefined
+  getByCategory(category: string): Command[]
+  getAll(): Command[]
+  getStats(): CommandStats
+}
+
+/**
+ * Command statistics
+ */
+export interface CommandStats {
+  total: number
+  implemented: number
+  planned: number
+  byCategory: Record<string, number>
+}
+
+// ============================================
+// Command Options Types
+// ============================================
+
+/**
+ * Author information
+ */
+export interface Author {
+  name?: string
+  email?: string
+  github?: string
+}
+
+/**
+ * Options for the design command.
+ */
+export interface DesignOptions {
+  /** Type of design */
+  type?: 'architecture' | 'api' | 'component' | 'database' | 'flow'
+  /** Output format */
+  format?: 'markdown' | 'mermaid'
+}
+
+/**
+ * Options for the cleanup command.
+ */
+export interface CleanupOptions {
+  /** Clean up memory/history */
+  memory?: boolean
+  /** Type of cleanup */
+  type?: 'all' | 'memory' | 'sessions' | 'cache'
+  /** Dry run without making changes */
+  dryRun?: boolean
+}
+
+/**
+ * Options for the setup command.
+ */
+export interface SetupOptions {
+  /** Force re-setup even if already configured */
+  force?: boolean
+  /** Skip interactive prompts */
+  nonInteractive?: boolean
+}
+
+/**
+ * Options for the migrate-all command.
+ */
+export interface MigrateOptions {
+  /** Perform deep scan for legacy installations */
+  deepScan?: boolean
+  /** Remove legacy installations after migration */
+  removeLegacy?: boolean
+  /** Dry run without making changes */
+  dryRun?: boolean
+}
+
+/**
+ * Options for the analyze command.
+ */
+export interface AnalyzeOptions {
+  /** Force re-analysis even if cached */
+  force?: boolean
+  /** Analysis depth */
+  depth?: 'quick' | 'normal' | 'deep'
+  /** Allow additional options */
+  [key: string]: unknown
+}
+
+// ============================================
+// Migration Types
+// ============================================
+
+/**
+ * Result from project migration.
+ */
+export interface MigrationResult {
+  success: boolean
+  projectId: string | null
+  filesCopied?: number
+  layerCounts: LayerCounts
+  config: MigrationConfig | null
+  author: Author | null
+  issues: string[]
+  dryRun: boolean
+  legacyRemoved?: boolean
+  legacyCleaned?: boolean
+}
+
+/**
+ * Layer counts for migration
+ */
+export interface LayerCounts {
+  core: number
+  progress: number
+  planning: number
+  analysis: number
+  memory: number
+  other: number
+}
+
+/**
+ * Migration configuration
+ */
+export interface MigrationConfig {
+  projectId: string
+  version: string
+  migratedAt: string
+}
+
+// ============================================
+// Analysis Types
+// ============================================
+
+/**
+ * Complexity analysis result
+ */
+export interface ComplexityResult {
+  level: 'low' | 'medium' | 'high'
+  hours: number
+  type: string
+}
+
+/**
+ * Health check result
+ */
+export interface HealthResult {
+  score: number
+  message: string
+}
+
+// ============================================
+// Command Function Types
+// ============================================
+
+/**
+ * Type-safe command method names (for dynamic invocation)
+ */
+export type CommandMethodName =
+  | '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'
+
+/**
+ * Function signature for standard command methods
+ */
+export type StandardCommandFn = (param: string | null, projectPath?: string) => Promise<CommandResult>
+
+// ============================================
+// Registry Types
+// ============================================
+
+/**
+ * Execution context passed to all command handlers
+ */
+export interface ExecutionContext {
+  projectId: string
+  projectPath: string
+  globalPath: string
+  timestamp: string
+}
+
+/**
+ * Command handler interface - all commands implement this
+ */
+export interface CommandHandler<TParams = void, TResult = CommandResult> {
+  /** Command name for registration */
+  readonly name: string
+  /** Execute the command */
+  execute(params: TParams, context: ExecutionContext): Promise<TResult>
+}
+
+/**
+ * Handler function type for simple commands
+ */
+export type HandlerFn<TParams = void> = (
+  params: TParams,
+  context: ExecutionContext
+) => Promise<CommandResult>
+
+/**
+ * Registry command usage - which interfaces support this command
+ */
+export interface RegistryCommandUsage {
+  claude: string | null
+  terminal: string | null
+}
+
+/**
+ * Blocking rules for commands
+ */
+export interface BlockingRules {
+  check: string
+  message: string
+}
+
+/**
+ * Command metadata for introspection (registry version)
+ */
+export interface CommandMeta {
+  name: string
+  group: string
+  description: string
+  requiresProject: boolean
+  usage: RegistryCommandUsage
+  params?: string
+  implemented: boolean
+  hasTemplate: boolean
+  blockingRules?: BlockingRules
+  features?: string[]
+  isOptional?: boolean
+  deprecated?: boolean
+  replacedBy?: string
+}
+
+/**
+ * Category metadata
+ */
+export interface CategoryInfo {
+  title: string
+  description: string
+  order: number
+}
+
+/**
+ * Registry statistics
+ */
+export interface RegistryStats {
+  total: number
+  implemented: number
+  withTemplates: number
+  claudeOnly: number
+  terminalOnly: number
+  both: number
+  requiresInit: number
+  byCategory: Record<string, number>
+}
+
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+  valid: boolean
+  issues: string[]
+}
+
+// Note: AgentInfo and AgentAssignmentResult moved to agents.ts
+
+// ============================================
+// Global Config Types (command-related)
+// ============================================
+
+/**
+ * Global configuration for prjct.
+ */
+export interface GlobalConfig {
+  projectId: string
+  projectPath?: string
+  authors: AuthorEntry[]
+  version: string
+  created?: string
+  lastSync: string
+}
+
+/**
+ * Author entry in global config
+ */
+export interface AuthorEntry {
+  name: string
+  email: string
+  github: string
+  firstContribution?: string
+  lastActivity?: string
+}

package/core/types/config.ts

@@ -0,0 +1,66 @@
+/**
+ * Config Types
+ * Types for project and global configuration.
+ */
+
+/**
+ * Local config - stored in .prjct/prjct.config.json
+ * Minimal config that points to global storage
+ */
+export interface LocalConfig {
+  projectId: string
+  dataPath: string
+}
+
+/**
+ * Global config - stored in ~/.prjct-cli/projects/{id}/project.json
+ * Contains all project metadata
+ */
+export interface GlobalConfig {
+  projectId: string
+  projectPath?: string
+  authors: AuthorEntry[]
+  version: string
+  created?: string
+  lastSync: string
+}
+
+/**
+ * Author entry in global config
+ */
+export interface AuthorEntry {
+  name: string
+  email: string
+  github: string
+  firstContribution?: string
+  lastActivity?: string
+}
+
+/**
+ * Project config - generic project settings (for registry)
+ */
+export interface ProjectConfig {
+  projectId: string
+  name?: string
+  createdAt: string
+  updatedAt: string
+  settings?: ProjectSettings
+}
+
+/**
+ * Project-specific settings
+ */
+export interface ProjectSettings {
+  autoCommit?: boolean
+  commitFooter?: string
+  branchNaming?: string
+}
+
+/**
+ * Global settings - user preferences
+ */
+export interface GlobalSettings {
+  defaultAuthor?: string
+  theme?: 'light' | 'dark'
+  telemetry?: boolean
+}

package/core/types/core.ts

@@ -0,0 +1,96 @@
+/**
+ * Core Types
+ * Canonical definitions for project context and state.
+ */
+
+export interface ContextPaths {
+  now: string
+  next: string
+  context: string
+  shipped: string
+  metrics: string
+  ideas: string
+  roadmap: string
+  specs: string
+  memory: string
+  patterns: string
+  analysis: string
+  codePatterns: string
+}
+
+/**
+ * Command parameters passed from CLI to commands.
+ * Each property corresponds to a CLI argument or flag.
+ */
+export interface CommandParams {
+  /** Task description for now/build commands */
+  task?: string
+  /** Feature/bug description */
+  description?: string
+  /** Feature name for feature/ship commands */
+  feature?: string
+  /** Idea text for idea command */
+  idea?: string
+  /** Alias for idea */
+  text?: string
+  /** Name parameter for various commands */
+  name?: string
+  /** Skip planning mode check */
+  skipPlanning?: boolean
+  /** User has approved destructive action */
+  approved?: boolean
+  /** Period for progress command */
+  period?: 'day' | 'week' | 'month'
+  /** Target for design command */
+  target?: string
+  /** Action for architect command */
+  action?: string
+}
+
+/**
+ * Project context for Claude and command execution.
+ */
+export interface ProjectContext {
+  projectId: string
+  projectPath: string
+  globalPath: string
+  paths: ContextPaths
+  params: CommandParams
+  timestamp: string
+  date: string
+}
+
+export interface ProjectState {
+  now: string | null
+  next: string | null
+  shipped: string | null
+  metrics: string | null
+  ideas: string | null
+  roadmap: string | null
+  analysis: string | null
+  codePatterns: string | null
+  _compressed?: Record<string, CompressedContent>
+  _compressionMetrics?: CompressionMetrics
+}
+
+/**
+ * Metrics from semantic compression of project state.
+ */
+export interface CompressionMetrics {
+  /** Original total size in bytes */
+  originalSize: number
+  /** Compressed total size in bytes */
+  compressedSize: number
+  /** Compression ratio (0-1) */
+  ratio: number
+  /** Fields that were compressed */
+  fieldsCompressed: string[]
+  /** Timestamp of compression */
+  timestamp: string
+}
+
+export interface CompressedContent {
+  raw: string
+  summary: string
+  compressed: string
+}

package/core/types/domain.ts

@@ -0,0 +1,71 @@
+/**
+ * Domain Types
+ * Types for domain layer modules.
+ */
+
+// =============================================================================
+// Task Stack Types
+// =============================================================================
+
+/**
+ * Task entry in the stack (JSONL format)
+ */
+export interface TaskStackEntry {
+  id: string
+  task: string
+  agent: string
+  status: 'active' | 'paused' | 'completed'
+  started: string
+  paused: string | null
+  resumed: string | null
+  completed: string | null
+  duration: number | null
+  durationFormatted?: string
+  complexity: string
+  dev: string
+  pauseReason?: string
+  pausedDuration?: number
+}
+
+/**
+ * Parsed content from legacy now.md file
+ */
+export interface ParsedNowFile {
+  description: string
+  started: string | null
+  agent: string | null
+  complexity: string | null
+  dev: string | null
+}
+
+/**
+ * Result of migrating from legacy now.md to stack
+ */
+export interface TaskStackMigrationResult {
+  migrated: boolean
+  hadTask?: boolean
+  task?: TaskStackEntry
+  error?: string
+}
+
+/**
+ * Result of switching between tasks
+ */
+export interface TaskSwitchResult {
+  paused: TaskStackEntry | null
+  resumed?: TaskStackEntry
+  started?: TaskStackEntry
+  type: 'resumed' | 'started'
+}
+
+/**
+ * Summary of task stack state
+ */
+export interface TaskStackSummary {
+  active: TaskStackEntry | null
+  paused: TaskStackEntry[]
+  pausedCount: number
+  completed: TaskStackEntry[]
+  completedCount: number
+  totalTasks: number
+}

package/core/types/events.ts

@@ -0,0 +1,42 @@
+/**
+ * Event Types
+ * Types for the event system and sync events.
+ */
+
+// =============================================================================
+// Sync Event Types
+// =============================================================================
+
+/**
+ * Event for synchronization with backend
+ */
+export interface SyncEvent {
+  type: string
+  path: string[]
+  data: unknown
+  timestamp: string
+  projectId: string
+}
+
+/**
+ * Event type union for sync events
+ */
+export type SyncEventType =
+  | 'task.created'
+  | 'task.updated'
+  | 'task.completed'
+  | 'task.deleted'
+  | 'feature.created'
+  | 'feature.updated'
+  | 'feature.shipped'
+  | 'feature.deleted'
+  | 'idea.created'
+  | 'idea.updated'
+  | 'idea.deleted'
+  | 'session.started'
+  | 'session.completed'
+  | 'shipped.created'
+  | 'agent.created'
+  | 'agent.updated'
+  | 'agent.deleted'
+  | 'project.updated'