prjct-cli 0.10.0 → 0.10.3

package/core/context-sync.js

@@ -0,0 +1,183 @@
+/**
+ * Context Sync - Generates dynamic project context for Claude
+ *
+ * Creates ~/.prjct-cli/projects/{id}/CLAUDE.md with:
+ * - Stack info
+ * - Available agents (dynamic, varies per project)
+ * - Current task
+ * - Priority queue
+ *
+ * Called by: /p:sync, /p:analyze, /p:init
+ */
+
+const fs = require('fs').promises
+const path = require('path')
+const os = require('os')
+
+/**
+ * Generate project context file for Claude
+ * 100% DYNAMIC - reads whatever agents exist
+ *
+ * @param {string} projectPath - Local project path
+ * @param {string} projectId - Project ID from config
+ * @returns {Promise<{agents: string[], stack: string|null, currentTask: string|null}>}
+ */
+async function generateLocalContext(projectPath, projectId) {
+  const globalPath = path.join(os.homedir(), '.prjct-cli/projects', projectId)
+
+  // 1. Read ALL agents that exist (dynamic - varies per project)
+  const agentsDir = path.join(globalPath, 'agents')
+  let agentFiles = []
+  try {
+    agentFiles = await fs.readdir(agentsDir)
+    agentFiles = agentFiles.filter(f => f.endsWith('.md'))
+  } catch {
+    // No agents directory yet
+  }
+
+  // 2. Read core files (may not exist)
+  const readSafe = async (p) => {
+    try {
+      return await fs.readFile(p, 'utf-8')
+    } catch {
+      return null
+    }
+  }
+
+  const [repoSummary, now, next, roadmap] = await Promise.all([
+    readSafe(path.join(globalPath, 'analysis/repo-summary.md')),
+    readSafe(path.join(globalPath, 'core/now.md')),
+    readSafe(path.join(globalPath, 'core/next.md')),
+    readSafe(path.join(globalPath, 'planning/roadmap.md'))
+  ])
+
+  // 3. Extract stack from repo-summary
+  const stack = extractStack(repoSummary)
+
+  // 4. Generate agent list with clean names
+  const agents = agentFiles.map(f => f.replace('.md', ''))
+
+  // 5. Extract current task
+  const currentTask = extractCurrentTask(now)
+
+  // 6. Extract top 3 from next.md
+  const nextTasks = extractTopTasks(next, 3)
+
+  // 7. Extract active features from roadmap
+  const activeFeatures = extractActiveFeatures(roadmap)
+
+  // 8. Generate CLAUDE.md content
+  const content = `# Project Context
+<!-- Auto-generated by /p:sync - DO NOT EDIT -->
+<!-- projectId: ${projectId} -->
+<!-- Last sync: ${new Date().toISOString()} -->
+
+## Stack
+${stack || 'Run /p:analyze to detect stack'}
+
+## Available Agents
+${agents.length ? agents.map(a => `- ${a}`).join('\n') : 'None. Run /p:sync to generate.'}
+
+## Current Task
+${currentTask || 'None. Use /p:now to start.'}
+
+## Next Up
+${nextTasks.length ? nextTasks.map((t, i) => `${i + 1}. ${t}`).join('\n') : 'Empty queue.'}
+
+## Active Features
+${activeFeatures.length ? activeFeatures.map(f => `- ${f}`).join('\n') : 'None in progress.'}
+
+## Data Location
+All project data: ~/.prjct-cli/projects/${projectId}/
+- agents/ - Read for detailed patterns and code examples
+- analysis/repo-summary.md - Full technical analysis
+- planning/roadmap.md - Features and roadmap
+`
+
+  // 9. Write to global storage (NOT in repo)
+  const contextPath = path.join(globalPath, 'CLAUDE.md')
+  await fs.writeFile(contextPath, content, 'utf-8')
+
+  return { agents, stack, currentTask }
+}
+
+/**
+ * Extract stack from repo-summary
+ */
+function extractStack(summary) {
+  if (!summary) return null
+
+  // Try multiple patterns
+  const patterns = [
+    /\*\*(?:Stack|Framework|Language)\*\*[:\s|]+([^\n|]+)/i,
+    /\| \*\*Type\*\* \| ([^\|]+) \|/i,
+    /## Tech Stack[\s\S]*?### (?:Frontend|Backend)\n- \*\*([^*]+)\*\*/i
+  ]
+
+  for (const pattern of patterns) {
+    const match = summary.match(pattern)
+    if (match) return match[1].trim()
+  }
+
+  return null
+}
+
+/**
+ * Extract current task from now.md
+ */
+function extractCurrentTask(now) {
+  if (!now) return null
+
+  // Skip headers and empty lines, get first content line
+  const lines = now.split('\n')
+  for (const line of lines) {
+    const trimmed = line.trim()
+    if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('<!--')) {
+      return trimmed
+    }
+  }
+  return null
+}
+
+/**
+ * Extract top N tasks from next.md
+ */
+function extractTopTasks(next, count) {
+  if (!next) return []
+
+  return next
+    .split('\n')
+    .filter(l => l.match(/^[-*\d.]\s/))
+    .slice(0, count)
+    .map(l => l.replace(/^[-*\d.]\s+/, '').trim())
+    .filter(Boolean)
+}
+
+/**
+ * Extract active features from roadmap.md
+ */
+function extractActiveFeatures(roadmap) {
+  if (!roadmap) return []
+
+  const features = []
+  const lines = roadmap.split('\n')
+  let inActive = false
+
+  for (const line of lines) {
+    if (line.includes('Active') || line.includes('In Progress')) {
+      inActive = true
+      continue
+    }
+    if (line.startsWith('## ') && inActive) {
+      break // End of active section
+    }
+    if (inActive && line.match(/^- \[ \]/)) {
+      const feature = line.replace(/^- \[ \]\s*\*\*/, '').replace(/\*\*.*$/, '').trim()
+      if (feature) features.push(feature)
+    }
+  }
+
+  return features.slice(0, 3) // Max 3
+}
+
+module.exports = { generateLocalContext }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.10.0",
+  "version": "0.10.3",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {
@@ -15,18 +15,14 @@
     "update-commands": "node -e \"const installer = require('./core/infrastructure/command-installer'); installer.syncCommands().then(r => console.log('Commands updated:', r)).catch(e => console.error('Error:', e.message))\"",
     "install-global": "./scripts/install.sh",
     "update": "./scripts/update.sh",
-    "test": "vitest run --workspace=vitest.workspace.js",
-    "test:watch": "vitest --workspace=vitest.workspace.js",
-    "test:coverage": "vitest run --coverage --workspace=vitest.workspace.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "validate": "node scripts/validate-commands.js",
-    "lint": "eslint \"**/*.js\" --ignore-pattern \"node_modules/**\" --ignore-pattern \"website/**\"",
-    "lint:fix": "eslint \"**/*.js\" --fix --ignore-pattern \"node_modules/**\" --ignore-pattern \"website/**\"",
+    "lint": "eslint . --ignore-pattern node_modules",
+    "lint:fix": "eslint . --fix --ignore-pattern node_modules",
     "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,css,md}\" --config .config/.prettierrc --ignore-path .config/.prettierignore",
-    "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,css,md}\" --config .config/.prettierrc --ignore-path .config/.prettierignore",
-    "website:dev": "cd website && npm run dev",
-    "website:build": "cd website && npm run build",
-    "website:preview": "cd website && npm run preview",
-    "website:install": "cd website && npm install"
+    "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,css,md}\" --config .config/.prettierrc --ignore-path .config/.prettierignore"
   },
   "keywords": [
     "claude-code",
@@ -48,7 +44,6 @@
     "prompts": "^2.4.2"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
     "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
@@ -56,10 +51,7 @@
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-n": "^16.6.2",
     "eslint-plugin-promise": "^6.6.0",
-    "jsdom": "^27.0.0",
     "prettier": "^3.6.2",
-    "prettier-plugin-tailwindcss": "^0.6.14",
-    "typescript": "^5.0.0",
     "vitest": "^3.2.4"
   },
   "repository": {

package/templates/commands/done.md

@@ -1,10 +1,17 @@
 ---
 allowed-tools: [Read, Write]
 description: 'Complete task'
+think-triggers: [report_complete]
 ---
 
 # /p:done
 
+## Think First
+Before marking complete, verify:
+1. Is the task actually finished?
+2. Were all acceptance criteria met?
+3. Should this trigger a /p:ship?
+
 ## Check
 Requires: `core/now.md` has content
 

package/templates/commands/feature.md

@@ -2,10 +2,18 @@
 allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
 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
 
+## 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?
+
 ## Flow
 
 1. **Value**: Impact/effort/timing → do_now/defer/blocked

package/templates/commands/ship.md

@@ -2,10 +2,18 @@
 allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
 description: 'Ship feature workflow'
 timestamp-rule: 'GetTimestamp() and GetDate() for timestamps'
+think-triggers: [git_decision, report_complete]
 ---
 
 # /p:ship
 
+## 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?
+
 ## Workflow (non-blocking)
 1. Lint → Tests → Docs update
 2. Version bump → CHANGELOG

package/templates/commands/spec.md

@@ -0,0 +1,128 @@
+---
+allowed-tools: [Read, Write, Glob, GetTimestamp, GetDate]
+description: 'Spec-driven development for complex features'
+timestamp-rule: 'GetTimestamp() and GetDate() for ALL timestamps'
+think-triggers: [explore_to_edit, complex_analysis]
+---
+
+# /p:spec
+
+Spec-Driven Development. Creates detailed specifications for complex features before implementation.
+
+## Think First
+Before creating spec, analyze:
+1. Is this feature complex enough for a spec? (auth, payments, migrations = yes)
+2. What are the key architectural decisions to make?
+3. Are there multiple valid approaches? Document tradeoffs.
+4. What questions should I ask the user before proceeding?
+
+## Purpose
+
+For features that require:
+- Clear requirements before coding
+- Design decisions documented
+- Tasks broken into 20-30 min chunks
+- User approval before starting
+
+## Flow
+
+### No params: Show template
+```
+→ Interactive spec template
+→ Ask for feature name
+→ Guide through requirements
+```
+
+### With feature name: Create spec
+```
+/p:spec "Dark Mode"
+1. Analyze: Context, patterns, dependencies
+2. Propose: Requirements + Design + Tasks
+3. Write: `planning/specs/{slug}.md`
+4. Ask: User approval
+5. On approve: Add tasks to queue, start first
+```
+
+## Spec Structure
+
+```markdown
+# Feature Spec: {name}
+
+**Created**: {GetDate()}
+**Status**: PENDING_APPROVAL | APPROVED | IN_PROGRESS | COMPLETED
+
+## Requirements (User approves)
+- [ ] Requirement 1
+- [ ] Requirement 2
+- [ ] Requirement 3
+
+## Design (Claude proposes)
+- **Approach**: {architecture decision}
+- **Key decisions**: {list}
+- **Dependencies**: {existing code/libs}
+
+## Tasks (20-30min each)
+1. [ ] Task 1 (20m) - {description}
+2. [ ] Task 2 (25m) - {description}
+3. [ ] Task 3 (30m) - {description}
+
+**Total**: {n} tasks, ~{Xh}
+
+## Notes
+- {implementation notes}
+- {edge cases to consider}
+```
+
+## Validation
+
+- Feature name required for creation
+- Spec must have at least 1 requirement
+- Each task should be 20-30 minutes
+- Check for existing spec with same name
+
+## Data
+
+Session: `{"ts":"{GetTimestamp()}","type":"spec_create","name":"{feature}","requirements":{n},"tasks":{n},"effort":"{Xh}"}`
+Spec file: `planning/specs/{feature-slug}.md`
+
+## Response
+
+### On creation:
+```
+📋 Spec: {feature}
+
+Requirements ({n}):
+{numbered_list}
+
+Design:
+→ {approach}
+→ {key_decision}
+
+Tasks ({n}, ~{total_time}):
+{numbered_list}
+
+APPROVE? (y/n/edit)
+```
+
+### On approval:
+```
+✅ Spec approved: {feature}
+→ {n} tasks added to queue
+→ Starting: {task_1}
+
+Use /p:done when complete
+```
+
+## Examples
+
+```
+/p:spec "User Authentication"
+→ Creates spec with OAuth/JWT decisions
+→ Breaks into: setup, login, logout, session, tests
+→ Estimates ~4h total
+
+/p:spec "Dark Mode"
+→ Creates spec with theme approach
+→ Breaks into: toggle, state, styles, persist, test
+→ Estimates ~3h total
+```

package/templates/global/CLAUDE.md

@@ -5,6 +5,23 @@ This section provides global context for all `/p:*` commands across any prjct pr
 
 **Auto-managed by prjct-cli** - This section is automatically updated when you install or update prjct.
 
+## 🤖 Project Context (OBLIGATORIO)
+
+**ANTES de trabajar en un proyecto prjct, LEE el contexto del proyecto:**
+
+1. Lee `.prjct/prjct.config.json` → obtén `projectId`
+2. Lee `~/.prjct-cli/projects/{projectId}/CLAUDE.md` → contexto dinámico del proyecto
+3. Para detalles de implementación, lee los archivos en `agents/`
+
+El archivo `CLAUDE.md` del proyecto contiene:
+- Stack detectado del proyecto
+- Agentes disponibles (varían por proyecto)
+- Tarea actual
+- Cola de prioridades
+- Rutas a documentación detallada
+
+**Si no existe CLAUDE.md**: Sugiere ejecutar `/p:sync` para generarlo.
+
 ## 🎯 Path Resolution for ALL /p:* Commands
 
 **CRITICAL**: Every `/p:*` command operates on **global storage**, NOT local files.