prjct-cli 0.45.0 → 0.45.3

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

@@ -3,26 +3,26 @@
  * Orchestrates multiple issue tracker providers and enrichment.
  */
 
-import type {
-  IssueTrackerProvider,
-  IssueTrackerConfig,
-  Issue,
-  EnrichedIssue,
-  SyncResult,
-  FetchOptions,
-  CreateIssueInput,
-  IssueProvider,
-} from './types'
+import { jiraProvider } from '../jira/client'
+import { linearProvider } from '../linear/client'
 import {
-  generateEnrichmentPrompt,
   buildEnrichedIssue,
+  type EnrichmentResult,
   formatEnrichmentAsMarkdown,
+  generateEnrichmentPrompt,
   generateQuickEnrichment,
   type ProjectContext,
-  type EnrichmentResult,
 } from './enricher'
-import { linearProvider } from '../linear/client'
-import { jiraProvider } from '../jira/client'
+import type {
+  CreateIssueInput,
+  EnrichedIssue,
+  FetchOptions,
+  Issue,
+  IssueProvider,
+  IssueTrackerConfig,
+  IssueTrackerProvider,
+  SyncResult,
+} from './types'
 
 // =============================================================================
 // Manager Class
@@ -232,7 +232,7 @@ export class IssueTrackerManager {
         for (const issue of issues) {
           try {
             // Generate prompt (actual AI execution is external)
-            const prompt = this.getEnrichmentPrompt(issue, projectContext)
+            const _prompt = this.getEnrichmentPrompt(issue, projectContext)
             console.log(`[issue-tracker] Enrichment prompt ready for ${issue.externalId}`)
 
             // For now, use quick enrichment as placeholder

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

@@ -95,28 +95,11 @@ export interface UpdateIssueInput {
 
 export type IssueProvider = 'linear' | 'jira' | 'monday' | 'github' | 'asana' | 'none'
 
-export type IssueStatus =
-  | 'backlog'
-  | 'todo'
-  | 'in_progress'
-  | 'in_review'
-  | 'done'
-  | 'cancelled'
-
-export type IssuePriority =
-  | 'none'
-  | 'urgent'
-  | 'high'
-  | 'medium'
-  | 'low'
-
-export type IssueType =
-  | 'feature'
-  | 'bug'
-  | 'improvement'
-  | 'task'
-  | 'chore'
-  | 'epic'
+export type IssueStatus = 'backlog' | 'todo' | 'in_progress' | 'in_review' | 'done' | 'cancelled'
+
+export type IssuePriority = 'none' | 'urgent' | 'high' | 'medium' | 'low'
+
+export type IssueType = 'feature' | 'bug' | 'improvement' | 'task' | 'chore' | 'epic'
 
 // =============================================================================
 // Provider Interface

package/core/integrations/jira/client.ts

@@ -15,15 +15,15 @@
  */
 
 import type {
-  IssueTrackerProvider,
-  Issue,
   CreateIssueInput,
-  UpdateIssueInput,
   FetchOptions,
-  JiraConfig,
-  IssueStatus,
+  Issue,
   IssuePriority,
+  IssueStatus,
+  IssueTrackerProvider,
   IssueType,
+  JiraConfig,
+  UpdateIssueInput,
 } from '../issue-tracker/types'
 
 // =============================================================================
@@ -36,13 +36,16 @@ interface JiraIssue {
   self: string
   fields: {
     summary: string
-    description?: {
-      type: string
-      content: Array<{
-        type: string
-        content?: Array<{ type: string; text?: string }>
-      }>
-    } | string | null
+    description?:
+      | {
+          type: string
+          content: Array<{
+            type: string
+            content?: Array<{ type: string; text?: string }>
+          }>
+        }
+      | string
+      | null
     status: {
       id: string
       name: string
@@ -114,7 +117,7 @@ const JIRA_STATUS_CATEGORY_MAP: Record<string, IssueStatus> = {
 const JIRA_STATUS_NAME_MAP: Record<string, IssueStatus> = {
   // Backlog states
   backlog: 'backlog',
-  'open': 'backlog',
+  open: 'backlog',
   'to do': 'todo',
   todo: 'todo',
   new: 'todo',
@@ -124,7 +127,7 @@ const JIRA_STATUS_NAME_MAP: Record<string, IssueStatus> = {
   'in development': 'in_progress',
   'in review': 'in_review',
   'code review': 'in_review',
-  'review': 'in_review',
+  review: 'in_review',
 
   // Done states
   done: 'done',
@@ -241,13 +244,19 @@ export class JiraProvider implements IssueTrackerProvider {
 
       // Verify connection by fetching current user
       try {
-        const response = await this.request<{ accountId: string; displayName: string; emailAddress?: string }>('/rest/api/3/myself')
+        const response = await this.request<{
+          accountId: string
+          displayName: string
+          emailAddress?: string
+        }>('/rest/api/3/myself')
         this.currentUser = {
           accountId: response.accountId,
           displayName: response.displayName,
           email: response.emailAddress,
         }
-        console.log(`[jira] Connected as ${this.currentUser.displayName} (${this.currentUser.email || 'no email'})`)
+        console.log(
+          `[jira] Connected as ${this.currentUser.displayName} (${this.currentUser.email || 'no email'})`
+        )
       } catch (error) {
         this.baseUrl = ''
         this.auth = ''
@@ -360,7 +369,7 @@ export class JiraProvider implements IssueTrackerProvider {
 
     // Add optional fields
     if (input.description) {
-      (payload.fields as Record<string, unknown>).description = {
+      ;(payload.fields as Record<string, unknown>).description = {
         type: 'doc',
         version: 1,
         content: [
@@ -373,28 +382,25 @@ export class JiraProvider implements IssueTrackerProvider {
     }
 
     if (input.priority) {
-      (payload.fields as Record<string, unknown>).priority = {
+      ;(payload.fields as Record<string, unknown>).priority = {
         name: PRIORITY_TO_JIRA[input.priority],
       }
     }
 
     if (input.labels?.length) {
-      (payload.fields as Record<string, unknown>).labels = input.labels
+      ;(payload.fields as Record<string, unknown>).labels = input.labels
     }
 
     if (input.assigneeId) {
-      (payload.fields as Record<string, unknown>).assignee = {
+      ;(payload.fields as Record<string, unknown>).assignee = {
         accountId: input.assigneeId,
       }
     }
 
-    const created = await this.request<{ id: string; key: string }>(
-      '/rest/api/3/issue',
-      {
-        method: 'POST',
-        body: JSON.stringify(payload),
-      }
-    )
+    const created = await this.request<{ id: string; key: string }>('/rest/api/3/issue', {
+      method: 'POST',
+      body: JSON.stringify(payload),
+    })
 
     // Fetch the full issue
     const issue = await this.fetchIssue(created.key)
@@ -414,7 +420,7 @@ export class JiraProvider implements IssueTrackerProvider {
     const payload: Record<string, unknown> = { fields: {} }
 
     if (input.description) {
-      (payload.fields as Record<string, unknown>).description = {
+      ;(payload.fields as Record<string, unknown>).description = {
         type: 'doc',
         version: 1,
         content: this.markdownToADF(input.description),
@@ -442,9 +448,9 @@ export class JiraProvider implements IssueTrackerProvider {
     if (!this.isConfigured()) throw new Error('JIRA not initialized')
 
     // Get available transitions
-    const transitions = await this.request<{ transitions: Array<{ id: string; name: string; to: { statusCategory: { key: string } } }> }>(
-      `/rest/api/3/issue/${id}/transitions`
-    )
+    const transitions = await this.request<{
+      transitions: Array<{ id: string; name: string; to: { statusCategory: { key: string } } }>
+    }>(`/rest/api/3/issue/${id}/transitions`)
 
     // Find transition to "in progress" state
     const inProgressTransition = transitions.transitions.find(
@@ -469,9 +475,9 @@ export class JiraProvider implements IssueTrackerProvider {
     if (!this.isConfigured()) throw new Error('JIRA not initialized')
 
     // Get available transitions
-    const transitions = await this.request<{ transitions: Array<{ id: string; name: string; to: { statusCategory: { key: string } } }> }>(
-      `/rest/api/3/issue/${id}/transitions`
-    )
+    const transitions = await this.request<{
+      transitions: Array<{ id: string; name: string; to: { statusCategory: { key: string } } }>
+    }>(`/rest/api/3/issue/${id}/transitions`)
 
     // Find transition to "done" state
     const doneTransition = transitions.transitions.find(
@@ -556,9 +562,7 @@ export class JiraProvider implements IssueTrackerProvider {
 
     // Try exact status name match first, then category
     const status: IssueStatus =
-      JIRA_STATUS_NAME_MAP[statusName] ||
-      JIRA_STATUS_CATEGORY_MAP[statusCategory] ||
-      'backlog'
+      JIRA_STATUS_NAME_MAP[statusName] || JIRA_STATUS_CATEGORY_MAP[statusCategory] || 'backlog'
 
     const priorityName = jiraIssue.fields.priority?.name?.toLowerCase() || 'medium'
     const priority: IssuePriority = JIRA_PRIORITY_MAP[priorityName] || 'medium'
@@ -599,9 +603,7 @@ export class JiraProvider implements IssueTrackerProvider {
   /**
    * Extract plain text from JIRA description (ADF or string)
    */
-  private extractDescription(
-    description: JiraIssue['fields']['description']
-  ): string | undefined {
+  private extractDescription(description: JiraIssue['fields']['description']): string | undefined {
     if (!description) return undefined
 
     // Handle string descriptions (older JIRA versions)
@@ -661,34 +663,42 @@ export class JiraProvider implements IssueTrackerProvider {
         content.push({
           type: 'taskList',
           attrs: { localId: crypto.randomUUID() },
-          content: [{
-            type: 'taskItem',
-            attrs: { localId: crypto.randomUUID(), state: 'TODO' },
-            content: [{ type: 'text', text: line.slice(6) }],
-          }],
+          content: [
+            {
+              type: 'taskItem',
+              attrs: { localId: crypto.randomUUID(), state: 'TODO' },
+              content: [{ type: 'text', text: line.slice(6) }],
+            },
+          ],
         })
       } else if (line.startsWith('- [x] ')) {
         // Checkbox checked
         content.push({
           type: 'taskList',
           attrs: { localId: crypto.randomUUID() },
-          content: [{
-            type: 'taskItem',
-            attrs: { localId: crypto.randomUUID(), state: 'DONE' },
-            content: [{ type: 'text', text: line.slice(6) }],
-          }],
+          content: [
+            {
+              type: 'taskItem',
+              attrs: { localId: crypto.randomUUID(), state: 'DONE' },
+              content: [{ type: 'text', text: line.slice(6) }],
+            },
+          ],
         })
       } else if (line.startsWith('- ')) {
         // Bullet point
         content.push({
           type: 'bulletList',
-          content: [{
-            type: 'listItem',
-            content: [{
-              type: 'paragraph',
-              content: [{ type: 'text', text: line.slice(2) }],
-            }],
-          }],
+          content: [
+            {
+              type: 'listItem',
+              content: [
+                {
+                  type: 'paragraph',
+                  content: [{ type: 'text', text: line.slice(2) }],
+                },
+              ],
+            },
+          ],
         })
       } else if (line.trim()) {
         // Regular paragraph
@@ -741,8 +751,6 @@ export class JiraProvider implements IssueTrackerProvider {
         return 'Improvement'
       case 'epic':
         return 'Epic'
-      case 'chore':
-      case 'task':
       default:
         return 'Task'
     }

package/core/integrations/jira/index.ts

@@ -9,33 +9,30 @@
  *    - JIRA_API_TOKEN: API token from https://id.atlassian.com/manage-profile/security/api-tokens
  */
 
-// REST API client
-export { JiraProvider, jiraProvider, type JiraAuthMode } from './client'
-
-// Service layer with caching (preferred API)
-export { JiraService, jiraService } from './service'
-
 // Cache utilities
 export {
-  issueCache,
   assignedIssuesCache,
-  projectsCache,
   clearJiraCache,
   getJiraCacheStats,
+  issueCache,
+  projectsCache,
 } from './cache'
-
+// REST API client
+export { type JiraAuthMode, JiraProvider, jiraProvider } from './client'
 // MCP adapter (deprecated - will be removed)
 export {
-  JiraMCPAdapter,
-  jiraMCPAdapter,
+  createCreateIssueInstruction,
+  createGetIssueInstruction,
   // MCP instruction generators
   createSearchInstruction,
-  createGetIssueInstruction,
   createTransitionInstruction,
   createUpdateInstruction,
-  createCreateIssueInstruction,
+  getMCPSetupInstructions,
   // Utilities
   isMCPAvailable,
-  getMCPSetupInstructions,
+  JiraMCPAdapter,
+  jiraMCPAdapter,
   type MCPInstruction,
 } from './mcp-adapter'
+// Service layer with caching (preferred API)
+export { JiraService, jiraService } from './service'

package/core/integrations/jira/mcp-adapter.ts

@@ -19,15 +19,14 @@
  */
 
 import type {
-  IssueTrackerProvider,
-  Issue,
   CreateIssueInput,
-  UpdateIssueInput,
   FetchOptions,
-  JiraConfig,
-  IssueStatus,
+  Issue,
   IssuePriority,
+  IssueStatus,
+  IssueTrackerProvider,
   IssueType,
+  JiraConfig,
 } from '../issue-tracker/types'
 
 // =============================================================================
@@ -323,9 +322,7 @@ export class JiraMCPAdapter implements Partial<IssueTrackerProvider> {
     const statusCategory = mcpIssue.fields.status.statusCategory?.key || ''
 
     const status: IssueStatus =
-      JIRA_STATUS_NAME_MAP[statusName] ||
-      JIRA_STATUS_CATEGORY_MAP[statusCategory] ||
-      'backlog'
+      JIRA_STATUS_NAME_MAP[statusName] || JIRA_STATUS_CATEGORY_MAP[statusCategory] || 'backlog'
 
     const priorityName = mcpIssue.fields.priority?.name?.toLowerCase() || 'medium'
     const priority: IssuePriority = JIRA_PRIORITY_MAP[priorityName] || 'medium'
@@ -400,8 +397,6 @@ export class JiraMCPAdapter implements Partial<IssueTrackerProvider> {
         return 'Improvement'
       case 'epic':
         return 'Epic'
-      case 'chore':
-      case 'task':
       default:
         return 'Task'
     }

package/core/integrations/jira/service.ts

@@ -4,21 +4,21 @@
  * All operations are cached with 5-minute TTL.
  */
 
-import { jiraProvider } from './client'
-import {
-  issueCache,
-  assignedIssuesCache,
-  projectsCache,
-  clearJiraCache,
-  getJiraCacheStats,
-} from './cache'
 import type {
-  Issue,
   CreateIssueInput,
-  UpdateIssueInput,
   FetchOptions,
+  Issue,
   JiraConfig,
+  UpdateIssueInput,
 } from '../issue-tracker/types'
+import {
+  assignedIssuesCache,
+  clearJiraCache,
+  getJiraCacheStats,
+  issueCache,
+  projectsCache,
+} from './cache'
+import { jiraProvider } from './client'
 
 export class JiraService {
   private initialized = false

package/core/integrations/linear/client.ts

@@ -6,15 +6,15 @@
 import { LinearClient as LinearSDK } from '@linear/sdk'
 import { getCredential } from '../../utils/keychain'
 import type {
-  IssueTrackerProvider,
-  Issue,
   CreateIssueInput,
-  UpdateIssueInput,
   FetchOptions,
-  LinearConfig,
-  IssueStatus,
+  Issue,
   IssuePriority,
+  IssueStatus,
+  IssueTrackerProvider,
   IssueType,
+  LinearConfig,
+  UpdateIssueInput,
 } from '../issue-tracker/types'
 
 // =============================================================================
@@ -74,9 +74,7 @@ export class LinearProvider implements IssueTrackerProvider {
     // Try config first, then keychain (which falls back to env var)
     const apiKey = config.apiKey || (await getCredential('linear-api-key'))
     if (!apiKey) {
-      throw new Error(
-        'LINEAR_API_KEY not configured. Run `p. linear setup` to configure.'
-      )
+      throw new Error('LINEAR_API_KEY not configured. Run `p. linear setup` to configure.')
     }
 
     this.sdk = new LinearSDK({ apiKey })
@@ -118,9 +116,7 @@ export class LinearProvider implements IssueTrackerProvider {
       filter: Object.keys(filter).length > 0 ? filter : undefined,
     })
 
-    return Promise.all(
-      assignedIssues.nodes.map((issue) => this.mapIssue(issue))
-    )
+    return Promise.all(assignedIssues.nodes.map((issue) => this.mapIssue(issue)))
   }
 
   /**
@@ -356,7 +352,10 @@ export class LinearProvider implements IssueTrackerProvider {
       description: linearIssue.description || undefined,
       status: LINEAR_STATUS_MAP[state?.type || 'backlog'] || 'backlog',
       priority: LINEAR_PRIORITY_MAP[linearIssue.priority] || 'none',
-      type: this.inferType(linearIssue.title, labels.nodes.map((l) => l.name)),
+      type: this.inferType(
+        linearIssue.title,
+        labels.nodes.map((l) => l.name)
+      ),
       assignee: assignee
         ? {
             id: assignee.id,
@@ -395,13 +394,25 @@ export class LinearProvider implements IssueTrackerProvider {
     if (labelsLower.includes('bug') || titleLower.includes('fix') || titleLower.includes('bug')) {
       return 'bug'
     }
-    if (labelsLower.includes('feature') || titleLower.includes('add') || titleLower.includes('implement')) {
+    if (
+      labelsLower.includes('feature') ||
+      titleLower.includes('add') ||
+      titleLower.includes('implement')
+    ) {
       return 'feature'
     }
-    if (labelsLower.includes('improvement') || titleLower.includes('improve') || titleLower.includes('enhance')) {
+    if (
+      labelsLower.includes('improvement') ||
+      titleLower.includes('improve') ||
+      titleLower.includes('enhance')
+    ) {
       return 'improvement'
     }
-    if (labelsLower.includes('chore') || titleLower.includes('chore') || titleLower.includes('deps')) {
+    if (
+      labelsLower.includes('chore') ||
+      titleLower.includes('chore') ||
+      titleLower.includes('deps')
+    ) {
       return 'chore'
     }
 
@@ -417,9 +428,7 @@ export class LinearProvider implements IssueTrackerProvider {
     const team = await this.sdk.team(teamId)
     const labels = await team.labels()
 
-    return labels.nodes
-      .filter((label) => labelNames.includes(label.name))
-      .map((label) => label.id)
+    return labels.nodes.filter((label) => labelNames.includes(label.name)).map((label) => label.id)
   }
 }
 

package/core/integrations/linear/index.ts

@@ -3,21 +3,18 @@
  * Issue tracker provider for Linear using @linear/sdk
  */
 
-// Core provider
-export { LinearProvider, linearProvider } from './client'
-
-// Service layer with caching (preferred API)
-export { LinearService, linearService } from './service'
-
-// Sync layer for bidirectional sync with issues.json
-export { LinearSync, linearSync } from './sync'
-
 // Cache utilities
 export {
-  issueCache,
   assignedIssuesCache,
-  teamsCache,
-  projectsCache,
   clearLinearCache,
   getLinearCacheStats,
+  issueCache,
+  projectsCache,
+  teamsCache,
 } from './cache'
+// Core provider
+export { LinearProvider, linearProvider } from './client'
+// Service layer with caching (preferred API)
+export { LinearService, linearService } from './service'
+// Sync layer for bidirectional sync with issues.json
+export { LinearSync, linearSync } from './sync'

package/core/integrations/linear/service.ts

@@ -4,22 +4,22 @@
  * All operations are cached with 5-minute TTL.
  */
 
-import { linearProvider } from './client'
-import {
-  issueCache,
-  assignedIssuesCache,
-  teamsCache,
-  projectsCache,
-  clearLinearCache,
-  getLinearCacheStats,
-} from './cache'
 import type {
-  Issue,
   CreateIssueInput,
-  UpdateIssueInput,
   FetchOptions,
+  Issue,
   LinearConfig,
+  UpdateIssueInput,
 } from '../issue-tracker/types'
+import {
+  assignedIssuesCache,
+  clearLinearCache,
+  getLinearCacheStats,
+  issueCache,
+  projectsCache,
+  teamsCache,
+} from './cache'
+import { linearProvider } from './client'
 
 export class LinearService {
   private initialized = false

package/core/integrations/linear/sync.ts

@@ -14,19 +14,19 @@
  *   state.json.currentTask.linearId ← DIRECT LINK
  */
 
-import { readFile, writeFile, mkdir } from 'fs/promises'
-import { existsSync } from 'fs'
-import { join } from 'path'
-import { linearService } from './service'
-import { getProjectPath } from '../../schemas/schemas'
+import { existsSync } from 'node:fs'
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
 import {
-  type IssuesJson,
   type CachedIssue,
-  type SyncResult,
   createEmptyIssues,
+  type IssuesJson,
   parseIssues,
+  type SyncResult,
 } from '../../schemas/issues'
+import { getProjectPath } from '../../schemas/schemas'
 import type { Issue } from '../issue-tracker/types'
+import { linearService } from './service'
 
 // Default staleness threshold: 30 minutes
 const DEFAULT_STALE_AFTER = 30 * 60 * 1000
@@ -105,7 +105,7 @@ export class LinearSync {
     const issuesJson = await this.loadIssues(projectId)
 
     // Check local cache first
-    if (issuesJson && issuesJson.issues[identifier]) {
+    if (issuesJson?.issues[identifier]) {
       const cachedIssue = issuesJson.issues[identifier]
 
       // Check if cached issue is still fresh (within fetchedAt + some grace period)