prjct-cli 0.45.0 → 0.45.3

package/core/services/agent-generator.ts

@@ -0,0 +1,237 @@
+/**
+ * AgentGenerator - Domain and workflow agent generation
+ *
+ * Extracted from sync-service.ts for single responsibility.
+ * Generates agent markdown files based on project stack.
+ *
+ * @version 1.0.0
+ */
+
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import type { StackDetection } from './stack-detector'
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface AgentInfo {
+  name: string
+  type: 'workflow' | 'domain'
+  skill?: string
+}
+
+export interface ProjectStats {
+  fileCount: number
+  version: string
+  name: string
+  ecosystem: string
+  projectType: string
+  languages: string[]
+  frameworks: string[]
+}
+
+// ============================================================================
+// AGENT GENERATOR CLASS
+// ============================================================================
+
+export class AgentGenerator {
+  private agentsPath: string
+  private templatesPath: string
+
+  constructor(agentsPath: string, templatesPath?: string) {
+    this.agentsPath = agentsPath
+    this.templatesPath = templatesPath || path.join(__dirname, '..', '..', 'templates', 'subagents')
+  }
+
+  /**
+   * Generate all agents based on stack detection
+   */
+  async generate(stack: StackDetection, stats: ProjectStats): Promise<AgentInfo[]> {
+    const agents: AgentInfo[] = []
+
+    // Purge old agents
+    await this.purgeOldAgents()
+
+    // Workflow agents (always generated) - IN PARALLEL
+    const workflowAgents = await this.generateWorkflowAgents()
+    agents.push(...workflowAgents)
+
+    // Domain agents (based on stack) - IN PARALLEL
+    const domainAgents = await this.generateDomainAgents(stack, stats)
+    agents.push(...domainAgents)
+
+    return agents
+  }
+
+  /**
+   * Remove existing agent files
+   */
+  private async purgeOldAgents(): Promise<void> {
+    try {
+      const files = await fs.readdir(this.agentsPath)
+      await Promise.all(
+        files
+          .filter((file) => file.endsWith('.md'))
+          .map((file) => fs.unlink(path.join(this.agentsPath, file)))
+      )
+    } catch {
+      // Directory might not exist yet
+    }
+  }
+
+  /**
+   * Generate workflow agents (always included)
+   */
+  private async generateWorkflowAgents(): Promise<AgentInfo[]> {
+    const workflowAgentNames = ['prjct-workflow', 'prjct-planner', 'prjct-shipper']
+
+    await Promise.all(workflowAgentNames.map((name) => this.generateWorkflowAgent(name)))
+
+    return workflowAgentNames.map((name) => ({ name, type: 'workflow' as const }))
+  }
+
+  /**
+   * Generate domain agents based on stack
+   */
+  private async generateDomainAgents(
+    stack: StackDetection,
+    stats: ProjectStats
+  ): Promise<AgentInfo[]> {
+    const agentsToGenerate: { name: string; skill?: string }[] = []
+
+    if (stack.hasFrontend) {
+      agentsToGenerate.push({ name: 'frontend', skill: 'javascript-typescript' })
+      agentsToGenerate.push({ name: 'uxui', skill: 'frontend-design' })
+    }
+    if (stack.hasBackend) {
+      agentsToGenerate.push({ name: 'backend', skill: 'javascript-typescript' })
+    }
+    if (stack.hasDatabase) {
+      agentsToGenerate.push({ name: 'database' })
+    }
+    if (stack.hasTesting) {
+      agentsToGenerate.push({ name: 'testing', skill: 'developer-kit' })
+    }
+    if (stack.hasDocker) {
+      agentsToGenerate.push({ name: 'devops', skill: 'developer-kit' })
+    }
+
+    // Generate all domain agents IN PARALLEL
+    await Promise.all(
+      agentsToGenerate.map((agent) => this.generateDomainAgent(agent.name, stats, stack))
+    )
+
+    return agentsToGenerate.map((agent) => ({
+      name: agent.name,
+      type: 'domain' as const,
+      skill: agent.skill,
+    }))
+  }
+
+  /**
+   * Generate a single workflow agent
+   */
+  private async generateWorkflowAgent(name: string): Promise<void> {
+    let content = ''
+
+    try {
+      const templatePath = path.join(this.templatesPath, 'workflow', `${name}.md`)
+      content = await fs.readFile(templatePath, 'utf-8')
+    } catch {
+      // Generate minimal agent
+      content = this.generateMinimalWorkflowAgent(name)
+    }
+
+    await fs.writeFile(path.join(this.agentsPath, `${name}.md`), content, 'utf-8')
+  }
+
+  /**
+   * Generate a single domain agent
+   */
+  private async generateDomainAgent(
+    name: string,
+    stats: ProjectStats,
+    stack: StackDetection
+  ): Promise<void> {
+    let content = ''
+
+    try {
+      const templatePath = path.join(this.templatesPath, 'domain', `${name}.md`)
+      content = await fs.readFile(templatePath, 'utf-8')
+
+      // Inject project-specific context
+      content = content.replace('{projectName}', stats.name)
+      content = content.replace('{frameworks}', stack.frameworks.join(', ') || 'None detected')
+      content = content.replace('{ecosystem}', stats.ecosystem)
+    } catch {
+      // Generate minimal agent
+      content = this.generateMinimalDomainAgent(name, stats, stack)
+    }
+
+    await fs.writeFile(path.join(this.agentsPath, `${name}.md`), content, 'utf-8')
+  }
+
+  /**
+   * Generate minimal workflow agent content
+   */
+  private generateMinimalWorkflowAgent(name: string): string {
+    const descriptions: Record<string, string> = {
+      'prjct-workflow': 'Task lifecycle: now, done, pause, resume',
+      'prjct-planner': 'Planning: task, prd, spec, bug',
+      'prjct-shipper': 'Shipping: ship, merge, review',
+    }
+
+    return `---
+name: ${name}
+description: ${descriptions[name] || 'Workflow agent'}
+tools: Read, Write, Glob
+---
+
+# ${name.toUpperCase()}
+
+Workflow agent for prjct operations.
+
+## Project Context
+
+When invoked:
+1. Read \`.prjct/prjct.config.json\` → extract \`projectId\`
+2. Read \`~/.prjct-cli/projects/{projectId}/storage/state.json\`
+3. Execute requested operation
+`
+  }
+
+  /**
+   * Generate minimal domain agent content
+   */
+  private generateMinimalDomainAgent(
+    name: string,
+    stats: ProjectStats,
+    stack: StackDetection
+  ): string {
+    return `---
+name: ${name}
+description: ${name.charAt(0).toUpperCase() + name.slice(1)} specialist for ${stats.name}
+tools: Read, Write, Glob, Grep
+skills: []
+---
+
+# ${name.toUpperCase()} AGENT
+
+Domain specialist for ${name} tasks.
+
+## Project Context
+
+- **Project**: ${stats.name}
+- **Ecosystem**: ${stats.ecosystem}
+- **Frameworks**: ${stack.frameworks.join(', ') || 'None detected'}
+
+## Your Role
+
+You are the ${name} expert for this project. Apply best practices for the detected stack.
+`
+  }
+}
+
+export const createAgentGenerator = (agentsPath: string) => new AgentGenerator(agentsPath)
+export default AgentGenerator

package/core/services/agent-service.ts

@@ -4,10 +4,10 @@
  * Handles agent detection, initialization, and routing tasks to appropriate agents.
  */
 
-import agentDetector from '../infrastructure/agent-detector'
 import AgentRouter from '../agentic/agent-router'
-import type { AgentInfo, AgentAssignmentResult, ProjectContext } from '../types'
 import { AgentError } from '../errors'
+import agentDetector from '../infrastructure/agent-detector'
+import type { AgentAssignmentResult, AgentInfo, ProjectContext } from '../types'
 
 // Valid agent types - whitelist for security (prevents path traversal)
 const VALID_AGENT_TYPES = ['claude'] as const

package/core/services/breakdown-service.ts

@@ -4,7 +4,7 @@
  * Handles task breakdown, severity detection, and complexity estimation.
  */
 
-import type { Severity, ComplexityEstimate } from '../types'
+import type { ComplexityEstimate, Severity } from '../types'
 
 export class BreakdownService {
   /**
@@ -77,9 +77,7 @@ export class BreakdownService {
       'authorization',
     ]
 
-    const hasComplexKeyword = complexKeywords.some((kw) =>
-      description.toLowerCase().includes(kw)
-    )
+    const hasComplexKeyword = complexKeywords.some((kw) => description.toLowerCase().includes(kw))
 
     if (hasComplexKeyword || wordCount > 30) {
       return { level: 'high', hours: 8 }

package/core/services/context-generator.ts

@@ -0,0 +1,299 @@
+/**
+ * ContextFileGenerator - Generates markdown context files
+ *
+ * Responsible for generating:
+ * - CLAUDE.md (main context for AI agents)
+ * - now.md (current task)
+ * - next.md (task queue)
+ * - ideas.md (captured ideas)
+ * - shipped.md (completed features)
+ */
+
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import dateHelper from '../utils/date-helper'
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface GitData {
+  branch: string
+  commits: number
+}
+
+export interface ProjectStats {
+  name: string
+  version: string
+  ecosystem: string
+  projectType: string
+  fileCount: number
+  languages: string[]
+  frameworks: string[]
+}
+
+export interface Commands {
+  install: string
+  dev: string
+  test: string
+  build: string
+  lint: string
+  format: string
+}
+
+export interface AgentInfo {
+  name: string
+  type: 'workflow' | 'domain'
+  skill?: string
+}
+
+export interface ContextGeneratorConfig {
+  projectId: string
+  projectPath: string
+  globalPath: string
+}
+
+// ============================================================================
+// CONTEXT FILE GENERATOR
+// ============================================================================
+
+export class ContextFileGenerator {
+  private config: ContextGeneratorConfig
+
+  constructor(config: ContextGeneratorConfig) {
+    this.config = config
+  }
+
+  /**
+   * Generate all context files in parallel
+   */
+  async generate(
+    git: GitData,
+    stats: ProjectStats,
+    commands: Commands,
+    agents: AgentInfo[]
+  ): Promise<string[]> {
+    const contextPath = path.join(this.config.globalPath, 'context')
+
+    // Generate all context files IN PARALLEL
+    await Promise.all([
+      this.generateClaudeMd(contextPath, git, stats, commands, agents),
+      this.generateNowMd(contextPath),
+      this.generateNextMd(contextPath),
+      this.generateIdeasMd(contextPath),
+      this.generateShippedMd(contextPath),
+    ])
+
+    return [
+      'context/CLAUDE.md',
+      'context/now.md',
+      'context/next.md',
+      'context/ideas.md',
+      'context/shipped.md',
+    ]
+  }
+
+  // ==========================================================================
+  // INDIVIDUAL GENERATORS
+  // ==========================================================================
+
+  /**
+   * Generate CLAUDE.md - main context file for AI agents
+   */
+  private async generateClaudeMd(
+    contextPath: string,
+    git: GitData,
+    stats: ProjectStats,
+    commands: Commands,
+    agents: AgentInfo[]
+  ): Promise<void> {
+    const workflowAgents = agents.filter((a) => a.type === 'workflow').map((a) => a.name)
+    const domainAgents = agents.filter((a) => a.type === 'domain').map((a) => a.name)
+
+    const content = `# ${stats.name} - Project Rules
+<!-- projectId: ${this.config.projectId} -->
+<!-- Generated: ${dateHelper.getTimestamp()} -->
+<!-- Ecosystem: ${stats.ecosystem} | Type: ${stats.projectType} -->
+
+## THIS PROJECT (${stats.ecosystem})
+
+**Type:** ${stats.projectType}
+**Path:** ${this.config.projectPath}
+
+### Commands (USE THESE, NOT OTHERS)
+
+| Action | Command |
+|--------|---------|
+| Install dependencies | \`${commands.install}\` |
+| Run dev server | \`${commands.dev}\` |
+| Run tests | \`${commands.test}\` |
+| Build | \`${commands.build}\` |
+| Lint | \`${commands.lint}\` |
+| Format | \`${commands.format}\` |
+
+### Code Conventions
+
+- **Languages**: ${stats.languages.join(', ') || 'Not detected'}
+- **Frameworks**: ${stats.frameworks.join(', ') || 'Not detected'}
+
+---
+
+## PRJCT RULES
+
+### Path Resolution
+**ALL prjct writes go to**: \`~/.prjct-cli/projects/${this.config.projectId}/\`
+- NEVER write to \`.prjct/\`
+- NEVER write to \`./\` for prjct data
+
+### Workflow
+\`\`\`
+p. sync → p. task "desc" → [work] → p. done → p. ship
+\`\`\`
+
+| Command | Action |
+|---------|--------|
+| \`p. sync\` | Re-analyze project |
+| \`p. task X\` | Start task |
+| \`p. done\` | Complete subtask |
+| \`p. ship X\` | Ship feature |
+
+---
+
+## PROJECT STATE
+
+| Field | Value |
+|-------|-------|
+| Name | ${stats.name} |
+| Version | ${stats.version} |
+| Ecosystem | ${stats.ecosystem} |
+| Branch | ${git.branch} |
+| Files | ~${stats.fileCount} |
+| Commits | ${git.commits} |
+
+---
+
+## AGENTS
+
+Load from \`~/.prjct-cli/projects/${this.config.projectId}/agents/\`:
+
+**Workflow**: ${workflowAgents.join(', ')}
+**Domain**: ${domainAgents.join(', ') || 'none'}
+`
+
+    await fs.writeFile(path.join(contextPath, 'CLAUDE.md'), content, 'utf-8')
+  }
+
+  /**
+   * Generate now.md - current task status
+   */
+  private async generateNowMd(contextPath: string): Promise<void> {
+    let currentTask = null
+    try {
+      const statePath = path.join(this.config.globalPath, 'storage', 'state.json')
+      const state = JSON.parse(await fs.readFile(statePath, 'utf-8'))
+      currentTask = state.currentTask
+    } catch {
+      // No state file
+    }
+
+    const content = currentTask
+      ? `# NOW
+
+**${currentTask.description}**
+
+Started: ${currentTask.startedAt}
+${currentTask.branch ? `Branch: ${currentTask.branch.name}` : ''}
+`
+      : `# NOW
+
+_No active task_
+
+Use \`p. task "description"\` to start working.
+`
+
+    await fs.writeFile(path.join(contextPath, 'now.md'), content, 'utf-8')
+  }
+
+  /**
+   * Generate next.md - task queue
+   */
+  private async generateNextMd(contextPath: string): Promise<void> {
+    let queue: { tasks: { description: string; priority?: string }[] } = { tasks: [] }
+    try {
+      const queuePath = path.join(this.config.globalPath, 'storage', 'queue.json')
+      queue = JSON.parse(await fs.readFile(queuePath, 'utf-8'))
+    } catch {
+      // No queue file
+    }
+
+    const content = `# NEXT
+
+${
+  queue.tasks.length > 0
+    ? queue.tasks
+        .map((t, i) => `${i + 1}. ${t.description}${t.priority ? ` [${t.priority}]` : ''}`)
+        .join('\n')
+    : '_Empty queue_'
+}
+`
+
+    await fs.writeFile(path.join(contextPath, 'next.md'), content, 'utf-8')
+  }
+
+  /**
+   * Generate ideas.md - captured ideas
+   */
+  private async generateIdeasMd(contextPath: string): Promise<void> {
+    let ideas: { ideas: { text: string; priority?: string }[] } = { ideas: [] }
+    try {
+      const ideasPath = path.join(this.config.globalPath, 'storage', 'ideas.json')
+      ideas = JSON.parse(await fs.readFile(ideasPath, 'utf-8'))
+    } catch {
+      // No ideas file
+    }
+
+    const content = `# IDEAS
+
+${
+  ideas.ideas.length > 0
+    ? ideas.ideas.map((i) => `- ${i.text}${i.priority ? ` [${i.priority}]` : ''}`).join('\n')
+    : '_No ideas captured yet_'
+}
+`
+
+    await fs.writeFile(path.join(contextPath, 'ideas.md'), content, 'utf-8')
+  }
+
+  /**
+   * Generate shipped.md - completed features
+   */
+  private async generateShippedMd(contextPath: string): Promise<void> {
+    let shipped: { shipped: { name: string; version?: string; shippedAt: string }[] } = {
+      shipped: [],
+    }
+    try {
+      const shippedPath = path.join(this.config.globalPath, 'storage', 'shipped.json')
+      shipped = JSON.parse(await fs.readFile(shippedPath, 'utf-8'))
+    } catch {
+      // No shipped file
+    }
+
+    const content = `# SHIPPED 🚀
+
+${
+  shipped.shipped.length > 0
+    ? shipped.shipped
+        .slice(-10)
+        .map((s) => `- **${s.name}**${s.version ? ` v${s.version}` : ''} - ${s.shippedAt}`)
+        .join('\n')
+    : '_Nothing shipped yet_'
+}
+
+**Total shipped:** ${shipped.shipped.length}
+`
+
+    await fs.writeFile(path.join(contextPath, 'shipped.md'), content, 'utf-8')
+  }
+}
+
+export default ContextFileGenerator