@dragonflymcp/plugin 1.0.0

package/dist/tools/pipeline/planner.js

@@ -0,0 +1,147 @@
+/**
+ * Execution plan generator.
+ * Pure functions — creates execution plans from validated pipelines.
+ */
+import { getPreconditions } from "./preconditions.js";
+import { generateId } from "../../utils/ids.js";
+// ─── Cost/Duration Estimates ─────────────────────────────────
+const COST_ESTIMATES = {
+    story: 0.005, architecture: 0.02, implementation: 0.01, quality: 0.008,
+    version: 0.002, security: 0.01, "code-analysis": 0.003, verification: 0.008,
+    documentation: 0.005, context: 0.001, retrospective: 0.003,
+};
+const DURATION_ESTIMATES_MS = {
+    story: 30000, architecture: 60000, implementation: 45000, quality: 40000,
+    version: 15000, security: 35000, "code-analysis": 20000, verification: 30000,
+    documentation: 25000, context: 10000, retrospective: 20000,
+};
+const MODEL_COST_MULTIPLIERS = {
+    haiku: 0.2, sonnet: 1.0, opus: 5.0,
+};
+// ─── Concept → Default Action ────────────────────────────────
+const ACTION_MAPPING = {
+    story: "create", architecture: "design", implementation: "generate",
+    quality: "review", version: "commit", security: "threat_model",
+    "code-analysis": "context", verification: "verify", documentation: "generate",
+    context: "compress", retrospective: "analyze",
+};
+function getAction(concept, refAction) {
+    return refAction || ACTION_MAPPING[concept] || "execute";
+}
+// ─── Instruction Templates ───────────────────────────────────
+function getInstruction(concept, action, storyId) {
+    const id = storyId || "XXX";
+    const instructions = {
+        story: `Create story state (story-${id})`,
+        architecture: `Design architecture (arch-${id})`,
+        implementation: `Generate implementation (impl-${id})`,
+        quality: `Review code and run tests (review-${id})`,
+        version: "Commit changes with proper message",
+        security: `Perform threat modeling (threat-${id})`,
+        "code-analysis": "Gather codebase context using MCP tools",
+        verification: "Run independent verification pass",
+        documentation: "Generate documentation",
+        context: "Compress context window",
+        retrospective: "Analyze workflow and identify improvements",
+    };
+    return instructions[concept] || `Execute ${action} for ${concept}`;
+}
+// ─── Plan Generator ──────────────────────────────────────────
+/**
+ * Generate an execution plan from a validated pipeline.
+ */
+export function generatePlan(pipeline, validation, options = {}) {
+    const preconditionData = getPreconditions(pipeline, options.storyId);
+    const steps = [];
+    const stepsByNumber = new Map();
+    let stepNumber = 1;
+    for (let i = 0; i < pipeline.steps.length; i++) {
+        const pipelineStep = pipeline.steps[i];
+        const isParallel = pipelineStep.type === "parallel";
+        const parallelStepNumbers = [];
+        for (let j = 0; j < pipelineStep.conceptRefs.length; j++) {
+            const ref = pipelineStep.conceptRefs[j];
+            const action = getAction(ref.concept, ref.action);
+            const preconditions = preconditionData.find((p) => p.step === stepNumber)?.preconditions || [];
+            // Blocked by previous pipeline step's last concept(s)
+            const blockedBy = [];
+            if (stepNumber > 1 && i > 0 && !isParallel) {
+                blockedBy.push(stepNumber - 1);
+            }
+            else if (stepNumber > 1 && isParallel && i > 0) {
+                const prevStep = pipeline.steps[i - 1];
+                const prevCount = prevStep.concepts.length;
+                for (let k = stepNumber - prevCount; k < stepNumber; k++) {
+                    if (k > 0)
+                        blockedBy.push(k);
+                }
+            }
+            const step = {
+                step_number: stepNumber,
+                concept: ref.concept,
+                action,
+                model: ref.model,
+                passes: ref.passes || 1,
+                preconditions,
+                blocked_by: blockedBy.length > 0 ? blockedBy : undefined,
+                instructions: getInstruction(ref.concept, action, options.storyId),
+            };
+            steps.push(step);
+            stepsByNumber.set(stepNumber, step);
+            if (isParallel)
+                parallelStepNumbers.push(stepNumber);
+            stepNumber++;
+        }
+        // Link parallel steps
+        if (isParallel && parallelStepNumbers.length > 1) {
+            for (const num of parallelStepNumbers) {
+                const step = stepsByNumber.get(num);
+                if (step)
+                    step.parallel_with = parallelStepNumbers.filter((n) => n !== num);
+            }
+        }
+    }
+    // Estimate cost and duration
+    let estimatedCost = 0;
+    let estimatedDuration = 0;
+    const parallelGroupSeen = new Set();
+    for (const step of steps) {
+        const baseCost = COST_ESTIMATES[step.concept] || 0.005;
+        const modelMult = step.model ? (MODEL_COST_MULTIPLIERS[step.model] || 1.0) : 1.0;
+        estimatedCost += baseCost * modelMult * step.passes;
+        const baseDuration = DURATION_ESTIMATES_MS[step.concept] || 30000;
+        if (step.parallel_with && step.parallel_with.length > 0) {
+            const groupKey = [step.step_number, ...step.parallel_with].sort().join(",");
+            if (!parallelGroupSeen.has(groupKey)) {
+                parallelGroupSeen.add(groupKey);
+                const groupDurations = [step, ...step.parallel_with.map((n) => stepsByNumber.get(n))]
+                    .map((s) => (DURATION_ESTIMATES_MS[s.concept] || 30000) * s.passes);
+                estimatedDuration += Math.max(...groupDurations);
+            }
+        }
+        else {
+            estimatedDuration += baseDuration * step.passes;
+        }
+    }
+    // Determine plan status
+    let status = "valid";
+    if (!validation.valid) {
+        status = "invalid";
+    }
+    else if (steps.every((s) => s.preconditions.length === 0 || !options.storyId)) {
+        status = "ready";
+    }
+    return {
+        plan_id: generateId("plan"),
+        pipeline_dsl: pipeline.raw,
+        story_id: options.storyId,
+        created_at: new Date().toISOString(),
+        status,
+        steps,
+        validation,
+        estimated_cost_usd: Math.round(estimatedCost * 10000) / 10000,
+        estimated_duration_ms: estimatedDuration,
+        start_from_step: options.fromStep,
+    };
+}
+//# sourceMappingURL=planner.js.map

package/dist/tools/pipeline/planner.js.map

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

package/dist/tools/pipeline/planner.test.d.ts

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

package/dist/tools/pipeline/planner.test.d.ts.map

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

package/dist/tools/pipeline/planner.test.js

@@ -0,0 +1,96 @@
+import { describe, it, expect } from "vitest";
+import { generatePlan } from "./planner.js";
+import { parsePipeline, validatePipeline } from "./composer.js";
+function makePlan(dsl, storyId) {
+    const pipeline = parsePipeline(dsl);
+    const validation = validatePipeline(pipeline);
+    return generatePlan(pipeline, validation, { storyId });
+}
+describe("generatePlan", () => {
+    it("generates steps for a simple pipeline", () => {
+        const plan = makePlan("story | architecture | implementation");
+        expect(plan.steps).toHaveLength(3);
+        expect(plan.steps[0].concept).toBe("story");
+        expect(plan.steps[0].action).toBe("create");
+        expect(plan.steps[1].concept).toBe("architecture");
+        expect(plan.steps[1].action).toBe("design");
+        expect(plan.steps[2].concept).toBe("implementation");
+        expect(plan.steps[2].action).toBe("generate");
+    });
+    it("assigns sequential step numbers", () => {
+        const plan = makePlan("story | architecture | implementation");
+        expect(plan.steps.map((s) => s.step_number)).toEqual([1, 2, 3]);
+    });
+    it("sets blocked_by for sequential steps", () => {
+        const plan = makePlan("story | architecture | implementation");
+        expect(plan.steps[0].blocked_by).toBeUndefined();
+        expect(plan.steps[1].blocked_by).toEqual([1]);
+        expect(plan.steps[2].blocked_by).toEqual([2]);
+    });
+    it("handles parallel steps", () => {
+        const plan = makePlan("story | parallel(architecture, security) | implementation");
+        expect(plan.steps).toHaveLength(4);
+        expect(plan.steps[1].parallel_with).toEqual([3]);
+        expect(plan.steps[2].parallel_with).toEqual([2]);
+        // Implementation blocked by previous (architecture's step)
+        expect(plan.steps[3].blocked_by).toEqual([3]);
+    });
+    it("includes preconditions when story_id provided", () => {
+        const plan = makePlan("story | architecture", "test-001");
+        // architecture has preconditions when storyId is provided
+        expect(plan.steps[1].preconditions.length).toBeGreaterThan(0);
+        expect(plan.steps[1].preconditions[0].description).toContain("test-001");
+    });
+    it("applies model from concept ref", () => {
+        const plan = makePlan("architecture:opus | implementation:sonnet");
+        expect(plan.steps[0].model).toBe("opus");
+        expect(plan.steps[1].model).toBe("sonnet");
+    });
+    it("applies pass count from concept ref", () => {
+        const plan = makePlan("verification[2]");
+        expect(plan.steps[0].passes).toBe(2);
+    });
+    it("estimates cost and duration", () => {
+        const plan = makePlan("story | architecture | implementation");
+        expect(plan.estimated_cost_usd).toBeGreaterThan(0);
+        expect(plan.estimated_duration_ms).toBeGreaterThan(0);
+    });
+    it("model multiplier affects cost", () => {
+        const haiku = makePlan("architecture:haiku");
+        const opus = makePlan("architecture:opus");
+        expect(opus.estimated_cost_usd).toBeGreaterThan(haiku.estimated_cost_usd);
+    });
+    it("marks invalid pipeline plan as invalid", () => {
+        const pipeline = parsePipeline("story | foobar");
+        const validation = validatePipeline(pipeline);
+        const plan = generatePlan(pipeline, validation, {});
+        expect(plan.status).toBe("invalid");
+    });
+    it("includes validation in plan", () => {
+        const plan = makePlan("story | architecture");
+        expect(plan.validation.valid).toBe(true);
+    });
+    it("includes plan_id and created_at", () => {
+        const plan = makePlan("story");
+        expect(plan.plan_id).toMatch(/^plan-/);
+        expect(plan.created_at).toBeTruthy();
+    });
+    it("includes instructions for each step", () => {
+        const plan = makePlan("story | architecture", "test-001");
+        expect(plan.steps[0].instructions).toContain("story");
+        expect(plan.steps[1].instructions).toContain("architecture");
+    });
+    it("respects fromStep", () => {
+        const pipeline = parsePipeline("story | architecture | implementation");
+        const validation = validatePipeline(pipeline);
+        const plan = generatePlan(pipeline, validation, { fromStep: 2 });
+        expect(plan.start_from_step).toBe(2);
+    });
+    it("handles parallel duration correctly (max, not sum)", () => {
+        const seqPlan = makePlan("architecture | security");
+        const parPlan = makePlan("parallel(architecture, security)");
+        // Parallel duration should be less than sequential
+        expect(parPlan.estimated_duration_ms).toBeLessThan(seqPlan.estimated_duration_ms);
+    });
+});
+//# sourceMappingURL=planner.test.js.map

package/dist/tools/pipeline/planner.test.js.map

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

package/dist/tools/pipeline/preconditions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Precondition definitions for pipeline steps.
+ * Pure data — no I/O. Returns what needs to be true, not whether it is.
+ */
+import type { Pipeline, PreconditionSpec } from "./types.js";
+/**
+ * Get precondition specs for all steps in a pipeline.
+ */
+export declare function getPreconditions(pipeline: Pipeline, storyId?: string): Array<{
+    step: number;
+    concept: string;
+    preconditions: PreconditionSpec[];
+}>;
+//# sourceMappingURL=preconditions.d.ts.map

package/dist/tools/pipeline/preconditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preconditions.d.ts","sourceRoot":"","sources":["../../../src/tools/pipeline/preconditions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA+C7D;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAiB7E"}

package/dist/tools/pipeline/preconditions.js

@@ -0,0 +1,65 @@
+/**
+ * Precondition definitions for pipeline steps.
+ * Pure data — no I/O. Returns what needs to be true, not whether it is.
+ */
+// ─── Precondition Definitions ────────────────────────────────
+const CONCEPT_PRECONDITIONS = {
+    story: () => [],
+    architecture: (storyId) => {
+        if (!storyId)
+            return [{ type: "field_not_empty", target: "story_id", description: "Story ID required for architecture" }];
+        return [
+            { type: "file_exists", target: `story-${storyId}`, description: `Story ${storyId} must exist` },
+            { type: "status_equals", target: `story-${storyId}.status=ready`, description: `Story ${storyId} must be ready` },
+        ];
+    },
+    implementation: (storyId) => {
+        if (!storyId)
+            return [{ type: "field_not_empty", target: "story_id", description: "Story ID required for implementation" }];
+        return [
+            { type: "file_exists", target: `architecture-${storyId}`, description: `Architecture for ${storyId} must exist` },
+            { type: "status_equals", target: `architecture-${storyId}.status=completed`, description: `Architecture for ${storyId} must be completed` },
+        ];
+    },
+    quality: (storyId) => {
+        if (!storyId)
+            return [{ type: "field_not_empty", target: "story_id", description: "Story ID required for quality" }];
+        return [
+            { type: "file_exists", target: `implementation-${storyId}`, description: `Implementation for ${storyId} must exist` },
+            { type: "field_not_empty", target: `implementation-${storyId}.files_changed`, description: `Implementation must have changed files` },
+        ];
+    },
+    version: (storyId) => {
+        if (!storyId)
+            return [{ type: "field_not_empty", target: "story_id", description: "Story ID required for version" }];
+        return [
+            { type: "file_exists", target: `review-${storyId}`, description: `Quality review for ${storyId} must exist` },
+            { type: "status_equals", target: `review-${storyId}.status=approved`, description: `Quality review for ${storyId} must be approved` },
+        ];
+    },
+    "code-analysis": () => [],
+    verification: () => [],
+    security: () => [],
+    context: () => [],
+    documentation: () => [],
+    retrospective: () => [],
+};
+/**
+ * Get precondition specs for all steps in a pipeline.
+ */
+export function getPreconditions(pipeline, storyId) {
+    const results = [];
+    let stepNumber = 1;
+    for (const step of pipeline.steps) {
+        for (const concept of step.concepts) {
+            const checker = CONCEPT_PRECONDITIONS[concept];
+            const preconditions = checker
+                ? checker(storyId)
+                : [{ type: "file_exists", target: concept, description: `Unknown concept: ${concept}` }];
+            results.push({ step: stepNumber, concept, preconditions });
+            stepNumber++;
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=preconditions.js.map

package/dist/tools/pipeline/preconditions.js.map

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

package/dist/tools/pipeline/preconditions.test.d.ts

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

package/dist/tools/pipeline/preconditions.test.d.ts.map

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

package/dist/tools/pipeline/preconditions.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from "vitest";
+import { getPreconditions } from "./preconditions.js";
+import { parsePipeline } from "./composer.js";
+describe("getPreconditions", () => {
+    it("returns empty preconditions for story", () => {
+        const pipeline = parsePipeline("story");
+        const results = getPreconditions(pipeline);
+        expect(results).toHaveLength(1);
+        expect(results[0].concept).toBe("story");
+        expect(results[0].preconditions).toHaveLength(0);
+    });
+    it("requires story_id for architecture", () => {
+        const pipeline = parsePipeline("architecture");
+        const results = getPreconditions(pipeline);
+        expect(results[0].preconditions).toHaveLength(1);
+        expect(results[0].preconditions[0].description).toContain("Story ID required");
+    });
+    it("defines file and status checks for architecture with story_id", () => {
+        const pipeline = parsePipeline("architecture");
+        const results = getPreconditions(pipeline, "test-001");
+        expect(results[0].preconditions).toHaveLength(2);
+        expect(results[0].preconditions[0].type).toBe("file_exists");
+        expect(results[0].preconditions[0].target).toContain("story-test-001");
+        expect(results[0].preconditions[1].type).toBe("status_equals");
+    });
+    it("defines preconditions for implementation", () => {
+        const pipeline = parsePipeline("implementation");
+        const results = getPreconditions(pipeline, "test-001");
+        expect(results[0].preconditions).toHaveLength(2);
+        expect(results[0].preconditions[0].target).toContain("architecture");
+    });
+    it("defines preconditions for quality", () => {
+        const pipeline = parsePipeline("quality");
+        const results = getPreconditions(pipeline, "test-001");
+        expect(results[0].preconditions).toHaveLength(2);
+        expect(results[0].preconditions[0].target).toContain("implementation");
+    });
+    it("defines preconditions for version", () => {
+        const pipeline = parsePipeline("version");
+        const results = getPreconditions(pipeline, "test-001");
+        expect(results[0].preconditions).toHaveLength(2);
+        expect(results[0].preconditions[0].target).toContain("review");
+    });
+    it("returns empty for concepts with no preconditions", () => {
+        for (const concept of ["code-analysis", "verification", "security", "context", "documentation", "retrospective"]) {
+            const pipeline = parsePipeline(concept);
+            const results = getPreconditions(pipeline);
+            expect(results[0].preconditions, `${concept} should have no preconditions`).toHaveLength(0);
+        }
+    });
+    it("handles multi-step pipeline", () => {
+        const pipeline = parsePipeline("story | architecture | implementation");
+        const results = getPreconditions(pipeline, "s1");
+        expect(results).toHaveLength(3);
+        expect(results[0].step).toBe(1);
+        expect(results[1].step).toBe(2);
+        expect(results[2].step).toBe(3);
+    });
+    it("handles parallel steps", () => {
+        const pipeline = parsePipeline("parallel(architecture, security)");
+        const results = getPreconditions(pipeline, "s1");
+        expect(results).toHaveLength(2);
+        expect(results[0].concept).toBe("architecture");
+        expect(results[1].concept).toBe("security");
+    });
+    it("returns fallback for unknown concepts", () => {
+        const pipeline = parsePipeline("foobar");
+        // foobar won't parse as known but pipeline still has steps
+        const results = getPreconditions(pipeline);
+        expect(results).toHaveLength(1);
+        expect(results[0].preconditions[0].description).toContain("Unknown concept");
+    });
+});
+//# sourceMappingURL=preconditions.test.js.map

package/dist/tools/pipeline/preconditions.test.js.map

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

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

@@ -0,0 +1,105 @@
+/**
+ * Pipeline Module Types
+ * Concept composition DSL parsing, validation, and execution planning.
+ */
+export type StepType = "sequential" | "parallel";
+/** Extended concept reference with optional action, model, and passes. */
+export interface ConceptRef {
+    concept: string;
+    action?: string;
+    model?: string;
+    passes?: number;
+}
+export interface PipelineStep {
+    type: StepType;
+    concepts: string[];
+    conceptRefs: ConceptRef[];
+}
+export interface PipelineAnnotations {
+    slo?: string;
+    errors?: string;
+}
+export interface Pipeline {
+    raw: string;
+    steps: PipelineStep[];
+    annotations: PipelineAnnotations;
+}
+export interface ValidationError {
+    step: number;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: string[];
+}
+export type StepStatus = "pending" | "ready" | "blocked" | "completed" | "skipped";
+export type PlanStatus = "valid" | "invalid" | "ready" | "in_progress" | "completed";
+export interface PreconditionSpec {
+    type: "file_exists" | "status_equals" | "field_not_empty";
+    target: string;
+    description: string;
+}
+export interface ExecutionStep {
+    step_number: number;
+    concept: string;
+    action: string;
+    model?: string;
+    passes: number;
+    preconditions: PreconditionSpec[];
+    blocked_by?: number[];
+    parallel_with?: number[];
+    instructions: string;
+}
+export interface ExecutionPlan {
+    plan_id: string;
+    pipeline_dsl: string;
+    story_id?: string;
+    created_at: string;
+    status: PlanStatus;
+    steps: ExecutionStep[];
+    validation: ValidationResult;
+    estimated_cost_usd: number;
+    estimated_duration_ms: number;
+    start_from_step?: number;
+}
+export interface PlanOptions {
+    storyId?: string;
+    fromStep?: number;
+}
+export interface ParsedTrigger {
+    concept: string;
+    action: string;
+    status: string;
+    params?: Record<string, string>;
+}
+export interface ParsedAction {
+    concept: string;
+    action: string;
+    model?: string;
+    sloProfile?: string;
+    parallel?: boolean;
+    condition?: string[];
+}
+export interface ParsedRule {
+    trigger: ParsedTrigger;
+    action: ParsedAction;
+    condition?: string[];
+}
+export interface SyncRuleCompiled {
+    id: string;
+    description: string;
+    when: {
+        concept: string;
+        action: string;
+        status: string;
+    };
+    then: {
+        concept: string;
+        action: string;
+        model?: string;
+        parallel?: boolean;
+    };
+    where?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/pipeline/types.js

@@ -0,0 +1,6 @@
+/**
+ * Pipeline Module Types
+ * Concept composition DSL parsing, validation, and execution planning.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Execution Loop / Repair Tools
+ * Provides self-repair and iterative refinement capabilities for code
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const tools: Tool[];
+export declare const repairModule: import("../../core/types.js").ToolModule;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/repair/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAiB1D,eAAO,MAAM,KAAK,EAAE,IAAI,EAoJvB,CAAC;AA2UF,eAAO,MAAM,YAAY,0CAAkC,CAAC"}