cmp-standards 2.0.1 → 2.6.0

package/dist/schema/plans.js

@@ -0,0 +1,180 @@
+/**
+ * @file Schema de Plans con Checkpoints para continuidad multi-agente
+ * @description Sistema de planes persistentes que sobreviven cierres de sesión
+ * y soportan trabajo colaborativo entre múltiples agentes.
+ *
+ * Arquitectura:
+ * - Plan: Entidad de alto nivel (objetivo, contexto, keywords)
+ * - PlanCheckpoint: Status updates incrementales
+ * - PlanMerge: Cuando dos planes se unifican
+ *
+ * @version 1.0.0
+ */
+import { z } from 'zod';
+import { ulid } from 'ulid';
+// =============================================================================
+// PLAN - Objetivo de alto nivel
+// =============================================================================
+export const PlanStatusSchema = z.enum([
+    'active', // En progreso
+    'paused', // Pausado (se puede retomar)
+    'completed', // Completado exitosamente
+    'abandoned', // Abandonado (no se completó)
+    'merged' // Fusionado con otro plan
+]);
+export const PlanSchema = z.object({
+    id: z.string(),
+    type: z.literal('plan'),
+    // Identificación
+    title: z.string().min(1).max(200),
+    description: z.string().optional(),
+    // Para matching semántico
+    keywords: z.array(z.string()).default([]),
+    domain: z.string().optional(), // finances, reserves, boats, etc.
+    // Estado
+    status: PlanStatusSchema,
+    // Contexto original
+    originalPrompt: z.string(), // El prompt que inició el plan
+    // Relaciones
+    parentPlanId: z.string().optional(), // Si fue mergeado desde otro
+    mergedFromIds: z.array(z.string()).default([]), // Planes que se fusionaron aquí
+    // Tareas asociadas (IDs de DEV_Items type='task')
+    taskIds: z.array(z.string()).default([]),
+    // Tracking
+    system: z.string(),
+    createdBy: z.string(), // agentId o 'user'
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    completedAt: z.string().datetime().optional(),
+    // Último checkpoint (denormalizado para acceso rápido)
+    lastCheckpointId: z.string().optional(),
+    lastCheckpointSummary: z.string().optional(),
+});
+// =============================================================================
+// PLAN CHECKPOINT - Status updates incrementales
+// =============================================================================
+export const CheckpointTypeSchema = z.enum([
+    'progress', // Avance normal
+    'decision', // Decisión tomada
+    'blocker', // Encontró un blocker
+    'pivot', // Cambio de dirección
+    'handoff', // Entrega a otro agente
+    'resume', // Retomando después de pausa
+    'complete' // Checkpoint final
+]);
+export const PlanCheckpointSchema = z.object({
+    id: z.string(),
+    type: z.literal('plan_checkpoint'),
+    // Relación
+    planId: z.string(),
+    // Contenido
+    checkpointType: CheckpointTypeSchema,
+    summary: z.string(), // Qué se hizo/decidió
+    // Decisiones (si las hay)
+    decisions: z.array(z.object({
+        decision: z.string(),
+        rationale: z.string().optional(),
+        alternatives: z.array(z.string()).optional(),
+    })).default([]),
+    // Próximos pasos sugeridos
+    nextSteps: z.array(z.string()).default([]),
+    // Archivos afectados en este checkpoint
+    filesModified: z.array(z.string()).default([]),
+    // Contexto
+    agentId: z.string(),
+    sessionId: z.string(),
+    // Timestamps
+    createdAt: z.string().datetime(),
+});
+// =============================================================================
+// PLAN MATCH RESULT - Para detección de planes similares
+// =============================================================================
+export const PlanMatchSchema = z.object({
+    planId: z.string(),
+    title: z.string(),
+    similarity: z.number().min(0).max(1), // 0-1 score
+    matchReason: z.enum(['keyword', 'semantic', 'domain', 'recent']),
+    lastActivity: z.string().datetime(),
+    checkpointCount: z.number(),
+    status: PlanStatusSchema,
+});
+// =============================================================================
+// HELPERS
+// =============================================================================
+/**
+ * Crear un nuevo plan
+ */
+export function createPlan(options) {
+    return {
+        id: `plan_${ulid()}`,
+        type: 'plan',
+        title: options.title,
+        description: options.description,
+        keywords: options.keywords || extractKeywords(options.title + ' ' + (options.description || '')),
+        domain: options.domain,
+        status: 'active',
+        originalPrompt: options.originalPrompt,
+        taskIds: [],
+        mergedFromIds: [],
+        system: options.system,
+        createdBy: options.createdBy,
+    };
+}
+/**
+ * Crear un checkpoint de progreso
+ */
+export function createCheckpoint(options) {
+    return {
+        id: `chkpt_${ulid()}`,
+        type: 'plan_checkpoint',
+        planId: options.planId,
+        checkpointType: options.checkpointType,
+        summary: options.summary,
+        decisions: options.decisions || [],
+        nextSteps: options.nextSteps || [],
+        filesModified: options.filesModified || [],
+        agentId: options.agentId,
+        sessionId: options.sessionId,
+    };
+}
+/**
+ * Extraer keywords de un texto para matching
+ */
+export function extractKeywords(text) {
+    // Stop words en español e inglés
+    const stopWords = new Set([
+        'el', 'la', 'los', 'las', 'un', 'una', 'de', 'del', 'en', 'con', 'para', 'por', 'que', 'se', 'es', 'y', 'a',
+        'the', 'a', 'an', 'in', 'on', 'at', 'to', 'for', 'of', 'with', 'by', 'from', 'is', 'are', 'was', 'were',
+        'be', 'been', 'being', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should',
+        'this', 'that', 'these', 'those', 'it', 'its', 'and', 'or', 'but', 'if', 'then', 'else', 'when', 'where',
+        'como', 'donde', 'cuando', 'porque', 'pero', 'sino', 'aunque', 'mientras', 'hasta', 'desde',
+    ]);
+    // Extraer palabras significativas
+    const words = text
+        .toLowerCase()
+        .replace(/[^a-záéíóúñü\s-]/g, ' ')
+        .split(/\s+/)
+        .filter(w => w.length > 2 && !stopWords.has(w));
+    // Deduplicar y limitar
+    return Array.from(new Set(words)).slice(0, 15);
+}
+/**
+ * Calcular similitud entre dos conjuntos de keywords
+ */
+export function calculateKeywordSimilarity(keywords1, keywords2) {
+    if (keywords1.length === 0 || keywords2.length === 0)
+        return 0;
+    const set1 = new Set(keywords1.map(k => k.toLowerCase()));
+    const set2 = new Set(keywords2.map(k => k.toLowerCase()));
+    let matches = 0;
+    const set1Array = Array.from(set1);
+    for (const k of set1Array) {
+        if (set2.has(k))
+            matches++;
+    }
+    // Jaccard similarity
+    const combined = Array.from(set1).concat(Array.from(set2));
+    const union = new Set(combined).size;
+    return matches / union;
+}
+//# sourceMappingURL=plans.js.map

package/dist/schema/plans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.js","sourceRoot":"","sources":["../../src/schema/plans.ts"],"names":[],"mappings":"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"}