prjct-cli 0.6.0 → 0.7.0

package/core/{capability-installer.js → infrastructure/capability-installer.js}

@@ -20,7 +20,7 @@ class CapabilityInstaller {
       const { stdout, stderr } = await execAsync(command)
 
       const duration = Date.now() - startTime
-      const durationMin = Math.round(duration / 1000 / 60 * 10) / 10
+      const durationMin = Math.round((duration / 1000 / 60) * 10) / 10
 
       return {
         success: true,
@@ -160,10 +160,7 @@ export default defineConfig({
         },
       }
 
-      await fs.writeFile(
-        path.join(projectPath, 'jsdoc.json'),
-        JSON.stringify(config, null, 2),
-      )
+      await fs.writeFile(path.join(projectPath, 'jsdoc.json'), JSON.stringify(config, null, 2))
 
       // Add docs script
       pkg.scripts = pkg.scripts || {}
@@ -180,7 +177,7 @@ export default defineConfig({
    * Verify installation succeeded
    */
   async verify(capability, projectPath) {
-    const caps = require('./project-capabilities')
+    const caps = require('../utils/project-capabilities')
     const detected = await caps.detect(projectPath)
 
     return detected[capability] === true

package/core/{command-installer.js → infrastructure/command-installer.js}

@@ -39,7 +39,7 @@ class CommandInstaller {
   async getCommandFiles() {
     try {
       const files = await fs.readdir(this.templatesDir)
-      return files.filter(f => f.endsWith('.md'))
+      return files.filter((f) => f.endsWith('.md'))
     } catch (error) {
       // Fallback to core commands if template directory not accessible
       return [
@@ -175,7 +175,9 @@ class CommandInstaller {
     try {
       await fs.access(this.claudeCommandsPath)
       const files = await fs.readdir(this.claudeCommandsPath)
-      const installedCommands = files.filter(f => f.endsWith('.md')).map(f => f.replace('.md', ''))
+      const installedCommands = files
+        .filter((f) => f.endsWith('.md'))
+        .map((f) => f.replace('.md', ''))
 
       return {
         installed: installedCommands.length > 0,

package/core/{config-manager.js → infrastructure/config-manager.js}

@@ -1,6 +1,6 @@
 const fs = require('fs').promises
 const pathManager = require('./path-manager')
-const { VERSION } = require('./version')
+const { VERSION } = require('../utils/version')
 
 /**
  * ConfigManager - Manages prjct.config.json files
@@ -234,7 +234,7 @@ class ConfigManager {
     const globalConfig = await this.readGlobalConfig(projectId)
     if (!globalConfig || !globalConfig.authors) return null
 
-    return globalConfig.authors.find(a => a.github === githubUsername) || null
+    return globalConfig.authors.find((a) => a.github === githubUsername) || null
   }
 
   /**
@@ -248,7 +248,7 @@ class ConfigManager {
   async addAuthor(projectId, author) {
     const globalConfig = await this.ensureGlobalConfig(projectId)
 
-    const exists = globalConfig.authors.some(a => a.github === author.github)
+    const exists = globalConfig.authors.some((a) => a.github === author.github)
     if (exists) return
 
     const now = new Date().toISOString()
@@ -276,7 +276,7 @@ class ConfigManager {
     const globalConfig = await this.readGlobalConfig(projectId)
     if (!globalConfig || !globalConfig.authors) return
 
-    const author = globalConfig.authors.find(a => a.github === githubUsername)
+    const author = globalConfig.authors.find((a) => a.github === githubUsername)
     if (author) {
       author.lastActivity = new Date().toISOString()
       globalConfig.lastSync = author.lastActivity

package/core/{editors-config.js → infrastructure/editors-config.js}

@@ -64,11 +64,7 @@ class EditorsConfig {
         path: claudePath,
       }
 
-      await fs.writeFile(
-        this.configFile,
-        JSON.stringify(config, null, 2),
-        'utf-8',
-      )
+      await fs.writeFile(this.configFile, JSON.stringify(config, null, 2), 'utf-8')
 
       return true
     } catch (error) {
@@ -111,11 +107,7 @@ class EditorsConfig {
       config.version = version
       config.lastInstall = new Date().toISOString()
 
-      await fs.writeFile(
-        this.configFile,
-        JSON.stringify(config, null, 2),
-        'utf-8',
-      )
+      await fs.writeFile(this.configFile, JSON.stringify(config, null, 2), 'utf-8')
 
       return true
     } catch (error) {

package/core/{migrator.js → infrastructure/migrator.js}

@@ -64,8 +64,12 @@ class Migrator {
 
       const globalConfig = await configManager.readGlobalConfig(projectId)
       if (globalConfig && globalConfig.authors && globalConfig.authors.length > 0) {
-        const needsCleanup = localConfig.authors || localConfig.author ||
-                            localConfig.version || localConfig.created || localConfig.lastSync
+        const needsCleanup =
+          localConfig.authors ||
+          localConfig.author ||
+          localConfig.version ||
+          localConfig.created ||
+          localConfig.lastSync
 
         if (needsCleanup) {
           delete localConfig.authors
@@ -182,7 +186,11 @@ class Migrator {
       return { layer: 'planning', filename }
     }
 
-    if (filename === 'memory.jsonl' || filename === 'context.jsonl' || filename === 'decisions.jsonl') {
+    if (
+      filename === 'memory.jsonl' ||
+      filename === 'context.jsonl' ||
+      filename === 'decisions.jsonl'
+    ) {
       return { layer: 'memory', filename }
     }
 
@@ -317,9 +325,7 @@ class Migrator {
       const layerPath = path.join(legacyPath, layer)
       try {
         await fs.rm(layerPath, { recursive: true, force: true })
-      } catch {
-
-      }
+      } catch {}
     }
   }
 
@@ -510,10 +516,20 @@ class Migrator {
     if (deepScan) {
       searchPaths = [os.homedir()]
     } else {
-      const commonDirs = ['Projects', 'Documents', 'Developer', 'Code', 'dev', 'workspace', 'repos', 'src', 'Apps']
+      const commonDirs = [
+        'Projects',
+        'Documents',
+        'Developer',
+        'Code',
+        'dev',
+        'workspace',
+        'repos',
+        'src',
+        'Apps',
+      ]
       searchPaths = commonDirs
-        .map(dir => path.join(os.homedir(), dir))
-        .filter(dirPath => {
+        .map((dir) => path.join(os.homedir(), dir))
+        .filter((dirPath) => {
           try {
             fs.accessSync(dirPath)
             return true
@@ -540,13 +556,13 @@ class Migrator {
       return skipDirs.includes(dirName) || (dirName.startsWith('.') && dirName !== '.prjct')
     }
 
-    const searchDirectory = async(dirPath, depth = 0) => {
+    const searchDirectory = async (dirPath, depth = 0) => {
       if (depth > 10) return
 
       try {
         const entries = await fs.readdir(dirPath, { withFileTypes: true })
 
-        if (entries.some(entry => entry.name === '.prjct' && entry.isDirectory())) {
+        if (entries.some((entry) => entry.name === '.prjct' && entry.isDirectory())) {
           projectDirs.push(dirPath)
           return // Don't search subdirectories if we found a project
         }
@@ -557,9 +573,7 @@ class Migrator {
             await searchDirectory(subPath, depth + 1)
           }
         }
-      } catch (error) {
-
-      }
+      } catch (error) {}
     }
 
     for (const searchPath of searchPaths) {
@@ -637,7 +651,8 @@ class Migrator {
 
           if (status.status === 'migrated' || status.status === 'new') {
             projectInfo.result = 'skipped'
-            projectInfo.reason = status.status === 'migrated' ? 'Already migrated' : 'Not initialized'
+            projectInfo.reason =
+              status.status === 'migrated' ? 'Already migrated' : 'Not initialized'
             summary.alreadyMigrated++
           } else if (status.needsMigration) {
             if (interactive && onProgress) {
@@ -749,8 +764,8 @@ class Migrator {
     if (summary.successfullyMigrated > 0) {
       lines.push('✅ Successfully Migrated:')
       summary.projects
-        .filter(p => p.result === 'success')
-        .forEach(project => {
+        .filter((p) => p.result === 'success')
+        .forEach((project) => {
           lines.push(`   • ${project.name}`)
           lines.push(`     Files: ${project.filesCopied} | ID: ${project.projectId}`)
         })
@@ -759,9 +774,9 @@ class Migrator {
 
     if (summary.errors.length > 0) {
       lines.push('❌ Errors:')
-      summary.errors.forEach(error => {
+      summary.errors.forEach((error) => {
         lines.push(`   • ${error.project}`)
-        error.issues.forEach(issue => lines.push(`     - ${issue}`))
+        error.issues.forEach((issue) => lines.push(`     - ${issue}`))
       })
       lines.push('')
     }

package/core/{path-manager.js → infrastructure/path-manager.js}

@@ -2,6 +2,8 @@ const fs = require('fs').promises
 const path = require('path')
 const crypto = require('crypto')
 const os = require('os')
+const dateHelper = require('../utils/date-helper')
+const fileHelper = require('../utils/file-helper')
 
 /**
  * PathManager - Manages project paths between local and global storage
@@ -90,13 +92,8 @@ class PathManager {
    * @returns {Promise<boolean>} - True if legacy directory exists
    */
   async hasLegacyStructure(projectPath) {
-    try {
-      const legacyPath = this.getLegacyPrjctPath(projectPath)
-      await fs.access(legacyPath)
-      return true
-    } catch {
-      return false
-    }
+    const legacyPath = this.getLegacyPrjctPath(projectPath)
+    return await fileHelper.dirExists(legacyPath)
   }
 
   /**
@@ -106,13 +103,8 @@ class PathManager {
    * @returns {Promise<boolean>} - True if config exists
    */
   async hasConfig(projectPath) {
-    try {
-      const configPath = this.getLocalConfigPath(projectPath)
-      await fs.access(configPath)
-      return true
-    } catch {
-      return false
-    }
+    const configPath = this.getLocalConfigPath(projectPath)
+    return await fileHelper.fileExists(configPath)
   }
 
   /**
@@ -122,9 +114,9 @@ class PathManager {
    * @returns {Promise<void>}
    */
   async ensureGlobalStructure() {
-    await fs.mkdir(this.globalBaseDir, { recursive: true })
-    await fs.mkdir(this.globalProjectsDir, { recursive: true })
-    await fs.mkdir(this.globalConfigDir, { recursive: true })
+    await fileHelper.ensureDir(this.globalBaseDir)
+    await fileHelper.ensureDir(this.globalProjectsDir)
+    await fileHelper.ensureDir(this.globalConfigDir)
   }
 
   /**
@@ -142,12 +134,11 @@ class PathManager {
     const layers = ['core', 'progress', 'planning', 'analysis', 'memory']
 
     for (const layer of layers) {
-      await fs.mkdir(path.join(projectPath, layer), { recursive: true })
+      await fileHelper.ensureDir(path.join(projectPath, layer))
     }
 
-    await fs.mkdir(path.join(projectPath, 'planning', 'tasks'), { recursive: true })
-
-    await fs.mkdir(path.join(projectPath, 'sessions'), { recursive: true })
+    await fileHelper.ensureDir(path.join(projectPath, 'planning', 'tasks'))
+    await fileHelper.ensureDir(path.join(projectPath, 'sessions'))
 
     return projectPath
   }
@@ -161,17 +152,9 @@ class PathManager {
    * @returns {string} - Path to session directory
    */
   getSessionPath(projectId, date = new Date()) {
-    const year = date.getFullYear().toString()
-    const month = (date.getMonth() + 1).toString().padStart(2, '0')
-    const day = date.getDate().toString().padStart(2, '0')
-
-    return path.join(
-      this.getGlobalProjectPath(projectId),
-      'sessions',
-      year,
-      month,
-      day,
-    )
+    const { year, month, day } = dateHelper.getYearMonthDay(date)
+
+    return path.join(this.getGlobalProjectPath(projectId), 'sessions', year, month, day)
   }
 
   /**
@@ -193,7 +176,7 @@ class PathManager {
    */
   async ensureSessionPath(projectId, date = new Date()) {
     const sessionPath = this.getSessionPath(projectId, date)
-    await fs.mkdir(sessionPath, { recursive: true })
+    await fileHelper.ensureDir(sessionPath)
     return sessionPath
   }
 
@@ -258,7 +241,7 @@ class PathManager {
   async getSessionsInRange(projectId, fromDate, toDate = new Date()) {
     const allSessions = await this.listSessions(projectId)
 
-    return allSessions.filter(session => session.date >= fromDate && session.date <= toDate)
+    return allSessions.filter((session) => session.date >= fromDate && session.date <= toDate)
   }
 
   /**
@@ -282,9 +265,7 @@ class PathManager {
     try {
       await this.ensureGlobalStructure()
       const entries = await fs.readdir(this.globalProjectsDir, { withFileTypes: true })
-      return entries
-        .filter(entry => entry.isDirectory())
-        .map(entry => entry.name)
+      return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name)
     } catch {
       return []
     }
@@ -297,13 +278,8 @@ class PathManager {
    * @returns {Promise<boolean>} - True if project exists
    */
   async projectExists(projectId) {
-    try {
-      const projectPath = this.getGlobalProjectPath(projectId)
-      await fs.access(projectPath)
-      return true
-    } catch {
-      return false
-    }
+    const projectPath = this.getGlobalProjectPath(projectId)
+    return await fileHelper.dirExists(projectPath)
   }
 
   /**

package/core/{session-manager.js → infrastructure/session-manager.js}

@@ -1,7 +1,10 @@
 const fs = require('fs').promises
 const path = require('path')
 const pathManager = require('./path-manager')
-const { VERSION } = require('./version')
+const { VERSION } = require('../utils/version')
+const dateHelper = require('../utils/date-helper')
+const jsonlHelper = require('../utils/jsonl-helper')
+const fileHelper = require('../utils/file-helper')
 
 /**
  * SessionManager - Manages temporal fragmentation of logs and progress data
@@ -54,18 +57,11 @@ class SessionManager {
     const sessionPath = await this.getCurrentSession(projectId)
     const filePath = path.join(sessionPath, filename)
 
-    const logLine = JSON.stringify(entry) + '\n'
-
-    try {
-      const existing = await fs.readFile(filePath, 'utf-8')
-      await fs.writeFile(filePath, existing + logLine, 'utf-8')
-    } catch {
-      await fs.writeFile(filePath, logLine, 'utf-8')
-    }
+    await jsonlHelper.appendJsonLine(filePath, entry)
 
     await this._updateSessionMetadata(sessionPath, {
-      lastActivity: new Date().toISOString(),
-      entryCount: await this._getFileLineCount(filePath),
+      lastActivity: dateHelper.getTimestamp(),
+      entryCount: await jsonlHelper.countJsonLines(filePath),
     })
   }
 
@@ -81,19 +77,15 @@ class SessionManager {
     const sessionPath = await this.getCurrentSession(projectId)
     const filePath = path.join(sessionPath, filename)
 
-    try {
-      const existing = await fs.readFile(filePath, 'utf-8')
-      await fs.writeFile(filePath, existing + content, 'utf-8')
-    } catch {
-      let initialContent = ''
-      if (filename === 'shipped.md') {
-        initialContent = '# SHIPPED 🚀\n\n'
-      }
-      await fs.writeFile(filePath, initialContent + content, 'utf-8')
+    const exists = await fileHelper.fileExists(filePath)
+    if (!exists && filename === 'shipped.md') {
+      await fileHelper.writeFile(filePath, '# SHIPPED 🚀\n\n' + content)
+    } else {
+      await fileHelper.appendToFile(filePath, content)
     }
 
     await this._updateSessionMetadata(sessionPath, {
-      lastActivity: new Date().toISOString(),
+      lastActivity: dateHelper.getTimestamp(),
     })
   }
 
@@ -108,12 +100,7 @@ class SessionManager {
     const sessionPath = await this.getCurrentSession(projectId)
     const filePath = path.join(sessionPath, filename)
 
-    try {
-      const content = await fs.readFile(filePath, 'utf-8')
-      return this._parseJsonLines(content)
-    } catch {
-      return []
-    }
+    return await jsonlHelper.readJsonLines(filePath)
   }
 
   /**
@@ -131,18 +118,13 @@ class SessionManager {
 
     for (const session of sessions) {
       const filePath = path.join(session.path, filename)
-      try {
-        const content = await fs.readFile(filePath, 'utf-8')
-        const entries = this._parseJsonLines(content)
+      const entries = await jsonlHelper.readJsonLines(filePath)
 
-        entries.forEach(entry => {
-          entry._sessionDate = session.date
-        })
+      entries.forEach((entry) => {
+        entry._sessionDate = session.date
+      })
 
-        allEntries.push(...entries)
-      } catch {
-        continue
-      }
+      allEntries.push(...entries)
     }
 
     return allEntries
@@ -163,13 +145,12 @@ class SessionManager {
 
     for (const session of sessions) {
       const filePath = path.join(session.path, filename)
-      try {
-        const content = await fs.readFile(filePath, 'utf-8')
-        if (content.trim()) {
-          allContent.push(`## Session: ${session.year}-${session.month}-${session.day}\n\n${content}`)
-        }
-      } catch {
-        continue
+      const content = await fileHelper.readFile(filePath, '')
+
+      if (content.trim()) {
+        allContent.push(
+          `## Session: ${session.year}-${session.month}-${session.day}\n\n${content}`
+        )
       }
     }
 
@@ -186,8 +167,7 @@ class SessionManager {
    */
   async getRecentLogs(projectId, days = 7, filename = 'context.jsonl') {
     const toDate = new Date()
-    const fromDate = new Date()
-    fromDate.setDate(fromDate.getDate() - days)
+    const fromDate = dateHelper.getDaysAgo(days)
 
     return await this.readSessionRange(projectId, fromDate, toDate, filename)
   }
@@ -237,7 +217,7 @@ class SessionManager {
    */
   async migrateLegacyLogs(projectId, legacyFilePath, sessionFilename) {
     try {
-      const content = await fs.readFile(legacyFilePath, 'utf-8')
+      const content = await fileHelper.readFile(legacyFilePath)
 
       if (sessionFilename.endsWith('.jsonl')) {
         return await this._migrateLegacyJsonl(projectId, content, sessionFilename)
@@ -258,12 +238,12 @@ class SessionManager {
    * @private
    */
   async _migrateLegacyJsonl(projectId, content, sessionFilename) {
-    const entries = this._parseJsonLines(content)
+    const entries = jsonlHelper.parseJsonLines(content)
     const sessionGroups = new Map()
 
     for (const entry of entries) {
       const date = new Date(entry.timestamp || entry.data?.timestamp || Date.now())
-      const dateKey = this._getDateKey(date)
+      const dateKey = dateHelper.getDateKey(date)
 
       if (!sessionGroups.has(dateKey)) {
         sessionGroups.set(dateKey, [])
@@ -278,8 +258,7 @@ class SessionManager {
       const sessionPath = await pathManager.ensureSessionPath(projectId, date)
       const filePath = path.join(sessionPath, sessionFilename)
 
-      const content = groupEntries.map(e => JSON.stringify(e)).join('\n') + '\n'
-      await fs.writeFile(filePath, content, 'utf-8')
+      await jsonlHelper.writeJsonLines(filePath, groupEntries)
 
       migratedCount += groupEntries.length
 
@@ -287,7 +266,7 @@ class SessionManager {
       await this._updateSessionMetadata(sessionPath, {
         entryCount: groupEntries.length,
         migrated: true,
-        migratedAt: new Date().toISOString(),
+        migratedAt: dateHelper.getTimestamp(),
       })
     }
 
@@ -307,11 +286,11 @@ class SessionManager {
     const sessionPath = await this.getCurrentSession(projectId)
     const filePath = path.join(sessionPath, sessionFilename)
 
-    await fs.writeFile(filePath, content, 'utf-8')
+    await fileHelper.writeFile(filePath, content)
 
     await this._updateSessionMetadata(sessionPath, {
       migrated: true,
-      migratedAt: new Date().toISOString(),
+      migratedAt: dateHelper.getTimestamp(),
     })
 
     return {
@@ -333,14 +312,11 @@ class SessionManager {
       return this.sessionMetadataCache.get(sessionPath)
     }
 
-    try {
-      const content = await fs.readFile(metadataPath, 'utf-8')
-      const metadata = JSON.parse(content)
+    const metadata = await fileHelper.readJson(metadataPath, null)
+    if (metadata) {
       this.sessionMetadataCache.set(sessionPath, metadata)
-      return metadata
-    } catch {
-      return null
     }
+    return metadata
   }
 
   /**
@@ -350,18 +326,16 @@ class SessionManager {
   async _ensureSessionMetadata(sessionPath) {
     const metadataPath = path.join(sessionPath, 'session-meta.json')
 
-    try {
-      await fs.access(metadataPath)
-    } catch {
-      // Create initial metadata
+    const exists = await fileHelper.fileExists(metadataPath)
+    if (!exists) {
       const metadata = {
-        created: new Date().toISOString(),
-        lastActivity: new Date().toISOString(),
+        created: dateHelper.getTimestamp(),
+        lastActivity: dateHelper.getTimestamp(),
         entryCount: 0,
         shipCount: 0,
         version: VERSION,
       }
-      await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8')
+      await fileHelper.writeJson(metadataPath, metadata)
       this.sessionMetadataCache.set(sessionPath, metadata)
     }
   }
@@ -371,52 +345,21 @@ class SessionManager {
    * @private
    */
   async _updateSessionMetadata(sessionPath, updates) {
-    const metadata = await this._getSessionMetadata(sessionPath) || {}
+    const metadata = (await this._getSessionMetadata(sessionPath)) || {}
     Object.assign(metadata, updates)
 
     const metadataPath = path.join(sessionPath, 'session-meta.json')
-    await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8')
+    await fileHelper.writeJson(metadataPath, metadata)
 
     this.sessionMetadataCache.set(sessionPath, metadata)
   }
 
-  /**
-   * Parse JSONL content
-   * @private
-   */
-  _parseJsonLines(content) {
-    const lines = content.split('\n').filter(line => line.trim())
-    const entries = []
-
-    for (const line of lines) {
-      try {
-        entries.push(JSON.parse(line))
-      } catch {
-      }
-    }
-
-    return entries
-  }
-
-  /**
-   * Get line count from file
-   * @private
-   */
-  async _getFileLineCount(filePath) {
-    try {
-      const content = await fs.readFile(filePath, 'utf-8')
-      return content.split('\n').filter(line => line.trim()).length
-    } catch {
-      return 0
-    }
-  }
-
   /**
    * Get today's date key (YYYY-MM-DD)
    * @private
    */
   _getTodayKey() {
-    return this._getDateKey(new Date())
+    return dateHelper.getTodayKey()
   }
 
   /**
@@ -424,10 +367,7 @@ class SessionManager {
    * @private
    */
   _getDateKey(date) {
-    const year = date.getFullYear()
-    const month = (date.getMonth() + 1).toString().padStart(2, '0')
-    const day = date.getDate().toString().padStart(2, '0')
-    return `${year}-${month}-${day}`
+    return dateHelper.getDateKey(date)
   }
 
   clearCache() {