monomind 2.7.4 → 2.7.6

package/packages/@monomind/cli/dist/src/mcp-tools/hooks-synthesis.js

@@ -1,196 +0,0 @@
-/**
- * Hooks Dynamic Agent Synthesis MCP Tools
- *
- * Wires the previously-orphaned @monomind/hooks synthesis subsystem
- * (EphemeralRegistry, TTLCleanup, AgentPromoter, DGMArchive,
- * SynthesisPromptTemplate — "Task 47") into the CLI's live MCP tool
- * registry.
- *
- * Architecture: @monomind/hooks has no LLM client of its own, so the actual
- * agent-definition generation is delegated to the calling agent (e.g. Claude
- * Code via the Task tool), which already has reasoning + generation
- * capability. The flow is:
- *   1. hooks_synthesis_prompt   — caller gets a structured prompt describing
- *      the task that had no good routing match.
- *   2. Caller (LLM) generates an AgentDefinition JSON object from the prompt.
- *   3. hooks_synthesis_register — validates the definition (zod schema),
- *      writes it to disk as a markdown agent file, and registers it in the
- *      ephemeral registry with a TTL.
- *   4. hooks_synthesis_status   — introspect the registry / DGM archive.
- *   5. hooks_synthesis_promote  — promote a well-performing ephemeral agent
- *      to the permanent registry (copies file + records in DGM archive).
- *   6. hooks_synthesis_cleanup  — delete expired, non-promoted agents.
- */
-import { randomUUID } from 'node:crypto';
-import { join } from 'node:path';
-import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
-import { getProjectCwd } from './types.js';
-import { agentDefinitionSchema, SynthesisPromptTemplate, EphemeralRegistry, TTLCleanup, AgentPromoter, DGMArchive, } from '@monomind/hooks';
-const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000; // 24h
-function getEphemeralAgentDir() {
-    return join(getProjectCwd(), '.claude', 'agents', 'ephemeral');
-}
-export const hooksSynthesisPrompt = {
-    name: 'hooks_synthesis-prompt',
-    description: 'Build an LLM prompt requesting a new synthesized agent definition, for use when hooks_route finds no confident match. ' +
-        'The caller generates the AgentDefinition JSON from the returned prompt, then submits it via hooks_synthesis-register.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            taskDescription: { type: 'string', description: 'The task that had no confident agent match' },
-            topMatchSlug: { type: 'string', description: 'Slug of the closest existing agent match' },
-            topMatchScore: { type: 'number', description: 'Confidence score of the closest match (0-1)' },
-            existingAgentCount: { type: 'number', description: 'Number of existing agents considered' },
-            existingSlugs: { type: 'array', items: { type: 'string' }, description: 'Slugs of existing agents to avoid colliding with' },
-        },
-        required: ['taskDescription'],
-    },
-    handler: async (params) => {
-        const taskDescription = params.taskDescription;
-        const topMatchSlug = params.topMatchSlug ?? 'none';
-        const topMatchScore = typeof params.topMatchScore === 'number' ? params.topMatchScore : 0;
-        const existingAgentCount = typeof params.existingAgentCount === 'number' ? params.existingAgentCount : 0;
-        const existingSlugs = Array.isArray(params.existingSlugs) ? params.existingSlugs : [];
-        const requestId = randomUUID();
-        const prompt = SynthesisPromptTemplate.build({
-            requestId,
-            taskDescription,
-            topMatchSlug,
-            topMatchScore,
-            existingAgentCount,
-            requestedAt: new Date(),
-        }, existingSlugs);
-        return { requestId, prompt };
-    },
-};
-export const hooksSynthesisRegister = {
-    name: 'hooks_synthesis-register',
-    description: 'Validate and register a synthesized agent definition (from hooks_synthesis-prompt). ' +
-        'Writes the agent as a markdown file and registers it in the ephemeral registry with a TTL.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            agentDefinition: { type: 'object', description: 'AgentDefinition JSON produced from the synthesis prompt' },
-            synthesisRequestId: { type: 'string', description: 'requestId returned by hooks_synthesis-prompt' },
-            ttlMs: { type: 'number', description: 'Time-to-live in ms before the agent expires (default: 24h)' },
-        },
-        required: ['agentDefinition', 'synthesisRequestId'],
-    },
-    handler: async (params) => {
-        const raw = params.agentDefinition;
-        const synthesisRequestId = params.synthesisRequestId;
-        const ttlMs = typeof params.ttlMs === 'number' && params.ttlMs > 0 ? params.ttlMs : DEFAULT_TTL_MS;
-        const parsed = agentDefinitionSchema.safeParse({
-            ...raw,
-            synthesizedAt: raw.synthesizedAt ?? new Date().toISOString(),
-        });
-        if (!parsed.success) {
-            return { registered: false, error: parsed.error.issues.map(i => `${i.path.join('.')}: ${i.message}`).join('; ') };
-        }
-        const def = parsed.data;
-        const registry = EphemeralRegistry.getInstance();
-        if (registry.isRegistered(def.slug)) {
-            return { registered: false, error: `slug "${def.slug}" is already registered` };
-        }
-        const agentDir = getEphemeralAgentDir();
-        if (!existsSync(agentDir))
-            mkdirSync(agentDir, { recursive: true });
-        const filePath = join(agentDir, `${def.slug}.md`);
-        writeFileSync(filePath, SynthesisPromptTemplate.toAgentMarkdown(def), 'utf-8');
-        const now = new Date();
-        registry.register({
-            slug: def.slug,
-            filePath,
-            createdAt: now,
-            expiresAt: new Date(now.getTime() + ttlMs),
-            usageCount: 0,
-            avgQualityScore: 0,
-            promoted: false,
-            synthesisRequestId,
-        });
-        return { registered: true, slug: def.slug, filePath, expiresAt: new Date(now.getTime() + ttlMs).toISOString() };
-    },
-};
-export const hooksSynthesisStatus = {
-    name: 'hooks_synthesis-status',
-    description: 'Introspect the ephemeral agent registry and DGM MAP-Elites archive: registered agents, usage/quality, and promotion candidates.',
-    inputSchema: { type: 'object', properties: {} },
-    handler: async () => {
-        const registry = EphemeralRegistry.getInstance();
-        const all = [...registry.getAll().values()];
-        const candidates = registry.getPromotionCandidates();
-        const archive = DGMArchive.getInstance();
-        return {
-            registrySize: registry.size,
-            agents: all.map(r => ({
-                slug: r.slug,
-                usageCount: r.usageCount,
-                avgQualityScore: r.avgQualityScore,
-                promoted: r.promoted,
-                expiresAt: r.expiresAt.toISOString(),
-            })),
-            promotionCandidates: candidates.map(c => c.slug),
-            dgmArchive: {
-                size: archive.size,
-                best: archive.best() ?? null,
-                niches: archive.listAll(),
-            },
-        };
-    },
-};
-export const hooksSynthesisPromote = {
-    name: 'hooks_synthesis-promote',
-    description: 'Promote an eligible ephemeral agent (min usage + quality threshold) to the permanent agent directory and DGM archive.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            slug: { type: 'string', description: 'Slug of the ephemeral agent to promote' },
-            targetDir: { type: 'string', description: 'Permanent agent directory (default: .claude/agents)' },
-        },
-        required: ['slug'],
-    },
-    handler: async (params) => {
-        const slug = params.slug;
-        const targetDir = params.targetDir || join(getProjectCwd(), '.claude', 'agents');
-        const registry = EphemeralRegistry.getInstance();
-        const record = registry.get(slug);
-        if (!record)
-            return { promoted: false, error: `slug "${slug}" not found in registry` };
-        if (!AgentPromoter.isEligible(record)) {
-            return {
-                promoted: false,
-                error: `slug "${slug}" is not eligible (needs usageCount>=${AgentPromoter.MIN_USAGE_COUNT}, avgQualityScore>=${AgentPromoter.PROMOTION_THRESHOLD})`,
-                usageCount: record.usageCount,
-                avgQualityScore: record.avgQualityScore,
-            };
-        }
-        const destPath = await AgentPromoter.promote(record, targetDir);
-        registry.markPromoted(slug);
-        return { promoted: true, slug, destPath };
-    },
-};
-export const hooksSynthesisCleanup = {
-    name: 'hooks_synthesis-cleanup',
-    description: 'Delete expired, non-promoted ephemeral agents from the registry and disk (TTL cleanup).',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            agentDir: { type: 'string', description: 'Ephemeral agent directory (default: .claude/agents/ephemeral)' },
-        },
-    },
-    handler: async (params) => {
-        const agentDir = params.agentDir || getEphemeralAgentDir();
-        const registry = EphemeralRegistry.getInstance();
-        const cleanup = new TTLCleanup(agentDir);
-        const result = await cleanup.runCleanup(registry);
-        return result;
-    },
-};
-export const hooksSynthesisTools = [
-    hooksSynthesisPrompt,
-    hooksSynthesisRegister,
-    hooksSynthesisStatus,
-    hooksSynthesisPromote,
-    hooksSynthesisCleanup,
-];
-//# sourceMappingURL=hooks-synthesis.js.map

package/packages/@monomind/cli/dist/src/mcp-tools/quality/chaos-resilience/chaos-inject.d.ts

@@ -1,229 +0,0 @@
-/**
- * chaos-inject.ts - Chaos failure injection MCP tool handler
- *
- * Injects controlled failures for resilience testing including network
- * latency, process termination, resource exhaustion, and more.
- * Includes dryRun safety mode.
- */
-import { z } from 'zod';
-export declare const ChaosInjectInputSchema: z.ZodObject<{
-    target: z.ZodString;
-    failureType: z.ZodEnum<["network-latency", "network-partition", "cpu-stress", "memory-pressure", "disk-failure", "process-kill", "dns-failure", "dependency-failure", "clock-skew", "packet-loss"]>;
-    duration: z.ZodDefault<z.ZodNumber>;
-    intensity: z.ZodDefault<z.ZodNumber>;
-    dryRun: z.ZodDefault<z.ZodBoolean>;
-    rollbackOnFailure: z.ZodDefault<z.ZodBoolean>;
-    monitorMetrics: z.ZodDefault<z.ZodBoolean>;
-    notifyChannels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    parameters: z.ZodOptional<z.ZodObject<{
-        latencyMs: z.ZodOptional<z.ZodNumber>;
-        packetLossPercent: z.ZodOptional<z.ZodNumber>;
-        cpuCores: z.ZodOptional<z.ZodNumber>;
-        memoryPercent: z.ZodOptional<z.ZodNumber>;
-        targetProcesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        latencyMs?: number | undefined;
-        packetLossPercent?: number | undefined;
-        cpuCores?: number | undefined;
-        memoryPercent?: number | undefined;
-        targetProcesses?: string[] | undefined;
-    }, {
-        latencyMs?: number | undefined;
-        packetLossPercent?: number | undefined;
-        cpuCores?: number | undefined;
-        memoryPercent?: number | undefined;
-        targetProcesses?: string[] | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    target: string;
-    duration: number;
-    dryRun: boolean;
-    failureType: "network-latency" | "network-partition" | "cpu-stress" | "memory-pressure" | "disk-failure" | "process-kill" | "dns-failure" | "dependency-failure" | "clock-skew" | "packet-loss";
-    intensity: number;
-    rollbackOnFailure: boolean;
-    monitorMetrics: boolean;
-    notifyChannels: string[];
-    parameters?: {
-        latencyMs?: number | undefined;
-        packetLossPercent?: number | undefined;
-        cpuCores?: number | undefined;
-        memoryPercent?: number | undefined;
-        targetProcesses?: string[] | undefined;
-    } | undefined;
-}, {
-    target: string;
-    failureType: "network-latency" | "network-partition" | "cpu-stress" | "memory-pressure" | "disk-failure" | "process-kill" | "dns-failure" | "dependency-failure" | "clock-skew" | "packet-loss";
-    duration?: number | undefined;
-    dryRun?: boolean | undefined;
-    intensity?: number | undefined;
-    rollbackOnFailure?: boolean | undefined;
-    monitorMetrics?: boolean | undefined;
-    notifyChannels?: string[] | undefined;
-    parameters?: {
-        latencyMs?: number | undefined;
-        packetLossPercent?: number | undefined;
-        cpuCores?: number | undefined;
-        memoryPercent?: number | undefined;
-        targetProcesses?: string[] | undefined;
-    } | undefined;
-}>;
-export type ChaosInjectInput = z.infer<typeof ChaosInjectInputSchema>;
-export interface ChaosInjectOutput {
-    success: boolean;
-    experimentId: string;
-    status: ExperimentStatus;
-    injection: InjectionDetails;
-    impact: ImpactAssessment;
-    metrics: ChaosMetrics;
-    timeline: TimelineEvent[];
-    recommendations: ChaosRecommendation[];
-    metadata: ChaosMetadata;
-}
-export interface ExperimentStatus {
-    state: 'planned' | 'running' | 'completed' | 'aborted' | 'dry-run';
-    progress: number;
-    startTime: string | null;
-    endTime: string | null;
-    rollbackRequired: boolean;
-    rollbackCompleted: boolean;
-}
-export interface InjectionDetails {
-    type: string;
-    target: string;
-    intensity: number;
-    duration: number;
-    parameters: Record<string, unknown>;
-    affectedComponents: string[];
-}
-export interface ImpactAssessment {
-    severity: 'none' | 'low' | 'medium' | 'high' | 'critical';
-    systemsAffected: string[];
-    usersAffected: number;
-    recoveryTime: number;
-    dataLoss: boolean;
-    serviceDisruption: ServiceDisruption;
-}
-export interface ServiceDisruption {
-    totalRequests: number;
-    failedRequests: number;
-    errorRate: number;
-    avgLatency: number;
-    p99Latency: number;
-}
-export interface ChaosMetrics {
-    baseline: MetricSnapshot;
-    duringChaos: MetricSnapshot;
-    afterChaos: MetricSnapshot;
-    degradation: number;
-    recoveryTime: number;
-}
-export interface MetricSnapshot {
-    timestamp: string;
-    cpu: number;
-    memory: number;
-    networkLatency: number;
-    errorRate: number;
-    requestsPerSecond: number;
-}
-export interface TimelineEvent {
-    timestamp: string;
-    event: string;
-    type: 'info' | 'warning' | 'error' | 'recovery';
-    details: string;
-}
-export interface ChaosRecommendation {
-    category: 'resilience' | 'recovery' | 'monitoring' | 'configuration';
-    priority: 'high' | 'medium' | 'low';
-    finding: string;
-    recommendation: string;
-    evidence: string;
-}
-export interface ChaosMetadata {
-    experimentId: string;
-    createdAt: string;
-    completedAt: string | null;
-    dryRun: boolean;
-    version: string;
-}
-export interface ToolContext {
-    get<T>(key: string): T | undefined;
-}
-/**
- * MCP Tool Handler for chaos-inject
- */
-export declare function handler(input: ChaosInjectInput, context: ToolContext): Promise<{
-    content: Array<{
-        type: 'text';
-        text: string;
-    }>;
-}>;
-export declare const toolDefinition: {
-    name: string;
-    description: string;
-    category: string;
-    version: string;
-    inputSchema: z.ZodObject<{
-        target: z.ZodString;
-        failureType: z.ZodEnum<["network-latency", "network-partition", "cpu-stress", "memory-pressure", "disk-failure", "process-kill", "dns-failure", "dependency-failure", "clock-skew", "packet-loss"]>;
-        duration: z.ZodDefault<z.ZodNumber>;
-        intensity: z.ZodDefault<z.ZodNumber>;
-        dryRun: z.ZodDefault<z.ZodBoolean>;
-        rollbackOnFailure: z.ZodDefault<z.ZodBoolean>;
-        monitorMetrics: z.ZodDefault<z.ZodBoolean>;
-        notifyChannels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-        parameters: z.ZodOptional<z.ZodObject<{
-            latencyMs: z.ZodOptional<z.ZodNumber>;
-            packetLossPercent: z.ZodOptional<z.ZodNumber>;
-            cpuCores: z.ZodOptional<z.ZodNumber>;
-            memoryPercent: z.ZodOptional<z.ZodNumber>;
-            targetProcesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            latencyMs?: number | undefined;
-            packetLossPercent?: number | undefined;
-            cpuCores?: number | undefined;
-            memoryPercent?: number | undefined;
-            targetProcesses?: string[] | undefined;
-        }, {
-            latencyMs?: number | undefined;
-            packetLossPercent?: number | undefined;
-            cpuCores?: number | undefined;
-            memoryPercent?: number | undefined;
-            targetProcesses?: string[] | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        target: string;
-        duration: number;
-        dryRun: boolean;
-        failureType: "network-latency" | "network-partition" | "cpu-stress" | "memory-pressure" | "disk-failure" | "process-kill" | "dns-failure" | "dependency-failure" | "clock-skew" | "packet-loss";
-        intensity: number;
-        rollbackOnFailure: boolean;
-        monitorMetrics: boolean;
-        notifyChannels: string[];
-        parameters?: {
-            latencyMs?: number | undefined;
-            packetLossPercent?: number | undefined;
-            cpuCores?: number | undefined;
-            memoryPercent?: number | undefined;
-            targetProcesses?: string[] | undefined;
-        } | undefined;
-    }, {
-        target: string;
-        failureType: "network-latency" | "network-partition" | "cpu-stress" | "memory-pressure" | "disk-failure" | "process-kill" | "dns-failure" | "dependency-failure" | "clock-skew" | "packet-loss";
-        duration?: number | undefined;
-        dryRun?: boolean | undefined;
-        intensity?: number | undefined;
-        rollbackOnFailure?: boolean | undefined;
-        monitorMetrics?: boolean | undefined;
-        notifyChannels?: string[] | undefined;
-        parameters?: {
-            latencyMs?: number | undefined;
-            packetLossPercent?: number | undefined;
-            cpuCores?: number | undefined;
-            memoryPercent?: number | undefined;
-            targetProcesses?: string[] | undefined;
-        } | undefined;
-    }>;
-    handler: typeof handler;
-};
-export default toolDefinition;
-//# sourceMappingURL=chaos-inject.d.ts.map