prjct-cli 0.10.13 → 0.11.0

package/templates/commands/history.md

@@ -0,0 +1,176 @@
+---
+allowed-tools: [Read, Bash]
+description: 'View snapshot history for undo/redo'
+timestamp-rule: 'None required - read-only command'
+---
+
+# /p:history - View Snapshot History
+
+## Overview
+Displays the history of snapshots for the current project. Shows what can be undone/redone.
+
+## Context Variables
+- `{projectId}`: From `.prjct/prjct.config.json`
+- `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{snapshotDir}`: `{globalPath}/snapshots`
+- `{limit}`: Number of snapshots to show (default: 10)
+
+## Step 1: Read Config
+
+READ: `.prjct/prjct.config.json`
+EXTRACT: `projectId`
+
+IF file not found:
+  OUTPUT: "No prjct project. Run /p:init first."
+  STOP
+
+## Step 2: Check Snapshots Exist
+
+BASH: `ls ~/.prjct-cli/projects/{projectId}/snapshots/.git 2>/dev/null || echo "NO_SNAPSHOTS"`
+
+IF output contains "NO_SNAPSHOTS":
+  OUTPUT: "⚠️ No snapshots yet. Create one with /p:ship."
+  STOP
+
+## Step 3: Get Snapshot History
+
+BASH: `cd {snapshotDir} && git log --pretty=format:'%h|%s|%ar|%ai' -n {limit}`
+
+CAPTURE output and parse each line:
+- `{shortHash}`: Before first `|`
+- `{message}`: Between first and second `|`
+- `{relativeTime}`: Between second and third `|`
+- `{absoluteTime}`: After third `|`
+
+## Step 4: Get Current Position
+
+BASH: `cd {snapshotDir} && git rev-parse --short HEAD`
+CAPTURE as {currentHash}
+
+## Step 5: Check Redo Stack
+
+READ: `{snapshotDir}/redo-stack.json`
+
+IF file exists AND not empty AND not "[]":
+  PARSE as JSON array
+  COUNT items as {redoCount}
+ELSE:
+  {redoCount} = 0
+
+## Step 6: Format Output
+
+Build table with columns:
+- `#`: Index (1, 2, 3...)
+- `Hash`: Short hash
+- `Description`: Commit message (first line)
+- `When`: Relative time
+- `Status`: "← current" for current, empty for others
+
+### Table Format
+
+```
+# Snapshot History
+
+| # | Hash    | Description                  | When       |
+|---|---------|------------------------------|------------|
+| 1 | abc1234 | Ship authentication [← NOW]  | 2 hours ago|
+| 2 | def5678 | Add login form               | 5 hours ago|
+| 3 | ghi9012 | Initial setup                | 1 day ago  |
+```
+
+## Output
+
+SUCCESS:
+```
+📜 Snapshot History
+
+| # | Hash    | Description                  | When        |
+|---|---------|------------------------------|-------------|
+{formattedTable}
+
+Current: {currentHash}
+Redo available: {redoCount} snapshot(s)
+
+Commands:
+• /p:undo - Revert to previous snapshot
+• /p:redo - Redo if available ({redoCount})
+• /p:ship - Create new snapshot
+```
+
+## Empty State
+
+IF no snapshots:
+```
+📜 Snapshot History
+
+No snapshots yet.
+
+Create your first snapshot:
+• /p:ship <feature> - Ship a feature and create snapshot
+```
+
+## Examples
+
+### Example 1: Multiple Snapshots
+```
+📜 Snapshot History
+
+| # | Hash    | Description                  | When        |
+|---|---------|------------------------------|-------------|
+| 1 | a1b2c3d | Ship user authentication     | 2 hours ago |
+| 2 | e4f5g6h | Add login form               | 5 hours ago |
+| 3 | i7j8k9l | Setup database models        | 1 day ago   |
+| 4 | m0n1o2p | Initial project setup        | 2 days ago  |
+
+Current: a1b2c3d
+Redo available: 0 snapshot(s)
+
+Commands:
+• /p:undo - Revert to previous snapshot
+• /p:redo - Redo if available (0)
+• /p:ship - Create new snapshot
+```
+
+### Example 2: After Undo
+```
+📜 Snapshot History
+
+| # | Hash    | Description                  | When        |
+|---|---------|------------------------------|-------------|
+| 1 | e4f5g6h | Add login form [← NOW]       | 5 hours ago |
+| 2 | i7j8k9l | Setup database models        | 1 day ago   |
+| 3 | m0n1o2p | Initial project setup        | 2 days ago  |
+
+Current: e4f5g6h
+Redo available: 1 snapshot(s)
+
+Commands:
+• /p:undo - Revert to previous snapshot
+• /p:redo - Redo if available (1)
+• /p:ship - Create new snapshot
+```
+
+### Example 3: No Snapshots
+```
+📜 Snapshot History
+
+No snapshots yet.
+
+Create your first snapshot:
+• /p:ship <feature> - Ship a feature and create snapshot
+```
+
+## Error Handling
+
+| Error | Response | Action |
+|-------|----------|--------|
+| No project | "No prjct project" | STOP |
+| No snapshots | Show empty state | STOP |
+| Git error | Show error message | STOP |
+
+## Notes
+
+- History is read-only, doesn't modify anything
+- Shows relative times for quick scanning
+- Indicates current position in history
+- Shows redo availability count

package/templates/commands/init.md

@@ -1,10 +1,16 @@
 ---
 allowed-tools: [Read, Write, Bash]
 description: 'Initialize prjct'
+timestamp-rule: 'GetTimestamp() for all timestamps'
 ---
 
 # /p:init
 
+## Context Variables
+- `{projectId}`: Generated unique ID (12 chars hex)
+- `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{cwd}`: Current working directory (repository path)
+
 ## Flow
 
 **Existing**: ID → dirs → config → analyze → agents
@@ -16,6 +22,28 @@ description: 'Initialize prjct'
 ## Config
 `.prjct/prjct.config.json`: version, projectId, dataPath, author
 
+## Step: Create project.json (REQUIRED)
+
+This file is the source of truth for the web dashboard. It maps projectId → repoPath.
+
+### Determine Project Name
+- Try package.json → `name` field
+- Try Cargo.toml → `[package] name`
+- Try pyproject.toml → `[project] name`
+- Fallback to directory name (last segment of current path)
+
+WRITE: `{globalPath}/project.json`
+
+```json
+{
+  "projectId": "{projectId}",
+  "repoPath": "{cwd}",
+  "name": "{projectName}",
+  "createdAt": "{GetTimestamp()}",
+  "lastSync": "{GetTimestamp()}"
+}
+```
+
 ## Response
 `✅ Init | {stack} | {N} agents | Next: /p:feature or /p:help`
 
@@ -31,4 +59,3 @@ description: 'Initialize prjct'
 💬 REMEMBER: Talk naturally! "Start with auth" / "Show roadmap" / "Add another feature"
 
 Ready to start building? 🚀
-```

package/templates/commands/now.md

@@ -1,14 +1,196 @@
 ---
-allowed-tools: [Read, Write, GetTimestamp]
-description: 'Current task'
-timestamp-rule: 'GetTimestamp() for timestamps'
+allowed-tools: [Read, Write, Bash]
+description: 'Set or show current task with session tracking'
+timestamp-rule: 'GetTimestamp() for ALL timestamps'
 ---
 
-# /p:now
+# /p:now - Current Task with Session Tracking
 
-## Flow
-**Show**: Read `core/now.md`
-**Set**: Write now.md + {GetTimestamp()} → Log
+## Context Variables
+- `{projectId}`: From `.prjct/prjct.config.json`
+- `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
+- `{nowPath}`: `{globalPath}/core/now.md`
+- `{sessionPath}`: `{globalPath}/sessions/current.json`
+- `{memoryPath}`: `{globalPath}/memory/context.jsonl`
+- `{task}`: User-provided task (optional)
 
-## Response
-`🎯 {task} | Started: {time} | Done: /p:done`
+## Step 1: Read Config
+
+READ: `.prjct/prjct.config.json`
+EXTRACT: `projectId`
+
+IF file not found:
+  OUTPUT: "No prjct project. Run /p:init first."
+  STOP
+
+## Step 2: Check Current State
+
+### Check for active session
+READ: `{sessionPath}`
+
+IF file exists:
+  PARSE as JSON
+  EXTRACT: {currentTask}, {status}, {startedAt}, {duration}
+
+### Check now.md
+READ: `{nowPath}`
+
+## Step 3: Handle Cases
+
+### Case A: No task provided - Show current
+IF {task} is empty OR not provided:
+  IF {currentTask} exists AND {status} == "active":
+    CALCULATE: {elapsed} = time since {startedAt}
+    OUTPUT:
+    ```
+    🎯 {currentTask}
+
+    Session: {sessionId}
+    Started: {startedAt} ({elapsed} ago)
+    Status: active
+
+    /p:done to complete | /p:pause to pause
+    ```
+    STOP
+  ELSE IF {currentTask} exists AND {status} == "paused":
+    OUTPUT:
+    ```
+    ⏸️ Paused: {currentTask}
+
+    Duration so far: {duration}
+
+    /p:resume to continue | /p:done to complete
+    ```
+    STOP
+  ELSE:
+    OUTPUT: "No current task. Use /p:now <task> to start one."
+    STOP
+
+### Case B: Task provided - Create/Update session
+IF {task} is provided:
+
+  ## Check for existing active session
+  IF {status} == "active" AND {currentTask} != {task}:
+    OUTPUT:
+    ```
+    ⚠️ Already working on: {currentTask}
+
+    Options:
+    • /p:done - Complete current task first
+    • /p:pause - Pause and switch
+    • /p:now (same task) - Continue current
+    ```
+    STOP
+
+  ## If same task, just continue
+  IF {currentTask} == {task}:
+    OUTPUT: "🎯 Continuing: {task}"
+    STOP
+
+  ## Create new session
+  GENERATE: {sessionId} = "sess_" + 8 random alphanumeric chars
+  SET: {startedAt} = GetTimestamp()
+
+  ### Create session JSON
+  WRITE: `{sessionPath}`
+  Content:
+  ```json
+  {
+    "id": "{sessionId}",
+    "projectId": "{projectId}",
+    "task": "{task}",
+    "status": "active",
+    "startedAt": "{startedAt}",
+    "pausedAt": null,
+    "completedAt": null,
+    "duration": 0,
+    "metrics": {
+      "filesChanged": 0,
+      "linesAdded": 0,
+      "linesRemoved": 0,
+      "commits": 0,
+      "snapshots": []
+    },
+    "timeline": [
+      {"type": "start", "at": "{startedAt}"}
+    ]
+  }
+  ```
+
+  ### Update now.md (legacy support)
+  WRITE: `{nowPath}`
+  Content:
+  ```markdown
+  # NOW
+
+  **{task}**
+
+  Started: {startedAt}
+  Session: {sessionId}
+  ```
+
+  ### Log to memory
+  APPEND to: `{memoryPath}`
+  Single line (JSONL):
+  ```json
+  {"timestamp":"{startedAt}","action":"session_started","sessionId":"{sessionId}","task":"{task}"}
+  ```
+
+## Output
+
+SUCCESS (new task):
+```
+🎯 {task}
+
+Session: {sessionId}
+Started: now
+
+/p:done when finished | /p:pause to take a break
+```
+
+## Error Handling
+
+| Error | Response | Action |
+|-------|----------|--------|
+| No project | "No prjct project" | STOP |
+| Active session exists | Show options | STOP |
+| Write fails | "Failed to create session" | STOP |
+
+## Examples
+
+### Example 1: Show Current Task
+```
+User: /p:now
+Output:
+🎯 Implement user authentication
+
+Session: sess_abc12345
+Started: 2 hours ago
+Status: active
+
+/p:done to complete | /p:pause to pause
+```
+
+### Example 2: Start New Task
+```
+User: /p:now "Add login form"
+Output:
+🎯 Add login form
+
+Session: sess_xyz98765
+Started: now
+
+/p:done when finished | /p:pause to take a break
+```
+
+### Example 3: Task Conflict
+```
+User: /p:now "Something else"
+Output:
+⚠️ Already working on: Add login form
+
+Options:
+• /p:done - Complete current task first
+• /p:pause - Pause and switch
+• /p:now (same task) - Continue current
+```

package/templates/commands/pause.md

@@ -1,18 +1,182 @@
 ---
-allowed-tools: [Read, Write, GetTimestamp]
-description: 'Pause task'
-timestamp-rule: 'GetTimestamp() for paused'
+allowed-tools: [Read, Write, Bash]
+description: 'Pause current session'
+timestamp-rule: 'GetTimestamp() for all timestamps'
 ---
 
-# /p:pause
+# /p:pause - Pause Current Session
 
-## Check
-Requires active in `core/stack.jsonl`
+## 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`
 
-## Flow
-1. Find active → Set status='paused', paused={GetTimestamp()}
-2. Update stack.jsonl + now.md
-3. Log: `{"ts":"{GetTimestamp()}","type":"task_pause","task":"{t}"}`
+## Step 1: Read Config
 
-## Response
-`⏸️ {task} | Active: {duration} | Resume: /p:resume`
+READ: `.prjct/prjct.config.json`
+EXTRACT: `projectId`
+
+IF file not found:
+  OUTPUT: "No prjct project. Run /p:init first."
+  STOP
+
+## Step 2: Check Session State
+
+READ: `{sessionPath}`
+
+IF file not found OR empty:
+  OUTPUT: "⚠️ No active session to pause. Use /p:now to start one."
+  STOP
+
+PARSE as JSON → {session}
+
+IF {session.status} == "paused":
+  CALCULATE: {elapsed} = time since {session.pausedAt}
+  OUTPUT:
+  ```
+  ⏸️ Already paused: {session.task}
+
+  Paused: {elapsed} ago
+  Duration so far: {session.duration}
+
+  /p:resume to continue | /p:done to complete
+  ```
+  STOP
+
+IF {session.status} != "active":
+  OUTPUT: "⚠️ No active session to pause."
+  STOP
+
+## Step 3: Calculate Duration So Far
+
+SET: {now} = GetTimestamp()
+
+For each event in {session.timeline}:
+  Track start/resume/pause times
+  Calculate total active time up to now
+
+SET: {duration} = total active seconds
+SET: {durationFormatted} = format as "Xh Ym" or "Xm"
+
+## Step 4: Update Session
+
+UPDATE {session}:
+```json
+{
+  "id": "{session.id}",
+  "projectId": "{session.projectId}",
+  "task": "{session.task}",
+  "status": "paused",
+  "startedAt": "{session.startedAt}",
+  "pausedAt": "{now}",
+  "completedAt": null,
+  "duration": {duration},
+  "metrics": {session.metrics},
+  "timeline": [
+    ...{session.timeline},
+    {"type": "pause", "at": "{now}"}
+  ]
+}
+```
+
+WRITE: `{sessionPath}`
+Content: Updated session JSON
+
+## Step 5: Update Legacy now.md
+
+WRITE: `{nowPath}`
+Content:
+```markdown
+# NOW
+
+⏸️ **{session.task}** (paused)
+
+Started: {session.startedAt}
+Paused: {now}
+Duration: {durationFormatted}
+Session: {session.id}
+```
+
+## Step 6: Log to Memory
+
+APPEND to: `{memoryPath}`
+
+Single line (JSONL):
+```json
+{"timestamp":"{now}","action":"session_paused","sessionId":"{session.id}","task":"{session.task}","duration":{duration}}
+```
+
+## Output
+
+SUCCESS:
+```
+⏸️ Paused: {session.task}
+
+Session: {session.id}
+Active time: {durationFormatted}
+
+Next:
+• /p:resume - Continue this task
+• /p:now <task> - Start different task
+• /p:done - Complete without resuming
+```
+
+## Error Handling
+
+| Error | Response | Action |
+|-------|----------|--------|
+| No project | "No prjct project" | STOP |
+| No session | "No active session" | STOP |
+| Already paused | Show paused state | STOP |
+| Write fails | Log warning | CONTINUE |
+
+## 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"}
+  ]
+}
+```
+
+**Current time:** 12:30 PM
+**Duration:** 2h 30m
+
+**Output:**
+```
+⏸️ Paused: implement auth
+
+Session: sess_abc12345
+Active time: 2h 30m
+
+Next:
+• /p:resume - Continue this task
+• /p:now <task> - Start different task
+• /p:done - Complete without resuming
+```
+
+### Example 2: Already Paused
+**Output:**
+```
+⏸️ Already paused: implement auth
+
+Paused: 15m ago
+Duration so far: 2h 30m
+
+/p:resume to continue | /p:done to complete
+```
+
+### Example 3: No Active Session
+**Output:**
+```
+⚠️ No active session to pause. Use /p:now to start one.
+```