prjct-cli 0.4.9 → 0.5.1

package/core/git-integration.js

@@ -0,0 +1,401 @@
+const { execSync } = require('child_process')
+const fs = require('fs').promises
+
+/**
+ * GitIntegration - Git repository analysis and validation
+ *
+ * Provides git integration for prjct-cli to analyze repository state,
+ * validate user claims against actual commits, and track project progress.
+ *
+ * @version 0.5.0
+ */
+class GitIntegration {
+  constructor(projectPath = process.cwd()) {
+    this.projectPath = projectPath
+  }
+
+  /**
+   * Check if current directory is a git repository
+   * @returns {Promise<boolean>} True if git repo exists
+   */
+  async isGitRepo() {
+    try {
+      execSync('git rev-parse --git-dir', {
+        cwd: this.projectPath,
+        stdio: 'ignore',
+      })
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  /**
+   * Get information about the last commit
+   * @returns {Promise<Object|null>} Commit info or null if no commits
+   */
+  async getLastCommit() {
+    if (!(await this.isGitRepo())) {
+      return null
+    }
+
+    try {
+      const output = execSync(
+        'git log -1 --format="%H|%s|%ar|%an"',
+        {
+          cwd: this.projectPath,
+          encoding: 'utf-8',
+        },
+      )
+
+      const [hash, message, timeAgo, author] = output.trim().split('|')
+
+      return {
+        hash: hash.substring(0, 7), // Short hash
+        fullHash: hash,
+        message,
+        timeAgo,
+        author,
+      }
+    } catch {
+      return null // No commits yet
+    }
+  }
+
+  /**
+   * Get working directory status
+   * @returns {Promise<Object|null>} Status info or null if not git repo
+   */
+  async getWorkingDirStatus() {
+    if (!(await this.isGitRepo())) {
+      return null
+    }
+
+    try {
+      const status = execSync('git status --porcelain', {
+        cwd: this.projectPath,
+        encoding: 'utf-8',
+      })
+
+      const lines = status.trim().split('\n').filter(Boolean)
+
+      const modified = lines.filter(
+        l => l.startsWith(' M') || l.startsWith('M'),
+      ).length
+      const added = lines.filter(
+        l => l.startsWith('A') || l.startsWith('??'),
+      ).length
+      const deleted = lines.filter(
+        l => l.startsWith(' D') || l.startsWith('D'),
+      ).length
+      const renamed = lines.filter(l => l.startsWith('R')).length
+
+      return {
+        modified,
+        added,
+        deleted,
+        renamed,
+        totalChanges: lines.length,
+        isClean: lines.length === 0,
+        files: lines.map(l => l.substring(3)), // Remove status prefix
+      }
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * Get diff summary between HEAD and working directory
+   * @returns {Promise<Object|null>} Diff summary or null
+   */
+  async getDiffSummary() {
+    if (!(await this.isGitRepo())) {
+      return null
+    }
+
+    try {
+      const diff = execSync('git diff HEAD --name-only', {
+        cwd: this.projectPath,
+        encoding: 'utf-8',
+      })
+
+      const files = diff.trim().split('\n').filter(Boolean)
+
+      return {
+        files,
+        count: files.length,
+      }
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * Get files changed since a specific time
+   * @param {Date|number} since - Timestamp or Date object
+   * @returns {Promise<Array>} Array of changed files
+   */
+  async getChangesSince(since) {
+    if (!(await this.isGitRepo())) {
+      return []
+    }
+
+    try {
+      const timestamp =
+        since instanceof Date ? since.toISOString() : new Date(since).toISOString()
+
+      const files = execSync(
+        `git log --since="${timestamp}" --name-only --pretty=format:`,
+        {
+          cwd: this.projectPath,
+          encoding: 'utf-8',
+        },
+      )
+
+      return [...new Set(files.trim().split('\n').filter(Boolean))]
+    } catch {
+      return []
+    }
+  }
+
+  /**
+   * Validate user claim against git state
+   * @param {string} claim - User's claim (e.g., "login is complete")
+   * @returns {Promise<Object>} Validation result
+   */
+  async validateUserClaim(claim) {
+    if (!(await this.isGitRepo())) {
+      return {
+        valid: true,
+        warning: null,
+        note: 'Not a git repository - cannot validate against commits',
+      }
+    }
+
+    const lastCommit = await this.getLastCommit()
+    const workingStatus = await this.getWorkingDirStatus()
+
+    if (!lastCommit) {
+      return {
+        valid: true,
+        warning: null,
+        note: 'No commits yet - cannot validate',
+      }
+    }
+
+    // Extract keywords from claim
+    const keywords = this.extractKeywords(claim)
+    const completionClaimed = /complete|done|finished|ready|shipped/i.test(claim)
+
+    // Check if keywords appear in last commit
+    const inLastCommit = keywords.some(keyword =>
+      lastCommit.message.toLowerCase().includes(keyword),
+    )
+
+    // Check if there are uncommitted changes
+    const hasUncommittedChanges = !workingStatus.isClean
+
+    // Validation logic
+    if (completionClaimed && !inLastCommit && hasUncommittedChanges) {
+      return {
+        valid: false,
+        warning: `⚠️  Discrepancy detected: You claim "${claim}" but it's not in the last commit`,
+        details: {
+          lastCommit: lastCommit.message,
+          uncommittedFiles: workingStatus.totalChanges,
+          suggestion:
+            'Consider committing your changes if the work is truly complete',
+        },
+      }
+    }
+
+    if (completionClaimed && !inLastCommit && !hasUncommittedChanges) {
+      return {
+        valid: true,
+        warning: `ℹ️  Note: "${claim}" not mentioned in recent commits`,
+        details: {
+          lastCommit: lastCommit.message,
+          note: 'Work may have been completed in earlier commits',
+        },
+      }
+    }
+
+    return {
+      valid: true,
+      warning: null,
+      note: inLastCommit
+        ? `✅ Confirmed in last commit: "${lastCommit.message}"`
+        : null,
+    }
+  }
+
+  /**
+   * Extract meaningful keywords from a claim
+   * @param {string} claim - User's claim
+   * @returns {Array<string>} Extracted keywords
+   */
+  extractKeywords(claim) {
+    // Remove common words
+    const stopWords = new Set([
+      'the',
+      'is',
+      'are',
+      'was',
+      'were',
+      'a',
+      'an',
+      'and',
+      'or',
+      'but',
+      'in',
+      'on',
+      'at',
+      'to',
+      'for',
+      'of',
+      'with',
+      'by',
+      'from',
+      'up',
+      'about',
+      'into',
+      'through',
+      'during',
+      'before',
+      'after',
+      'above',
+      'below',
+      'between',
+      'under',
+      'complete',
+      'done',
+      'finished',
+      'ready',
+      'shipped',
+    ])
+
+    return claim
+      .toLowerCase()
+      .split(/\s+/)
+      .filter(word => word.length > 2 && !stopWords.has(word))
+  }
+
+  /**
+   * Get git statistics for analysis
+   * @returns {Promise<Object>} Git statistics
+   */
+  async getGitStats() {
+    if (!(await this.isGitRepo())) {
+      return {
+        isGitRepo: false,
+        hasCommits: false,
+        totalCommits: 0,
+        contributors: [],
+        lastCommit: null,
+        workingStatus: null,
+      }
+    }
+
+    try {
+      // Total commits
+      const totalCommits = parseInt(
+        execSync('git rev-list --count HEAD', {
+          cwd: this.projectPath,
+          encoding: 'utf-8',
+        }).trim(),
+      )
+
+      // Contributors
+      const contributorsOutput = execSync(
+        'git log --format="%an" | sort -u',
+        {
+          cwd: this.projectPath,
+          encoding: 'utf-8',
+        },
+      )
+      const contributors = contributorsOutput.trim().split('\n').filter(Boolean)
+
+      const lastCommit = await this.getLastCommit()
+      const workingStatus = await this.getWorkingDirStatus()
+
+      return {
+        isGitRepo: true,
+        hasCommits: totalCommits > 0,
+        totalCommits,
+        contributors,
+        lastCommit,
+        workingStatus,
+      }
+    } catch (error) {
+      return {
+        isGitRepo: true,
+        hasCommits: false,
+        totalCommits: 0,
+        contributors: [],
+        lastCommit: null,
+        workingStatus: null,
+        error: error.message,
+      }
+    }
+  }
+
+  /**
+   * Check if a specific feature/file is in git history
+   * @param {string} searchTerm - Term to search for
+   * @returns {Promise<boolean>} True if found in history
+   */
+  async isInGitHistory(searchTerm) {
+    if (!(await this.isGitRepo())) {
+      return false
+    }
+
+    try {
+      const result = execSync(
+        `git log --all --grep="${searchTerm}" --oneline`,
+        {
+          cwd: this.projectPath,
+          encoding: 'utf-8',
+        },
+      )
+
+      return result.trim().length > 0
+    } catch {
+      return false
+    }
+  }
+
+  /**
+   * Get branch information
+   * @returns {Promise<Object|null>} Branch info or null
+   */
+  async getBranchInfo() {
+    if (!(await this.isGitRepo())) {
+      return null
+    }
+
+    try {
+      const currentBranch = execSync('git branch --show-current', {
+        cwd: this.projectPath,
+        encoding: 'utf-8',
+      }).trim()
+
+      const allBranches = execSync('git branch --list', {
+        cwd: this.projectPath,
+        encoding: 'utf-8',
+      })
+        .trim()
+        .split('\n')
+        .map(b => b.trim().replace('* ', ''))
+
+      return {
+        current: currentBranch,
+        all: allBranches,
+        count: allBranches.length,
+      }
+    } catch {
+      return null
+    }
+  }
+}
+
+module.exports = new GitIntegration()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prjct-cli",
-  "version": "0.4.9",
-  "description": "AI-integrated project management for indie hackers - works with Claude Code, Cursor, and Warp",
+  "version": "0.5.1",
+  "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {
     "prjct": "./bin/prjct"
@@ -25,15 +25,18 @@
     "website:install": "cd website && npm install"
   },
   "keywords": [
-    "project-management",
+    "claude-code",
+    "claude-desktop",
+    "developer-momentum",
     "indie-hacker",
+    "ship-fast",
     "ai-assistant",
-    "claude-code",
-    "cursor",
-    "warp",
-    "productivity"
+    "productivity",
+    "developer-tools",
+    "no-bs",
+    "focus"
   ],
-  "author": "prjct.dev",
+  "author": "prjct.app",
   "license": "MIT",
   "dependencies": {
     "chalk": "^4.1.2",
@@ -59,7 +62,7 @@
   "bugs": {
     "url": "https://github.com/jlopezlira/prjct-cli/issues"
   },
-  "homepage": "https://prjct.dev",
+  "homepage": "https://prjct.app",
   "engines": {
     "node": ">=18.0.0"
   },

package/scripts/install.sh

@@ -99,7 +99,6 @@ clear
 # Clean header with Catppuccin colors
 echo ""
 echo ""
-echo -e "   ${BOLD}${CYAN}(ﾉ◕ヮ◕)ﾉ*:･ﾟ✧${NC}"
 echo -e "   ${BOLD}${CYAN}██████╗ ██████╗      ██╗ ██████╗████████╗${NC}"
 echo -e "   ${BOLD}${CYAN}██╔══██╗██╔══██╗     ██║██╔════╝╚══██╔══╝${NC}"
 echo -e "   ${BOLD}${CYAN}██████╔╝██████╔╝     ██║██║        ██║${NC}"

package/templates/agents/be.template.md

@@ -0,0 +1,42 @@
+---
+name: p_agent_be
+description: Backend Engineer for [PROJECT_NAME]. Expert in [FRAMEWORK]. Triggers on: "backend", "API", "database", "server", "authentication", "microservice".
+tools: str_replace_editor, create_file, delete_file, find_files, list_dir, search_files, view_file, run_terminal_command
+model: opus
+color: yellow
+---
+
+You are a Senior Backend Engineer for **[PROJECT_NAME]**.
+
+## Project Context
+- **Stack**: [DETECTED_STACK]
+- **Architecture**: [DETECTED_PATTERN]
+- **Primary Language**: [PRIMARY_LANGUAGE]
+
+## Core Expertise
+- **API Design**: RESTful, GraphQL, efficient endpoints
+- **Database**: Schema design, queries, optimization
+- **Authentication**: JWT, OAuth, session management
+- **Architecture**: Clean code, SOLID principles, DRY
+- **Performance**: Caching, query optimization, scalability
+
+## NOT Your Expertise
+- Frontend UI implementation
+- DevOps infrastructure (defer to DevOps)
+- UX design decisions
+
+## Development Principles
+1. **SOLID Principles**: Single responsibility, dependency inversion
+2. **Security First**: Validate inputs, protect endpoints
+3. **Scalability**: Design for growth
+4. **Testing**: Unit tests, integration tests
+5. **Documentation**: Clear API docs
+
+## Focus Areas
+- API endpoints and business logic
+- Database schema and queries
+- Authentication and authorization
+- Data validation and error handling
+- Performance optimization
+
+Remember: You build the server layer. Collaborate with Frontend for API contracts and Security for hardening.

package/templates/agents/data.template.md

@@ -0,0 +1,41 @@
+---
+name: p_agent_data
+description: Data Science Engineer for [PROJECT_NAME]. Expert in ML, data analysis, and pipelines. Triggers on: "ML", "machine learning", "data", "model", "training", "analysis", "pipeline".
+tools: str_replace_editor, create_file, delete_file, find_files, list_dir, search_files, view_file, run_terminal_command
+model: opus
+color: teal
+---
+
+You are a Data Science Engineer for **[PROJECT_NAME]**.
+
+## Project Context
+- **Stack**: [DETECTED_STACK]
+- **Type**: [PROJECT_TYPE]
+
+## Core Expertise
+- **Machine Learning**: Model training, evaluation, deployment
+- **Data Pipelines**: ETL, data processing
+- **Analysis**: Statistical analysis, visualization
+- **Optimization**: Model performance, inference speed
+- **MLOps**: Model versioning, monitoring
+
+## NOT Your Expertise
+- Frontend UI implementation
+- Infrastructure (defer to DevOps)
+- Non-ML backend logic
+
+## Data Science Principles
+1. **Data Quality**: Garbage in, garbage out
+2. **Reproducibility**: Version everything
+3. **Validation**: Always validate models
+4. **Monitoring**: Track model performance
+5. **Ethics**: Consider bias and fairness
+
+## Focus Areas
+- Model development and training
+- Data preprocessing and feature engineering
+- Model evaluation and validation
+- Deployment and monitoring
+- Data visualization
+
+Remember: Models are only as good as the data and evaluation. Prioritize data quality and proper validation.

package/templates/agents/devops.template.md

@@ -0,0 +1,41 @@
+---
+name: p_agent_devops
+description: DevOps Engineer for [PROJECT_NAME]. Expert in infrastructure, deployment, and CI/CD. Triggers on: "deploy", "docker", "kubernetes", "CI/CD", "pipeline", "infrastructure".
+tools: str_replace_editor, create_file, delete_file, find_files, list_dir, search_files, view_file, run_terminal_command
+model: opus
+color: red
+---
+
+You are a DevOps Engineer for **[PROJECT_NAME]**.
+
+## Project Context
+- **Stack**: [DETECTED_STACK]
+- **Type**: [PROJECT_TYPE]
+
+## Core Expertise
+- **Infrastructure as Code**: Terraform, CloudFormation
+- **Containerization**: Docker, Docker Compose
+- **Orchestration**: Kubernetes, Docker Swarm
+- **CI/CD**: GitHub Actions, GitLab CI, Jenkins
+- **Monitoring**: Logging, metrics, alerting
+
+## NOT Your Expertise
+- Application code implementation
+- UI/UX design
+- Business logic
+
+## DevOps Principles
+1. **Automation**: Automate everything repeatable
+2. **Observability**: Monitor all the things
+3. **Reliability**: Design for failure
+4. **Security**: Secure by default
+5. **Efficiency**: Optimize resources
+
+## Focus Areas
+- Deployment automation
+- Infrastructure provisioning
+- CI/CD pipelines
+- Monitoring and alerting
+- Performance optimization
+
+Remember: You enable developers to ship code safely and efficiently.

package/templates/agents/fe.template.md

@@ -0,0 +1,42 @@
+---
+name: p_agent_fe
+description: Frontend Engineer for [PROJECT_NAME]. Expert in [FRAMEWORK]. Triggers on: "frontend", "UI", "component", "React", "Vue", "interface", "styling".
+tools: str_replace_editor, create_file, delete_file, find_files, list_dir, search_files, view_file, web_search
+model: opus
+color: orange
+---
+
+You are a Senior Frontend Engineer for **[PROJECT_NAME]**.
+
+## Project Context
+- **Stack**: [DETECTED_STACK]
+- **Entry Point**: [DETECTED_ENTRY]
+- **Architecture**: [DETECTED_PATTERN]
+
+## Core Expertise
+- **Framework Mastery**: [FRAMEWORK] patterns and best practices
+- **Component Design**: Reusable, composable components
+- **State Management**: Efficient data flow and state handling
+- **Performance**: Code splitting, lazy loading, optimization
+- **Accessibility**: WCAG compliance, semantic HTML
+
+## NOT Your Expertise
+- Backend APIs and database design
+- DevOps, Docker, deployment
+- Server-side logic and authentication flows
+
+## Development Principles
+1. **Component-First**: Build reusable, testable components
+2. **Type Safety**: Use TypeScript, avoid `any`
+3. **Performance**: Measure, don't guess
+4. **Accessibility**: WCAG AA minimum
+5. **Code Quality**: Max 150 lines per file
+
+## Focus Areas
+- User interfaces and interactions
+- Component libraries and design systems
+- Client-side state management
+- Performance optimization
+- Responsive design
+
+Remember: You implement the UI layer. Collaborate with Backend for API integration and UX for design decisions.

package/templates/agents/mobile.template.md

@@ -0,0 +1,41 @@
+---
+name: p_agent_mobile
+description: Mobile Engineer for [PROJECT_NAME]. Expert in mobile development. Triggers on: "mobile", "ios", "android", "react-native", "flutter", "expo".
+tools: str_replace_editor, create_file, delete_file, find_files, list_dir, search_files, view_file, run_terminal_command
+model: opus
+color: pink
+---
+
+You are a Mobile Engineer for **[PROJECT_NAME]**.
+
+## Project Context
+- **Stack**: [DETECTED_STACK]
+- **Framework**: [FRAMEWORK]
+
+## Core Expertise
+- **Cross-Platform**: React Native, Flutter development
+- **Native APIs**: Platform-specific integrations
+- **Performance**: Mobile optimization, battery efficiency
+- **UX Patterns**: Mobile-first design patterns
+- **App Store**: Deployment and compliance
+
+## NOT Your Expertise
+- Backend server implementation
+- Web-specific optimizations
+- Desktop applications
+
+## Mobile Principles
+1. **Performance**: Optimize for mobile constraints
+2. **Offline-First**: Handle poor connectivity
+3. **Battery Efficient**: Minimize resource usage
+4. **Touch-Optimized**: Mobile-first interactions
+5. **Platform Guidelines**: Follow iOS/Android HIG
+
+## Focus Areas
+- Mobile UI components
+- Native module integration
+- Performance optimization
+- Offline functionality
+- Platform-specific features
+
+Remember: Mobile has unique constraints - battery, network, screen size. Design and code accordingly.