prjct-cli 0.11.5 → 0.12.1

package/core/types/index.ts

@@ -0,0 +1,506 @@
+/**
+ * Core Types for prjct-cli
+ * Shared type definitions across the codebase
+ */
+
+// ============================================
+// Command System
+// ============================================
+
+export interface CommandResult {
+  success: boolean
+  message?: string
+  error?: string
+  data?: unknown
+}
+
+export interface CommandUsage {
+  human: string
+  claude: string
+}
+
+export interface CommandMetadata {
+  requiresProject: boolean
+  requiresActiveTask: boolean
+  modifiesState: boolean
+  category: string
+}
+
+export interface CommandFeature {
+  name: string
+  status: 'implemented' | 'planned' | 'deprecated'
+}
+
+export interface Command {
+  name: string
+  description: string
+  category: string
+  usage: CommandUsage
+  metadata: CommandMetadata
+  features: CommandFeature[]
+  implemented: boolean
+}
+
+export interface CommandRegistry {
+  getByName(name: string): Command | undefined
+  getByCategory(category: string): Command[]
+  getAll(): Command[]
+  getStats(): CommandStats
+}
+
+export interface CommandStats {
+  total: number
+  implemented: number
+  planned: number
+  byCategory: Record<string, number>
+}
+
+// ============================================
+// Context System
+// ============================================
+
+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
+}
+
+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
+}
+
+// ============================================
+// Agent System
+// ============================================
+
+export interface Agent {
+  name: string
+  content: string
+  path: string
+  role: string | null
+  domain: string | null
+  skills: string[]
+  modified: Date
+}
+
+export interface AgentInfo {
+  name: string
+  type: string
+  domain?: string
+}
+
+export interface AgentRouting {
+  agent: AgentInfo
+  confidence: number
+  reason: string
+  availableAgents: string[]
+}
+
+// ============================================
+// Tool System
+// ============================================
+
+export type ToolFunction = (...args: unknown[]) => Promise<unknown>
+
+export interface ToolDefinition {
+  name: string
+  description: string
+  handler: ToolFunction
+  parallelizable: boolean
+}
+
+export interface ToolRegistry {
+  get(name: string): ToolFunction | undefined
+  list(): string[]
+  has(name: string): boolean
+}
+
+export interface BashResult {
+  stdout: string
+  stderr: string
+  code: number
+}
+
+// ============================================
+// Execution System
+// ============================================
+
+/**
+ * Result of command execution through the agentic system.
+ *
+ * @group Core - Essential execution data
+ * @group Context - Execution environment
+ * @group Agentic - AI-related outputs
+ */
+export interface ExecutionResult {
+  // Core
+  /** Whether command executed successfully */
+  success: boolean
+  /** Generated prompt sent to Claude */
+  prompt: string
+  /** Whether execution was delegated to agentic system */
+  agenticDelegation: boolean
+
+  // Context
+  /** Template that was loaded */
+  template: Template | null
+  /** Project context used */
+  context: ProjectContext
+  /** Project state at execution time */
+  state: ProjectState
+
+  // Agentic outputs
+  /** Chain-of-thought reasoning (if enabled) */
+  reasoning: ChainOfThoughtResult | null
+  /** Think block content (if enabled) */
+  thinkBlock: ThinkBlockResult | null
+  /** Ground truth verification result */
+  groundTruth: GroundTruthResult | null
+  /** Compression metrics from semantic compression */
+  compressionMetrics: CompressionMetrics | null
+  /** Patterns learned during execution */
+  learnedPatterns: LearnedPatterns | null
+  /** Memories relevant to this execution */
+  relevantMemories: Memory[]
+}
+
+/**
+ * Result from chain-of-thought processing.
+ */
+export interface ChainOfThoughtResult {
+  steps: string[]
+  conclusion: string
+}
+
+/**
+ * Result from think block processing.
+ */
+export interface ThinkBlockResult {
+  content: string
+  duration: number
+}
+
+/**
+ * Result from ground truth verification.
+ */
+export interface GroundTruthResult {
+  verified: boolean
+  checks: GroundTruthCheck[]
+}
+
+export interface GroundTruthCheck {
+  name: string
+  passed: boolean
+  message?: string
+}
+
+/**
+ * Patterns learned during execution.
+ */
+export interface LearnedPatterns {
+  /** Code patterns detected */
+  code: string[]
+  /** User preference patterns */
+  preferences: string[]
+  /** Error patterns to avoid */
+  errors: string[]
+}
+
+export interface ValidationResult {
+  valid: boolean
+  error: string | null
+  suggestion: string | null
+  state: ProjectState
+}
+
+// ============================================
+// Memory System
+// ============================================
+
+export interface Memory {
+  id: string
+  type: string
+  content: string
+  tags: string[]
+  timestamp: string
+  metadata?: MemoryMetadata
+}
+
+/**
+ * Metadata associated with a memory entry.
+ */
+export interface MemoryMetadata {
+  /** Command that created this memory */
+  command?: string
+  /** Confidence score (0-1) */
+  confidence?: number
+  /** Related task ID */
+  taskId?: string
+  /** Related feature name */
+  feature?: string
+  /** Source of the memory */
+  source?: 'user' | 'system' | 'learned'
+}
+
+export interface MemoryQuery {
+  type?: string
+  tags?: string[]
+  limit?: number
+  since?: string
+}
+
+export type MemoryTag =
+  | 'decision'
+  | 'pattern'
+  | 'preference'
+  | 'learning'
+  | 'error'
+  | 'success'
+
+// ============================================
+// Session System
+// ============================================
+
+export interface Session {
+  id: string
+  startedAt: string
+  endedAt?: string
+  task?: string
+  duration?: number
+  metrics?: SessionMetrics
+}
+
+export interface SessionMetrics {
+  filesCreated: number
+  filesModified: number
+  linesAdded: number
+  linesRemoved: number
+  commits: number
+}
+
+// ============================================
+// Task System
+// ============================================
+
+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[]
+}
+
+// ============================================
+// Config System
+// ============================================
+
+export interface ProjectConfig {
+  projectId: string
+  name?: string
+  createdAt: string
+  updatedAt: string
+  settings?: ProjectSettings
+}
+
+export interface ProjectSettings {
+  autoCommit?: boolean
+  commitFooter?: string
+  branchNaming?: string
+}
+
+export interface GlobalConfig {
+  version: string
+  projects: Record<string, ProjectConfig>
+  settings: GlobalSettings
+}
+
+export interface GlobalSettings {
+  defaultAuthor?: string
+  theme?: 'light' | 'dark'
+  telemetry?: boolean
+}
+
+// ============================================
+// Template System
+// ============================================
+
+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
+}
+
+// ============================================
+// Utility Types
+// ============================================
+
+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
+}

package/core/utils/{animations.js → animations.ts}

@@ -3,9 +3,53 @@
  * Fallback when terminal doesn't support RGB colors
  */
 
-const chalk = require('chalk')
+import chalk from 'chalk'
+
+type ChalkFunction = typeof chalk.green
+
+interface Colors {
+  success: ChalkFunction
+  error: ChalkFunction
+  warning: ChalkFunction
+  info: ChalkFunction
+  ship: ChalkFunction
+  celebrate: ChalkFunction
+  focus: ChalkFunction
+  idea: ChalkFunction
+  progress: ChalkFunction
+  task: ChalkFunction
+  primary: ChalkFunction
+  secondary: ChalkFunction
+  text: ChalkFunction
+  subtext: ChalkFunction
+  dim: ChalkFunction
+}
+
+interface Frames {
+  rocket: string[]
+  sparkles: string[]
+  loading: string[]
+  progress: string[]
+  celebration: string[]
+}
+
+interface Banners {
+  ship: string
+  success: string
+  error: string
+  welcome: string
+  cleanup: string
+  focus: string
+}
+
+interface RecapData {
+  currentTask?: string | null
+  shippedCount: number
+  queuedCount: number
+  ideasCount: number
+}
 
-const colors = {
+export const colors: Colors = {
   success: chalk.green,
   error: chalk.red,
   warning: chalk.yellow,
@@ -23,7 +67,7 @@ const colors = {
   dim: chalk.gray,
 }
 
-const frames = {
+export const frames: Frames = {
   rocket: [
     '     🚀     ',
     '    🚀      ',
@@ -55,7 +99,7 @@ const frames = {
   celebration: ['🎉', '🎊', '✨', '🌟', '⭐', '💫', '🎆', '🎇'],
 }
 
-const banners = {
+export const banners: Banners = {
   ship: `
 ╔════════════════════════════════════════════╗
 ║  🚀 ${colors.ship.bold('S H I P P E D !')}  🚀            ║
@@ -82,15 +126,19 @@ ${colors.focus.bold('   🎯 FOCUS MODE 🎯   ')}
 ${colors.focus('━━━━━━━━━━━━━━━━━━━━━━━')}`,
 }
 
-async function animate(frames, duration = 100) {
-  for (const frame of frames) {
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+export async function animate(frameList: string[], duration = 100): Promise<void> {
+  for (const frame of frameList) {
     process.stdout.write('\r' + frame)
     await sleep(duration)
   }
   process.stdout.write('\r' + ' '.repeat(30) + '\r')
 }
 
-async function typeWriter(text, delay = 30) {
+export async function typeWriter(text: string, delay = 30): Promise<void> {
   for (let i = 0; i <= text.length; i++) {
     process.stdout.write('\r' + text.slice(0, i) + (i < text.length ? '▋' : ''))
     await sleep(delay)
@@ -98,7 +146,7 @@ async function typeWriter(text, delay = 30) {
   process.stdout.write('\n')
 }
 
-async function progressBar(duration = 1000, label = 'Processing') {
+export async function progressBar(duration = 1000, label = 'Processing'): Promise<void> {
   const steps = 20
   const stepDuration = duration / steps
 
@@ -113,7 +161,7 @@ async function progressBar(duration = 1000, label = 'Processing') {
   process.stdout.write('\n')
 }
 
-async function sparkle(message) {
+export async function sparkle(message: string): Promise<void> {
   const sparkles = ['✨', '⭐', '💫', '🌟']
   let output = ''
 
@@ -129,22 +177,18 @@ async function sparkle(message) {
   console.log(output)
 }
 
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms))
-}
-
-function formatShip(feature, count) {
+export function formatShip(feature: string, count: number): string {
   const banner = banners.ship
   const stats = `
 ${colors.text('Feature:')} ${colors.ship.bold(feature)}
-${colors.text('Total shipped:')} ${colors.success.bold(count)}
+${colors.text('Total shipped:')} ${colors.success.bold(String(count))}
 ${colors.text('Velocity:')} ${colors.celebrate('🔥 On fire!')}
   `
 
   return banner + stats
 }
 
-function formatFocus(task, timestamp) {
+export function formatFocus(task: string, timestamp: string): string {
   const banner = banners.focus
   const info = `
 ${colors.text('Current task:')} ${colors.focus.bold(task)}
@@ -154,15 +198,15 @@ ${colors.dim('Started:')} ${colors.subtext(timestamp)}
   return banner + info
 }
 
-function formatSuccess(message) {
+export function formatSuccess(message: string): string {
   return `${colors.success('✅')} ${colors.text(message)}`
 }
 
-function formatError(message) {
+export function formatError(message: string): string {
   return `${colors.error('❌')} ${colors.text(message)}`
 }
 
-function formatIdea(idea) {
+export function formatIdea(idea: string): string {
   return `
 ${colors.idea('💡 Idea captured!')}
 ${colors.text('―'.repeat(30))}
@@ -172,19 +216,19 @@ ${colors.dim('Added to your ideas backlog')}
   `
 }
 
-function formatCleanup(filesRemoved, tasksArchived, spaceFeed) {
+export function formatCleanup(filesRemoved: number, tasksArchived: number, spaceFeed: number): string {
   return `
 ${banners.cleanup}
 
-${colors.text('🗑️  Files removed:')} ${colors.success.bold(filesRemoved)}
-${colors.text('📦 Tasks archived:')} ${colors.success.bold(tasksArchived)}
+${colors.text('🗑️  Files removed:')} ${colors.success.bold(String(filesRemoved))}
+${colors.text('📦 Tasks archived:')} ${colors.success.bold(String(tasksArchived))}
 ${colors.text('💾 Space freed:')} ${colors.success.bold(spaceFeed + ' MB')}
 
 ${colors.celebrate('✨ Your project is clean and lean!')}
   `
 }
 
-function formatRecap(data) {
+export function formatRecap(data: RecapData): string {
   const divider = colors.primary('━'.repeat(40))
 
   return `
@@ -193,16 +237,17 @@ ${colors.primary.bold('📊 PROJECT RECAP')}
 ${divider}
 
 ${colors.text('🎯 Current focus:')} ${data.currentTask || colors.dim('No active task')}
-${colors.text('🚀 Shipped this week:')} ${colors.success.bold(data.shippedCount)}
-${colors.text('📝 Queued tasks:')} ${colors.info.bold(data.queuedCount)}
-${colors.text('💡 Ideas captured:')} ${colors.idea.bold(data.ideasCount)}
+${colors.text('🚀 Shipped this week:')} ${colors.success.bold(String(data.shippedCount))}
+${colors.text('📝 Queued tasks:')} ${colors.info.bold(String(data.queuedCount))}
+${colors.text('💡 Ideas captured:')} ${colors.idea.bold(String(data.ideasCount))}
 
 ${divider}
 ${colors.dim('Keep shipping! 🚀')}
   `
 }
 
-module.exports = {
+// Default export for CommonJS compatibility
+export default {
   colors,
   frames,
   banners,
@@ -216,5 +261,6 @@ module.exports = {
   formatError,
   formatIdea,
   formatCleanup,
-  formatRecap,
+  formatRecap
 }
+