@dragonflymcp/plugin 1.0.0

package/dist/tools/analytics/index.js

@@ -0,0 +1,192 @@
+/**
+ * Analytics Module
+ * 2 MCP tools for workflow timeline visualization and configuration validation.
+ */
+import { successResponse, args as a } from "../../utils/responses.js";
+import { createDispatcher, createModule } from "../../core/dispatcher.js";
+import { createLazyLoader } from "../../utils/lazy.js";
+import { requireAnalytics } from "../../utils/guards.js";
+import { config } from "../../core/config.js";
+import { AnalyticsStore } from "./store.js";
+const dispatcher = createDispatcher();
+const getStore = createLazyLoader(() => new AnalyticsStore(config().stateDbPath));
+export const tools = [
+    {
+        name: "dragonfly_timeline_view",
+        description: "Temporal workflow visualization from provenance. Shows ordered events with timing, costs, and flow grouping.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                flow_id: { type: "string", description: "Filter to a specific workflow/flow" },
+                concept: { type: "string", description: "Filter by concept" },
+                from: { type: "string", description: "Start date (ISO 8601)" },
+                to: { type: "string", description: "End date (ISO 8601)" },
+                limit: { type: "number", description: "Max entries to return (default: 100)" },
+            },
+        },
+    },
+    {
+        name: "dragonfly_validate_config",
+        description: "Validate configuration files and database integrity. Checks state.db and memory.db tables and data consistency.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                check_state: {
+                    type: "boolean",
+                    description: "Check state.db integrity (default: true)",
+                },
+                check_memory: {
+                    type: "boolean",
+                    description: "Check memory.db integrity (default: true)",
+                },
+            },
+        },
+    },
+];
+// ─── Handlers ──────────────────────────────────────────────────
+dispatcher
+    .register("dragonfly_timeline_view", requireAnalytics(async (args) => {
+    const store = getStore();
+    const filter = buildFilter(args);
+    const actions = store.loadProvenance(filter);
+    const limit = a.number(args, "limit", 100);
+    if (actions.length === 0) {
+        return successResponse({ message: "No provenance actions found", filter });
+    }
+    const entries = actions.slice(0, limit).map((act) => ({
+        action_id: act.action_id,
+        timestamp: act.timestamp,
+        concept: act.concept,
+        action: act.action,
+        status: act.status,
+        model: act.model,
+        duration_ms: act.duration_ms,
+        cost_usd: act.cost?.cost_usd,
+        flow_id: act.flow_id,
+    }));
+    const flowIds = [...new Set(entries.map((e) => e.flow_id).filter(Boolean))];
+    const timestamps = entries.map((e) => e.timestamp).sort();
+    const view = {
+        entries,
+        total_duration_ms: entries.reduce((s, e) => s + (e.duration_ms || 0), 0),
+        total_cost: entries.reduce((s, e) => s + (e.cost_usd || 0), 0),
+        flow_ids: flowIds,
+        date_range: {
+            from: timestamps[0] || "",
+            to: timestamps[timestamps.length - 1] || "",
+        },
+    };
+    return successResponse(view);
+}))
+    .register("dragonfly_validate_config", requireAnalytics(async (args) => {
+    const cfg = config();
+    const checkState = a.boolean(args, "check_state", true);
+    const checkMemory = a.boolean(args, "check_memory", true);
+    const errors = [];
+    const warnings = [];
+    if (checkState) {
+        validateDb(cfg.stateDbPath, "state.db", [
+            "health", "events", "checkpoints", "workflow_sessions", "stories",
+        ], errors, warnings);
+    }
+    if (checkMemory) {
+        validateDb(cfg.memoryDbPath, "memory.db", [
+            "memories", "memory_embeddings", "links",
+        ], errors, warnings);
+    }
+    return successResponse({
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        databases_checked: [
+            ...(checkState ? ["state.db"] : []),
+            ...(checkMemory ? ["memory.db"] : []),
+        ],
+    });
+}));
+// ─── Helpers ──────────────────────────────────────────────────
+function buildFilter(args) {
+    const filter = {};
+    const from = a.stringOptional(args, "from");
+    const to = a.stringOptional(args, "to");
+    if (from || to) {
+        filter.dateRange = {
+            from: from ? new Date(from) : undefined,
+            to: to ? new Date(to) : undefined,
+        };
+    }
+    const concept = a.stringOptional(args, "concept");
+    if (concept)
+        filter.concepts = [concept];
+    const model = a.stringOptional(args, "model");
+    if (model)
+        filter.models = [model];
+    const flowId = a.stringOptional(args, "flow_id");
+    if (flowId)
+        filter.flowId = flowId;
+    return filter;
+}
+function validateDb(dbPath, dbName, requiredTables, errors, warnings) {
+    const fs = require("fs");
+    if (!fs.existsSync(dbPath)) {
+        errors.push({ db: dbName, table: "", message: `Database file not found: ${dbPath}`, severity: "error" });
+        return;
+    }
+    try {
+        const Database = require("better-sqlite3");
+        const db = new Database(dbPath, { readonly: true });
+        try {
+            const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'").all();
+            const tableNames = new Set(tables.map((t) => t.name));
+            for (const required of requiredTables) {
+                if (!tableNames.has(required)) {
+                    errors.push({
+                        db: dbName,
+                        table: required,
+                        message: `Required table '${required}' not found`,
+                        severity: "error",
+                    });
+                }
+            }
+            // Check WAL mode
+            const journal = db.pragma("journal_mode");
+            if (journal[0]?.journal_mode !== "wal") {
+                warnings.push({
+                    db: dbName,
+                    table: "",
+                    message: "Database not using WAL journal mode (recommended for concurrent access)",
+                    severity: "warning",
+                });
+            }
+            // Check row counts for basic health
+            for (const table of requiredTables) {
+                if (tableNames.has(table)) {
+                    const count = db.prepare(`SELECT COUNT(*) as c FROM ${table}`).get();
+                    if (count.c === 0) {
+                        warnings.push({
+                            db: dbName,
+                            table,
+                            message: `Table '${table}' is empty`,
+                            severity: "warning",
+                        });
+                    }
+                }
+            }
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (err) {
+        errors.push({
+            db: dbName,
+            table: "",
+            message: `Failed to open database: ${err instanceof Error ? err.message : String(err)}`,
+            severity: "error",
+        });
+    }
+}
+export const analyticsModule = createModule(tools, dispatcher);
+export * from "./types.js";
+export { AnalyticsStore } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/analytics/index.js.map

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

package/dist/tools/analytics/learner.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pure learning functions for extracting workflow patterns and computing calibration.
+ * No I/O — operates on in-memory ProvenanceAction arrays.
+ */
+import type { ProvenanceAction, LearnedPattern, MemoryCalibration, LearningState, SkillTemplate } from "./types.js";
+/**
+ * Extract recurring patterns from provenance actions.
+ * Groups by concept-action pair, computes success rate, duration, cost, confidence.
+ */
+export declare function extractPatterns(actions: ProvenanceAction[]): LearnedPattern[];
+/**
+ * Compute memory calibration effectiveness per concept.
+ * Measures how often memory injections led to successful outcomes.
+ */
+export declare function computeCalibration(actions: ProvenanceAction[]): MemoryCalibration[];
+/**
+ * Generate a skill template from a learned pattern.
+ */
+export declare function generateSkill(pattern: LearnedPattern): SkillTemplate;
+/**
+ * Filter patterns eligible for skill generation.
+ * Requires 5+ occurrences and 80%+ success rate.
+ */
+export declare function getEligiblePatterns(patterns: LearnedPattern[]): LearnedPattern[];
+/**
+ * Compute full learning state from provenance actions.
+ */
+export declare function computeLearningState(actions: ProvenanceAction[]): LearningState;
+//# sourceMappingURL=learner.d.ts.map

package/dist/tools/analytics/learner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learner.d.ts","sourceRoot":"","sources":["../../../src/tools/analytics/learner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,cAAc,EAAE,CA+D7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,EAAE,CAuBnF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA0BpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAEhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,aAAa,CAK/E"}

package/dist/tools/analytics/learner.js

@@ -0,0 +1,135 @@
+/**
+ * Pure learning functions for extracting workflow patterns and computing calibration.
+ * No I/O — operates on in-memory ProvenanceAction arrays.
+ */
+/**
+ * Extract recurring patterns from provenance actions.
+ * Groups by concept-action pair, computes success rate, duration, cost, confidence.
+ */
+export function extractPatterns(actions) {
+    const groups = new Map();
+    for (const a of actions) {
+        const key = `${a.concept}:${a.action}`;
+        const g = groups.get(key) || {
+            concept: a.concept,
+            action: a.action,
+            total: 0,
+            successes: 0,
+            durations: [],
+            costs: [],
+            timestamps: [],
+            models: new Set(),
+        };
+        g.total += 1;
+        if (a.status === "completed")
+            g.successes += 1;
+        if (a.duration_ms)
+            g.durations.push(a.duration_ms);
+        if (a.cost?.cost_usd)
+            g.costs.push(a.cost.cost_usd);
+        g.timestamps.push(a.timestamp);
+        if (a.model)
+            g.models.add(a.model);
+        groups.set(key, g);
+    }
+    return Array.from(groups.values()).map((g) => {
+        const successRate = g.total > 0 ? g.successes / g.total : 0;
+        const avgDuration = g.durations.length > 0
+            ? g.durations.reduce((s, d) => s + d, 0) / g.durations.length
+            : 0;
+        const avgCost = g.costs.length > 0
+            ? g.costs.reduce((s, c) => s + c, 0) / g.costs.length
+            : 0;
+        const sorted = [...g.timestamps].sort();
+        let confidence;
+        if (g.total >= 10 && successRate >= 0.8)
+            confidence = "high";
+        else if (g.total >= 5 && successRate >= 0.6)
+            confidence = "medium";
+        else
+            confidence = "low";
+        return {
+            concept: g.concept,
+            action: g.action,
+            occurrences: g.total,
+            success_rate: successRate,
+            avg_duration_ms: avgDuration,
+            avg_cost: avgCost,
+            confidence,
+            first_seen: sorted[0] || "",
+            last_seen: sorted[sorted.length - 1] || "",
+            models_used: Array.from(g.models),
+        };
+    }).sort((a, b) => b.occurrences - a.occurrences);
+}
+/**
+ * Compute memory calibration effectiveness per concept.
+ * Measures how often memory injections led to successful outcomes.
+ */
+export function computeCalibration(actions) {
+    const groups = new Map();
+    for (const a of actions) {
+        const hasMemoryInjection = a.metadata?.memory_injected === true
+            || a.metadata?.memories_used !== undefined;
+        if (!hasMemoryInjection)
+            continue;
+        const g = groups.get(a.concept) || { injections: 0, successes: 0 };
+        g.injections += 1;
+        if (a.status === "completed" && !a.error)
+            g.successes += 1;
+        groups.set(a.concept, g);
+    }
+    return Array.from(groups.entries())
+        .map(([category, g]) => ({
+        category,
+        total_injections: g.injections,
+        led_to_success: g.successes,
+        effectiveness: g.injections > 0 ? g.successes / g.injections : 0,
+    }))
+        .sort((a, b) => b.effectiveness - a.effectiveness);
+}
+/**
+ * Generate a skill template from a learned pattern.
+ */
+export function generateSkill(pattern) {
+    const name = `${pattern.concept}-${pattern.action}`;
+    const description = `Learned pattern for ${pattern.concept}/${pattern.action} `
+        + `(${pattern.occurrences} occurrences, ${(pattern.success_rate * 100).toFixed(0)}% success)`;
+    const content = [
+        `# ${name}`,
+        "",
+        `## Context`,
+        `- Concept: ${pattern.concept}`,
+        `- Action: ${pattern.action}`,
+        `- Success Rate: ${(pattern.success_rate * 100).toFixed(1)}%`,
+        `- Average Duration: ${(pattern.avg_duration_ms / 1000).toFixed(1)}s`,
+        `- Average Cost: $${pattern.avg_cost.toFixed(4)}`,
+        `- Confidence: ${pattern.confidence}`,
+        "",
+        `## Models`,
+        pattern.models_used.map((m) => `- ${m}`).join("\n"),
+        "",
+        `## Insights`,
+        `Based on ${pattern.occurrences} observed executions.`,
+        `First seen: ${pattern.first_seen}`,
+        `Last seen: ${pattern.last_seen}`,
+    ].join("\n");
+    return { name, description, content, pattern };
+}
+/**
+ * Filter patterns eligible for skill generation.
+ * Requires 5+ occurrences and 80%+ success rate.
+ */
+export function getEligiblePatterns(patterns) {
+    return patterns.filter((p) => p.occurrences >= 5 && p.success_rate >= 0.8);
+}
+/**
+ * Compute full learning state from provenance actions.
+ */
+export function computeLearningState(actions) {
+    return {
+        patterns: extractPatterns(actions),
+        calibrations: computeCalibration(actions),
+    };
+}
+//# sourceMappingURL=learner.js.map

package/dist/tools/analytics/learner.js.map

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

package/dist/tools/analytics/learner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=learner.test.d.ts.map

package/dist/tools/analytics/learner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learner.test.d.ts","sourceRoot":"","sources":["../../../src/tools/analytics/learner.test.ts"],"names":[],"mappings":""}

package/dist/tools/analytics/learner.test.js

@@ -0,0 +1,118 @@
+import { describe, it, expect } from "vitest";
+import { extractPatterns, computeCalibration, generateSkill, getEligiblePatterns, computeLearningState, } from "./learner.js";
+function makeAction(overrides = {}) {
+    return {
+        action_id: `act-${Math.random().toString(36).slice(2, 8)}`,
+        concept: "implementation",
+        action: "complete",
+        status: "completed",
+        timestamp: "2026-02-15T10:00:00Z",
+        model: "sonnet",
+        cost: { cost_usd: 0.01 },
+        duration_ms: 5000,
+        ...overrides,
+    };
+}
+describe("extractPatterns", () => {
+    it("returns empty for no actions", () => {
+        expect(extractPatterns([])).toHaveLength(0);
+    });
+    it("groups by concept-action", () => {
+        const actions = [
+            makeAction({ concept: "story", action: "complete" }),
+            makeAction({ concept: "story", action: "complete" }),
+            makeAction({ concept: "implementation", action: "start" }),
+        ];
+        const patterns = extractPatterns(actions);
+        expect(patterns).toHaveLength(2);
+        expect(patterns[0].occurrences).toBe(2);
+    });
+    it("computes success rate correctly", () => {
+        const actions = [
+            makeAction({ concept: "quality", action: "review", status: "completed" }),
+            makeAction({ concept: "quality", action: "review", status: "completed" }),
+            makeAction({ concept: "quality", action: "review", status: "failed" }),
+        ];
+        const patterns = extractPatterns(actions);
+        const p = patterns.find((p) => p.concept === "quality");
+        expect(p.success_rate).toBeCloseTo(2 / 3);
+    });
+    it("assigns confidence levels correctly", () => {
+        // 10+ occurrences with 80%+ success = high
+        const highActions = Array.from({ length: 10 }, () => makeAction({ concept: "story", action: "complete", status: "completed" }));
+        const patterns = extractPatterns(highActions);
+        expect(patterns[0].confidence).toBe("high");
+    });
+    it("tracks models used", () => {
+        const actions = [
+            makeAction({ concept: "story", action: "complete", model: "opus" }),
+            makeAction({ concept: "story", action: "complete", model: "sonnet" }),
+            makeAction({ concept: "story", action: "complete", model: "opus" }),
+        ];
+        const patterns = extractPatterns(actions);
+        expect(patterns[0].models_used).toContain("opus");
+        expect(patterns[0].models_used).toContain("sonnet");
+        expect(patterns[0].models_used).toHaveLength(2);
+    });
+});
+describe("computeCalibration", () => {
+    it("returns empty for no memory-injected actions", () => {
+        const actions = [makeAction()];
+        expect(computeCalibration(actions)).toHaveLength(0);
+    });
+    it("computes effectiveness from memory_injected metadata", () => {
+        const actions = [
+            makeAction({ concept: "implementation", status: "completed", metadata: { memory_injected: true } }),
+            makeAction({ concept: "implementation", status: "completed", metadata: { memory_injected: true } }),
+            makeAction({ concept: "implementation", status: "failed", metadata: { memory_injected: true } }),
+        ];
+        const cals = computeCalibration(actions);
+        expect(cals).toHaveLength(1);
+        expect(cals[0].total_injections).toBe(3);
+        expect(cals[0].effectiveness).toBeCloseTo(2 / 3);
+    });
+});
+describe("generateSkill", () => {
+    it("generates markdown skill template", () => {
+        const pattern = {
+            concept: "implementation",
+            action: "complete",
+            occurrences: 15,
+            success_rate: 0.93,
+            avg_duration_ms: 8000,
+            avg_cost: 0.05,
+            confidence: "high",
+            first_seen: "2026-01-01T00:00:00Z",
+            last_seen: "2026-02-15T00:00:00Z",
+            models_used: ["sonnet", "opus"],
+        };
+        const skill = generateSkill(pattern);
+        expect(skill.name).toBe("implementation-complete");
+        expect(skill.content).toContain("93.0%");
+        expect(skill.content).toContain("sonnet");
+    });
+});
+describe("getEligiblePatterns", () => {
+    it("filters by occurrences and success rate", () => {
+        const patterns = [
+            { concept: "story", action: "complete", occurrences: 10, success_rate: 0.9, avg_duration_ms: 0, avg_cost: 0, confidence: "high", first_seen: "", last_seen: "", models_used: [] },
+            { concept: "quality", action: "review", occurrences: 3, success_rate: 0.9, avg_duration_ms: 0, avg_cost: 0, confidence: "medium", first_seen: "", last_seen: "", models_used: [] },
+            { concept: "impl", action: "start", occurrences: 6, success_rate: 0.5, avg_duration_ms: 0, avg_cost: 0, confidence: "low", first_seen: "", last_seen: "", models_used: [] },
+        ];
+        const eligible = getEligiblePatterns(patterns);
+        expect(eligible).toHaveLength(1);
+        expect(eligible[0].concept).toBe("story");
+    });
+});
+describe("computeLearningState", () => {
+    it("returns both patterns and calibrations", () => {
+        const actions = [
+            makeAction({ concept: "story", metadata: { memory_injected: true } }),
+            makeAction({ concept: "story" }),
+        ];
+        const state = computeLearningState(actions);
+        expect(state.patterns.length).toBeGreaterThan(0);
+        expect(state.calibrations.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=learner.test.js.map

package/dist/tools/analytics/learner.test.js.map

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

package/dist/tools/analytics/observe.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Observability analysis for prompt/token usage logs.
+ * Reads JSONL prompt logs and computes analytics.
+ */
+import type { PromptLogEntry, ObservabilityAnalysis } from "./types.js";
+/**
+ * Load prompt logs from JSONL file.
+ */
+export declare function loadPromptLogs(projectRoot: string): PromptLogEntry[];
+/**
+ * Filter log entries by date range and concept.
+ */
+export declare function filterLogs(entries: PromptLogEntry[], options: {
+    from?: string;
+    to?: string;
+    concept?: string;
+}): PromptLogEntry[];
+/**
+ * Analyze prompt logs into structured analytics.
+ */
+export declare function analyzePromptLogs(entries: PromptLogEntry[]): ObservabilityAnalysis;
+//# sourceMappingURL=observe.d.ts.map

package/dist/tools/analytics/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/tools/analytics/observe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,cAAc,EAEd,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CAiBpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,cAAc,EAAE,CAOlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,qBAAqB,CA6GlF"}