prjct-cli 0.10.8 → 0.10.10

package/templates/commands/feature.md

@@ -1,34 +1,275 @@
 ---
-allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
+allowed-tools: [Read, Write, Bash]
 description: 'Value analysis + roadmap + task breakdown + auto-start'
 timestamp-rule: 'GetTimestamp() and GetDate() for ALL timestamps'
-think-triggers: [explore_to_edit, complex_analysis]
 ---
 
-# /p:feature
+# /p:feature - Add Feature to Roadmap
 
-## Think First
-Before creating feature, analyze:
-1. Is this a simple or complex feature?
-2. What files/components will be affected?
-3. Are there dependencies or blockers?
-4. Should I create a /p:spec first?
+## Context Variables
+- `{projectId}`: From `.prjct/prjct.config.json`
+- `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{roadmapPath}`: `{globalPath}/planning/roadmap.md`
+- `{nextPath}`: `{globalPath}/core/next.md`
+- `{nowPath}`: `{globalPath}/core/now.md`
+- `{memoryPath}`: `{globalPath}/memory/context.jsonl`
+- `{feature}`: User-provided feature description
 
-## Flow
+## Step 1: Read Config
 
-1. **Value**: Impact/effort/timing → do_now/defer/blocked
-2. **Roadmap**: Add to `planning/roadmap.md` (30 days max)
-3. **Tasks**: Break down → `core/next.md`
-4. **Session**: Log to `planning/sessions/{YYYY-MM}/{DD}.jsonl`
-5. **Start**: Auto-start task 1 with agent assignment
+READ: `.prjct/prjct.config.json`
+EXTRACT: `projectId`
 
-**No params**: Show 6 categories (UI/Performance/Features/Quality/Bugs/Docs)
+IF file not found:
+  OUTPUT: "No prjct project. Run /p:init first."
+  STOP
 
-## Data
+## Step 2: Handle No Parameters
 
-Session: `{"ts":"{GetTimestamp()}","type":"feature_add","name":"{f}","tasks":{n},"impact":"{h/m/l}","effort":"{Xh}"}`
-Roadmap: `- [ ] {feature} ({n} tasks, {Xh}) - {GetDate()}`
+IF no feature description provided:
+  OUTPUT interactive menu:
+  ```
+  What kind of feature?
 
-## Response
+  1. UI/UX - Interface improvements
+  2. Performance - Speed, memory, optimization
+  3. Features - New functionality
+  4. Quality - Testing, refactoring
+  5. Bugs - Fix issues
+  6. Docs - Documentation
 
-`✅ {feature} | Impact: {impact} | {n} tasks | Starting #{1}`
+  Describe your feature or choose a category.
+  ```
+  WAIT for user input
+  CONTINUE with user's response as {feature}
+
+## Step 3: Value Analysis
+
+Analyze the feature:
+
+### Impact Assessment
+Based on feature description, determine:
+
+IF affects core functionality OR user-facing:
+  {impact} = "high"
+ELSE IF affects internal systems OR developer experience:
+  {impact} = "medium"
+ELSE:
+  {impact} = "low"
+
+### Effort Estimation
+Based on complexity:
+
+IF simple change (1-2 files, straightforward):
+  {effort} = "1-2h"
+  {taskCount} = 1-2
+ELSE IF medium change (3-5 files, some logic):
+  {effort} = "3-4h"
+  {taskCount} = 3-4
+ELSE IF complex change (many files, new patterns):
+  {effort} = "6-8h"
+  {taskCount} = 5-8
+ELSE:
+  {effort} = "1d+"
+  {taskCount} = 8+
+
+### Timing Decision
+IF {impact} = "high" AND {effort} < "4h":
+  {timing} = "do_now"
+ELSE IF {impact} = "high":
+  {timing} = "plan_first"
+ELSE:
+  {timing} = "add_to_queue"
+
+## Step 4: Task Breakdown
+
+Break {feature} into specific, actionable tasks:
+
+### Task Generation Rules
+1. Each task should be completable in 30min - 2h
+2. Tasks should be atomic (one concern each)
+3. Order tasks by dependency (blockers first)
+4. Include setup/research task if needed
+5. Include testing/verification as final task
+
+### Example Breakdown
+For feature "add user authentication":
+```
+1. Research auth patterns for this stack
+2. Setup auth middleware/routes
+3. Implement login endpoint
+4. Implement logout endpoint
+5. Add session management
+6. Write auth tests
+```
+
+GENERATE: {tasks} = list of task descriptions
+
+## Step 5: Update Roadmap
+
+READ: `{roadmapPath}` (create if not exists)
+
+### Format New Entry
+
+```markdown
+## {GetDate()} - {feature}
+- Impact: {impact} | Effort: {effort}
+- Tasks: {taskCount}
+- Status: active
+
+### Tasks
+1. [ ] {task1}
+2. [ ] {task2}
+...
+```
+
+INSERT at top (after # Roadmap header)
+
+### Archive Old Entries
+IF entries older than 30 days exist:
+  MOVE to: `{globalPath}/planning/archive/roadmap-{yearMonth}.md`
+
+WRITE: `{roadmapPath}`
+
+## Step 6: Update Priority Queue
+
+READ: `{nextPath}` (create if not exists)
+
+### Add Tasks to Queue
+
+For each task in {tasks}:
+  APPEND to next.md:
+  ```markdown
+  - [ ] {task} (from: {feature})
+  ```
+
+WRITE: `{nextPath}`
+
+## Step 7: Auto-Start First Task
+
+READ: `{nowPath}`
+
+IF empty OR contains "No current task":
+  ### Start First Task
+  {firstTask} = first item from {tasks}
+
+  WRITE: `{nowPath}`
+  ```markdown
+  # NOW
+
+  **{firstTask}**
+
+  Feature: {feature}
+  Started: {GetTimestamp()}
+  ```
+
+  {autoStarted} = true
+ELSE:
+  {autoStarted} = false
+
+## Step 8: Log to Session
+
+GET: {date} = GetDate()
+EXTRACT: {yearMonth} = YYYY-MM from {date}
+
+ENSURE directory:
+BASH: `mkdir -p {globalPath}/planning/sessions/{yearMonth}`
+
+APPEND to: `{globalPath}/planning/sessions/{yearMonth}/{date}.jsonl`
+
+Single line (JSONL):
+```json
+{"ts":"{GetTimestamp()}","type":"feature_add","name":"{feature}","tasks":{taskCount},"impact":"{impact}","effort":"{effort}"}
+```
+
+## Step 9: Log to Memory
+
+APPEND to: `{memoryPath}`
+
+Single line (JSONL):
+```json
+{"timestamp":"{GetTimestamp()}","action":"feature_added","feature":"{feature}","tasks":{taskCount}}
+```
+
+## Output
+
+SUCCESS (with auto-start):
+```
+✅ Added: {feature}
+
+Impact: {impact} | Effort: {effort}
+Tasks: {taskCount}
+
+🎯 Started: {firstTask}
+
+Next:
+• Work on the task
+• /p:done - When finished
+• /p:next - See full queue
+```
+
+SUCCESS (without auto-start):
+```
+✅ Added: {feature}
+
+Impact: {impact} | Effort: {effort}
+Tasks: {taskCount}
+
+⚠️ Already working on another task.
+Tasks added to queue.
+
+Next:
+• /p:done - Finish current task
+• /p:next - See queue
+```
+
+## Error Handling
+
+| Error | Response | Action |
+|-------|----------|--------|
+| No config | "No prjct project" | STOP |
+| No feature | Show category menu | WAIT |
+| Write fails | Log warning | CONTINUE |
+
+## Examples
+
+### Example 1: Simple Feature
+Input: `/p:feature add dark mode toggle`
+
+```
+✅ Added: add dark mode toggle
+
+Impact: medium | Effort: 2-3h
+Tasks: 3
+
+🎯 Started: Setup theme context/state
+
+Tasks:
+1. Setup theme context/state
+2. Add toggle component
+3. Apply theme to components
+
+Next: /p:done | /p:next
+```
+
+### Example 2: Complex Feature
+Input: `/p:feature implement user authentication`
+
+```
+✅ Added: implement user authentication
+
+Impact: high | Effort: 6-8h
+Tasks: 6
+
+🎯 Started: Research auth patterns
+
+Tasks:
+1. Research auth patterns
+2. Setup auth middleware
+3. Implement login
+4. Implement logout
+5. Add session management
+6. Write auth tests
+
+Next: /p:done | /p:next
+```

package/templates/commands/ship.md

@@ -1,35 +1,256 @@
 ---
-allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
-description: 'Ship feature workflow'
-timestamp-rule: 'GetTimestamp() and GetDate() for timestamps'
-think-triggers: [git_decision, report_complete]
+allowed-tools: [Read, Write, Bash]
+description: 'Ship feature with automated workflow'
+timestamp-rule: 'GetTimestamp() and GetDate() for ALL timestamps'
 ---
 
-# /p:ship
+# /p:ship - Ship Feature Workflow
 
-## Think First
-Before shipping, verify:
-1. Are there uncommitted changes to include?
-2. What version bump is needed (patch/minor/major)?
-3. Is the feature actually complete?
-4. Should tests run first?
+## Context Variables
+- `{projectId}`: From `.prjct/prjct.config.json`
+- `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{shippedPath}`: `{globalPath}/progress/shipped.md`
+- `{memoryPath}`: `{globalPath}/memory/context.jsonl`
+- `{feature}`: User-provided feature name
 
-## Workflow (non-blocking)
-1. Lint → Tests → Docs update
-2. Version bump → CHANGELOG
-3. Commit + push (prjct footer)
-4. Log: `progress/sessions/{YY-MM}/{DD}.jsonl`
-5. Update: `progress/shipped.md` (30 days)
-6. Recommend: compact
+## Step 1: Read Config
 
-## Data
-Session: `{"ts":"{GetTimestamp()}","type":"feature_ship","name":"{f}","agent":"{a}","version":"{v}"}`
+READ: `.prjct/prjct.config.json`
+EXTRACT: `projectId`
 
-Commit footer:
+IF file not found:
+  OUTPUT: "No prjct project. Run /p:init first."
+  STOP
+
+## Step 2: Validate Prerequisites
+
+BASH: `git status --porcelain`
+
+IF output empty (no changes):
+  OUTPUT: "⚠️ No changes to ship. Make some commits first."
+  STOP
+
+BASH: `git rev-parse --is-inside-work-tree`
+
+IF not a git repo:
+  OUTPUT: "⚠️ Not a git repository. Initialize git first."
+  STOP
+
+## Step 3: Quality Checks (Non-Blocking)
+
+### Lint Check
+BASH: `npm run lint 2>&1 || echo "LINT_SKIP"`
+
+CAPTURE output as {lintResult}
+
+IF contains "LINT_SKIP" OR contains "missing script":
+  {lintStatus} = "skipped"
+ELSE IF contains "error":
+  {lintStatus} = "warnings"
+ELSE:
+  {lintStatus} = "passed"
+
+### Test Check
+BASH: `npm test 2>&1 || echo "TEST_SKIP"`
+
+CAPTURE output as {testResult}
+
+IF contains "TEST_SKIP" OR contains "missing script":
+  {testStatus} = "skipped"
+ELSE IF contains "failed" OR contains "FAIL":
+  {testStatus} = "failed"
+ELSE:
+  {testStatus} = "passed"
+
+**Note**: These are NON-BLOCKING. Continue even if they fail.
+
+## Step 4: Version Bump
+
+READ: `package.json`
+EXTRACT: current version as {currentVersion}
+
+### Determine Bump Type
+
+BASH: `git log --oneline -10`
+
+ANALYZE commit messages:
+
+IF any commit contains "BREAKING" OR "major:":
+  {bumpType} = "major"
+  {newVersion} = increment X in X.Y.Z, set Y=0, Z=0
+
+ELSE IF any commit contains "feat:" OR "feature:":
+  {bumpType} = "minor"
+  {newVersion} = increment Y in X.Y.Z, set Z=0
+
+ELSE:
+  {bumpType} = "patch"
+  {newVersion} = increment Z in X.Y.Z
+
+### Update package.json
+
+READ: `package.json`
+REPLACE: `"version": "{currentVersion}"` with `"version": "{newVersion}"`
+WRITE: `package.json`
+
+## Step 5: Update CHANGELOG
+
+READ: `CHANGELOG.md` (create if not exists)
+
+### Format New Entry
+
+```markdown
+## [{newVersion}] - {GetDate()}
+
+### {feature}
+- Shipped by prjct-cli
+- Lint: {lintStatus}
+- Tests: {testStatus}
 ```
+
+INSERT at top of file (after # Changelog header)
+
+WRITE: `CHANGELOG.md`
+
+## Step 6: Git Commit
+
+### Stage Changes
+BASH: `git add .`
+
+### Create Commit
+BASH: `git commit -m "$(cat <<'EOF'
+feat: Ship {feature}
+
+- Version: {newVersion}
+- Lint: {lintStatus}
+- Tests: {testStatus}
+
 🤖 Generated with [p/](https://www.prjct.app/)
 Designed for [Claude](https://www.anthropic.com/claude)
+EOF
+)"`
+
+## Step 7: Git Push
+
+BASH: `git push 2>&1`
+
+CAPTURE output as {pushResult}
+
+IF contains "rejected" OR contains "failed":
+  OUTPUT: "⚠️ Push failed. Try: git pull --rebase && git push"
+  CONTINUE (don't stop)
+
+IF contains "no upstream":
+  BASH: `git push -u origin HEAD`
+
+## Step 8: Log to Session
+
+GET: {date} = GetDate()
+EXTRACT: {yearMonth} = YYYY-MM from {date}
+
+ENSURE directory exists:
+BASH: `mkdir -p {globalPath}/progress/sessions/{yearMonth}`
+
+APPEND to: `{globalPath}/progress/sessions/{yearMonth}/{date}.jsonl`
+
+Single line (JSONL):
+```json
+{"ts":"{GetTimestamp()}","type":"feature_ship","name":"{feature}","version":"{newVersion}","lint":"{lintStatus}","tests":"{testStatus}"}
+```
+
+## Step 9: Update Shipped Index
+
+READ: `{shippedPath}` (create if not exists)
+
+### Format New Entry
+
+```markdown
+## {GetDate()} - {feature}
+- Version: {newVersion}
+- Lint: {lintStatus} | Tests: {testStatus}
+```
+
+INSERT at top (after # Shipped header)
+
+### Archive Old Entries
+IF file has entries older than 30 days:
+  MOVE old entries to: `{globalPath}/progress/archive/shipped-{yearMonth}.md`
+
+WRITE: `{shippedPath}`
+
+## Step 10: Log to Memory
+
+APPEND to: `{memoryPath}`
+
+Single line (JSONL):
+```json
+{"timestamp":"{GetTimestamp()}","action":"feature_shipped","feature":"{feature}","version":"{newVersion}"}
+```
+
+## Output
+
+SUCCESS:
+```
+🚀 Shipped: {feature}
+
+Version: {currentVersion} → {newVersion}
+Lint: {lintStatus}
+Tests: {testStatus}
+Commit: {commitHash}
+
+Next:
+• /p:feature - Plan next feature
+• /p:recap - See progress
+• compact - Clean up conversation
+```
+
+## Error Handling
+
+| Error | Response | Action |
+|-------|----------|--------|
+| No git repo | "Not a git repository" | STOP |
+| No changes | "No changes to ship" | STOP |
+| Lint fails | Show warning | CONTINUE |
+| Tests fail | Show warning | CONTINUE |
+| Push fails | Show fix command | CONTINUE |
+| No package.json | Skip version bump | CONTINUE |
+
+## Examples
+
+### Example 1: Full Success
+```
+🚀 Shipped: user authentication
+
+Version: 1.2.0 → 1.3.0
+Lint: passed
+Tests: passed
+Commit: abc1234
+
+Next: /p:feature | /p:recap | compact
 ```
 
-## Response
-`🚀 {feature} | {agent} | {time} | v{version} | Next: compact`
+### Example 2: With Warnings
+```
+🚀 Shipped: bug fixes
+
+Version: 1.2.0 → 1.2.1
+Lint: warnings (non-blocking)
+Tests: skipped
+Commit: def5678
+
+⚠️ Consider fixing lint warnings
+
+Next: /p:feature | /p:recap | compact
+```
+
+### Example 3: No Tests/Lint
+```
+🚀 Shipped: documentation update
+
+Version: 1.2.0 → 1.2.1
+Lint: skipped (no script)
+Tests: skipped (no script)
+Commit: ghi9012
+
+Next: /p:feature | /p:recap | compact
+```