agentplane 0.3.15 → 0.3.17

package/dist/commands/task/finish-plan.js

@@ -0,0 +1,157 @@
+import { CliError } from "../../shared/errors.js";
+import { backendUsesLocalTaskStore } from "../shared/task-backend.js";
+import { getTaskStore } from "../shared/task-store.js";
+import { requireStructuredComment } from "./shared.js";
+export function resolveFinishExecutionPlan(opts) {
+    const { ctx, options } = opts;
+    const { prefix, min_chars: minChars } = ctx.config.tasks.comments.verified;
+    requireStructuredComment(options.body, prefix, minChars);
+    const statusCommitRequested = options.statusCommit;
+    if ((options.commitFromComment || statusCommitRequested) && options.taskIds.length !== 1) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--commit-from-comment/--status-commit requires exactly one task id",
+        });
+    }
+    if (options.commitFromComment && statusCommitRequested) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--commit-from-comment cannot be combined with --status-commit in finish; use one deterministic commit path.",
+        });
+    }
+    if ((options.closeCommit || options.noCloseCommit) && options.taskIds.length !== 1) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--close-commit/--no-close-commit requires exactly one task id",
+        });
+    }
+    if (options.closeCommit && options.noCloseCommit) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--close-commit and --no-close-commit are mutually exclusive",
+        });
+    }
+    if ((options.closeCommit || options.noCloseCommit) &&
+        (options.commitFromComment || options.statusCommit)) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--close-commit/--no-close-commit cannot be combined with --commit-from-comment/--status-commit",
+        });
+    }
+    const primaryTaskId = options.taskIds[0] ?? "";
+    if ((options.commitFromComment || statusCommitRequested) && !primaryTaskId) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--commit-from-comment/--status-commit requires exactly one task id",
+        });
+    }
+    if (options.commitAutoAllow) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--commit-auto-allow is disabled; pass explicit --commit-allow <path-prefix>.",
+        });
+    }
+    if (options.statusCommitAutoAllow) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--status-commit-auto-allow is disabled; pass explicit --status-commit-allow <path-prefix>.",
+        });
+    }
+    if (options.commitFromComment && options.commitAllow.length === 0) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--commit-from-comment requires --commit-allow <path-prefix>",
+        });
+    }
+    if (statusCommitRequested && options.statusCommitAllow.length === 0) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--status-commit requires --status-commit-allow <path-prefix>",
+        });
+    }
+    const useStore = backendUsesLocalTaskStore(ctx);
+    const store = useStore ? getTaskStore(ctx) : null;
+    const backendWritesTaskReadmes = ctx.taskBackend.capabilities.writes_task_readmes === true;
+    const defaultDirectCloseCommit = ctx.config.workflow_mode === "direct" &&
+        backendWritesTaskReadmes &&
+        options.taskIds.length === 1 &&
+        !options.commitFromComment &&
+        !statusCommitRequested;
+    const defaultBranchPrCloseCommit = ctx.config.workflow_mode === "branch_pr" &&
+        backendWritesTaskReadmes &&
+        options.taskIds.length === 1 &&
+        !options.commitFromComment &&
+        !statusCommitRequested;
+    const statusPathRequiresTrackedTaskCommit = backendWritesTaskReadmes &&
+        options.taskIds.length === 1 &&
+        (options.commitFromComment || statusCommitRequested);
+    const shouldCloseCommit = options.closeCommit === true ||
+        statusPathRequiresTrackedTaskCommit ||
+        (defaultDirectCloseCommit && options.noCloseCommit !== true) ||
+        (defaultBranchPrCloseCommit && options.noCloseCommit !== true);
+    const metaTaskId = options.taskIds.length === 1 ? (options.taskIds[0] ?? "") : "";
+    const wantMeta = typeof options.result === "string" ||
+        typeof options.risk === "string" ||
+        options.breaking === true;
+    const resultProvided = typeof options.result === "string";
+    if (wantMeta && options.taskIds.length !== 1) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--result/--risk/--breaking requires exactly one task id",
+        });
+    }
+    const resultSummary = typeof options.result === "string" ? options.result.trim() : "";
+    const riskLevel = options.risk;
+    const breaking = options.breaking === true;
+    const finishFinding = resolveFinishFinding(options);
+    if (finishFinding && options.taskIds.length !== 1) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--observation/--impact/--resolution and incident finding options require exactly one task id",
+        });
+    }
+    return {
+        useStore,
+        store,
+        statusCommitRequested,
+        primaryTaskId,
+        metaTaskId,
+        resultProvided,
+        resultSummary,
+        riskLevel,
+        breaking,
+        finishFinding,
+        shouldCloseCommit,
+    };
+}
+function resolveFinishFinding(options) {
+    if (typeof options.observation !== "string" ||
+        typeof options.impact !== "string" ||
+        typeof options.resolution !== "string") {
+        return null;
+    }
+    return {
+        observation: options.observation,
+        impact: options.impact,
+        resolution: options.resolution,
+        localOnly: options.localOnly === true,
+        repoFixable: options.repoFixable === true,
+        incidentScope: options.incidentScope,
+        incidentTags: options.incidentTags ?? [],
+        incidentMatch: options.incidentMatch ?? [],
+        incidentAdvice: options.incidentAdvice,
+        incidentRule: options.incidentRule,
+    };
+}

package/dist/commands/task/finish-types.d.ts

@@ -0,0 +1,69 @@
+import type { CommandContext } from "../shared/task-backend.js";
+import type { TaskStore } from "../shared/task-store.js";
+export type FinishOptions = {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskIds: string[];
+    author: string;
+    body: string;
+    result?: string;
+    risk?: "low" | "med" | "high";
+    breaking: boolean;
+    commit?: string;
+    force: boolean;
+    yes?: boolean;
+    commitFromComment: boolean;
+    commitEmoji?: string;
+    commitAllow: string[];
+    commitAutoAllow: boolean;
+    commitAllowTasks: boolean;
+    commitRequireClean: boolean;
+    statusCommit: boolean;
+    statusCommitEmoji?: string;
+    statusCommitAllow: string[];
+    statusCommitAutoAllow: boolean;
+    statusCommitRequireClean: boolean;
+    confirmStatusCommit: boolean;
+    closeCommit?: boolean;
+    noCloseCommit?: boolean;
+    closeUnstageOthers?: boolean;
+    baseBranchOverride?: string;
+    observation?: string;
+    impact?: string;
+    resolution?: string;
+    localOnly?: boolean;
+    repoFixable?: boolean;
+    incidentScope?: string;
+    incidentTags?: string[];
+    incidentMatch?: string[];
+    incidentAdvice?: string;
+    incidentRule?: string;
+    quiet: boolean;
+};
+export type FinishStructuredFinding = {
+    observation: string;
+    impact: string;
+    resolution: string;
+    localOnly: boolean;
+    repoFixable: boolean;
+    incidentScope?: string;
+    incidentTags: string[];
+    incidentMatch: string[];
+    incidentAdvice?: string;
+    incidentRule?: string;
+};
+export type FinishExecutionPlan = {
+    useStore: boolean;
+    store: TaskStore | null;
+    statusCommitRequested: boolean;
+    primaryTaskId: string;
+    metaTaskId: string;
+    resultProvided: boolean;
+    resultSummary: string;
+    riskLevel?: "low" | "med" | "high";
+    breaking: boolean;
+    finishFinding: FinishStructuredFinding | null;
+    shouldCloseCommit: boolean;
+};
+//# sourceMappingURL=finish-types.d.ts.map

package/dist/commands/task/finish-types.d.ts.map

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

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

@@ -1,43 +1,2 @@
-import { type CommandContext } from "../shared/task-backend.js";
-export declare function cmdFinish(opts: {
-    ctx?: CommandContext;
-    cwd: string;
-    rootOverride?: string;
-    taskIds: string[];
-    author: string;
-    body: string;
-    result?: string;
-    risk?: "low" | "med" | "high";
-    breaking: boolean;
-    commit?: string;
-    force: boolean;
-    yes?: boolean;
-    commitFromComment: boolean;
-    commitEmoji?: string;
-    commitAllow: string[];
-    commitAutoAllow: boolean;
-    commitAllowTasks: boolean;
-    commitRequireClean: boolean;
-    statusCommit: boolean;
-    statusCommitEmoji?: string;
-    statusCommitAllow: string[];
-    statusCommitAutoAllow: boolean;
-    statusCommitRequireClean: boolean;
-    confirmStatusCommit: boolean;
-    closeCommit?: boolean;
-    noCloseCommit?: boolean;
-    closeUnstageOthers?: boolean;
-    baseBranchOverride?: string;
-    observation?: string;
-    impact?: string;
-    resolution?: string;
-    localOnly?: boolean;
-    repoFixable?: boolean;
-    incidentScope?: string;
-    incidentTags?: string[];
-    incidentMatch?: string[];
-    incidentAdvice?: string;
-    incidentRule?: string;
-    quiet: boolean;
-}): Promise<number>;
+export { cmdFinish } from "./finish-command.js";
 //# sourceMappingURL=finish.d.ts.map

package/dist/commands/task/finish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAuMnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsalB"}
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}