prjct-cli 0.45.0 → 0.45.3

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'

package/core/server/routes-extended.ts

@@ -7,9 +7,9 @@
  * @version 2.0.0
  */
 
+import fs from 'node:fs/promises'
+import path from 'node:path'
 import { Hono } from 'hono'
-import fs from 'fs/promises'
-import path from 'path'
 import * as jsonc from 'jsonc-parser'
 import pathManager from '../infrastructure/path-manager'
 import { isNotFoundError } from '../types/fs'
@@ -38,7 +38,7 @@ async function readJsonFile<T>(filePath: string): Promise<T | null> {
 async function writeJsonFile(filePath: string, data: unknown): Promise<boolean> {
   try {
     await fs.mkdir(path.dirname(filePath), { recursive: true })
-    await fs.writeFile(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8')
+    await fs.writeFile(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf-8')
     return true
   } catch (error) {
     if (isNotFoundError(error)) {
@@ -59,14 +59,14 @@ async function getProjectConfig(projectId: string): Promise<any> {
 
 async function calculateDuration(startedAt: string | undefined): Promise<string> {
   if (!startedAt) return ''
-  
+
   const start = new Date(startedAt)
   const now = new Date()
   const elapsed = now.getTime() - start.getTime()
-  
+
   const hours = Math.floor(elapsed / (1000 * 60 * 60))
   const minutes = Math.floor((elapsed % (1000 * 60 * 60)) / (1000 * 60))
-  
+
   if (hours > 0) {
     return `${hours}h ${minutes}m`
   }
@@ -87,34 +87,26 @@ export function createExtendedRoutes(): Hono {
     try {
       await fs.mkdir(PROJECTS_DIR, { recursive: true })
       const entries = await fs.readdir(PROJECTS_DIR, { withFileTypes: true })
-      const projectIds = entries.filter(e => e.isDirectory()).map(e => e.name)
+      const projectIds = entries.filter((e) => e.isDirectory()).map((e) => e.name)
 
       const projects = await Promise.all(
         projectIds.map(async (id) => {
           const projectPath = getProjectPath(id)
-          
+
           // Read config
           const config = await getProjectConfig(id)
-          
+
           // Read state
-          const state = await readJsonFile<any>(
-            path.join(projectPath, 'storage/state.json')
-          )
-          
+          const state = await readJsonFile<any>(path.join(projectPath, 'storage/state.json'))
+
           // Read queue for count
-          const queue = await readJsonFile<any>(
-            path.join(projectPath, 'storage/queue.json')
-          )
-          
+          const queue = await readJsonFile<any>(path.join(projectPath, 'storage/queue.json'))
+
           // Read ideas for count
-          const ideas = await readJsonFile<any>(
-            path.join(projectPath, 'storage/ideas.json')
-          )
-          
+          const ideas = await readJsonFile<any>(path.join(projectPath, 'storage/ideas.json'))
+
           // Read shipped for count
-          const shipped = await readJsonFile<any>(
-            path.join(projectPath, 'storage/shipped.json')
-          )
+          const shipped = await readJsonFile<any>(path.join(projectPath, 'storage/shipped.json'))
 
           const currentTask = state?.currentTask
           const duration = await calculateDuration(currentTask?.startedAt)
@@ -123,16 +115,18 @@ export function createExtendedRoutes(): Hono {
             id,
             name: config?.name || id.slice(0, 8),
             path: config?.path || null,
-            currentTask: currentTask ? {
-              ...currentTask,
-              duration
-            } : null,
+            currentTask: currentTask
+              ? {
+                  ...currentTask,
+                  duration,
+                }
+              : null,
             pausedTask: state?.previousTask || null,
             stats: {
               queueCount: queue?.tasks?.filter((t: any) => !t.completed)?.length || 0,
               ideasCount: ideas?.ideas?.filter((i: any) => i.status === 'pending')?.length || 0,
               shippedCount: shipped?.shipped?.length || 0,
-            }
+            },
           }
         })
       )
@@ -178,15 +172,17 @@ export function createExtendedRoutes(): Hono {
       const weekStart = new Date(todayStart)
       weekStart.setDate(weekStart.getDate() - weekStart.getDay())
 
-      const completedToday = queue?.tasks?.filter((t: any) => {
-        if (!t.completed || !t.completedAt) return false
-        return new Date(t.completedAt) >= todayStart
-      })?.length || 0
+      const completedToday =
+        queue?.tasks?.filter((t: any) => {
+          if (!t.completed || !t.completedAt) return false
+          return new Date(t.completedAt) >= todayStart
+        })?.length || 0
 
-      const completedThisWeek = queue?.tasks?.filter((t: any) => {
-        if (!t.completed || !t.completedAt) return false
-        return new Date(t.completedAt) >= weekStart
-      })?.length || 0
+      const completedThisWeek =
+        queue?.tasks?.filter((t: any) => {
+          if (!t.completed || !t.completedAt) return false
+          return new Date(t.completedAt) >= weekStart
+        })?.length || 0
 
       return c.json({
         id: projectId,
@@ -204,7 +200,7 @@ export function createExtendedRoutes(): Hono {
           ideasCount: ideas?.ideas?.filter((i: any) => i.status === 'pending')?.length || 0,
           shippedCount: shipped?.shipped?.length || 0,
         },
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
       })
     } catch (error) {
       return c.json({ error: String(error) }, 500)
@@ -221,7 +217,7 @@ export function createExtendedRoutes(): Hono {
 
     try {
       const state = await readJsonFile<any>(statePath)
-      
+
       if (!state?.currentTask) {
         return c.json({ success: false, error: 'No active task' }, 400)
       }
@@ -232,15 +228,15 @@ export function createExtendedRoutes(): Hono {
       const newState = {
         currentTask: null,
         previousTask: null,
-        lastUpdated: new Date().toISOString()
+        lastUpdated: new Date().toISOString(),
       }
 
       await writeJsonFile(statePath, newState)
 
-      return c.json({ 
-        success: true, 
+      return c.json({
+        success: true,
         completedTask,
-        message: `Completed: ${completedTask.description}`
+        message: `Completed: ${completedTask.description}`,
       })
     } catch (error) {
       return c.json({ success: false, error: String(error) }, 500)
@@ -260,7 +256,7 @@ export function createExtendedRoutes(): Hono {
       const reason = body.reason
 
       const state = await readJsonFile<any>(statePath)
-      
+
       if (!state?.currentTask) {
         return c.json({ success: false, error: 'No active task' }, 400)
       }
@@ -271,21 +267,21 @@ export function createExtendedRoutes(): Hono {
         status: 'paused',
         startedAt: state.currentTask.startedAt,
         pausedAt: new Date().toISOString(),
-        pauseReason: reason
+        pauseReason: reason,
       }
 
       const newState = {
         currentTask: null,
         previousTask: pausedTask,
-        lastUpdated: new Date().toISOString()
+        lastUpdated: new Date().toISOString(),
       }
 
       await writeJsonFile(statePath, newState)
 
-      return c.json({ 
-        success: true, 
+      return c.json({
+        success: true,
         pausedTask,
-        message: `Paused: ${pausedTask.description}`
+        message: `Paused: ${pausedTask.description}`,
       })
     } catch (error) {
       return c.json({ success: false, error: String(error) }, 500)
@@ -302,7 +298,7 @@ export function createExtendedRoutes(): Hono {
 
     try {
       const state = await readJsonFile<any>(statePath)
-      
+
       if (!state?.previousTask) {
         return c.json({ success: false, error: 'No paused task' }, 400)
       }
@@ -311,21 +307,21 @@ export function createExtendedRoutes(): Hono {
         id: state.previousTask.id,
         description: state.previousTask.description,
         startedAt: new Date().toISOString(),
-        sessionId: `sess_${Date.now().toString(36)}`
+        sessionId: `sess_${Date.now().toString(36)}`,
       }
 
       const newState = {
         currentTask: resumedTask,
         previousTask: null,
-        lastUpdated: new Date().toISOString()
+        lastUpdated: new Date().toISOString(),
       }
 
       await writeJsonFile(statePath, newState)
 
-      return c.json({ 
-        success: true, 
+      return c.json({
+        success: true,
         resumedTask,
-        message: `Resumed: ${resumedTask.description}`
+        message: `Resumed: ${resumedTask.description}`,
       })
     } catch (error) {
       return c.json({ success: false, error: String(error) }, 500)
@@ -369,22 +365,22 @@ export function createExtendedRoutes(): Hono {
         description: task.description,
         startedAt: new Date().toISOString(),
         sessionId: `sess_${Date.now().toString(36)}`,
-        featureId: task.featureId
+        featureId: task.featureId,
       }
 
       // Update state
       const newState = {
         currentTask: newTask,
         previousTask: null,
-        lastUpdated: new Date().toISOString()
+        lastUpdated: new Date().toISOString(),
       }
 
       await writeJsonFile(statePath, newState)
 
-      return c.json({ 
-        success: true, 
+      return c.json({
+        success: true,
         task: newTask,
-        message: `Started: ${newTask.description}`
+        message: `Started: ${newTask.description}`,
       })
     } catch (error) {
       return c.json({ success: false, error: String(error) }, 500)
@@ -407,7 +403,7 @@ export function createExtendedRoutes(): Hono {
         return c.json({ success: false, error: 'text required' }, 400)
       }
 
-      const ideas = await readJsonFile<any>(ideasPath) || { ideas: [], lastUpdated: '' }
+      const ideas = (await readJsonFile<any>(ideasPath)) || { ideas: [], lastUpdated: '' }
 
       const newIdea = {
         id: `idea_${Date.now().toString(36)}`,
@@ -415,7 +411,7 @@ export function createExtendedRoutes(): Hono {
         status: 'pending',
         priority,
         tags,
-        addedAt: new Date().toISOString()
+        addedAt: new Date().toISOString(),
       }
 
       ideas.ideas.unshift(newIdea) // Prepend
@@ -423,10 +419,10 @@ export function createExtendedRoutes(): Hono {
 
       await writeJsonFile(ideasPath, ideas)
 
-      return c.json({ 
-        success: true, 
+      return c.json({
+        success: true,
         idea: newIdea,
-        message: `Captured: ${text.slice(0, 50)}...`
+        message: `Captured: ${text.slice(0, 50)}...`,
       })
     } catch (error) {
       return c.json({ success: false, error: String(error) }, 500)
@@ -440,7 +436,7 @@ export function createExtendedRoutes(): Hono {
     try {
       await fs.mkdir(PROJECTS_DIR, { recursive: true })
       const entries = await fs.readdir(PROJECTS_DIR, { withFileTypes: true })
-      const projectIds = entries.filter(e => e.isDirectory()).map(e => e.name)
+      const projectIds = entries.filter((e) => e.isDirectory()).map((e) => e.name)
 
       let totalTasks = 0
       let totalIdeas = 0
@@ -449,14 +445,14 @@ export function createExtendedRoutes(): Hono {
 
       for (const id of projectIds) {
         const projectPath = getProjectPath(id)
-        
+
         const state = await readJsonFile<any>(path.join(projectPath, 'storage/state.json'))
         const queue = await readJsonFile<any>(path.join(projectPath, 'storage/queue.json'))
         const ideas = await readJsonFile<any>(path.join(projectPath, 'storage/ideas.json'))
         const shipped = await readJsonFile<any>(path.join(projectPath, 'storage/shipped.json'))
 
         if (state?.currentTask) activeProjects++
-        
+
         totalTasks += queue?.tasks?.filter((t: any) => !t.completed)?.length || 0
         totalIdeas += ideas?.ideas?.filter((i: any) => i.status === 'pending')?.length || 0
         totalShipped += shipped?.shipped?.length || 0
@@ -468,7 +464,7 @@ export function createExtendedRoutes(): Hono {
         totalTasks,
         totalIdeas,
         totalShipped,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
       })
     } catch (error) {
       return c.json({ error: String(error) }, 500)
@@ -485,7 +481,7 @@ export function createExtendedRoutes(): Hono {
 
       await fs.mkdir(PROJECTS_DIR, { recursive: true })
       const entries = await fs.readdir(PROJECTS_DIR, { withFileTypes: true })
-      const projectIds = entries.filter(e => e.isDirectory()).map(e => e.name)
+      const projectIds = entries.filter((e) => e.isDirectory()).map((e) => e.name)
 
       // If cwd provided, find matching project by path
       let targetProjectId: string | null = null
@@ -519,7 +515,7 @@ export function createExtendedRoutes(): Hono {
           activeProject = { id, name: config?.name || id, path: config?.repoPath || config?.path }
           activeTask = {
             ...state.currentTask,
-            duration: await calculateDuration(state.currentTask.startedAt)
+            duration: await calculateDuration(state.currentTask.startedAt),
           }
           break
         }
@@ -540,7 +536,7 @@ export function createExtendedRoutes(): Hono {
         // Include whether we filtered by cwd
         filtered: !!targetProjectId,
         cwd: cwd || null,
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
       })
     } catch (error) {
       return c.json({ error: String(error) }, 500)

package/core/server/routes.ts

@@ -6,9 +6,9 @@
  * @version 1.0.0
  */
 
+import fs from 'node:fs/promises'
+import path from 'node:path'
 import { Hono } from 'hono'
-import fs from 'fs/promises'
-import path from 'path'
 import * as jsonc from 'jsonc-parser'
 import pathManager from '../infrastructure/path-manager'
 import { isNotFoundError } from '../types/fs'
@@ -46,7 +46,7 @@ async function readJsonFile<T>(filePath: string): Promise<T | null> {
 async function writeJsonFile(filePath: string, data: unknown): Promise<boolean> {
   try {
     await fs.mkdir(path.dirname(filePath), { recursive: true })
-    await fs.writeFile(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8')
+    await fs.writeFile(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf-8')
     return true
   } catch (error) {
     console.error(`JSON write error: ${(error as Error).message}`)

package/core/server/server.ts

@@ -11,11 +11,11 @@
 import { Hono } from 'hono'
 import { cors } from 'hono/cors'
 import { logger } from 'hono/logger'
+import type { ServerConfig, ServerInstance } from '../types'
+import { isBun } from '../utils/runtime'
 import { createRoutes } from './routes'
 import { createExtendedRoutes } from './routes-extended'
 import { createSSEManager } from './sse'
-import { isBun } from '../utils/runtime'
-import type { ServerConfig, ServerInstance } from '../types'
 
 // Server handle type that works for both runtimes
 type ServerHandle = { stop: () => void } | null
@@ -29,11 +29,14 @@ export function createServer(config: ServerConfig): ServerInstance {
 
   // Middleware
   if (config.enableCors !== false) {
-    app.use('*', cors({
-      origin: '*',
-      allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
-      allowHeaders: ['Content-Type', 'Authorization'],
-    }))
+    app.use(
+      '*',
+      cors({
+        origin: '*',
+        allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+        allowHeaders: ['Content-Type', 'Authorization'],
+      })
+    )
   }
 
   if (config.enableLogging !== false) {
@@ -44,25 +47,27 @@ export function createServer(config: ServerConfig): ServerInstance {
   app.get('/health', (c) => c.json({ status: 'ok', timestamp: new Date().toISOString() }))
 
   // API info
-  app.get('/', (c) => c.json({
-    name: 'prjct-cli',
-    version: '0.20.0',
-    projectId: config.projectId,
-    endpoints: {
-      health: '/health',
-      state: '/api/state',
-      queue: '/api/queue',
-      ideas: '/api/ideas',
-      roadmap: '/api/roadmap',
-      shipped: '/api/shipped',
-      events: '/api/events',
-      // Extended endpoints for status-bar
-      projects: '/api/projects',
-      projectFull: '/api/projects/:id/full',
-      statusBarCompact: '/api/status-bar/compact',
-      globalStats: '/api/stats/global',
-    }
-  }))
+  app.get('/', (c) =>
+    c.json({
+      name: 'prjct-cli',
+      version: '0.20.0',
+      projectId: config.projectId,
+      endpoints: {
+        health: '/health',
+        state: '/api/state',
+        queue: '/api/queue',
+        ideas: '/api/ideas',
+        roadmap: '/api/roadmap',
+        shipped: '/api/shipped',
+        events: '/api/events',
+        // Extended endpoints for status-bar
+        projects: '/api/projects',
+        projectFull: '/api/projects/:id/full',
+        statusBarCompact: '/api/status-bar/compact',
+        globalStats: '/api/stats/global',
+      },
+    })
+  )
 
   // Mount API routes
   const routes = createRoutes(config.projectId, config.projectPath)