prjct-cli 1.22.0 → 1.23.0

package/core/schemas/llm-output.ts

@@ -1,170 +0,0 @@
-/**
- * LLM Output Schemas
- *
- * Zod schemas for all LLM prompt response types.
- * These schemas are:
- * 1. Injected into prompts as explicit format instructions
- * 2. Used to validate LLM responses before storage or use
- * 3. Define the contract between prompts and response handling
- *
- * @see PRJ-264
- */
-
-import { z } from 'zod'
-import { ClassificationDomainSchema, TaskClassificationSchema } from './classification'
-
-// =============================================================================
-// Re-export classification schema (it IS an LLM output schema)
-// =============================================================================
-
-export { TaskClassificationSchema } from './classification'
-
-// =============================================================================
-// Agent Assignment Schema
-// =============================================================================
-
-/** LLM response when selecting which agent should handle a task */
-export const AgentAssignmentSchema = z.object({
-  /** Agent file name (e.g., "backend.md", "frontend.md") */
-  agentName: z.string(),
-  /** Why this agent was selected */
-  reasoning: z.string(),
-  /** Confidence in the assignment (0-1) */
-  confidence: z.number().min(0).max(1),
-})
-
-// =============================================================================
-// Subtask Breakdown Schema
-// =============================================================================
-
-/** LLM response when breaking a task into subtasks */
-export const SubtaskBreakdownSchema = z.object({
-  /** Subtasks in execution order */
-  subtasks: z.array(
-    z.object({
-      /** Short description of the subtask */
-      description: z.string(),
-      /** Domain this subtask belongs to */
-      domain: ClassificationDomainSchema,
-      /** Suggested agent for this subtask */
-      agent: z.string(),
-      /** IDs of subtasks this depends on (by index, 0-based) */
-      dependsOn: z.array(z.number()),
-    })
-  ),
-  /** Estimated total effort */
-  effort: z.enum(['low', 'medium', 'high']),
-})
-
-// =============================================================================
-// Schema-to-Prompt Serializer
-// =============================================================================
-
-/**
- * Registry of output schemas keyed by prompt type.
- * Used by prompt-builder to inject the correct schema into each prompt.
- */
-export const OUTPUT_SCHEMAS: Record<string, { schema: z.ZodTypeAny; example: string }> = {
-  classification: {
-    schema: TaskClassificationSchema,
-    example: JSON.stringify(
-      {
-        primaryDomain: 'backend',
-        secondaryDomains: ['database'],
-        confidence: 0.9,
-        filePatterns: ['src/api/**'],
-        relevantAgents: ['backend.md'],
-      },
-      null,
-      2
-    ),
-  },
-  agentAssignment: {
-    schema: AgentAssignmentSchema,
-    example: JSON.stringify(
-      {
-        agentName: 'backend.md',
-        reasoning: 'Task involves API endpoint creation',
-        confidence: 0.85,
-      },
-      null,
-      2
-    ),
-  },
-  subtaskBreakdown: {
-    schema: SubtaskBreakdownSchema,
-    example: JSON.stringify(
-      {
-        subtasks: [
-          {
-            description: 'Add schema validation',
-            domain: 'backend',
-            agent: 'backend.md',
-            dependsOn: [],
-          },
-          {
-            description: 'Add unit tests',
-            domain: 'testing',
-            agent: 'testing.md',
-            dependsOn: [0],
-          },
-        ],
-        effort: 'medium',
-      },
-      null,
-      2
-    ),
-  },
-}
-
-/**
- * Render a schema as prompt instructions.
- * Returns a markdown block that tells the LLM exactly what format to use.
- */
-export function renderSchemaForPrompt(schemaType: string): string | null {
-  const entry = OUTPUT_SCHEMAS[schemaType]
-  if (!entry) return null
-
-  return `## OUTPUT FORMAT
-
-Return ONLY valid JSON matching this schema (no markdown, no explanation):
-
-\`\`\`json
-${entry.example}
-\`\`\`
-
-Fields:
-${describeSchema(entry.schema)}`
-}
-
-/**
- * Extract field descriptions from a Zod object schema.
- */
-function describeSchema(schema: z.ZodTypeAny): string {
-  if (schema instanceof z.ZodObject) {
-    const shape = schema.shape as Record<string, z.ZodTypeAny>
-    return Object.entries(shape)
-      .map(([key, field]) => `- \`${key}\`: ${describeField(field)}`)
-      .join('\n')
-  }
-  return '(see example above)'
-}
-
-/**
- * Describe a single Zod field type for prompt injection.
- */
-function describeField(field: z.ZodTypeAny): string {
-  if (field instanceof z.ZodString) return 'string'
-  if (field instanceof z.ZodNumber) return 'number'
-  if (field instanceof z.ZodEnum) return `one of: ${(field.options as string[]).join(', ')}`
-  if (field instanceof z.ZodArray) return `array of ${describeField(field.element)}`
-  if (field instanceof z.ZodObject) return 'object'
-  return 'any'
-}
-
-// =============================================================================
-// Inferred Types
-// =============================================================================
-
-export type AgentAssignment = z.infer<typeof AgentAssignmentSchema>
-export type SubtaskBreakdown = z.infer<typeof SubtaskBreakdownSchema>

package/core/schemas/metrics.ts

@@ -1,143 +0,0 @@
-/**
- * Metrics Schema
- *
- * Defines the structure for metrics.json - value dashboard metrics.
- * Tracks token savings, sync performance, and usage trends.
- *
- * Uses Zod for runtime validation and TypeScript type inference.
- * @version 1.0.0
- */
-
-import { z } from 'zod'
-
-// =============================================================================
-// Zod Schemas - Source of Truth
-// =============================================================================
-
-/**
- * Daily stats for trend analysis
- */
-export const DailyStatsSchema = z.object({
-  date: z.string(), // YYYY-MM-DD
-  tokensSaved: z.number(), // Tokens saved that day
-  syncs: z.number(), // Number of syncs
-  avgCompressionRate: z.number(), // Average compression rate (0-1)
-  totalDuration: z.number(), // Total sync time in ms
-})
-
-/**
- * Agent usage tracking
- */
-export const AgentUsageSchema = z.object({
-  agentName: z.string(), // e.g., "backend", "frontend"
-  usageCount: z.number(), // Times invoked
-  tokensSaved: z.number(), // Tokens saved by this agent
-})
-
-/**
- * Main metrics JSON structure
- */
-export const MetricsJsonSchema = z.object({
-  // Token metrics
-  totalTokensSaved: z.number(),
-  avgCompressionRate: z.number(), // 0-1 (e.g., 0.63 = 63% reduction)
-
-  // Sync metrics
-  syncCount: z.number(),
-  watchTriggers: z.number(), // Auto-syncs from watch mode
-  avgSyncDuration: z.number(), // Average in ms
-  totalSyncDuration: z.number(), // Total in ms
-
-  // Agent usage
-  agentUsage: z.array(AgentUsageSchema),
-
-  // Time series for trends
-  dailyStats: z.array(DailyStatsSchema),
-
-  // Metadata
-  firstSync: z.string(), // ISO8601 - when tracking started
-  lastUpdated: z.string(), // ISO8601
-})
-
-// =============================================================================
-// Inferred Types
-// =============================================================================
-
-export type DailyStats = z.infer<typeof DailyStatsSchema>
-export type AgentUsage = z.infer<typeof AgentUsageSchema>
-export type MetricsJson = z.infer<typeof MetricsJsonSchema>
-
-// =============================================================================
-// Validation Helpers
-// =============================================================================
-
-/** Parse and validate metrics.json content */
-export const parseMetrics = (data: unknown): MetricsJson => MetricsJsonSchema.parse(data)
-
-/** Safe parse with error result */
-export const safeParseMetrics = (data: unknown) => MetricsJsonSchema.safeParse(data)
-
-// =============================================================================
-// Defaults
-// =============================================================================
-
-export const DEFAULT_METRICS: MetricsJson = {
-  totalTokensSaved: 0,
-  avgCompressionRate: 0,
-  syncCount: 0,
-  watchTriggers: 0,
-  avgSyncDuration: 0,
-  totalSyncDuration: 0,
-  agentUsage: [],
-  dailyStats: [],
-  firstSync: '',
-  lastUpdated: '',
-}
-
-// =============================================================================
-// Cost Calculation Constants (January 2026 Pricing)
-// =============================================================================
-
-/**
- * Token costs per 1000 tokens (INPUT pricing)
- * Source: https://docs.anthropic.com/en/docs/about-claude/models
- *
- * Used for estimating cost savings from context compression
- */
-export const TOKEN_COSTS = {
-  // Current models (2026)
-  'claude-opus-4.5': 0.005, // $5/M input - flagship
-  'claude-sonnet-4.5': 0.003, // $3/M input - balanced
-  'claude-haiku-4.5': 0.001, // $1/M input - fastest
-  // Legacy models
-  'claude-opus-4': 0.015, // $15/M input
-  'claude-sonnet-4': 0.003, // $3/M input
-  'claude-3-opus': 0.015, // $15/M input (deprecated)
-  'claude-3-sonnet': 0.003, // $3/M input (deprecated)
-  // Other providers
-  'gpt-4o': 0.0025, // $2.50/M input
-  'gpt-4': 0.01, // $10/M input (legacy)
-  'gemini-pro': 0.00125, // $1.25/M input
-  // Default: Claude Sonnet (most common for Claude Code)
-  default: 0.003, // $3/M input
-} as const
-
-export type ModelName = keyof typeof TOKEN_COSTS
-
-/**
- * Calculate estimated cost saved based on tokens
- */
-export function estimateCostSaved(tokens: number, model: ModelName = 'default'): number {
-  const costPer1k = TOKEN_COSTS[model] || TOKEN_COSTS.default
-  return (tokens / 1000) * costPer1k
-}
-
-/**
- * Format cost as currency string
- */
-export function formatCost(cost: number): string {
-  if (cost < 0.01) {
-    return `$${(cost * 100).toFixed(2)}¢`
-  }
-  return `$${cost.toFixed(2)}`
-}

package/core/schemas/model.ts

@@ -1,153 +0,0 @@
-/**
- * Model Schema
- *
- * Defines model specification types for AI providers.
- * Records which model was used for each analysis and task,
- * enabling consistency tracking and mismatch warnings.
- *
- * @see PRJ-265
- */
-
-import { z } from 'zod'
-
-// =============================================================================
-// Provider-Specific Model Identifiers
-// =============================================================================
-
-/** Claude model identifiers (short names matching agent frontmatter convention) */
-export const ClaudeModelSchema = z.enum(['opus', 'sonnet', 'haiku'])
-
-/** Gemini model identifiers */
-export const GeminiModelSchema = z.enum(['2.5-pro', '2.5-flash', '2.0-flash'])
-
-/** Generic model identifier - allows any string for future providers */
-export const AIModelSchema = z.string().min(1)
-
-// =============================================================================
-// Supported Models Per Provider
-// =============================================================================
-
-export const SUPPORTED_MODELS: Record<string, readonly string[]> = {
-  claude: ['opus', 'sonnet', 'haiku'],
-  gemini: ['2.5-pro', '2.5-flash', '2.0-flash'],
-  cursor: [], // Multi-model IDE, user selects model
-  windsurf: [], // Multi-model IDE, user selects model
-  antigravity: [], // Platform-managed
-} as const
-
-export const DEFAULT_MODELS: Record<string, string> = {
-  claude: 'sonnet',
-  gemini: '2.5-flash',
-} as const
-
-// =============================================================================
-// Minimum CLI Versions
-// =============================================================================
-
-export const MIN_CLI_VERSIONS: Record<string, string> = {
-  claude: '1.0.0',
-  gemini: '1.0.0',
-} as const
-
-// =============================================================================
-// Model Metadata - Recorded Per Operation
-// =============================================================================
-
-/** Model metadata recorded with each analysis or task */
-export const ModelMetadataSchema = z.object({
-  /** Provider name (e.g., 'claude', 'gemini') */
-  provider: z.string(),
-  /** Model identifier (e.g., 'opus', 'sonnet', '2.5-pro') */
-  model: z.string(),
-  /** CLI version used */
-  cliVersion: z.string().optional(),
-  /** When this was recorded */
-  recordedAt: z.string(),
-})
-
-// =============================================================================
-// Model Configuration - Per Project
-// =============================================================================
-
-/** Per-project model preference */
-export const ModelPreferenceSchema = z.object({
-  /** Preferred model for this project */
-  preferredModel: z.string().optional(),
-  /** Model used for last analysis (for mismatch detection) */
-  lastAnalysisModel: ModelMetadataSchema.optional(),
-})
-
-// =============================================================================
-// Inferred Types
-// =============================================================================
-
-export type ClaudeModel = z.infer<typeof ClaudeModelSchema>
-export type GeminiModel = z.infer<typeof GeminiModelSchema>
-export type ModelMetadata = z.infer<typeof ModelMetadataSchema>
-export type ModelPreference = z.infer<typeof ModelPreferenceSchema>
-
-// =============================================================================
-// Validation Helpers
-// =============================================================================
-
-/** Check if a model is valid for a given provider */
-export function isValidModelForProvider(provider: string, model: string): boolean {
-  const supported = SUPPORTED_MODELS[provider]
-  if (!supported || supported.length === 0) return true // No restriction for multi-model IDEs
-  return supported.includes(model)
-}
-
-/** Get the default model for a provider */
-export function getDefaultModel(provider: string): string | null {
-  return DEFAULT_MODELS[provider] ?? null
-}
-
-/** Get supported models for a provider */
-export function getSupportedModels(provider: string): readonly string[] {
-  return SUPPORTED_MODELS[provider] ?? []
-}
-
-/** Get minimum CLI version for a provider */
-export function getMinCliVersion(provider: string): string | null {
-  return MIN_CLI_VERSIONS[provider] ?? null
-}
-
-/**
- * Compare semver versions. Returns:
- *  -1 if a < b
- *   0 if a == b
- *   1 if a > b
- */
-export function compareSemver(a: string, b: string): -1 | 0 | 1 {
-  const pa = a.split('.').map(Number)
-  const pb = b.split('.').map(Number)
-  for (let i = 0; i < 3; i++) {
-    const va = pa[i] ?? 0
-    const vb = pb[i] ?? 0
-    if (va < vb) return -1
-    if (va > vb) return 1
-  }
-  return 0
-}
-
-/** Check if a CLI version meets minimum requirements */
-export function meetsMinVersion(provider: string, version: string): boolean {
-  const min = MIN_CLI_VERSIONS[provider]
-  if (!min) return true // No minimum defined
-  return compareSemver(version, min) >= 0
-}
-
-/**
- * Check for model mismatch between analysis and current task.
- * Returns a warning message if the models differ, or null if they match.
- */
-export function checkModelMismatch(
-  analysisModel: ModelMetadata | undefined,
-  taskModel: ModelMetadata | undefined
-): string | null {
-  if (!analysisModel || !taskModel) return null
-  if (analysisModel.provider !== taskModel.provider || analysisModel.model !== taskModel.model) {
-    return `⚠️ Model mismatch: analysis used ${analysisModel.provider}/${analysisModel.model}, but task is using ${taskModel.provider}/${taskModel.model}. Results may differ.`
-  }
-  return null
-}