prjct-cli 1.22.0 → 1.24.0

package/core/errors.ts

@@ -1,335 +0,0 @@
-/**
- * Custom Error Hierarchy for prjct-cli
- *
- * Base error class with specific subclasses for different error domains.
- * Enables typed error handling and better error messages.
- *
- * Features:
- * - Zod-validated structured error data
- * - NamedError pattern (inspired by opencode)
- * - Type-safe error creation and handling
- *
- * @module core/errors
- * @version 2.0.0
- */
-
-import { type ZodType, z } from 'zod'
-
-// =============================================================================
-// Named Error Pattern (Zod-based)
-// =============================================================================
-
-/**
- * Creates a typed error class with Zod schema validation
- * Inspired by opencode's NamedError pattern
- *
- * @example
- * const FileNotFound = NamedError.create('FileNotFound', z.object({
- *   path: z.string(),
- *   operation: z.enum(['read', 'write', 'delete'])
- * }))
- *
- * throw FileNotFound.throw({ path: '/foo/bar', operation: 'read' })
- */
-export const NamedError = {
-  create<T extends ZodType>(name: string, schema: T) {
-    type Data = z.infer<T>
-
-    class TypedError extends Error {
-      readonly errorName: string
-      readonly data: Data
-      readonly isOperational = true
-
-      constructor(data: Data) {
-        const parsed = schema.parse(data)
-        super(`${name}: ${JSON.stringify(parsed)}`)
-        this.name = name
-        this.errorName = name
-        this.data = parsed
-        Error.captureStackTrace?.(this, this.constructor)
-      }
-
-      static throw(data: Data): never {
-        throw new TypedError(data)
-      }
-
-      static is(error: unknown): error is TypedError {
-        return error instanceof TypedError && (error as TypedError).errorName === name
-      }
-
-      static create(data: Data): TypedError {
-        return new TypedError(data)
-      }
-    }
-
-    return TypedError
-  },
-}
-
-// =============================================================================
-// Typed Error Definitions (New Pattern)
-// =============================================================================
-
-/** File operation errors with path context */
-export const FileError = NamedError.create(
-  'FileError',
-  z.object({
-    path: z.string(),
-    operation: z.enum(['read', 'write', 'delete', 'create', 'copy']),
-    reason: z.string().optional(),
-  })
-)
-
-/** Validation errors with field context */
-export const ValidationError = NamedError.create(
-  'ValidationError',
-  z.object({
-    field: z.string(),
-    expected: z.string(),
-    received: z.string().optional(),
-    message: z.string().optional(),
-  })
-)
-
-/** Permission errors */
-export const PermissionError = NamedError.create(
-  'PermissionError',
-  z.object({
-    action: z.string(),
-    resource: z.string(),
-    reason: z.string().optional(),
-  })
-)
-
-/** Task operation errors */
-export const TaskError = NamedError.create(
-  'TaskError',
-  z.object({
-    taskId: z.string().optional(),
-    operation: z.enum(['create', 'update', 'complete', 'pause', 'resume', 'delete']),
-    reason: z.string(),
-  })
-)
-
-/** Session errors */
-export const SessionError = NamedError.create(
-  'SessionError',
-  z.object({
-    sessionId: z.string().optional(),
-    reason: z.string(),
-  })
-)
-
-/** Sync errors */
-export const SyncError = NamedError.create(
-  'SyncError',
-  z.object({
-    projectId: z.string().optional(),
-    operation: z.enum(['push', 'pull', 'auth', 'connect']),
-    reason: z.string(),
-  })
-)
-
-// =============================================================================
-// Legacy Error Classes (Preserved for Backward Compatibility)
-// =============================================================================
-
-/**
- * Base error class for all prjct errors
- */
-export class PrjctError extends Error {
-  readonly code: string
-  readonly isOperational: boolean
-
-  constructor(message: string, code = 'PRJCT_ERROR') {
-    super(message)
-    this.name = 'PrjctError'
-    this.code = code
-    this.isOperational = true // Distinguishes from programming errors
-    Error.captureStackTrace?.(this, this.constructor)
-  }
-}
-
-/**
- * Configuration-related errors
- */
-export class ConfigError extends PrjctError {
-  constructor(message: string, code = 'CONFIG_ERROR') {
-    super(message, code)
-    this.name = 'ConfigError'
-  }
-
-  static notFound(path: string): ConfigError {
-    return new ConfigError(`Configuration not found: ${path}`, 'CONFIG_NOT_FOUND')
-  }
-
-  static invalid(reason: string): ConfigError {
-    return new ConfigError(`Invalid configuration: ${reason}`, 'CONFIG_INVALID')
-  }
-
-  static parseError(path: string): ConfigError {
-    return new ConfigError(`Failed to parse configuration: ${path}`, 'CONFIG_PARSE_ERROR')
-  }
-}
-
-/**
- * Storage and file system errors
- */
-export class StorageError extends PrjctError {
-  constructor(message: string, code = 'STORAGE_ERROR') {
-    super(message, code)
-    this.name = 'StorageError'
-  }
-
-  static readFailed(path: string): StorageError {
-    return new StorageError(`Failed to read: ${path}`, 'STORAGE_READ_FAILED')
-  }
-
-  static writeFailed(path: string): StorageError {
-    return new StorageError(`Failed to write: ${path}`, 'STORAGE_WRITE_FAILED')
-  }
-
-  static notFound(path: string): StorageError {
-    return new StorageError(`File not found: ${path}`, 'STORAGE_NOT_FOUND')
-  }
-}
-
-/**
- * Project-related errors
- */
-export class ProjectError extends PrjctError {
-  constructor(message: string, code = 'PROJECT_ERROR') {
-    super(message, code)
-    this.name = 'ProjectError'
-  }
-
-  static notInitialized(): ProjectError {
-    return new ProjectError('Project not initialized. Run /p:init first.', 'PROJECT_NOT_INIT')
-  }
-
-  static notFound(projectId: string): ProjectError {
-    return new ProjectError(`Project not found: ${projectId}`, 'PROJECT_NOT_FOUND')
-  }
-
-  static invalidId(projectId: string): ProjectError {
-    return new ProjectError(`Invalid project ID: ${projectId}`, 'PROJECT_INVALID_ID')
-  }
-}
-
-/**
- * Command execution errors
- */
-export class CommandError extends PrjctError {
-  constructor(message: string, code = 'COMMAND_ERROR') {
-    super(message, code)
-    this.name = 'CommandError'
-  }
-
-  static notFound(commandName: string): CommandError {
-    return new CommandError(`Command not found: ${commandName}`, 'COMMAND_NOT_FOUND')
-  }
-
-  static invalidParams(reason: string): CommandError {
-    return new CommandError(`Invalid parameters: ${reason}`, 'COMMAND_INVALID_PARAMS')
-  }
-
-  static executionFailed(commandName: string, reason: string): CommandError {
-    return new CommandError(`Command '${commandName}' failed: ${reason}`, 'COMMAND_EXEC_FAILED')
-  }
-}
-
-/**
- * Template-related errors
- */
-export class TemplateError extends PrjctError {
-  constructor(message: string, code = 'TEMPLATE_ERROR') {
-    super(message, code)
-    this.name = 'TemplateError'
-  }
-
-  static notFound(templateName: string): TemplateError {
-    return new TemplateError(`Template not found: ${templateName}.md`, 'TEMPLATE_NOT_FOUND')
-  }
-
-  static parseFailed(templateName: string): TemplateError {
-    return new TemplateError(`Failed to parse template: ${templateName}`, 'TEMPLATE_PARSE_ERROR')
-  }
-}
-
-/**
- * Agent-related errors
- */
-export class AgentError extends PrjctError {
-  constructor(message: string, code = 'AGENT_ERROR') {
-    super(message, code)
-    this.name = 'AgentError'
-  }
-
-  static notSupported(agentType: string): AgentError {
-    return new AgentError(`Unsupported agent type: ${agentType}`, 'AGENT_NOT_SUPPORTED')
-  }
-
-  static initFailed(reason: string): AgentError {
-    return new AgentError(`Agent initialization failed: ${reason}`, 'AGENT_INIT_FAILED')
-  }
-}
-
-/**
- * Type guard to check if error is a PrjctError
- */
-export function isPrjctError(error: unknown): error is PrjctError {
-  return error instanceof PrjctError
-}
-
-/**
- * Type guard for specific error types
- */
-export function isConfigError(error: unknown): error is ConfigError {
-  return error instanceof ConfigError
-}
-
-export function isStorageError(error: unknown): error is StorageError {
-  return error instanceof StorageError
-}
-
-export function isProjectError(error: unknown): error is ProjectError {
-  return error instanceof ProjectError
-}
-
-export function isCommandError(error: unknown): error is CommandError {
-  return error instanceof CommandError
-}
-
-export function isTemplateError(error: unknown): error is TemplateError {
-  return error instanceof TemplateError
-}
-
-export function isAgentError(error: unknown): error is AgentError {
-  return error instanceof AgentError
-}
-
-/**
- * Extract error message safely from unknown error
- */
-export function getErrorMessage(error: unknown): string {
-  if (isPrjctError(error)) {
-    return error.message
-  }
-  if (error instanceof Error) {
-    return error.message
-  }
-  if (typeof error === 'string') {
-    return error
-  }
-  return 'Unknown error'
-}
-
-/**
- * Extract error code safely from unknown error
- */
-export function getErrorCode(error: unknown): string {
-  if (isPrjctError(error)) {
-    return error.code
-  }
-  return 'UNKNOWN_ERROR'
-}

package/core/events/events.ts

@@ -1,85 +0,0 @@
-/**
- * Event Bus for Sync
- *
- * Events are published on every Storage write/delete.
- * Events accumulate in sync/pending.json until /p:ship or /p:sync.
- */
-
-import pathManager from '../infrastructure/path-manager'
-import type { SyncEvent, SyncEventType } from '../types'
-import { getTimestamp } from '../utils/date-helper'
-import * as fileHelper from '../utils/file-helper'
-
-/**
- * Infer event type from path and action
- */
-export function inferEventType(pathArray: string[], action: 'write' | 'delete'): SyncEventType {
-  const entity = pathArray[0]
-
-  if (action === 'delete') {
-    return `${entity}.deleted` as SyncEventType
-  }
-
-  // For writes, we'd need to check if it's new or update
-  // For simplicity, use 'updated' (can be refined later)
-  return `${entity}.updated` as SyncEventType
-}
-
-class EventBus {
-  /**
-   * Publish event to pending queue
-   */
-  async publish(event: SyncEvent): Promise<void> {
-    const filePath = pathManager.getSyncPendingPath(event.projectId)
-
-    // Read existing pending events
-    const pending = (await fileHelper.readJson<SyncEvent[]>(filePath, [])) ?? []
-
-    // Add new event
-    pending.push(event)
-
-    // Write back (ensureDir is handled by writeJson)
-    await fileHelper.writeJson(filePath, pending)
-  }
-
-  /**
-   * Get all pending events for a project
-   */
-  async getPending(projectId: string): Promise<SyncEvent[]> {
-    const filePath = pathManager.getSyncPendingPath(projectId)
-    return (await fileHelper.readJson<SyncEvent[]>(filePath, [])) ?? []
-  }
-
-  /**
-   * Clear pending events after successful sync
-   */
-  async clearPending(projectId: string): Promise<void> {
-    const filePath = pathManager.getSyncPendingPath(projectId)
-    await fileHelper.writeJson(filePath, [])
-  }
-
-  /**
-   * Update last sync timestamp
-   */
-  async updateLastSync(projectId: string): Promise<void> {
-    const filePath = pathManager.getLastSyncPath(projectId)
-
-    const data = {
-      timestamp: getTimestamp(),
-      success: true,
-    }
-
-    await fileHelper.writeJson(filePath, data)
-  }
-
-  /**
-   * Get last sync info
-   */
-  async getLastSync(projectId: string): Promise<{ timestamp: string; success: boolean } | null> {
-    const filePath = pathManager.getLastSyncPath(projectId)
-    return await fileHelper.readJson<{ timestamp: string; success: boolean } | null>(filePath, null)
-  }
-}
-
-export const eventBus = new EventBus()
-export default eventBus

package/core/events/index.ts

@@ -1,8 +0,0 @@
-/**
- * Event Bus for Sync
- *
- * Barrel export for events module
- */
-
-export type { SyncEvent, SyncEventType } from '../types'
-export { default, eventBus, inferEventType } from './events'