prjct-cli 0.44.1 → 0.45.3

package/core/plugin/loader.ts

@@ -9,12 +9,12 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import { hookSystem } from './hooks'
-import { eventBus, type EventCallback } from '../bus'
+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 { hookSystem } from './hooks'
 
 type PluginSource = 'builtin' | 'global' | 'project'
 type HookHandler = (data: unknown) => unknown | Promise<unknown>
@@ -118,9 +118,10 @@ class PluginLoader {
       for (const file of files) {
         const filePath = path.join(globalPath, file)
         if (file.endsWith('.js') || file.endsWith('.ts') || (await this.isDirectory(filePath))) {
-          const pluginPath = (file.endsWith('.js') || file.endsWith('.ts'))
-            ? filePath
-            : path.join(filePath, 'index.js')
+          const pluginPath =
+            file.endsWith('.js') || file.endsWith('.ts')
+              ? filePath
+              : path.join(filePath, 'index.js')
           await this.loadPlugin(pluginPath, 'global')
         }
       }
@@ -169,7 +170,11 @@ class PluginLoader {
   /**
    * Load a single plugin
    */
-  async loadPlugin(pluginPath: string, source: PluginSource, config: Record<string, unknown> = {}): Promise<void> {
+  async loadPlugin(
+    pluginPath: string,
+    source: PluginSource,
+    config: Record<string, unknown> = {}
+  ): Promise<void> {
     try {
       // Check if file exists
       await fs.access(pluginPath)
@@ -192,7 +197,7 @@ class PluginLoader {
       this.plugins.set(plugin.name, {
         ...plugin,
         source,
-        config: { ...config, ...(this.config[plugin.name] as Record<string, unknown> || {}) }
+        config: { ...config, ...((this.config[plugin.name] as Record<string, unknown>) || {}) },
       })
       this.pluginPaths.set(plugin.name, pluginPath)
 
@@ -212,10 +217,9 @@ class PluginLoader {
           config: this.plugins.get(plugin.name)!.config!,
           eventBus,
           hookSystem,
-          projectPath: this.projectPath
+          projectPath: this.projectPath,
         })
       }
-
     } catch (error) {
       const err = error as NodeJS.ErrnoException
       if (err.code === 'ENOENT') {
@@ -235,7 +239,7 @@ class PluginLoader {
     for (const [hookPoint, handler] of Object.entries(plugin.hooks || {})) {
       hookSystem.register(hookPoint, handler, {
         pluginName: plugin.name,
-        priority: plugin.priority || 10
+        priority: plugin.priority || 10,
       })
     }
   }
@@ -304,7 +308,7 @@ class PluginLoader {
    * Get plugins by source
    */
   getPluginsBySource(source: PluginSource): Plugin[] {
-    return this.getAllPlugins().filter(p => p.source === source)
+    return this.getAllPlugins().filter((p) => p.source === source)
   }
 
   /**
@@ -319,7 +323,7 @@ class PluginLoader {
           commands[name] = {
             handler: handler.handler,
             plugin: plugin.name,
-            description: handler.description || `Command from ${plugin.name}`
+            description: handler.description || `Command from ${plugin.name}`,
           }
         }
       }
@@ -347,10 +351,6 @@ class PluginLoader {
 // Singleton instance
 const pluginLoader = new PluginLoader()
 
-export {
-  PluginLoader,
-  pluginLoader,
-  Plugin
-}
+export { PluginLoader, pluginLoader, type Plugin }
 
 export default { PluginLoader, pluginLoader }

package/core/plugin/registry.ts

@@ -6,11 +6,11 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 import pathManager from '../infrastructure/path-manager'
-import { pluginLoader } from './loader'
 import { isNotFoundError } from '../types/fs'
+import { pluginLoader } from './loader'
 
 type PluginSource = 'builtin' | 'global' | 'project'
 
@@ -51,16 +51,10 @@ class PluginRegistry {
    */
   async discoverPlugins(): Promise<void> {
     // Built-in plugins
-    await this.discoverFromPath(
-      path.join(__dirname, '..', 'plugins'),
-      'builtin'
-    )
+    await this.discoverFromPath(path.join(__dirname, '..', 'plugins'), 'builtin')
 
     // Global plugins
-    await this.discoverFromPath(
-      path.join(pathManager.getGlobalBasePath(), 'plugins'),
-      'global'
-    )
+    await this.discoverFromPath(path.join(pathManager.getGlobalBasePath(), 'plugins'), 'global')
   }
 
   /**
@@ -91,7 +85,7 @@ class PluginRegistry {
             this.availablePlugins.set(metadata.name, {
               ...metadata,
               path: pluginPath,
-              source
+              source,
             })
           }
         } catch (error) {
@@ -125,7 +119,7 @@ class PluginRegistry {
         return {
           name: nameMatch[1],
           version: versionMatch ? versionMatch[1] : '1.0.0',
-          description: descMatch ? descMatch[1] : ''
+          description: descMatch ? descMatch[1] : '',
         }
       }
 
@@ -137,7 +131,7 @@ class PluginRegistry {
         return {
           name: plugin.name,
           version: plugin.version || '1.0.0',
-          description: plugin.description || ''
+          description: plugin.description || '',
         }
       }
     } catch (error) {
@@ -161,7 +155,7 @@ class PluginRegistry {
    * Get available plugins by source
    */
   getAvailableBySource(source: PluginSource): PluginMetadata[] {
-    return this.getAvailable().filter(p => p.source === source)
+    return this.getAvailable().filter((p) => p.source === source)
   }
 
   /**
@@ -190,7 +184,7 @@ class PluginRegistry {
     return {
       ...(available || { name, version: '1.0.0', description: '' }),
       loaded: !!loaded,
-      active: loaded ? true : false
+      active: !!loaded,
     }
   }
 
@@ -287,7 +281,7 @@ class PluginRegistry {
     const bySource: Record<PluginSource, PluginMetadata[]> = {
       builtin: [],
       global: [],
-      project: []
+      project: [],
     }
 
     for (const plugin of available) {
@@ -329,11 +323,6 @@ class PluginRegistry {
 // Singleton instance
 const pluginRegistry = new PluginRegistry()
 
-export {
-  PluginRegistry,
-  pluginRegistry,
-  PluginMetadata,
-  PluginInfo
-}
+export { PluginRegistry, pluginRegistry, type PluginMetadata, type PluginInfo }
 
 export default { PluginRegistry, pluginRegistry }

package/core/schemas/agents.ts

@@ -23,5 +23,5 @@ export const DEFAULT_AGENT: Omit<AgentSchema, 'name' | 'description'> = {
   patterns: [],
   filesOwned: [],
   bestFor: [],
-  avoidFor: []
+  avoidFor: [],
 }

package/core/schemas/analysis.ts

@@ -37,5 +37,5 @@ export const DEFAULT_ANALYSIS: Omit<AnalysisSchema, 'projectId'> = {
   fileCount: 0,
   patterns: [],
   antiPatterns: [],
-  analyzedAt: new Date().toISOString()
+  analyzedAt: new Date().toISOString(),
 }

package/core/schemas/enriched-task.ts

@@ -19,20 +19,14 @@ export const TaskTypeSchema = z.enum([
   'epic',
 ])
 
-export const PrioritySchema = z.enum([
-  'critical',
-  'high',
-  'medium',
-  'low',
-  'none',
-])
+export const PrioritySchema = z.enum(['critical', 'high', 'medium', 'low', 'none'])
 
 export const ComplexitySchema = z.enum([
-  'trivial',   // < 1 hour
-  'small',     // 1-4 hours
-  'medium',    // 1-2 days
-  'large',     // 3-5 days
-  'epic',      // > 1 week
+  'trivial', // < 1 hour
+  'small', // 1-4 hours
+  'medium', // 1-2 days
+  'large', // 3-5 days
+  'epic', // > 1 week
 ])
 
 export const RiskLevelSchema = z.enum(['none', 'low', 'medium', 'high', 'critical'])
@@ -45,7 +39,9 @@ export const UserStorySchema = z.object({
   role: z.string().describe('The user role (e.g., "mobile user")'),
   action: z.string().describe('What the user wants to do'),
   benefit: z.string().describe('The benefit they get'),
-  formatted: z.string().describe('Formatted user story: "As a [role], I want [action] so that [benefit]"'),
+  formatted: z
+    .string()
+    .describe('Formatted user story: "As a [role], I want [action] so that [benefit]"'),
 })
 
 // =============================================================================
@@ -91,11 +87,15 @@ export const DependenciesSchema = z.object({
   code: z.array(CodeDependencySchema).default([]),
   api: z.array(ApiDependencySchema).default([]),
   tasks: z.array(TaskDependencySchema).default([]),
-  infrastructure: z.array(z.object({
-    service: z.string(),
-    purpose: z.string(),
-    risk: RiskLevelSchema,
-  })).default([]),
+  infrastructure: z
+    .array(
+      z.object({
+        service: z.string(),
+        purpose: z.string(),
+        risk: RiskLevelSchema,
+      })
+    )
+    .default([]),
 })
 
 // =============================================================================
@@ -103,31 +103,45 @@ export const DependenciesSchema = z.object({
 // =============================================================================
 
 export const TechnicalAnalysisSchema = z.object({
-  affectedFiles: z.array(z.object({
-    path: z.string(),
-    changes: z.string().describe('Expected changes'),
-    complexity: ComplexitySchema,
-  })).default([]),
-
-  existingPatterns: z.array(z.object({
-    pattern: z.string().describe('Pattern name'),
-    file: z.string().describe('Reference file'),
-    relevance: z.string().describe('Why it is relevant'),
-  })).default([]),
+  affectedFiles: z
+    .array(
+      z.object({
+        path: z.string(),
+        changes: z.string().describe('Expected changes'),
+        complexity: ComplexitySchema,
+      })
+    )
+    .default([]),
+
+  existingPatterns: z
+    .array(
+      z.object({
+        pattern: z.string().describe('Pattern name'),
+        file: z.string().describe('Reference file'),
+        relevance: z.string().describe('Why it is relevant'),
+      })
+    )
+    .default([]),
 
   suggestedApproach: z.string().optional().describe('Recommended approach'),
 
-  potentialRisks: z.array(z.object({
-    risk: z.string(),
-    mitigation: z.string(),
-    severity: RiskLevelSchema,
-  })).default([]),
-
-  testingStrategy: z.object({
-    unit: z.array(z.string()).default([]),
-    integration: z.array(z.string()).default([]),
-    e2e: z.array(z.string()).default([]),
-  }).optional(),
+  potentialRisks: z
+    .array(
+      z.object({
+        risk: z.string(),
+        mitigation: z.string(),
+        severity: RiskLevelSchema,
+      })
+    )
+    .default([]),
+
+  testingStrategy: z
+    .object({
+      unit: z.array(z.string()).default([]),
+      integration: z.array(z.string()).default([]),
+      e2e: z.array(z.string()).default([]),
+    })
+    .optional(),
 })
 
 // =============================================================================
@@ -174,12 +188,9 @@ export const EnrichedTaskSchema = z.object({
   // Enrichment
   userStory: UserStorySchema,
   acceptanceCriteria: z.array(AcceptanceCriterionSchema).min(1),
-  definitionOfDone: z.array(z.string()).default([
-    'Code reviewed',
-    'Tests pass',
-    'Documentation updated',
-    'Deployed to staging',
-  ]),
+  definitionOfDone: z
+    .array(z.string())
+    .default(['Code reviewed', 'Tests pass', 'Documentation updated', 'Deployed to staging']),
 
   // Technical analysis
   technicalAnalysis: TechnicalAnalysisSchema,
@@ -241,13 +252,15 @@ export function isReadyForDev(task: EnrichedTask): { ready: boolean; reasons: st
   }
 
   // Check blockers
-  const blockingDeps = task.dependencies.tasks.filter(t => t.blocking)
+  const blockingDeps = task.dependencies.tasks.filter((t) => t.blocking)
   if (blockingDeps.length > 0) {
-    reasons.push(`Blocked by: ${blockingDeps.map(t => t.id).join(', ')}`)
+    reasons.push(`Blocked by: ${blockingDeps.map((t) => t.id).join(', ')}`)
   }
 
   // Check critical risks
-  const criticalRisks = task.technicalAnalysis.potentialRisks.filter(r => r.severity === 'critical')
+  const criticalRisks = task.technicalAnalysis.potentialRisks.filter(
+    (r) => r.severity === 'critical'
+  )
   if (criticalRisks.length > 0) {
     reasons.push('Has unmitigated critical risks')
   }

package/core/schemas/ideas.ts

@@ -23,32 +23,32 @@ export const ImpactEffortSchema = z.object({
 })
 
 export const TechStackSchema = z.object({
-  frontend: z.string().optional(),  // "Next.js 14, HeroUI"
-  backend: z.string().optional(),   // "Supabase (Auth, DB, RLS, Realtime)"
-  payments: z.string().optional(),  // "Stripe Billing"
-  ai: z.string().optional(),        // "Vercel AI SDK"
-  deploy: z.string().optional(),    // "Vercel"
+  frontend: z.string().optional(), // "Next.js 14, HeroUI"
+  backend: z.string().optional(), // "Supabase (Auth, DB, RLS, Realtime)"
+  payments: z.string().optional(), // "Stripe Billing"
+  ai: z.string().optional(), // "Vercel AI SDK"
+  deploy: z.string().optional(), // "Vercel"
   other: z.array(z.string()).optional(),
 })
 
 export const IdeaModuleSchema = z.object({
-  name: z.string(),               // "Multi-tenant"
-  description: z.string(),        // "Empresas con RLS estricto"
+  name: z.string(), // "Multi-tenant"
+  description: z.string(), // "Empresas con RLS estricto"
 })
 
 export const IdeaRoleSchema = z.object({
-  name: z.string(),               // "SUPER_ADMIN"
+  name: z.string(), // "SUPER_ADMIN"
   description: z.string().optional(),
 })
 
 export const IdeaItemSchema = z.object({
-  id: z.string(),                 // idea_xxxxxxxx
-  text: z.string(),               // Title/summary
+  id: z.string(), // idea_xxxxxxxx
+  text: z.string(), // Title/summary
   details: z.string().optional(),
   priority: IdeaPrioritySchema,
   status: IdeaStatusSchema,
   tags: z.array(z.string()),
-  addedAt: z.string(),            // ISO8601
+  addedAt: z.string(), // ISO8601
   completedAt: z.string().optional(),
   convertedTo: z.string().optional(),
   // Source documentation
@@ -105,10 +105,10 @@ export const DEFAULT_IDEA: Omit<IdeaSchema, 'id' | 'text'> = {
   priority: 'medium',
   status: 'pending',
   tags: [],
-  addedAt: new Date().toISOString()
+  addedAt: new Date().toISOString(),
 }
 
 export const DEFAULT_IDEAS: IdeasJson = {
   ideas: [],
-  lastUpdated: ''
+  lastUpdated: '',
 }

package/core/schemas/index.ts

@@ -12,44 +12,34 @@
  *   - memory/   (context.jsonl, patterns.json)
  */
 
-// State (current task + queue)
-export * from './state'
-
-// Issues (local cache of issue tracker issues)
-export * from './issues'
-
-// Project metadata
-export * from './project'
-
 // Agents
 export * from './agents'
-
-// Ideas
-export * from './ideas'
-
-// Roadmap (features)
-export * from './roadmap'
-
-// Shipped items
-export * from './shipped'
-
 // Analysis
 export * from './analysis'
-
+// Ideas
+export * from './ideas'
+// Issues (local cache of issue tracker issues)
+export * from './issues'
 // Outcomes
 export * from './outcomes'
-
 // Permissions
 export * from './permissions'
-
+// Project metadata
+export * from './project'
+// Roadmap (features)
+export * from './roadmap'
 // Utilities (ID generators and path helpers)
 export {
-  generateUUID,
-  generateTaskId,
+  GLOBAL_STORAGE,
   generateFeatureId,
   generateIdeaId,
-  generateShipId,
   generateSessionId,
-  GLOBAL_STORAGE,
-  getProjectPath
+  generateShipId,
+  generateTaskId,
+  generateUUID,
+  getProjectPath,
 } from './schemas'
+// Shipped items
+export * from './shipped'
+// State (current task + queue)
+export * from './state'

package/core/schemas/issues.ts

@@ -14,7 +14,14 @@ import { z } from 'zod'
 // =============================================================================
 
 export const IssueProviderSchema = z.enum(['linear', 'jira', 'github', 'monday', 'asana', 'none'])
-export const IssueStatusSchema = z.enum(['backlog', 'todo', 'in_progress', 'in_review', 'done', 'cancelled'])
+export const IssueStatusSchema = z.enum([
+  'backlog',
+  'todo',
+  'in_progress',
+  'in_review',
+  'done',
+  'cancelled',
+])
 export const IssuePrioritySchema = z.enum(['none', 'urgent', 'high', 'medium', 'low'])
 export const IssueTypeSchema = z.enum(['feature', 'bug', 'improvement', 'task', 'chore', 'epic'])
 
@@ -27,8 +34,8 @@ export const IssueTypeSchema = z.enum(['feature', 'bug', 'improvement', 'task',
  */
 export const CachedIssueSchema = z.object({
   // Core identifiers
-  id: z.string(),                    // Provider UUID
-  identifier: z.string(),            // Human-readable ID (e.g., "PRJ-123")
+  id: z.string(), // Provider UUID
+  identifier: z.string(), // Human-readable ID (e.g., "PRJ-123")
 
   // Issue content
   title: z.string(),
@@ -40,27 +47,33 @@ export const CachedIssueSchema = z.object({
   type: IssueTypeSchema.optional(),
 
   // Metadata
-  assignee: z.object({
-    id: z.string(),
-    name: z.string(),
-    email: z.string().optional(),
-  }).optional(),
+  assignee: z
+    .object({
+      id: z.string(),
+      name: z.string(),
+      email: z.string().optional(),
+    })
+    .optional(),
   labels: z.array(z.string()).default([]),
-  team: z.object({
-    id: z.string(),
-    name: z.string(),
-    key: z.string().optional(),
-  }).optional(),
-  project: z.object({
-    id: z.string(),
-    name: z.string(),
-  }).optional(),
+  team: z
+    .object({
+      id: z.string(),
+      name: z.string(),
+      key: z.string().optional(),
+    })
+    .optional(),
+  project: z
+    .object({
+      id: z.string(),
+      name: z.string(),
+    })
+    .optional(),
 
   // URLs and timestamps
   url: z.string(),
-  createdAt: z.string(),             // ISO8601 from provider
-  updatedAt: z.string(),             // ISO8601 from provider
-  fetchedAt: z.string(),             // ISO8601 when we cached it
+  createdAt: z.string(), // ISO8601 from provider
+  updatedAt: z.string(), // ISO8601 from provider
+  fetchedAt: z.string(), // ISO8601 when we cached it
 })
 
 // =============================================================================
@@ -76,7 +89,7 @@ export const IssuesJsonSchema = z.object({
   provider: IssueProviderSchema,
 
   // Sync metadata
-  lastSync: z.string(),              // ISO8601 of last full sync
+  lastSync: z.string(), // ISO8601 of last full sync
   staleAfter: z.number().default(1800000), // 30 minutes in ms
 
   // Issues map: identifier -> issue
@@ -91,10 +104,12 @@ export const SyncResultSchema = z.object({
   provider: IssueProviderSchema,
   fetched: z.number(),
   updated: z.number(),
-  errors: z.array(z.object({
-    issueId: z.string(),
-    error: z.string(),
-  })),
+  errors: z.array(
+    z.object({
+      issueId: z.string(),
+      error: z.string(),
+    })
+  ),
   timestamp: z.string(),
 })