prjct-cli 0.8.6 → 0.8.8

package/core/utils/jsonl-helper.js

@@ -1,4 +1,7 @@
 const fs = require('fs').promises
+const fsSync = require('fs')
+const readline = require('readline')
+const path = require('path')
 
 /**
  * JSONL Helper - Centralized JSONL parsing and writing
@@ -190,6 +193,134 @@ async function isJsonLinesEmpty(filePath) {
   return count === 0
 }
 
+/**
+ * Read JSONL file with streaming (memory-efficient for large files)
+ * Only reads last N lines instead of loading entire file
+ *
+ * @param {string} filePath - Path to JSONL file
+ * @param {number} maxLines - Maximum lines to read (default: 1000)
+ * @returns {Promise<Array<Object>>} - Array of parsed objects (last N lines)
+ */
+async function readJsonLinesStreaming(filePath, maxLines = 1000) {
+  try {
+    const fileStream = fsSync.createReadStream(filePath)
+    const rl = readline.createInterface({
+      input: fileStream,
+      crlfDelay: Infinity,
+    })
+
+    const lines = []
+
+    for await (const line of rl) {
+      if (line.trim()) {
+        try {
+          lines.push(JSON.parse(line))
+        } catch {
+          // Skip malformed lines
+        }
+
+        // Keep only last maxLines
+        if (lines.length > maxLines) {
+          lines.shift()
+        }
+      }
+    }
+
+    return lines
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return []
+    }
+    throw error
+  }
+}
+
+/**
+ * Get file size in MB
+ *
+ * @param {string} filePath - Path to file
+ * @returns {Promise<number>} - File size in MB
+ */
+async function getFileSizeMB(filePath) {
+  try {
+    const stats = await fs.stat(filePath)
+    return stats.size / (1024 * 1024)
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return 0
+    }
+    throw error
+  }
+}
+
+/**
+ * Rotate JSONL file if it exceeds size limit
+ * Moves large file to archive with timestamp
+ *
+ * @param {string} filePath - Path to JSONL file
+ * @param {number} maxSizeMB - Maximum size in MB before rotation (default: 10)
+ * @returns {Promise<boolean>} - True if rotated, false if not needed
+ */
+async function rotateJsonLinesIfNeeded(filePath, maxSizeMB = 10) {
+  const sizeMB = await getFileSizeMB(filePath)
+
+  if (sizeMB < maxSizeMB) {
+    return false // No rotation needed
+  }
+
+  // Generate archive filename with timestamp
+  const timestamp = new Date().toISOString().split('T')[0] // YYYY-MM-DD
+  const dir = path.dirname(filePath)
+  const ext = path.extname(filePath)
+  const base = path.basename(filePath, ext)
+  const archivePath = path.join(dir, `${base}-${timestamp}${ext}`)
+
+  // Move file to archive
+  await fs.rename(filePath, archivePath)
+
+  console.log(`📦 Rotated ${path.basename(filePath)} (${sizeMB.toFixed(1)}MB) → ${path.basename(archivePath)}`)
+
+  return true
+}
+
+/**
+ * Append JSON line with automatic rotation
+ * Checks file size before append and rotates if needed
+ *
+ * @param {string} filePath - Path to JSONL file
+ * @param {Object} object - Object to append
+ * @param {number} maxSizeMB - Maximum size before rotation (default: 10)
+ * @returns {Promise<void>}
+ */
+async function appendJsonLineWithRotation(filePath, object, maxSizeMB = 10) {
+  // Rotate if needed (before appending)
+  await rotateJsonLinesIfNeeded(filePath, maxSizeMB)
+
+  // Append normally
+  await appendJsonLine(filePath, object)
+}
+
+/**
+ * Warn if file is large before reading
+ * Returns size and whether it's considered large
+ *
+ * @param {string} filePath - Path to file
+ * @param {number} warnThresholdMB - Threshold in MB to warn (default: 50)
+ * @returns {Promise<{sizeMB: number, isLarge: boolean}>}
+ */
+async function checkFileSizeWarning(filePath, warnThresholdMB = 50) {
+  const sizeMB = await getFileSizeMB(filePath)
+  const isLarge = sizeMB > warnThresholdMB
+
+  if (isLarge) {
+    console.warn(
+      `⚠️  Large file detected: ${path.basename(filePath)} (${sizeMB.toFixed(1)}MB). Reading may use significant memory.`
+    )
+  }
+
+  return { sizeMB, isLarge }
+}
+
 module.exports = {
   parseJsonLines,
   stringifyJsonLines,
@@ -203,4 +334,10 @@ module.exports = {
   getFirstJsonLines,
   mergeJsonLines,
   isJsonLinesEmpty,
+  // NEW: Memory-efficient functions
+  readJsonLinesStreaming,
+  getFileSizeMB,
+  rotateJsonLinesIfNeeded,
+  appendJsonLineWithRotation,
+  checkFileSizeWarning,
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {

package/scripts/install.sh

@@ -9,22 +9,59 @@
 YELLOW='\033[1;33m'
 CYAN='\033[0;36m'
 GREEN='\033[0;32m'
+RED='\033[0;31m'
+BOLD='\033[1m'
+DIM='\033[2m'
 NC='\033[0m'
 
+# Check if legacy installation exists
+LEGACY_DIR="$HOME/.prjct-cli"
+HAS_LEGACY=false
+LEGACY_VERSION="unknown"
+
+if [ -d "$LEGACY_DIR" ]; then
+  # Check if it's a git clone (legacy curl install)
+  if [ -d "$LEGACY_DIR/.git" ]; then
+    HAS_LEGACY=true
+    if [ -f "$LEGACY_DIR/package.json" ]; then
+      LEGACY_VERSION=$(grep -o '"version":[[:space:]]*"[^"]*"' "$LEGACY_DIR/package.json" | head -1 | cut -d'"' -f4)
+    fi
+  fi
+fi
+
 echo ""
 echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
 echo -e "${YELLOW}⚠️  This installation method is DEPRECATED${NC}"
 echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
 echo ""
-echo -e "Please use npm instead:"
-echo ""
-echo -e "  ${GREEN}npm install -g prjct-cli${NC}"
-echo ""
-echo -e "Benefits of npm installation:"
-echo -e "  • ${CYAN}Automatic setup${NC} - No manual configuration needed"
-echo -e "  • ${CYAN}Auto-migration${NC} - Legacy projects migrated automatically"
-echo -e "  • ${CYAN}Beautiful ASCII art${NC} - See the installation success"
+
+if [ "$HAS_LEGACY" = true ]; then
+  echo -e "${RED}⚠️  Legacy curl installation detected!${NC}"
+  echo ""
+  echo -e "   ${DIM}Version: ${LEGACY_VERSION}${NC}"
+  echo -e "   ${DIM}Location: ~/.prjct-cli/${NC}"
+  echo ""
+  echo -e "${CYAN}Migration Required:${NC}"
+  echo ""
+  echo -e "  1. ${BOLD}Install via npm:${NC}"
+  echo -e "     ${GREEN}npm install -g prjct-cli${NC}"
+  echo ""
+  echo -e "  2. ${BOLD}Automatic cleanup:${NC}"
+  echo -e "     ${DIM}Legacy installation will be cleaned automatically${NC}"
+  echo -e "     ${DIM}Your project data will be preserved${NC}"
+  echo ""
+else
+  echo -e "${CYAN}Please install using npm:${NC}"
+  echo ""
+  echo -e "  ${GREEN}npm install -g prjct-cli${NC}"
+  echo ""
+fi
+
+echo -e "${BOLD}Benefits of npm installation:${NC}"
+echo -e "  • ${CYAN}Automatic cleanup${NC} - Removes old curl installations"
+echo -e "  • ${CYAN}Data preservation${NC} - Your projects are migrated safely"
 echo -e "  • ${CYAN}Easy updates${NC} - Just npm update -g prjct-cli"
+echo -e "  • ${CYAN}Proper versioning${NC} - npm handles everything"
 echo ""
 echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
 echo ""

package/scripts/postinstall.js

@@ -3,13 +3,13 @@
 /**
  * Post-install hook for prjct-cli (OPTIONAL)
  *
- * Intenta ejecutar setup si npm scripts están habilitados.
- * Si falla o no se ejecuta, no hay problema - el setup se ejecutará
- * automáticamente en el primer uso del CLI (como Astro, Vite, etc.)
+ * Attempts to run setup if npm scripts are enabled.
+ * If it fails or doesn't run, no problem - setup will run
+ * automatically on first CLI use (like Astro, Vite, etc.)
  *
- * Este hook es una optimización pero NO es crítico.
+ * This hook is an optimization but NOT critical.
  *
- * @version 0.8.5
+ * @version 0.8.8
  */
 
 const path = require('path')

package/templates/agents/AGENTS.md

@@ -167,13 +167,13 @@ Semantic understanding, not pattern matching.
 
 | Intent     | Command    | Examples                                     |
 | ---------- | ---------- | -------------------------------------------- |
-| Start task | `/p:now`   | "work on X", "starting API", "voy a hacer X" |
-| Finish     | `/p:done`  | "done", "finished", "terminé", "listo"       |
+| Start task | `/p:now`   | "work on X", "starting API", "begin auth"    |
+| Finish     | `/p:done`  | "done", "finished", "completed", "all set"   |
 | Ship       | `/p:ship`  | "ship this", "deploy X", "it's ready"        |
 | Idea       | `/p:idea`  | "I have an idea", "what if we..."            |
 | Progress   | `/p:recap` | "show progress", "how am I doing"            |
 | Stuck      | `/p:stuck` | "I'm stuck", "help with X"                   |
-| Next       | `/p:next`  | "what's next", "qué sigue"                   |
+| Next       | `/p:next`  | "what's next", "show queue", "priority list" |
 
 **Any language works** - if you understand intent, execute the command.
 

package/templates/commands/ask.md

@@ -7,380 +7,67 @@ description: 'Conversational intent to action translator - helps users understan
 
 ## Purpose
 
-Translate natural language intent into actionable prjct command flows. Helps users who know WHAT they want but don't know HOW to do it with prjct.
-
-## Usage
-
-```
-/p:ask "<what you want to do>"
-```
+Translate natural language intent into actionable prjct command flows. Helps users who know WHAT they want but don't know HOW.
 
 ## Flow
 
 1. **Understand intent**: Parse user's natural language description
-2. **Analyze context**: Read project state (core/now.md, core/next.md, planning/roadmap.md)
+2. **Analyze context**: Read project state (`core/now.md`, `core/next.md`, `planning/roadmap.md`)
 3. **Recommend flow**: Suggest specific command sequence with explanations
-4. **Offer templates**: If applicable, show examples from similar use cases
-5. **Ask confirmation**: Interactive - don't execute automatically
+4. **Ask confirmation**: Interactive - don't execute automatically
 
 ## Intent Categories
 
-Claude analyzes and maps to one of these patterns:
-
-### 1. Feature Development
-Keywords: "add", "implement", "create", "build", "agregar", "implementar", "crear"
+**1. Feature Development**: "add", "implement", "create", "build"
+→ `/p:feature "{desc}"` → `/p:done` (iterate) → `/p:ship "{name}"`
 
-**Recommended flow:**
-```
-1. /p:feature "{description}"
-   → Value analysis (impact/effort/timing)
-   → Task breakdown
-   → Auto-start first task
-
-2. /p:done (after each task)
-
-3. /p:ship "{feature name}" (when complete)
-```
+**2. Performance/Optimization**: "optimize", "improve", "faster", "memory leak"
+→ `/p:feature "optimize {area}"` → `/p:build 1` → `/p:done` → `/p:ship "optimization"`
 
-### 2. Performance/Optimization
-Keywords: "optimize", "improve", "faster", "performance", "memory leak", "optimizar", "mejorar"
+**3. Bug Fixing**: "bug", "error", "fix", "broken", "not working"
+→ `/p:bug "{desc}"` → `/p:build "{bug task}"` → `/p:done` → `/p:ship "bug fixes"`
 
-**Recommended flow:**
-```
-1. /p:feature "optimize {area}"
-   → Break down into measurable tasks:
-     • Profile and identify bottlenecks
-     • Implement specific optimizations
-     • Measure improvements
-     • Document findings
-
-2. /p:build 1 (start with profiling)
-
-3. /p:done (iterate through tasks)
-
-4. /p:ship "performance optimization"
-```
-
-### 3. Bug Fixing
-Keywords: "bug", "error", "fix", "broken", "not working", "arreglar", "error"
-
-**Recommended flow:**
-```
-1. /p:bug "{description}"
-   → Auto-prioritized based on severity
-   → Added to queue
+**4. Design/Architecture**: "design", "architecture", "structure", "plan"
+→ `/p:design {target} --type {architecture|api|component|database|flow}` → `/p:feature "implement {design}"` → `/p:build 1`
 
-2. /p:build "{bug task}" (if high priority)
-
-3. /p:done (when fixed)
-
-4. /p:ship "bug fixes" (if part of larger batch)
-```
-
-### 4. Design/Architecture
-Keywords: "design", "architecture", "structure", "plan", "diseñar", "arquitectura"
-
-**Recommended flow:**
-```
-1. /p:design {target} --type {architecture|api|component|database|flow}
-   → Create design document
-   → Plan implementation
-
-2. /p:feature "implement {design}"
-   → Convert design to tasks
-
-3. /p:build 1 (start implementation)
-```
-
-### 5. Lost/Confused
-Keywords: "don't know", "help", "stuck", "what should", "no sé", "ayuda"
-
-**Recommended flow:**
-```
-1. /p:suggest
-   → Context-aware recommendations
-   → Shows current state
-   → Suggests next best action
-
-OR
-
-2. /p:help
-   → Interactive guide
-   → Shows available commands
-   → Examples
-```
+**5. Lost/Confused**: "don't know", "help", "stuck", "what should"
+→ `/p:suggest` (context-aware recommendations) OR `/p:help` (interactive guide)
 
 ## Response Format
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 Entiendo: {interpreted_intent}
+🎯 I understand: {interpreted_intent}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-📊 TU CONTEXTO:
-  • Estado actual: {current_state}
-  • Tareas activas: {active_tasks}
-  • Último ship: {time_ago}
+📊 YOUR CONTEXT:
+  • Current state: {current_state}
+  • Active tasks: {active_tasks}
+  • Last ship: {time_ago}
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-💡 RECOMENDACIÓN DE FLUJO:
+💡 RECOMMENDED FLOW:
 
 {step_by_step_command_flow}
 
-Cada paso explicado:
+Each step explained:
 → {command_1}: {why_this_command}
 → {command_2}: {what_it_does}
 → {command_3}: {expected_outcome}
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-✨ EJEMPLOS SIMILARES:
-
-"{similar_example_1}"
-"{similar_example_2}"
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-¿Quieres que ejecute el paso 1?
-[Sí] [No, solo dame las tareas] [Necesito más ayuda]
-```
-
-## Examples
-
-### Example 1: Performance Optimization
-
-**Input:**
-```
-/p:ask "quiero mejorar el performance y evitar memory leaks"
-```
-
-**Output:**
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 Entiendo: optimización de performance + solución de memory leaks
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📊 TU CONTEXTO:
-  • Estado actual: sin tarea activa
-  • Tareas en cola: 3
-  • Último ship: hace 2 días
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💡 RECOMENDACIÓN DE FLUJO:
-
-1. /p:feature "optimizar performance y memory leaks"
-
-   Claude analizará y creará tareas como:
-   • Setup profiler (Chrome DevTools/React DevTools)
-   • Identificar memory leaks con heap snapshots
-   • Optimizar re-renders innecesarios
-   • Implementar memoization (useMemo, useCallback)
-   • Code splitting para reducir bundle size
-   • Medir mejoras y documentar
-
-2. /p:build 1
-   → Empezar con el profiling (necesitas datos primero)
-
-3. /p:done
-   → Después de cada tarea completada
-
-4. /p:ship "performance optimization"
-   → Cuando hayas terminado todas las mejoras
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-✨ POR QUÉ ESTE FLUJO:
-
-→ /p:feature: Analiza el valor (impacto alto, esfuerzo medio)
-             Recomienda timing (hacer ahora antes de más features)
-             Breakdown inteligente (primero medir, luego optimizar)
-
-→ /p:build:   Asigna agente apropiado (probablemente FE)
-             Tracking de tiempo
-             Focus en una tarea a la vez
-
-→ /p:done:    Registra progreso
-             Mantiene momentum
-             Mueve a siguiente tarea
-
-→ /p:ship:    Commit + push + celebración
-             Actualiza docs
-             Registra el logro
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-¿Empezamos con /p:feature para analizar el valor y crear las tareas?
-```
-
-### Example 2: New Feature
-
-**Input:**
-```
-/p:ask "I want to add user authentication"
+Would you like me to execute step 1?
 ```
 
-**Output:**
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 I understand: implement user authentication system
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📊 YOUR CONTEXT:
-  • Current state: working on "navbar redesign"
-  • Queue: 2 tasks
-  • Last ship: 1 day ago
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-⚠️  IMPORTANTE: Tienes tarea activa
-
-Opciones:
-
-A) TERMINAR PRIMERO (Recomendado)
-   1. /p:done → Terminar "navbar redesign"
-   2. /p:feature "user authentication"
-   3. /p:build 1 → Empezar auth
-
-B) GUARDAR PARA DESPUÉS
-   1. /p:feature "user authentication"
-      → Se agrega a la cola
-   2. Continúa con navbar
-   3. /p:done cuando termines navbar
-   4. /p:build "authentication" cuando estés listo
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💡 RECOMENDACIÓN:
-
-Termina navbar primero (mantiene focus)
-Luego /p:feature "authentication" hará:
-
-• Análisis de valor (impacto: HIGH)
-• Stack analysis (sugiere: Clerk, Auth0, o custom JWT)
-• Task breakdown:
-  - Setup auth provider
-  - Implement login/signup UI
-  - Protected routes
-  - Session management
-  - Testing
-
-• Auto-start primera tarea
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-¿Qué prefieres: A) Terminar navbar primero, o B) Agregar a cola?
-```
-
-### Example 3: Lost/Confused
-
-**Input:**
-```
-/p:ask "no sé qué hacer ahora"
-```
-
-**Output:**
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 Entiendo: necesitas orientación sobre qué hacer
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📊 TU CONTEXTO:
-  • Estado actual: sin tarea activa ✅
-  • Tareas en cola: 5 tareas esperando
-  • Último ship: hace 4 días ⚠️
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💡 TE RECOMIENDO:
-
-1. VER TU COLA DE TAREAS
-   /p:next
-   → Muestra las 5 tareas top priority
-   → Ya están priorizadas y listas para trabajar
-
-2. EMPEZAR LA TAREA #1
-   /p:build 1
-   → Empieza automáticamente la tarea top priority
-   → Asigna agente apropiado
-   → Tracking de tiempo
-
-3. VER SUGERENCIAS INTELIGENTES
-   /p:suggest
-   → Analiza tu contexto completo
-   → Recomienda basado en:
-     - Tiempo sin ship (4 días)
-     - Velocidad reciente
-     - Urgencias
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🎯 MI SUGERENCIA ESPECÍFICA:
-
-Han pasado 4 días sin ship → Es momento de completar algo
-
-Opción A: Trabaja en tareas de cola
-   /p:next → /p:build 1 → /p:done → /p:ship
-
-Opción B: Crea algo nuevo rápido
-   /p:feature "quick win" → /p:build 1 → ship today
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-¿Qué prefieres?
-1. Ver qué hay en cola (/p:next)
-2. Sugerencias personalizadas (/p:suggest)
-3. Contarme qué tienes en mente
-```
-
-## Key Principles
-
-1. **Conversational**: Natural language, not technical
-2. **Educational**: Explain WHY each command
-3. **Contextual**: Always check project state first
-4. **Interactive**: Ask confirmation, offer choices
-5. **No auto-execution**: Show the path, let user decide
-6. **Bilingual**: Support English and Spanish naturally
-7. **Examples**: Show similar use cases when relevant
-
 ## Validation
 
-- **Optional**: Can run without project initialized
-- **If not initialized**: Suggest `/p:init` first
+- **Optional**: Can run without project initialized (suggests `/p:init` if needed)
 - **Read-only**: Never modifies files, only recommends
 
 ## Edge Cases
 
-### No prjct project
-```
-⚠️  No prjct project here
-
-First, initialize:
-/p:init                    # For existing project
-/p:init "your idea"        # For new project
-
-Then I can help you!
-```
-
-### Very vague request
-```
-🤔 Puedes darme más detalles?
-
-Qué quieres hacer:
-• Agregar nueva funcionalidad?
-• Arreglar algo que no funciona?
-• Mejorar el código existente?
-• No estás seguro?
-
-Cuéntame más y te ayudo a encontrar el comando correcto!
-```
-
-## Success Criteria
-
-After using `/p:ask`, user should:
-- ✅ Understand WHAT commands to use
-- ✅ Understand WHY those commands
-- ✅ Understand the SEQUENCE of actions
-- ✅ Feel confident to proceed
-- ✅ Learn the system while using it
+**No prjct project**: Suggest `/p:init` or `/p:init "idea"` first
+**Vague request**: Ask for more details - feature? bug? optimization? not sure?
+**Active task exists**: Offer options - finish first (recommended) or add to queue