prjct-cli 0.20.0 → 0.21.0

package/core/serializers/ideas-serializer.ts

@@ -1,187 +0,0 @@
-/**
- * Ideas Serializer
- *
- * Parses and serializes ideas.md for idea backlog.
- *
- * MD Format (ideas.md):
- * ```
- * # IDEAS 💡
- *
- * ## Brain Dump
- *
- * - Add dark mode _(2025-12-10)_ #ui #enhancement
- * - Improve caching _(2025-12-09)_ #performance
- *
- * ## Converted
- *
- * - ✓ Add user auth → feat_123 _(2025-12-08)_
- * ```
- */
-
-export type IdeaStatus = 'pending' | 'converted' | 'archived'
-export type IdeaPriority = 'low' | 'medium' | 'high'
-
-export interface Idea {
-  id: string
-  text: string
-  status: IdeaStatus
-  priority: IdeaPriority
-  tags: string[]
-  addedAt: string         // ISO8601
-  convertedTo?: string    // featureId if converted
-}
-
-/**
- * Parse ideas.md content to Idea[]
- */
-export function parseIdeas(content: string): Idea[] {
-  if (!content || !content.trim()) {
-    return []
-  }
-
-  const ideas: Idea[] = []
-
-  // Split by sections
-  const sections = content.split(/\n## /).slice(1)
-
-  for (const section of sections) {
-    const lines = section.trim().split('\n')
-    const sectionName = lines[0]?.trim().toLowerCase() || ''
-
-    // Determine status based on section
-    let status: IdeaStatus = 'pending'
-    if (sectionName.includes('converted')) {
-      status = 'converted'
-    } else if (sectionName.includes('archived')) {
-      status = 'archived'
-    }
-
-    // Parse list items
-    for (let i = 1; i < lines.length; i++) {
-      const line = lines[i].trim()
-      if (!line.startsWith('-')) continue
-
-      const itemText = line.slice(1).trim()
-      if (!itemText) continue
-
-      // Extract date: _(date)_
-      const dateMatch = itemText.match(/_\((.+?)\)_/)
-      const addedAt = dateMatch ? dateMatch[1].trim() : new Date().toISOString()
-
-      // Extract tags: #tag1 #tag2
-      const tags = (itemText.match(/#(\w+)/g) || []).map(t => t.slice(1))
-
-      // Extract converted feature id: → feat_123
-      const convertedMatch = itemText.match(/→\s*(\w+)/)
-      const convertedTo = convertedMatch ? convertedMatch[1] : undefined
-
-      // Clean text: remove date, tags, and conversion marker
-      let text = itemText
-        .replace(/_\(.+?\)_/g, '')
-        .replace(/#\w+/g, '')
-        .replace(/→\s*\w+/g, '')
-        .replace(/^✓\s*/, '')
-        .trim()
-
-      // Detect priority from keywords
-      let priority: IdeaPriority = 'medium'
-      if (text.toLowerCase().includes('urgent') || text.toLowerCase().includes('critical')) {
-        priority = 'high'
-      } else if (text.toLowerCase().includes('nice to have') || text.toLowerCase().includes('maybe')) {
-        priority = 'low'
-      }
-
-      ideas.push({
-        id: `idea_${Date.parse(addedAt) || Date.now()}_${i}`,
-        text,
-        status,
-        priority,
-        tags,
-        addedAt,
-        convertedTo
-      })
-    }
-  }
-
-  return ideas
-}
-
-/**
- * Serialize Idea[] to ideas.md format
- */
-export function serializeIdeas(ideas: Idea[]): string {
-  const lines: string[] = ['# IDEAS 💡', '']
-
-  const pending = ideas.filter(i => i.status === 'pending')
-  const converted = ideas.filter(i => i.status === 'converted')
-  const archived = ideas.filter(i => i.status === 'archived')
-
-  // Brain Dump section (pending ideas)
-  lines.push('## Brain Dump', '')
-
-  if (pending.length === 0) {
-    lines.push('_No pending ideas. Use `/p:idea` to capture one._', '')
-  } else {
-    // Sort by addedAt descending (newest first)
-    const sorted = [...pending].sort(
-      (a, b) => new Date(b.addedAt).getTime() - new Date(a.addedAt).getTime()
-    )
-
-    for (const idea of sorted) {
-      const tagsStr = idea.tags.length > 0 ? ' ' + idea.tags.map(t => `#${t}`).join(' ') : ''
-      const dateStr = formatDate(idea.addedAt)
-      lines.push(`- ${idea.text} _(${dateStr})_${tagsStr}`)
-    }
-    lines.push('')
-  }
-
-  // Converted section
-  if (converted.length > 0) {
-    lines.push('## Converted', '')
-    const sorted = [...converted].sort(
-      (a, b) => new Date(b.addedAt).getTime() - new Date(a.addedAt).getTime()
-    )
-
-    for (const idea of sorted) {
-      const convStr = idea.convertedTo ? ` → ${idea.convertedTo}` : ''
-      const dateStr = formatDate(idea.addedAt)
-      lines.push(`- ✓ ${idea.text}${convStr} _(${dateStr})_`)
-    }
-    lines.push('')
-  }
-
-  // Archived section
-  if (archived.length > 0) {
-    lines.push('## Archived', '')
-    const sorted = [...archived].sort(
-      (a, b) => new Date(b.addedAt).getTime() - new Date(a.addedAt).getTime()
-    )
-
-    for (const idea of sorted) {
-      const dateStr = formatDate(idea.addedAt)
-      lines.push(`- ${idea.text} _(${dateStr})_`)
-    }
-    lines.push('')
-  }
-
-  return lines.join('\n')
-}
-
-/**
- * Format date for display
- */
-function formatDate(isoDate: string): string {
-  try {
-    const date = new Date(isoDate)
-    return date.toISOString().split('T')[0] // YYYY-MM-DD
-  } catch {
-    return isoDate
-  }
-}
-
-/**
- * Create empty ideas.md
- */
-export function createEmptyIdeasMd(): string {
-  return serializeIdeas([])
-}

package/core/serializers/index.ts

@@ -1,36 +0,0 @@
-/**
- * Serializers Index
- *
- * MD-First Architecture: These serializers convert between TypeScript schemas and MD format.
- */
-
-// State (now.md)
-export {
-  parseState,
-  serializeState,
-  createCurrentTaskMd,
-  createEmptyStateMd
-} from './state-serializer'
-
-// Queue (next.md)
-export {
-  parseQueue,
-  serializeQueue,
-  createEmptyQueueMd
-} from './queue-serializer'
-
-// Shipped (shipped.md)
-export {
-  parseShipped,
-  serializeShipped,
-  createEmptyShippedMd
-} from './shipped-serializer'
-export type { ShippedFeature } from './shipped-serializer'
-
-// Ideas (ideas.md)
-export {
-  parseIdeas,
-  serializeIdeas,
-  createEmptyIdeasMd
-} from './ideas-serializer'
-export type { Idea, IdeaStatus, IdeaPriority } from './ideas-serializer'

package/core/serializers/queue-serializer.ts

@@ -1,210 +0,0 @@
-/**
- * Queue Serializer
- *
- * Parses and serializes next.md for task queue.
- *
- * MD Format (next.md):
- * ```
- * # Priority Queue
- *
- * > Tasks ready to start
- *
- * ## Active Tasks
- * 1. [ ] Task description @agent (from: Feature Name)
- * 2. [x] Completed task ✅
- *
- * ## Previously Active
- * - [ ] Paused task
- *
- * ## Backlog
- * - [ ] 🐛 [HIGH] Bug description
- * - [ ] Feature task
- * ```
- */
-
-import type { QueueJson, QueueTask, Priority, TaskType, TaskSection } from '../schemas/state'
-
-/**
- * Parse next.md content to QueueJson
- */
-export function parseQueue(content: string): QueueJson {
-  if (!content || !content.trim()) {
-    return { tasks: [], lastUpdated: '' }
-  }
-
-  const lines = content.split('\n')
-  const tasks: QueueTask[] = []
-  let currentSection: TaskSection = 'active'
-  let taskIndex = 0
-
-  for (const line of lines) {
-    // Detect section headers
-    if (line.match(/^##\s*Active/i)) {
-      currentSection = 'active'
-      continue
-    }
-    if (line.match(/^##\s*Previously/i)) {
-      currentSection = 'previously_active'
-      continue
-    }
-    if (line.match(/^##\s*Backlog/i)) {
-      currentSection = 'backlog'
-      continue
-    }
-
-    // Parse task lines: "1. [ ] Task" or "- [ ] Task" or "- [x] Task"
-    const taskMatch = line.match(/^(?:\d+\.|[-*])\s*\[([\sx])\]\s*(.+)$/i)
-    if (!taskMatch) continue
-
-    const isCompleted = taskMatch[1].toLowerCase() === 'x'
-    let taskText = taskMatch[2].trim()
-
-    // Extract agent: @fe, @be, @fe+be
-    const agentMatch = taskText.match(/@(\w+(?:\+\w+)?)/)
-    const agent = agentMatch ? agentMatch[1] : undefined
-    taskText = taskText.replace(/@\w+(?:\+\w+)?/, '').trim()
-
-    // Extract origin feature: (from: Feature Name)
-    const fromMatch = taskText.match(/\(from:\s*([^)]+)\)/)
-    const originFeature = fromMatch ? fromMatch[1].trim() : undefined
-    taskText = taskText.replace(/\(from:\s*[^)]+\)/, '').trim()
-
-    // Detect task type from emoji/prefix
-    let type: TaskType = 'feature'
-    let priority: Priority = 'medium'
-
-    if (taskText.includes('🐛') || taskText.toLowerCase().includes('bug')) {
-      type = 'bug'
-      taskText = taskText.replace('🐛', '').trim()
-    }
-    if (taskText.includes('🔧') || taskText.toLowerCase().includes('fix')) {
-      type = 'improvement'
-    }
-    if (taskText.includes('♻️') || taskText.toLowerCase().includes('refactor')) {
-      type = 'chore'
-    }
-
-    // Extract priority: [HIGH], [MEDIUM], [LOW], [CRITICAL]
-    const priorityMatch = taskText.match(/\[(HIGH|MEDIUM|LOW|CRITICAL)\]/i)
-    if (priorityMatch) {
-      priority = priorityMatch[1].toLowerCase() as Priority
-      taskText = taskText.replace(/\[(HIGH|MEDIUM|LOW|CRITICAL)\]/i, '').trim()
-    }
-
-    // Remove checkmarks and clean up
-    taskText = taskText.replace(/✅/g, '').trim()
-
-    // Skip empty descriptions
-    if (!taskText) continue
-
-    const task: QueueTask = {
-      id: `task_${Date.now()}_${taskIndex++}`,
-      description: taskText,
-      priority,
-      type,
-      completed: isCompleted,
-      createdAt: new Date().toISOString(),
-      section: currentSection
-    }
-
-    if (agent) task.agent = agent
-    if (originFeature) task.originFeature = originFeature
-    if (isCompleted) task.completedAt = new Date().toISOString()
-
-    tasks.push(task)
-  }
-
-  // Extract updated date
-  const updatedMatch = content.match(/_Updated:\s*(\d{4}-\d{2}-\d{2})/)
-  const lastUpdated = updatedMatch ? updatedMatch[1] : new Date().toISOString().split('T')[0]
-
-  return { tasks, lastUpdated }
-}
-
-/**
- * Serialize QueueJson to next.md format
- */
-export function serializeQueue(data: QueueJson): string {
-  const lines: string[] = [
-    '# Priority Queue',
-    '',
-    '> Tasks ready to start (max 100)',
-    '> Auto-updated by prjct',
-    ''
-  ]
-
-  // Group tasks by section
-  const active = data.tasks.filter(t => t.section === 'active')
-  const previouslyActive = data.tasks.filter(t => t.section === 'previously_active')
-  const backlog = data.tasks.filter(t => t.section === 'backlog')
-
-  // Active Tasks
-  if (active.length > 0) {
-    lines.push('## Active Tasks', '')
-    active.forEach((task, i) => {
-      lines.push(formatTask(task, i + 1, true))
-    })
-    lines.push('')
-  }
-
-  // Previously Active
-  if (previouslyActive.length > 0) {
-    lines.push('## Previously Active', '')
-    previouslyActive.forEach(task => {
-      lines.push(formatTask(task, 0, false))
-    })
-    lines.push('')
-  }
-
-  // Backlog
-  lines.push('---', '', '## Backlog', '')
-  if (backlog.length > 0) {
-    backlog.forEach(task => {
-      lines.push(formatTask(task, 0, false))
-    })
-  } else {
-    lines.push('_No backlog items_')
-  }
-
-  lines.push('')
-  lines.push('---', '')
-  lines.push(`_Updated: ${data.lastUpdated || new Date().toISOString().split('T')[0]}_`)
-
-  return lines.join('\n')
-}
-
-/**
- * Format a single task as markdown
- */
-function formatTask(task: QueueTask, num: number, numbered: boolean): string {
-  const checkbox = task.completed ? '[x]' : '[ ]'
-  const prefix = numbered && num > 0 ? `${num}.` : '-'
-
-  let text = task.description
-
-  // Add emoji for type
-  if (task.type === 'bug') text = `🐛 ${text}`
-
-  // Add priority tag for high/critical
-  if (task.priority === 'high' || task.priority === 'critical') {
-    text = `[${task.priority.toUpperCase()}] ${text}`
-  }
-
-  // Add agent
-  if (task.agent) text = `${text} @${task.agent}`
-
-  // Add origin feature
-  if (task.originFeature) text = `${text} (from: ${task.originFeature})`
-
-  // Add checkmark for completed
-  if (task.completed) text = `${text} ✅`
-
-  return `${prefix} ${checkbox} ${text}`
-}
-
-/**
- * Quick helpers
- */
-export function createEmptyQueueMd(): string {
-  return serializeQueue({ tasks: [], lastUpdated: new Date().toISOString().split('T')[0] })
-}

package/core/serializers/shipped-serializer.ts

@@ -1,108 +0,0 @@
-/**
- * Shipped Serializer
- *
- * Parses and serializes shipped.md for shipped features.
- *
- * MD Format (shipped.md):
- * ```
- * # SHIPPED 🚀
- *
- * ## Feature Name
- *
- * Shipped: 2025-12-10T10:00:00.000Z
- * Version: 0.1.5
- *
- * ## Another Feature
- *
- * Shipped: 2025-12-09T14:30:00.000Z
- * Version: 0.1.4
- * ```
- */
-
-export interface ShippedFeature {
-  id: string
-  name: string
-  shippedAt: string      // ISO8601
-  version: string
-  description?: string
-}
-
-/**
- * Parse shipped.md content to ShippedFeature[]
- */
-export function parseShipped(content: string): ShippedFeature[] {
-  if (!content || !content.trim()) {
-    return []
-  }
-
-  const features: ShippedFeature[] = []
-  const sections = content.split(/\n## /).slice(1) // Skip header
-
-  for (const section of sections) {
-    const lines = section.trim().split('\n')
-    const name = lines[0]?.trim()
-
-    if (!name) continue
-
-    const shippedMatch = section.match(/Shipped:\s*(.+)/i)
-    const versionMatch = section.match(/Version:\s*(.+)/i)
-
-    const shippedAt = shippedMatch ? shippedMatch[1].trim() : new Date().toISOString()
-    const version = versionMatch ? versionMatch[1].trim() : '0.0.0'
-
-    // Extract description (lines between name and metadata)
-    const descLines: string[] = []
-    for (let i = 1; i < lines.length; i++) {
-      const line = lines[i].trim()
-      if (line.startsWith('Shipped:') || line.startsWith('Version:') || !line) break
-      descLines.push(line)
-    }
-
-    features.push({
-      id: `ship_${Date.parse(shippedAt) || Date.now()}`,
-      name,
-      shippedAt,
-      version,
-      description: descLines.join(' ') || undefined
-    })
-  }
-
-  return features
-}
-
-/**
- * Serialize ShippedFeature[] to shipped.md format
- */
-export function serializeShipped(features: ShippedFeature[]): string {
-  const lines: string[] = ['# SHIPPED 🚀', '']
-
-  if (features.length === 0) {
-    lines.push('_No features shipped yet._', '')
-    lines.push('Use `/p:ship` to celebrate your first ship!')
-    return lines.join('\n')
-  }
-
-  // Sort by shippedAt descending (newest first)
-  const sorted = [...features].sort(
-    (a, b) => new Date(b.shippedAt).getTime() - new Date(a.shippedAt).getTime()
-  )
-
-  for (const feature of sorted) {
-    lines.push(`## ${feature.name}`, '')
-    if (feature.description) {
-      lines.push(feature.description, '')
-    }
-    lines.push(`Shipped: ${feature.shippedAt}`)
-    lines.push(`Version: ${feature.version}`)
-    lines.push('')
-  }
-
-  return lines.join('\n')
-}
-
-/**
- * Create empty shipped.md
- */
-export function createEmptyShippedMd(): string {
-  return serializeShipped([])
-}

package/core/serializers/state-serializer.ts

@@ -1,136 +0,0 @@
-/**
- * State Serializer
- *
- * Parses and serializes now.md for current task state.
- *
- * MD Format (now.md):
- * ```
- * # NOW
- *
- * **Task description here**
- *
- * Started: 2025-12-10T10:00:00.000Z
- * Session: sess_abc123
- * Feature: feat_xyz789
- * Agent: fe
- * ```
- */
-
-import type { StateJson, CurrentTask, PreviousTask } from '../schemas/state'
-
-/**
- * Parse now.md content to StateJson
- */
-export function parseState(content: string): StateJson {
-  if (!content || !content.trim()) {
-    return { currentTask: null, lastUpdated: '' }
-  }
-
-  const lines = content.split('\n')
-  let currentTask: CurrentTask | null = null
-  let previousTask: PreviousTask | null = null
-
-  // Find task description (bold line after # NOW)
-  let description = ''
-  for (const line of lines) {
-    const boldMatch = line.match(/^\*\*(.+)\*\*$/)
-    if (boldMatch) {
-      description = boldMatch[1].trim()
-      break
-    }
-  }
-
-  if (!description || description.toLowerCase().includes('no active task')) {
-    return { currentTask: null, lastUpdated: '' }
-  }
-
-  // Extract metadata
-  const startedMatch = content.match(/Started:\s*(.+)/i)
-  const sessionMatch = content.match(/Session:\s*(.+)/i)
-  const featureMatch = content.match(/Feature:\s*(.+)/i)
-  const idMatch = content.match(/ID:\s*(.+)/i)
-  const agentMatch = content.match(/Agent:\s*(.+)/i)
-  const pausedMatch = content.match(/Paused:\s*(.+)/i)
-
-  const id = idMatch ? idMatch[1].trim() : `task_${Date.now()}`
-  const startedAt = startedMatch ? startedMatch[1].trim() : new Date().toISOString()
-  const sessionId = sessionMatch ? sessionMatch[1].trim() : `sess_${Date.now()}`
-
-  if (pausedMatch) {
-    // This is a paused task
-    previousTask = {
-      id,
-      description,
-      status: 'paused',
-      startedAt,
-      pausedAt: pausedMatch[1].trim()
-    }
-  } else {
-    // Active task
-    currentTask = {
-      id,
-      description,
-      startedAt,
-      sessionId
-    }
-
-    if (featureMatch) {
-      currentTask.featureId = featureMatch[1].trim()
-    }
-  }
-
-  return {
-    currentTask,
-    previousTask,
-    lastUpdated: startedAt
-  }
-}
-
-/**
- * Serialize StateJson to now.md format
- */
-export function serializeState(data: StateJson): string {
-  const lines: string[] = ['# NOW', '']
-
-  if (!data.currentTask && !data.previousTask) {
-    lines.push('_No active task_', '')
-    lines.push('Use `/p:now` to start working on something.')
-    return lines.join('\n')
-  }
-
-  const task = data.currentTask || data.previousTask
-
-  if (task) {
-    lines.push(`**${task.description}**`, '')
-
-    if ('pausedAt' in task && task.pausedAt) {
-      lines.push(`Started: ${task.startedAt}`)
-      lines.push(`Paused: ${task.pausedAt}`)
-    } else if (data.currentTask) {
-      lines.push(`Started: ${data.currentTask.startedAt}`)
-      lines.push(`Session: ${data.currentTask.sessionId}`)
-      if (data.currentTask.featureId) {
-        lines.push(`Feature: ${data.currentTask.featureId}`)
-      }
-    }
-  }
-
-  return lines.join('\n')
-}
-
-/**
- * Quick helpers for common operations
- */
-export function createCurrentTaskMd(task: CurrentTask): string {
-  return serializeState({
-    currentTask: task,
-    lastUpdated: task.startedAt
-  })
-}
-
-export function createEmptyStateMd(): string {
-  return serializeState({
-    currentTask: null,
-    lastUpdated: ''
-  })
-}

package/core/session/types.ts

@@ -1,29 +0,0 @@
-/**
- * Session Types
- */
-
-export interface SessionMetrics {
-  filesChanged: number
-  linesAdded: number
-  linesRemoved: number
-  commits: number
-  snapshots: string[]
-}
-
-export interface TimelineEvent {
-  type: 'start' | 'pause' | 'resume' | 'complete'
-  at: string
-}
-
-export interface Session {
-  id: string
-  projectId: string
-  task: string
-  status: 'active' | 'paused' | 'completed'
-  startedAt: string
-  pausedAt: string | null
-  completedAt: string | null
-  duration: number
-  metrics: SessionMetrics
-  timeline: TimelineEvent[]
-}