prjct-cli 0.7.2 → 0.8.0

package/core/__tests__/setup.test.js

@@ -0,0 +1,15 @@
+import { describe, it, expect } from 'vitest'
+
+describe('Vitest Setup', () => {
+  it('should pass basic assertion', () => {
+    expect(true).toBe(true)
+  })
+
+  it('should handle numbers', () => {
+    expect(2 + 2).toBe(4)
+  })
+
+  it('should handle strings', () => {
+    expect('prjct-cli').toContain('prjct')
+  })
+})

package/core/__tests__/utils/date-helper.test.js

@@ -0,0 +1,169 @@
+import { describe, it, expect } from 'vitest'
+import * as dateHelper from '../../utils/date-helper.js'
+
+describe('Date Helper', () => {
+  describe('formatDate()', () => {
+    it('should format date to YYYY-MM-DD', () => {
+      const date = new Date(2025, 9, 4, 12, 0, 0) // October 4, 2025
+      const formatted = dateHelper.formatDate(date)
+
+      expect(formatted).toMatch(/^\d{4}-\d{2}-\d{2}$/)
+    })
+
+    it('should pad single digit month', () => {
+      const date = new Date(2025, 2, 15) // March 15, 2025
+      const formatted = dateHelper.formatDate(date)
+
+      expect(formatted).toContain('-03-')
+    })
+
+    it('should pad single digit day', () => {
+      const date = new Date(2025, 9, 5) // October 5, 2025
+      const formatted = dateHelper.formatDate(date)
+
+      expect(formatted).toContain('-05')
+    })
+
+    it('should handle edge case dates', () => {
+      const date = new Date(2025, 0, 1) // January 1, 2025
+      const formatted = dateHelper.formatDate(date)
+
+      expect(formatted).toBe('2025-01-01')
+    })
+
+    it('should handle end of year', () => {
+      const date = new Date(2025, 11, 31) // December 31, 2025
+      const formatted = dateHelper.formatDate(date)
+
+      expect(formatted).toBe('2025-12-31')
+    })
+  })
+
+  describe('formatMonth()', () => {
+    it('should format date to YYYY-MM', () => {
+      const date = new Date('2025-10-04')
+      const formatted = dateHelper.formatMonth(date)
+
+      expect(formatted).toMatch(/^\d{4}-\d{2}$/)
+      expect(formatted).toBe('2025-10')
+    })
+
+    it('should pad single digit month', () => {
+      const date = new Date('2025-03-15')
+      const formatted = dateHelper.formatMonth(date)
+
+      expect(formatted).toBe('2025-03')
+    })
+
+    it('should handle January', () => {
+      const date = new Date('2025-01-15')
+      const formatted = dateHelper.formatMonth(date)
+
+      expect(formatted).toBe('2025-01')
+    })
+
+    it('should handle December', () => {
+      const date = new Date('2025-12-25')
+      const formatted = dateHelper.formatMonth(date)
+
+      expect(formatted).toBe('2025-12')
+    })
+  })
+
+  describe('getTodayKey()', () => {
+    it('should return today in YYYY-MM-DD format', () => {
+      const today = dateHelper.getTodayKey()
+
+      expect(today).toMatch(/^\d{4}-\d{2}-\d{2}$/)
+    })
+
+    it('should match formatDate for current date', () => {
+      const today = dateHelper.getTodayKey()
+      const now = dateHelper.formatDate(new Date())
+
+      expect(today).toBe(now)
+    })
+  })
+
+  describe('getDateKey()', () => {
+    it('should return date key in YYYY-MM-DD format', () => {
+      const date = new Date(2025, 9, 4) // October 4, 2025
+      const key = dateHelper.getDateKey(date)
+
+      expect(key).toBe('2025-10-04')
+    })
+
+    it('should be alias for formatDate', () => {
+      const date = new Date(2025, 9, 4) // October 4, 2025
+
+      expect(dateHelper.getDateKey(date)).toBe(dateHelper.formatDate(date))
+    })
+  })
+
+  describe('getTimestamp()', () => {
+    it('should return ISO timestamp', () => {
+      const timestamp = dateHelper.getTimestamp()
+
+      expect(timestamp).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)
+    })
+
+    it('should be valid date string', () => {
+      const timestamp = dateHelper.getTimestamp()
+      const date = new Date(timestamp)
+
+      expect(date.toString()).not.toBe('Invalid Date')
+    })
+  })
+
+  describe('calculateDuration()', () => {
+    it('should calculate duration in minutes', () => {
+      const start = new Date('2025-10-04T10:00:00Z')
+      const end = new Date('2025-10-04T10:30:00Z')
+      const duration = dateHelper.calculateDuration(start, end)
+
+      expect(duration).toContain('30m')
+    })
+
+    it('should calculate duration in hours and minutes', () => {
+      const start = new Date('2025-10-04T10:00:00Z')
+      const end = new Date('2025-10-04T12:30:00Z')
+      const duration = dateHelper.calculateDuration(start, end)
+
+      expect(duration).toContain('2h')
+      expect(duration).toContain('30m')
+    })
+
+    it('should handle exact hours', () => {
+      const start = new Date('2025-10-04T10:00:00Z')
+      const end = new Date('2025-10-04T13:00:00Z')
+      const duration = dateHelper.calculateDuration(start, end)
+
+      expect(duration).toContain('3h')
+    })
+
+    it('should handle less than 1 minute', () => {
+      const start = new Date('2025-10-04T10:00:00Z')
+      const end = new Date('2025-10-04T10:00:30Z')
+      const duration = dateHelper.calculateDuration(start, end)
+
+      expect(duration).toContain('30s')
+    })
+  })
+
+  describe('Edge Cases', () => {
+    it('should handle leap year', () => {
+      const date = new Date(2024, 1, 29) // February 29, 2024
+      const formatted = dateHelper.formatDate(date)
+
+      expect(formatted).toBe('2024-02-29')
+    })
+
+    it('should handle different years', () => {
+      const date2024 = new Date(2024, 9, 4) // October 4, 2024
+      const date2025 = new Date(2025, 9, 4) // October 4, 2025
+
+      expect(dateHelper.formatDate(date2024)).toBe('2024-10-04')
+      expect(dateHelper.formatDate(date2025)).toBe('2025-10-04')
+    })
+  })
+})

package/core/__tests__/utils/file-helper.test.js

@@ -0,0 +1,258 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import * as fileHelper from '../../utils/file-helper.js'
+import fs from 'fs/promises'
+import path from 'path'
+import os from 'os'
+
+describe('File Helper', () => {
+  const testDir = path.join(os.tmpdir(), 'prjct-file-helper-test-' + Date.now())
+
+  beforeEach(async () => {
+    await fs.mkdir(testDir, { recursive: true })
+  })
+
+  afterEach(async () => {
+    try {
+      await fs.rm(testDir, { recursive: true, force: true })
+    } catch (error) {
+      // Ignore cleanup errors
+    }
+  })
+
+  describe('readJson()', () => {
+    it('should read and parse JSON file', async () => {
+      const testFile = path.join(testDir, 'test.json')
+      const data = { name: 'test', value: 123 }
+      await fs.writeFile(testFile, JSON.stringify(data))
+
+      const result = await fileHelper.readJson(testFile)
+
+      expect(result).toEqual(data)
+    })
+
+    it('should return default value for non-existent file', async () => {
+      const result = await fileHelper.readJson('/nonexistent/file.json', { default: true })
+
+      expect(result).toEqual({ default: true })
+    })
+
+    it('should return null by default for non-existent file', async () => {
+      const result = await fileHelper.readJson('/nonexistent/file.json')
+
+      expect(result).toBeNull()
+    })
+
+    it('should handle complex JSON structures', async () => {
+      const testFile = path.join(testDir, 'complex.json')
+      const data = {
+        nested: {
+          array: [1, 2, 3],
+          object: { key: 'value' },
+        },
+        boolean: true,
+        number: 42,
+      }
+      await fs.writeFile(testFile, JSON.stringify(data))
+
+      const result = await fileHelper.readJson(testFile)
+
+      expect(result).toEqual(data)
+    })
+  })
+
+  describe('writeJson()', () => {
+    it('should write JSON file with pretty formatting', async () => {
+      const testFile = path.join(testDir, 'write.json')
+      const data = { name: 'test', value: 123 }
+
+      await fileHelper.writeJson(testFile, data)
+
+      const content = await fs.readFile(testFile, 'utf-8')
+      expect(JSON.parse(content)).toEqual(data)
+      expect(content).toContain('\n') // Should be pretty-printed
+    })
+
+    it('should use custom indentation', async () => {
+      const testFile = path.join(testDir, 'indent.json')
+      const data = { key: 'value' }
+
+      await fileHelper.writeJson(testFile, data, 4)
+
+      const content = await fs.readFile(testFile, 'utf-8')
+      expect(content).toContain('    ') // 4 spaces
+    })
+
+    it('should handle nested objects', async () => {
+      const testFile = path.join(testDir, 'nested.json')
+      const data = {
+        level1: {
+          level2: {
+            level3: 'deep',
+          },
+        },
+      }
+
+      await fileHelper.writeJson(testFile, data)
+
+      const result = await fileHelper.readJson(testFile)
+      expect(result).toEqual(data)
+    })
+  })
+
+  describe('readFile()', () => {
+    it('should read text file', async () => {
+      const testFile = path.join(testDir, 'text.txt')
+      const content = 'Hello, World!'
+      await fs.writeFile(testFile, content)
+
+      const result = await fileHelper.readFile(testFile)
+
+      expect(result).toBe(content)
+    })
+
+    it('should return default value for non-existent file', async () => {
+      const result = await fileHelper.readFile('/nonexistent/file.txt', 'default content')
+
+      expect(result).toBe('default content')
+    })
+
+    it('should return empty string by default', async () => {
+      const result = await fileHelper.readFile('/nonexistent/file.txt')
+
+      expect(result).toBe('')
+    })
+
+    it('should handle multi-line content', async () => {
+      const testFile = path.join(testDir, 'multiline.txt')
+      const content = 'Line 1\nLine 2\nLine 3'
+      await fs.writeFile(testFile, content)
+
+      const result = await fileHelper.readFile(testFile)
+
+      expect(result).toBe(content)
+    })
+  })
+
+  describe('writeFile()', () => {
+    it('should write text file', async () => {
+      const testFile = path.join(testDir, 'write.txt')
+      const content = 'Test content'
+
+      await fileHelper.writeFile(testFile, content)
+
+      const result = await fs.readFile(testFile, 'utf-8')
+      expect(result).toBe(content)
+    })
+
+    it('should overwrite existing file', async () => {
+      const testFile = path.join(testDir, 'overwrite.txt')
+
+      await fileHelper.writeFile(testFile, 'First')
+      await fileHelper.writeFile(testFile, 'Second')
+
+      const result = await fs.readFile(testFile, 'utf-8')
+      expect(result).toBe('Second')
+    })
+
+    it('should create directory if needed', async () => {
+      const nestedFile = path.join(testDir, 'nested', 'dir', 'file.txt')
+
+      await fileHelper.writeFile(nestedFile, 'content')
+
+      const exists = await fs
+        .access(nestedFile)
+        .then(() => true)
+        .catch(() => false)
+      expect(exists).toBe(true)
+    })
+  })
+
+  describe('fileExists()', () => {
+    it('should return true for existing file', async () => {
+      const testFile = path.join(testDir, 'exists.txt')
+      await fs.writeFile(testFile, 'content')
+
+      const exists = await fileHelper.fileExists(testFile)
+
+      expect(exists).toBe(true)
+    })
+
+    it('should return false for non-existent file', async () => {
+      const exists = await fileHelper.fileExists('/nonexistent/file.txt')
+
+      expect(exists).toBe(false)
+    })
+
+    it('should work with directories', async () => {
+      const exists = await fileHelper.fileExists(testDir)
+
+      expect(exists).toBe(true)
+    })
+  })
+
+  describe('ensureDir()', () => {
+    it('should create directory if not exists', async () => {
+      const newDir = path.join(testDir, 'new', 'nested', 'dir')
+
+      await fileHelper.ensureDir(newDir)
+
+      const exists = await fs
+        .access(newDir)
+        .then(() => true)
+        .catch(() => false)
+      expect(exists).toBe(true)
+    })
+
+    it('should not fail if directory exists', async () => {
+      await fileHelper.ensureDir(testDir)
+
+      // Should not throw
+      await expect(fileHelper.ensureDir(testDir)).resolves.not.toThrow()
+    })
+  })
+
+  describe('Integration', () => {
+    it('should read and write JSON files', async () => {
+      const testFile = path.join(testDir, 'integration.json')
+      const data = { test: 'data', number: 42 }
+
+      await fileHelper.writeJson(testFile, data)
+      const result = await fileHelper.readJson(testFile)
+
+      expect(result).toEqual(data)
+    })
+
+    it('should handle file operations pipeline', async () => {
+      const testFile = path.join(testDir, 'pipeline.txt')
+
+      // Write
+      await fileHelper.writeFile(testFile, 'original')
+
+      // Check exists
+      const exists = await fileHelper.fileExists(testFile)
+      expect(exists).toBe(true)
+
+      // Read
+      const content = await fileHelper.readFile(testFile)
+      expect(content).toBe('original')
+
+      // Update
+      await fileHelper.writeFile(testFile, 'updated')
+
+      // Read again
+      const updated = await fileHelper.readFile(testFile)
+      expect(updated).toBe('updated')
+    })
+
+    it('should create nested structure and write files', async () => {
+      const nestedDir = path.join(testDir, 'level1', 'level2', 'level3')
+      const nestedFile = path.join(nestedDir, 'deep.json')
+
+      await fileHelper.ensureDir(nestedDir)
+      await fileHelper.writeJson(nestedFile, { deep: true })
+
+      const result = await fileHelper.readJson(nestedFile)
+      expect(result).toEqual({ deep: true })
+    })
+  })
+})

package/core/command-registry.js

@@ -8,11 +8,11 @@
  * - CLAUDE.md (AI assistant instructions)
  * - scripts/validate-commands.js (validation)
  *
- * @version 0.6.0 - Simplified workflow with 9 core commands
+ * @version 0.8.0 - Conversational interface with zero memorization
  */
 
 const COMMANDS = [
-  // ===== CORE WORKFLOW COMMANDS (9 essential) =====
+  // ===== CORE WORKFLOW COMMANDS (13 essential) =====
 
   // 1. Initialize
   {
@@ -267,7 +267,55 @@ const COMMANDS = [
     ],
   },
 
-  // 11. Architect Execute
+  // 11. Ask - Intent to Action
+  {
+    name: 'ask',
+    category: 'core',
+    description: 'Conversational intent to action translator',
+    usage: {
+      claude: '/p:ask "what you want to do"',
+      terminal: 'prjct ask "what you want to do"',
+    },
+    params: '<description>',
+    implemented: true,
+    hasTemplate: true,
+    icon: 'MessageCircle',
+    requiresInit: false, // Can work before init to guide setup
+    blockingRules: null,
+    features: [
+      'Natural language understanding',
+      'Recommends command flow',
+      'Educational explanations',
+      'Interactive confirmation',
+      'Works in any language',
+    ],
+  },
+
+  // 12. Suggest - Context-Aware Recommendations
+  {
+    name: 'suggest',
+    category: 'core',
+    description: 'Context-aware next steps suggestions',
+    usage: {
+      claude: '/p:suggest',
+      terminal: 'prjct suggest',
+    },
+    params: null,
+    implemented: true,
+    hasTemplate: true,
+    icon: 'Lightbulb',
+    requiresInit: true,
+    blockingRules: null,
+    features: [
+      'Analyzes project state',
+      'Recommends actions',
+      'Urgency detection',
+      'Momentum tracking',
+      'Personalized suggestions',
+    ],
+  },
+
+  // 13. Architect Execute
   {
     name: 'architect',
     category: 'core',
@@ -446,7 +494,7 @@ const CATEGORIES = {
   core: {
     title: 'Core Workflow',
     icon: 'Zap',
-    description: '9 essential commands for daily development workflow',
+    description: '13 essential commands for daily development workflow',
     order: 1,
   },
   optional: {

package/core/commands.js

@@ -2632,8 +2632,6 @@ Agent: ${agent}
     const skipped = []
 
     for (const projectId of projectIds) {
-      const globalProjectPath = path.join(globalRoot, projectId)
-
       // Read global config to get project path
       const globalConfig = await configManager.readGlobalConfig(projectId)
       if (!globalConfig || !globalConfig.projectPath) {
@@ -2704,7 +2702,6 @@ Agent: ${agent}
       console.log('🏗️  Architect Mode - Code Generation\n')
 
       const globalPath = await this.getGlobalProjectPath(projectPath)
-      const architectSession = require('./domain/architect-session')
 
       // Check if there's a completed plan
       const planPath = path.join(globalPath, 'planning', 'architect-session.md')

package/core/infrastructure/session-manager.js

@@ -1,4 +1,3 @@
-const fs = require('fs').promises
 const path = require('path')
 const pathManager = require('./path-manager')
 const { VERSION } = require('../utils/version')

package/core/utils/file-helper.js

@@ -70,6 +70,8 @@ async function readFile(filePath, defaultValue = '') {
  * @returns {Promise<void>}
  */
 async function writeFile(filePath, content) {
+  const dir = path.dirname(filePath)
+  await fs.mkdir(dir, { recursive: true })
   await fs.writeFile(filePath, content, 'utf-8')
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {
@@ -12,7 +12,9 @@
   },
   "scripts": {
     "install-global": "./scripts/install.sh",
-    "test": "echo 'No tests configured'",
+    "test": "vitest run --workspace=vitest.workspace.js",
+    "test:watch": "vitest --workspace=vitest.workspace.js",
+    "test:coverage": "vitest run --coverage --workspace=vitest.workspace.js",
     "validate": "node scripts/validate-commands.js",
     "lint": "eslint \"**/*.js\" --ignore-pattern \"node_modules/**\" --ignore-pattern \"website/**\"",
     "lint:fix": "eslint \"**/*.js\" --fix --ignore-pattern \"node_modules/**\" --ignore-pattern \"website/**\"",
@@ -43,15 +45,18 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-config-standard": "^17.1.0",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-n": "^16.6.2",
     "eslint-plugin-promise": "^6.6.0",
+    "jsdom": "^27.0.0",
     "prettier": "^3.6.2",
     "prettier-plugin-tailwindcss": "^0.6.14",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
   },
   "repository": {
     "type": "git",