prjct-cli 0.11.5 → 0.12.0

package/templates/commands/ship.md

@@ -2,14 +2,22 @@
 allowed-tools: [Read, Write, Bash]
 description: 'Ship feature with automated workflow'
 timestamp-rule: 'GetTimestamp() and GetDate() for ALL timestamps'
+architecture: 'JSON-first - Write to data/*.json, views are generated'
 ---
 
 # /p:ship - Ship Feature Workflow
 
+## Architecture: JSON-First
+
+**Source of Truth**: `data/shipped.json`, `data/roadmap.json`
+**Generated Views**: `views/shipped.md`, `views/roadmap.md` (auto-generated)
+
 ## Context Variables
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
-- `{shippedPath}`: `{globalPath}/progress/shipped.md`
+- `{dataPath}`: `{globalPath}/data`
+- `{shippedPath}`: `{dataPath}/shipped.json`
+- `{roadmapPath}`: `{dataPath}/roadmap.json`
 - `{memoryPath}`: `{globalPath}/memory/context.jsonl`
 - `{snapshotDir}`: `{globalPath}/snapshots`
 - `{feature}`: User-provided feature name
@@ -144,51 +152,82 @@ IF contains "rejected" OR contains "failed":
 IF contains "no upstream":
   BASH: `git push -u origin HEAD`
 
-## Step 8: Log to Session
+## Step 8: Update Shipped (JSON)
 
-GET: {date} = GetDate()
-EXTRACT: {yearMonth} = YYYY-MM from {date}
+SET: {now} = GetTimestamp()
+GENERATE: {shipId} = "ship_" + 8 random alphanumeric chars
 
-ENSURE directory exists:
-BASH: `mkdir -p {globalPath}/progress/sessions/{yearMonth}`
+READ: `{shippedPath}` (or create default if not exists)
+
+Default structure:
+```json
+{
+  "items": [],
+  "lastUpdated": ""
+}
+```
 
-APPEND to: `{globalPath}/progress/sessions/{yearMonth}/{date}.jsonl`
+### Get changes from git
+BASH: `git log --oneline -5`
+CAPTURE commit messages as {changes}
 
-Single line (JSONL):
+### Create shipped item
+```json
+{
+  "id": "{shipId}",
+  "name": "{feature}",
+  "version": "{newVersion}",
+  "type": "feature",
+  "changes": [{changes as array}],
+  "metrics": {
+    "lintStatus": "{lintStatus}",
+    "testStatus": "{testStatus}"
+  },
+  "shippedAt": "{now}"
+}
+```
+
+### Update shipped.json
 ```json
-{"ts":"{GetTimestamp()}","type":"feature_ship","name":"{feature}","version":"{newVersion}","lint":"{lintStatus}","tests":"{testStatus}"}
+{
+  "items": [
+    {new shipped item},
+    ...existing items
+  ],
+  "lastUpdated": "{now}"
+}
 ```
 
-## Step 9: Update Shipped Index
+WRITE: `{shippedPath}`
 
-READ: `{shippedPath}` (create if not exists)
+## Step 9: Update Roadmap Status (JSON)
 
-### Format New Entry
+READ: `{roadmapPath}`
 
-```markdown
-## {GetDate()} - {feature}
-- Version: {newVersion}
-- Lint: {lintStatus} | Tests: {testStatus}
-```
+### Find matching feature and update status
+For feature matching {feature}:
+  Set status = "shipped"
+  Set shippedAt = "{now}"
+  Set version = "{newVersion}"
 
-INSERT at top (after # Shipped header)
+WRITE: `{roadmapPath}`
 
-### Archive Old Entries
-IF file has entries older than 30 days:
-  MOVE old entries to: `{globalPath}/progress/archive/shipped-{yearMonth}.md`
+## Step 10: Generate Views
 
-WRITE: `{shippedPath}`
+BASH: `cd {projectRoot} && npx prjct-generate-views --project={projectId}`
+
+Note: This regenerates views/shipped.md, views/roadmap.md from JSON automatically.
 
-## Step 10: Log to Memory
+## Step 11: Log to Memory
 
 APPEND to: `{memoryPath}`
 
 Single line (JSONL):
 ```json
-{"timestamp":"{GetTimestamp()}","action":"feature_shipped","feature":"{feature}","version":"{newVersion}"}
+{"timestamp":"{now}","action":"feature_shipped","shipId":"{shipId}","feature":"{feature}","version":"{newVersion}"}
 ```
 
-## Step 11: Create Snapshot (Undo/Redo Support)
+## Step 12: Create Snapshot (Undo/Redo Support)
 
 This creates a snapshot for the undo/redo system.
 

package/templates/commands/sync.md

@@ -2,10 +2,19 @@
 allowed-tools: [Read, Write, Bash, Glob, Grep]
 description: 'Sync state + generate agents + detect patterns'
 timestamp-rule: 'GetTimestamp() for all timestamps'
+architecture: 'JSON-first - Write to data/*.json, views are generated'
 ---
 
 # /p:sync - Sync Project State
 
+## Architecture: JSON-First
+
+This command:
+1. Analyzes the repository
+2. Generates agents
+3. Updates `data/project.json` (source of truth)
+4. Regenerates all MD views from JSON
+
 ## Context Variables
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
@@ -181,7 +190,7 @@ IF exists:
 
   WRITE: `{globalPath}/CLAUDE.md`
 
-## Step 6: Update project.json
+## Step 6: Update project.json (in data/)
 
 This file is the source of truth for the web dashboard. It maps projectId → repoPath.
 
@@ -191,7 +200,7 @@ This file is the source of truth for the web dashboard. It maps projectId → re
 - Try pyproject.toml → `[project] name`
 - Fallback to directory name (last segment of current path)
 
-WRITE: `{globalPath}/project.json`
+WRITE: `{globalPath}/data/project.json`
 
 ```json
 {
@@ -214,7 +223,23 @@ WRITE: `{globalPath}/project.json`
 
 NOTE: If project.json already exists, preserve `createdAt` field. Always update `lastSync` and `techStack`.
 
-## Step 7: Log to Memory
+Also write to root for backwards compatibility:
+WRITE: `{globalPath}/project.json` (same content)
+
+## Step 7: Generate Views from JSON
+
+Regenerate all MD views from the JSON source of truth:
+
+BASH: `cd {projectRoot} && npx prjct-generate-views --project={projectId}`
+
+This ensures:
+- views/now.md reflects data/state.json
+- views/next.md reflects data/queue.json
+- views/ideas.md reflects data/ideas.json
+- views/roadmap.md reflects data/roadmap.json
+- views/shipped.md reflects data/shipped.json
+
+## Step 8: Log to Memory
 
 APPEND to: `{memoryPath}`
 

package/core/agentic/agent-router.js

@@ -1,140 +0,0 @@
-/**
- * Agent Router
- * Orchestrates agent loading and context building for Claude delegation.
- *
- * @module agentic/agent-router
- * @version 2.0.0
- */
-
-const fs = require('fs').promises
-const path = require('path')
-const configManager = require('../infrastructure/config-manager')
-const pathManager = require('../infrastructure/path-manager')
-
-/**
- * Routes tasks to specialized agents based on Claude's decisions.
- * Handles agent loading, context building, and usage logging.
- */
-class AgentRouter {
-  constructor() {
-    /** @type {string|null} */
-    this.projectId = null
-    /** @type {string|null} */
-    this.agentsPath = null
-  }
-
-  /**
-   * Initialize router with project context
-   *
-   * @param {string} projectPath - Path to the project
-   */
-  async initialize(projectPath) {
-    this.projectId = await configManager.getProjectId(projectPath)
-    this.agentsPath = pathManager.getPath(this.projectId, 'agents')
-  }
-
-  /**
-   * Load all available agents from project
-   *
-   * @returns {Promise<Array<{name: string, content: string}>>} Available agents
-   */
-  async loadAvailableAgents() {
-    try {
-      const files = await fs.readdir(this.agentsPath)
-      const agents = []
-
-      for (const file of files) {
-        if (file.endsWith('.md')) {
-          const name = file.replace('.md', '')
-          const content = await fs.readFile(
-            path.join(this.agentsPath, file),
-            'utf-8'
-          )
-          agents.push({ name, content })
-        }
-      }
-
-      return agents
-    } catch {
-      return []
-    }
-  }
-
-  /**
-   * Get list of available agent names
-   *
-   * @returns {Promise<string[]>} Agent names
-   */
-  async getAgentNames() {
-    const agents = await this.loadAvailableAgents()
-    return agents.map(a => a.name)
-  }
-
-  /**
-   * Load a specific agent by name
-   *
-   * @param {string} name - Agent name (without .md extension)
-   * @returns {Promise<{name: string, content: string}|null>} Agent or null
-   */
-  async loadAgent(name) {
-    try {
-      const filePath = path.join(this.agentsPath, `${name}.md`)
-      const content = await fs.readFile(filePath, 'utf-8')
-      return { name, content }
-    } catch {
-      return null
-    }
-  }
-
-  /**
-   * Build context for Claude to decide agent assignment
-   *
-   * @param {string|Object} task - Task description or object
-   * @param {string} projectPath - Project path
-   * @returns {Promise<Object>} Assignment context for Claude
-   */
-  async buildAssignmentContext(task, projectPath) {
-    const agents = await this.getAgentNames()
-
-    return {
-      task: task.description || task,
-      availableAgents: agents,
-      projectPath,
-      projectId: this.projectId,
-      // Claude reads this and decides via template
-      _template: 'templates/agent-assignment.md'
-    }
-  }
-
-  /**
-   * Log agent usage to JSONL file
-   *
-   * @param {string|Object} task - Task description
-   * @param {string|Object} agent - Agent used
-   * @param {string} projectPath - Project path (unused, kept for API compat)
-   */
-  async logUsage(task, agent, projectPath) {
-    try {
-      const logPath = path.join(
-        process.env.HOME,
-        '.prjct-cli',
-        'projects',
-        this.projectId,
-        'agent-usage.jsonl'
-      )
-
-      const entry = JSON.stringify({
-        timestamp: new Date().toISOString(),
-        task: typeof task === 'string' ? task : task.description,
-        agent: agent.name || agent,
-        projectId: this.projectId
-      }) + '\n'
-
-      await fs.appendFile(logPath, entry)
-    } catch {
-      // Silent fail for logging
-    }
-  }
-}
-
-module.exports = AgentRouter