@dragonflymcp/plugin 1.0.0

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

@@ -0,0 +1,290 @@
+/**
+ * Analytics Module Types
+ * Consolidated types for cost analysis, benchmarks, learning, drift detection,
+ * observability, timeline, and validation.
+ */
+export type Concept = "story" | "architecture" | "implementation" | "quality" | "version" | "context" | "retrospective" | "security" | "documentation" | "code-analysis" | "verification";
+export type Model = "haiku" | "sonnet" | "opus";
+export type ActionStatus = "started" | "completed" | "failed" | "blocked";
+export interface CostInfo {
+    input_tokens?: number;
+    output_tokens?: number;
+    total_tokens?: number;
+    cost_usd?: number;
+}
+export interface ProvenanceAction {
+    action_id: string;
+    concept: Concept;
+    action: string;
+    status: ActionStatus;
+    timestamp: string;
+    model?: Model;
+    triggered_by?: string | null;
+    flow_id?: string;
+    sync_rule_id?: string | null;
+    inputs?: Record<string, unknown>;
+    outputs?: {
+        artifact_id?: string;
+        artifact_type?: string;
+        artifact_path?: string;
+    };
+    cost?: CostInfo;
+    duration_ms?: number;
+    error?: {
+        type: string;
+        message: string;
+        recoverable: boolean;
+    } | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ProvenanceFilter {
+    dateRange?: {
+        from?: Date;
+        to?: Date;
+    };
+    concepts?: Concept[];
+    models?: Model[];
+    flowId?: string;
+    storyId?: string;
+}
+export interface CostByDimension {
+    dimension: string;
+    total_cost: number;
+    count: number;
+    avg_cost: number;
+    input_tokens: number;
+    output_tokens: number;
+}
+export interface CostAnalytics {
+    total_cost: number;
+    total_actions: number;
+    by_concept: CostByDimension[];
+    by_model: CostByDimension[];
+    by_flow: CostByDimension[];
+    by_date: CostByDimension[];
+    time_series: {
+        date: string;
+        cost: number;
+    }[];
+}
+export interface CostMetrics {
+    total_spend: number;
+    by_concept: Array<{
+        concept: string;
+        total: number;
+        avg: number;
+        count: number;
+    }>;
+    by_story: Array<{
+        story_id: string;
+        total: number;
+        count: number;
+    }>;
+    by_model: Array<{
+        model: string;
+        total: number;
+        avg: number;
+        count: number;
+    }>;
+}
+export interface DurationMetrics {
+    total_duration_ms: number;
+    by_concept: Array<{
+        concept: string;
+        total_ms: number;
+        avg_ms: number;
+        p50_ms: number;
+        p90_ms: number;
+        p99_ms: number;
+        count: number;
+    }>;
+    by_story: Array<{
+        story_id: string;
+        total_ms: number;
+        count: number;
+    }>;
+}
+export interface QualityMetrics {
+    total_reviews: number;
+    approval_rate: number;
+    avg_review_cycles: number;
+    by_concept: Array<{
+        concept: string;
+        reviews: number;
+        approvals: number;
+        rejections: number;
+    }>;
+}
+export interface ModelUsage {
+    distribution: Array<{
+        model: string;
+        count: number;
+        percentage: number;
+    }>;
+    cost_distribution: Array<{
+        model: string;
+        cost: number;
+        percentage: number;
+    }>;
+}
+export interface FailureMetrics {
+    total_failures: number;
+    failure_rate: number;
+    retry_count: number;
+    by_concept: Array<{
+        concept: string;
+        failures: number;
+        retries: number;
+    }>;
+    by_error_type: Array<{
+        error_type: string;
+        count: number;
+    }>;
+}
+export interface TrendData {
+    window_size: number;
+    cost_trend: Array<{
+        story_id: string;
+        cost: number;
+        cumulative: number;
+    }>;
+    duration_trend: Array<{
+        story_id: string;
+        duration_ms: number;
+    }>;
+    failure_trend: Array<{
+        story_id: string;
+        failure_rate: number;
+    }>;
+}
+export interface BenchmarkMetrics {
+    generated_at: string;
+    action_count: number;
+    story_count: number;
+    cost: CostMetrics;
+    duration: DurationMetrics;
+    quality: QualityMetrics;
+    model_usage: ModelUsage;
+    failures: FailureMetrics;
+    trends?: TrendData;
+}
+export interface LearnedPattern {
+    concept: string;
+    action: string;
+    occurrences: number;
+    success_rate: number;
+    avg_duration_ms: number;
+    avg_cost: number;
+    confidence: "low" | "medium" | "high";
+    first_seen: string;
+    last_seen: string;
+    models_used: string[];
+}
+export interface MemoryCalibration {
+    category: string;
+    total_injections: number;
+    led_to_success: number;
+    effectiveness: number;
+}
+export interface LearningState {
+    patterns: LearnedPattern[];
+    calibrations: MemoryCalibration[];
+}
+export interface SkillTemplate {
+    name: string;
+    description: string;
+    content: string;
+    pattern: LearnedPattern;
+}
+export interface FileEntry {
+    relativePath: string;
+    fullPath: string;
+    hash: string;
+    category: string;
+}
+export interface DriftItem {
+    relativePath: string;
+    category: string;
+    templatePath: string;
+    installedPath: string;
+}
+export interface DriftReport {
+    modified: DriftItem[];
+    missing: DriftItem[];
+    added: DriftItem[];
+    scanned_at: string;
+}
+export interface PromptLogEntry {
+    timestamp: string;
+    session_id?: string;
+    concept?: string;
+    model?: string;
+    input_tokens?: number;
+    output_tokens?: number;
+    duration_ms?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionStats {
+    session_id: string;
+    total_tokens: number;
+    call_count: number;
+    concepts: string[];
+    duration_ms: number;
+}
+export interface ObservabilityAnalysis {
+    total_calls: number;
+    total_tokens: number;
+    unique_sessions: number;
+    by_concept: Array<{
+        concept: string;
+        calls: number;
+        tokens: number;
+        avg_tokens: number;
+    }>;
+    by_model: Array<{
+        model: string;
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    }>;
+    date_range: {
+        from: string;
+        to: string;
+    };
+    top_sessions: SessionStats[];
+}
+export interface ValidationError {
+    file: string;
+    path?: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface ValidationReport {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+    files_checked: number;
+    schemas_used: string[];
+}
+export interface TimelineEntry {
+    action_id: string;
+    timestamp: string;
+    concept: string;
+    action: string;
+    status: string;
+    model?: string;
+    duration_ms?: number;
+    cost_usd?: number;
+    flow_id?: string;
+}
+export interface TimelineView {
+    entries: TimelineEntry[];
+    total_duration_ms: number;
+    total_cost: number;
+    flow_ids: string[];
+    date_range: {
+        from: string;
+        to: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/analytics/types.js

@@ -0,0 +1,7 @@
+/**
+ * Analytics Module Types
+ * Consolidated types for cost analysis, benchmarks, learning, drift detection,
+ * observability, timeline, and validation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/analytics/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tools/ast/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AST Index Tools
+ * Provides code intelligence through AST analysis
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const tools: Tool[];
+export declare const astModule: import("../../core/types.js").ToolModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/ast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ast/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAY1D,eAAO,MAAM,KAAK,EAAE,IAAI,EA2KvB,CAAC;AA8DF,eAAO,MAAM,SAAS,0CAAkC,CAAC"}

package/dist/tools/ast/index.js

@@ -0,0 +1,242 @@
+/**
+ * AST Index Tools
+ * Provides code intelligence through AST analysis
+ */
+import { successResponse, args as a } from "../../utils/responses.js";
+import { createDispatcher, createModule } from "../../core/dispatcher.js";
+import { config } from "../../core/config.js";
+import { createLazyLoader } from "../../utils/lazy.js";
+import { ASTIndexer } from "./indexer.js";
+import { IndexStore } from "./store.js";
+const getStore = createLazyLoader(() => new IndexStore(config().indexPath));
+const getIndexer = createLazyLoader(() => new ASTIndexer(config().projectRoot, getStore()));
+export const tools = [
+    {
+        name: "index_project",
+        description: "Build or rebuild the AST index for the project",
+        inputSchema: {
+            type: "object",
+            properties: {
+                paths: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Specific paths to index (default: entire project)",
+                },
+                languages: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter by language (typescript, javascript, python, go, rust, java, c)",
+                },
+                incremental: {
+                    type: "boolean",
+                    description: "Only index changed files (default: true)",
+                    default: true,
+                },
+            },
+        },
+    },
+    {
+        name: "find_symbol",
+        description: "Find a symbol by name with fuzzy matching",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Symbol name to search for",
+                },
+                kind: {
+                    type: "string",
+                    enum: [
+                        "function",
+                        "class",
+                        "method",
+                        "variable",
+                        "interface",
+                        "type",
+                        "constant",
+                    ],
+                    description: "Filter by symbol kind",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum results to return (default: 10)",
+                    default: 10,
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "get_symbol_info",
+        description: "Get detailed information about a specific symbol",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file: {
+                    type: "string",
+                    description: "File path containing the symbol",
+                },
+                symbol: {
+                    type: "string",
+                    description: "Symbol name",
+                },
+                includeBody: {
+                    type: "boolean",
+                    description: "Include the symbol's source code",
+                    default: false,
+                },
+            },
+            required: ["file", "symbol"],
+        },
+    },
+    {
+        name: "find_references",
+        description: "Find all references to a symbol",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file: {
+                    type: "string",
+                    description: "File path containing the symbol definition",
+                },
+                symbol: {
+                    type: "string",
+                    description: "Symbol name to find references for",
+                },
+                includeDefinition: {
+                    type: "boolean",
+                    description: "Include the definition in results",
+                    default: false,
+                },
+            },
+            required: ["file", "symbol"],
+        },
+    },
+    {
+        name: "get_call_graph",
+        description: "Get the call graph for a function or method",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file: {
+                    type: "string",
+                    description: "File path containing the function",
+                },
+                symbol: {
+                    type: "string",
+                    description: "Function/method name",
+                },
+                depth: {
+                    type: "number",
+                    description: "How deep to traverse the call graph (default: 2)",
+                    default: 2,
+                },
+                direction: {
+                    type: "string",
+                    enum: ["callers", "callees", "both"],
+                    description: "Direction to traverse (default: both)",
+                    default: "both",
+                },
+            },
+            required: ["file", "symbol"],
+        },
+    },
+    {
+        name: "find_implementations",
+        description: "Find implementations of an interface or abstract class",
+        inputSchema: {
+            type: "object",
+            properties: {
+                interface: {
+                    type: "string",
+                    description: "Interface or abstract class name",
+                },
+                file: {
+                    type: "string",
+                    description: "File containing the interface (optional, helps disambiguate)",
+                },
+            },
+            required: ["interface"],
+        },
+    },
+    {
+        name: "get_file_symbols",
+        description: "Get all symbols defined in a file",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file: {
+                    type: "string",
+                    description: "File path to get symbols from",
+                },
+                depth: {
+                    type: "number",
+                    description: "Nesting depth to include (default: 1 for top-level only)",
+                    default: 1,
+                },
+            },
+            required: ["file"],
+        },
+    },
+];
+const dispatcher = createDispatcher();
+dispatcher
+    .registerVeryLong("index_project", async (args) => {
+    const result = await getIndexer().indexProject({
+        paths: a.array(args, "paths"),
+        languages: a.array(args, "languages"),
+        incremental: a.boolean(args, "incremental", true),
+    });
+    return successResponse(result);
+})
+    .registerQuick("find_symbol", async (args) => {
+    const symbols = getStore().findSymbol({
+        query: a.string(args, "query"),
+        kind: a.stringOptional(args, "kind"),
+        limit: a.number(args, "limit", 10),
+    });
+    return successResponse(symbols);
+})
+    .registerQuick("get_symbol_info", async (args) => {
+    const info = getStore().getSymbolInfo({
+        file: a.string(args, "file"),
+        symbol: a.string(args, "symbol"),
+        includeBody: a.boolean(args, "includeBody", false),
+        projectRoot: config().projectRoot,
+    });
+    return successResponse(info);
+})
+    .registerQuick("find_references", async (args) => {
+    const refs = getStore().findReferences({
+        file: a.string(args, "file"),
+        symbol: a.string(args, "symbol"),
+        includeDefinition: a.boolean(args, "includeDefinition", false),
+    });
+    return successResponse(refs);
+})
+    .registerQuick("get_call_graph", async (args) => {
+    const graph = getStore().getCallGraph({
+        file: a.string(args, "file"),
+        symbol: a.string(args, "symbol"),
+        depth: a.number(args, "depth", 2),
+        direction: a.stringOptional(args, "direction") ?? "both",
+    });
+    return successResponse(graph);
+})
+    .registerQuick("find_implementations", async (args) => {
+    const impls = getStore().findImplementations({
+        interface: a.string(args, "interface"),
+        file: a.stringOptional(args, "file"),
+    });
+    return successResponse(impls);
+})
+    .registerQuick("get_file_symbols", async (args) => {
+    const symbols = getStore().getFileSymbols({
+        file: a.string(args, "file"),
+        depth: a.number(args, "depth", 1),
+    });
+    return successResponse(symbols);
+});
+export const astModule = createModule(tools, dispatcher);
+//# sourceMappingURL=index.js.map

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

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

package/dist/tools/ast/indexer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * AST Indexer
+ * Parses source code using tree-sitter and extracts symbols, references, and calls
+ */
+import { IndexStore } from "./store.js";
+import type { SupportedLanguage } from "../../core/types.js";
+export interface IndexOptions {
+    paths?: string[];
+    languages?: SupportedLanguage[];
+    incremental?: boolean;
+}
+export interface IndexResult {
+    filesIndexed: number;
+    symbolsFound: number;
+    referencesFound: number;
+    callsFound: number;
+    duration: number;
+    errors: string[];
+}
+export declare class ASTIndexer {
+    private projectRoot;
+    private store;
+    private parser;
+    private languages;
+    private initialized;
+    constructor(projectRoot: string, store: IndexStore);
+    private initialize;
+    private loadLanguage;
+    /**
+     * Detect which languages are actually present in the project
+     * by scanning for source files, filtering to languages with WASM support.
+     */
+    private detectProjectLanguages;
+    indexProject(options?: IndexOptions): Promise<IndexResult>;
+    private indexFile;
+    private extractSignature;
+    private extractCalls;
+    private extractReferences;
+    private getChangedFiles;
+}
+//# sourceMappingURL=indexer.d.ts.map

package/dist/tools/ast/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../src/tools/ast/indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAmC,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAoH9F,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;YAKpC,UAAU;YAQV,YAAY;IAgD1B;;;OAGG;YACW,sBAAsB;IAe9B,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;YA6EtD,SAAS;IA2SvB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,YAAY;IA+DpB,OAAO,CAAC,iBAAiB;YAgCX,eAAe;CAe9B"}