prjct-cli 0.44.1 → 0.45.3

package/core/index.ts

@@ -7,12 +7,12 @@
 import { PrjctCommands } from './commands/index'
 import { commandRegistry } from './commands/registry'
 import './commands/register' // Ensure commands are registered
-import out from './utils/output'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
 import type { CommandMeta } from './commands/registry'
-import { detectAllProviders, detectAntigravity, Providers } from './infrastructure/ai-provider'
-import fs from 'fs'
-import path from 'path'
-import os from 'os'
+import { detectAllProviders, detectAntigravity } from './infrastructure/ai-provider'
+import out from './utils/output'
 
 interface ParsedCommandArgs {
   parsedArgs: string[]
@@ -111,6 +111,11 @@ async function main(): Promise<void> {
         ship: (p) => commands.ship(p),
         // Analytics
         dash: (p) => commands.dash(p || 'default'),
+        stats: () =>
+          commands.stats(process.cwd(), {
+            json: options.json === true,
+            export: options.export === true,
+          }),
         help: (p) => commands.help(p || ''),
         // Maintenance
         recover: () => commands.recover(),
@@ -118,9 +123,10 @@ async function main(): Promise<void> {
         redo: () => commands.redo(),
         history: () => commands.history(),
         // Setup
-        sync: () => commands.sync(process.cwd(), {
-          aiTools: options.agents ? String(options.agents).split(',') : undefined,
-        }),
+        sync: () =>
+          commands.sync(process.cwd(), {
+            aiTools: options.agents ? String(options.agents).split(',') : undefined,
+          }),
         start: () => commands.start(),
         // Context (for Claude templates)
         context: (p) => commands.context(p),
@@ -135,13 +141,13 @@ async function main(): Promise<void> {
     }
 
     // 7. Display result
-    if (result && result.message) {
+    if (result?.message) {
       console.log(result.message)
     }
 
     // Show branding footer
     out.end()
-    process.exit(result && result.success ? 0 : 1)
+    process.exit(result?.success ? 0 : 1)
   } catch (error) {
     console.error('Error:', (error as Error).message)
     if (process.env.DEBUG) {
@@ -156,7 +162,7 @@ async function main(): Promise<void> {
 /**
  * Parse command arguments dynamically
  */
-function parseCommandArgs(cmd: CommandMeta, rawArgs: string[]): ParsedCommandArgs {
+function parseCommandArgs(_cmd: CommandMeta, rawArgs: string[]): ParsedCommandArgs {
   const parsedArgs: string[] = []
   const options: Record<string, string | boolean> = {}
 
@@ -231,7 +237,9 @@ ${DIM}Providers:${RESET}`)
   // Antigravity status (global, skills-based)
   const antigravityDetection = detectAntigravity()
   if (antigravityDetection.installed) {
-    const status = antigravityDetection.skillInstalled ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● detected${RESET}`
+    const status = antigravityDetection.skillInstalled
+      ? `${GREEN}✓ ready${RESET}`
+      : `${YELLOW}● detected${RESET}`
     const hint = antigravityDetection.skillInstalled ? '' : ` ${DIM}(run prjct start)${RESET}`
     console.log(`  Antigravity   ${status}${hint}`)
   } else {
@@ -289,6 +297,8 @@ TERMINAL COMMANDS (this CLI)
   prjct init             Initialize project (required for Cursor)
   prjct setup            Reconfigure installations
   prjct sync             Sync project state
+  prjct watch            Auto-sync on file changes (Ctrl+C to stop)
+  prjct doctor           Check system health and dependencies
 
 EXAMPLES
 --------
@@ -303,6 +313,12 @@ EXAMPLES
   > /sync
   > /task "add user authentication"
 
+FLAGS
+-----
+  --quiet, -q            Suppress all output (only errors to stderr)
+  --version, -v          Show version
+  --help, -h             Show this help
+
 MORE INFO
 ---------
   Documentation:  https://prjct.app

package/core/infrastructure/agent-detector.ts

@@ -5,8 +5,8 @@
  * @module infrastructure/agent-detector
  */
 
-import fs from 'fs'
-import path from 'path'
+import fs from 'node:fs'
+import path from 'node:path'
 import type { DetectedAgent } from '../types'
 
 declare const global: typeof globalThis & {
@@ -144,5 +144,5 @@ export default {
   setAgent,
   reset,
   isClaude,
-  isTerminal
+  isTerminal,
 }

package/core/infrastructure/ai-provider.ts

@@ -17,17 +17,17 @@
  * @see https://docs.windsurf.com/windsurf/cascade/memories
  */
 
-import { execSync } from 'child_process'
-import fs from 'fs'
-import path from 'path'
-import os from 'os'
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
 import type {
-  AIProviderName,
   AIProviderConfig,
+  AIProviderName,
+  CursorProjectDetection,
+  ProviderBranding,
   ProviderDetectionResult,
   ProviderSelectionResult,
-  ProviderBranding,
-  CursorProjectDetection,
   WindsurfProjectDetection,
 } from '../types/provider'
 
@@ -110,17 +110,17 @@ export const AntigravityProvider: AIProviderConfig = {
 export const CursorProvider: AIProviderConfig = {
   name: 'cursor',
   displayName: 'Cursor IDE',
-  cliCommand: null,              // Not a CLI - GUI app
-  configDir: null,               // No global config directory
-  contextFile: 'prjct.mdc',      // Uses .mdc format with frontmatter
-  skillsDir: null,               // No skills directory
+  cliCommand: null, // Not a CLI - GUI app
+  configDir: null, // No global config directory
+  contextFile: 'prjct.mdc', // Uses .mdc format with frontmatter
+  skillsDir: null, // No skills directory
   commandsDir: '.cursor/commands',
-  rulesDir: '.cursor/rules',     // Cursor-specific: rules directory
+  rulesDir: '.cursor/rules', // Cursor-specific: rules directory
   commandFormat: 'md',
   settingsFile: null,
   projectSettingsFile: null,
   ignoreFile: '.cursorignore',
-  isProjectLevel: true,          // Config is project-level only
+  isProjectLevel: true, // Config is project-level only
   websiteUrl: 'https://cursor.com',
   docsUrl: 'https://cursor.com/docs',
 }
@@ -140,17 +140,17 @@ export const CursorProvider: AIProviderConfig = {
 export const WindsurfProvider: AIProviderConfig = {
   name: 'windsurf',
   displayName: 'Windsurf IDE',
-  cliCommand: null,                    // Not a CLI - GUI app
-  configDir: null,                     // No global config directory
-  contextFile: 'prjct.md',             // Uses .md format (not .mdc)
-  skillsDir: null,                     // No skills directory
-  commandsDir: '.windsurf/workflows',  // Windsurf uses "workflows" not "commands"
+  cliCommand: null, // Not a CLI - GUI app
+  configDir: null, // No global config directory
+  contextFile: 'prjct.md', // Uses .md format (not .mdc)
+  skillsDir: null, // No skills directory
+  commandsDir: '.windsurf/workflows', // Windsurf uses "workflows" not "commands"
   rulesDir: '.windsurf/rules',
   commandFormat: 'md',
   settingsFile: null,
   projectSettingsFile: null,
   ignoreFile: '.windsurfignore',
-  isProjectLevel: true,                // Config is project-level only
+  isProjectLevel: true, // Config is project-level only
   websiteUrl: 'https://windsurf.com',
   docsUrl: 'https://docs.windsurf.com',
 }
@@ -227,7 +227,10 @@ export function detectProvider(provider: AIProviderName): ProviderDetectionResul
  * Detect all available CLI-based providers
  * Note: Cursor detection is project-level, use detectCursorProject() separately
  */
-export function detectAllProviders(): { claude: ProviderDetectionResult; gemini: ProviderDetectionResult } {
+export function detectAllProviders(): {
+  claude: ProviderDetectionResult
+  gemini: ProviderDetectionResult
+} {
   return {
     claude: detectProvider('claude'),
     gemini: detectProvider('gemini'),

package/core/infrastructure/author-detector.ts

@@ -9,9 +9,9 @@
  * @module infrastructure/author-detector
  */
 
-import { promisify } from 'util'
-import { exec as execCallback } from 'child_process'
-import type { DetectedAuthorInfo, AuthorConfigStatus } from '../types'
+import { exec as execCallback } from 'node:child_process'
+import { promisify } from 'node:util'
+import type { AuthorConfigStatus, DetectedAuthorInfo } from '../types'
 
 const exec = promisify(execCallback)
 
@@ -52,13 +52,13 @@ export async function detect(): Promise<DetectedAuthorInfo> {
   const [github, name, email] = await Promise.all([
     detectGitHubUsername(),
     detectGitName(),
-    detectGitEmail()
+    detectGitEmail(),
   ])
 
   return {
     github,
     email,
-    name: name || github || 'Unknown'
+    name: name || github || 'Unknown',
   }
 }
 
@@ -83,7 +83,7 @@ export async function getConfigStatus(): Promise<AuthorConfigStatus> {
   const [hasGitHub, hasGit, author] = await Promise.all([
     isGitHubCLIAvailable(),
     isGitConfigured(),
-    detect()
+    detect(),
   ])
 
   return {
@@ -91,15 +91,21 @@ export async function getConfigStatus(): Promise<AuthorConfigStatus> {
     hasGit,
     author,
     isComplete: !!(author.github || (author.name !== 'Unknown' && author.email)),
-    recommendations: getRecommendations(hasGitHub, hasGit, author)
+    recommendations: getRecommendations(hasGitHub, hasGit, author),
   }
 }
 
-function getRecommendations(hasGitHub: boolean, hasGit: boolean, author: DetectedAuthorInfo): string[] {
+function getRecommendations(
+  hasGitHub: boolean,
+  hasGit: boolean,
+  author: DetectedAuthorInfo
+): string[] {
   const recommendations: string[] = []
 
   if (!hasGitHub && !author.github) {
-    recommendations.push('Install GitHub CLI (gh) for better collaboration support: https://cli.github.com/')
+    recommendations.push(
+      'Install GitHub CLI (gh) for better collaboration support: https://cli.github.com/'
+    )
   }
 
   if (!hasGit) {
@@ -137,5 +143,5 @@ export default {
   isGitHubCLIAvailable,
   isGitConfigured,
   getConfigStatus,
-  formatAuthor
+  formatAuthor,
 }

package/core/infrastructure/capability-installer.ts

@@ -8,8 +8,8 @@
  * Configuration should be template-driven, not code-driven.
  */
 
-import { exec } from 'child_process'
-import { promisify } from 'util'
+import { exec } from 'node:child_process'
+import { promisify } from 'node:util'
 
 const execAsync = promisify(exec)
 

package/core/infrastructure/claude-agent.ts

@@ -3,7 +3,7 @@
  * Implements prjct commands for Claude Code environment
  */
 
-import fs from 'fs/promises'
+import fs from 'node:fs/promises'
 import { isNotFoundError } from '../types/fs'
 
 declare const global: typeof globalThis & {
@@ -71,7 +71,7 @@ class ClaudeAgent {
    */
   async readFile(filePath: string): Promise<string> {
     try {
-      if (global.mcp && global.mcp.filesystem) {
+      if (global.mcp?.filesystem) {
         return await global.mcp.filesystem.read(filePath)
       }
     } catch (_error) {
@@ -86,7 +86,7 @@ class ClaudeAgent {
    */
   async writeFile(filePath: string, content: string): Promise<void> {
     try {
-      if (global.mcp && global.mcp.filesystem) {
+      if (global.mcp?.filesystem) {
         return await global.mcp.filesystem.write(filePath, content)
       }
     } catch (_error) {
@@ -101,7 +101,7 @@ class ClaudeAgent {
    */
   async listDirectory(dirPath: string): Promise<string[]> {
     try {
-      if (global.mcp && global.mcp.filesystem) {
+      if (global.mcp?.filesystem) {
         return await global.mcp.filesystem.list(dirPath)
       }
     } catch (_error) {
@@ -148,7 +148,7 @@ class ClaudeAgent {
       return '📋 No tasks queued'
     }
 
-    return '📋 Queue:\n' + tasks.map((t, i) => `${i + 1}. ${t}`).join('\n')
+    return `📋 Queue:\n${tasks.map((t, i) => `${i + 1}. ${t}`).join('\n')}`
   }
 
   /**
@@ -161,7 +161,7 @@ class ClaudeAgent {
 🚀 Shipped: ${data.shippedCount}
 📝 Queue: ${data.queuedCount}
 💡 Ideas: ${data.ideasCount}
-${data.recentActivity ? '\n' + data.recentActivity : ''}`
+${data.recentActivity ? `\n${data.recentActivity}` : ''}`
   }
 
   /**

package/core/infrastructure/command-installer.ts

@@ -12,18 +12,18 @@
  * @version 0.6.0 - Multi-provider support
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import os from 'os'
-import { getPackageRoot } from '../utils/version'
-import { isNotFoundError } from '../types/fs'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
 import type {
-  InstallResult,
-  UninstallResult,
   CheckResult,
-  SyncResult,
   GlobalConfigResult,
+  InstallResult,
+  SyncResult,
+  UninstallResult,
 } from '../types'
+import { isNotFoundError } from '../types/fs'
+import { getPackageRoot } from '../utils/version'
 
 // =============================================================================
 // Global Config
@@ -82,13 +82,18 @@ export async function installGlobalConfig(): Promise<GlobalConfigResult> {
     await fs.mkdir(activeProvider.configDir, { recursive: true })
 
     const globalConfigPath = path.join(activeProvider.configDir, activeProvider.contextFile)
-    const templatePath = path.join(getPackageRoot(), 'templates', 'global', activeProvider.contextFile)
+    const templatePath = path.join(
+      getPackageRoot(),
+      'templates',
+      'global',
+      activeProvider.contextFile
+    )
 
     // Read template content
     let templateContent = ''
     try {
       templateContent = await fs.readFile(templatePath, 'utf-8')
-    } catch (error) {
+    } catch (_error) {
       // Fallback if provider-specific template not found
       const fallbackTemplatePath = path.join(getPackageRoot(), 'templates/global/CLAUDE.md')
       templateContent = await fs.readFile(fallbackTemplatePath, 'utf-8')
@@ -133,7 +138,7 @@ export async function installGlobalConfig(): Promise<GlobalConfigResult> {
 
       if (!hasMarkers) {
         // No markers - append prjct section at the end
-        const updatedContent = existingContent + '\n\n' + templateContent
+        const updatedContent = `${existingContent}\n\n${templateContent}`
         await fs.writeFile(globalConfigPath, updatedContent, 'utf-8')
         return {
           success: true,
@@ -183,10 +188,10 @@ export class CommandInstaller {
 
   constructor() {
     this.homeDir = os.homedir()
-    
+
     const aiProvider = require('./ai-provider')
     const activeProvider = aiProvider.getActiveProvider()
-    
+
     // Command paths are provider-specific
     if (activeProvider.name === 'gemini') {
       this.claudeCommandsPath = path.join(activeProvider.configDir, 'commands')
@@ -194,7 +199,7 @@ export class CommandInstaller {
       // Claude: Commands are in p/ subdirectory to avoid cluttering commands/
       this.claudeCommandsPath = path.join(activeProvider.configDir, 'commands', 'p')
     }
-    
+
     this.claudeConfigPath = activeProvider.configDir
     this.templatesDir = path.join(getPackageRoot(), 'templates', 'commands')
   }
@@ -228,7 +233,7 @@ export class CommandInstaller {
     try {
       const files = await fs.readdir(this.templatesDir)
       return files.filter((f) => f.endsWith('.md'))
-    } catch (error) {
+    } catch (_error) {
       // Fallback to core commands if template directory not accessible (ENOENT or other)
       return [
         'init.md',
@@ -332,7 +337,7 @@ export class CommandInstaller {
       // Try to remove the /p directory if empty
       try {
         await fs.rmdir(this.claudeCommandsPath)
-      } catch (error) {
+      } catch (_error) {
         // Directory not empty or doesn't exist - that's fine (ENOTEMPTY or ENOENT)
       }
 
@@ -438,7 +443,7 @@ export class CommandInstaller {
     const aiProvider = require('./ai-provider')
     const activeProvider = aiProvider.getActiveProvider()
     const routerFile = activeProvider.name === 'gemini' ? 'p.toml' : 'p.md'
-    
+
     try {
       const routerSource = path.join(this.templatesDir, routerFile)
       const routerDest = path.join(activeProvider.configDir, 'commands', routerFile)

package/core/infrastructure/config-manager.ts

@@ -10,19 +10,19 @@
  * @version 0.3.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 import * as jsonc from 'jsonc-parser'
-import pathManager from './path-manager'
-import authorDetector from './author-detector'
-import { VERSION } from '../utils/version'
-import { getTimestamp } from '../utils/date-helper'
 import { getErrorMessage } from '../errors'
+import type { Author, GlobalConfig, LocalConfig } from '../types'
 import { isNotFoundError } from '../types/fs'
-import type { Author, LocalConfig, GlobalConfig } from '../types'
+import { getTimestamp } from '../utils/date-helper'
+import { VERSION } from '../utils/version'
+import authorDetector from './author-detector'
+import pathManager from './path-manager'
 
 // Re-export types for convenience
-export type { Author, LocalConfig, GlobalConfig } from '../types'
+export type { Author, GlobalConfig, LocalConfig } from '../types'
 
 /**
  * Parse JSON or JSONC content safely
@@ -36,7 +36,9 @@ function parseJsonc<T>(content: string): T {
   })
   if (errors.length > 0) {
     const firstError = errors[0]
-    throw new SyntaxError(`JSON parse error at offset ${firstError.offset}: ${jsonc.printParseErrorCode(firstError.error)}`)
+    throw new SyntaxError(
+      `JSON parse error at offset ${firstError.offset}: ${jsonc.printParseErrorCode(firstError.error)}`
+    )
   }
   return result
 }
@@ -72,7 +74,7 @@ class ConfigManager {
     await fs.mkdir(configDir, { recursive: true })
 
     const content = JSON.stringify(config, null, 2)
-    await fs.writeFile(configPath, content + '\n', 'utf-8')
+    await fs.writeFile(configPath, `${content}\n`, 'utf-8')
   }
 
   /**
@@ -91,7 +93,9 @@ class ConfigManager {
         return null
       }
       // Log other errors for debugging
-      console.warn(`Warning: Could not read global config for ${projectId}: ${getErrorMessage(error)}`)
+      console.warn(
+        `Warning: Could not read global config for ${projectId}: ${getErrorMessage(error)}`
+      )
       return null
     }
   }
@@ -106,7 +110,7 @@ class ConfigManager {
     await fs.mkdir(configDir, { recursive: true })
 
     const content = JSON.stringify(config, null, 2)
-    await fs.writeFile(configPath, content + '\n', 'utf-8')
+    await fs.writeFile(configPath, `${content}\n`, 'utf-8')
   }
 
   /**
@@ -231,7 +235,7 @@ class ConfigManager {
    */
   async getProjectId(projectPath: string): Promise<string> {
     const config = await this.readConfig(projectPath)
-    if (config && config.projectId) {
+    if (config?.projectId) {
       return config.projectId
     }
     return pathManager.generateProjectId(projectPath)
@@ -300,7 +304,7 @@ class ConfigManager {
     await this.addAuthor(projectId, {
       name: author.name ?? undefined,
       email: author.email ?? undefined,
-      github: author.github ?? undefined
+      github: author.github ?? undefined,
     })
 
     return author.github || author.name || 'Unknown'

package/core/infrastructure/editors-config.ts

@@ -9,9 +9,9 @@
  * @version 0.6.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import os from 'os'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
 import type { AIProviderName } from '../types/provider'
 
 interface EditorConfig {
@@ -65,7 +65,11 @@ class EditorsConfig {
   /**
    * Save installation configuration
    */
-  async saveConfig(version: string, installPath: string, provider: AIProviderName = 'claude'): Promise<boolean> {
+  async saveConfig(
+    version: string,
+    installPath: string,
+    provider: AIProviderName = 'claude'
+  ): Promise<boolean> {
     try {
       await this.ensureConfigDir()
 

package/core/infrastructure/path-manager.ts

@@ -9,13 +9,13 @@
  * @version 0.2.1
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import crypto from 'crypto'
-import os from 'os'
+import crypto from 'node:crypto'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import type { SessionInfo } from '../types'
 import * as dateHelper from '../utils/date-helper'
 import * as fileHelper from '../utils/file-helper'
-import type { SessionInfo } from '../types'
 
 class PathManager {
   globalBaseDir: string
@@ -24,7 +24,9 @@ class PathManager {
 
   constructor() {
     const envOverride = process.env.PRJCT_CLI_HOME?.trim()
-    this.globalBaseDir = envOverride ? path.resolve(envOverride) : path.join(os.homedir(), '.prjct-cli')
+    this.globalBaseDir = envOverride
+      ? path.resolve(envOverride)
+      : path.join(os.homedir(), '.prjct-cli')
     this.globalProjectsDir = path.join(this.globalBaseDir, 'projects')
     this.globalConfigDir = path.join(this.globalBaseDir, 'config')
   }

package/core/infrastructure/permission-manager.ts

@@ -9,9 +9,9 @@
  */
 
 import {
-  type PermissionsConfig,
-  type PermissionLevel,
   buildDefaultPermissions,
+  type PermissionLevel,
+  type PermissionsConfig,
 } from '../schemas/permissions'
 import type { PermissionCheckResult } from '../types'
 
@@ -114,11 +114,12 @@ class PermissionManager {
       allowed: match.level === 'allow',
       level: match.level,
       matchedPattern: match.pattern,
-      reason: match.level === 'deny'
-        ? `Command denied by pattern: ${match.pattern}`
-        : match.level === 'ask'
-          ? `Command requires approval: ${match.pattern}`
-          : undefined,
+      reason:
+        match.level === 'deny'
+          ? `Command denied by pattern: ${match.pattern}`
+          : match.level === 'ask'
+            ? `Command requires approval: ${match.pattern}`
+            : undefined,
     }
   }
 
@@ -145,11 +146,12 @@ class PermissionManager {
       allowed: match.level === 'allow',
       level: match.level,
       matchedPattern: match.pattern,
-      reason: match.level === 'deny'
-        ? `File operation denied: ${operation} on ${match.pattern}`
-        : match.level === 'ask'
-          ? `File operation requires approval: ${operation}`
-          : undefined,
+      reason:
+        match.level === 'deny'
+          ? `File operation denied: ${operation} on ${match.pattern}`
+          : match.level === 'ask'
+            ? `File operation requires approval: ${operation}`
+            : undefined,
     }
   }
 
@@ -239,11 +241,12 @@ class PermissionManager {
     return {
       allowed: level === 'allow',
       level,
-      reason: level === 'deny'
-        ? 'External directory access denied'
-        : level === 'ask'
-          ? 'External directory access requires approval'
-          : undefined,
+      reason:
+        level === 'deny'
+          ? 'External directory access denied'
+          : level === 'ask'
+            ? 'External directory access requires approval'
+            : undefined,
     }
   }