cmp-standards 2.0.1 → 2.6.0

package/dist/schema/tracking.js

@@ -0,0 +1,204 @@
+/**
+ * @file Schema de tracking para tareas, mejoras y sesiones
+ * @description Define los tipos y estructuras para el sistema de tracking obligatorio
+ */
+import { z } from 'zod';
+// =============================================================================
+// TASK - Tarea en progreso
+// =============================================================================
+export const TaskStatusSchema = z.enum([
+    'pending',
+    'in_progress',
+    'completed',
+    'blocked'
+]);
+export const TaskResultSchema = z.enum([
+    'success',
+    'partial',
+    'blocked'
+]);
+export const ImprovementSchema = z.object({
+    id: z.string(),
+    area: z.string(),
+    title: z.string(),
+    description: z.string(),
+    priority: z.enum(['low', 'medium', 'high', 'critical']),
+    effort: z.enum(['trivial', 'small', 'medium', 'large']).optional(),
+    detectedAt: z.string().datetime(),
+    detectedBy: z.string().optional(),
+    implementedAt: z.string().datetime().optional(),
+    implementedInTask: z.string().optional()
+});
+export const TaskContentSchema = z.object({
+    // Identificación
+    title: z.string().min(1).max(200),
+    description: z.string().optional(),
+    userRequest: z.string(), // Mensaje original del usuario
+    // Plan de trabajo
+    plan: z.array(z.string()).min(1),
+    currentStep: z.number().min(0),
+    // Contexto
+    domain: z.string(),
+    files: z.array(z.string()).default([]),
+    // Tracking de sesión
+    sessionId: z.string(),
+    agentId: z.string().optional(),
+    // Timestamps
+    startedAt: z.string().datetime(),
+    lastActivityAt: z.string().datetime(),
+    completedAt: z.string().datetime().optional(),
+    // Resultado (al completar)
+    result: TaskResultSchema.optional(),
+    resultNotes: z.string().optional(),
+    // Mejoras detectadas (OBLIGATORIO al completar)
+    improvements: z.array(ImprovementSchema).default([]),
+    // Lecciones aprendidas
+    lessons: z.array(z.string()).default([])
+});
+export const TaskSchema = z.object({
+    id: z.string(),
+    type: z.literal('task'),
+    status: TaskStatusSchema,
+    system: z.string(),
+    content: TaskContentSchema,
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime()
+});
+// =============================================================================
+// IMPROVEMENT - Mejora detectada
+// =============================================================================
+export const ImprovementStatusSchema = z.enum([
+    'pending',
+    'in_progress',
+    'implemented',
+    'rejected',
+    'deferred'
+]);
+export const ImprovementContentSchema = z.object({
+    // Qué mejorar
+    area: z.string(),
+    title: z.string().min(1).max(200),
+    description: z.string(),
+    // Contexto de detección
+    detectedInTask: z.string(), // ID de la tarea donde se detectó
+    detectedBy: z.string(), // agentId que lo detectó
+    detectedAt: z.string().datetime(),
+    // Prioridad y esfuerzo
+    priority: z.enum(['low', 'medium', 'high', 'critical']),
+    effort: z.enum(['trivial', 'small', 'medium', 'large']).optional(),
+    // Implementación
+    implementedAt: z.string().datetime().optional(),
+    implementedInTask: z.string().optional(),
+    implementedBy: z.string().optional(),
+    // Rechazo
+    rejectedAt: z.string().datetime().optional(),
+    rejectedReason: z.string().optional()
+});
+export const ImprovementRecordSchema = z.object({
+    id: z.string(),
+    type: z.literal('improvement'),
+    status: ImprovementStatusSchema,
+    system: z.string(),
+    content: ImprovementContentSchema,
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime()
+});
+// =============================================================================
+// SESSION - Sesión de trabajo
+// =============================================================================
+export const SessionContentSchema = z.object({
+    // Identificación
+    sessionId: z.string(),
+    userId: z.string().optional(),
+    system: z.string(),
+    // Contexto
+    projectPath: z.string().optional(),
+    ide: z.string().optional(), // 'vscode', 'cursor', 'terminal'
+    // Timestamps
+    startedAt: z.string().datetime(),
+    lastActivityAt: z.string().datetime(),
+    endedAt: z.string().datetime().optional(),
+    // Métricas
+    toolCalls: z.number().default(0),
+    tasksStarted: z.number().default(0),
+    tasksCompleted: z.number().default(0),
+    improvementsDetected: z.number().default(0)
+});
+export const SessionSchema = z.object({
+    id: z.string(),
+    type: z.literal('session'),
+    status: z.enum(['active', 'ended']),
+    system: z.string(),
+    content: SessionContentSchema,
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime()
+});
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Crear una nueva tarea con valores por defecto
+ */
+export function createTask(system, sessionId, options) {
+    const now = new Date().toISOString();
+    return {
+        id: `task_${Date.now()}`,
+        type: 'task',
+        status: 'in_progress',
+        system,
+        content: {
+            title: options.title,
+            description: options.description,
+            userRequest: options.userRequest,
+            plan: options.plan,
+            currentStep: 0,
+            domain: options.domain,
+            files: [],
+            sessionId,
+            agentId: options.agentId,
+            startedAt: now,
+            lastActivityAt: now,
+            improvements: [],
+            lessons: []
+        }
+    };
+}
+/**
+ * Crear una mejora detectada
+ */
+export function createImprovement(system, taskId, options) {
+    const now = new Date().toISOString();
+    return {
+        id: `imp_${Date.now()}`,
+        type: 'improvement',
+        status: 'pending',
+        system,
+        content: {
+            area: options.area,
+            title: options.title,
+            description: options.description,
+            detectedInTask: taskId,
+            detectedBy: options.detectedBy || 'unknown',
+            detectedAt: now,
+            priority: options.priority,
+            effort: options.effort
+        }
+    };
+}
+/**
+ * Validar que una tarea tiene mejoras antes de completar
+ */
+export function validateTaskCompletion(task) {
+    const errors = [];
+    if (!task.content.result) {
+        errors.push('Falta especificar el resultado (success/partial/blocked)');
+    }
+    if (task.content.improvements.length === 0) {
+        errors.push('Debes registrar al menos 1 mejora detectada');
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+//# sourceMappingURL=tracking.js.map

package/dist/schema/tracking.js.map

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

package/dist/services/ContextGenerator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Context Generator Service
+ *
+ * Generates fresh context from the database for LLM agents.
+ * Updates GEMINI.md or CLAUDE.md with recent memories and tasks.
+ */
+import type { DrizzleMemoryClient } from "../db/drizzle-client.js";
+export declare class ContextGenerator {
+    private client;
+    constructor(client: DrizzleMemoryClient);
+    /**
+     * Update a markdown file with fresh database context
+     */
+    generateContext(filePath: string): Promise<boolean>;
+}
+//# sourceMappingURL=ContextGenerator.d.ts.map

package/dist/services/ContextGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextGenerator.d.ts","sourceRoot":"","sources":["../../src/services/ContextGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB;IAIvC;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAmD1D"}

package/dist/services/ContextGenerator.js

@@ -0,0 +1,62 @@
+/**
+ * Context Generator Service
+ *
+ * Generates fresh context from the database for LLM agents.
+ * Updates GEMINI.md or CLAUDE.md with recent memories and tasks.
+ */
+import fs from "fs/promises";
+export class ContextGenerator {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Update a markdown file with fresh database context
+     */
+    async generateContext(filePath) {
+        try {
+            const [tasks, memories] = await Promise.all([
+                this.client.list({ type: "task", status: "in_progress", limit: 5 }),
+                this.client.list({ type: "memory", limit: 10 }),
+            ]);
+            const tasksMd = tasks
+                .map((t) => {
+                const c = t.content;
+                return `- [TASK] ${c.title || t.id}`;
+            })
+                .join("\n");
+            const memoriesMd = memories
+                .map((m) => {
+                const c = m.content;
+                return `- ${c.body || c.title} (${new Date(m.createdAt).toLocaleDateString()})`;
+            })
+                .join("\n");
+            let content = "";
+            try {
+                content = await fs.readFile(filePath, "utf-8");
+            }
+            catch {
+                content = "# Project Context\n\n";
+            }
+            const splitMarker = "## Hive Mind Context";
+            if (content.includes(splitMarker)) {
+                content = content.split(splitMarker)[0];
+            }
+            const freshContext = `
+${splitMarker}
+### Active Tasks
+${tasksMd || "- No active tasks."}
+
+### Recent Memories
+${memoriesMd || "- No recent memories."}
+`;
+            await fs.writeFile(filePath, content + freshContext, "utf-8");
+            return true;
+        }
+        catch (error) {
+            console.error("[ContextGenerator] Error:", error);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=ContextGenerator.js.map

package/dist/services/ContextGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextGenerator.js","sourceRoot":"","sources":["../../src/services/ContextGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,aAAa,CAAC;AAI7B,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAsB;IAEpC,YAAY,MAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB;QACpC,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;gBACnE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;aAChD,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,KAAK;iBAClB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,CAAC,GAAG,CAAC,CAAC,OAAkC,CAAC;gBAC/C,OAAO,YAAY,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;YACvC,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,MAAM,UAAU,GAAG,QAAQ;iBACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,CAAC,GAAG,CAAC,CAAC,OAAkC,CAAC;gBAC/C,OAAO,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CACxC,CAAC,CAAC,SAAU,CACb,CAAC,kBAAkB,EAAE,GAAG,CAAC;YAC5B,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,uBAAuB,CAAC;YACpC,CAAC;YAED,MAAM,WAAW,GAAG,sBAAsB,CAAC;YAC3C,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAE,CAAC;YAC3C,CAAC;YAED,MAAM,YAAY,GAAG;EACzB,WAAW;;EAEX,OAAO,IAAI,oBAAoB;;;EAG/B,UAAU,IAAI,uBAAuB;CACtC,CAAC;YAEI,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,YAAY,EAAE,OAAO,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/services/PlanManager.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @file PlanManager Service
+ * @description Gestiona planes de trabajo con checkpoints para continuidad multi-agente.
+ *
+ * Características:
+ * - Detección de planes similares al iniciar sesión
+ * - Checkpoints incrementales para save points
+ * - Soporte para merge de planes
+ * - Historial navegable
+ *
+ * @version 1.0.0
+ */
+import { type Plan, type PlanCheckpoint, type PlanMatch, type PlanStatus, type CheckpointType } from '../schema/plans.js';
+import type { DevSystem } from '../types/index.js';
+export interface CreatePlanOptions {
+    title: string;
+    description?: string;
+    originalPrompt: string;
+    domain?: string;
+    keywords?: string[];
+}
+export interface FindSimilarOptions {
+    prompt: string;
+    domain?: string;
+    limit?: number;
+    minSimilarity?: number;
+}
+export interface AddCheckpointOptions {
+    checkpointType: CheckpointType;
+    summary: string;
+    decisions?: PlanCheckpoint['decisions'];
+    nextSteps?: string[];
+    filesModified?: string[];
+}
+export declare class PlanManager {
+    private client;
+    private system;
+    private currentSessionId;
+    private agentId;
+    constructor(system: DevSystem, options?: {
+        sessionId?: string;
+        agentId?: string;
+    });
+    /**
+     * Crear un nuevo plan
+     */
+    create(options: CreatePlanOptions): Promise<Plan>;
+    /**
+     * Obtener plan por ID con validación Zod
+     */
+    get(planId: string): Promise<Plan | null>;
+    /**
+     * Obtener todos los planes activos
+     */
+    getActive(): Promise<Plan[]>;
+    /**
+     * Buscar planes similares a un prompt (optimizado para evitar N+1 queries)
+     */
+    findSimilar(options: FindSimilarOptions): Promise<PlanMatch[]>;
+    /**
+     * Actualizar estado del plan
+     */
+    updateStatus(planId: string, status: PlanStatus): Promise<void>;
+    /**
+     * Mergear dos planes
+     */
+    merge(targetPlanId: string, sourcePlanId: string): Promise<void>;
+    /**
+     * Agregar checkpoint a un plan
+     */
+    addCheckpoint(planId: string, options: AddCheckpointOptions): Promise<PlanCheckpoint>;
+    /**
+     * Obtener checkpoints de un plan con validación Zod
+     */
+    getCheckpoints(planId: string, limit?: number): Promise<PlanCheckpoint[]>;
+    /**
+     * Obtener último checkpoint de un plan
+     */
+    getLastCheckpoint(planId: string): Promise<PlanCheckpoint | null>;
+    /**
+     * Generar contexto de planes para session start
+     */
+    getSessionContext(currentPrompt?: string): Promise<string>;
+}
+/**
+ * Obtener o crear instancia de PlanManager
+ */
+export declare function getPlanManager(system: DevSystem, options?: {
+    sessionId?: string;
+    agentId?: string;
+}): PlanManager;
+/**
+ * Crear nueva instancia de PlanManager
+ */
+export declare function createPlanManager(system: DevSystem, options?: {
+    sessionId?: string;
+    agentId?: string;
+}): PlanManager;
+//# sourceMappingURL=PlanManager.d.ts.map

package/dist/services/PlanManager.d.ts.map

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