prjct-cli 0.8.6 → 0.9.1

package/CHANGELOG.md

@@ -7,6 +7,222 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.1] - 2024-11-22
+
+### 🎯 Context Optimization & Prompt Efficiency
+
+Major performance improvements through context window optimization and prompt conciseness.
+
+### Added
+
+- **Mandatory Agent Assignment System**
+  - Every task now requires specialized agent assignment
+  - Automatic expertise detection from task descriptions
+  - Universal technology support (Ruby, Go, Python, etc.)
+
+- **Context Filtering System**
+  - 70-90% context window reduction per task
+  - Technology-specific file filtering
+  - Smart pattern detection for any framework
+
+### Changed
+
+- **Optimized Command Templates** (~70% reduction)
+  - Concise, efficient prompts for AI understanding
+  - Removed verbose explanations
+  - Direct flow instructions with → and | notation
+
+- **Agent Generation Improvements**
+  - Dynamic, concise agent prompts
+  - Removed 200+ lines of hardcoded patterns
+  - Universal technology detection
+
+### Performance
+
+- Context window usage: **70-90% reduction**
+- Template verbosity: **~70% average reduction**
+- Agent specialization: True domain focus achieved
+
+## [0.9.0] - 2024-11-22
+
+### 🚀 Major Release: Simplified Commands + Pause/Resume + Intelligent Ideas
+
+This release represents a **major simplification** of prjct-cli, reducing commands by 48% while adding powerful new capabilities including pause/resume for task interruptions and AI-powered idea development.
+
+### Added
+
+- **Task Stack System** - Natural workflow with interruptions
+  - ✅ `/p:pause [reason]` - Pause active task to handle interruptions
+  - ✅ `/p:resume [task_id]` - Resume paused tasks with preserved context
+  - ✅ Multiple concurrent paused tasks supported
+  - ✅ Automatic duration tracking (excludes paused time)
+  - ✅ Migration from legacy `now.md` to new `stack.jsonl` format
+  - 📊 Impact: Handle urgent tasks without losing context
+
+- **Intelligent Idea Development** - Transform ideas into complete architectures
+  - ✅ `/p:idea` enhanced to develop full technical specifications
+  - ✅ Simple ideas → Quick capture (< 20 words)
+  - ✅ Complex ideas → Complete architecture generation
+  - ✅ Interactive discovery process with AI
+  - ✅ Generates: Tech stack, API specs, database schema, roadmap
+  - ✅ Saves to `planning/architectures/{id}/` for reference
+  - 📊 Impact: Go from idea to implementation-ready specs in one command
+
+- **Unified Commands** - Fewer commands, more power
+  - ✅ `/p:work [task]` - Replaces `/p:now` + `/p:build`
+    - No params → Show current task
+    - With task → Start new task
+  - ✅ `/p:dash [view]` - Replaces 4 dashboard commands
+    - Default → Full dashboard
+    - `week/month` → Progress views
+    - `roadmap` → Planning view
+    - `compact` → Minimal status
+  - ✅ `/p:help [topic]` - Enhanced to absorb 3 commands
+    - Absorbs `/p:ask`, `/p:suggest`, `/p:stuck`
+    - Context-aware suggestions
+    - Intent to action translation
+
+### Changed
+
+- **Command Count** - Reduced from 23 → 13 (48% reduction)
+  - Core workflow remains 13 commands but simplified
+  - Removed redundant overlapping commands
+  - Better organization and clearer purpose
+
+- **Architecture Generator** - New system for idea development
+  - `core/domain/architecture-generator.js` - Full architecture generation
+  - `core/domain/task-stack.js` - Pause/resume task management
+  - `templates/planning-methodology.md` - Comprehensive planning guide
+
+### Removed
+
+- **Deprecated Commands** - Completely removed (not just marked deprecated)
+  - ❌ `/p:now` → Use `/p:work`
+  - ❌ `/p:build` → Use `/p:work "task"`
+  - ❌ `/p:status` → Use `/p:dash`
+  - ❌ `/p:roadmap` → Use `/p:dash roadmap`
+  - ❌ `/p:recap` → Use `/p:dash`
+  - ❌ `/p:progress` → Use `/p:dash week`
+  - ❌ `/p:ask` → Use `/p:help`
+  - ❌ `/p:suggest` → Use `/p:help`
+  - ❌ `/p:stuck` → Use `/p:help stuck:`
+  - ❌ `/p:workflow` → Automatic in `/p:ship`
+  - ❌ `/p:task` → Use `/p:feature` for breakdown
+
+### Migration Guide
+
+**For existing users:**
+1. First run will automatically migrate `now.md` to new stack system
+2. Old commands will show error with suggestion to use new command
+3. All data preserved during migration
+
+**Command mapping:**
+```bash
+# Old → New
+/p:now              → /p:work
+/p:build "task"     → /p:work "task"
+/p:status           → /p:dash
+/p:roadmap          → /p:dash roadmap
+/p:ask "question"   → /p:help ask: "question"
+/p:suggest          → /p:help
+/p:stuck "issue"    → /p:help stuck: "issue"
+```
+
+**New workflow:**
+```bash
+/p:idea "build CRM"     # Develop complete architecture
+/p:work "implement auth" # Start task
+/p:pause                 # Urgent interruption
+/p:work "fix bug"        # Handle urgent task
+/p:done                  # Complete bug
+/p:resume                # Back to auth
+/p:ship "auth feature"   # Ship when done
+```
+
+### Technical Details
+
+- New files: 10 templates, 3 domain modules
+- Modified: Command registry, core commands
+- Lines of code: +2000 (new features), -3000 (removed redundancy)
+- Breaking changes: Yes (old commands removed)
+- Data migration: Automatic
+
+## [0.8.8] - 2025-10-06
+
+### Added
+
+- **System timestamp tools** - LLM now gets real date/time from system instead of guessing
+  - ✅ `GetTimestamp()` tool - Returns ISO timestamp from system clock
+  - ✅ `GetDate()` tool - Returns YYYY-MM-DD from system clock
+  - ✅ `GetDateTime()` tool - Returns full date/time object with components
+  - 🐛 **Bug fixed**: Tasks no longer show January 1st dates when it's October
+  - 📊 Impact: Session files now use correct dates, analytics work properly
+
+- **Template optimization** - Phase 1 complete: Top 7 critical templates optimized
+  - ✅ Reduced from 2006 → 605 lines (69.8% reduction, saved 1401 lines)
+  - ✅ All templates now in English only (removed Spanish examples)
+  - ✅ Preserved 100% of business logic and decision-making patterns
+  - ✅ Removed verbose examples, success criteria, redundant explanations
+  - 📊 Impact: Faster LLM processing, lower token usage, clearer instructions
+
+- **Legacy installation cleanup** - Automatic detection and removal of curl-based installations
+  - ✅ Detects legacy `~/.prjct-cli/` from curl install.sh (pre-v0.8.2)
+  - ✅ Migrates project data to npm global location automatically
+  - ✅ Removes legacy installation files (bin/, core/, templates/, etc.)
+  - ✅ Preserves user data (projects/ directory migrated safely)
+  - ✅ Cleans up shell PATH entries (bash/zsh/PowerShell)
+  - ✅ Removes legacy symlinks on Unix systems
+  - 🎯 **Impact**: Users on old curl installations automatically migrate to npm
+  - 🔧 **Windows compatible**: Handles PowerShell profiles, skips Unix-only operations
+
+### Changed
+
+- **Critical timestamp rule in CLAUDE.md** - Added prominent warning about LLM timestamp limitations
+  - LLM knowledge cutoff is January 2025, cannot generate accurate timestamps
+  - All templates now include `timestamp-rule` in frontmatter
+  - Templates updated: feature.md, ship.md, now.md, build.md, idea.md
+  - Hardcoded example dates replaced with GetTimestamp()/GetDate() tool calls
+
+- **Templates optimized** (Phase 1 - Top 7)
+  - suggest.md: 555 → 96 lines (82.7% reduction)
+  - ask.md: 386 → 73 lines (81.1% reduction)
+  - help.md: 348 → 90 lines (74.1% reduction)
+  - feature.md: 239 → 93 lines (61.1% reduction)
+  - init.md: 210 → 113 lines (46.2% reduction)
+  - ship.md: 148 → 79 lines (46.6% reduction)
+  - migrate-all.md: 120 → 61 lines (49.2% reduction)
+
+- **context-builder.js** - Enhanced timestamp documentation
+  - Clarified that timestamps come from system clock, not LLM
+  - Added inline comments explaining ISO format and YYYY-MM-DD format
+
+- **install.sh deprecation** - Enhanced messaging with legacy detection
+  - Now detects if user has legacy curl installation
+  - Shows version and location of legacy install
+  - Provides clear migration instructions
+  - Explains automatic cleanup process
+
+- **All Spanish removed from codebase** - 100% English documentation
+  - Updated all JSDoc comments to English
+  - Removed Spanish examples from templates
+  - Fixed: setup.js, postinstall.js, AGENTS.md
+
+### Fixed
+
+- **Session date accuracy** - All session files now use correct system date
+  - Previously: LLM generated timestamps (often January 1st)
+  - Now: System clock provides accurate timestamps via GetTimestamp() tool
+  - Duration calculations now accurate
+  - Progress tracking and analytics now reliable
+
+- **Windows compatibility** - Full cross-platform support
+  - Legacy installer detector works on Windows
+  - Platform detection via `process.platform === 'win32'`
+  - PowerShell profile cleanup (instead of bash/zsh)
+  - Skips symlink cleanup on Windows (Unix-only feature)
+  - Cross-platform path handling with `os.homedir()` and `path.join()`
+  - Command installer already works on Windows (no changes needed)
+
 ## [0.8.6] - 2025-10-05
 
 ### Fixed

package/CLAUDE.md

@@ -6,6 +6,40 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **prjct-cli** is a developer momentum tool for solo builders, indie hackers, and small teams (2-5 people). Just ship. No BS. Track progress through slash commands without meetings, ceremonies, or traditional PM overhead.
 
+## ⚠️ CRITICAL: Timestamp Management
+
+**LLM DOES NOT KNOW CURRENT DATE/TIME** - Your knowledge cutoff is January 2025, and you cannot generate accurate timestamps.
+
+### Timestamp Tools (MUST USE)
+
+**ALWAYS use these tools for ALL timestamps and dates:**
+
+- `GetTimestamp()` → Returns current system time in ISO format (e.g., "2025-10-07T14:30:00.000Z")
+- `GetDate()` → Returns current date in YYYY-MM-DD format (e.g., "2025-10-07")
+- `GetDateTime()` → Returns object with timestamp, date, year, month, day
+
+### Rules
+
+1. **NEVER generate timestamps manually** - All dates like "2025-10-04" or "2025-01-01" are WRONG
+2. **ALWAYS call GetTimestamp()** when writing to session files (*.jsonl)
+3. **ALWAYS call GetDate()** when adding entries to index files (shipped.md, roadmap.md, ideas.md)
+4. **Templates have `timestamp-rule`** in frontmatter - READ AND FOLLOW IT
+5. **Session files are organized by date** - Use system date to determine correct file path
+
+### Example (CORRECT)
+
+```jsonl
+{"ts":"{GetTimestamp()}","type":"feature_add","name":"auth","tasks":5}
+```
+
+### Example (WRONG - DO NOT DO THIS)
+
+```jsonl
+{"ts":"2025-10-04T14:30:00Z","type":"feature_add","name":"auth","tasks":5}
+```
+
+**Why this matters**: Without system timestamps, all session data shows January 1st dates, making analytics and progress tracking completely broken.
+
 ## 🚀 Real-World Workflow (Simplified)
 
 prjct follows your **actual** development workflow with 5 essential commands: