prjct-cli 1.22.0 → 1.24.0

package/core/services/index.ts

@@ -1,46 +0,0 @@
-/**
- * Services Layer
- *
- * Exports all service modules for use across the application.
- * Services encapsulate business logic extracted from CommandBase.
- */
-
-// Re-export types from canonical source
-export type {
-  ComplexityEstimate,
-  MemoryServiceEntry,
-  Severity,
-  Skill,
-  SkillMetadata,
-  SkillSearchResult,
-} from '../types'
-export type { AgentInfo, ProjectStats } from './agent-generator'
-// Agent Generator - Extracted from sync-service (PRJ-87)
-export { AgentGenerator, createAgentGenerator } from './agent-generator'
-export { AgentService, agentService } from './agent-service'
-export { BreakdownService, breakdownService } from './breakdown-service'
-export type { ContextSelectionOptions, SelectedContext } from './context-selector'
-// Context Selector - Task-based context selection (PRJ-85)
-export { ContextSelector, contextSelector } from './context-selector'
-export type { CategorizationOptions, CategorizationResult } from './file-categorizer'
-// File Categorizer - Smart Context Selection (PRJ-85)
-export { FileCategorizer, fileCategorizer } from './file-categorizer'
-export type { FileScore, FileStats, ScoringContext } from './file-scorer'
-// File Scorer
-export { FileScorer, fileScorer } from './file-scorer'
-export type { GitData } from './git-analyzer'
-// Git Analyzer - Extracted from sync-service (PRJ-85)
-export { GitAnalyzer, getEmptyGitData, gitAnalyzer } from './git-analyzer'
-export { MemoryService, memoryService } from './memory-service'
-export type { ContextSection, NestedContext, ResolvedContext } from './nested-context-resolver'
-// Nested Context Resolver - Monorepo PRJCT.md inheritance (PRJ-118)
-export { NestedContextResolver } from './nested-context-resolver'
-export type { IndexOptions, RelevantContext, ScanResult } from './project-index'
-// Project Index - Persistent scanning with scoring
-export { createProjectIndexer, ProjectIndexer, RELEVANCE_THRESHOLD } from './project-index'
-export { ProjectService, projectService } from './project-service'
-export type { StalenessConfig, StalenessStatus } from './staleness-checker'
-// Staleness Checker - Detect when CLAUDE.md is stale (PRJ-120)
-export { createStalenessChecker, StalenessChecker } from './staleness-checker'
-export type { SyncResult } from './sync-service'
-export { SyncService, syncService } from './sync-service'

package/core/services/local-state-generator.ts

@@ -1,158 +0,0 @@
-/**
- * Local State Generator
- *
- * Generates .prjct-state.md in the project root for local persistence.
- * This provides a quick reference to current task state without needing
- * to access global storage.
- *
- * @see PRJ-112
- */
-
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import type { StateJson } from '../schemas/state'
-import { isNotFoundError } from '../types/fs'
-
-const LOCAL_STATE_FILENAME = '.prjct-state.md'
-
-// Extended runtime types (state.json has fields not in strict schema)
-interface RuntimeTask {
-  description: string
-  startedAt: string
-  linearId?: string
-  branch?: string
-  status?: string
-  subtasks?: Array<{
-    description: string
-    status: string
-  }>
-  currentSubtaskIndex?: number
-}
-
-interface RuntimePreviousTask {
-  description: string
-  status: string
-  prUrl?: string
-}
-
-class LocalStateGenerator {
-  /**
-   * Generate .prjct-state.md in the project root
-   */
-  async generate(projectPath: string, state: StateJson): Promise<void> {
-    const filePath = path.join(projectPath, LOCAL_STATE_FILENAME)
-    const content = this.toMarkdown(state)
-    await fs.writeFile(filePath, content, 'utf-8')
-  }
-
-  /**
-   * Remove local state file
-   */
-  async remove(projectPath: string): Promise<void> {
-    const filePath = path.join(projectPath, LOCAL_STATE_FILENAME)
-    try {
-      await fs.unlink(filePath)
-    } catch (error) {
-      if (!isNotFoundError(error)) throw error
-    }
-  }
-
-  /**
-   * Check if local state file exists
-   */
-  async exists(projectPath: string): Promise<boolean> {
-    const filePath = path.join(projectPath, LOCAL_STATE_FILENAME)
-    try {
-      await fs.access(filePath)
-      return true
-    } catch {
-      return false
-    }
-  }
-
-  /**
-   * Convert state to markdown format
-   * Note: Uses runtime types since state.json has fields not in strict Zod schema
-   */
-  private toMarkdown(state: StateJson): string {
-    const lines: string[] = [
-      '<!-- Auto-generated by prjct - DO NOT EDIT -->',
-      '<!-- This file provides local state persistence for AI tools -->',
-      '',
-      '# prjct State',
-      '',
-    ]
-
-    if (state.currentTask) {
-      // Cast to runtime type (state.json has additional fields)
-      const task = state.currentTask as unknown as RuntimeTask
-      lines.push('## Current Task')
-      lines.push('')
-      lines.push(`**${task.description}**`)
-      lines.push('')
-      lines.push(`- Started: ${task.startedAt}`)
-      if (task.linearId) {
-        lines.push(`- Linear: ${task.linearId}`)
-      }
-      if (task.branch) {
-        lines.push(`- Branch: ${task.branch}`)
-      }
-      lines.push(`- Status: ${task.status || 'active'}`)
-      lines.push('')
-
-      // Subtasks
-      if (task.subtasks && task.subtasks.length > 0) {
-        lines.push('### Subtasks')
-        lines.push('')
-
-        task.subtasks.forEach((subtask, index) => {
-          const statusIcon =
-            subtask.status === 'completed' ? '✅' : subtask.status === 'in_progress' ? '▶️' : '⏳'
-          const isActive = index === task.currentSubtaskIndex ? ' ← **Active**' : ''
-          lines.push(`${index + 1}. ${statusIcon} ${subtask.description}${isActive}`)
-        })
-
-        lines.push('')
-
-        // Progress
-        const completed = task.subtasks.filter((s) => s.status === 'completed').length
-        const total = task.subtasks.length
-        const percentage = Math.round((completed / total) * 100)
-        lines.push(`**Progress**: ${completed}/${total} (${percentage}%)`)
-        lines.push('')
-      }
-    } else {
-      lines.push('*No active task*')
-      lines.push('')
-      lines.push('Start a task with `p. task "description"`')
-      lines.push('')
-    }
-
-    // Previous task info
-    if (state.previousTask) {
-      // Cast to runtime type
-      const prevTask = state.previousTask as unknown as RuntimePreviousTask
-      lines.push('---')
-      lines.push('')
-      lines.push('## Previous Task')
-      lines.push('')
-      lines.push(`**${prevTask.description}**`)
-      lines.push('')
-      lines.push(`- Status: ${prevTask.status}`)
-      if (prevTask.prUrl) {
-        lines.push(`- PR: ${prevTask.prUrl}`)
-      }
-      lines.push('')
-    }
-
-    // Footer
-    lines.push('---')
-    lines.push(`*Last updated: ${state.lastUpdated || new Date().toISOString()}*`)
-    lines.push('')
-
-    return lines.join('\n')
-  }
-}
-
-export const localStateGenerator = new LocalStateGenerator()
-export default localStateGenerator

package/core/services/memory-service.ts

@@ -1,181 +0,0 @@
-/**
- * MemoryService - Event logging and memory management
- *
- * Handles logging actions to memory for audit trail and context building.
- */
-
-import configManager from '../infrastructure/config-manager'
-import pathManager from '../infrastructure/path-manager'
-import { ARCHIVE_POLICIES, archiveStorage } from '../storage/archive-storage'
-import type { MemoryServiceEntry } from '../types'
-import { getErrorMessage, isNotFoundError } from '../types/fs'
-import { getTimestamp } from '../utils/date-helper'
-import * as jsonlHelper from '../utils/jsonl-helper'
-
-export class MemoryService {
-  /**
-   * Log an action to memory
-   */
-  async log(
-    projectPath: string,
-    action: string,
-    data: Record<string, unknown>,
-    author?: string
-  ): Promise<void> {
-    try {
-      const projectId = await configManager.getProjectId(projectPath)
-      if (!projectId) return
-
-      const memoryPath = pathManager.getFilePath(projectId, 'memory', 'context.jsonl')
-
-      const entry: MemoryServiceEntry = {
-        timestamp: getTimestamp(),
-        action,
-        data,
-        author,
-      }
-
-      await jsonlHelper.appendJsonLine(memoryPath, entry)
-    } catch (error) {
-      // Non-critical - don't fail the command, but log unexpected errors
-      if (!isNotFoundError(error)) {
-        console.error(`Memory log error: ${getErrorMessage(error)}`)
-      }
-    }
-  }
-
-  /**
-   * Get recent memory entries
-   */
-  async getRecent(projectPath: string, limit: number = 100): Promise<MemoryServiceEntry[]> {
-    try {
-      const projectId = await configManager.getProjectId(projectPath)
-      if (!projectId) return []
-
-      const memoryPath = pathManager.getFilePath(projectId, 'memory', 'context.jsonl')
-      const entries = await jsonlHelper.readJsonLines<MemoryServiceEntry>(memoryPath)
-      return entries.slice(-limit)
-    } catch (error) {
-      // ENOENT or parse error - return empty (expected for new projects)
-      if (!isNotFoundError(error) && !(error instanceof SyntaxError)) {
-        console.error(`Memory read error: ${getErrorMessage(error)}`)
-      }
-      return []
-    }
-  }
-
-  /**
-   * Search memory for entries matching a pattern
-   */
-  async search(
-    projectPath: string,
-    pattern: string,
-    limit: number = 50
-  ): Promise<MemoryServiceEntry[]> {
-    const entries = await this.getRecent(projectPath, 1000)
-    const patternLower = pattern.toLowerCase()
-
-    return entries
-      .filter((entry) => {
-        const actionMatch = entry.action.toLowerCase().includes(patternLower)
-        const dataMatch = JSON.stringify(entry.data).toLowerCase().includes(patternLower)
-        return actionMatch || dataMatch
-      })
-      .slice(-limit)
-  }
-
-  /**
-   * Get entries for a specific action type
-   */
-  async getByAction(
-    projectPath: string,
-    action: string,
-    limit: number = 50
-  ): Promise<MemoryServiceEntry[]> {
-    const entries = await this.getRecent(projectPath, 1000)
-    return entries.filter((entry) => entry.action === action).slice(-limit)
-  }
-
-  /**
-   * Clear memory (for testing or cleanup)
-   */
-  async clear(projectPath: string): Promise<void> {
-    try {
-      const projectId = await configManager.getProjectId(projectPath)
-      if (!projectId) return
-
-      const memoryPath = pathManager.getFilePath(projectId, 'memory', 'context.jsonl')
-      await jsonlHelper.writeJsonLines(memoryPath, [])
-    } catch (error) {
-      // Non-critical - but log unexpected errors
-      if (!isNotFoundError(error)) {
-        console.error(`Memory clear error: ${getErrorMessage(error)}`)
-      }
-    }
-  }
-
-  /**
-   * Get recent events by projectId (for stats dashboard)
-   * @see PRJ-89
-   */
-  async getRecentEvents(
-    projectId: string,
-    limit: number = 100
-  ): Promise<Record<string, unknown>[]> {
-    try {
-      const memoryPath = pathManager.getFilePath(projectId, 'memory', 'context.jsonl')
-      const entries = await jsonlHelper.readJsonLines<Record<string, unknown>>(memoryPath)
-      return entries.slice(-limit)
-    } catch (error) {
-      // ENOENT or parse error - return empty
-      if (!isNotFoundError(error) && !(error instanceof SyntaxError)) {
-        console.error(`Memory read error: ${getErrorMessage(error)}`)
-      }
-      return []
-    }
-  }
-
-  /**
-   * Cap memory log at max entries (PRJ-267).
-   * Moves overflow entries to archive table, keeps most recent entries.
-   * Returns count of archived entries.
-   */
-  async capEntries(projectId: string): Promise<number> {
-    try {
-      const memoryPath = pathManager.getFilePath(projectId, 'memory', 'context.jsonl')
-      const entries = await jsonlHelper.readJsonLines<MemoryServiceEntry>(memoryPath)
-
-      if (entries.length <= ARCHIVE_POLICIES.MEMORY_MAX_ENTRIES) {
-        return 0
-      }
-
-      const overflow = entries.slice(0, entries.length - ARCHIVE_POLICIES.MEMORY_MAX_ENTRIES)
-      const kept = entries.slice(-ARCHIVE_POLICIES.MEMORY_MAX_ENTRIES)
-
-      // Archive overflow entries in batch
-      archiveStorage.archiveMany(
-        projectId,
-        overflow.map((entry, i) => ({
-          entityType: 'memory_entry' as const,
-          entityId: `memory-${entry.timestamp || i}`,
-          entityData: entry,
-          summary: entry.action,
-          reason: 'overflow',
-        }))
-      )
-
-      // Rewrite file with only kept entries
-      await jsonlHelper.writeJsonLines(memoryPath, kept)
-
-      return overflow.length
-    } catch (error) {
-      if (!isNotFoundError(error)) {
-        console.error(`Memory cap error: ${getErrorMessage(error)}`)
-      }
-      return 0
-    }
-  }
-}
-
-export const memoryService = new MemoryService()
-export default memoryService