prjct-cli 0.11.5 → 0.12.0

package/core/schemas/roadmap.ts

@@ -0,0 +1,90 @@
+/**
+ * Roadmap Schema
+ *
+ * Defines the structure for roadmap.json - feature roadmap.
+ * Matches json-loader.ts types exactly.
+ */
+
+export type FeatureStatus = 'planned' | 'active' | 'completed' | 'shipped'
+export type FeatureImpact = 'low' | 'medium' | 'high'
+export type FeatureType = 'feature' | 'breaking_change' | 'refactor' | 'infrastructure'
+
+export interface FeatureTask {
+  id: string                    // task_xxxxxxxx
+  description: string
+  completed: boolean
+  completedAt?: string          // ISO8601
+}
+
+export interface RoadmapPhase {
+  id: string                    // P0, P1, etc.
+  name: string
+  status: 'completed' | 'active' | 'planned'
+  completedAt?: string          // ISO8601
+}
+
+export interface RoadmapStrategy {
+  goal: string
+  phases: RoadmapPhase[]
+  successMetrics?: string[]
+}
+
+// Duration for completed sprints/features
+export interface FeatureDuration {
+  hours: number
+  minutes: number
+  totalMinutes: number
+  display?: string              // "~25m", "~1h"
+}
+
+export interface FeatureSchema {
+  id: string                    // feat_xxxxxxxx
+  name: string
+  description?: string
+  date: string                  // YYYY-MM-DD creation date
+  status: FeatureStatus
+  impact: FeatureImpact
+  effort?: string               // "1-2 days" or similar
+  progress: number              // 0-100
+  // Enriched fields from MD
+  type?: FeatureType
+  roi?: number                  // 1-5 from star count
+  why?: string[]                // from ### Why This Feature? section
+  technicalNotes?: string[]     // from ### Technical Notes section
+  compatibility?: string
+  phase?: string                // P0, P1, etc.
+  tasks: FeatureTask[]
+  createdAt: string             // ISO8601
+  shippedAt?: string            // ISO8601
+  version?: string              // Release version when shipped
+  // ZERO DATA LOSS - additional fields
+  duration?: FeatureDuration    // "~25m", "~1h" parsed
+  taskCount?: number            // "7 tasks" from MD header
+  agent?: string                // "fe+be", "fe", "be"
+  sprintName?: string           // "Sprint 6 - Reports + Audits"
+  completedDate?: string        // "2025-12-09" from MD
+}
+
+export interface RoadmapJson {
+  strategy?: RoadmapStrategy | null
+  features: FeatureSchema[]
+  backlog: string[]
+  lastUpdated: string
+}
+
+// Legacy type for backwards compatibility
+export type RoadmapSchema = FeatureSchema[]
+
+export const DEFAULT_FEATURE: Omit<FeatureSchema, 'id' | 'name'> = {
+  status: 'planned',
+  impact: 'medium',
+  progress: 0,
+  tasks: [],
+  createdAt: new Date().toISOString()
+}
+
+export const DEFAULT_ROADMAP: RoadmapJson = {
+  features: [],
+  backlog: [],
+  lastUpdated: ''
+}

package/core/schemas/shipped.ts

@@ -0,0 +1,82 @@
+/**
+ * Shipped Schema
+ *
+ * Defines the structure for shipped.json - completed/shipped items.
+ * ZERO DATA LOSS - captures ALL fields from MD files.
+ */
+
+export type ShipType = 'feature' | 'fix' | 'improvement' | 'refactor'
+export type CheckStatus = 'pass' | 'warning' | 'fail' | 'skipped'
+export type AgentType = 'fe' | 'be' | 'fe+be' | 'devops' | 'ai' | string
+
+// Duration object for parsed time strings like "13h 38m"
+export interface Duration {
+  hours: number
+  minutes: number
+  totalMinutes: number
+}
+
+// Code metrics from "Files: 4 | +160/-31 | Commits: 0"
+export interface CodeMetrics {
+  filesChanged?: number | null
+  linesAdded?: number | null
+  linesRemoved?: number | null
+  commits?: number | null
+}
+
+export interface ShipChange {
+  description: string
+  type?: 'added' | 'changed' | 'fixed' | 'removed'
+}
+
+export interface QualityMetrics {
+  lintStatus?: CheckStatus | null
+  lintDetails?: string
+  testStatus?: CheckStatus | null
+  testDetails?: string
+}
+
+// Git commit information
+export interface CommitInfo {
+  hash?: string                 // "0a7bbea"
+  message?: string              // "feat(security): Multi-tenant..."
+  branch?: string               // "main"
+}
+
+export interface ShippedItemSchema {
+  id: string                    // ship_xxxxxxxx
+  name: string
+  version?: string | null       // "0.11.6" extracted from MD
+  type: ShipType
+  // Agent who worked on this
+  agent?: AgentType             // "fe+be", "be", "fe"
+  // Full description (narrative text, not just bullet points)
+  description?: string          // "CRITICAL: Multi-tenant isolation hardening..."
+  // Changelog from bullet points
+  changes: ShipChange[]
+  // Code snippets if any
+  codeSnippets?: string[]       // TypeScript/code examples from MD
+  // Git commit info
+  commit?: CommitInfo
+  // Enriched fields from MD
+  codeMetrics?: CodeMetrics
+  qualityMetrics?: QualityMetrics
+  quantitativeImpact?: string   // "81% (1,079 → 204 lines)"
+  duration?: Duration           // parsed from "13h 38m"
+  tasksCompleted?: number | null
+  shippedAt: string             // ISO8601
+  featureId?: string
+}
+
+export interface ShippedJson {
+  items: ShippedItemSchema[]
+  lastUpdated: string
+}
+
+// Legacy type for backwards compatibility
+export type ShippedSchema = ShippedItemSchema[]
+
+export const DEFAULT_SHIPPED: ShippedJson = {
+  items: [],
+  lastUpdated: ''
+}

package/core/schemas/state.ts

@@ -0,0 +1,107 @@
+/**
+ * State Schema
+ *
+ * Defines the structure for state.json - current task state.
+ * Queue is now separate in queue.json.
+ *
+ * Matches json-loader.ts types exactly.
+ */
+
+export type Priority = 'low' | 'medium' | 'high' | 'critical'
+export type TaskType = 'feature' | 'bug' | 'improvement' | 'chore'
+export type TaskSection = 'active' | 'backlog' | 'previously_active'
+
+export interface CurrentTask {
+  id: string                  // task_xxxxxxxx
+  description: string
+  startedAt: string           // ISO8601
+  sessionId: string           // sess_xxxxxxxx
+  featureId?: string          // feat_xxxxxxxx
+}
+
+export interface PreviousTask {
+  id: string
+  description: string
+  status: 'paused'
+  startedAt: string           // ISO8601
+  pausedAt: string            // ISO8601
+}
+
+// StateJson is the wrapper for state.json file
+export interface StateJson {
+  currentTask: CurrentTask | null
+  previousTask?: PreviousTask | null
+  lastUpdated: string
+}
+
+// QueueJson is the wrapper for queue.json file
+export interface QueueTask {
+  id: string                  // task_xxxxxxxx
+  description: string
+  priority: Priority
+  type: TaskType              // detect from emoji 🐛=bug
+  featureId?: string
+  originFeature?: string      // from "(from: Feature Name)" pattern
+  completed: boolean
+  completedAt?: string        // ISO8601
+  createdAt: string           // ISO8601
+  section: TaskSection        // based on MD section
+  // Additional fields for ZERO DATA LOSS
+  agent?: string              // "fe", "be", "fe + be"
+  groupName?: string          // "Sales Reports", "Stock Audits"
+  groupId?: string            // For grouping related tasks
+}
+
+export interface QueueJson {
+  tasks: QueueTask[]
+  lastUpdated: string
+}
+
+// Legacy types for backwards compatibility
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'blocked' | 'paused'
+export type ActivityType = 'task_completed' | 'feature_shipped' | 'idea_captured' | 'session_started'
+
+export interface QueuedTask extends QueueTask {} // Alias
+
+export interface Stats {
+  tasksToday: number
+  tasksThisWeek: number
+  streak: number
+  velocity: string
+  avgDuration: string
+}
+
+export interface RecentActivity {
+  type: ActivityType
+  description: string
+  timestamp: string // ISO8601
+  duration?: string
+}
+
+export interface StateSchema {
+  projectId: string
+  currentTask: CurrentTask | null
+  queue: QueuedTask[]
+  stats: Stats
+  recentActivity: RecentActivity[]
+  lastSync: string // ISO8601
+}
+
+// Defaults
+export const DEFAULT_STATE: StateJson = {
+  currentTask: null,
+  lastUpdated: ''
+}
+
+export const DEFAULT_QUEUE: QueueJson = {
+  tasks: [],
+  lastUpdated: ''
+}
+
+export const DEFAULT_STATS: Stats = {
+  tasksToday: 0,
+  tasksThisWeek: 0,
+  streak: 0,
+  velocity: '0/day',
+  avgDuration: '0m'
+}

package/core/session/index.ts

@@ -0,0 +1,17 @@
+/**
+ * SessionManager - Structured Session Tracking
+ *
+ * Tracks work sessions with metrics, timeline, and duration.
+ * Inspired by OpenCode's session system but simplified.
+ *
+ * Storage: ~/.prjct-cli/projects/{projectId}/sessions/
+ *
+ * @version 1.0.0
+ */
+
+export type { Session, SessionMetrics, TimelineEvent } from './types'
+export { generateId, calculateDuration, formatDuration } from './utils'
+export { SessionManager } from './session-manager'
+
+import { SessionManager } from './session-manager'
+export default SessionManager

package/core/session/{metrics.js → metrics.ts}

@@ -6,21 +6,58 @@
  * @version 1.0.0
  */
 
-const fs = require('fs').promises
-const path = require('path')
-const pathManager = require('../infrastructure/path-manager')
+import fs from 'fs/promises'
+import path from 'path'
+import pathManager from '../infrastructure/path-manager'
+
+interface Session {
+  id: string
+  status: 'active' | 'paused' | 'completed'
+  startedAt: string
+  completedAt?: string
+  duration: number
+  metrics?: {
+    filesChanged?: number
+    linesAdded?: number
+    linesRemoved?: number
+    commits?: number
+  }
+}
+
+interface DayMetrics {
+  sessions: number
+  duration: number
+  commits: number
+}
+
+interface AggregatedMetrics {
+  period: string
+  totalSessions: number
+  totalDuration: number
+  totalDurationFormatted: string
+  averageDuration: number
+  averageDurationFormatted: string
+  tasksCompleted: number
+  filesChanged: number
+  linesAdded: number
+  linesRemoved: number
+  commits: number
+  productivityScore: number
+  streak: number
+  byDay: Record<string, DayMetrics>
+}
 
 class SessionMetrics {
-  constructor(projectId) {
+  private projectId: string
+
+  constructor(projectId: string) {
     this.projectId = projectId
   }
 
   /**
    * Get aggregated metrics for a time period
-   * @param {'day'|'week'|'month'|'all'} period
-   * @returns {Promise<Object>}
    */
-  async getMetrics(period = 'week') {
+  async getMetrics(period: 'day' | 'week' | 'month' | 'all' = 'week'): Promise<AggregatedMetrics> {
     const sessions = await this.getSessionsForPeriod(period)
 
     return {
@@ -43,14 +80,12 @@ class SessionMetrics {
 
   /**
    * Get sessions for a given period
-   * @param {string} period
-   * @returns {Promise<Array>}
    */
-  async getSessionsForPeriod(period) {
+  async getSessionsForPeriod(period: string): Promise<Session[]> {
     const globalPath = pathManager.getGlobalProjectPath(this.projectId)
     const archiveDir = path.join(globalPath, 'sessions', 'archive')
 
-    const sessions = []
+    const sessions: Session[] = []
     const cutoffDate = this.getCutoffDate(period)
 
     try {
@@ -64,9 +99,9 @@ class SessionMetrics {
           if (!file.endsWith('.json')) continue
 
           const content = await fs.readFile(path.join(monthDir, file), 'utf-8')
-          const session = JSON.parse(content)
+          const session: Session = JSON.parse(content)
 
-          if (new Date(session.completedAt) >= cutoffDate) {
+          if (session.completedAt && new Date(session.completedAt) >= cutoffDate) {
             sessions.push(session)
           }
         }
@@ -79,7 +114,7 @@ class SessionMetrics {
     try {
       const currentPath = path.join(globalPath, 'sessions', 'current.json')
       const content = await fs.readFile(currentPath, 'utf-8')
-      const current = JSON.parse(content)
+      const current: Session = JSON.parse(content)
       if (new Date(current.startedAt) >= cutoffDate) {
         sessions.push(current)
       }
@@ -92,10 +127,8 @@ class SessionMetrics {
 
   /**
    * Get cutoff date for period
-   * @param {string} period
-   * @returns {Date}
    */
-  getCutoffDate(period) {
+  getCutoffDate(period: string): Date {
     const now = new Date()
 
     switch (period) {
@@ -117,30 +150,23 @@ class SessionMetrics {
 
   /**
    * Sum durations from sessions
-   * @param {Array} sessions
-   * @returns {number} Total seconds
    */
-  sumDurations(sessions) {
+  sumDurations(sessions: Session[]): number {
     return sessions.reduce((sum, s) => sum + (s.duration || 0), 0)
   }
 
   /**
    * Calculate average duration
-   * @param {Array} sessions
-   * @returns {number} Average seconds
    */
-  averageDuration(sessions) {
+  averageDuration(sessions: Session[]): number {
     if (sessions.length === 0) return 0
     return Math.round(this.sumDurations(sessions) / sessions.length)
   }
 
   /**
    * Sum a specific metric
-   * @param {Array} sessions
-   * @param {string} metric
-   * @returns {number}
    */
-  sumMetric(sessions, metric) {
+  sumMetric(sessions: Session[], metric: 'filesChanged' | 'linesAdded' | 'linesRemoved' | 'commits'): number {
     return sessions.reduce((sum, s) => {
       return sum + (s.metrics?.[metric] || 0)
     }, 0)
@@ -149,10 +175,8 @@ class SessionMetrics {
   /**
    * Calculate productivity score (0-100)
    * Based on consistency, duration, and output
-   * @param {Array} sessions
-   * @returns {number}
    */
-  calculateProductivityScore(sessions) {
+  calculateProductivityScore(sessions: Session[]): number {
     if (sessions.length === 0) return 0
 
     // Factors:
@@ -181,9 +205,8 @@ class SessionMetrics {
 
   /**
    * Calculate current streak (consecutive days with sessions)
-   * @returns {Promise<number>}
    */
-  async calculateStreak() {
+  async calculateStreak(): Promise<number> {
     const sessions = await this.getSessionsForPeriod('month')
 
     // Get unique dates with sessions
@@ -215,11 +238,9 @@ class SessionMetrics {
 
   /**
    * Group sessions by day
-   * @param {Array} sessions
-   * @returns {Object}
    */
-  groupByDay(sessions) {
-    const byDay = {}
+  groupByDay(sessions: Session[]): Record<string, DayMetrics> {
+    const byDay: Record<string, DayMetrics> = {}
 
     for (const session of sessions) {
       const date = new Date(session.completedAt || session.startedAt)
@@ -243,10 +264,8 @@ class SessionMetrics {
 
   /**
    * Format duration as human readable
-   * @param {number} seconds
-   * @returns {string}
    */
-  formatDuration(seconds) {
+  formatDuration(seconds: number): string {
     if (seconds < 60) return `${seconds}s`
     if (seconds < 3600) return `${Math.round(seconds / 60)}m`
 
@@ -259,21 +278,19 @@ class SessionMetrics {
 
   /**
    * Generate metrics summary for display
-   * @param {'day'|'week'|'month'} period
-   * @returns {Promise<string>}
    */
-  async generateSummary(period = 'week') {
+  async generateSummary(period: 'day' | 'week' | 'month' = 'week'): Promise<string> {
     const m = await this.getMetrics(period)
 
-    const periodLabel = {
+    const periodLabel: Record<string, string> = {
       day: 'Today',
       week: 'This Week',
       month: 'This Month',
       all: 'All Time'
-    }[period]
+    }
 
     return `
-## ${periodLabel}
+## ${periodLabel[period]}
 
 | Metric | Value |
 |--------|-------|
@@ -290,4 +307,5 @@ class SessionMetrics {
   }
 }
 
-module.exports = SessionMetrics
+export default SessionMetrics
+export { SessionMetrics, AggregatedMetrics, DayMetrics }