@gopherine/obsidian-mcp 0.1.1

package/dist/commands/skill/validate.js

@@ -0,0 +1,39 @@
+import { readFile } from "fs/promises";
+import { parseFrontmatter } from "../../lib/frontmatter.js";
+import { validateSkillFrontmatter } from "./schema.js";
+async function fetchUrl(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+}
+function isUrl(source) {
+    return source.startsWith("http://") || source.startsWith("https://");
+}
+export async function validateSkill(options) {
+    const { skillPath } = options;
+    let content;
+    try {
+        if (isUrl(skillPath)) {
+            content = await fetchUrl(skillPath);
+        }
+        else {
+            content = await readFile(skillPath, "utf-8");
+        }
+    }
+    catch (e) {
+        return {
+            valid: false,
+            errors: [`Failed to read file: ${e.message}`],
+        };
+    }
+    const { data } = parseFrontmatter(content);
+    const { valid, errors } = validateSkillFrontmatter(data);
+    return {
+        valid,
+        errors,
+        frontmatter: valid ? data : undefined,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/skill/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/commands/skill/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAoB,MAAM,aAAa,CAAC;AAYzE,KAAK,UAAU,QAAQ,CAAC,GAAW;IACjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,KAAK,CAAC,MAAc;IAC3B,OAAO,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAwB;IAExB,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,CAAC,wBAAyB,CAAW,CAAC,OAAO,EAAE,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAEzD,OAAO;QACL,KAAK;QACL,MAAM;QACN,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,IAAmC,CAAC,CAAC,CAAC,SAAS;KACrE,CAAC;AACJ,CAAC"}

package/dist/commands/skill/validate.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/skill/validate.test.js

@@ -0,0 +1,171 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdir, rm, writeFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+import { validateSkill } from "./validate.js";
+describe("validateSkill", () => {
+    let vaultRoot;
+    beforeEach(async () => {
+        vaultRoot = join(homedir(), `.vault-skill-validate-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(vaultRoot, { recursive: true });
+    });
+    afterEach(async () => {
+        await rm(vaultRoot, { recursive: true, force: true });
+    });
+    describe("valid skill files", () => {
+        const cases = [
+            {
+                name: "minimal valid frontmatter",
+                content: "---\nname: my-skill\ndescription: Does something\n---\n\n# My Skill",
+                expectedName: "my-skill",
+                expectedDesc: "Does something",
+            },
+            {
+                name: "full frontmatter with all optional fields",
+                content: `---
+name: full-skill
+description: Full skill with all fields
+version: "2.1.0"
+author: test-author
+tags:
+  - category
+  - utility
+depends_on:
+  - base-skill
+---
+
+# Full Skill
+`,
+                expectedName: "full-skill",
+                expectedVersion: "2.1.0",
+            },
+            {
+                name: "frontmatter with body content",
+                content: "---\nname: body-skill\ndescription: Has body\n---\n\nSome body content here",
+                expectedName: "body-skill",
+            },
+        ];
+        for (const { name, content, expectedName, expectedDesc, expectedVersion } of cases) {
+            it(name, async () => {
+                const skillPath = join(vaultRoot, "skill.md");
+                await writeFile(skillPath, content);
+                const result = await validateSkill({ skillPath });
+                expect(result.valid).toBe(true);
+                expect(result.errors).toEqual([]);
+                expect(result.frontmatter?.name).toBe(expectedName);
+                if (expectedDesc)
+                    expect(result.frontmatter?.description).toBe(expectedDesc);
+                if (expectedVersion)
+                    expect(result.frontmatter?.version).toBe(expectedVersion);
+            });
+        }
+    });
+    describe("invalid skill files", () => {
+        const cases = [
+            {
+                name: "missing name field",
+                content: "---\ndescription: No name\n---\n\n# Skill",
+                expectedError: "name",
+            },
+            {
+                name: "missing description field",
+                content: "---\nname: no-desc\n---\n\n# Skill",
+                expectedError: "description",
+            },
+            {
+                name: "empty frontmatter",
+                content: "---\n---\n\n# Skill",
+                expectedErrorCount: 2,
+            },
+            {
+                name: "no frontmatter at all",
+                content: "# Just a heading\n\nNo frontmatter here",
+                expectedErrorCount: 2,
+            },
+            {
+                name: "non-string version",
+                content: "---\nname: bad-ver\ndescription: Test\nversion: 123\n---\n\n# Skill",
+                expectedError: "version",
+            },
+            {
+                name: "non-string author",
+                content: "---\nname: bad-author\ndescription: Test\nauthor: 42\n---\n\n# Skill",
+                expectedError: "author",
+            },
+            {
+                name: "non-array tags",
+                content: "---\nname: bad-tags\ndescription: Test\ntags: not-array\n---\n\n# Skill",
+                expectedError: "tags",
+            },
+            {
+                name: "non-string array tags",
+                content: "---\nname: bad-tags2\ndescription: Test\ntags: [1, 2]\n---\n\n# Skill",
+                expectedError: "tags",
+            },
+            {
+                name: "non-array depends_on",
+                content: "---\nname: bad-deps\ndescription: Test\ndepends_on: string-val\n---\n\n# Skill",
+                expectedError: "depends_on",
+            },
+        ];
+        for (const { name, content, expectedError, expectedErrorCount } of cases) {
+            it(name, async () => {
+                const skillPath = join(vaultRoot, "invalid.md");
+                await writeFile(skillPath, content);
+                const result = await validateSkill({ skillPath });
+                expect(result.valid).toBe(false);
+                if (expectedError) {
+                    expect(result.errors.some((e) => e.includes(expectedError))).toBe(true);
+                }
+                if (expectedErrorCount) {
+                    expect(result.errors.length).toBe(expectedErrorCount);
+                }
+                expect(result.frontmatter).toBeUndefined();
+            });
+        }
+    });
+    describe("file read errors", () => {
+        it("returns error for nonexistent file", async () => {
+            const result = await validateSkill({ skillPath: "/nonexistent/path/skill.md" });
+            expect(result.valid).toBe(false);
+            expect(result.errors[0]).toContain("Failed to read file");
+        });
+    });
+    describe("URL sources", () => {
+        it("validates skill from URL", async () => {
+            const mockContent = "---\nname: url-skill\ndescription: From URL\n---\n\n# URL Skill";
+            vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+                ok: true,
+                text: () => Promise.resolve(mockContent),
+            }));
+            const result = await validateSkill({ skillPath: "https://example.com/skill.md" });
+            expect(result.valid).toBe(true);
+            expect(result.frontmatter?.name).toBe("url-skill");
+            vi.unstubAllGlobals();
+        });
+        it("returns error when fetch fails", async () => {
+            vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+                ok: false,
+                status: 404,
+                statusText: "Not Found",
+            }));
+            const result = await validateSkill({ skillPath: "https://example.com/missing.md" });
+            expect(result.valid).toBe(false);
+            expect(result.errors[0]).toContain("Failed to fetch");
+            vi.unstubAllGlobals();
+        });
+        it("returns error when fetch throws", async () => {
+            vi.stubGlobal("fetch", vi.fn().mockRejectedValue(new Error("Network error")));
+            const result = await validateSkill({ skillPath: "https://example.com/error.md" });
+            expect(result.valid).toBe(false);
+            expect(result.errors[0]).toContain("Failed to read file");
+            vi.unstubAllGlobals();
+        });
+        it("does not treat non-http paths as URLs", async () => {
+            const result = await validateSkill({ skillPath: "/local/path.md" });
+            expect(result.valid).toBe(false);
+            expect(result.errors[0]).toContain("Failed to read file");
+        });
+    });
+});
+//# sourceMappingURL=validate.test.js.map

package/dist/commands/skill/validate.test.js.map

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

package/dist/commands/task.d.ts

@@ -0,0 +1,34 @@
+import type { CommandContext } from "../core/types.js";
+export type TaskStatus = "backlog" | "in-progress" | "blocked" | "done" | "cancelled";
+export type TaskPriority = "p0" | "p1" | "p2";
+export interface TaskItem {
+    id: string;
+    title: string;
+    status: TaskStatus;
+    priority: TaskPriority;
+    blocked_by: string[];
+    assigned_to: string;
+    sprint: string;
+    tags: string[];
+    created: string;
+    updated: string;
+    path: string;
+}
+export declare function taskCommand(args: {
+    action: "add" | "list" | "update" | "board";
+    title?: string;
+    taskId?: string;
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    blockedBy?: string[];
+    assignedTo?: string;
+    sprint?: string;
+    tags?: string[];
+    project?: string;
+}, ctx: CommandContext): Promise<{
+    task_id?: string;
+    path?: string;
+    updated_fields?: string[];
+    tasks?: TaskItem[];
+    board?: Record<string, TaskItem[]>;
+}>;

package/dist/commands/task.js

@@ -0,0 +1,160 @@
+import { parseFrontmatter, serializeFrontmatter, createFrontmatter, mergeFrontmatter } from "../lib/frontmatter.js";
+import { resolveProject } from "../config.js";
+import { getNextNumber, slugify } from "../lib/auto-number.js";
+const VALID_TASK_STATUSES = ["backlog", "in-progress", "blocked", "done", "cancelled"];
+const VALID_TASK_PRIORITIES = ["p0", "p1", "p2"];
+const STATUS_COLUMNS = ["backlog", "in-progress", "blocked", "done", "cancelled"];
+export async function taskCommand(args, ctx) {
+    const projectSlug = await resolveProject(ctx.vaultPath, args.project);
+    const vaultFs = ctx.vaultFs;
+    const tasksDir = `projects/${projectSlug}/tasks`;
+    switch (args.action) {
+        case "add": {
+            if (!args.title)
+                throw new Error("Title required for add");
+            const nextNum = await getNextNumber(vaultFs, tasksDir);
+            const padded = String(nextNum).padStart(3, "0");
+            const titleSlug = slugify(args.title);
+            const taskId = `task-${padded}`;
+            const filename = `${taskId}-${titleSlug}.md`;
+            const filePath = `${tasksDir}/${filename}`;
+            const priority = args.priority ?? "p1";
+            if (!VALID_TASK_PRIORITIES.includes(priority)) {
+                throw new Error(`Invalid priority "${priority}". Must be one of: ${VALID_TASK_PRIORITIES.join(", ")}`);
+            }
+            const fm = createFrontmatter({
+                type: "task",
+                project: projectSlug,
+                status: "backlog",
+                priority,
+                blocked_by: args.blockedBy ?? [],
+                assigned_to: args.assignedTo ?? "",
+                sprint: args.sprint ?? "",
+                tags: args.tags ?? [],
+            });
+            const body = `\n# ${args.title}\n`;
+            await vaultFs.write(filePath, serializeFrontmatter(fm, body));
+            return { task_id: taskId, path: filePath };
+        }
+        case "list": {
+            const tasks = await listTasks(vaultFs, tasksDir);
+            let filtered = tasks;
+            if (args.status) {
+                filtered = filtered.filter((t) => t.status === args.status);
+            }
+            if (args.priority) {
+                filtered = filtered.filter((t) => t.priority === args.priority);
+            }
+            if (args.assignedTo) {
+                filtered = filtered.filter((t) => t.assigned_to === args.assignedTo);
+            }
+            return { tasks: filtered };
+        }
+        case "update": {
+            if (!args.taskId)
+                throw new Error("Task ID required for update");
+            const tasks = await listTasks(vaultFs, tasksDir);
+            const task = tasks.find((t) => t.id === args.taskId);
+            if (!task)
+                throw new Error(`Task not found: ${args.taskId}`);
+            const content = await vaultFs.read(task.path);
+            const { data, content: body } = parseFrontmatter(content);
+            const updatedFields = [];
+            if (args.status) {
+                if (!VALID_TASK_STATUSES.includes(args.status)) {
+                    throw new Error(`Invalid status "${args.status}". Must be one of: ${VALID_TASK_STATUSES.join(", ")}`);
+                }
+                data.status = args.status;
+                updatedFields.push("status");
+            }
+            if (args.priority) {
+                if (!VALID_TASK_PRIORITIES.includes(args.priority)) {
+                    throw new Error(`Invalid priority "${args.priority}". Must be one of: ${VALID_TASK_PRIORITIES.join(", ")}`);
+                }
+                data.priority = args.priority;
+                updatedFields.push("priority");
+            }
+            if (args.blockedBy !== undefined) {
+                data.blocked_by = args.blockedBy;
+                updatedFields.push("blocked_by");
+            }
+            if (args.assignedTo !== undefined) {
+                data.assigned_to = args.assignedTo;
+                updatedFields.push("assigned_to");
+            }
+            if (args.title) {
+                const newBody = body.replace(/^# .+$/m, `# ${args.title}`);
+                const updated = mergeFrontmatter(data, {});
+                await vaultFs.write(task.path, serializeFrontmatter(updated, newBody));
+                updatedFields.push("title");
+                return { task_id: args.taskId, updated_fields: updatedFields };
+            }
+            const updated = mergeFrontmatter(data, {});
+            await vaultFs.write(task.path, serializeFrontmatter(updated, body));
+            return { task_id: args.taskId, updated_fields: updatedFields };
+        }
+        case "board": {
+            const tasks = await listTasks(vaultFs, tasksDir);
+            const board = {};
+            for (const col of STATUS_COLUMNS) {
+                board[col] = tasks.filter((t) => t.status === col);
+            }
+            return { board };
+        }
+        default:
+            throw new Error(`Unknown action: ${args.action}`);
+    }
+}
+async function listTasks(vaultFs, tasksDir) {
+    const tasks = [];
+    let files;
+    try {
+        files = await vaultFs.list(tasksDir, 1);
+    }
+    catch {
+        return [];
+    }
+    for (const file of files) {
+        if (!file.endsWith(".md"))
+            continue;
+        const filePath = file;
+        try {
+            const content = await vaultFs.read(filePath);
+            const { data, content: body } = parseFrontmatter(content);
+            if (data.type !== "task")
+                continue;
+            const basename = file.split("/").pop() ?? file;
+            const idMatch = basename.match(/^(task-\d+)/);
+            if (!idMatch)
+                continue;
+            const titleMatch = body.match(/^# (.+)$/m);
+            const title = titleMatch ? titleMatch[1].trim() : file;
+            tasks.push({
+                id: idMatch[1],
+                title,
+                status: data.status ?? "backlog",
+                priority: data.priority ?? "p1",
+                blocked_by: Array.isArray(data.blocked_by) ? data.blocked_by : [],
+                assigned_to: data.assigned_to ?? "",
+                sprint: data.sprint ?? "",
+                tags: Array.isArray(data.tags) ? data.tags : [],
+                created: data.created ?? "",
+                updated: data.updated ?? "",
+                path: filePath,
+            });
+        }
+        catch (e) {
+            if (e instanceof Error && "code" in e && e.code !== "ENOENT") {
+                console.error("[task] Skipping unreadable task file:", e instanceof Error ? e.message : e);
+            }
+        }
+    }
+    tasks.sort((a, b) => {
+        const priOrder = VALID_TASK_PRIORITIES.indexOf(a.priority) - VALID_TASK_PRIORITIES.indexOf(b.priority);
+        if (priOrder !== 0)
+            return priOrder;
+        return a.id.localeCompare(b.id);
+    });
+    return tasks;
+}
+//# sourceMappingURL=task.js.map

package/dist/commands/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAmB/D,MAAM,mBAAmB,GAAiB,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACrG,MAAM,qBAAqB,GAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACjE,MAAM,cAAc,GAAiB,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAEhG,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAWC,EACD,GAAmB;IAQnB,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,MAAM,QAAQ,GAAG,YAAY,WAAW,QAAQ,CAAC;IAEjD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAE3D,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,QAAQ,MAAM,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,SAAS,KAAK,CAAC;YAC7C,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;YACvC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,sBAAsB,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzG,CAAC;YAED,MAAM,EAAE,GAAG,iBAAiB,CAAC;gBAC3B,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,WAAW;gBACpB,MAAM,EAAE,SAAS;gBACjB,QAAQ;gBACR,UAAU,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;gBAChC,WAAW,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;gBAClC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC;YACnC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;YAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7C,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjD,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;YACvE,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC7B,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAEjE,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAE7D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM,aAAa,GAAa,EAAE,CAAC;YAEnC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/C,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,MAAM,sBAAsB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxG,CAAC;gBACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC1B,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnD,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,QAAQ,sBAAsB,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC9G,CAAC;gBACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAC9B,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;gBACjC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;gBACnC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC3D,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3C,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBACvE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;YACjE,CAAC;YAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC3C,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAEpE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;QACjE,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjD,MAAM,KAAK,GAA+B,EAAE,CAAC;YAE7C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;gBACjC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;YACrD,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAA6C,EAAE,QAAgB;IACtF,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAE1D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;YAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAEvD,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;gBACd,KAAK;gBACL,MAAM,EAAG,IAAI,CAAC,MAAqB,IAAI,SAAS;gBAChD,QAAQ,EAAG,IAAI,CAAC,QAAyB,IAAI,IAAI;gBACjD,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAsB,CAAC,CAAC,CAAC,EAAE;gBAC7E,WAAW,EAAG,IAAI,CAAC,WAAsB,IAAI,EAAE;gBAC/C,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,EAAE;gBACrC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAgB,CAAC,CAAC,CAAC,EAAE;gBAC3D,OAAO,EAAG,IAAI,CAAC,OAAkB,IAAI,EAAE;gBACvC,OAAO,EAAG,IAAI,CAAC,OAAkB,IAAI,EAAE;gBACvC,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,KAAK,IAAI,MAAM,IAAI,CAAC,IAAK,CAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtE,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvG,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QACpC,OAAO,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/commands/task.test.d.ts

@@ -0,0 +1 @@
+export {};