@agentplaneorg/core 0.1.0

package/dist/task-readme.js

@@ -0,0 +1,118 @@
+import { parse as parseYaml } from "yaml";
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function splitFrontmatter(markdown) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(markdown);
+    if (!match)
+        return { frontmatterText: null, body: markdown };
+    return { frontmatterText: match[1] ?? null, body: markdown.slice(match[0].length) };
+}
+export function parseTaskReadme(markdown) {
+    const { frontmatterText, body } = splitFrontmatter(markdown);
+    if (frontmatterText == null) {
+        throw new Error("Task README is missing YAML frontmatter");
+    }
+    const parsed = parseYaml(frontmatterText);
+    if (!isRecord(parsed)) {
+        throw new TypeError("Task README frontmatter must be a YAML mapping");
+    }
+    return { frontmatter: parsed, body };
+}
+function renderScalar(value) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    if (typeof value === "number")
+        return String(value);
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    throw new TypeError(`Unsupported scalar type: ${typeof value}`);
+}
+function renderInlineMap(value, preferredKeyOrder) {
+    const keys = Object.keys(value);
+    const ordered = [];
+    if (preferredKeyOrder) {
+        for (const k of preferredKeyOrder)
+            if (k in value)
+                ordered.push(k);
+    }
+    const remaining = keys.filter((k) => !ordered.includes(k)).toSorted((a, b) => a.localeCompare(b));
+    ordered.push(...remaining);
+    const parts = ordered.map((k) => {
+        const v = value[k];
+        if (Array.isArray(v))
+            return `${k}: ${renderFlowSeq(v)}`;
+        if (isRecord(v))
+            return `${k}: ${renderInlineMap(v, null)}`;
+        return `${k}: ${renderScalar(v)}`;
+    });
+    return `{ ${parts.join(", ")} }`;
+}
+function renderFlowSeq(value) {
+    const parts = value.map((v) => {
+        if (Array.isArray(v))
+            return renderFlowSeq(v);
+        if (isRecord(v))
+            return renderInlineMap(v, null);
+        return renderScalar(v);
+    });
+    return `[${parts.join(", ")}]`;
+}
+function renderValue(key, value) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return [`${key}: []`];
+        const allObjects = value.every((v) => isRecord(v));
+        if (!allObjects)
+            return [`${key}: ${renderFlowSeq(value)}`];
+        return [
+            `${key}:`,
+            ...value.map((item) => {
+                if (!isRecord(item))
+                    throw new TypeError("Expected an object item in YAML sequence");
+                const preferred = key === "comments" ? ["author", "body"] : null;
+                return `  - ${renderInlineMap(item, preferred)}`;
+            }),
+        ];
+    }
+    if (isRecord(value)) {
+        const preferred = key === "commit" ? ["hash", "message"] : null;
+        return [`${key}: ${renderInlineMap(value, preferred)}`];
+    }
+    return [`${key}: ${renderScalar(value)}`];
+}
+export function renderTaskFrontmatter(frontmatter) {
+    const preferredKeyOrder = [
+        "id",
+        "title",
+        "status",
+        "priority",
+        "owner",
+        "depends_on",
+        "tags",
+        "verify",
+        "commit",
+        "comments",
+        "doc_version",
+        "doc_updated_at",
+        "doc_updated_by",
+        "description",
+    ];
+    const keys = Object.keys(frontmatter);
+    const ordered = [];
+    for (const k of preferredKeyOrder)
+        if (k in frontmatter)
+            ordered.push(k);
+    const remaining = keys.filter((k) => !ordered.includes(k)).toSorted((a, b) => a.localeCompare(b));
+    ordered.push(...remaining);
+    const lines = [];
+    for (const k of ordered) {
+        lines.push(...renderValue(k, frontmatter[k]));
+    }
+    return `---\n${lines.join("\n")}\n---\n`;
+}
+export function renderTaskReadme(frontmatter, body) {
+    return `${renderTaskFrontmatter(frontmatter)}${body}`;
+}

package/dist/task-store.d.ts

@@ -0,0 +1,74 @@
+export type TaskStatus = "TODO" | "DOING" | "DONE" | "BLOCKED";
+export type TaskPriority = "low" | "normal" | "med" | "high";
+export type TaskFrontmatter = {
+    id: string;
+    title: string;
+    status: TaskStatus;
+    priority: TaskPriority;
+    owner: string;
+    depends_on: string[];
+    tags: string[];
+    verify: string[];
+    comments: {
+        author: string;
+        body: string;
+    }[];
+    doc_version: 2;
+    doc_updated_at: string;
+    doc_updated_by: string;
+    description: string;
+    commit?: {
+        hash: string;
+        message: string;
+    } | null;
+};
+export type TaskRecord = {
+    id: string;
+    frontmatter: TaskFrontmatter;
+    body: string;
+    readmePath: string;
+};
+export declare function validateTaskDocMetadata(frontmatter: Record<string, unknown>): string[];
+export declare function getTasksDir(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<{
+    gitRoot: string;
+    tasksDir: string;
+    idSuffixLengthDefault: number;
+}>;
+export declare function taskReadmePath(tasksDir: string, taskId: string): string;
+export declare function createTask(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    title: string;
+    description: string;
+    owner: string;
+    priority: TaskPriority;
+    tags: string[];
+    dependsOn: string[];
+    verify: string[];
+}): Promise<{
+    id: string;
+    readmePath: string;
+}>;
+export declare function setTaskDocSection(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    taskId: string;
+    section: string;
+    text: string;
+    updatedBy?: string | null;
+}): Promise<{
+    readmePath: string;
+}>;
+export declare function readTask(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    taskId: string;
+}): Promise<TaskRecord>;
+export declare function listTasks(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<TaskRecord[]>;
+//# sourceMappingURL=task-store.d.ts.map

package/dist/task-store.d.ts.map

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

package/dist/task-store.js

@@ -0,0 +1,211 @@
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadConfig } from "./config.js";
+import { resolveProject } from "./project-root.js";
+import { parseTaskReadme, renderTaskReadme } from "./task-readme.js";
+function nowIso() {
+    return new Date().toISOString();
+}
+export function validateTaskDocMetadata(frontmatter) {
+    const errors = [];
+    if (frontmatter.doc_version !== 2)
+        errors.push("doc_version must be 2");
+    const updatedAt = frontmatter.doc_updated_at;
+    if (typeof updatedAt !== "string" || Number.isNaN(Date.parse(updatedAt))) {
+        errors.push("doc_updated_at must be an ISO timestamp");
+    }
+    const updatedBy = frontmatter.doc_updated_by;
+    if (typeof updatedBy !== "string" || updatedBy.trim().length === 0) {
+        errors.push("doc_updated_by must be a non-empty string");
+    }
+    return errors;
+}
+const ID_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+function randomSuffix(length) {
+    let out = "";
+    for (let i = 0; i < length; i++) {
+        out += ID_ALPHABET[Math.floor(Math.random() * ID_ALPHABET.length)];
+    }
+    return out;
+}
+function timestampIdPrefix(date) {
+    const yyyy = String(date.getUTCFullYear()).padStart(4, "0");
+    const mm = String(date.getUTCMonth() + 1).padStart(2, "0");
+    const dd = String(date.getUTCDate()).padStart(2, "0");
+    const hh = String(date.getUTCHours()).padStart(2, "0");
+    const min = String(date.getUTCMinutes()).padStart(2, "0");
+    return `${yyyy}${mm}${dd}${hh}${min}`;
+}
+async function fileExists(filePath) {
+    try {
+        await readFile(filePath, "utf8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function getTasksDir(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    const loaded = await loadConfig(resolved.agentplaneDir);
+    const tasksDir = path.join(resolved.gitRoot, loaded.config.paths.workflow_dir);
+    return {
+        gitRoot: resolved.gitRoot,
+        tasksDir,
+        idSuffixLengthDefault: loaded.config.tasks.id_suffix_length_default,
+    };
+}
+export function taskReadmePath(tasksDir, taskId) {
+    return path.join(tasksDir, taskId, "README.md");
+}
+function defaultTaskBody() {
+    return [
+        "## Summary",
+        "",
+        "",
+        "## Scope",
+        "",
+        "",
+        "## Risks",
+        "",
+        "",
+        "## Verify Steps",
+        "",
+        "",
+        "## Rollback Plan",
+        "",
+    ].join("\n");
+}
+function escapeRegExp(text) {
+    return text.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw `\\$&`);
+}
+function setMarkdownSection(body, section, text) {
+    const lines = body.replaceAll("\r\n", "\n").split("\n");
+    const headingRe = new RegExp(String.raw `^##\s+${escapeRegExp(section)}\s*$`);
+    let start = -1;
+    let nextHeading = lines.length;
+    for (const [i, line] of lines.entries()) {
+        if (!line.startsWith("## "))
+            continue;
+        if (start === -1) {
+            if (headingRe.test(line))
+                start = i;
+            continue;
+        }
+        nextHeading = i;
+        break;
+    }
+    const newTextLines = text.replaceAll("\r\n", "\n").split("\n");
+    const replacement = ["", ...newTextLines, ""];
+    if (start === -1) {
+        const out = [...lines];
+        if (out.length > 0 && out.at(-1)?.trim() !== "")
+            out.push("");
+        out.push(`## ${section}`, ...replacement);
+        return `${out.join("\n")}\n`;
+    }
+    const out = [...lines.slice(0, start + 1), ...replacement, ...lines.slice(nextHeading)];
+    return `${out.join("\n")}\n`;
+}
+export async function createTask(opts) {
+    const { tasksDir, idSuffixLengthDefault } = await getTasksDir({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    await mkdir(tasksDir, { recursive: true });
+    const suffixLength = idSuffixLengthDefault;
+    const base = timestampIdPrefix(new Date());
+    for (let attempt = 0; attempt < 20; attempt++) {
+        const id = `${base}-${randomSuffix(suffixLength)}`;
+        const readmePath = taskReadmePath(tasksDir, id);
+        if (await fileExists(readmePath))
+            continue;
+        const frontmatter = {
+            id,
+            title: opts.title,
+            status: "TODO",
+            priority: opts.priority,
+            owner: opts.owner,
+            depends_on: opts.dependsOn,
+            tags: opts.tags,
+            verify: opts.verify,
+            comments: [],
+            doc_version: 2,
+            doc_updated_at: nowIso(),
+            doc_updated_by: "agentplane",
+            description: opts.description,
+        };
+        const body = defaultTaskBody();
+        const text = renderTaskReadme(frontmatter, body);
+        await mkdir(path.dirname(readmePath), { recursive: true });
+        await writeFile(readmePath, text, "utf8");
+        return { id, readmePath };
+    }
+    throw new Error("Failed to generate a unique task id");
+}
+export async function setTaskDocSection(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    const loaded = await loadConfig(resolved.agentplaneDir);
+    const allowed = loaded.config.tasks.doc.sections;
+    if (!allowed.includes(opts.section)) {
+        throw new Error(`Unknown doc section: ${opts.section}`);
+    }
+    const tasksDir = path.join(resolved.gitRoot, loaded.config.paths.workflow_dir);
+    const readmePath = taskReadmePath(tasksDir, opts.taskId);
+    const original = await readFile(readmePath, "utf8");
+    const parsed = parseTaskReadme(original);
+    const updatedBy = (opts.updatedBy ?? "agentplane").trim();
+    if (updatedBy.length === 0)
+        throw new Error("doc_updated_by must be a non-empty string");
+    const nextFrontmatter = {
+        ...parsed.frontmatter,
+        doc_version: 2,
+        doc_updated_at: nowIso(),
+        doc_updated_by: updatedBy,
+    };
+    const nextBody = setMarkdownSection(parsed.body, opts.section, opts.text);
+    const nextText = renderTaskReadme(nextFrontmatter, nextBody);
+    await writeFile(readmePath, nextText, "utf8");
+    return { readmePath };
+}
+export async function readTask(opts) {
+    const { tasksDir } = await getTasksDir({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    const readmePath = taskReadmePath(tasksDir, opts.taskId);
+    const text = await readFile(readmePath, "utf8");
+    const parsed = parseTaskReadme(text);
+    return {
+        id: opts.taskId,
+        frontmatter: parsed.frontmatter,
+        body: parsed.body,
+        readmePath,
+    };
+}
+export async function listTasks(opts) {
+    const { tasksDir } = await getTasksDir({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    const entries = await readdir(tasksDir, { withFileTypes: true }).catch(() => []);
+    const ids = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    const tasks = [];
+    for (const id of ids) {
+        const readmePath = taskReadmePath(tasksDir, id);
+        try {
+            const text = await readFile(readmePath, "utf8");
+            const parsed = parseTaskReadme(text);
+            tasks.push({
+                id,
+                frontmatter: parsed.frontmatter,
+                body: parsed.body,
+                readmePath,
+            });
+        }
+        catch {
+            // Skip unreadable/broken tasks for now; lint will handle this later.
+        }
+    }
+    return tasks.toSorted((a, b) => a.id.localeCompare(b.id));
+}

package/dist/tasks-export.d.ts

@@ -0,0 +1,49 @@
+export declare function canonicalizeJson(value: unknown): unknown;
+export type TasksExportMeta = {
+    schema_version: 1;
+    managed_by: string;
+    checksum_algo: "sha256";
+    checksum: string;
+};
+export type TasksExportTask = {
+    id: string;
+    title: string;
+    status: string;
+    priority: string;
+    owner: string;
+    depends_on: string[];
+    tags: string[];
+    verify: string[];
+    commit: {
+        hash: string;
+        message: string;
+    } | null;
+    comments: {
+        author: string;
+        body: string;
+    }[];
+    doc_version: 2;
+    doc_updated_at: string;
+    doc_updated_by: string;
+    description: string;
+    dirty: boolean;
+    id_source: string;
+};
+export type TasksExportSnapshot = {
+    tasks: TasksExportTask[];
+    meta: TasksExportMeta;
+};
+export declare function canonicalTasksPayload(tasks: TasksExportTask[]): string;
+export declare function computeTasksChecksum(tasks: TasksExportTask[]): string;
+export declare function buildTasksExportSnapshot(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<TasksExportSnapshot>;
+export declare function writeTasksExport(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<{
+    path: string;
+    snapshot: TasksExportSnapshot;
+}>;
+//# sourceMappingURL=tasks-export.d.ts.map

package/dist/tasks-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-export.d.ts","sourceRoot":"","sources":["../src/tasks-export.ts"],"names":[],"mappings":"AAYA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWxD;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,QAAQ,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAEtE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAGrE;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqE/B;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAW3D"}

package/dist/tasks-export.js

@@ -0,0 +1,96 @@
+import { createHash } from "node:crypto";
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadConfig } from "./config.js";
+import { resolveProject } from "./project-root.js";
+import { listTasks } from "./task-store.js";
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+export function canonicalizeJson(value) {
+    if (Array.isArray(value))
+        return value.map((v) => canonicalizeJson(v));
+    if (isRecord(value)) {
+        const out = {};
+        const keys = Object.keys(value).toSorted((a, b) => a.localeCompare(b));
+        for (const key of keys)
+            out[key] = canonicalizeJson(value[key]);
+        return out;
+    }
+    return value;
+}
+export function canonicalTasksPayload(tasks) {
+    return JSON.stringify(canonicalizeJson({ tasks }));
+}
+export function computeTasksChecksum(tasks) {
+    const payload = canonicalTasksPayload(tasks);
+    return createHash("sha256").update(payload, "utf8").digest("hex");
+}
+export async function buildTasksExportSnapshot(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    await loadConfig(resolved.agentplaneDir);
+    const tasks = await listTasks({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    const exportTasks = tasks.map((t) => {
+        const fm = t.frontmatter;
+        const dependsOn = Array.isArray(fm.depends_on)
+            ? fm.depends_on.filter((v) => typeof v === "string")
+            : [];
+        const tags = Array.isArray(fm.tags)
+            ? fm.tags.filter((v) => typeof v === "string")
+            : [];
+        const verify = Array.isArray(fm.verify)
+            ? fm.verify.filter((v) => typeof v === "string")
+            : [];
+        const commit = isRecord(fm.commit) &&
+            typeof fm.commit.hash === "string" &&
+            typeof fm.commit.message === "string" &&
+            fm.commit.hash.length > 0 &&
+            fm.commit.message.length > 0
+            ? { hash: fm.commit.hash, message: fm.commit.message }
+            : null;
+        const comments = Array.isArray(fm.comments)
+            ? fm.comments
+                .filter((c) => isRecord(c))
+                .filter((c) => typeof c.author === "string" && typeof c.body === "string")
+                .map((c) => ({ author: c.author, body: c.body }))
+            : [];
+        return {
+            id: typeof fm.id === "string" ? fm.id : t.id,
+            title: typeof fm.title === "string" ? fm.title : "",
+            status: typeof fm.status === "string" ? fm.status : "",
+            priority: typeof fm.priority === "string" ? fm.priority : "",
+            owner: typeof fm.owner === "string" ? fm.owner : "",
+            depends_on: dependsOn,
+            tags,
+            verify,
+            commit,
+            comments,
+            doc_version: 2,
+            doc_updated_at: typeof fm.doc_updated_at === "string" ? fm.doc_updated_at : "",
+            doc_updated_by: typeof fm.doc_updated_by === "string" ? fm.doc_updated_by : "",
+            description: typeof fm.description === "string" ? fm.description : "",
+            dirty: false,
+            id_source: "generated",
+        };
+    });
+    const sorted = exportTasks.toSorted((a, b) => a.id.localeCompare(b.id));
+    const checksum = computeTasksChecksum(sorted);
+    return {
+        tasks: sorted,
+        meta: {
+            schema_version: 1,
+            managed_by: "agentplane",
+            checksum_algo: "sha256",
+            checksum,
+        },
+    };
+}
+export async function writeTasksExport(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    const loaded = await loadConfig(resolved.agentplaneDir);
+    const outPath = path.join(resolved.gitRoot, loaded.config.paths.tasks_path);
+    const snapshot = await buildTasksExportSnapshot(opts);
+    await mkdir(path.dirname(outPath), { recursive: true });
+    await writeFile(outPath, `${JSON.stringify(snapshot, null, 2)}\n`, "utf8");
+    return { path: outPath, snapshot };
+}

package/dist/tasks-lint.d.ts

@@ -0,0 +1,19 @@
+import type { AgentplaneConfig } from "./config.js";
+import { type TasksExportSnapshot } from "./tasks-export.js";
+export type TasksLintResult = {
+    errors: string[];
+};
+export declare function lintTasksSnapshot(snapshot: TasksExportSnapshot, config: AgentplaneConfig): TasksLintResult;
+export declare function readTasksExport(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<{
+    snapshot: TasksExportSnapshot;
+    path: string;
+    config: AgentplaneConfig;
+}>;
+export declare function lintTasksFile(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<TasksLintResult>;
+//# sourceMappingURL=tasks-lint.d.ts.map

package/dist/tasks-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-lint.d.ts","sourceRoot":"","sources":["../src/tasks-lint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AA2DF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,gBAAgB,GACvB,eAAe,CA4GjB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAOrF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,eAAe,CAAC,CAG3B"}