prjct-cli 0.8.6 → 0.9.1

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.9.1",
   "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/analyze.md

@@ -1,63 +1,20 @@
 ---
 allowed-tools: [Read, Grep, Glob, Bash, TodoWrite]
-description: 'Analyze repository and generate summary'
+description: 'Analyze repo + generate summary'
 ---
 
 # /p:analyze
 
 ## Flow
+1. Scan structure → Detect tech (package.json, Gemfile, etc.)
+2. Analyze patterns → Git status
+3. Generate → `analysis/repo-summary.md`
 
-1. Scan: project structure (Glob)
-2. Detect: technologies (package.json, requirements.txt, etc.)
-3. Analyze: architecture patterns
-4. Git: status and stats
-5. Generate: comprehensive report
-6. Save: `analysis/repo-summary.md`
-
-## Report Format
-
-```markdown
-# Repository Analysis
-
-## Overview
-
-- Type: {type}
-- Language: {lang}
-- Framework: {framework}
-
-## Git Status
-
-- Last commit: {hash} "{msg}" ({time_ago})
-- Status: {clean/has_changes}
-
-## Stack
-
-- Languages: {list}
-- Frameworks: {list}
-- Dependencies: {count}
-
-## Architecture
-
-- Pattern: {pattern}
-- Entry points: {files}
-
-## Recommended Agents
-
-Base (6): PM, UX, FE, BE, QA, Scribe
-Additional: {conditional_agents}
-
-Generated: {timestamp}
-```
+## Report
+- Overview: type, lang, framework
+- Stack: technologies detected
+- Architecture: patterns, entry points
+- Agents: recommend specialists
 
 ## Response
-
-```
-🔍 Analysis complete!
-
-Project: {name} ({type})
-Stack: {stack}
-
-📄 Full report: analysis/repo-summary.md
-
-/p:roadmap | /p:now
-```
+`🔍 {project} | Stack: {tech} | Saved: analysis/repo-summary.md`