prjct-cli 0.20.0 → 0.21.0

package/core/{infrastructure/session-manager/migration.ts → session/log-migration.ts}

@@ -4,11 +4,11 @@
  */
 
 import path from 'path'
-import pathManager from '../path-manager'
-import * as dateHelper from '../../utils/date-helper'
-import * as jsonlHelper from '../../utils/jsonl-helper'
-import * as fileHelper from '../../utils/file-helper'
-import type { SessionEntry, MigrationResult, SessionMetadata } from './types'
+import pathManager from '../infrastructure/path-manager'
+import * as dateHelper from '../utils/date-helper'
+import * as jsonlHelper from '../utils/jsonl-helper'
+import * as fileHelper from '../utils/file-helper'
+import type { SessionEntry, SessionMigrationResult, SessionLogMetadata } from '../types'
 
 /**
  * Migrate legacy JSONL file
@@ -17,9 +17,9 @@ export async function migrateLegacyJsonl(
   projectId: string,
   content: string,
   sessionFilename: string,
-  updateMetadata: (sessionPath: string, updates: Partial<SessionMetadata>) => Promise<void>,
+  updateMetadata: (sessionPath: string, updates: Partial<SessionLogMetadata>) => Promise<void>,
   ensureMetadata: (sessionPath: string) => Promise<void>
-): Promise<MigrationResult> {
+): Promise<SessionMigrationResult> {
   const entries = jsonlHelper.parseJsonLines(content) as SessionEntry[]
   const sessionGroups = new Map<string, SessionEntry[]>()
 
@@ -68,8 +68,8 @@ export async function migrateLegacyMarkdown(
   sessionPath: string,
   content: string,
   sessionFilename: string,
-  updateMetadata: (sessionPath: string, updates: Partial<SessionMetadata>) => Promise<void>
-): Promise<MigrationResult> {
+  updateMetadata: (sessionPath: string, updates: Partial<SessionLogMetadata>) => Promise<void>
+): Promise<SessionMigrationResult> {
   const filePath = path.join(sessionPath, sessionFilename)
 
   await fileHelper.writeFile(filePath, content)

package/core/{infrastructure/session-manager/session-manager.ts → session/session-log-manager.ts}

@@ -1,20 +1,21 @@
 /**
- * SessionManager Class
+ * SessionLogManager Class
  * Manages temporal fragmentation of logs and progress data.
+ * Writes to sessions/YYYY-MM/DD/ structure with auto-rotation.
  */
 
 import path from 'path'
-import pathManager from '../path-manager'
-import { VERSION } from '../../utils/version'
-import * as dateHelper from '../../utils/date-helper'
-import * as jsonlHelper from '../../utils/jsonl-helper'
-import * as fileHelper from '../../utils/file-helper'
-import { migrateLegacyJsonl, migrateLegacyMarkdown } from './migration'
-import type { SessionEntry, SessionMetadata, SessionStats, MigrationResult } from './types'
-
-export class SessionManager {
+import pathManager from '../infrastructure/path-manager'
+import { VERSION } from '../utils/version'
+import * as dateHelper from '../utils/date-helper'
+import * as jsonlHelper from '../utils/jsonl-helper'
+import * as fileHelper from '../utils/file-helper'
+import { migrateLegacyJsonl, migrateLegacyMarkdown } from './log-migration'
+import type { SessionEntry, SessionLogMetadata, SessionStats, SessionMigrationResult } from '../types'
+
+export class SessionLogManager {
   private currentSessionCache: Map<string, string>
-  private sessionMetadataCache: Map<string, SessionMetadata>
+  private sessionMetadataCache: Map<string, SessionLogMetadata>
 
   constructor() {
     this.currentSessionCache = new Map()
@@ -34,7 +35,7 @@ export class SessionManager {
     const sessionPath = await pathManager.ensureSessionPath(projectId)
     this.currentSessionCache.set(cacheKey, sessionPath)
 
-    await this._ensureSessionMetadata(sessionPath)
+    await this._ensureSessionLogMetadata(sessionPath)
 
     return sessionPath
   }
@@ -53,7 +54,7 @@ export class SessionManager {
     // Use automatic rotation to prevent large files (>10MB)
     await jsonlHelper.appendJsonLineWithRotation(filePath, entry, 10)
 
-    await this._updateSessionMetadata(sessionPath, {
+    await this._updateSessionLogMetadata(sessionPath, {
       lastActivity: dateHelper.getTimestamp(),
       entryCount: await jsonlHelper.countJsonLines(filePath),
     })
@@ -73,7 +74,7 @@ export class SessionManager {
       await fileHelper.appendToFile(filePath, content)
     }
 
-    await this._updateSessionMetadata(sessionPath, {
+    await this._updateSessionLogMetadata(sessionPath, {
       lastActivity: dateHelper.getTimestamp(),
     })
   }
@@ -177,7 +178,7 @@ export class SessionManager {
     let activeDays = 0
 
     for (const session of sessions) {
-      const metadata = await this._getSessionMetadata(session.path)
+      const metadata = await this._getSessionLogMetadata(session.path)
       if (metadata) {
         totalEntries += metadata.entryCount || 0
         totalShips += metadata.shipCount || 0
@@ -203,7 +204,7 @@ export class SessionManager {
     projectId: string,
     legacyFilePath: string,
     sessionFilename: string
-  ): Promise<MigrationResult> {
+  ): Promise<SessionMigrationResult> {
     try {
       const content = await fileHelper.readFile(legacyFilePath)
 
@@ -212,8 +213,8 @@ export class SessionManager {
           projectId,
           content,
           sessionFilename,
-          (sp, u) => this._updateSessionMetadata(sp, u),
-          (sp) => this._ensureSessionMetadata(sp)
+          (sp, u) => this._updateSessionLogMetadata(sp, u),
+          (sp) => this._ensureSessionLogMetadata(sp)
         )
       } else {
         const sessionPath = await this.getCurrentSession(projectId)
@@ -221,7 +222,7 @@ export class SessionManager {
           sessionPath,
           content,
           sessionFilename,
-          (sp, u) => this._updateSessionMetadata(sp, u)
+          (sp, u) => this._updateSessionLogMetadata(sp, u)
         )
       }
     } catch (error) {
@@ -236,14 +237,14 @@ export class SessionManager {
   /**
    * Get session metadata
    */
-  private async _getSessionMetadata(sessionPath: string): Promise<SessionMetadata | null> {
+  private async _getSessionLogMetadata(sessionPath: string): Promise<SessionLogMetadata | null> {
     const metadataPath = path.join(sessionPath, 'session-meta.json')
 
     if (this.sessionMetadataCache.has(sessionPath)) {
       return this.sessionMetadataCache.get(sessionPath)!
     }
 
-    const metadata = await fileHelper.readJson<SessionMetadata>(metadataPath, null)
+    const metadata = await fileHelper.readJson<SessionLogMetadata>(metadataPath, null)
     if (metadata) {
       this.sessionMetadataCache.set(sessionPath, metadata)
     }
@@ -253,12 +254,12 @@ export class SessionManager {
   /**
    * Ensure session metadata exists
    */
-  private async _ensureSessionMetadata(sessionPath: string): Promise<void> {
+  private async _ensureSessionLogMetadata(sessionPath: string): Promise<void> {
     const metadataPath = path.join(sessionPath, 'session-meta.json')
 
     const exists = await fileHelper.fileExists(metadataPath)
     if (!exists) {
-      const metadata: SessionMetadata = {
+      const metadata: SessionLogMetadata = {
         created: dateHelper.getTimestamp(),
         lastActivity: dateHelper.getTimestamp(),
         entryCount: 0,
@@ -273,11 +274,11 @@ export class SessionManager {
   /**
    * Update session metadata
    */
-  private async _updateSessionMetadata(
+  private async _updateSessionLogMetadata(
     sessionPath: string,
-    updates: Partial<SessionMetadata>
+    updates: Partial<SessionLogMetadata>
   ): Promise<void> {
-    const metadata = (await this._getSessionMetadata(sessionPath)) || {}
+    const metadata = (await this._getSessionLogMetadata(sessionPath)) || {}
     Object.assign(metadata, updates)
 
     const metadataPath = path.join(sessionPath, 'session-meta.json')

package/core/session/{session-manager.ts → task-session-manager.ts}

@@ -1,6 +1,7 @@
 /**
- * SessionManager Class
- * Core session management functionality
+ * TaskSessionManager Class
+ * Manages task lifecycle: create, pause, resume, complete
+ * Tracks metrics, timeline, and archives completed sessions.
  */
 
 import fs from 'fs/promises'
@@ -10,12 +11,12 @@ import { promisify } from 'util'
 import pathManager from '../infrastructure/path-manager'
 import configManager from '../infrastructure/config-manager'
 import { emit } from '../bus'
-import type { Session, SessionMetrics } from './types'
+import type { Session, SessionMetrics } from '../types'
 import { generateId, calculateDuration, formatDuration } from './utils'
 
 const execAsync = promisify(exec)
 
-export class SessionManager {
+export class TaskSessionManager {
   private projectPath: string
   private projectId: string | null
   private sessionDir: string | null
@@ -89,7 +90,9 @@ export class SessionManager {
       completedAt: null,
       duration: 0,
       metrics: {
+        filesCreated: 0,
         filesChanged: 0,
+        filesModified: 0,
         linesAdded: 0,
         linesRemoved: 0,
         commits: 0,

package/core/session/utils.ts

@@ -2,7 +2,7 @@
  * Session Utilities
  */
 
-import type { Session, TimelineEvent } from './types'
+import type { Session, TimelineEvent } from '../types'
 import { generateUUID } from '../schemas'
 
 /**

package/core/storage/ideas-storage.ts

@@ -7,24 +7,8 @@
 
 import { StorageManager } from './storage-manager'
 import { generateUUID } from '../schemas'
-
-export type IdeaStatus = 'pending' | 'converted' | 'archived'
-export type IdeaPriority = 'low' | 'medium' | 'high'
-
-export interface Idea {
-  id: string
-  text: string
-  status: IdeaStatus
-  priority: IdeaPriority
-  tags: string[]
-  addedAt: string
-  convertedTo?: string // featureId if converted
-}
-
-export interface IdeasJson {
-  ideas: Idea[]
-  lastUpdated: string
-}
+import { getTimestamp } from '../utils/date-helper'
+import type { Idea, IdeasJson, IdeaStatus, IdeaPriority } from '../types'
 
 class IdeasStorage extends StorageManager<IdeasJson> {
   constructor() {
@@ -127,12 +111,12 @@ class IdeasStorage extends StorageManager<IdeasJson> {
       status: 'pending',
       priority: options.priority || 'medium',
       tags: options.tags || [],
-      addedAt: new Date().toISOString()
+      addedAt: getTimestamp()
     }
 
     await this.update(projectId, (data) => ({
       ideas: [idea, ...data.ideas], // Prepend new ideas
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
 
     // Publish event
@@ -167,7 +151,7 @@ class IdeasStorage extends StorageManager<IdeasJson> {
           ? { ...i, status: 'converted' as IdeaStatus, convertedTo: featureId }
           : i
       ),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
 
     await this.publishEvent(projectId, 'idea.converted', {
@@ -184,7 +168,7 @@ class IdeasStorage extends StorageManager<IdeasJson> {
       ideas: data.ideas.map(i =>
         i.id === ideaId ? { ...i, status: 'archived' as IdeaStatus } : i
       ),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
 
     await this.publishEvent(projectId, 'idea.archived', { ideaId })
@@ -202,7 +186,7 @@ class IdeasStorage extends StorageManager<IdeasJson> {
       ideas: data.ideas.map(i =>
         i.id === ideaId ? { ...i, priority } : i
       ),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
   }
 
@@ -220,7 +204,7 @@ class IdeasStorage extends StorageManager<IdeasJson> {
           ? { ...i, tags: [...new Set([...i.tags, ...tags])] }
           : i
       ),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
   }
 
@@ -230,7 +214,7 @@ class IdeasStorage extends StorageManager<IdeasJson> {
   async removeIdea(projectId: string, ideaId: string): Promise<void> {
     await this.update(projectId, (data) => ({
       ideas: data.ideas.filter(i => i.id !== ideaId),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
   }
 
@@ -266,7 +250,7 @@ class IdeasStorage extends StorageManager<IdeasJson> {
 
     await this.update(projectId, (d) => ({
       ideas: d.ideas.filter(i => !toRemove.has(i.id)),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
 
     return { removed }

package/core/storage/index.ts

@@ -38,167 +38,19 @@
 export { StorageManager } from './storage-manager'
 export { stateStorage } from './state-storage'
 export { queueStorage } from './queue-storage'
-export { ideasStorage, type Idea, type IdeasJson, type IdeaStatus, type IdeaPriority } from './ideas-storage'
-export { shippedStorage, type ShippedFeature, type ShippedJson } from './shipped-storage'
+export { ideasStorage } from './ideas-storage'
+export { shippedStorage } from './shipped-storage'
 
 // ========== GRANULAR STORAGE (Legacy) ==========
-
-import fs from 'fs/promises'
-import path from 'path'
-import os from 'os'
-import { eventBus, inferEventType } from '../events'
-
-export interface Storage {
-  write<T>(path: string[], data: T): Promise<void>
-  read<T>(path: string[]): Promise<T | null>
-  list(prefix: string[]): Promise<string[][]>
-  delete(path: string[]): Promise<void>
-  exists(path: string[]): Promise<boolean>
-}
-
-class FileStorage implements Storage {
-  private projectId: string
-  private basePath: string
-
-  constructor(projectId: string) {
-    this.projectId = projectId
-    this.basePath = path.join(os.homedir(), '.prjct-cli/projects', projectId, 'data')
-  }
-
-  /**
-   * Convert path array to file path
-   * ["task", "abc123"] → data/tasks/abc123.json
-   * ["project"] → data/project.json
-   */
-  private pathToFile(pathArray: string[]): string {
-    if (pathArray.length === 1) {
-      return path.join(this.basePath, `${pathArray[0]}.json`)
-    }
-
-    // Pluralize first segment for directory
-    const dir = pathArray[0] + 's'
-    const rest = pathArray.slice(1)
-    const filename = rest.join('/') + '.json'
-
-    return path.join(this.basePath, dir, filename)
-  }
-
-  async write<T>(pathArray: string[], data: T): Promise<void> {
-    const filePath = this.pathToFile(pathArray)
-
-    // Ensure directory exists
-    await fs.mkdir(path.dirname(filePath), { recursive: true })
-
-    // Write data
-    await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf-8')
-
-    // Publish event for sync
-    eventBus.publish({
-      type: inferEventType(pathArray, 'write'),
-      path: pathArray,
-      data,
-      timestamp: new Date().toISOString(),
-      projectId: this.projectId
-    })
-
-    // Update index if it's a collection item
-    if (pathArray.length === 2) {
-      await this.updateIndex(pathArray[0], pathArray[1], 'add')
-    }
-  }
-
-  async read<T>(pathArray: string[]): Promise<T | null> {
-    const filePath = this.pathToFile(pathArray)
-
-    try {
-      const content = await fs.readFile(filePath, 'utf-8')
-      return JSON.parse(content) as T
-    } catch {
-      return null
-    }
-  }
-
-  async list(prefix: string[]): Promise<string[][]> {
-    const dir = path.join(this.basePath, prefix[0] + 's')
-
-    try {
-      const files = await fs.readdir(dir)
-      return files
-        .filter(f => f.endsWith('.json') && f !== 'index.json')
-        .map(f => [...prefix, f.replace('.json', '')])
-    } catch {
-      return []
-    }
-  }
-
-  async delete(pathArray: string[]): Promise<void> {
-    const filePath = this.pathToFile(pathArray)
-
-    try {
-      await fs.unlink(filePath)
-
-      // Publish event for sync
-      eventBus.publish({
-        type: inferEventType(pathArray, 'delete'),
-        path: pathArray,
-        data: null,
-        timestamp: new Date().toISOString(),
-        projectId: this.projectId
-      })
-
-      // Update index if it's a collection item
-      if (pathArray.length === 2) {
-        await this.updateIndex(pathArray[0], pathArray[1], 'remove')
-      }
-    } catch {
-      // File doesn't exist, ignore
-    }
-  }
-
-  async exists(pathArray: string[]): Promise<boolean> {
-    const filePath = this.pathToFile(pathArray)
-
-    try {
-      await fs.access(filePath)
-      return true
-    } catch {
-      return false
-    }
-  }
-
-  /**
-   * Update collection index
-   */
-  private async updateIndex(collection: string, id: string, action: 'add' | 'remove'): Promise<void> {
-    const indexPath = path.join(this.basePath, collection + 's', 'index.json')
-
-    let index: { ids: string[]; updatedAt: string } = { ids: [], updatedAt: '' }
-
-    try {
-      const content = await fs.readFile(indexPath, 'utf-8')
-      index = JSON.parse(content)
-    } catch {
-      // Index doesn't exist yet
-    }
-
-    if (action === 'add' && !index.ids.includes(id)) {
-      index.ids.push(id)
-    } else if (action === 'remove') {
-      index.ids = index.ids.filter(i => i !== id)
-    }
-
-    index.updatedAt = new Date().toISOString()
-
-    await fs.mkdir(path.dirname(indexPath), { recursive: true })
-    await fs.writeFile(indexPath, JSON.stringify(index, null, 2), 'utf-8')
-  }
-}
-
-/**
- * Get storage instance for a project
- */
-export function getStorage(projectId: string): Storage {
-  return new FileStorage(projectId)
-}
-
-export default { getStorage }
+export { getStorage, default } from './storage'
+
+// Re-export types from canonical location
+export type {
+  Storage,
+  Idea,
+  IdeasJson,
+  IdeaStatus,
+  IdeaPriority,
+  ShippedFeature,
+  ShippedJson,
+} from '../types'

package/core/storage/queue-storage.ts

@@ -7,6 +7,7 @@
 
 import { StorageManager } from './storage-manager'
 import { generateUUID } from '../schemas'
+import { getTimestamp } from '../utils/date-helper'
 import type { QueueJson, QueueTask, Priority, TaskType, TaskSection } from '../schemas/state'
 
 class QueueStorage extends StorageManager<QueueJson> {
@@ -125,13 +126,13 @@ class QueueStorage extends StorageManager<QueueJson> {
     const newTask: QueueTask = {
       ...task,
       id: generateUUID(),
-      createdAt: new Date().toISOString(),
+      createdAt: getTimestamp(),
       completed: false
     }
 
     await this.update(projectId, (queue) => ({
       tasks: [...queue.tasks, newTask],
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
 
     // Publish incremental event
@@ -152,7 +153,7 @@ class QueueStorage extends StorageManager<QueueJson> {
     projectId: string,
     tasks: Omit<QueueTask, 'id' | 'createdAt' | 'completed' | 'completedAt'>[]
   ): Promise<QueueTask[]> {
-    const now = new Date().toISOString()
+    const now = getTimestamp()
     const newTasks: QueueTask[] = tasks.map(task => ({
       ...task,
       id: generateUUID(),
@@ -180,7 +181,7 @@ class QueueStorage extends StorageManager<QueueJson> {
   async removeTask(projectId: string, taskId: string): Promise<void> {
     await this.update(projectId, (queue) => ({
       tasks: queue.tasks.filter(t => t.id !== taskId),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
 
     await this.publishEvent(projectId, 'queue.task_removed', { taskId })
@@ -198,20 +199,21 @@ class QueueStorage extends StorageManager<QueueJson> {
           completedTask = {
             ...t,
             completed: true,
-            completedAt: new Date().toISOString()
+            completedAt: getTimestamp()
           }
           return completedTask
         }
         return t
       })
-      return { tasks, lastUpdated: new Date().toISOString() }
+      return { tasks, lastUpdated: getTimestamp() }
     })
 
     if (completedTask) {
+      const task = completedTask as QueueTask
       await this.publishEvent(projectId, 'queue.task_completed', {
         taskId,
-        description: completedTask.description,
-        completedAt: completedTask.completedAt
+        description: task.description,
+        completedAt: task.completedAt
       })
     }
 
@@ -230,7 +232,7 @@ class QueueStorage extends StorageManager<QueueJson> {
       tasks: queue.tasks.map(t =>
         t.id === taskId ? { ...t, section } : t
       ),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
   }
 
@@ -246,7 +248,7 @@ class QueueStorage extends StorageManager<QueueJson> {
       tasks: queue.tasks.map(t =>
         t.id === taskId ? { ...t, priority } : t
       ),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
   }
 
@@ -259,7 +261,7 @@ class QueueStorage extends StorageManager<QueueJson> {
 
     await this.update(projectId, (q) => ({
       tasks: q.tasks.filter(t => !t.completed),
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
 
     return completedCount

package/core/storage/shipped-storage.ts

@@ -7,21 +7,8 @@
 
 import { StorageManager } from './storage-manager'
 import { generateUUID } from '../schemas'
-
-export interface ShippedFeature {
-  id: string
-  name: string
-  shippedAt: string
-  version: string
-  description?: string
-  tasks?: string[] // Task IDs that were part of this ship
-  duration?: string // How long it took
-}
-
-export interface ShippedJson {
-  shipped: ShippedFeature[]
-  lastUpdated: string
-}
+import { getTimestamp } from '../utils/date-helper'
+import type { ShippedFeature, ShippedJson } from '../types'
 
 class ShippedStorage extends StorageManager<ShippedJson> {
   constructor() {
@@ -139,12 +126,12 @@ class ShippedStorage extends StorageManager<ShippedJson> {
     const shipped: ShippedFeature = {
       ...feature,
       id: generateUUID(),
-      shippedAt: new Date().toISOString()
+      shippedAt: getTimestamp()
     }
 
     await this.update(projectId, (data) => ({
       shipped: [shipped, ...data.shipped], // Prepend
-      lastUpdated: new Date().toISOString()
+      lastUpdated: getTimestamp()
     }))
 
     // Publish event