prjct-cli 0.44.1 → 0.45.3

package/core/schemas/roadmap.ts

@@ -23,20 +23,25 @@ import { z } from 'zod'
 
 export const FeatureStatusSchema = z.enum(['planned', 'active', 'completed', 'shipped'])
 export const FeatureImpactSchema = z.enum(['low', 'medium', 'high'])
-export const FeatureTypeSchema = z.enum(['feature', 'breaking_change', 'refactor', 'infrastructure'])
+export const FeatureTypeSchema = z.enum([
+  'feature',
+  'breaking_change',
+  'refactor',
+  'infrastructure',
+])
 export const PhaseStatusSchema = z.enum(['completed', 'active', 'planned'])
 export const QuarterStatusSchema = z.enum(['planned', 'active', 'completed'])
 export const InferredFromSchema = z.enum(['git', 'git-branch', 'manual', 'prd'])
 
 export const FeatureTaskSchema = z.object({
-  id: z.string(),               // task_xxxxxxxx
+  id: z.string(), // task_xxxxxxxx
   description: z.string(),
   completed: z.boolean(),
   completedAt: z.string().optional(),
 })
 
 export const RoadmapPhaseSchema = z.object({
-  id: z.string(),               // P0, P1, etc.
+  id: z.string(), // P0, P1, etc.
   name: z.string(),
   status: PhaseStatusSchema,
   completedAt: z.string().optional(),
@@ -73,10 +78,14 @@ export const GitCommitSchema = z.object({
 export const EffortEstimateSchema = z.object({
   hours: z.number(),
   confidence: z.enum(['low', 'medium', 'high']).optional(),
-  breakdown: z.array(z.object({
-    area: z.string(),
-    hours: z.number(),
-  })).optional(),
+  breakdown: z
+    .array(
+      z.object({
+        area: z.string(),
+        hours: z.number(),
+      })
+    )
+    .optional(),
 })
 
 export const EffortActualSchema = z.object({
@@ -98,19 +107,19 @@ export const FeatureEffortSchema = z.object({
 export const QuarterCapacitySchema = z.object({
   totalHours: z.number(),
   allocatedHours: z.number(),
-  bufferPercent: z.number().optional(),  // % reserved for unknowns
+  bufferPercent: z.number().optional(), // % reserved for unknowns
 })
 
 export const QuarterSchema = z.object({
-  id: z.string(),                         // Q1-2026
-  name: z.string(),                       // "Q1 2026"
-  theme: z.string().optional(),           // "Foundation"
+  id: z.string(), // Q1-2026
+  name: z.string(), // "Q1 2026"
+  theme: z.string().optional(), // "Foundation"
   goals: z.array(z.string()).optional(),
-  features: z.array(z.string()),          // Feature IDs
+  features: z.array(z.string()), // Feature IDs
   capacity: QuarterCapacitySchema.optional(),
   status: QuarterStatusSchema,
-  startDate: z.string().optional(),       // ISO8601
-  endDate: z.string().optional(),         // ISO8601
+  startDate: z.string().optional(), // ISO8601
+  endDate: z.string().optional(), // ISO8601
 })
 
 // -----------------------------------------------------------------------------
@@ -118,23 +127,23 @@ export const QuarterSchema = z.object({
 // -----------------------------------------------------------------------------
 
 export const FeatureItemSchema = z.object({
-  id: z.string(),               // feat_xxxxxxxx
+  id: z.string(), // feat_xxxxxxxx
   name: z.string(),
   description: z.string().optional(),
-  date: z.string(),             // YYYY-MM-DD creation date
+  date: z.string(), // YYYY-MM-DD creation date
   status: FeatureStatusSchema,
   impact: FeatureImpactSchema,
   effort: z.string().optional(),
-  progress: z.number(),         // 0-100
+  progress: z.number(), // 0-100
   // Enriched fields from MD
   type: FeatureTypeSchema.optional(),
-  roi: z.number().optional(),   // 1-5 from star count
+  roi: z.number().optional(), // 1-5 from star count
   why: z.array(z.string()).optional(),
   technicalNotes: z.array(z.string()).optional(),
   compatibility: z.string().optional(),
   phase: z.string().optional(), // P0, P1, etc.
   tasks: z.array(FeatureTaskSchema),
-  createdAt: z.string(),        // ISO8601
+  createdAt: z.string(), // ISO8601
   shippedAt: z.string().optional(),
   version: z.string().optional(),
   // ZERO DATA LOSS - additional fields
@@ -149,29 +158,29 @@ export const FeatureItemSchema = z.object({
   // =========================================================================
 
   // PRD Integration
-  prdId: z.string().nullable().optional(),           // Link to PRD (prd_xxxxxxxx)
+  prdId: z.string().nullable().optional(), // Link to PRD (prd_xxxxxxxx)
 
   // Legacy Support (for existing projects)
-  legacy: z.boolean().optional(),                     // true = no PRD required
-  inferredFrom: InferredFromSchema.optional(),        // git, git-branch, manual, prd
+  legacy: z.boolean().optional(), // true = no PRD required
+  inferredFrom: InferredFromSchema.optional(), // git, git-branch, manual, prd
 
   // Quarter Planning
-  quarter: z.string().nullable().optional(),          // Q1-2026, etc.
+  quarter: z.string().nullable().optional(), // Q1-2026, etc.
 
   // Dependency Tracking
-  dependencies: z.array(z.string()).optional(),       // Feature IDs this depends on
-  blockedBy: z.array(z.string()).optional(),          // Feature IDs blocking this
+  dependencies: z.array(z.string()).optional(), // Feature IDs this depends on
+  blockedBy: z.array(z.string()).optional(), // Feature IDs blocking this
 
   // Effort Tracking (for PRD comparison)
   effortTracking: FeatureEffortSchema.optional(),
 
   // Value Scoring (calculated from PRD)
-  valueScore: z.number().optional(),                  // Calculated priority score
+  valueScore: z.number().optional(), // Calculated priority score
 
   // Git Data (for legacy features)
-  commits: z.array(GitCommitSchema).optional(),       // Commits for this feature
-  branch: z.string().optional(),                      // Branch name (for active)
-  commitsAhead: z.number().optional(),                // Commits ahead of main
+  commits: z.array(GitCommitSchema).optional(), // Commits for this feature
+  branch: z.string().optional(), // Branch name (for active)
+  commitsAhead: z.number().optional(), // Commits ahead of main
 })
 
 // -----------------------------------------------------------------------------
@@ -184,7 +193,7 @@ export const BacklogItemSchema = z.object({
   prdId: z.string().nullable().optional(),
   valueScore: z.number().optional(),
   effortEstimate: z.number().optional(),
-  reason: z.string().optional(),          // Why in backlog
+  reason: z.string().optional(), // Why in backlog
 })
 
 // -----------------------------------------------------------------------------
@@ -194,7 +203,7 @@ export const BacklogItemSchema = z.object({
 export const RoadmapJsonSchema = z.object({
   strategy: RoadmapStrategySchema.nullable().optional(),
   features: z.array(FeatureItemSchema),
-  backlog: z.array(z.union([z.string(), BacklogItemSchema])),  // Support both formats
+  backlog: z.array(z.union([z.string(), BacklogItemSchema])), // Support both formats
   lastUpdated: z.string(),
 
   // AI ORCHESTRATION FIELDS (v0.29.0)
@@ -274,7 +283,11 @@ export const DEFAULT_ROADMAP: RoadmapJson = {
  * Check if a feature is legacy (no PRD required)
  */
 export const isLegacyFeature = (feature: FeatureSchema): boolean => {
-  return feature.legacy === true || feature.inferredFrom === 'git' || feature.inferredFrom === 'git-branch'
+  return (
+    feature.legacy === true ||
+    feature.inferredFrom === 'git' ||
+    feature.inferredFrom === 'git-branch'
+  )
 }
 
 /**
@@ -294,14 +307,14 @@ export const calculateFeaturePriority = (feature: FeatureSchema): number => {
  * Get features for a specific quarter
  */
 export const getQuarterFeatures = (roadmap: RoadmapJson, quarterId: string): FeatureSchema[] => {
-  return roadmap.features.filter(f => f.quarter === quarterId)
+  return roadmap.features.filter((f) => f.quarter === quarterId)
 }
 
 /**
  * Get quarter capacity utilization percentage
  */
 export const getQuarterUtilization = (roadmap: RoadmapJson, quarterId: string): number => {
-  const quarter = roadmap.quarters?.find(q => q.id === quarterId)
+  const quarter = roadmap.quarters?.find((q) => q.id === quarterId)
   if (!quarter?.capacity) return 0
 
   const { allocatedHours, totalHours } = quarter.capacity

package/core/schemas/schemas.ts

@@ -4,9 +4,9 @@
  * ID generators and path helpers for project data.
  */
 
-import crypto from 'crypto'
-import { join } from 'path'
-import { homedir } from 'os'
+import crypto from 'node:crypto'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
 
 // ============================================
 // ID GENERATORS - UUID ONLY
@@ -36,4 +36,3 @@ export const GLOBAL_STORAGE = join(homedir(), '.prjct-cli', 'projects')
 export function getProjectPath(projectId: string): string {
   return join(GLOBAL_STORAGE, projectId)
 }
-

package/core/schemas/shipped.ts

@@ -50,7 +50,7 @@ export const CommitInfoSchema = z.object({
 })
 
 export const ShippedItemSchema = z.object({
-  id: z.string(),               // ship_xxxxxxxx
+  id: z.string(), // ship_xxxxxxxx
   name: z.string(),
   version: z.string().nullable().optional(),
   type: ShipTypeSchema,
@@ -64,7 +64,7 @@ export const ShippedItemSchema = z.object({
   quantitativeImpact: z.string().optional(),
   duration: DurationSchema.optional(),
   tasksCompleted: z.number().nullable().optional(),
-  shippedAt: z.string(),        // ISO8601
+  shippedAt: z.string(), // ISO8601
   featureId: z.string().optional(),
 })
 
@@ -105,5 +105,5 @@ export const safeParseShipped = (data: unknown) => ShippedJsonSchema.safeParse(d
 
 export const DEFAULT_SHIPPED: ShippedJson = {
   items: [],
-  lastUpdated: ''
+  lastUpdated: '',
 }

package/core/schemas/state.ts

@@ -17,17 +17,31 @@ import { z } from 'zod'
 export const PrioritySchema = z.enum(['low', 'medium', 'high', 'critical'])
 export const TaskTypeSchema = z.enum(['feature', 'bug', 'improvement', 'chore'])
 export const TaskSectionSchema = z.enum(['active', 'backlog', 'previously_active'])
-export const TaskStatusSchema = z.enum(['pending', 'in_progress', 'completed', 'blocked', 'paused', 'failed'])
-export const ActivityTypeSchema = z.enum(['task_completed', 'feature_shipped', 'idea_captured', 'session_started'])
+export const TaskStatusSchema = z.enum([
+  'pending',
+  'in_progress',
+  'completed',
+  'blocked',
+  'paused',
+  'failed',
+])
+export const ActivityTypeSchema = z.enum([
+  'task_completed',
+  'feature_shipped',
+  'idea_captured',
+  'session_started',
+])
 
 // Subtask summary for context handoff between agents
 export const SubtaskSummarySchema = z.object({
   title: z.string(),
   description: z.string(),
-  filesChanged: z.array(z.object({
-    path: z.string(),
-    action: z.enum(['created', 'modified', 'deleted']),
-  })),
+  filesChanged: z.array(
+    z.object({
+      path: z.string(),
+      action: z.enum(['created', 'modified', 'deleted']),
+    })
+  ),
   whatWasDone: z.array(z.string()),
   outputForNextAgent: z.string().optional(),
   notes: z.string().optional(),
@@ -35,15 +49,15 @@ export const SubtaskSummarySchema = z.object({
 
 // Subtask schema for task fragmentation
 export const SubtaskSchema = z.object({
-  id: z.string(),                    // subtask-xxx
+  id: z.string(), // subtask-xxx
   description: z.string(),
-  domain: z.string(),                // frontend, backend, database, testing, etc.
-  agent: z.string(),                 // agent file name (e.g., "frontend.md")
+  domain: z.string(), // frontend, backend, database, testing, etc.
+  agent: z.string(), // agent file name (e.g., "frontend.md")
   status: TaskStatusSchema,
-  dependsOn: z.array(z.string()),    // IDs of dependent subtasks
-  startedAt: z.string().optional(),  // ISO8601
+  dependsOn: z.array(z.string()), // IDs of dependent subtasks
+  startedAt: z.string().optional(), // ISO8601
   completedAt: z.string().optional(), // ISO8601
-  output: z.string().optional(),      // Brief output description
+  output: z.string().optional(), // Brief output description
   summary: SubtaskSummarySchema.optional(), // Full summary for context handoff
 })
 
@@ -55,26 +69,26 @@ export const SubtaskProgressSchema = z.object({
 })
 
 export const CurrentTaskSchema = z.object({
-  id: z.string(),                   // task_xxxxxxxx
+  id: z.string(), // task_xxxxxxxx
   description: z.string(),
-  startedAt: z.string(),            // ISO8601
-  sessionId: z.string(),            // sess_xxxxxxxx
+  startedAt: z.string(), // ISO8601
+  sessionId: z.string(), // sess_xxxxxxxx
   featureId: z.string().optional(), // feat_xxxxxxxx
   // Subtask tracking for fragmented tasks
   subtasks: z.array(SubtaskSchema).optional(),
   currentSubtaskIndex: z.number().optional(),
   subtaskProgress: SubtaskProgressSchema.optional(),
   // Linear integration - bidirectional sync
-  linearId: z.string().optional(),      // "PRJ-123" - Linear identifier
-  linearUuid: z.string().optional(),    // Linear internal UUID for API calls
+  linearId: z.string().optional(), // "PRJ-123" - Linear identifier
+  linearUuid: z.string().optional(), // Linear internal UUID for API calls
 })
 
 export const PreviousTaskSchema = z.object({
   id: z.string(),
   description: z.string(),
   status: z.literal('paused'),
-  startedAt: z.string(),            // ISO8601
-  pausedAt: z.string(),             // ISO8601
+  startedAt: z.string(), // ISO8601
+  pausedAt: z.string(), // ISO8601
   pauseReason: z.string().optional(),
 })
 
@@ -85,20 +99,20 @@ export const StateJsonSchema = z.object({
 })
 
 export const QueueTaskSchema = z.object({
-  id: z.string(),                   // task_xxxxxxxx
+  id: z.string(), // task_xxxxxxxx
   description: z.string(),
   priority: PrioritySchema,
-  type: TaskTypeSchema,             // detect from emoji 🐛=bug
+  type: TaskTypeSchema, // detect from emoji 🐛=bug
   featureId: z.string().optional(),
   originFeature: z.string().optional(),
   completed: z.boolean(),
   completedAt: z.string().optional(),
-  createdAt: z.string(),            // ISO8601
+  createdAt: z.string(), // ISO8601
   section: TaskSectionSchema,
   // Additional fields for ZERO DATA LOSS
-  agent: z.string().optional(),     // "fe", "be", "fe + be"
+  agent: z.string().optional(), // "fe", "be", "fe + be"
   groupName: z.string().optional(), // "Sales Reports", "Stock Audits"
-  groupId: z.string().optional(),   // For grouping related tasks
+  groupId: z.string().optional(), // For grouping related tasks
 })
 
 export const QueueJsonSchema = z.object({
@@ -117,7 +131,7 @@ export const StatsSchema = z.object({
 export const RecentActivitySchema = z.object({
   type: ActivityTypeSchema,
   description: z.string(),
-  timestamp: z.string(),            // ISO8601
+  timestamp: z.string(), // ISO8601
   duration: z.string().optional(),
 })
 
@@ -127,7 +141,7 @@ export const StateSchemaFull = z.object({
   queue: z.array(QueueTaskSchema),
   stats: StatsSchema,
   recentActivity: z.array(RecentActivitySchema),
-  lastSync: z.string(),             // ISO8601
+  lastSync: z.string(), // ISO8601
 })
 
 // =============================================================================
@@ -176,12 +190,12 @@ export const safeParseQueue = (data: unknown) => QueueJsonSchema.safeParse(data)
 
 export const DEFAULT_STATE: StateJson = {
   currentTask: null,
-  lastUpdated: ''
+  lastUpdated: '',
 }
 
 export const DEFAULT_QUEUE: QueueJson = {
   tasks: [],
-  lastUpdated: ''
+  lastUpdated: '',
 }
 
 export const DEFAULT_STATS: Stats = {
@@ -189,5 +203,5 @@ export const DEFAULT_STATS: Stats = {
   tasksThisWeek: 0,
   streak: 0,
   velocity: '0/day',
-  avgDuration: '0m'
+  avgDuration: '0m',
 }

package/core/server/index.ts

@@ -7,16 +7,15 @@
  * @version 1.0.0
  */
 
-export { createServer, startServer, DEFAULT_PORT } from './server'
-export { createRoutes } from './routes'
-export { createExtendedRoutes } from './routes-extended'
-export { createSSEManager, SSE_EVENTS } from './sse'
-
 // Re-export types from canonical location
 export type {
   ServerConfig,
   ServerInstance,
   SSEClient,
-  SSEManager,
   SSEEventType,
+  SSEManager,
 } from '../types'
+export { createRoutes } from './routes'
+export { createExtendedRoutes } from './routes-extended'
+export { createServer, DEFAULT_PORT, startServer } from './server'
+export { createSSEManager, SSE_EVENTS } from './sse'