@agentplaneorg/core 0.1.4 → 0.1.6

package/dist/{task-store.d.ts → tasks/task-store.d.ts}

@@ -1,3 +1,4 @@
+import { generateTaskId } from "./task-id.js";
 export type TaskStatus = "TODO" | "DOING" | "DONE" | "BLOCKED";
 export type TaskPriority = "low" | "normal" | "med" | "high";
 export type TaskFrontmatter = {
@@ -48,6 +49,7 @@ export declare function createTask(opts: {
     tags: string[];
     dependsOn: string[];
     verify: string[];
+    idGenerator?: typeof generateTaskId;
 }): Promise<{
     id: string;
     readmePath: string;

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

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

package/dist/tasks/task-store.js

@@ -0,0 +1,212 @@
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadConfig } from "../config/config.js";
+import { resolveProject } from "../project/project-root.js";
+import { parseTaskReadme, renderTaskReadme } from "./task-readme.js";
+import { ensureDocSections, setMarkdownSection } from "./task-doc.js";
+import { generateTaskId } from "./task-id.js";
+function nowIso() {
+    return new Date().toISOString();
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+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;
+}
+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",
+        "",
+        "",
+        "## Verification",
+        "",
+        "",
+        "## Rollback Plan",
+        "",
+    ].join("\n");
+}
+function getLastCommentAuthor(frontmatter) {
+    const comments = frontmatter.comments;
+    if (!Array.isArray(comments))
+        return null;
+    const entries = comments;
+    for (let i = entries.length - 1; i >= 0; i -= 1) {
+        const entry = entries[i];
+        if (!isRecord(entry))
+            continue;
+        const author = entry.author;
+        if (typeof author === "string") {
+            const trimmed = author.trim();
+            if (trimmed)
+                return trimmed;
+        }
+    }
+    return null;
+}
+function resolveDocUpdatedBy(frontmatter, updatedBy) {
+    if (updatedBy != null) {
+        const explicit = updatedBy.trim();
+        if (explicit.length === 0) {
+            throw new Error("doc_updated_by must be a non-empty string");
+        }
+        return explicit;
+    }
+    const lastAuthor = getLastCommentAuthor(frontmatter);
+    if (lastAuthor)
+        return lastAuthor;
+    const existing = frontmatter.doc_updated_by;
+    if (typeof existing === "string") {
+        const trimmed = existing.trim();
+        if (trimmed && trimmed.toLowerCase() !== "agentplane")
+            return trimmed;
+    }
+    const owner = frontmatter.owner;
+    if (typeof owner === "string") {
+        const trimmed = owner.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    return "agentplane";
+}
+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 id = await (opts.idGenerator ?? generateTaskId)({
+        length: suffixLength,
+        attempts: 20,
+        isAvailable: async (taskId) => !(await fileExists(taskReadmePath(tasksDir, taskId))),
+    });
+    const readmePath = taskReadmePath(tasksDir, id);
+    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: opts.owner,
+        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 };
+}
+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 = resolveDocUpdatedBy(parsed.frontmatter, opts.updatedBy);
+    const nextFrontmatter = {
+        ...parsed.frontmatter,
+        doc_version: 2,
+        doc_updated_at: nowIso(),
+        doc_updated_by: updatedBy,
+    };
+    const baseDoc = ensureDocSections(parsed.body, loaded.config.tasks.doc.required_sections);
+    const nextBody = ensureDocSections(setMarkdownSection(baseDoc, opts.section, opts.text), loaded.config.tasks.doc.required_sections);
+    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/tasks-export.d.ts.map

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

@@ -1,8 +1,9 @@
 import { createHash } from "node:crypto";
-import { mkdir, writeFile } from "node:fs/promises";
+import { mkdir } from "node:fs/promises";
 import path from "node:path";
-import { loadConfig } from "./config.js";
-import { resolveProject } from "./project-root.js";
+import { loadConfig } from "../config/config.js";
+import { atomicWriteFile } from "../fs/atomic-write.js";
+import { resolveProject } from "../project/project-root.js";
 import { listTasks } from "./task-store.js";
 function isRecord(value) {
     return !!value && typeof value === "object" && !Array.isArray(value);
@@ -91,6 +92,6 @@ export async function writeTasksExport(opts) {
     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");
+    await atomicWriteFile(outPath, `${JSON.stringify(snapshot, null, 2)}\n`);
     return { path: outPath, snapshot };
 }

package/dist/{tasks-lint.d.ts → tasks/tasks-lint.d.ts}

@@ -1,4 +1,4 @@
-import type { AgentplaneConfig } from "./config.js";
+import type { AgentplaneConfig } from "../config/config.js";
 import { type TasksExportSnapshot } from "./tasks-export.js";
 export type TasksLintResult = {
     errors: string[];

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-lint.d.ts","sourceRoot":"","sources":["../../src/tasks/tasks-lint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,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"}

package/dist/{tasks-lint.js → tasks/tasks-lint.js}

@@ -1,7 +1,7 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { loadConfig } from "./config.js";
-import { resolveProject } from "./project-root.js";
+import { loadConfig } from "../config/config.js";
+import { resolveProject } from "../project/project-root.js";
 import { computeTasksChecksum, } from "./tasks-export.js";
 function isRecord(value) {
     return !!value && typeof value === "object" && !Array.isArray(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentplaneorg/core",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Core utilities and models for the Agent Plane CLI.",
   "keywords": [
     "agentplane",
@@ -30,6 +30,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "schemas",
     "README.md",
     "LICENSE"
   ],
@@ -43,6 +44,8 @@
     "prepack": "bun run clean && bun run build"
   },
   "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
     "yaml": "^2.8.2"
   }
 }

package/schemas/config.schema.json

@@ -0,0 +1,278 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://agentplane.dev/schemas/config.schema.json",
+  "title": "agentplane config.json (v1)",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_version", "workflow_mode", "paths", "tasks", "commit", "tasks_backend"],
+  "properties": {
+    "schema_version": { "type": "integer", "const": 1, "default": 1 },
+    "workflow_mode": {
+      "type": "string",
+      "enum": ["direct", "branch_pr"],
+      "default": "direct"
+    },
+    "status_commit_policy": {
+      "type": "string",
+      "enum": ["off", "warn", "confirm"],
+      "default": "warn"
+    },
+    "finish_auto_status_commit": { "type": "boolean", "default": true },
+    "base_branch": { "type": "string", "minLength": 1, "default": "main" },
+    "agents": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["approvals"],
+      "default": {
+        "approvals": { "require_plan": true, "require_network": true, "require_verify": true }
+      },
+      "properties": {
+        "approvals": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["require_plan", "require_network", "require_verify"],
+          "default": { "require_plan": true, "require_network": true, "require_verify": true },
+          "properties": {
+            "require_plan": { "type": "boolean", "default": true },
+            "require_network": { "type": "boolean", "default": true },
+            "require_verify": { "type": "boolean", "default": true }
+          }
+        }
+      }
+    },
+    "recipes": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["storage_default"],
+      "default": { "storage_default": "link" },
+      "properties": {
+        "storage_default": {
+          "type": "string",
+          "enum": ["link", "copy", "global"],
+          "default": "link"
+        }
+      }
+    },
+    "paths": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["agents_dir", "tasks_path", "workflow_dir", "worktrees_dir"],
+      "default": {
+        "agents_dir": ".agentplane/agents",
+        "tasks_path": ".agentplane/tasks.json",
+        "workflow_dir": ".agentplane/tasks",
+        "worktrees_dir": ".agentplane/worktrees"
+      },
+      "properties": {
+        "agents_dir": { "type": "string", "minLength": 1, "default": ".agentplane/agents" },
+        "tasks_path": { "type": "string", "minLength": 1, "default": ".agentplane/tasks.json" },
+        "workflow_dir": { "type": "string", "minLength": 1, "default": ".agentplane/tasks" },
+        "worktrees_dir": { "type": "string", "minLength": 1, "default": ".agentplane/worktrees" }
+      }
+    },
+    "branch": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["task_prefix"],
+      "default": { "task_prefix": "task" },
+      "properties": {
+        "task_prefix": { "type": "string", "minLength": 1, "default": "task" }
+      }
+    },
+    "framework": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["source", "last_update"],
+      "default": {
+        "source": "https://github.com/basilisk-labs/agent-plane",
+        "last_update": null
+      },
+      "properties": {
+        "source": {
+          "type": "string",
+          "minLength": 1,
+          "default": "https://github.com/basilisk-labs/agent-plane"
+        },
+        "last_update": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "default": null
+        }
+      }
+    },
+    "tasks": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id_suffix_length_default", "verify", "doc", "comments"],
+      "default": {
+        "id_suffix_length_default": 6,
+        "verify": { "required_tags": ["code", "backend", "frontend"] },
+        "doc": {
+          "sections": [
+            "Summary",
+            "Context",
+            "Scope",
+            "Risks",
+            "Verify Steps",
+            "Verification",
+            "Rollback Plan",
+            "Notes"
+          ],
+          "required_sections": [
+            "Summary",
+            "Scope",
+            "Risks",
+            "Verify Steps",
+            "Verification",
+            "Rollback Plan"
+          ]
+        },
+        "comments": {
+          "start": { "prefix": "Start:", "min_chars": 40 },
+          "blocked": { "prefix": "Blocked:", "min_chars": 40 },
+          "verified": { "prefix": "Verified:", "min_chars": 60 }
+        }
+      },
+      "properties": {
+        "id_suffix_length_default": {
+          "type": "integer",
+          "minimum": 3,
+          "maximum": 16,
+          "default": 6
+        },
+        "verify": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["required_tags"],
+          "default": { "required_tags": ["code", "backend", "frontend"] },
+          "properties": {
+            "required_tags": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "uniqueItems": true,
+              "default": ["code", "backend", "frontend"]
+            }
+          }
+        },
+        "doc": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["sections", "required_sections"],
+          "default": {
+            "sections": [
+              "Summary",
+              "Context",
+              "Scope",
+              "Risks",
+              "Verify Steps",
+              "Verification",
+              "Rollback Plan",
+              "Notes"
+            ],
+            "required_sections": [
+              "Summary",
+              "Scope",
+              "Risks",
+              "Verify Steps",
+              "Verification",
+              "Rollback Plan"
+            ]
+          },
+          "properties": {
+            "sections": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "default": [
+                "Summary",
+                "Context",
+                "Scope",
+                "Risks",
+                "Verify Steps",
+                "Verification",
+                "Rollback Plan",
+                "Notes"
+              ]
+            },
+            "required_sections": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "default": [
+                "Summary",
+                "Scope",
+                "Risks",
+                "Verify Steps",
+                "Verification",
+                "Rollback Plan"
+              ]
+            }
+          }
+        },
+        "comments": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["start", "blocked", "verified"],
+          "default": {
+            "start": { "prefix": "Start:", "min_chars": 40 },
+            "blocked": { "prefix": "Blocked:", "min_chars": 40 },
+            "verified": { "prefix": "Verified:", "min_chars": 60 }
+          },
+          "properties": {
+            "start": {
+              "$ref": "#/$defs/comment_policy",
+              "default": { "prefix": "Start:", "min_chars": 40 }
+            },
+            "blocked": {
+              "$ref": "#/$defs/comment_policy",
+              "default": { "prefix": "Blocked:", "min_chars": 40 }
+            },
+            "verified": {
+              "$ref": "#/$defs/comment_policy",
+              "default": { "prefix": "Verified:", "min_chars": 60 }
+            }
+          }
+        }
+      }
+    },
+    "commit": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["generic_tokens"],
+      "default": {
+        "generic_tokens": ["start", "status", "mark", "done", "wip", "update", "tasks", "task"]
+      },
+      "properties": {
+        "generic_tokens": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true,
+          "default": ["start", "status", "mark", "done", "wip", "update", "tasks", "task"]
+        }
+      }
+    },
+    "tasks_backend": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["config_path"],
+      "default": { "config_path": ".agentplane/backends/local/backend.json" },
+      "properties": {
+        "config_path": {
+          "type": "string",
+          "minLength": 1,
+          "default": ".agentplane/backends/local/backend.json"
+        }
+      }
+    },
+    "closure_commit_requires_approval": { "type": "boolean", "default": false }
+  },
+  "$defs": {
+    "comment_policy": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["prefix", "min_chars"],
+      "properties": {
+        "prefix": { "type": "string", "minLength": 1 },
+        "min_chars": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/dist/base-branch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-branch.d.ts","sourceRoot":"","sources":["../src/base-branch.ts"],"names":[],"mappings":"AA0BA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGzB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlB"}

package/dist/commit-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commit-policy.d.ts","sourceRoot":"","sources":["../src/commit-policy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAMF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAOlF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,kBAAkB,CAerB"}

package/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,CAAC,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,oBAAoB,EAAE,kBAAkB,CAAC;IACzC,yBAAyB,EAAE,OAAO,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,SAAS,EAAE;YACT,YAAY,EAAE,OAAO,CAAC;YACtB,eAAe,EAAE,OAAO,CAAC;SAC1B,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;KAC7C,CAAC;IACF,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1D,KAAK,EAAE;QACL,wBAAwB,EAAE,MAAM,CAAC;QACjC,MAAM,EAAE;YAAE,aAAa,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QACpC,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QACzD,QAAQ,EAAE;YACR,KAAK,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;YAC7C,OAAO,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;YAC/C,QAAQ,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;SACjD,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACrC,aAAa,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,gCAAgC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,wBAAgB,aAAa,IAAI,gBAAgB,CAmDhD;AAMD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAiG7D;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAAC;AAQF,wBAAsB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyB7E;AAkBD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAgBN;AAED,wBAAsB,UAAU,CAC9B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAO3B"}