prjct-cli 0.11.4 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,77 @@
 # Changelog
 
+## [0.12.0] - 2025-12-10
+
+### Added - JSON-First Architecture (Zero Data Loss)
+
+Major refactor: JSON is now source of truth. Claude reads/writes JSON, MD views are auto-generated.
+
+- **New Data Flow**
+  - `data/*.json` - Source of truth (Claude reads/writes)
+  - `views/*.md` - Auto-generated from JSON (Claude does NOT write MD)
+  - Web app reads JSON directly (no regex parsing)
+
+- **LLM-Based Migration** (`/api/migrate`)
+  - OpenRouter Claude-3.5-haiku extracts structured data from legacy MD
+  - Comprehensive pattern extraction rules for ZERO data loss
+  - Migrates: state, queue, ideas, roadmap, shipped, metrics, project
+
+- **Enriched Schemas** (capturing ALL data from MD)
+  - `shipped.json`: Added `agent`, `description`, `codeSnippets[]`, `commit{hash,message}`
+  - `queue.json`: Added `agent`, `groupName`, `groupId` per task
+  - `ideas.json`: Added `source`, `sourceFiles[]`, `stack{}`, `modules[]`, `roles[]`, `risks[]`
+  - `roadmap.json`: Added `duration{}`, `taskCount`, `agent`, `sprintName`, `completedDate`
+
+- **View Generator** (`bin/generate-views.js`)
+  - Generates MD from JSON for Claude context
+  - Templates: now.md, next.md, ideas.md, roadmap.md, shipped.md
+
+- **Files Added**:
+  - `packages/web/lib/services/migration.server.ts` - LLM migration service
+  - `packages/web/app/api/migrate/route.ts` - Migration API endpoint
+  - `core/view-generator.ts` - View generation from JSON
+  - `bin/generate-views.js` - CLI for view generation
+
+- **Files Modified**:
+  - `core/schemas/*.ts` - All schemas with enriched fields
+  - `packages/web/lib/json-loader.ts` - Types synced with schemas
+
+## [0.11.6] - 2025-12-09
+
+### Fixed - Terminal Responsive & Performance Issues
+
+Bug fixes for terminal UX issues when resizing browser and handling large output.
+
+- **Resize Bug Fixed** - Terminal no longer gets stuck at ~100px² when resizing browser
+  - Replaced `window.addEventListener('resize')` with `ResizeObserver`
+  - Added dimension validation before fitting (handles hidden tabs correctly)
+  - Added proper cleanup on unmount
+  - Added re-fit on tab activation
+
+- **Performance Improvements** - Terminal now handles large output smoothly
+  - Added client-side output buffering with `requestAnimationFrame`
+  - Added server-side PTY output buffering (16ms batch window)
+  - Added terminal config optimizations (`scrollback: 5000`, `smoothScrollDuration: 0`)
+
+- **Files Modified**:
+  - `packages/web/hooks/useClaudeTerminal.ts` - ResizeObserver, output batching, fit function
+  - `packages/web/components/TerminalTab.tsx` - Re-fit on tab activation
+  - `packages/web/server.ts` - PTY output buffering
+
+## [0.11.5] - 2025-12-09
+
+### Fixed - Production Server Mode
+
+Critical bug fix: `prjct serve` now runs in production mode instead of development mode.
+
+- **Server Mode** - Changed from dev to production
+  - Default port: 3000 → 9472 (avoids conflicts)
+  - Mode: `npm run dev` → `npm run start:prod` with `NODE_ENV=production`
+  - Auto-build on first run if `.next/` doesn't exist
+  - All features now work correctly (were broken in dev mode)
+
+- **packages/web/package.json** - Added `start:prod` script
+
 ## [0.11.0] - 2025-12-08
 
 ### Added - Web Application & Server Components

package/README.md

@@ -17,6 +17,34 @@ Developer momentum tool for indie hackers and small teams.
 [![Tests](https://github.com/jlopezlira/prjct-cli/actions/workflows/test.yml/badge.svg)](https://github.com/jlopezlira/prjct-cli/actions/workflows/test.yml)
 [![Website Build](https://img.shields.io/badge/website-deployed-success)](https://prjct.app)
 
+> **New to prjct?** You don't need to memorize commands. Just use `p.` and talk naturally:
+> - `p. start working on user auth`
+> - `p. I'm done`
+> - `p. ship the authentication`
+
+## 💬 p. Trigger - Zero Memorization
+
+**You don't need to memorize commands.** Just use the `p.` prefix and talk naturally!
+
+The system detects your intent and maps it to the right command - **works in any language**:
+
+```
+Instead of:                      Just say:
+/p:now "implement auth"    →     "p. I want to start building the auth system"
+/p:done                    →     "p. I'm done" or "p. finished"
+/p:ship "feature"          →     "p. ship the authentication"
+/p:stuck "error"           →     "p. I'm stuck on this error"
+/p:idea "add feature"      →     "p. I have an idea about dark mode"
+```
+
+**How it works:**
+
+- Simple `p.` prefix signals prjct context
+- Works in English, Spanish, German, French - any language
+- System detects intent and executes the right command
+- Auto-validates you're in a prjct project before execution
+- Every command response suggests what to do next
+
 ## 🤖 Claude-Native Architecture
 
 **prjct-cli is purpose-built for Claude's unique capabilities:**
@@ -38,25 +66,25 @@ We chose to focus 100% on Claude to deliver:
 
 ## ⚡ Installation
 
-### From npm (Recommended)
+### Using Bun (Recommended)
 
-Install prjct-cli globally using npm:
+prjct-cli is built with Bun for maximum performance:
 
 ```bash
-npm install -g prjct-cli
+bun install -g prjct-cli
 ```
 
-**Alternative package managers**:
+### Alternative Package Managers
 
 ```bash
+# Using npm
+npm install -g prjct-cli
+
 # Using yarn
 yarn global add prjct-cli
 
 # Using pnpm
 pnpm add -g prjct-cli
-
-# Using bun
-bun install -g prjct-cli
 ```
 
 ### From GitHub Packages
@@ -69,7 +97,7 @@ npm install -g @jlopezlira/prjct-cli --registry=https://npm.pkg.github.com
 
 For easier installation from GitHub Packages, see [GitHub Packages Setup](docs/GITHUB_PACKAGES.md).
 
-**Requirements**: Node.js 18 or higher
+**Requirements**: Bun 1.0+ or Node.js 18+
 
 > **Note**: The CLI automatically detects updates and notifies you when a new version is available. Simply run `npm update -g prjct-cli` to upgrade.
 
@@ -127,32 +155,60 @@ cd prjct-cli
 - ✅ **Auto-detects your environment** (Claude or Terminal fallback)
 - ✅ **Configures shell** (bash/zsh) automatically
 
-## 💬 p. Trigger - Zero Memorization
+## ⚡ 5-Minute Quick Start
 
-**You don't need to memorize commands.** Just use the `p.` prefix and talk naturally!
+Get productive with prjct-cli in under 5 minutes.
 
-The system detects your intent and maps it to the right command - **works in any language**:
+### Step 1: Initialize Your Project
 
+```bash
+cd your-project
 ```
-✨ Natural Language with p. Trigger:
 
-Instead of:                      Just say:
-/p:now "implement auth"    →     "p. I want to start building the auth system"
-/p:done                    →     "p. I'm done" or "p. finished"
-/p:ship "feature"          →     "p. ship the authentication"
-/p:stuck "error"           →     "p. I'm stuck on this error"
-/p:idea "add feature"      →     "p. I have an idea about dark mode"
+In Claude Code or Claude Desktop:
+```
+/p:init
 ```
 
-**How it works:**
+Or just say: `p. initialize this project`
 
-- Simple `p.` prefix signals prjct context
-- Works in English, Spanish, German, French - any language
-- System detects intent and executes the right command
-- Auto-validates you're in a prjct project before execution
-- Every command response suggests what to do next
+### Step 2: Start Your First Task
+
+```
+/p:now "implement user login"
+```
+
+Or naturally: `p. I want to start working on user login`
+
+### Step 3: Work on Your Task
+
+Just code! prjct tracks your focus.
+
+### Step 4: Complete Your Task
+
+```
+/p:done
+```
+
+Or naturally: `p. finished`
+
+### Step 5: Ship It!
+
+```
+/p:ship "user authentication"
+```
+
+Or naturally: `p. ship the authentication`
+
+**That's it!** You now know the core workflow.
+
+### What's Next?
+
+- `/p:recap` - See your progress
+- `/p:help` - Get contextual guidance
+- `/p:idea "something cool"` - Capture ideas without interrupting
 
-**Available in:** Any language - powered by Claude's natural language understanding
+> **Pro tip:** You don't need to memorize commands. Just use `p.` and describe what you want!
 
 ## 🚀 Built for Claude - Ship Fast, No BS
 

package/bin/dev.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * prjct dev - Start prjct web development environment

package/bin/generate-views.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env bun
+
+/**
+ * prjct generate-views - Generate MD views from JSON data
+ *
+ * Converts JSON source of truth to readable MD files for Claude.
+ *
+ * Usage:
+ *   prjct generate-views --project=<projectId>   Generate views for specific project
+ *   prjct generate-views --all                   Generate views for all projects
+ *   prjct generate-views --view=<name>           Generate specific view (now, next, ideas, roadmap, shipped)
+ */
+
+const path = require('path')
+const fs = require('fs/promises')
+const os = require('os')
+
+// Colors for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+}
+
+const GLOBAL_STORAGE = path.join(os.homedir(), '.prjct-cli', 'projects')
+
+// Parse command line arguments
+function parseArgs(argv) {
+  const args = {
+    project: null,
+    all: false,
+    view: null,
+    help: false,
+  }
+
+  for (const arg of argv.slice(2)) {
+    if (arg === '--help' || arg === '-h') {
+      args.help = true
+    } else if (arg === '--all') {
+      args.all = true
+    } else if (arg.startsWith('--project=')) {
+      args.project = arg.split('=')[1]
+    } else if (arg.startsWith('--view=')) {
+      args.view = arg.split('=')[1]
+    }
+  }
+
+  return args
+}
+
+// Print help message
+function printHelp() {
+  console.log(`
+${colors.cyan}${colors.bright}prjct generate-views${colors.reset}
+
+Generate MD views from JSON data files.
+
+${colors.bright}Usage:${colors.reset}
+  prjct generate-views --project=<projectId>   Generate views for specific project
+  prjct generate-views --all                   Generate views for all projects
+  prjct generate-views --view=<name>           Generate specific view only
+
+${colors.bright}Options:${colors.reset}
+  --project=<id>    Project ID to generate views for
+  --all             Generate views for all projects
+  --view=<name>     Generate specific view (now, next, ideas, roadmap, shipped)
+  --help, -h        Show this help message
+
+${colors.bright}Views:${colors.reset}
+  now      Current task status (from state.json)
+  next     Priority queue (from queue.json)
+  ideas    Idea backlog (from ideas.json)
+  roadmap  Feature roadmap (from roadmap.json)
+  shipped  Shipped items (from shipped.json)
+
+${colors.bright}Examples:${colors.reset}
+  prjct generate-views --project=abc123
+  prjct generate-views --all
+  prjct generate-views --project=abc123 --view=now
+`)
+}
+
+// Get list of all project IDs
+async function getAllProjects() {
+  try {
+    const entries = await fs.readdir(GLOBAL_STORAGE, { withFileTypes: true })
+    return entries
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name)
+  } catch {
+    return []
+  }
+}
+
+// Import and run the view generator
+async function generateViews(projectId, viewName = null) {
+  // Dynamic import of the TypeScript module
+  const generatorPath = path.join(__dirname, '..', 'core', 'view-generator.ts')
+
+  try {
+    const generator = await import(generatorPath)
+
+    if (viewName) {
+      // Generate specific view
+      await generator.generateView(projectId, viewName)
+      return { generated: [`${viewName}.md`], errors: [] }
+    } else {
+      // Generate all views
+      return await generator.generateViews(projectId)
+    }
+  } catch (err) {
+    return {
+      generated: [],
+      errors: [err instanceof Error ? err.message : 'Unknown error'],
+    }
+  }
+}
+
+// Main function
+async function main() {
+  const args = parseArgs(process.argv)
+
+  if (args.help) {
+    printHelp()
+    process.exit(0)
+  }
+
+  // Validate arguments
+  if (!args.project && !args.all) {
+    console.log(`${colors.red}Error: Specify --project=<id> or --all${colors.reset}`)
+    console.log(`${colors.dim}Run 'prjct generate-views --help' for usage${colors.reset}`)
+    process.exit(1)
+  }
+
+  // Validate view name if specified
+  const validViews = ['now', 'next', 'ideas', 'roadmap', 'shipped']
+  if (args.view && !validViews.includes(args.view)) {
+    console.log(`${colors.red}Error: Invalid view '${args.view}'${colors.reset}`)
+    console.log(`${colors.dim}Valid views: ${validViews.join(', ')}${colors.reset}`)
+    process.exit(1)
+  }
+
+  // Get projects to process
+  let projects = []
+  if (args.all) {
+    projects = await getAllProjects()
+    if (projects.length === 0) {
+      console.log(`${colors.yellow}No projects found in ${GLOBAL_STORAGE}${colors.reset}`)
+      process.exit(0)
+    }
+  } else {
+    projects = [args.project]
+  }
+
+  console.log(`${colors.cyan}${colors.bright}Generating views...${colors.reset}\n`)
+
+  let totalGenerated = 0
+  let totalErrors = 0
+
+  for (const projectId of projects) {
+    const projectPath = path.join(GLOBAL_STORAGE, projectId)
+
+    // Check project exists
+    try {
+      await fs.access(projectPath)
+    } catch {
+      console.log(`${colors.yellow}⚠ Project not found: ${projectId}${colors.reset}`)
+      totalErrors++
+      continue
+    }
+
+    const result = await generateViews(projectId, args.view)
+
+    if (result.generated.length > 0) {
+      console.log(`${colors.green}✓ ${projectId}${colors.reset}`)
+      for (const file of result.generated) {
+        console.log(`  ${colors.dim}→ ${file}${colors.reset}`)
+      }
+      totalGenerated += result.generated.length
+    }
+
+    if (result.errors.length > 0) {
+      console.log(`${colors.red}✗ ${projectId}${colors.reset}`)
+      for (const error of result.errors) {
+        console.log(`  ${colors.red}→ ${error}${colors.reset}`)
+      }
+      totalErrors += result.errors.length
+    }
+  }
+
+  // Summary
+  console.log('')
+  if (totalGenerated > 0) {
+    console.log(`${colors.green}${colors.bright}✓ Generated ${totalGenerated} view(s)${colors.reset}`)
+  }
+  if (totalErrors > 0) {
+    console.log(`${colors.red}✗ ${totalErrors} error(s)${colors.reset}`)
+    process.exit(1)
+  }
+}
+
+main().catch((err) => {
+  console.error(`${colors.red}Error: ${err.message}${colors.reset}`)
+  process.exit(1)
+})