prjct-cli 0.30.3 → 0.33.5

package/CHANGELOG.md

@@ -1,5 +1,123 @@
 # Changelog
 
+## [0.33.5] - 2026-01-13
+
+### Fix: Type Safety Improvements (PRJ-54)
+
+Remove unsafe `as unknown` type casts with proper TypeScript interfaces.
+
+**Changes:**
+- `GroundTruthContext` now uses `ContextPaths` directly
+- `chain-of-thought.ts` uses `Pick<ProjectContext, ...>` type alias
+- `command-executor.ts` uses `PromptContext` instead of `Record<string, unknown>`
+
+---
+
+## [0.33.4] - 2026-01-13
+
+### Refactor: Error Type Differentiation Phase 3 (PRJ-61)
+
+**Final phase** - Complete error differentiation across all 116 remaining catch blocks in 52 files.
+
+**Pattern Applied:**
+- `isNotFoundError()` for expected ENOENT errors
+- `instanceof SyntaxError` for JSON parse errors
+- `_error` capture for intentional catch-all blocks (network, git, etc.)
+- Unexpected errors propagate with `throw error`
+
+**Key Files Fixed:**
+- `core/storage/storage.ts` - Storage read/exists operations
+- `core/commands/shipping.ts` - Ship workflow error handling
+- `core/session/task-session-manager.ts` - Session management
+- `core/commands/cleanup.ts` - Cleanup operations
+- `core/agentic/context-builder.ts` - Context building
+- Plus 47 more files
+
+**Stats:**
+- Catches fixed this phase: 116
+- Total fixed (Phase 1+2+3): 185
+- Remaining: 0 empty catches
+
+---
+
+## [0.33.3] - 2026-01-13
+
+### Refactor: Error Type Differentiation Phase 2 (PRJ-60)
+
+**Continuation of PRJ-51** - Differentiate error types in 3 more files (14 catch blocks):
+
+**Files Modified:**
+- `core/domain/snapshot-manager.ts` - 6 catches (fs.access, fs.readFile, fs.unlink, JSON.parse)
+- `core/server/routes-extended.ts` - 2 catches (readJsonFile, writeJsonFile helpers)
+- `core/infrastructure/setup.ts` - 6 catches (migration, settings parsing, status line)
+
+**Pattern Applied:**
+- ENOENT errors → handled gracefully (expected for missing files)
+- SyntaxError → handled gracefully (expected for malformed JSON)
+- Other errors → propagated or logged (unexpected)
+
+**Stats:**
+- Catches fixed: 14
+- Total fixed (Phase 1+2): 69
+- Remaining: ~211 catches in 63 files
+
+---
+
+## [0.33.2] - 2026-01-13
+
+### Refactor: Error Type Differentiation (PRJ-51)
+
+**Problem:** 280 catch blocks across 69 files used empty `catch {}` which swallowed all errors without differentiating between expected (ENOENT) and unexpected errors.
+
+**Solution:** Phase 1 implementation - differentiate error types in 3 priority files (55 catch blocks):
+
+**Pattern Applied:**
+```typescript
+// Before
+} catch { return null }
+
+// After
+} catch (error) {
+  if (isNotFoundError(error)) return null      // Expected: file doesn't exist
+  if (error instanceof SyntaxError) return null // Expected: invalid JSON
+  throw error                                   // Unexpected: propagate
+}
+```
+
+**Files Modified:**
+- `core/agentic/ground-truth.ts` - 21 catches (verification functions)
+- `core/domain/analyzer.ts` - 18 catches (codebase analysis)
+- `core/infrastructure/command-installer.ts` - 16 catches (command management)
+
+**Tests Added:**
+- `core/__tests__/types/fs.test.ts` - 15 new tests for error utilities
+
+**Stats:**
+- Tests: 137 → 152 (+15)
+- Catches fixed: 55
+- Files: 4 (3 refactored + 1 test)
+
+---
+
+## [0.33.1] - 2026-01-13
+
+### Refactor: Code Quality Improvements
+
+**PRJ-58: Consolidate hardcoded paths to pathManager**
+- Added `getClaudeDir()`, `getClaudeCommandsDir()`, `getClaudeSettingsPath()` to pathManager
+- Refactored 6 files to use centralized path methods instead of `os.homedir()` concatenation
+- Files: `compaction.ts`, `generator.ts`, `routes-extended.ts`, `routes.ts`, `auth-config.ts`, `setup.ts`
+
+**PRJ-57: Simplify logger level detection**
+- Use `Set` for truthy values instead of multiple OR conditions
+- Remove redundant `'prjct'` equality check (covered by `includes`)
+- Use nullish coalescing (`??`) instead of ternary
+- Pre-compute level name to avoid runtime lookup
+- Add `createLogMethod()` factory to reduce repetition
+- File: `core/utils/logger.ts`
+
+---
+
 ## [0.30.3] - 2026-01-13
 
 ### Fix: Enrichment Not Enabled by Default

package/CLAUDE.md

@@ -91,6 +91,7 @@ User Action → Storage (JSON) → Context (MD) → Sync Events
 
 ## COMMANDS
 
+### Core Workflow
 | Trigger | Purpose |
 |---------|---------|
 | `p. init` | Initialize project with deep analysis |
@@ -102,11 +103,51 @@ User Action → Storage (JSON) → Context (MD) → Sync Events
 | `p. resume` | Resume paused task |
 | `p. bug <desc>` | Report bug with auto-priority |
 
+### Issue Tracker Integrations
+| Trigger | Purpose |
+|---------|---------|
+| `p. linear` | Linear issues (OAuth via MCP) |
+| `p. jira` | JIRA issues (OAuth/SSO via MCP) |
+| `p. github` | GitHub Issues (token via MCP) |
+| `p. monday` | Monday.com boards (OAuth via MCP) |
+| `p. enrich <ID>` | **AI-powered ticket enrichment** |
+
+### Ticket Enrichment (`p. enrich`)
+
+Transform vague PM tickets into technical PRDs:
+
+```
+PM creates: "Add user auth"
+            ↓
+p. enrich PRJ-59
+            ↓
+Architect analyzes codebase:
+- Similar implementations found
+- 5 files affected
+- OAuth2 approach recommended
+- 8 story points (not PM's guess of 2)
+            ↓
+Publishes PRD to tracker:
+- Technical approach
+- Acceptance criteria
+- LLM-ready prompt (for any AI tool)
+```
+
+**Subcommands:**
+- `p. enrich <ID>` - Enrich specific ticket
+- `p. enrich setup` - Configure team preferences (estimation, output)
+- `p. enrich batch` - Enrich all assigned tickets (backlog grooming)
+
 ### Workflow
 ```
 p. sync → p. task "description" → [work] → p. done → p. ship
 ```
 
+### With Issue Tracker
+```
+p. linear → p. enrich PRJ-59 → p. linear start PRJ-59 → [work] → p. done → p. ship
+```
+
 ---
 
 ## INTELLIGENT BEHAVIOR

package/assets/statusline/components/jira.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# prjct statusline - JIRA integration component
+# Displays the linked JIRA issue key and priority
+
+component_jira() {
+  component_enabled "jira" || return
+  [[ "${CONFIG_JIRA_ENABLED}" != "true" ]] && return
+
+  local cache_file="${CACHE_DIR}/jira.cache"
+  local issue_data=""
+
+  # Check cache first
+  if cache_valid "$cache_file" "$CONFIG_CACHE_TTL_JIRA"; then
+    issue_data=$(cat "$cache_file")
+  else
+    # Get project ID
+    local project_id=$(get_project_id)
+    [[ -z "$project_id" ]] && return
+
+    local global_path="${HOME}/.prjct-cli/projects/${project_id}"
+    local state_file="${global_path}/storage/state.json"
+    local issues_file="${global_path}/storage/issues.json"
+
+    # Check if state file exists
+    [[ ! -f "$state_file" ]] && return
+
+    # Get linked issue from current task
+    local linked_issue=""
+
+    # First check if current task has a linked JIRA issue
+    local linked_provider=$(jq -r '.currentTask.linkedIssue.provider // ""' "$state_file" 2>/dev/null)
+    if [[ "$linked_provider" == "jira" ]]; then
+      linked_issue=$(jq -r '.currentTask.linkedIssue.id // ""' "$state_file" 2>/dev/null)
+    fi
+
+    # If no linked issue, try to get from issues.json (last worked)
+    if [[ -z "$linked_issue" ]] && [[ -f "$issues_file" ]]; then
+      # Check if issues.json is for JIRA
+      local provider=$(jq -r '.provider // ""' "$issues_file" 2>/dev/null)
+      if [[ "$provider" == "jira" ]]; then
+        # Get most recently updated issue that's in_progress
+        linked_issue=$(jq -r '
+          .issues // {} | to_entries
+          | map(select(.value.status == "in_progress"))
+          | sort_by(.value.updatedAt) | last
+          | .key // ""
+        ' "$issues_file" 2>/dev/null)
+      fi
+    fi
+
+    [[ -z "$linked_issue" ]] && return
+
+    # Get issue details from issues cache
+    if [[ -f "$issues_file" ]]; then
+      issue_data=$(jq -r --arg id "$linked_issue" '
+        .issues[$id] // {} |
+        "\(.externalId // "")|\(.priority // "none")|\(.status // "")"
+      ' "$issues_file" 2>/dev/null)
+
+      # Cache the result
+      write_cache "$cache_file" "$issue_data"
+    fi
+  fi
+
+  # Return empty if no data
+  [[ -z "$issue_data" || "$issue_data" == "||" ]] && return
+
+  # Parse issue data
+  local issue_key=$(echo "$issue_data" | cut -d'|' -f1)
+  local priority=$(echo "$issue_data" | cut -d'|' -f2)
+  local status=$(echo "$issue_data" | cut -d'|' -f3)
+
+  [[ -z "$issue_key" ]] && return
+
+  # Format output with JIRA-style coloring
+  local output=""
+
+  # Add status indicator if enabled
+  if [[ "${CONFIG_JIRA_SHOW_STATUS}" == "true" ]] && [[ -n "$status" ]]; then
+    local status_icon=$(get_jira_status_icon "$status")
+    [[ -n "$status_icon" ]] && output+="${status_icon} "
+  fi
+
+  # Issue key
+  output+="${ACCENT}${issue_key}${NC}"
+
+  # Add priority icon if enabled and priority is significant
+  if [[ "${CONFIG_JIRA_SHOW_PRIORITY}" == "true" ]]; then
+    local priority_icon=$(get_priority_icon "$priority")
+    [[ -n "$priority_icon" ]] && output+=" ${priority_icon}"
+  fi
+
+  echo -e "$output"
+}
+
+# Get JIRA-specific status icon
+get_jira_status_icon() {
+  local status="$1"
+  case "$status" in
+    backlog)      echo "📋" ;;
+    todo)         echo "📝" ;;
+    in_progress)  echo "🔄" ;;
+    in_review)    echo "👀" ;;
+    done)         echo "✅" ;;
+    cancelled)    echo "❌" ;;
+    *)            echo "" ;;
+  esac
+}

package/assets/statusline/default-config.json

@@ -4,7 +4,8 @@
   "cacheTTL": {
     "prjct": 30,
     "git": 5,
-    "linear": 60
+    "linear": 60,
+    "jira": 60
   },
   "components": {
     "prjct_icon": {
@@ -21,6 +22,12 @@
       "position": 2,
       "showPriority": true
     },
+    "jira": {
+      "enabled": false,
+      "position": 2,
+      "showPriority": true,
+      "showStatus": false
+    },
     "dir": {
       "enabled": true,
       "position": 3

package/assets/statusline/lib/config.sh

@@ -10,6 +10,7 @@ DEFAULT_THEME="default"
 DEFAULT_CACHE_TTL_PRJCT=30
 DEFAULT_CACHE_TTL_GIT=5
 DEFAULT_CACHE_TTL_LINEAR=60
+DEFAULT_CACHE_TTL_JIRA=60
 DEFAULT_TASK_MAX_LENGTH=25
 DEFAULT_CONTEXT_MIN_PERCENT=30
 DEFAULT_ENRICHMENT_ENABLED="true"
@@ -26,16 +27,21 @@ load_config() {
   CONFIG_CACHE_TTL_PRJCT="$DEFAULT_CACHE_TTL_PRJCT"
   CONFIG_CACHE_TTL_GIT="$DEFAULT_CACHE_TTL_GIT"
   CONFIG_CACHE_TTL_LINEAR="$DEFAULT_CACHE_TTL_LINEAR"
+  CONFIG_CACHE_TTL_JIRA="$DEFAULT_CACHE_TTL_JIRA"
   CONFIG_TASK_MAX_LENGTH="$DEFAULT_TASK_MAX_LENGTH"
   CONFIG_CONTEXT_MIN_PERCENT="$DEFAULT_CONTEXT_MIN_PERCENT"
   CONFIG_LINEAR_ENABLED="true"
   CONFIG_LINEAR_SHOW_PRIORITY="true"
+  CONFIG_JIRA_ENABLED="false"
+  CONFIG_JIRA_SHOW_PRIORITY="true"
+  CONFIG_JIRA_SHOW_STATUS="false"
   CONFIG_ENRICHMENT_ENABLED="$DEFAULT_ENRICHMENT_ENABLED"
 
   # Default component configuration
   COMPONENT_ENABLED["prjct_icon"]="true"
   COMPONENT_ENABLED["task"]="true"
   COMPONENT_ENABLED["linear"]="true"
+  COMPONENT_ENABLED["jira"]="false"
   COMPONENT_ENABLED["dir"]="true"
   COMPONENT_ENABLED["git"]="true"
   COMPONENT_ENABLED["changes"]="true"
@@ -45,6 +51,7 @@ load_config() {
   COMPONENT_POSITION["prjct_icon"]=0
   COMPONENT_POSITION["task"]=1
   COMPONENT_POSITION["linear"]=2
+  COMPONENT_POSITION["jira"]=2
   COMPONENT_POSITION["dir"]=3
   COMPONENT_POSITION["git"]=4
   COMPONENT_POSITION["changes"]=5
@@ -63,12 +70,16 @@ load_config() {
       (.cacheTTL.prjct // 30),
       (.cacheTTL.git // 5),
       (.cacheTTL.linear // 60),
+      (.cacheTTL.jira // 60),
       (.components.task.maxLength // 25),
       (.components.context.minPercent // 30),
       (if .components.linear.showPriority == null then true else .components.linear.showPriority end),
+      (if .components.jira.showPriority == null then true else .components.jira.showPriority end),
+      (if .components.jira.showStatus == null then false else .components.jira.showStatus end),
       (if .components.prjct_icon.enabled == null then true else .components.prjct_icon.enabled end),
       (if .components.task.enabled == null then true else .components.task.enabled end),
       (if .components.linear.enabled == null then true else .components.linear.enabled end),
+      (if .components.jira.enabled == null then false else .components.jira.enabled end),
       (if .components.dir.enabled == null then true else .components.dir.enabled end),
       (if .components.git.enabled == null then true else .components.git.enabled end),
       (if .components.changes.enabled == null then true else .components.changes.enabled end),
@@ -78,6 +89,7 @@ load_config() {
       (.components.prjct_icon.position // 0),
       (.components.task.position // 1),
       (.components.linear.position // 2),
+      (.components.jira.position // 2),
       (.components.dir.position // 3),
       (.components.git.position // 4),
       (.components.changes.position // 5),
@@ -92,10 +104,11 @@ load_config() {
   local old_ifs="$IFS"
   IFS=$'\t' read -r \
     CONFIG_THEME \
-    CONFIG_CACHE_TTL_PRJCT CONFIG_CACHE_TTL_GIT CONFIG_CACHE_TTL_LINEAR \
-    CONFIG_TASK_MAX_LENGTH CONFIG_CONTEXT_MIN_PERCENT CONFIG_LINEAR_SHOW_PRIORITY \
-    E_PRJCT_ICON E_TASK E_LINEAR E_DIR E_GIT E_CHANGES E_CONTEXT E_MODEL E_ENRICHMENT \
-    P_PRJCT_ICON P_TASK P_LINEAR P_DIR P_GIT P_CHANGES P_CONTEXT P_MODEL \
+    CONFIG_CACHE_TTL_PRJCT CONFIG_CACHE_TTL_GIT CONFIG_CACHE_TTL_LINEAR CONFIG_CACHE_TTL_JIRA \
+    CONFIG_TASK_MAX_LENGTH CONFIG_CONTEXT_MIN_PERCENT \
+    CONFIG_LINEAR_SHOW_PRIORITY CONFIG_JIRA_SHOW_PRIORITY CONFIG_JIRA_SHOW_STATUS \
+    E_PRJCT_ICON E_TASK E_LINEAR E_JIRA E_DIR E_GIT E_CHANGES E_CONTEXT E_MODEL E_ENRICHMENT \
+    P_PRJCT_ICON P_TASK P_LINEAR P_JIRA P_DIR P_GIT P_CHANGES P_CONTEXT P_MODEL \
     <<< "$config_data"
   IFS="$old_ifs"
 
@@ -103,6 +116,7 @@ load_config() {
   COMPONENT_ENABLED["prjct_icon"]="$E_PRJCT_ICON"
   COMPONENT_ENABLED["task"]="$E_TASK"
   COMPONENT_ENABLED["linear"]="$E_LINEAR"
+  COMPONENT_ENABLED["jira"]="$E_JIRA"
   COMPONENT_ENABLED["dir"]="$E_DIR"
   COMPONENT_ENABLED["git"]="$E_GIT"
   COMPONENT_ENABLED["changes"]="$E_CHANGES"
@@ -113,14 +127,16 @@ load_config() {
   COMPONENT_POSITION["prjct_icon"]="$P_PRJCT_ICON"
   COMPONENT_POSITION["task"]="$P_TASK"
   COMPONENT_POSITION["linear"]="$P_LINEAR"
+  COMPONENT_POSITION["jira"]="$P_JIRA"
   COMPONENT_POSITION["dir"]="$P_DIR"
   COMPONENT_POSITION["git"]="$P_GIT"
   COMPONENT_POSITION["changes"]="$P_CHANGES"
   COMPONENT_POSITION["context"]="$P_CONTEXT"
   COMPONENT_POSITION["model"]="$P_MODEL"
 
-  # Update linear enabled based on component config
+  # Update linear/jira enabled based on component config
   CONFIG_LINEAR_ENABLED="${COMPONENT_ENABLED["linear"]}"
+  CONFIG_JIRA_ENABLED="${COMPONENT_ENABLED["jira"]}"
 
   # Update enrichment enabled from config
   [[ -n "$E_ENRICHMENT" ]] && CONFIG_ENRICHMENT_ENABLED="$E_ENRICHMENT"

package/core/__tests__/agentic/memory-system.test.ts

@@ -253,7 +253,7 @@ describe('MemorySystem P3.3', () => {
     try {
       const testPath = pathManager.getGlobalProjectPath(TEST_PROJECT_ID)
       await fs.rm(testPath, { recursive: true, force: true })
-    } catch {
+    } catch (_error) {
       // Ignore cleanup errors
     }
   })
@@ -261,7 +261,7 @@ describe('MemorySystem P3.3', () => {
   afterAll(async () => {
     try {
       await fs.rm(TEST_GLOBAL_BASE_DIR, { recursive: true, force: true })
-    } catch {
+    } catch (_error) {
       // Ignore cleanup errors
     }
   })

package/core/__tests__/types/fs.test.ts

@@ -0,0 +1,125 @@
+/**
+ * FS Types Tests
+ * Tests for file system error utilities
+ */
+
+import { describe, it, expect } from 'bun:test'
+import {
+  isNotFoundError,
+  isPermissionError,
+  isDirNotEmptyError,
+  isFileExistsError,
+  isNodeError,
+} from '../../types/fs'
+
+describe('FS Error Utilities', () => {
+  describe('isNotFoundError', () => {
+    it('should return true for ENOENT error', () => {
+      const error = new Error('File not found') as NodeJS.ErrnoException
+      error.code = 'ENOENT'
+      expect(isNotFoundError(error)).toBe(true)
+    })
+
+    it('should return false for other error codes', () => {
+      const error = new Error('Permission denied') as NodeJS.ErrnoException
+      error.code = 'EACCES'
+      expect(isNotFoundError(error)).toBe(false)
+    })
+
+    it('should return false for errors without code', () => {
+      const error = new Error('Generic error')
+      expect(isNotFoundError(error)).toBe(false)
+    })
+
+    it('should return false for non-error values', () => {
+      expect(isNotFoundError(null)).toBe(false)
+      expect(isNotFoundError(undefined)).toBe(false)
+      expect(isNotFoundError('string')).toBe(false)
+    })
+  })
+
+  describe('isPermissionError', () => {
+    it('should return true for EACCES error', () => {
+      const error = new Error('Permission denied') as NodeJS.ErrnoException
+      error.code = 'EACCES'
+      expect(isPermissionError(error)).toBe(true)
+    })
+
+    it('should return true for EPERM error', () => {
+      const error = new Error('Operation not permitted') as NodeJS.ErrnoException
+      error.code = 'EPERM'
+      expect(isPermissionError(error)).toBe(true)
+    })
+
+    it('should return false for other error codes', () => {
+      const error = new Error('File not found') as NodeJS.ErrnoException
+      error.code = 'ENOENT'
+      expect(isPermissionError(error)).toBe(false)
+    })
+  })
+
+  describe('isDirNotEmptyError', () => {
+    it('should return true for ENOTEMPTY error', () => {
+      const error = new Error('Directory not empty') as NodeJS.ErrnoException
+      error.code = 'ENOTEMPTY'
+      expect(isDirNotEmptyError(error)).toBe(true)
+    })
+
+    it('should return false for other error codes', () => {
+      const error = new Error('File not found') as NodeJS.ErrnoException
+      error.code = 'ENOENT'
+      expect(isDirNotEmptyError(error)).toBe(false)
+    })
+  })
+
+  describe('isFileExistsError', () => {
+    it('should return true for EEXIST error', () => {
+      const error = new Error('File exists') as NodeJS.ErrnoException
+      error.code = 'EEXIST'
+      expect(isFileExistsError(error)).toBe(true)
+    })
+
+    it('should return false for other error codes', () => {
+      const error = new Error('File not found') as NodeJS.ErrnoException
+      error.code = 'ENOENT'
+      expect(isFileExistsError(error)).toBe(false)
+    })
+  })
+
+  describe('isNodeError', () => {
+    it('should return true for Error with code property', () => {
+      const error = new Error('File not found') as NodeJS.ErrnoException
+      error.code = 'ENOENT'
+      expect(isNodeError(error)).toBe(true)
+    })
+
+    it('should return false for Error without code property', () => {
+      const error = new Error('Generic error')
+      expect(isNodeError(error)).toBe(false)
+    })
+
+    it('should return false for non-Error values', () => {
+      expect(isNodeError(null)).toBe(false)
+      expect(isNodeError({ code: 'ENOENT' })).toBe(false) // Not an Error instance
+    })
+  })
+
+  describe('SyntaxError handling pattern', () => {
+    it('should differentiate SyntaxError from fs errors', () => {
+      const syntaxError = new SyntaxError('Unexpected token')
+      const fsError = new Error('File not found') as NodeJS.ErrnoException
+      fsError.code = 'ENOENT'
+
+      // Pattern used in code
+      const handleError = (error: unknown): string => {
+        if (isNotFoundError(error)) return 'not-found'
+        if (error instanceof SyntaxError) return 'parse-error'
+        return 'other'
+      }
+
+      expect(handleError(fsError)).toBe('not-found')
+      expect(handleError(syntaxError)).toBe('parse-error')
+      expect(handleError(new Error('Other'))).toBe('other')
+    })
+  })
+})

package/core/agentic/agent-router.ts

@@ -15,6 +15,7 @@ import fs from 'fs/promises'
 import path from 'path'
 import configManager from '../infrastructure/config-manager'
 import pathManager from '../infrastructure/path-manager'
+import { isNotFoundError } from '../types/fs'
 import type { Agent, AssignmentContext } from '../types'
 
 // Re-export types for convenience
@@ -57,7 +58,11 @@ class AgentRouter {
       }
 
       return agents
-    } catch {
+    } catch (error) {
+      // Agents directory doesn't exist yet - expected for new projects
+      if (!isNotFoundError(error)) {
+        console.error(`Agent loading error: ${(error as Error).message}`)
+      }
       return []
     }
   }
@@ -80,7 +85,11 @@ class AgentRouter {
       const filePath = path.join(this.agentsPath, `${name}.md`)
       const content = await fs.readFile(filePath, 'utf-8')
       return { name, content }
-    } catch {
+    } catch (error) {
+      // Agent file doesn't exist - expected
+      if (!isNotFoundError(error)) {
+        console.error(`Agent load error: ${(error as Error).message}`)
+      }
       return null
     }
   }
@@ -130,8 +139,11 @@ class AgentRouter {
         }) + '\n'
 
       await fs.appendFile(logPath, entry)
-    } catch {
-      // Silent fail for logging
+    } catch (error) {
+      // Non-critical - log unexpected errors but don't fail
+      if (!isNotFoundError(error)) {
+        console.error(`Agent usage log error: ${(error as Error).message}`)
+      }
     }
   }
 }

package/core/agentic/chain-of-thought.ts

@@ -6,19 +6,11 @@
  * @version 1.0.0
  */
 
-interface Context {
-  projectId?: string | null
-  projectPath: string
-  params: Record<string, unknown>
-}
+import type { ProjectContext, ContextState } from '../types'
 
-interface State {
-  now?: string | null
-  next?: string | null
-  shipped?: string | null
-  analysis?: string | null
-  [key: string]: unknown
-}
+// Type aliases for compatibility with ProjectContext from contextBuilder.build()
+type Context = Pick<ProjectContext, 'projectId' | 'projectPath' | 'params'>
+type State = ContextState
 
 interface ReasoningStep {
   step: string