prjct-cli 0.45.0 → 0.45.3

package/core/domain/analyzer.ts

@@ -10,10 +10,10 @@
  * @version 0.6.0 - Fully agentic refactor
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import { promisify } from 'util'
-import { exec as execCallback } from 'child_process'
+import { exec as execCallback } from 'node:child_process'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { promisify } from 'node:util'
 import { isNotFoundError } from '../types/fs'
 
 const exec = promisify(execCallback)
@@ -209,11 +209,11 @@ class CodebaseAnalyzer {
         .forEach((line) => {
           const match = line.trim().match(/^\s*(\d+)\s+(\.\w+)$/)
           if (match) {
-            extensions[match[2]] = parseInt(match[1])
+            extensions[match[2]] = parseInt(match[1], 10)
           }
         })
       return extensions
-    } catch (error) {
+    } catch (_error) {
       // exec errors (find command not available, etc.) - return empty
       return {}
     }
@@ -278,7 +278,7 @@ class CodebaseAnalyzer {
         cwd: this.projectPath!,
       })
       return stdout
-    } catch (error) {
+    } catch (_error) {
       // Git errors (not a repo, git not installed) - return empty
       return ''
     }
@@ -297,16 +297,19 @@ class CodebaseAnalyzer {
         cwd: this.projectPath!,
       })
 
-      const { stdout: firstCommit } = await exec('git log --reverse --pretty=format:"%ar" | head -1', {
-        cwd: this.projectPath!,
-      })
+      const { stdout: firstCommit } = await exec(
+        'git log --reverse --pretty=format:"%ar" | head -1',
+        {
+          cwd: this.projectPath!,
+        }
+      )
 
       return {
-        totalCommits: parseInt(totalCommits.trim()) || 0,
-        contributors: parseInt(contributors.trim()) || 0,
+        totalCommits: parseInt(totalCommits.trim(), 10) || 0,
+        contributors: parseInt(contributors.trim(), 10) || 0,
         age: firstCommit.trim() || 'unknown',
       }
-    } catch (error) {
+    } catch (_error) {
       // Git errors (not a repo, git not installed) - return defaults
       return {
         totalCommits: 0,
@@ -325,8 +328,8 @@ class CodebaseAnalyzer {
         'find . -type f ! -path "*/node_modules/*" ! -path "*/.git/*" ! -path "*/dist/*" | wc -l',
         { cwd: this.projectPath! }
       )
-      return parseInt(stdout.trim()) || 0
-    } catch (error) {
+      return parseInt(stdout.trim(), 10) || 0
+    } catch (_error) {
       // exec errors (find command not available, etc.) - return 0
       return 0
     }
@@ -372,7 +375,7 @@ class CodebaseAnalyzer {
         { cwd: this.projectPath! }
       )
       return stdout.trim().split('\n').filter(Boolean)
-    } catch (error) {
+    } catch (_error) {
       // exec errors (find command not available, etc.) - return empty
       return []
     }

package/core/domain/architecture-generator.ts

@@ -4,8 +4,8 @@
  * This file only provides structure - real content from Claude
  */
 
-import path from 'path'
-import fs from 'fs/promises'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 
 interface ArchitectureContext {
   [key: string]: unknown
@@ -40,7 +40,10 @@ class ArchitectureGenerator {
    * Generate architecture skeleton
    * AGENTIC: Claude fills in content using templates
    */
-  async generateArchitecture(idea: string, context: ArchitectureContext = {}): Promise<Architecture> {
+  async generateArchitecture(
+    idea: string,
+    _context: ArchitectureContext = {}
+  ): Promise<Architecture> {
     // Return skeleton - Claude generates actual content via templates
     return {
       id: `arch-${Date.now()}`,

package/core/domain/context-estimator.ts

@@ -7,7 +7,6 @@
  * @version 1.0.0
  */
 
-import path from 'path'
 import { glob } from 'glob'
 import log from '../utils/logger'
 
@@ -79,7 +78,7 @@ class ContextEstimator {
    * 100% AGENTIC: Uses REAL project data, not hardcoded patterns.
    * No domain-specific assumptions or language→extension mapping.
    */
-  getPatternsForDomain(domain: string, projectData: ProjectTech): FilePatterns {
+  getPatternsForDomain(_domain: string, projectData: ProjectTech): FilePatterns {
     const patterns: FilePatterns = {
       include: [],
       extensions: [],
@@ -87,7 +86,7 @@ class ContextEstimator {
     }
 
     // Use REAL extensions from project (if provided in projectData)
-    if (projectData && projectData.extensions) {
+    if (projectData?.extensions) {
       // projectData.extensions is {'.js': 45, '.ts': 23, ...}
       patterns.extensions = Object.keys(projectData.extensions)
         .filter((ext) => ext.startsWith('.'))
@@ -95,7 +94,7 @@ class ContextEstimator {
     }
 
     // Use REAL directories from project (if provided in projectData)
-    if (projectData && projectData.directories) {
+    if (projectData?.directories) {
       patterns.include = projectData.directories.filter((dir) => !patterns.exclude.includes(dir))
     }
 

package/core/domain/snapshot-manager.ts

@@ -9,13 +9,13 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import { exec } from 'child_process'
-import { promisify } from 'util'
-import pathManager from '../infrastructure/path-manager'
-import configManager from '../infrastructure/config-manager'
+import { exec } from 'node:child_process'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { promisify } from 'node:util'
 import { emit } from '../bus'
+import configManager from '../infrastructure/config-manager'
+import pathManager from '../infrastructure/path-manager'
 import { isNotFoundError } from '../types/fs'
 
 const execAsync = promisify(exec)
@@ -100,7 +100,9 @@ class SnapshotManager {
     await execAsync(`git config user.name "prjct-snapshots"`, { cwd: this.snapshotDir! })
 
     // Create initial empty commit
-    await execAsync(`git commit --allow-empty -m "init: snapshot system"`, { cwd: this.snapshotDir! })
+    await execAsync(`git commit --allow-empty -m "init: snapshot system"`, {
+      cwd: this.snapshotDir!,
+    })
   }
 
   /**
@@ -236,9 +238,12 @@ class SnapshotManager {
     if (!this.initialized) await this.initialize()
 
     // Get files changed in that commit
-    const { stdout: filesOutput } = await execAsync(`git diff-tree --no-commit-id --name-only -r ${hash}`, {
-      cwd: this.snapshotDir!,
-    })
+    const { stdout: filesOutput } = await execAsync(
+      `git diff-tree --no-commit-id --name-only -r ${hash}`,
+      {
+        cwd: this.snapshotDir!,
+      }
+    )
 
     const files = filesOutput.split('\n').filter(Boolean)
 
@@ -337,11 +342,10 @@ class SnapshotManager {
    */
   async logSnapshot(snapshot: SnapshotInfo): Promise<void> {
     const manifestPath = path.join(this.snapshotDir!, 'manifest.jsonl')
-    const entry =
-      JSON.stringify({
-        type: 'snapshot',
-        ...snapshot,
-      }) + '\n'
+    const entry = `${JSON.stringify({
+      type: 'snapshot',
+      ...snapshot,
+    })}\n`
 
     await fs.appendFile(manifestPath, entry)
   }
@@ -351,13 +355,12 @@ class SnapshotManager {
    */
   async logRestore(hash: string, files: string[]): Promise<void> {
     const manifestPath = path.join(this.snapshotDir!, 'manifest.jsonl')
-    const entry =
-      JSON.stringify({
-        type: 'restore',
-        hash,
-        files,
-        timestamp: new Date().toISOString(),
-      }) + '\n'
+    const entry = `${JSON.stringify({
+      type: 'restore',
+      hash,
+      files,
+      timestamp: new Date().toISOString(),
+    })}\n`
 
     await fs.appendFile(manifestPath, entry)
   }

package/core/domain/task-stack.ts

@@ -3,23 +3,22 @@
  * Manages task breakdown and hierarchical task tracking.
  */
 
-import path from 'path'
-import fs from 'fs/promises'
-import { exec } from 'child_process'
-import { promisify } from 'util'
-import log from '../utils/logger'
-import { isNotFoundError } from '../types/fs'
+import { exec } from 'node:child_process'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { promisify } from 'node:util'
 import type {
-  TaskStackEntry,
   ParsedNowFile,
+  TaskStackEntry,
   TaskStackMigrationResult,
-  TaskSwitchResult,
   TaskStackSummary,
+  TaskSwitchResult,
 } from '../types'
+import { isNotFoundError } from '../types/fs'
+import log from '../utils/logger'
 
 const execAsync = promisify(exec)
 
-
 // =============================================================================
 // Parser
 // =============================================================================
@@ -129,7 +128,7 @@ export async function ensureStackFile(stackPath: string): Promise<void> {
  */
 export async function appendToStack(stackPath: string, entry: TaskStackEntry): Promise<void> {
   await ensureStackFile(stackPath)
-  const line = JSON.stringify(entry) + '\n'
+  const line = `${JSON.stringify(entry)}\n`
   await fs.appendFile(stackPath, line)
 }
 
@@ -162,14 +161,18 @@ export async function readStack(stackPath: string): Promise<TaskStackEntry[]> {
  * Write full stack to file
  */
 export async function writeStack(stackPath: string, stack: TaskStackEntry[]): Promise<void> {
-  const content = stack.map((task) => JSON.stringify(task)).join('\n') + '\n'
+  const content = `${stack.map((task) => JSON.stringify(task)).join('\n')}\n`
   await fs.writeFile(stackPath, content)
 }
 
 /**
  * Generate now.md content for a task
  */
-export function generateNowContent(task: TaskStackEntry | null, customContent: string | null, formatDurationFn: (ms: number) => string): string {
+export function generateNowContent(
+  task: TaskStackEntry | null,
+  customContent: string | null,
+  formatDurationFn: (ms: number) => string
+): string {
   if (customContent !== undefined && customContent !== null) {
     return customContent
   }
@@ -340,7 +343,11 @@ export class TaskStack {
   /**
    * Start a new task
    */
-  async startTask(description: string, agent: string = 'general', complexity: string = 'moderate'): Promise<TaskStackEntry> {
+  async startTask(
+    description: string,
+    agent: string = 'general',
+    complexity: string = 'moderate'
+  ): Promise<TaskStackEntry> {
     // Check if there's already an active task
     const active = await this.getActiveTask()
     if (active) {
@@ -524,7 +531,10 @@ export class TaskStack {
   /**
    * Update now.md to reflect current state
    */
-  async updateNowFile(task: TaskStackEntry | null, customContent: string | null = null): Promise<void> {
+  async updateNowFile(
+    task: TaskStackEntry | null,
+    customContent: string | null = null
+  ): Promise<void> {
     await updateNowFile(this.nowPath, task, customContent, formatDuration)
   }
 

package/core/errors.ts

@@ -13,7 +13,7 @@
  * @version 2.0.0
  */
 
-import { z, type ZodType } from 'zod'
+import { type ZodType, z } from 'zod'
 
 // =============================================================================
 // Named Error Pattern (Zod-based)

package/core/events/events.ts

@@ -6,10 +6,9 @@
  */
 
 import pathManager from '../infrastructure/path-manager'
-import * as fileHelper from '../utils/file-helper'
+import type { SyncEvent, SyncEventType } from '../types'
 import { getTimestamp } from '../utils/date-helper'
-
-import type { SyncEventType, SyncEvent } from '../types'
+import * as fileHelper from '../utils/file-helper'
 
 /**
  * Infer event type from path and action
@@ -84,4 +83,3 @@ class EventBus {
 
 export const eventBus = new EventBus()
 export default eventBus
-

package/core/events/index.ts

@@ -4,6 +4,5 @@
  * Barrel export for events module
  */
 
-export { eventBus, inferEventType } from './events'
-export { default } from './events'
 export type { SyncEvent, SyncEventType } from '../types'
+export { default, eventBus, inferEventType } from './events'

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,10 +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,
-        }),
+        stats: () =>
+          commands.stats(process.cwd(), {
+            json: options.json === true,
+            export: options.export === true,
+          }),
         help: (p) => commands.help(p || ''),
         // Maintenance
         recover: () => commands.recover(),
@@ -122,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),
@@ -139,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) {
@@ -160,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> = {}
 
@@ -235,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 {
@@ -293,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
 --------
@@ -307,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)