prjct-cli 1.6.7 → 1.6.9

package/core/types/sync-verifier.ts

@@ -0,0 +1,33 @@
+/**
+ * Sync Verifier Types
+ * Types for sync verification checks.
+ */
+
+export interface VerificationCheck {
+  name: string
+  command?: string
+  script?: string
+  enabled?: boolean
+}
+
+export interface VerificationConfig {
+  checks?: VerificationCheck[]
+  failFast?: boolean
+}
+
+export interface VerificationCheckResult {
+  name: string
+  passed: boolean
+  output?: string
+  error?: string
+  durationMs: number
+}
+
+export interface VerificationReport {
+  passed: boolean
+  checks: VerificationCheckResult[]
+  totalMs: number
+  failedCount: number
+  passedCount: number
+  skippedCount: number
+}

package/core/types/workflow.ts

@@ -0,0 +1,23 @@
+/**
+ * Workflow Types
+ * Types for workflow preferences and hooks.
+ */
+
+export type PreferenceScope = 'permanent' | 'session' | 'once'
+export type HookPhase = 'before' | 'after' | 'skip'
+export type HookCommand = 'task' | 'done' | 'ship' | 'sync'
+
+export interface WorkflowPreference {
+  hook: HookPhase
+  command: HookCommand
+  action: string
+  scope: PreferenceScope
+  createdAt: string
+}
+
+export interface HookResult {
+  success: boolean
+  failed?: string
+  skipped?: string[]
+  output?: string
+}

package/core/utils/animations.ts

@@ -249,21 +249,3 @@ ${divider}
 ${colors.dim('Keep shipping! 🚀')}
   `
 }
-
-// Default export for CommonJS compatibility
-export default {
-  colors,
-  frames,
-  banners,
-  animate,
-  typeWriter,
-  progressBar,
-  sparkle,
-  formatShip,
-  formatFocus,
-  formatSuccess,
-  formatError,
-  formatIdea,
-  formatCleanup,
-  formatRecap,
-}

package/core/utils/cache.ts

@@ -185,9 +185,3 @@ export class LazyCache<T> {
     return !this.loaded || this.data === null
   }
 }
-
-// Default export for CommonJS compatibility
-export default {
-  TTLCache,
-  LazyCache,
-}

package/core/utils/citations.ts

@@ -7,23 +7,9 @@
  * @see PRJ-113
  */
 
-export type SourceType = 'detected' | 'user-defined' | 'inferred'
+import type { ContextSources, SourceInfo, SourceType } from '../types/citations'
 
-export interface SourceInfo {
-  file: string
-  type: SourceType
-}
-
-export interface ContextSources {
-  name: SourceInfo
-  version: SourceInfo
-  ecosystem: SourceInfo
-  languages: SourceInfo
-  frameworks: SourceInfo
-  commands: SourceInfo
-  projectType: SourceInfo
-  git: SourceInfo
-}
+export type { ContextSources, SourceInfo, SourceType } from '../types/citations'
 
 /**
  * Generate an HTML citation comment

package/core/utils/collection-filters.ts

@@ -207,27 +207,3 @@ export function uniqueByField<T, K extends keyof T>(items: T[], field: K): T[] {
     return true
   })
 }
-
-// Default export for CommonJS compatibility
-export default {
-  PRIORITY_ORDER,
-  SECTION_ORDER,
-  filterByField,
-  filterByFieldIn,
-  filterByFieldNot,
-  filterActiveByField,
-  filterByTruthy,
-  filterByFalsy,
-  sortByPriority,
-  sortBySectionAndPriority,
-  sortByDate,
-  filterByDateRange,
-  filterByLastDays,
-  groupByField,
-  countByField,
-  take,
-  takeLast,
-  findByField,
-  anyByField,
-  uniqueByField,
-}

package/core/utils/date-helper.ts

@@ -164,23 +164,3 @@ export function getEndOfDay(date: Date): Date {
   result.setHours(23, 59, 59, 999)
   return result
 }
-
-// Default export for CommonJS compatibility
-export default {
-  formatDate,
-  formatMonth,
-  getTodayKey,
-  getDateKey,
-  getYearMonthDay,
-  parseDate,
-  getTimestamp,
-  getDaysAgo,
-  getDaysFromNow,
-  getDateRange,
-  isToday,
-  isWithinLastDays,
-  formatDuration,
-  calculateDuration,
-  getStartOfDay,
-  getEndOfDay,
-}

package/core/utils/error-messages.ts

@@ -2,151 +2,17 @@
  * Error Messages Catalog
  *
  * Centralized error messages with context and recovery hints.
- * Provides consistent, helpful error output across the CLI.
+ * Types and catalog live in core/types/errors.ts.
  *
  * @see PRJ-131
  * @module utils/error-messages
  */
 
-export interface ErrorWithHint {
-  message: string
-  hint?: string
-  file?: string
-  docs?: string
-  code?: string
-}
-
-/**
- * Common error messages with recovery hints
- */
-export const ERRORS = {
-  // Project errors
-  NO_PROJECT: {
-    message: 'No prjct project found in this directory',
-    hint: "Run 'prjct init' to set up a new project",
-    file: '.prjct/prjct.config.json',
-  },
-
-  NO_PROJECT_ID: {
-    message: 'Project ID not found',
-    hint: "Run 'prjct init' or check .prjct/prjct.config.json",
-    file: '.prjct/prjct.config.json',
-  },
-
-  CONFIG_NOT_FOUND: {
-    message: 'Configuration file not found',
-    hint: "Run 'prjct init' to create project configuration",
-    file: '.prjct/prjct.config.json',
-  },
-
-  CONFIG_INVALID: {
-    message: 'Invalid configuration file',
-    hint: 'Check JSON syntax or delete .prjct/ and run init again',
-    file: '.prjct/prjct.config.json',
-  },
-
-  // Git errors
-  GIT_NOT_FOUND: {
-    message: 'Git repository not detected',
-    hint: "Run 'git init' first, then 'prjct init'",
-  },
-
-  GIT_NO_COMMITS: {
-    message: 'No commits in repository',
-    hint: 'Make an initial commit before using prjct',
-  },
-
-  GIT_DIRTY: {
-    message: 'Working directory has uncommitted changes',
-    hint: "Commit or stash changes, or use '--force' to override",
-  },
-
-  GIT_ON_MAIN: {
-    message: 'Cannot ship from main/master branch',
-    hint: 'Create a feature branch first: git checkout -b feature/your-feature',
-  },
-
-  GIT_OPERATION_FAILED: {
-    message: 'Git operation failed',
-    hint: 'Check git status and resolve any conflicts',
-  },
-
-  // Auth errors
-  GH_NOT_AUTHENTICATED: {
-    message: 'GitHub CLI not authenticated',
-    hint: "Run 'gh auth login' to authenticate",
-    docs: 'https://cli.github.com/manual/gh_auth_login',
-  },
-
-  LINEAR_NOT_CONFIGURED: {
-    message: 'Linear integration not configured',
-    hint: "Run 'p. linear setup' to configure Linear",
-  },
-
-  LINEAR_API_ERROR: {
-    message: 'Linear API error',
-    hint: 'Check your API key or network connection',
-  },
-
-  // Task errors
-  NO_ACTIVE_TASK: {
-    message: 'No active task',
-    hint: 'Start a task with \'p. task "description"\'',
-  },
-
-  TASK_ALREADY_ACTIVE: {
-    message: 'A task is already in progress',
-    hint: "Complete it with 'p. done' or pause with 'p. pause'",
-  },
-
-  // Sync errors
-  SYNC_FAILED: {
-    message: 'Project sync failed',
-    hint: 'Check file permissions and try again',
-  },
-
-  // Ship errors
-  NOTHING_TO_SHIP: {
-    message: 'Nothing to ship',
-    hint: 'Make some changes first, then run ship',
-  },
-
-  PR_CREATE_FAILED: {
-    message: 'Failed to create pull request',
-    hint: 'Check GitHub auth and remote configuration',
-  },
-
-  // Provider errors
-  NO_AI_PROVIDER: {
-    message: 'No AI provider detected',
-    hint: "Install Claude Code or Gemini CLI, then run 'prjct start'",
-    docs: 'https://prjct.app/docs',
-  },
-
-  PROVIDER_NOT_CONFIGURED: {
-    message: 'AI provider not configured for prjct',
-    hint: "Run 'prjct start' to configure your provider",
-  },
-
-  // Command errors
-  UNKNOWN_COMMAND: {
-    message: 'Unknown command',
-    hint: "Run 'prjct --help' to see available commands",
-  },
-
-  MISSING_PARAM: {
-    message: 'Missing required parameter',
-    hint: 'Check command usage below',
-  },
-
-  // Generic
-  UNKNOWN: {
-    message: 'An unexpected error occurred',
-    hint: 'Check the error details and try again',
-  },
-} as const
+import type { ErrorCode, ErrorWithHint } from '../types/errors'
+import { ERRORS } from '../types/errors'
 
-export type ErrorCode = keyof typeof ERRORS
+export type { ErrorCode, ErrorWithHint } from '../types/errors'
+export { ERRORS } from '../types/errors'
 
 /**
  * Get error with optional overrides

package/core/utils/file-helper.ts

@@ -267,29 +267,3 @@ export function getFileExtension(filePath: string): string {
 export function getFileNameWithoutExtension(filePath: string): string {
   return path.basename(filePath, path.extname(filePath))
 }
-
-// Default export for CommonJS compatibility
-export default {
-  readJson,
-  writeJson,
-  readFile,
-  writeFile,
-  atomicWrite,
-  appendToFile,
-  appendLine,
-  prependToFile,
-  fileExists,
-  dirExists,
-  ensureDir,
-  deleteFile,
-  deleteDir,
-  listFiles,
-  getFileSize,
-  getFileModifiedTime,
-  copyFile,
-  moveFile,
-  readLines,
-  writeLines,
-  getFileExtension,
-  getFileNameWithoutExtension,
-}

package/core/utils/help.ts

@@ -312,12 +312,3 @@ export function getHelp(topic?: string): string {
 
   return formatCommandHelp(topic)
 }
-
-export default {
-  formatMainHelp,
-  formatCommandHelp,
-  formatCommandList,
-  formatTerminalCommandHelp,
-  formatAgentCommandHelp,
-  getHelp,
-}

package/core/utils/jsonl-helper.ts

@@ -288,24 +288,3 @@ export async function checkFileSizeWarning(
 
   return { sizeMB, isLarge }
 }
-
-// Default export for CommonJS compatibility
-export default {
-  parseJsonLines,
-  stringifyJsonLines,
-  readJsonLines,
-  writeJsonLines,
-  appendJsonLine,
-  appendJsonLines,
-  filterJsonLines,
-  countJsonLines,
-  getLastJsonLines,
-  getFirstJsonLines,
-  mergeJsonLines,
-  isJsonLinesEmpty,
-  readJsonLinesStreaming,
-  getFileSizeMB,
-  rotateJsonLinesIfNeeded,
-  appendJsonLineWithRotation,
-  checkFileSizeWarning,
-}

package/core/utils/logger.ts

@@ -16,17 +16,7 @@
  *   log.error('Failed to load', error.message)
  */
 
-type LogLevel = 'error' | 'warn' | 'info' | 'debug'
-type LogFunction = (...args: unknown[]) => void
-
-interface Logger {
-  error: LogFunction
-  warn: LogFunction
-  info: LogFunction
-  debug: LogFunction
-  isEnabled: () => boolean
-  level: () => LogLevel | 'disabled'
-}
+import type { LogFunction, Logger, LogLevel } from '../types/logger'
 
 const LEVELS: Record<LogLevel, number> = { error: 0, warn: 1, info: 2, debug: 3 }
 const TRUTHY_VALUES = new Set(['1', 'true', '*'])
@@ -36,6 +26,8 @@ const TRUTHY_VALUES = new Set(['1', 'true', '*'])
  * Returns -1 (disabled) or a level from LEVELS
  */
 function getLogLevel(): { level: number; name: LogLevel | 'disabled' } {
+  // PRJCT_DEBUG (primary) or DEBUG (fallback): Enable debug logging
+  // Values: '1', 'true', a log level name, or 'prjct' to match
   const debugEnv = process.env.PRJCT_DEBUG || process.env.DEBUG || ''
 
   // Disabled if empty

package/core/utils/markdown-builder.ts

@@ -278,6 +278,3 @@ export class MarkdownBuilder {
 export function md(): MarkdownBuilder {
   return new MarkdownBuilder()
 }
-
-// Default export
-export default { MarkdownBuilder, md }

package/core/utils/next-steps.ts

@@ -91,5 +91,3 @@ export function showStateInfo(state: WorkflowState): void {
   const info = workflowStateMachine.getStateInfo(state)
   console.log(chalk.dim(`📍 State: ${chalk.white(state.toUpperCase())} - ${info.description}`))
 }
-
-export default { showNextSteps, getNextSteps, showStateInfo }

package/core/utils/output.ts

@@ -11,31 +11,22 @@
 
 import chalk from 'chalk'
 import { OUTPUT_LIMITS } from '../constants'
+import type { ErrorCode, ErrorWithHint } from '../types/errors'
+import type { Output, OutputMetrics, OutputTier, TierConfig } from '../types/output'
 import branding from './branding'
-import type { ErrorCode, ErrorWithHint } from './error-messages'
 import { getError } from './error-messages'
 
 const _FRAMES = branding.spinner.frames
 const SPEED = branding.spinner.speed
 
-/**
- * Output tier configuration
- * Controls verbosity of CLI output
- */
-export type OutputTier = 'silent' | 'minimal' | 'compact' | 'verbose'
-
-export interface TierConfig {
-  maxLines: number
-  maxCharsPerLine: number
-  showMetrics: boolean
-}
+export type { Output, OutputMetrics, OutputTier, TierConfig } from '../types/output'
 
 export const OUTPUT_TIERS: Record<OutputTier, TierConfig> = {
   silent: { maxLines: 0, maxCharsPerLine: 0, showMetrics: false },
   minimal: { maxLines: 1, maxCharsPerLine: 65, showMetrics: false },
   compact: { maxLines: 4, maxCharsPerLine: 80, showMetrics: true },
   verbose: { maxLines: Infinity, maxCharsPerLine: Infinity, showMetrics: true },
-}
+} as const
 
 // Current output tier (default: compact for human-readable output)
 let currentTier: OutputTier = 'compact'
@@ -184,36 +175,6 @@ export function formatForHuman(data: unknown): string {
 const clear = (): boolean =>
   process.stdout.isTTY ? process.stdout.write(`\r${' '.repeat(OUTPUT_LIMITS.CLEAR_WIDTH)}\r`) : true
 
-/**
- * Metrics to display after command completion
- * Shows value provided by prjct (compression, agent count, etc.)
- */
-interface OutputMetrics {
-  agents?: number // Number of agents used
-  reduction?: number // Context reduction percentage
-  tokens?: number // Token count (in thousands)
-}
-
-interface Output {
-  start(): Output
-  end(): Output
-  spin(msg: string): Output
-  done(msg: string, metrics?: OutputMetrics): Output
-  fail(msg: string): Output
-  failWithHint(error: ErrorWithHint | ErrorCode): Output
-  warn(msg: string): Output
-  info(msg: string): Output
-  debug(msg: string): Output
-  success(msg: string, metrics?: OutputMetrics): Output
-  list(items: string[], options?: { bullet?: string; indent?: number }): Output
-  table(rows: Array<Record<string, string | number>>, options?: { header?: boolean }): Output
-  box(title: string, content: string): Output
-  section(title: string): Output
-  stop(): Output
-  step(current: number, total: number, msg: string): Output
-  progress(current: number, total: number, msg?: string): Output
-}
-
 const out: Output = {
   // Branding: Show header at start
   start() {
@@ -273,7 +234,7 @@ const out: Output = {
   // Rich error with context and recovery hint
   failWithHint(error: ErrorWithHint | ErrorCode) {
     this.stop()
-    const err = typeof error === 'string' ? getError(error) : error
+    const err = typeof error === 'string' ? getError(error as ErrorCode) : error
     console.error()
     console.error(`${ICONS.fail} ${err.message}`)
     if (err.file) {
@@ -305,6 +266,7 @@ const out: Output = {
   // Debug message (only if DEBUG=1 or DEBUG=true)
   debug(msg: string) {
     this.stop()
+    // DEBUG: Enable debug output (values: '1' or 'true')
     const debugEnabled = process.env.DEBUG === '1' || process.env.DEBUG === 'true'
     if (!quietMode && debugEnabled) {
       console.log(`${ICONS.debug} ${chalk.dim(msg)}`)
@@ -436,7 +398,6 @@ const out: Output = {
   },
 }
 
-export type { OutputMetrics }
 export type { ErrorCode, ErrorWithHint } from './error-messages'
 export { createError, ERRORS, getError } from './error-messages'
 export default out

package/core/utils/runtime.ts

@@ -106,14 +106,3 @@ export function getRunCommand(scriptPath: string, args: string[] = []): string {
 
   return `node ${scriptPath}${argsStr}`
 }
-
-export default {
-  detectRuntime,
-  isBunAvailable,
-  isNodeAvailable,
-  getRuntimeVersion,
-  isBun,
-  isNode,
-  getPreferredRuntime,
-  getRunCommand,
-}

package/core/utils/session-helper.ts

@@ -276,15 +276,3 @@ export async function cleanEmptySessionDirs(
 
   return cleaned
 }
-
-// Default export for CommonJS compatibility
-export default {
-  getTodaySessionFilePath,
-  ensureTodaySessionDir,
-  writeToSession,
-  readTodaySession,
-  readRecentSessions,
-  getSessionStats,
-  archiveOldSessions,
-  cleanEmptySessionDirs,
-}

package/core/utils/version.ts

@@ -123,15 +123,3 @@ export function needsMigration(fromVersion: string, toVersion: string | null = n
 
 export const VERSION = getVersion()
 export const PACKAGE_ROOT = getPackageRoot()
-
-// Default export for CommonJS compatibility
-export default {
-  getVersion,
-  getPackageRoot,
-  getPackageInfo,
-  compareVersions,
-  isCompatible,
-  needsMigration,
-  VERSION,
-  PACKAGE_ROOT,
-}

package/core/workflow/workflow-preferences.ts

@@ -17,28 +17,25 @@ import { exec } from 'node:child_process'
 import { promisify } from 'node:util'
 import chalk from 'chalk'
 import memorySystem from '../agentic/memory-system'
+import { WORKFLOW_HELP } from '../constants'
+import type {
+  HookCommand,
+  HookPhase,
+  HookResult,
+  PreferenceScope,
+  WorkflowPreference,
+} from '../types'
 import { getErrorMessage } from '../types/fs'
 
 const execAsync = promisify(exec)
 
-export type PreferenceScope = 'permanent' | 'session' | 'once'
-export type HookPhase = 'before' | 'after' | 'skip'
-export type HookCommand = 'task' | 'done' | 'ship' | 'sync'
-
-export interface WorkflowPreference {
-  hook: HookPhase
-  command: HookCommand
-  action: string // command to run or 'true' for skip
-  scope: PreferenceScope
-  createdAt: string
-}
-
-export interface HookResult {
-  success: boolean
-  failed?: string
-  skipped?: string[]
-  output?: string
-}
+export type {
+  HookCommand,
+  HookPhase,
+  HookResult,
+  PreferenceScope,
+  WorkflowPreference,
+} from '../types'
 
 // Session and once preferences (in-memory)
 const sessionPreferences: Map<string, WorkflowPreference> = new Map()
@@ -265,7 +262,7 @@ export function formatWorkflowPreferences(
   }>
 ): string {
   if (preferences.length === 0) {
-    return `${chalk.dim('No workflow preferences configured.')}\n\nSet one: "p. workflow antes de ship corre los tests"`
+    return `${chalk.dim(WORKFLOW_HELP.NO_PREFERENCES)}\n\nSet one: "${WORKFLOW_HELP.SET_EXAMPLE}"`
   }
 
   const lines: string[] = ['', 'WORKFLOW PREFERENCES', '────────────────────────────']
@@ -282,8 +279,8 @@ export function formatWorkflowPreferences(
   }
 
   lines.push('')
-  lines.push(chalk.dim('Modify: "p. workflow antes de ship corre npm test"'))
-  lines.push(chalk.dim('Remove: "p. workflow quita el hook de ship"'))
+  lines.push(chalk.dim(`Modify: "${WORKFLOW_HELP.MODIFY_EXAMPLE}"`))
+  lines.push(chalk.dim(`Remove: "${WORKFLOW_HELP.REMOVE_EXAMPLE}"`))
 
   return lines.join('\n')
 }
@@ -295,13 +292,3 @@ export function clearSessionPreferences(): void {
   sessionPreferences.clear()
   oncePreferences.clear()
 }
-
-export default {
-  setWorkflowPreference,
-  getWorkflowPreferences,
-  runWorkflowHooks,
-  listWorkflowPreferences,
-  removeWorkflowPreference,
-  formatWorkflowPreferences,
-  clearSessionPreferences,
-}