prjct-cli 1.22.0 → 1.24.0

package/core/schemas/enriched-task.ts

@@ -1,291 +0,0 @@
-/**
- * Enriched Task Schema
- * Defines the structure of a fully enriched task from PM Expert
- */
-
-import { z } from 'zod'
-
-// =============================================================================
-// Enums
-// =============================================================================
-
-export const TaskTypeSchema = z.enum([
-  'feature',
-  'bug',
-  'improvement',
-  'task',
-  'chore',
-  'spike',
-  'epic',
-])
-
-export const PrioritySchema = z.enum(['critical', 'high', 'medium', 'low', 'none'])
-
-export const ComplexitySchema = z.enum([
-  'trivial', // < 1 hour
-  'small', // 1-4 hours
-  'medium', // 1-2 days
-  'large', // 3-5 days
-  'epic', // > 1 week
-])
-
-export const RiskLevelSchema = z.enum(['none', 'low', 'medium', 'high', 'critical'])
-
-// =============================================================================
-// User Story
-// =============================================================================
-
-export const UserStorySchema = z.object({
-  role: z.string().describe('The user role (e.g., "mobile user")'),
-  action: z.string().describe('What the user wants to do'),
-  benefit: z.string().describe('The benefit they get'),
-  formatted: z
-    .string()
-    .describe('Formatted user story: "As a [role], I want [action] so that [benefit]"'),
-})
-
-// =============================================================================
-// Acceptance Criteria
-// =============================================================================
-
-export const AcceptanceCriterionSchema = z.object({
-  id: z.string().describe('Unique criterion ID (e.g., AC-1)'),
-  description: z.string().describe('Criterion description'),
-  type: z.enum(['functional', 'technical', 'ux', 'performance']).default('functional'),
-  testable: z.boolean().default(true).describe('Whether it is verifiable/testable'),
-  gherkin: z.string().optional().describe('Optional Given/When/Then format'),
-})
-
-// =============================================================================
-// Dependencies
-// =============================================================================
-
-export const CodeDependencySchema = z.object({
-  file: z.string().describe('File path'),
-  reason: z.string().describe('Why it is relevant'),
-  risk: RiskLevelSchema.describe('Risk level of modifying'),
-  lines: z.string().optional().describe('Specific lines (e.g., "45-67")'),
-})
-
-export const ApiDependencySchema = z.object({
-  endpoint: z.string().describe('Endpoint (e.g., POST /api/auth/login)'),
-  method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).optional(),
-  status: z.enum(['stable', 'in_development', 'deprecated']).default('stable'),
-  risk: RiskLevelSchema,
-  notes: z.string().optional(),
-})
-
-export const TaskDependencySchema = z.object({
-  id: z.string().describe('Blocking task ID'),
-  title: z.string().describe('Task title'),
-  status: z.string().describe('Current status'),
-  blocking: z.boolean().default(false).describe('Whether it completely blocks'),
-  risk: RiskLevelSchema,
-})
-
-export const DependenciesSchema = z.object({
-  code: z.array(CodeDependencySchema).default([]),
-  api: z.array(ApiDependencySchema).default([]),
-  tasks: z.array(TaskDependencySchema).default([]),
-  infrastructure: z
-    .array(
-      z.object({
-        service: z.string(),
-        purpose: z.string(),
-        risk: RiskLevelSchema,
-      })
-    )
-    .default([]),
-})
-
-// =============================================================================
-// Technical Analysis
-// =============================================================================
-
-export const TechnicalAnalysisSchema = z.object({
-  affectedFiles: z
-    .array(
-      z.object({
-        path: z.string(),
-        changes: z.string().describe('Expected changes'),
-        complexity: ComplexitySchema,
-      })
-    )
-    .default([]),
-
-  existingPatterns: z
-    .array(
-      z.object({
-        pattern: z.string().describe('Pattern name'),
-        file: z.string().describe('Reference file'),
-        relevance: z.string().describe('Why it is relevant'),
-      })
-    )
-    .default([]),
-
-  suggestedApproach: z.string().optional().describe('Recommended approach'),
-
-  potentialRisks: z
-    .array(
-      z.object({
-        risk: z.string(),
-        mitigation: z.string(),
-        severity: RiskLevelSchema,
-      })
-    )
-    .default([]),
-
-  testingStrategy: z
-    .object({
-      unit: z.array(z.string()).default([]),
-      integration: z.array(z.string()).default([]),
-      e2e: z.array(z.string()).default([]),
-    })
-    .optional(),
-})
-
-// =============================================================================
-// LLM Prompt (AI-Agnostic)
-// =============================================================================
-
-/**
- * LLM Prompt Schema
- * Generates prompts compatible with any AI assistant:
- * Claude, ChatGPT, Copilot, Gemini, Cursor, etc.
- */
-export const LLMPromptSchema = z.object({
-  context: z.string().describe('Codebase context (stack, structure)'),
-  problem: z.string().describe('What problem needs to be solved'),
-  task: z.string().describe('Task description'),
-  instructions: z.array(z.string()).describe('Step-by-step instructions'),
-  files: z.array(z.string()).describe('Files to modify'),
-  patterns: z.array(z.string()).describe('Reference patterns to follow'),
-  acceptanceCriteria: z.array(z.string()).describe('How to know when done'),
-  verification: z.array(z.string()).describe('How to test/verify correctness'),
-  formatted: z.string().describe('Complete copy-paste ready prompt'),
-})
-
-// =============================================================================
-// Main Enriched Task Schema
-// =============================================================================
-
-export const EnrichedTaskSchema = z.object({
-  // Identification
-  id: z.string().describe('Task UUID'),
-  externalId: z.string().optional().describe('External system ID (ENG-123)'),
-  provider: z.enum(['linear', 'jira', 'monday', 'github', 'internal']).optional(),
-
-  // Basic (original input)
-  originalTitle: z.string().describe('Original title from PO'),
-  originalDescription: z.string().optional().describe('Original description'),
-
-  // Classification
-  type: TaskTypeSchema,
-  priority: PrioritySchema,
-  complexity: ComplexitySchema,
-  labels: z.array(z.string()).default([]),
-
-  // Enrichment
-  userStory: UserStorySchema,
-  acceptanceCriteria: z.array(AcceptanceCriterionSchema).min(1),
-  definitionOfDone: z
-    .array(z.string())
-    .default(['Code reviewed', 'Tests pass', 'Documentation updated', 'Deployed to staging']),
-
-  // Technical analysis
-  technicalAnalysis: TechnicalAnalysisSchema,
-  dependencies: DependenciesSchema,
-
-  // For the LLM
-  llmPrompt: LLMPromptSchema,
-
-  // Metadata
-  enrichedAt: z.string().describe('ISO timestamp'),
-  enrichedBy: z.enum(['pm-expert', 'manual', 'imported']).default('pm-expert'),
-  confidence: z.number().min(0).max(1).describe('Analysis confidence (0-1)'),
-
-  // Status
-  readyForDev: z.boolean().default(false).describe('Whether ready for development'),
-  blockers: z.array(z.string()).default([]).describe('Active blockers'),
-})
-
-// =============================================================================
-// Types
-// =============================================================================
-
-export type TaskType = z.infer<typeof TaskTypeSchema>
-export type Priority = z.infer<typeof PrioritySchema>
-export type Complexity = z.infer<typeof ComplexitySchema>
-export type RiskLevel = z.infer<typeof RiskLevelSchema>
-export type UserStory = z.infer<typeof UserStorySchema>
-export type AcceptanceCriterion = z.infer<typeof AcceptanceCriterionSchema>
-export type Dependencies = z.infer<typeof DependenciesSchema>
-export type TechnicalAnalysis = z.infer<typeof TechnicalAnalysisSchema>
-export type LLMPrompt = z.infer<typeof LLMPromptSchema>
-export type EnrichedTask = z.infer<typeof EnrichedTaskSchema>
-
-// =============================================================================
-// Helpers
-// =============================================================================
-
-/**
- * Create formatted user story
- */
-export function formatUserStory(role: string, action: string, benefit: string): UserStory {
-  return {
-    role,
-    action,
-    benefit,
-    formatted: `As a **${role}**, I want to **${action}** so that **${benefit}**.`,
-  }
-}
-
-/**
- * Check if task is ready for development
- */
-export function isReadyForDev(task: EnrichedTask): { ready: boolean; reasons: string[] } {
-  const reasons: string[] = []
-
-  // Check acceptance criteria
-  if (task.acceptanceCriteria.length < 2) {
-    reasons.push('Needs at least 2 acceptance criteria')
-  }
-
-  // Check blockers
-  const blockingDeps = task.dependencies.tasks.filter((t) => t.blocking)
-  if (blockingDeps.length > 0) {
-    reasons.push(`Blocked by: ${blockingDeps.map((t) => t.id).join(', ')}`)
-  }
-
-  // Check critical risks
-  const criticalRisks = task.technicalAnalysis.potentialRisks.filter(
-    (r) => r.severity === 'critical'
-  )
-  if (criticalRisks.length > 0) {
-    reasons.push('Has unmitigated critical risks')
-  }
-
-  // Check analysis confidence
-  if (task.confidence < 0.6) {
-    reasons.push('Low confidence analysis - needs manual review')
-  }
-
-  return {
-    ready: reasons.length === 0,
-    reasons,
-  }
-}
-
-/**
- * Estimate story points based on complexity
- */
-export function estimateStoryPoints(complexity: Complexity): number {
-  const map: Record<Complexity, number> = {
-    trivial: 1,
-    small: 2,
-    medium: 3,
-    large: 5,
-    epic: 8,
-  }
-  return map[complexity]
-}

package/core/schemas/ideas.ts

@@ -1,114 +0,0 @@
-/**
- * Ideas Schema
- *
- * Defines the structure for ideas.json - idea backlog.
- * Uses Zod for runtime validation and TypeScript type inference.
- *
- * @version 2.0.0
- */
-
-import { z } from 'zod'
-
-// =============================================================================
-// Zod Schemas - Source of Truth
-// =============================================================================
-
-export const IdeaPrioritySchema = z.enum(['low', 'medium', 'high'])
-export const IdeaStatusSchema = z.enum(['pending', 'converted', 'completed', 'archived', 'dormant'])
-export const ImpactLevelSchema = z.enum(['high', 'medium', 'low'])
-
-export const ImpactEffortSchema = z.object({
-  impact: ImpactLevelSchema,
-  effort: ImpactLevelSchema,
-})
-
-export const TechStackSchema = z.object({
-  frontend: z.string().optional(), // "Next.js 14, HeroUI"
-  backend: z.string().optional(), // "Supabase (Auth, DB, RLS, Realtime)"
-  payments: z.string().optional(), // "Stripe Billing"
-  ai: z.string().optional(), // "Vercel AI SDK"
-  deploy: z.string().optional(), // "Vercel"
-  other: z.array(z.string()).optional(),
-})
-
-export const IdeaModuleSchema = z.object({
-  name: z.string(), // "Multi-tenant"
-  description: z.string(), // "Strict RLS for organizations"
-})
-
-export const IdeaRoleSchema = z.object({
-  name: z.string(), // "SUPER_ADMIN"
-  description: z.string().optional(),
-})
-
-export const IdeaItemSchema = z.object({
-  id: z.string(), // idea_xxxxxxxx
-  text: z.string(), // Title/summary
-  details: z.string().optional(),
-  priority: IdeaPrioritySchema,
-  status: IdeaStatusSchema,
-  tags: z.array(z.string()),
-  addedAt: z.string(), // ISO8601
-  completedAt: z.string().optional(),
-  convertedTo: z.string().optional(),
-  // Source documentation
-  source: z.string().optional(),
-  sourceFiles: z.array(z.string()).optional(),
-  // Enriched fields from MD
-  painPoints: z.array(z.string()).optional(),
-  solutions: z.array(z.string()).optional(),
-  filesAffected: z.array(z.string()).optional(),
-  impactEffort: ImpactEffortSchema.optional(),
-  implementationNotes: z.string().optional(),
-  // Technical spec fields for ZERO DATA LOSS
-  stack: TechStackSchema.optional(),
-  modules: z.array(IdeaModuleSchema).optional(),
-  roles: z.array(IdeaRoleSchema).optional(),
-  risks: z.array(z.string()).optional(),
-  risksCount: z.number().optional(),
-})
-
-export const IdeasJsonSchema = z.object({
-  ideas: z.array(IdeaItemSchema),
-  lastUpdated: z.string(),
-})
-
-// =============================================================================
-// Inferred Types - Backward Compatible
-// =============================================================================
-
-export type IdeaPriority = z.infer<typeof IdeaPrioritySchema>
-export type IdeaStatus = z.infer<typeof IdeaStatusSchema>
-export type ImpactEffort = z.infer<typeof ImpactEffortSchema>
-export type TechStack = z.infer<typeof TechStackSchema>
-export type IdeaModule = z.infer<typeof IdeaModuleSchema>
-export type IdeaRole = z.infer<typeof IdeaRoleSchema>
-export type IdeaSchema = z.infer<typeof IdeaItemSchema>
-export type IdeasJson = z.infer<typeof IdeasJsonSchema>
-
-// Legacy type for backwards compatibility
-export type IdeasSchema = IdeaSchema[]
-
-// =============================================================================
-// Validation Helpers
-// =============================================================================
-
-/** Parse and validate ideas.json content */
-export const parseIdeas = (data: unknown): IdeasJson => IdeasJsonSchema.parse(data)
-export const safeParseIdeas = (data: unknown) => IdeasJsonSchema.safeParse(data)
-
-// =============================================================================
-// Defaults
-// =============================================================================
-
-export const DEFAULT_IDEA: Omit<IdeaSchema, 'id' | 'text'> = {
-  priority: 'medium',
-  status: 'pending',
-  tags: [],
-  addedAt: new Date().toISOString(),
-}
-
-export const DEFAULT_IDEAS: IdeasJson = {
-  ideas: [],
-  lastUpdated: '',
-}

package/core/schemas/index.ts

@@ -1,53 +0,0 @@
-/**
- * Schemas Module
- *
- * TypeScript types and defaults for all project data.
- * MD-First Architecture: Markdown files are the source of truth.
- *
- * Structure: ~/.prjct-cli/projects/{projectId}/
- *   - core/     (now.md, next.md, context.md)
- *   - progress/ (shipped.md, metrics.md)
- *   - planning/ (ideas.md, roadmap.md, tasks/)
- *   - analysis/ (repo-summary.md)
- *   - memory/   (context.jsonl, patterns.json)
- */
-
-// Agents
-export * from './agents'
-// Analysis
-export * from './analysis'
-// Classification (LLM-based domain detection)
-export * from './classification'
-// Ideas
-export * from './ideas'
-// Issues (local cache of issue tracker issues)
-export * from './issues'
-// LLM output schemas (structured response validation)
-export * from './llm-output'
-// Model specification (AI provider model tracking)
-export * from './model'
-// Outcomes
-export * from './outcomes'
-// Permissions
-export * from './permissions'
-// Project metadata
-export * from './project'
-// Roadmap (features)
-export * from './roadmap'
-// Utilities (ID generators and path helpers)
-export {
-  GLOBAL_STORAGE,
-  generateFeatureId,
-  generateIdeaId,
-  generateSessionId,
-  generateShipId,
-  generateTaskId,
-  generateUUID,
-  getProjectPath,
-} from './schemas'
-// Shipped items
-export * from './shipped'
-// State (current task + queue)
-export * from './state'
-// Velocity (sprint-based tracking)
-export * from './velocity'

package/core/schemas/issues.ts

@@ -1,159 +0,0 @@
-/**
- * Issues Schema
- *
- * Defines the structure for issues.json - local cache of issue tracker issues.
- * Used for bidirectional sync with Linear/JIRA/etc.
- *
- * Location: ~/.prjct-cli/projects/{projectId}/storage/issues.json
- */
-
-import { z } from 'zod'
-
-// =============================================================================
-// Issue Provider Types
-// =============================================================================
-
-export const IssueProviderSchema = z.enum(['linear', 'jira', 'github', 'monday', 'asana', 'none'])
-export const IssueStatusSchema = z.enum([
-  'backlog',
-  'todo',
-  'in_progress',
-  'in_review',
-  'done',
-  'cancelled',
-])
-export const IssuePrioritySchema = z.enum(['none', 'urgent', 'high', 'medium', 'low'])
-export const IssueTypeSchema = z.enum(['feature', 'bug', 'improvement', 'task', 'chore', 'epic'])
-
-// =============================================================================
-// Cached Issue Schema
-// =============================================================================
-
-/**
- * Single cached issue from provider
- */
-export const CachedIssueSchema = z.object({
-  // Core identifiers
-  id: z.string(), // Provider UUID
-  identifier: z.string(), // Human-readable ID (e.g., "PRJ-123")
-
-  // Issue content
-  title: z.string(),
-  description: z.string().optional(),
-
-  // State
-  status: IssueStatusSchema,
-  priority: IssuePrioritySchema,
-  type: IssueTypeSchema.optional(),
-
-  // Metadata
-  assignee: z
-    .object({
-      id: z.string(),
-      name: z.string(),
-      email: z.string().optional(),
-    })
-    .optional(),
-  labels: z.array(z.string()).default([]),
-  team: z
-    .object({
-      id: z.string(),
-      name: z.string(),
-      key: z.string().optional(),
-    })
-    .optional(),
-  project: z
-    .object({
-      id: z.string(),
-      name: z.string(),
-    })
-    .optional(),
-
-  // URLs and timestamps
-  url: z.string(),
-  createdAt: z.string(), // ISO8601 from provider
-  updatedAt: z.string(), // ISO8601 from provider
-  fetchedAt: z.string(), // ISO8601 when we cached it
-})
-
-// =============================================================================
-// Issues JSON Schema (Root)
-// =============================================================================
-
-/**
- * Root schema for issues.json
- * Maps identifier -> CachedIssue for quick lookup
- */
-export const IssuesJsonSchema = z.object({
-  // Provider info
-  provider: IssueProviderSchema,
-
-  // Sync metadata
-  lastSync: z.string(), // ISO8601 of last full sync
-  staleAfter: z.number().default(1800000), // 30 minutes in ms
-
-  // Issues map: identifier -> issue
-  issues: z.record(z.string(), CachedIssueSchema),
-})
-
-// =============================================================================
-// Sync Result Schema
-// =============================================================================
-
-export const SyncResultSchema = z.object({
-  provider: IssueProviderSchema,
-  fetched: z.number(),
-  updated: z.number(),
-  errors: z.array(
-    z.object({
-      issueId: z.string(),
-      error: z.string(),
-    })
-  ),
-  timestamp: z.string(),
-})
-
-// =============================================================================
-// Inferred Types
-// =============================================================================
-
-export type IssueProvider = z.infer<typeof IssueProviderSchema>
-export type IssueStatus = z.infer<typeof IssueStatusSchema>
-export type IssuePriority = z.infer<typeof IssuePrioritySchema>
-export type IssueType = z.infer<typeof IssueTypeSchema>
-export type CachedIssue = z.infer<typeof CachedIssueSchema>
-export type IssuesJson = z.infer<typeof IssuesJsonSchema>
-export type SyncResult = z.infer<typeof SyncResultSchema>
-
-// =============================================================================
-// Validation Helpers
-// =============================================================================
-
-/** Parse and validate issues.json content */
-export const parseIssues = (data: unknown): IssuesJson => IssuesJsonSchema.parse(data)
-
-/** Safe parse with error result */
-export const safeParseIssues = (data: unknown) => IssuesJsonSchema.safeParse(data)
-
-// =============================================================================
-// Defaults
-// =============================================================================
-
-export const DEFAULT_ISSUES: IssuesJson = {
-  provider: 'none',
-  lastSync: '',
-  staleAfter: 1800000, // 30 minutes
-  issues: {},
-}
-
-/**
- * Create empty issues.json for a provider
- */
-export function createEmptyIssues(provider: IssueProvider): IssuesJson {
-  return {
-    provider,
-    lastSync: '',
-    staleAfter: 1800000,
-    issues: {},
-  }
-}