prjct-cli 1.22.0 → 1.24.0

package/core/schemas/state.ts

@@ -1,284 +0,0 @@
-/**
- * State Schema
- *
- * Defines the structure for state.json - current task state.
- * Queue is now separate in queue.json.
- *
- * Uses Zod for runtime validation and TypeScript type inference.
- * @version 2.0.0
- */
-
-import { z } from 'zod'
-import { ModelMetadataSchema } from './model'
-
-// =============================================================================
-// Zod Schemas - Source of Truth
-// =============================================================================
-
-export const PrioritySchema = z.enum(['low', 'medium', 'high', 'critical'])
-export const TaskTypeSchema = z.enum(['feature', 'bug', 'improvement', 'chore'])
-export const TaskSectionSchema = z.enum(['active', 'backlog', 'previously_active'])
-export const TaskStatusSchema = z.enum([
-  'pending',
-  'in_progress',
-  'completed',
-  'blocked',
-  'paused',
-  'failed',
-  'skipped',
-])
-export const ActivityTypeSchema = z.enum([
-  'task_completed',
-  'feature_shipped',
-  'idea_captured',
-  'session_started',
-])
-
-// Subtask summary for context handoff between agents
-export const SubtaskSummarySchema = z.object({
-  title: z.string(),
-  description: z.string(),
-  filesChanged: z.array(
-    z.object({
-      path: z.string(),
-      action: z.enum(['created', 'modified', 'deleted']),
-    })
-  ),
-  whatWasDone: z.array(z.string()).min(1),
-  outputForNextAgent: z.string().min(1),
-  notes: z.string().optional(),
-})
-
-// Schema for validating completion data before persisting
-// Used by completeSubtask() to enforce mandatory handoff
-export const SubtaskCompletionDataSchema = z.object({
-  output: z.string().min(1, 'Subtask output is required'),
-  summary: SubtaskSummarySchema,
-})
-
-// Subtask schema for task fragmentation
-export const SubtaskSchema = z.object({
-  id: z.string(), // subtask-xxx
-  description: z.string(),
-  domain: z.string(), // frontend, backend, database, testing, etc.
-  agent: z.string(), // agent file name (e.g., "frontend.md")
-  status: TaskStatusSchema,
-  dependsOn: z.array(z.string()), // IDs of dependent subtasks
-  startedAt: z.string().optional(), // ISO8601
-  completedAt: z.string().optional(), // ISO8601
-  output: z.string().optional(), // Brief output description
-  summary: SubtaskSummarySchema.optional(), // Full summary for context handoff
-  skipReason: z.string().optional(), // Why this subtask was skipped
-  blockReason: z.string().optional(), // What is blocking this subtask
-  // Fibonacci estimation
-  estimatedPoints: z.number().optional(), // Fibonacci: 1,2,3,5,8,13,21
-  estimatedMinutes: z.number().optional(), // Derived from points
-})
-
-// Subtask progress tracking
-export const SubtaskProgressSchema = z.object({
-  completed: z.number(),
-  total: z.number(),
-  percentage: z.number(),
-})
-
-export const CurrentTaskSchema = z.object({
-  id: z.string(), // task_xxxxxxxx
-  description: z.string(),
-  startedAt: z.string(), // ISO8601
-  sessionId: z.string(), // sess_xxxxxxxx
-  featureId: z.string().optional(), // feat_xxxxxxxx
-  // Subtask tracking for fragmented tasks
-  subtasks: z.array(SubtaskSchema).optional(),
-  currentSubtaskIndex: z.number().optional(),
-  subtaskProgress: SubtaskProgressSchema.optional(),
-  // Linear integration - bidirectional sync
-  linearId: z.string().optional(), // "PRJ-123" - Linear identifier
-  linearUuid: z.string().optional(), // Linear internal UUID for API calls
-  // Fibonacci estimation
-  estimatedPoints: z.number().optional(), // Fibonacci: 1,2,3,5,8,13,21
-  estimatedMinutes: z.number().optional(), // Derived from points
-  // Model specification - which AI model was used (PRJ-265)
-  modelMetadata: ModelMetadataSchema.optional(),
-})
-
-export const PreviousTaskSchema = z.object({
-  id: z.string(),
-  description: z.string(),
-  status: z.literal('paused'),
-  startedAt: z.string(), // ISO8601
-  pausedAt: z.string(), // ISO8601
-  pauseReason: z.string().optional(),
-})
-
-// Task feedback captured during completion (PRJ-272)
-// Enables the task-to-analysis feedback loop: tasks report discoveries back to analysis
-export const TaskFeedbackSchema = z.object({
-  // Stack confirmations - tech confirmed/used during the task
-  stackConfirmed: z.array(z.string()).optional(), // ["React 18", "TypeScript strict mode"]
-  // Patterns discovered during the task
-  patternsDiscovered: z.array(z.string()).optional(), // ["API routes follow /api/v1/{resource}"]
-  // Agent accuracy - how well domain agents performed
-  agentAccuracy: z
-    .array(
-      z.object({
-        agent: z.string(), // "backend.md"
-        rating: z.enum(['helpful', 'neutral', 'inaccurate']),
-        note: z.string().optional(), // "Missing Tailwind context"
-      })
-    )
-    .optional(),
-  // Issues encountered during the task
-  issuesEncountered: z.array(z.string()).optional(), // ["ESLint conflicts with Prettier"]
-})
-
-// Task history entry for completed tasks
-// Stores historical context to enable pattern learning and cross-task correlation
-export const TaskHistoryEntrySchema = z.object({
-  taskId: z.string(), // task UUID
-  title: z.string(), // parent task description
-  classification: TaskTypeSchema, // feature, bug, improvement, chore
-  startedAt: z.string(), // ISO8601
-  completedAt: z.string(), // ISO8601
-  subtaskCount: z.number(), // total number of subtasks
-  subtaskSummaries: z.array(SubtaskSummarySchema), // summary of each subtask
-  outcome: z.string(), // brief description of what was accomplished
-  branchName: z.string(), // git branch used
-  linearId: z.string().optional(), // Linear issue ID if linked
-  linearUuid: z.string().optional(), // Linear internal UUID
-  prUrl: z.string().optional(), // PR URL if shipped
-  feedback: TaskFeedbackSchema.optional(), // Task-to-analysis feedback (PRJ-272)
-})
-
-export const StateJsonSchema = z.object({
-  currentTask: CurrentTaskSchema.nullable(),
-  previousTask: PreviousTaskSchema.nullable().optional(), // deprecated: use pausedTasks
-  pausedTasks: z.array(PreviousTaskSchema).optional(), // replaces previousTask
-  taskHistory: z.array(TaskHistoryEntrySchema).optional(), // completed tasks history (max 20)
-  lastUpdated: z.string(),
-})
-
-export const QueueTaskSchema = z.object({
-  id: z.string(), // task_xxxxxxxx
-  description: z.string(),
-  priority: PrioritySchema,
-  type: TaskTypeSchema, // detect from emoji 🐛=bug
-  featureId: z.string().optional(),
-  originFeature: z.string().optional(),
-  completed: z.boolean(),
-  completedAt: z.string().optional(),
-  createdAt: z.string(), // ISO8601
-  section: TaskSectionSchema,
-  // Additional fields for ZERO DATA LOSS
-  agent: z.string().optional(), // "fe", "be", "fe + be"
-  groupName: z.string().optional(), // "Sales Reports", "Stock Audits"
-  groupId: z.string().optional(), // For grouping related tasks
-})
-
-export const QueueJsonSchema = z.object({
-  tasks: z.array(QueueTaskSchema),
-  lastUpdated: z.string(),
-})
-
-export const StatsSchema = z.object({
-  tasksToday: z.number(),
-  tasksThisWeek: z.number(),
-  streak: z.number(),
-  velocity: z.string(),
-  avgDuration: z.string(),
-})
-
-export const RecentActivitySchema = z.object({
-  type: ActivityTypeSchema,
-  description: z.string(),
-  timestamp: z.string(), // ISO8601
-  duration: z.string().optional(),
-})
-
-export const StateSchemaFull = z.object({
-  projectId: z.string(),
-  currentTask: CurrentTaskSchema.nullable(),
-  queue: z.array(QueueTaskSchema),
-  stats: StatsSchema,
-  recentActivity: z.array(RecentActivitySchema),
-  lastSync: z.string(), // ISO8601
-})
-
-// =============================================================================
-// Inferred Types - Backward Compatible
-// =============================================================================
-
-export type Priority = z.infer<typeof PrioritySchema>
-export type TaskType = z.infer<typeof TaskTypeSchema>
-export type TaskSection = z.infer<typeof TaskSectionSchema>
-export type TaskStatus = z.infer<typeof TaskStatusSchema>
-export type ActivityType = z.infer<typeof ActivityTypeSchema>
-
-export type Subtask = z.infer<typeof SubtaskSchema>
-export type SubtaskSummary = z.infer<typeof SubtaskSummarySchema>
-export type SubtaskCompletionData = z.infer<typeof SubtaskCompletionDataSchema>
-export type SubtaskProgress = z.infer<typeof SubtaskProgressSchema>
-
-export type CurrentTask = z.infer<typeof CurrentTaskSchema>
-export type PreviousTask = z.infer<typeof PreviousTaskSchema>
-export type TaskFeedback = z.infer<typeof TaskFeedbackSchema>
-export type TaskHistoryEntry = z.infer<typeof TaskHistoryEntrySchema>
-export type StateJson = z.infer<typeof StateJsonSchema>
-export type QueueTask = z.infer<typeof QueueTaskSchema>
-export type QueueJson = z.infer<typeof QueueJsonSchema>
-export type Stats = z.infer<typeof StatsSchema>
-export type RecentActivity = z.infer<typeof RecentActivitySchema>
-export type StateSchema = z.infer<typeof StateSchemaFull>
-
-// Legacy alias
-export type QueuedTask = QueueTask
-
-// =============================================================================
-// Validation Helpers
-// =============================================================================
-
-/** Parse and validate state.json content */
-export const parseState = (data: unknown): StateJson => StateJsonSchema.parse(data)
-
-/** Parse and validate queue.json content */
-export const parseQueue = (data: unknown): QueueJson => QueueJsonSchema.parse(data)
-
-/** Safe parse with error result */
-export const safeParseState = (data: unknown) => StateJsonSchema.safeParse(data)
-export const safeParseQueue = (data: unknown) => QueueJsonSchema.safeParse(data)
-
-/** Validate subtask completion data — returns errors or null */
-export const validateSubtaskCompletion = (
-  data: unknown
-): { success: true; data: SubtaskCompletionData } | { success: false; errors: string[] } => {
-  const result = SubtaskCompletionDataSchema.safeParse(data)
-  if (result.success) return { success: true, data: result.data }
-  return {
-    success: false,
-    errors: result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
-  }
-}
-
-// =============================================================================
-// Defaults
-// =============================================================================
-
-export const DEFAULT_STATE: StateJson = {
-  currentTask: null,
-  pausedTasks: [],
-  taskHistory: [],
-  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/schemas/velocity.ts

@@ -1,103 +0,0 @@
-/**
- * Velocity Schema (PRJ-296)
- *
- * Defines the structure for velocity tracking:
- * - Sprint-based velocity with configurable sprint length
- * - Estimation accuracy trends
- * - Over/under estimation patterns
- * - Completion projections
- *
- * @version 1.0.0
- */
-
-import { z } from 'zod'
-
-// =============================================================================
-// Zod Schemas - Source of Truth
-// =============================================================================
-
-export const VelocityTrendSchema = z.enum(['improving', 'stable', 'declining'])
-
-export const SprintVelocitySchema = z.object({
-  sprintNumber: z.number(),
-  startDate: z.string(), // ISO8601
-  endDate: z.string(), // ISO8601
-  pointsCompleted: z.number(),
-  tasksCompleted: z.number(),
-  avgVariance: z.number(), // Average estimation variance (%)
-  estimationAccuracy: z.number(), // % of tasks within tolerance
-})
-
-export const EstimationPatternSchema = z.object({
-  category: z.string(), // task type or domain
-  avgVariance: z.number(), // positive = over, negative = under
-  taskCount: z.number(),
-})
-
-export const CompletionProjectionSchema = z.object({
-  totalPoints: z.number(),
-  sprints: z.number(),
-  estimatedDate: z.string(), // ISO8601
-})
-
-export const VelocityMetricsSchema = z.object({
-  sprints: z.array(SprintVelocitySchema),
-  averageVelocity: z.number(),
-  velocityTrend: VelocityTrendSchema,
-  estimationAccuracy: z.number(), // 0-100%
-  overEstimated: z.array(EstimationPatternSchema),
-  underEstimated: z.array(EstimationPatternSchema),
-  lastUpdated: z.string(), // ISO8601
-})
-
-export const VelocityConfigSchema = z.object({
-  sprintLengthDays: z.number().min(1).max(90).default(7),
-  startDay: z
-    .enum(['monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday'])
-    .default('monday'),
-  windowSize: z.number().min(1).max(52).default(6), // number of sprints for rolling average
-  accuracyTolerance: z.number().min(0).max(100).default(20), // ±% for "accurate" estimate
-})
-
-// =============================================================================
-// Inferred Types
-// =============================================================================
-
-export type VelocityTrend = z.infer<typeof VelocityTrendSchema>
-export type SprintVelocity = z.infer<typeof SprintVelocitySchema>
-export type EstimationPattern = z.infer<typeof EstimationPatternSchema>
-export type CompletionProjection = z.infer<typeof CompletionProjectionSchema>
-export type VelocityMetrics = z.infer<typeof VelocityMetricsSchema>
-export type VelocityConfig = z.input<typeof VelocityConfigSchema>
-
-// =============================================================================
-// Defaults
-// =============================================================================
-
-export const DEFAULT_VELOCITY_CONFIG: VelocityConfig = {
-  sprintLengthDays: 7,
-  startDay: 'monday',
-  windowSize: 6,
-  accuracyTolerance: 20,
-}
-
-export const DEFAULT_VELOCITY_METRICS: VelocityMetrics = {
-  sprints: [],
-  averageVelocity: 0,
-  velocityTrend: 'stable',
-  estimationAccuracy: 0,
-  overEstimated: [],
-  underEstimated: [],
-  lastUpdated: '',
-}
-
-// =============================================================================
-// Validation Helpers
-// =============================================================================
-
-export const parseVelocityMetrics = (data: unknown): VelocityMetrics =>
-  VelocityMetricsSchema.parse(data)
-
-export const safeParseVelocityMetrics = (data: unknown) => VelocityMetricsSchema.safeParse(data)
-
-export const parseVelocityConfig = (data: unknown) => VelocityConfigSchema.parse(data)

package/core/server/index.ts

@@ -1,21 +0,0 @@
-/**
- * Server Module
- *
- * HTTP server for prjct-cli web dashboard and API.
- *
- * @module core/server
- * @version 1.0.0
- */
-
-// Re-export types from canonical location
-export type {
-  ServerConfig,
-  ServerInstance,
-  SSEClient,
-  SSEEventType,
-  SSEManager,
-} from '../types'
-export { createRoutes } from './routes'
-export { createExtendedRoutes } from './routes-extended'
-export { createServer, DEFAULT_PORT, startServer } from './server'
-export { createSSEManager, SSE_EVENTS } from './sse'