prjct-cli 1.6.2 → 1.6.4

package/core/commands/workflow.ts

@@ -14,6 +14,7 @@ import { linearService } from '../integrations/linear'
 import { generateUUID } from '../schemas'
 import { queueStorage, stateStorage } from '../storage'
 import type { CommandResult } from '../types'
+import { getErrorMessage } from '../types/fs'
 import { showNextSteps, showStateInfo } from '../utils/next-steps'
 import { getLinearApiKey, getProjectCredentials } from '../utils/project-credentials'
 import {
@@ -145,8 +146,8 @@ export class WorkflowCommands extends PrjctCommandsBase {
         return { success: true, task: currentTask.description, currentTask }
       }
     } catch (error) {
-      out.fail((error as Error).message)
-      return { success: false, error: (error as Error).message }
+      out.fail(getErrorMessage(error))
+      return { success: false, error: getErrorMessage(error) }
     }
   }
 
@@ -231,8 +232,8 @@ export class WorkflowCommands extends PrjctCommandsBase {
 
       return { success: true, task, duration }
     } catch (error) {
-      out.fail((error as Error).message)
-      return { success: false, error: (error as Error).message }
+      out.fail(getErrorMessage(error))
+      return { success: false, error: getErrorMessage(error) }
     }
   }
 
@@ -263,8 +264,8 @@ export class WorkflowCommands extends PrjctCommandsBase {
 
       return { success: true, tasks, count: tasks.length }
     } catch (error) {
-      out.fail((error as Error).message)
-      return { success: false, error: (error as Error).message }
+      out.fail(getErrorMessage(error))
+      return { success: false, error: getErrorMessage(error) }
     }
   }
 
@@ -305,8 +306,8 @@ export class WorkflowCommands extends PrjctCommandsBase {
 
       return { success: true, task: currentTask.description, reason }
     } catch (error) {
-      out.fail((error as Error).message)
-      return { success: false, error: (error as Error).message }
+      out.fail(getErrorMessage(error))
+      return { success: false, error: getErrorMessage(error) }
     }
   }
 
@@ -353,8 +354,8 @@ export class WorkflowCommands extends PrjctCommandsBase {
 
       return { success: true, task: resumed.description }
     } catch (error) {
-      out.fail((error as Error).message)
-      return { success: false, error: (error as Error).message }
+      out.fail(getErrorMessage(error))
+      return { success: false, error: getErrorMessage(error) }
     }
   }
 
@@ -411,8 +412,8 @@ export class WorkflowCommands extends PrjctCommandsBase {
         },
       }
     } catch (error) {
-      out.fail((error as Error).message)
-      return { success: false, error: (error as Error).message }
+      out.fail(getErrorMessage(error))
+      return { success: false, error: getErrorMessage(error) }
     }
   }
 }

package/core/context-tools/index.ts

@@ -16,6 +16,7 @@
  */
 
 import { metricsStorage } from '../storage/metrics-storage'
+import { getErrorMessage } from '../types/fs'
 import { getTimestamp } from '../utils/date-helper'
 import { findRelevantFiles } from './files-tool'
 import { analyzeImports } from './imports-tool'
@@ -115,7 +116,7 @@ export async function runContextTool(
     return {
       tool: 'error',
       result: {
-        error: (error as Error).message,
+        error: getErrorMessage(error),
         code: 'EXECUTION_ERROR',
       },
     }

package/core/domain/agent-generator.ts

@@ -7,6 +7,7 @@
 import fs from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
+import { getErrorMessage } from '../types/fs'
 import log from '../utils/logger'
 import AgentLoader from './agent-loader'
 
@@ -140,7 +141,7 @@ ${config.contextFilter || 'Only relevant files'}
         }
       }
     } catch (error) {
-      log.error('Agent cleanup failed:', (error as Error).message)
+      log.error('Agent cleanup failed:', getErrorMessage(error))
     }
 
     return removed

package/core/domain/context-estimator.ts

@@ -8,6 +8,7 @@
  */
 
 import { glob } from 'glob'
+import { getErrorMessage } from '../types/fs'
 import log from '../utils/logger'
 
 interface TaskAnalysis {
@@ -157,7 +158,7 @@ class ContextEstimator {
       // Remove duplicates and sort
       return [...new Set(files)].sort()
     } catch (error) {
-      log.error('Error finding files:', (error as Error).message)
+      log.error('Error finding files:', getErrorMessage(error))
       return []
     }
   }

package/core/domain/task-stack.ts

@@ -14,7 +14,7 @@ import type {
   TaskStackSummary,
   TaskSwitchResult,
 } from '../types'
-import { isNotFoundError } from '../types/fs'
+import { getErrorMessage, isNotFoundError } from '../types/fs'
 import log from '../utils/logger'
 
 const execAsync = promisify(exec)
@@ -150,7 +150,7 @@ export async function readStack(stackPath: string): Promise<TaskStackEntry[]> {
     try {
       entries.push(JSON.parse(line))
     } catch (error) {
-      log.error('Error parsing stack line:', (error as Error).message)
+      log.error('Error parsing stack line:', getErrorMessage(error))
     }
   }
 
@@ -300,7 +300,7 @@ export class TaskStack {
     } catch (error) {
       // No now.md or error reading, just create empty stack
       await ensureStackFile(this.stackPath)
-      return { migrated: true, hadTask: false, error: (error as Error).message }
+      return { migrated: true, hadTask: false, error: getErrorMessage(error) }
     }
   }
 

package/core/index.ts

@@ -14,6 +14,7 @@ import type { CommandMeta } from './commands/registry'
 import { detectAllProviders, detectAntigravity } from './infrastructure/ai-provider'
 import configManager from './infrastructure/config-manager'
 import { sessionTracker } from './services/session-tracker'
+import { getErrorMessage, getErrorStack } from './types/fs'
 import { getError } from './utils/error-messages'
 import { fileExists } from './utils/fs-helpers'
 import out from './utils/output'
@@ -199,9 +200,9 @@ async function main(): Promise<void> {
     out.end()
     process.exit(result?.success ? 0 : 1)
   } catch (error) {
-    console.error('Error:', (error as Error).message)
+    console.error('Error:', getErrorMessage(error))
     if (process.env.DEBUG) {
-      console.error((error as Error).stack)
+      console.error(getErrorStack(error))
     }
     // Show branding footer even on error
     out.end()
@@ -440,9 +441,9 @@ MORE INFO
 
 // Run CLI
 main().catch((error) => {
-  console.error('Fatal error:', (error as Error).message)
+  console.error('Fatal error:', getErrorMessage(error))
   if (process.env.DEBUG) {
-    console.error((error as Error).stack)
+    console.error(getErrorStack(error))
   }
   process.exit(1)
 })

package/core/infrastructure/capability-installer.ts

@@ -10,6 +10,7 @@
 
 import { exec } from 'node:child_process'
 import { promisify } from 'node:util'
+import { getErrorMessage } from '../types/fs'
 
 const execAsync = promisify(exec)
 
@@ -61,7 +62,7 @@ class CapabilityInstaller {
         success: false,
         capability,
         command,
-        error: (error as Error).message,
+        error: getErrorMessage(error),
       }
     }
   }

package/core/infrastructure/command-installer.ts

@@ -22,7 +22,7 @@ import type {
   SyncResult,
   UninstallResult,
 } from '../types'
-import { isNotFoundError } from '../types/fs'
+import { getErrorMessage, isNotFoundError } from '../types/fs'
 import { getPackageRoot } from '../utils/version'
 
 // =============================================================================
@@ -150,7 +150,7 @@ export async function installDocs(): Promise<{ success: boolean; error?: string
 
     return { success: true }
   } catch (error) {
-    return { success: false, error: (error as Error).message }
+    return { success: false, error: getErrorMessage(error) }
   }
 }
 
@@ -277,7 +277,7 @@ export async function installGlobalConfig(): Promise<GlobalConfigResult> {
   } catch (error) {
     return {
       success: false,
-      error: (error as Error).message,
+      error: getErrorMessage(error),
       action: 'failed',
     }
   }
@@ -409,7 +409,7 @@ export class CommandInstaller {
 
           installed.push(file.replace('.md', ''))
         } catch (error) {
-          errors.push({ file, error: (error as Error).message })
+          errors.push({ file, error: getErrorMessage(error) })
         }
       }
 
@@ -422,7 +422,7 @@ export class CommandInstaller {
     } catch (error) {
       return {
         success: false,
-        error: (error as Error).message,
+        error: getErrorMessage(error),
       }
     }
   }
@@ -443,7 +443,7 @@ export class CommandInstaller {
           uninstalled.push(file.replace('.md', ''))
         } catch (error) {
           if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {
-            errors.push({ file, error: (error as Error).message })
+            errors.push({ file, error: getErrorMessage(error) })
           }
         }
       }
@@ -463,7 +463,7 @@ export class CommandInstaller {
     } catch (error) {
       return {
         success: false,
-        error: (error as Error).message,
+        error: getErrorMessage(error),
       }
     }
   }
@@ -673,7 +673,7 @@ export class CommandInstaller {
             results.updated++
           }
         } catch (error) {
-          results.errors!.push({ file, error: (error as Error).message })
+          results.errors!.push({ file, error: getErrorMessage(error) })
         }
       }
 
@@ -685,7 +685,7 @@ export class CommandInstaller {
     } catch (error) {
       return {
         success: false,
-        error: (error as Error).message,
+        error: getErrorMessage(error),
         added: 0,
         updated: 0,
         removed: 0,

package/core/infrastructure/editors-config.ts

@@ -12,6 +12,7 @@
 import fs from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
+import { getErrorMessage } from '../types/fs'
 import type { AIProviderName } from '../types/provider'
 
 interface EditorConfig {
@@ -42,7 +43,7 @@ class EditorsConfig {
     try {
       await fs.mkdir(this.configDir, { recursive: true })
     } catch (error) {
-      console.error('[editors-config] Error creating config directory:', (error as Error).message)
+      console.error('[editors-config] Error creating config directory:', getErrorMessage(error))
     }
   }
 
@@ -57,7 +58,7 @@ class EditorsConfig {
       if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
         return null
       }
-      console.error('[editors-config] Error loading config:', (error as Error).message)
+      console.error('[editors-config] Error loading config:', getErrorMessage(error))
       return null
     }
   }
@@ -85,7 +86,7 @@ class EditorsConfig {
 
       return true
     } catch (error) {
-      console.error('[editors-config] Error saving config:', (error as Error).message)
+      console.error('[editors-config] Error saving config:', getErrorMessage(error))
       return false
     }
   }
@@ -132,7 +133,7 @@ class EditorsConfig {
 
       return true
     } catch (error) {
-      console.error('[editors-config] Error updating version:', (error as Error).message)
+      console.error('[editors-config] Error updating version:', getErrorMessage(error))
       return false
     }
   }
@@ -161,7 +162,7 @@ class EditorsConfig {
       }
       return true
     } catch (error) {
-      console.error('[editors-config] Error deleting config:', (error as Error).message)
+      console.error('[editors-config] Error deleting config:', getErrorMessage(error))
       return false
     }
   }

package/core/infrastructure/setup.ts

@@ -24,9 +24,10 @@ import path from 'node:path'
 import chalk from 'chalk'
 import { getTimeout } from '../constants'
 import { dependencyValidator } from '../services/dependency-validator'
-import { isNotFoundError } from '../types/fs'
+import { getErrorMessage, isNotFoundError } from '../types/fs'
 import type { AIProviderConfig, AIProviderName } from '../types/provider'
 import { fileExists } from '../utils/fs-helpers'
+import log from '../utils/logger'
 import { getPackageRoot, VERSION } from '../utils/version'
 import {
   detectAllProviders,
@@ -270,7 +271,7 @@ async function installGeminiRouter(): Promise<boolean> {
     }
     return false
   } catch (error) {
-    console.error(`Gemini router warning: ${(error as Error).message}`)
+    log.warn(`Gemini router warning: ${getErrorMessage(error)}`)
     return false
   }
 }
@@ -340,7 +341,7 @@ async function installGeminiGlobalConfig(): Promise<{ success: boolean; action:
     await fs.writeFile(globalConfigPath, updatedContent, 'utf-8')
     return { success: true, action: 'updated' }
   } catch (error) {
-    console.error(`Gemini config warning: ${(error as Error).message}`)
+    log.warn(`Gemini config warning: ${getErrorMessage(error)}`)
     return { success: false, action: null }
   }
 }
@@ -373,7 +374,7 @@ export async function installAntigravitySkill(): Promise<{
 
     // Read template content
     if (!(await fileExists(templatePath))) {
-      console.error('Antigravity SKILL.md template not found')
+      log.warn('Antigravity SKILL.md template not found')
       return { success: false, action: null }
     }
 
@@ -384,7 +385,7 @@ export async function installAntigravitySkill(): Promise<{
 
     return { success: true, action: skillExists ? 'updated' : 'created' }
   } catch (error) {
-    console.error(`Antigravity skill warning: ${(error as Error).message}`)
+    log.warn(`Antigravity skill warning: ${getErrorMessage(error)}`)
     return { success: false, action: null }
   }
 }
@@ -465,7 +466,7 @@ export async function installCursorProject(projectRoot: string): Promise<{
     result.success = result.rulesCreated || result.commandsCreated
     return result
   } catch (error) {
-    console.error(`Cursor installation warning: ${(error as Error).message}`)
+    log.warn(`Cursor installation warning: ${getErrorMessage(error)}`)
     return result
   }
 }
@@ -515,7 +516,7 @@ async function addCursorToGitignore(projectRoot: string): Promise<boolean> {
     await fs.writeFile(gitignorePath, newContent, 'utf-8')
     return true
   } catch (error) {
-    console.error(`Gitignore update warning: ${(error as Error).message}`)
+    log.warn(`Gitignore update warning: ${getErrorMessage(error)}`)
     return false
   }
 }
@@ -615,7 +616,7 @@ export async function installWindsurfProject(projectRoot: string): Promise<{
     result.success = result.rulesCreated || result.workflowsCreated
     return result
   } catch (error) {
-    console.error(`Windsurf installation warning: ${(error as Error).message}`)
+    log.warn(`Windsurf installation warning: ${getErrorMessage(error)}`)
     return result
   }
 }
@@ -665,7 +666,7 @@ async function addWindsurfToGitignore(projectRoot: string): Promise<boolean> {
     await fs.writeFile(gitignorePath, newContent, 'utf-8')
     return true
   } catch (error) {
-    console.error(`Gitignore update warning: ${(error as Error).message}`)
+    log.warn(`Gitignore update warning: ${getErrorMessage(error)}`)
     return false
   }
 }
@@ -738,7 +739,7 @@ async function migrateProjectsCliVersion(): Promise<void> {
     // Silently fail if projects directory doesn't exist
     if (!isNotFoundError(error)) {
       // Log unexpected errors but don't crash - migration is optional
-      console.error(`Migration warning: ${(error as Error).message}`)
+      log.warn(`Migration warning: ${getErrorMessage(error)}`)
     }
   }
 }
@@ -912,7 +913,7 @@ echo "prjct"
     // Silently fail if directories don't exist
     if (!isNotFoundError(error)) {
       // Log unexpected errors but don't crash - status line is optional
-      console.error(`Status line warning: ${(error as Error).message}`)
+      log.warn(`Status line warning: ${getErrorMessage(error)}`)
     }
   }
 }
@@ -965,7 +966,7 @@ async function installContext7MCP(): Promise<void> {
     }
   } catch (error) {
     // Non-fatal error, just log
-    console.error(`Context7 MCP setup warning: ${(error as Error).message}`)
+    log.warn(`Context7 MCP setup warning: ${getErrorMessage(error)}`)
   }
 }
 
@@ -1018,7 +1019,7 @@ async function ensureStatusLineSymlink(linkPath: string, targetPath: string): Pr
     } catch (copyError) {
       // Both symlink and copy failed - log if unexpected error
       if (!isNotFoundError(copyError)) {
-        console.error(`Symlink fallback warning: ${(copyError as Error).message}`)
+        log.warn(`Symlink fallback warning: ${(copyError as Error).message}`)
       }
     }
   }

package/core/infrastructure/update-checker.ts

@@ -9,6 +9,7 @@ import https from 'node:https'
 import os from 'node:os'
 import path from 'node:path'
 import chalk from 'chalk'
+import { getErrorMessage } from '../types/fs'
 import { fileExists } from '../utils/fs-helpers'
 
 interface UpdateCache {
@@ -44,7 +45,7 @@ class UpdateChecker {
       const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'))
       return packageJson.version
     } catch (error) {
-      console.error('Error reading package version:', (error as Error).message)
+      console.error('Error reading package version:', getErrorMessage(error))
       return null
     }
   }

package/core/integrations/issue-tracker/enricher.ts

@@ -6,6 +6,7 @@
  * The actual AI call happens through Claude Code's execution context.
  */
 
+import { getErrorMessage } from '../../types/fs'
 import type { EnrichedIssue, Issue } from './types'
 
 // =============================================================================
@@ -233,7 +234,7 @@ export function parseEnrichmentResponse(response: string): EnrichmentResult | nu
       relatedCode: parsed.relatedCode,
     }
   } catch (error) {
-    console.error('[enricher] Failed to parse enrichment:', (error as Error).message)
+    console.error('[enricher] Failed to parse enrichment:', getErrorMessage(error))
     return null
   }
 }

package/core/integrations/issue-tracker/manager.ts

@@ -3,6 +3,7 @@
  * Orchestrates multiple issue tracker providers and enrichment.
  */
 
+import { getErrorMessage } from '../../types/fs'
 import { jiraProvider } from '../jira/client'
 import { linearProvider } from '../linear/client'
 import {
@@ -241,7 +242,7 @@ export class IssueTrackerManager {
           } catch (error) {
             result.errors.push({
               issueId: issue.externalId,
-              error: (error as Error).message,
+              error: getErrorMessage(error),
             })
           }
         }
@@ -251,7 +252,7 @@ export class IssueTrackerManager {
     } catch (error) {
       result.errors.push({
         issueId: 'sync',
-        error: (error as Error).message,
+        error: getErrorMessage(error),
       })
       return result
     }

package/core/integrations/jira/client.ts

@@ -14,6 +14,7 @@
  *    - Requires MCP server configured in ~/.claude/mcp.json
  */
 
+import { getErrorMessage } from '../../types/fs'
 import type {
   CreateIssueInput,
   FetchOptions,
@@ -261,7 +262,7 @@ export class JiraProvider implements IssueTrackerProvider {
         this.baseUrl = ''
         this.auth = ''
         this._authMode = 'none'
-        throw new Error(`JIRA connection failed: ${(error as Error).message}`)
+        throw new Error(`JIRA connection failed: ${getErrorMessage(error)}`)
       }
     } else {
       // MCP mode - no direct API access, Claude uses MCP tools
@@ -340,7 +341,7 @@ export class JiraProvider implements IssueTrackerProvider {
       return this.mapIssue(issue)
     } catch (error) {
       // Issue not found
-      if ((error as Error).message.includes('404')) {
+      if (getErrorMessage(error).includes('404')) {
         return null
       }
       throw error

package/core/integrations/linear/client.ts

@@ -4,6 +4,7 @@
  */
 
 import { LinearClient as LinearSDK } from '@linear/sdk'
+import { getErrorMessage } from '../../types/fs'
 import { getCredential } from '../../utils/keychain'
 import type {
   CreateIssueInput,
@@ -84,7 +85,7 @@ export class LinearProvider implements IssueTrackerProvider {
       await this.sdk.viewer
     } catch (error) {
       this.sdk = null
-      throw new Error(`Linear connection failed: ${(error as Error).message}`)
+      throw new Error(`Linear connection failed: ${getErrorMessage(error)}`)
     }
   }
 

package/core/integrations/linear/sync.ts

@@ -24,6 +24,7 @@ import {
   type SyncResult,
 } from '../../schemas/issues'
 import { getProjectPath } from '../../schemas/schemas'
+import { getErrorMessage } from '../../types/fs'
 import { fileExists } from '../../utils/fs-helpers'
 import type { Issue } from '../issue-tracker/types'
 import { linearService } from './service'
@@ -60,7 +61,7 @@ export class LinearSync {
         } catch (err) {
           errors.push({
             issueId: issue.externalId || issue.id,
-            error: (err as Error).message,
+            error: getErrorMessage(err),
           })
         }
       }
@@ -85,7 +86,7 @@ export class LinearSync {
     } catch (err) {
       errors.push({
         issueId: 'all',
-        error: (err as Error).message,
+        error: getErrorMessage(err),
       })
       return {
         provider: 'linear',

package/core/plugin/builtin/webhook.ts

@@ -20,6 +20,7 @@
 import crypto from 'node:crypto'
 import { EventTypes } from '../../bus'
 import type { WebhookConfig, WebhookPayload, WebhookPluginContext } from '../../types'
+import { getErrorMessage } from '../../types/fs'
 import { HookPoints } from '../hooks'
 
 const plugin = {
@@ -139,7 +140,7 @@ const plugin = {
         console.error(`[webhook] Request failed: ${response.status}`)
       }
     } catch (error) {
-      console.error(`[webhook] Error sending webhook:`, (error as Error).message)
+      console.error(`[webhook] Error sending webhook:`, getErrorMessage(error))
     }
   },
 }

package/core/plugin/hooks.ts

@@ -8,6 +8,7 @@
  */
 
 import { EventTypes, eventBus } from '../bus'
+import { getErrorMessage } from '../types/fs'
 
 /**
  * Hook Points - Where plugins can intercept
@@ -144,7 +145,7 @@ class HookSystem {
           result = { ...result, ...(modified as Record<string, unknown>) }
         }
       } catch (error) {
-        console.error(`Hook error [${hook.pluginName}] at ${hookPoint}:`, (error as Error).message)
+        console.error(`Hook error [${hook.pluginName}] at ${hookPoint}:`, getErrorMessage(error))
         // Continue with other hooks
       }
     }
@@ -164,10 +165,7 @@ class HookSystem {
         try {
           await hook.handler(data)
         } catch (error) {
-          console.error(
-            `Hook error [${hook.pluginName}] at ${hookPoint}:`,
-            (error as Error).message
-          )
+          console.error(`Hook error [${hook.pluginName}] at ${hookPoint}:`, getErrorMessage(error))
         }
       })
     )
@@ -199,7 +197,7 @@ class HookSystem {
       } catch (error) {
         console.error(
           `Transform hook error [${hook.pluginName}] at ${hookPoint}:`,
-          (error as Error).message
+          getErrorMessage(error)
         )
         // Keep previous value on error
       }

package/core/plugin/loader.ts

@@ -13,7 +13,7 @@ import fs from 'node:fs/promises'
 import path from 'node:path'
 import { type EventCallback, eventBus } from '../bus'
 import pathManager from '../infrastructure/path-manager'
-import { isNotFoundError } from '../types/fs'
+import { getErrorMessage, isNotFoundError } from '../types/fs'
 import { hookSystem } from './hooks'
 
 type PluginSource = 'builtin' | 'global' | 'project'
@@ -162,7 +162,7 @@ class PluginLoader {
           await this.loadPlugin(fullPath, 'project', spec.config)
         }
       } catch (error) {
-        console.error(`Failed to load plugin: ${spec}`, (error as Error).message)
+        console.error(`Failed to load plugin: ${spec}`, getErrorMessage(error))
       }
     }
   }