@agentplaneorg/core 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Denis Smirnov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,5 @@
+# @agentplane/core
+
+Internal core library used by the `agentplane` CLI.
+
+This package is intended to be published alongside `agentplane` to satisfy runtime dependencies.

package/dist/base-branch.d.ts

@@ -0,0 +1,14 @@
+export declare function getPinnedBaseBranch(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<string | null>;
+export declare function getBaseBranch(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<string>;
+export declare function setPinnedBaseBranch(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    value: string;
+}): Promise<string>;
+//# sourceMappingURL=base-branch.d.ts.map

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

@@ -0,0 +1 @@
+{"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/base-branch.js

@@ -0,0 +1,38 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { resolveProject } from "./project-root.js";
+const execFileAsync = promisify(execFile);
+const DEFAULT_BASE_BRANCH = "main";
+const GIT_CONFIG_BASE_BRANCH_KEY = "agentplane.baseBranch";
+async function gitConfigGet(cwd, key) {
+    try {
+        const { stdout } = await execFileAsync("git", ["config", "--local", "--get", key], { cwd });
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 1)
+            return null;
+        throw err;
+    }
+}
+async function gitConfigSet(cwd, key, value) {
+    await execFileAsync("git", ["config", "--local", key, value], { cwd });
+}
+export async function getPinnedBaseBranch(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    return await gitConfigGet(resolved.gitRoot, GIT_CONFIG_BASE_BRANCH_KEY);
+}
+export async function getBaseBranch(opts) {
+    const pinned = await getPinnedBaseBranch(opts);
+    return pinned ?? DEFAULT_BASE_BRANCH;
+}
+export async function setPinnedBaseBranch(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    const trimmed = opts.value.trim();
+    if (trimmed.length === 0)
+        throw new Error("base branch must be non-empty");
+    await gitConfigSet(resolved.gitRoot, GIT_CONFIG_BASE_BRANCH_KEY, trimmed);
+    return trimmed;
+}

package/dist/commit-policy.d.ts

@@ -0,0 +1,12 @@
+export type CommitPolicyResult = {
+    ok: boolean;
+    errors: string[];
+};
+export declare function extractTaskSuffix(taskId: string): string;
+export declare function isGenericSubject(subject: string, genericTokens: string[]): boolean;
+export declare function validateCommitSubject(opts: {
+    subject: string;
+    taskId: string;
+    genericTokens: string[];
+}): CommitPolicyResult;
+//# sourceMappingURL=commit-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"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/commit-policy.js

@@ -0,0 +1,31 @@
+function stripPunctuation(input) {
+    return input.replaceAll(/[^\p{L}\p{N}\s-]/gu, " ");
+}
+export function extractTaskSuffix(taskId) {
+    const parts = taskId.split("-");
+    return parts.at(-1) ?? "";
+}
+export function isGenericSubject(subject, genericTokens) {
+    const normalized = stripPunctuation(subject).toLowerCase().trim();
+    if (!normalized)
+        return true;
+    const words = normalized.split(/\s+/).filter(Boolean);
+    if (words.length === 0)
+        return true;
+    const tokenSet = new Set(genericTokens.map((t) => t.toLowerCase()));
+    return words.length <= 3 && words.every((w) => tokenSet.has(w));
+}
+export function validateCommitSubject(opts) {
+    const errors = [];
+    const subject = opts.subject.trim();
+    if (!subject)
+        errors.push("commit subject must be non-empty");
+    const suffix = extractTaskSuffix(opts.taskId);
+    if (!subject.includes(opts.taskId) && (suffix.length === 0 || !subject.includes(suffix))) {
+        errors.push("commit subject must include task id or suffix");
+    }
+    if (isGenericSubject(subject, opts.genericTokens)) {
+        errors.push("commit subject is too generic");
+    }
+    return { ok: errors.length === 0, errors };
+}

package/dist/config.d.ts

@@ -0,0 +1,74 @@
+export type WorkflowMode = "direct" | "branch_pr";
+export type StatusCommitPolicy = "off" | "warn" | "confirm";
+export type AgentplaneConfig = {
+    schema_version: 1;
+    workflow_mode: WorkflowMode;
+    status_commit_policy: StatusCommitPolicy;
+    finish_auto_status_commit: boolean;
+    base_branch: string;
+    agents?: {
+        approvals: {
+            require_plan: boolean;
+            require_network: boolean;
+        };
+    };
+    recipes?: {
+        storage_default: "link" | "copy" | "global";
+    };
+    paths: {
+        agents_dir: string;
+        tasks_path: string;
+        workflow_dir: string;
+        worktrees_dir: string;
+    };
+    branch: {
+        task_prefix: string;
+    };
+    framework: {
+        source: string;
+        last_update: string | null;
+    };
+    tasks: {
+        id_suffix_length_default: number;
+        verify: {
+            required_tags: string[];
+        };
+        doc: {
+            sections: string[];
+            required_sections: string[];
+        };
+        comments: {
+            start: {
+                prefix: string;
+                min_chars: number;
+            };
+            blocked: {
+                prefix: string;
+                min_chars: number;
+            };
+            verified: {
+                prefix: string;
+                min_chars: number;
+            };
+        };
+    };
+    commit: {
+        generic_tokens: string[];
+    };
+    tasks_backend: {
+        config_path: string;
+    };
+    closure_commit_requires_approval: boolean;
+};
+export declare function defaultConfig(): AgentplaneConfig;
+export declare function validateConfig(raw: unknown): AgentplaneConfig;
+export type LoadedConfig = {
+    path: string;
+    exists: boolean;
+    config: AgentplaneConfig;
+    raw: Record<string, unknown>;
+};
+export declare function loadConfig(agentplaneDir: string): Promise<LoadedConfig>;
+export declare function setByDottedKey(obj: Record<string, unknown>, dottedKey: string, value: string): void;
+export declare function saveConfig(agentplaneDir: string, raw: Record<string, unknown>): Promise<AgentplaneConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"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"}

package/dist/config.js

@@ -0,0 +1,237 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export function defaultConfig() {
+    return {
+        schema_version: 1,
+        workflow_mode: "direct",
+        status_commit_policy: "warn",
+        finish_auto_status_commit: true,
+        base_branch: "main",
+        agents: {
+            approvals: {
+                require_plan: true,
+                require_network: true,
+            },
+        },
+        recipes: {
+            storage_default: "link",
+        },
+        paths: {
+            agents_dir: ".agentplane/agents",
+            tasks_path: ".agentplane/tasks.json",
+            workflow_dir: ".agentplane/tasks",
+            worktrees_dir: ".agentplane/worktrees",
+        },
+        branch: { task_prefix: "task" },
+        framework: { source: "https://github.com/basilisk-labs/agent-plane", last_update: null },
+        tasks: {
+            id_suffix_length_default: 6,
+            verify: { required_tags: ["code", "backend", "frontend"] },
+            doc: {
+                sections: [
+                    "Summary",
+                    "Context",
+                    "Scope",
+                    "Risks",
+                    "Verify Steps",
+                    "Rollback Plan",
+                    "Notes",
+                ],
+                required_sections: ["Summary", "Scope", "Risks", "Verify Steps", "Rollback Plan"],
+            },
+            comments: {
+                start: { prefix: "Start:", min_chars: 40 },
+                blocked: { prefix: "Blocked:", min_chars: 40 },
+                verified: { prefix: "Verified:", min_chars: 60 },
+            },
+        },
+        commit: {
+            generic_tokens: ["start", "status", "mark", "done", "wip", "update", "tasks", "task"],
+        },
+        tasks_backend: { config_path: ".agentplane/backends/local/backend.json" },
+        closure_commit_requires_approval: false,
+    };
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+export function validateConfig(raw) {
+    if (!isRecord(raw))
+        throw new TypeError("config must be an object");
+    if (raw.schema_version !== 1)
+        throw new Error("config.schema_version must be 1");
+    if (raw.workflow_mode !== "direct" && raw.workflow_mode !== "branch_pr") {
+        throw new Error("config.workflow_mode must be 'direct' or 'branch_pr'");
+    }
+    if (raw.status_commit_policy !== "off" &&
+        raw.status_commit_policy !== "warn" &&
+        raw.status_commit_policy !== "confirm") {
+        throw new Error("config.status_commit_policy must be 'off' | 'warn' | 'confirm'");
+    }
+    if (typeof raw.finish_auto_status_commit !== "boolean")
+        throw new Error("config.finish_auto_status_commit must be boolean");
+    if (typeof raw.base_branch !== "string" || raw.base_branch.length === 0)
+        throw new Error("config.base_branch must be string");
+    if (raw.agents !== undefined) {
+        if (!isRecord(raw.agents))
+            throw new Error("config.agents must be object");
+        if (!isRecord(raw.agents.approvals))
+            throw new Error("config.agents.approvals must be object");
+        if (typeof raw.agents.approvals.require_plan !== "boolean") {
+            throw new Error("config.agents.approvals.require_plan must be boolean");
+        }
+        if (typeof raw.agents.approvals.require_network !== "boolean") {
+            throw new Error("config.agents.approvals.require_network must be boolean");
+        }
+    }
+    if (raw.recipes !== undefined) {
+        if (!isRecord(raw.recipes))
+            throw new Error("config.recipes must be object");
+        const storageDefault = raw.recipes.storage_default;
+        if (storageDefault !== "link" && storageDefault !== "copy" && storageDefault !== "global") {
+            throw new Error("config.recipes.storage_default must be 'link' | 'copy' | 'global'");
+        }
+    }
+    if (!isRecord(raw.paths))
+        throw new Error("config.paths must be object");
+    if (!isRecord(raw.branch))
+        throw new Error("config.branch must be object");
+    if (!isRecord(raw.framework))
+        throw new Error("config.framework must be object");
+    if (!isRecord(raw.tasks))
+        throw new Error("config.tasks must be object");
+    if (!isRecord(raw.commit))
+        throw new Error("config.commit must be object");
+    if (!isRecord(raw.tasks_backend))
+        throw new Error("config.tasks_backend must be object");
+    if (typeof raw.closure_commit_requires_approval !== "boolean") {
+        throw new Error("config.closure_commit_requires_approval must be boolean");
+    }
+    // Minimal path fields validation.
+    for (const key of ["agents_dir", "tasks_path", "workflow_dir", "worktrees_dir"]) {
+        const v = raw.paths[key];
+        if (typeof v !== "string" || v.length === 0)
+            throw new Error(`config.paths.${key} must be string`);
+    }
+    if (typeof raw.branch.task_prefix !== "string" || raw.branch.task_prefix.length === 0) {
+        throw new Error("config.branch.task_prefix must be string");
+    }
+    if (typeof raw.framework.source !== "string" || raw.framework.source.length === 0) {
+        throw new Error("config.framework.source must be string");
+    }
+    if (raw.framework.last_update !== null && typeof raw.framework.last_update !== "string") {
+        throw new Error("config.framework.last_update must be string or null");
+    }
+    if (!isRecord(raw.tasks.verify) || !Array.isArray(raw.tasks.verify.required_tags)) {
+        throw new Error("config.tasks.verify.required_tags must be array");
+    }
+    if (typeof raw.tasks.id_suffix_length_default !== "number" ||
+        !Number.isInteger(raw.tasks.id_suffix_length_default)) {
+        throw new Error("config.tasks.id_suffix_length_default must be integer");
+    }
+    if (!isRecord(raw.tasks.doc) ||
+        !Array.isArray(raw.tasks.doc.sections) ||
+        !Array.isArray(raw.tasks.doc.required_sections)) {
+        throw new Error("config.tasks.doc.sections and required_sections must be arrays");
+    }
+    if (!isRecord(raw.tasks.comments))
+        throw new Error("config.tasks.comments must be object");
+    for (const k of ["start", "blocked", "verified"]) {
+        const policy = raw.tasks.comments[k];
+        if (!isRecord(policy) ||
+            typeof policy.prefix !== "string" ||
+            typeof policy.min_chars !== "number") {
+            throw new Error(`config.tasks.comments.${k} must have prefix/min_chars`);
+        }
+    }
+    if (!Array.isArray(raw.commit.generic_tokens))
+        throw new Error("config.commit.generic_tokens must be array");
+    if (typeof raw.tasks_backend.config_path !== "string" ||
+        raw.tasks_backend.config_path.length === 0) {
+        throw new Error("config.tasks_backend.config_path must be string");
+    }
+    // At this point, raw satisfies the minimal contract; keep unknown fields by returning it as-is.
+    return raw;
+}
+function toErrnoException(err) {
+    if (!err || typeof err !== "object")
+        return null;
+    if (!("code" in err))
+        return null;
+    return err;
+}
+export async function loadConfig(agentplaneDir) {
+    const filePath = path.join(agentplaneDir, "config.json");
+    try {
+        const rawText = await readFile(filePath, "utf8");
+        const parsed = JSON.parse(rawText);
+        const validated = validateConfig(parsed);
+        return {
+            path: filePath,
+            exists: true,
+            config: validated,
+            raw: parsed,
+        };
+    }
+    catch (err) {
+        const errno = toErrnoException(err);
+        if (errno?.code === "ENOENT") {
+            const def = defaultConfig();
+            return {
+                path: filePath,
+                exists: false,
+                config: def,
+                raw: def,
+            };
+        }
+        throw err;
+    }
+}
+function parseScalar(value) {
+    const trimmed = value.trim();
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (trimmed === "null")
+        return null;
+    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return value;
+        }
+    }
+    if (/^-?\d+(?:\.\d+)?$/.test(trimmed))
+        return Number(trimmed);
+    return value;
+}
+export function setByDottedKey(obj, dottedKey, value) {
+    const parts = dottedKey.split(".").filter(Boolean);
+    if (parts.length === 0)
+        throw new Error("config key must be non-empty");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!part)
+            continue;
+        const next = current[part];
+        if (!isRecord(next)) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    const last = parts.at(-1);
+    if (!last)
+        throw new Error("config key must be non-empty");
+    current[last] = parseScalar(value);
+}
+export async function saveConfig(agentplaneDir, raw) {
+    const validated = validateConfig(raw);
+    await mkdir(agentplaneDir, { recursive: true });
+    const filePath = path.join(agentplaneDir, "config.json");
+    const text = `${JSON.stringify(raw, null, 2)}\n`;
+    await writeFile(filePath, text, "utf8");
+    return validated;
+}

package/dist/git-utils.d.ts

@@ -0,0 +1,9 @@
+export declare function getStagedFiles(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<string[]>;
+export declare function getUnstagedFiles(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<string[]>;
+//# sourceMappingURL=git-utils.d.ts.map

package/dist/git-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../src/git-utils.ts"],"names":[],"mappings":"AAeA,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGpB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcpB"}

package/dist/git-utils.js

@@ -0,0 +1,31 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { resolveProject } from "./project-root.js";
+const execFileAsync = promisify(execFile);
+async function gitLines(cwd, args) {
+    const { stdout } = await execFileAsync("git", args, { cwd });
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+export async function getStagedFiles(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    return await gitLines(resolved.gitRoot, ["diff", "--name-only", "--cached"]);
+}
+export async function getUnstagedFiles(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    const lines = await gitLines(resolved.gitRoot, ["status", "--porcelain"]);
+    const files = [];
+    for (const line of lines) {
+        const status = line.slice(0, 2);
+        const filePart = line.slice(3).trim();
+        if (!filePart)
+            continue;
+        const name = filePart.includes("->") ? filePart.split("->").at(-1)?.trim() : filePart;
+        if ((status === "??" || status[1] !== " ") && name) {
+            files.push(name);
+        }
+    }
+    return files;
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export declare const CORE_VERSION = "0.0.0";
+export { findGitRoot, resolveProject, type ResolvedProject, type ResolveProjectOptions, } from "./project-root.js";
+export { defaultConfig, loadConfig, saveConfig, setByDottedKey, validateConfig, type AgentplaneConfig, type LoadedConfig, type StatusCommitPolicy, type WorkflowMode, } from "./config.js";
+export { parseTaskReadme, renderTaskFrontmatter, renderTaskReadme, type ParsedTaskReadme, } from "./task-readme.js";
+export { createTask, getTasksDir, listTasks, readTask, setTaskDocSection, taskReadmePath, validateTaskDocMetadata, type TaskFrontmatter, type TaskPriority, type TaskRecord, type TaskStatus, } from "./task-store.js";
+export { buildTasksExportSnapshot, canonicalTasksPayload, canonicalizeJson, computeTasksChecksum, writeTasksExport, type TasksExportMeta, type TasksExportSnapshot, type TasksExportTask, } from "./tasks-export.js";
+export { lintTasksFile, lintTasksSnapshot, readTasksExport, type TasksLintResult, } from "./tasks-lint.js";
+export { getBaseBranch, getPinnedBaseBranch, setPinnedBaseBranch } from "./base-branch.js";
+export { extractTaskSuffix, isGenericSubject, validateCommitSubject, type CommitPolicyResult, } from "./commit-policy.js";
+export { getStagedFiles, getUnstagedFiles } from "./git-utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,OAAO,EACL,WAAW,EACX,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE3F,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export const CORE_VERSION = "0.0.0";
+export { findGitRoot, resolveProject, } from "./project-root.js";
+export { defaultConfig, loadConfig, saveConfig, setByDottedKey, validateConfig, } from "./config.js";
+export { parseTaskReadme, renderTaskFrontmatter, renderTaskReadme, } from "./task-readme.js";
+export { createTask, getTasksDir, listTasks, readTask, setTaskDocSection, taskReadmePath, validateTaskDocMetadata, } from "./task-store.js";
+export { buildTasksExportSnapshot, canonicalTasksPayload, canonicalizeJson, computeTasksChecksum, writeTasksExport, } from "./tasks-export.js";
+export { lintTasksFile, lintTasksSnapshot, readTasksExport, } from "./tasks-lint.js";
+export { getBaseBranch, getPinnedBaseBranch, setPinnedBaseBranch } from "./base-branch.js";
+export { extractTaskSuffix, isGenericSubject, validateCommitSubject, } from "./commit-policy.js";
+export { getStagedFiles, getUnstagedFiles } from "./git-utils.js";

package/dist/project-root.d.ts

@@ -0,0 +1,11 @@
+export declare function findGitRoot(startDir: string): Promise<string | null>;
+export type ResolveProjectOptions = {
+    cwd: string;
+    rootOverride?: string | null;
+};
+export type ResolvedProject = {
+    gitRoot: string;
+    agentplaneDir: string;
+};
+export declare function resolveProject(opts: ResolveProjectOptions): Promise<ResolvedProject>;
+//# sourceMappingURL=project-root.d.ts.map

package/dist/project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.d.ts","sourceRoot":"","sources":["../src/project-root.ts"],"names":[],"mappings":"AAiBA,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU1E;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAU1F"}

package/dist/project-root.js

@@ -0,0 +1,38 @@
+import { access } from "node:fs/promises";
+import path from "node:path";
+async function exists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isGitRoot(dir) {
+    const dotGit = path.join(dir, ".git");
+    return exists(dotGit);
+}
+export async function findGitRoot(startDir) {
+    let current = path.resolve(startDir);
+    // Walk upwards until filesystem root.
+    while (true) {
+        if (await isGitRoot(current))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+export async function resolveProject(opts) {
+    const start = opts.rootOverride ? path.resolve(opts.rootOverride) : path.resolve(opts.cwd);
+    const gitRoot = await findGitRoot(start);
+    if (!gitRoot) {
+        throw new Error(`Not a git repository (start: ${start})`);
+    }
+    return {
+        gitRoot,
+        agentplaneDir: path.join(gitRoot, ".agentplane"),
+    };
+}

package/dist/task-readme.d.ts

@@ -0,0 +1,8 @@
+export type ParsedTaskReadme = {
+    frontmatter: Record<string, unknown>;
+    body: string;
+};
+export declare function parseTaskReadme(markdown: string): ParsedTaskReadme;
+export declare function renderTaskFrontmatter(frontmatter: Record<string, unknown>): string;
+export declare function renderTaskReadme(frontmatter: Record<string, unknown>, body: string): string;
+//# sourceMappingURL=task-readme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-readme.d.ts","sourceRoot":"","sources":["../src/task-readme.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAQF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAYlE;AAiED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA8BlF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3F"}