prjct-cli 0.12.2 → 0.13.0

package/templates/commands/now.md

@@ -2,26 +2,38 @@
 allowed-tools: [Read, Write, Bash]
 description: 'Set or show current task with session tracking'
 timestamp-rule: 'GetTimestamp() for ALL timestamps'
-architecture: 'JSON-first - Write to data/*.json, views are generated'
+architecture: 'MD-first - MD files are source of truth'
 ---
 
 # /p:now - Current Task with Session Tracking
 
-## Architecture: JSON-First
+## Architecture: MD-First
 
-**Source of Truth**: `data/state.json`
-**Generated View**: `views/now.md` (auto-generated, do not edit directly)
+**Source of Truth**: `core/now.md`
 
-All writes go to JSON. After writing, run `prjct generate-views --project={projectId}` to regenerate MD views.
+MD files are the source of truth. Write directly to MD files.
 
 ## Context Variables
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
-- `{dataPath}`: `{globalPath}/data`
-- `{statePath}`: `{dataPath}/state.json`
+- `{nowPath}`: `{globalPath}/core/now.md`
 - `{sessionPath}`: `{globalPath}/sessions/current.json`
 - `{memoryPath}`: `{globalPath}/memory/context.jsonl`
 - `{task}`: User-provided task (optional)
+- `{estimate}`: User-provided time estimate (optional, e.g., "2h", "30m", "1d")
+
+## Estimate Format
+
+Estimates use simple duration format:
+- `30m` - 30 minutes
+- `2h` - 2 hours
+- `1d` - 1 day (8 hours)
+- `2h30m` - 2 hours 30 minutes
+
+If no estimate provided, gently remind:
+```
+💡 Tip: Add estimate next time with /p:now "task" 2h
+```
 
 ## Step 1: Read Config
 
@@ -34,14 +46,17 @@ IF file not found:
 
 ## Step 2: Check Current State
 
-### Read state.json (source of truth)
-READ: `{statePath}`
+### Read now.md (source of truth)
+READ: `{nowPath}`
 
-IF file exists:
-  PARSE as JSON
-  EXTRACT: {currentTask} from state.currentTask
+IF file exists AND has content:
+  PARSE MD format:
+  - Look for `**Task description**` (bold text = current task)
+  - Look for `Started: {timestamp}`
+  - Look for `Session: {sessionId}`
+  EXTRACT: {currentTask}, {startedAt}, {sessionId}
 
-### Check for active session (legacy support)
+### Check for active session (for detailed tracking)
 READ: `{sessionPath}`
 
 IF file exists:
@@ -104,23 +119,30 @@ IF {task} is provided:
   GENERATE: {sessionId} = "sess_" + 8 random alphanumeric chars
   SET: {startedAt} = GetTimestamp()
 
-  ### Write state.json (SOURCE OF TRUTH)
-  READ: `{statePath}` (or create default if not exists)
+  ### Write now.md (SOURCE OF TRUTH)
 
-  UPDATE state.json:
-  ```json
-  {
-    "currentTask": {
-      "id": "task_{8_random_chars}",
-      "description": "{task}",
-      "startedAt": "{startedAt}",
-      "sessionId": "{sessionId}"
-    },
-    "lastUpdated": "{startedAt}"
-  }
+  WRITE: `{nowPath}`
+
+  IF {estimate} provided:
+  ```markdown
+  # NOW
+
+  **{task}**
+
+  Started: {startedAt}
+  Session: {sessionId}
+  Estimate: {estimate}
   ```
 
-  WRITE: `{statePath}`
+  ELSE (no estimate):
+  ```markdown
+  # NOW
+
+  **{task}**
+
+  Started: {startedAt}
+  Session: {sessionId}
+  ```
 
   ### Create session JSON (for detailed tracking)
   WRITE: `{sessionPath}`
@@ -135,6 +157,8 @@ IF {task} is provided:
     "pausedAt": null,
     "completedAt": null,
     "duration": 0,
+    "estimate": "{estimate OR null}",
+    "estimateSeconds": {estimateInSeconds OR null},
     "metrics": {
       "filesChanged": 0,
       "linesAdded": 0,
@@ -148,26 +172,48 @@ IF {task} is provided:
   }
   ```
 
-  ### Generate views (auto-regenerate MD from JSON)
-  BASH: `cd {projectRoot} && npx prjct-generate-views --project={projectId}`
-
-  Note: This regenerates views/now.md from data/state.json automatically.
+  ### Convert estimate to seconds
+  IF {estimate} provided:
+    - "30m" → 1800 seconds
+    - "2h" → 7200 seconds
+    - "1d" → 28800 seconds (8 hours)
+    - "2h30m" → 9000 seconds
 
   ### Log to memory
   APPEND to: `{memoryPath}`
   Single line (JSONL):
+
+  IF {estimate} provided:
+  ```json
+  {"timestamp":"{startedAt}","action":"session_started","sessionId":"{sessionId}","task":"{task}","estimate":"{estimate}","estimateSeconds":{estimateInSeconds}}
+  ```
+
+  ELSE:
   ```json
   {"timestamp":"{startedAt}","action":"session_started","sessionId":"{sessionId}","task":"{task}"}
   ```
 
 ## Output
 
-SUCCESS (new task):
+SUCCESS (new task with estimate):
 ```
 🎯 {task}
 
 Session: {sessionId}
 Started: now
+Estimate: {estimate}
+
+/p:done when finished | /p:pause to take a break
+```
+
+SUCCESS (new task without estimate):
+```
+🎯 {task}
+
+Session: {sessionId}
+Started: now
+
+💡 Tip: Add estimate next time with /p:now "task" 2h
 
 /p:done when finished | /p:pause to take a break
 ```
@@ -195,7 +241,7 @@ Status: active
 /p:done to complete | /p:pause to pause
 ```
 
-### Example 2: Start New Task
+### Example 2: Start New Task (without estimate)
 ```
 User: /p:now "Add login form"
 Output:
@@ -204,6 +250,21 @@ Output:
 Session: sess_xyz98765
 Started: now
 
+💡 Tip: Add estimate next time with /p:now "task" 2h
+
+/p:done when finished | /p:pause to take a break
+```
+
+### Example 2b: Start New Task (with estimate)
+```
+User: /p:now "Add login form" 2h
+Output:
+🎯 Add login form
+
+Session: sess_xyz98765
+Started: now
+Estimate: 2h
+
 /p:done when finished | /p:pause to take a break
 ```
 

package/templates/commands/pause.md

@@ -1,17 +1,43 @@
 ---
 allowed-tools: [Read, Write, Bash]
-description: 'Pause current session'
+description: 'Pause current session with reason'
 timestamp-rule: 'GetTimestamp() for all timestamps'
+architecture: 'MD-first - MD files are source of truth'
 ---
 
 # /p:pause - Pause Current Session
 
+## Architecture: MD-First
+
+**Source of Truth**: `core/now.md`, `sessions/current.json`
+
 ## Context Variables
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
 - `{sessionPath}`: `{globalPath}/sessions/current.json`
 - `{nowPath}`: `{globalPath}/core/now.md`
 - `{memoryPath}`: `{globalPath}/memory/context.jsonl`
+- `{reason}`: User-provided reason (optional)
+
+## Pause Reasons
+
+When pausing, capture WHY to enable blocker tracking:
+
+| Reason | Meaning | Dashboard Impact |
+|--------|---------|------------------|
+| `blocked` | Waiting on external dependency | Shows in Blockers list |
+| `switch` | Switching to higher priority task | Context switch metric |
+| `break` | Taking a break | Normal pause |
+| `research` | Need to investigate more | Research time tracked |
+
+If no reason provided, ask:
+```
+Why are you pausing?
+1. blocked - Waiting on something external
+2. switch - Starting a different task
+3. break - Taking a break
+4. research - Need to investigate
+```
 
 ## Step 1: Read Config
 
@@ -40,6 +66,7 @@ IF {session.status} == "paused":
 
   Paused: {elapsed} ago
   Duration so far: {session.duration}
+  Reason: {session.pauseReason}
 
   /p:resume to continue | /p:done to complete
   ```
@@ -49,7 +76,17 @@ IF {session.status} != "active":
   OUTPUT: "⚠️ No active session to pause."
   STOP
 
-## Step 3: Calculate Duration So Far
+## Step 3: Get Pause Reason
+
+IF {reason} not provided:
+  ASK user to select reason (blocked, switch, break, research)
+  OR auto-detect "break" as default
+
+IF {reason} == "blocked":
+  ASK for blocker note: "What's blocking you?"
+  SET: {blockerNote} = user response
+
+## Step 4: Calculate Duration So Far
 
 SET: {now} = GetTimestamp()
 
@@ -60,7 +97,7 @@ For each event in {session.timeline}:
 SET: {duration} = total active seconds
 SET: {durationFormatted} = format as "Xh Ym" or "Xm"
 
-## Step 4: Update Session
+## Step 5: Update Session
 
 UPDATE {session}:
 ```json
@@ -71,12 +108,14 @@ UPDATE {session}:
   "status": "paused",
   "startedAt": "{session.startedAt}",
   "pausedAt": "{now}",
+  "pauseReason": "{reason}",
+  "pauseNote": "{blockerNote}",
   "completedAt": null,
   "duration": {duration},
   "metrics": {session.metrics},
   "timeline": [
     ...{session.timeline},
-    {"type": "pause", "at": "{now}"}
+    {"type": "pause", "at": "{now}", "reason": "{reason}", "note": "{blockerNote}"}
   ]
 }
 ```
@@ -84,7 +123,7 @@ UPDATE {session}:
 WRITE: `{sessionPath}`
 Content: Updated session JSON
 
-## Step 5: Update Legacy now.md
+## Step 6: Update now.md (SOURCE OF TRUTH)
 
 WRITE: `{nowPath}`
 Content:
@@ -96,16 +135,18 @@ Content:
 Started: {session.startedAt}
 Paused: {now}
 Duration: {durationFormatted}
+Reason: {reason}
 Session: {session.id}
+{IF blockerNote: Note: {blockerNote}}
 ```
 
-## Step 6: Log to Memory
+## Step 7: Log to Memory
 
 APPEND to: `{memoryPath}`
 
 Single line (JSONL):
 ```json
-{"timestamp":"{now}","action":"session_paused","sessionId":"{session.id}","task":"{session.task}","duration":{duration}}
+{"timestamp":"{now}","action":"session_paused","sessionId":"{session.id}","task":"{session.task}","duration":{duration},"reason":"{reason}","note":"{blockerNote}"}
 ```
 
 ## Output
@@ -116,6 +157,8 @@ SUCCESS:
 
 Session: {session.id}
 Active time: {durationFormatted}
+Reason: {reason}
+{IF blockerNote: Note: {blockerNote}}
 
 Next:
 • /p:resume - Continue this task
@@ -134,22 +177,27 @@ Next:
 
 ## Examples
 
-### Example 1: Pause Active Session
-**Session:**
-```json
-{
-  "id": "sess_abc12345",
-  "task": "implement auth",
-  "status": "active",
-  "startedAt": "2025-12-07T10:00:00.000Z",
-  "timeline": [
-    {"type": "start", "at": "2025-12-07T10:00:00.000Z"}
-  ]
-}
+### Example 1: Pause with Blocked Reason
+**Input:** `/p:pause blocked`
+**Prompt:** "What's blocking you?"
+**User:** "Waiting for API credentials from vendor"
+
+**Output:**
 ```
+⏸️ Paused: implement auth
 
-**Current time:** 12:30 PM
-**Duration:** 2h 30m
+Session: sess_abc12345
+Active time: 2h 30m
+Reason: blocked
+Note: Waiting for API credentials from vendor
+
+Next:
+• /p:resume - Continue this task
+• /p:now <task> - Start different task
+```
+
+### Example 2: Quick Break
+**Input:** `/p:pause break`
 
 **Output:**
 ```
@@ -157,26 +205,38 @@ Next:
 
 Session: sess_abc12345
 Active time: 2h 30m
+Reason: break
 
 Next:
 • /p:resume - Continue this task
-• /p:now <task> - Start different task
-• /p:done - Complete without resuming
 ```
 
-### Example 2: Already Paused
+### Example 3: Context Switch
+**Input:** `/p:pause switch`
+
 **Output:**
 ```
-⏸️ Already paused: implement auth
+⏸️ Paused: implement auth
 
-Paused: 15m ago
-Duration so far: 2h 30m
+Session: sess_abc12345
+Active time: 2h 30m
+Reason: switch
 
-/p:resume to continue | /p:done to complete
+Next:
+• /p:now <task> - Start the urgent task
 ```
 
-### Example 3: No Active Session
+### Example 4: No Reason (Interactive)
+**Input:** `/p:pause`
+
 **Output:**
 ```
-⚠️ No active session to pause. Use /p:now to start one.
+Why are you pausing?
+
+1. blocked - Waiting on something external
+2. switch - Starting a different task
+3. break - Taking a break
+4. research - Need to investigate
+
+Select [1-4]:
 ```