agentplane 0.3.5 → 0.3.7

package/dist/commands/task/shared/transitions.d.ts

@@ -1,6 +1,5 @@
 import type { AgentplaneConfig } from "@agentplaneorg/core";
 import type { TaskData, TaskEvent } from "../../../backends/task-backend.js";
-import type { CommandContext } from "../../shared/task-backend.js";
 export declare function appendTaskEvent(task: TaskData, event: TaskEvent): TaskEvent[];
 export declare function ensurePlanApprovedIfRequired(task: TaskData, config: AgentplaneConfig): void;
 export declare function ensureVerificationSatisfiedIfRequired(task: TaskData, config: AgentplaneConfig): void;
@@ -19,6 +18,15 @@ export declare function ensureCommentCommitAllowed(opts: {
     statusFrom: string;
     statusTo: string;
 }): void;
+export declare function resolveCommentCommitWarning(opts: {
+    enabled: boolean;
+    config: AgentplaneConfig;
+    action: string;
+    confirmed: boolean;
+    quiet: boolean;
+    statusFrom: string;
+    statusTo: string;
+}): string | null;
 export declare function requireStructuredComment(body: string, prefix: string, minChars: number): void;
 export declare function readHeadCommit(cwd: string): Promise<{
     hash: string;
@@ -32,11 +40,18 @@ export declare function enforceStatusCommitPolicy(opts: {
     statusFrom: string;
     statusTo: string;
 }): void;
+export declare function resolveStatusCommitPolicyWarning(opts: {
+    policy: AgentplaneConfig["status_commit_policy"];
+    action: string;
+    confirmed: boolean;
+    quiet: boolean;
+    statusFrom: string;
+    statusTo: string;
+}): string | null;
 export declare function isMajorStatusCommitTransition(statusFrom: string, statusTo: string): boolean;
 export declare function readCommitInfo(cwd: string, rev: string): Promise<{
     hash: string;
     message: string;
 }>;
 export declare function defaultCommitEmojiForStatus(status: string): string;
-export declare function defaultCommitEmojiForAgentId(ctx: CommandContext, agentId: string): Promise<string>;
 //# sourceMappingURL=transitions.d.ts.map

package/dist/commands/task/shared/transitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/transitions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,CAW7E;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAc3F;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAkBN;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO1E;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAUP;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAmBP;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgB7F;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CA8BP;AAUD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3F;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/shared/transitions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAK7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,CAW7E;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAc3F;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAkBN;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO1E;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAUP;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAKP;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,GAAG,IAAI,CAmBhB;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgB7F;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAKP;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,GAAG,IAAI,CA2BhB;AAUD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3F;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlE"}

package/dist/commands/task/shared/transitions.js

@@ -1,8 +1,6 @@
 import { execFile } from "node:child_process";
-import path from "node:path";
 import { promisify } from "node:util";
 import { warnMessage } from "../../../cli/output.js";
-import { resolveCommitEmojiForAgent } from "../../../shared/agent-emoji.js";
 import { CliError } from "../../../shared/errors.js";
 import { parseGitLogHashSubject } from "../../../shared/git-log.js";
 import { requiresVerificationByPrimary, toStringArray } from "./tags.js";
@@ -73,8 +71,14 @@ export function ensureStatusTransitionAllowed(opts) {
     });
 }
 export function ensureCommentCommitAllowed(opts) {
+    const warning = resolveCommentCommitWarning(opts);
+    if (warning) {
+        process.stderr.write(`${warnMessage(warning)}\n`);
+    }
+}
+export function resolveCommentCommitWarning(opts) {
     if (!opts.enabled)
-        return;
+        return null;
     if (opts.config.commit_automation === "finish_only") {
         throw new CliError({
             exitCode: 2,
@@ -83,7 +87,7 @@ export function ensureCommentCommitAllowed(opts) {
                 "(allowed only in finish).",
         });
     }
-    enforceStatusCommitPolicy({
+    return resolveStatusCommitPolicyWarning({
         policy: opts.config.status_commit_policy,
         action: opts.action,
         confirmed: opts.confirmed,
@@ -115,6 +119,12 @@ export async function readHeadCommit(cwd) {
     return { hash, message: subject };
 }
 export function enforceStatusCommitPolicy(opts) {
+    const warning = resolveStatusCommitPolicyWarning(opts);
+    if (warning) {
+        process.stderr.write(`${warnMessage(warning)}\n`);
+    }
+}
+export function resolveStatusCommitPolicyWarning(opts) {
     if (!isMajorStatusCommitTransition(opts.statusFrom, opts.statusTo)) {
         throw new CliError({
             exitCode: 2,
@@ -124,12 +134,12 @@ export function enforceStatusCommitPolicy(opts) {
         });
     }
     if (opts.policy === "off")
-        return;
+        return null;
     if (opts.policy === "warn") {
-        if (!opts.quiet && !opts.confirmed) {
-            process.stderr.write(`${warnMessage(`${opts.action}: status/comment-driven commit requested; policy=warn (pass --confirm-status-commit to acknowledge)`)}\n`);
-        }
-        return;
+        return opts.quiet || opts.confirmed
+            ? null
+            : `${opts.action}: status/comment-driven commit requested; policy=warn ` +
+                "(pass --confirm-status-commit to acknowledge)";
     }
     if (opts.policy === "confirm" && !opts.confirmed) {
         throw new CliError({
@@ -139,6 +149,7 @@ export function enforceStatusCommitPolicy(opts) {
                 "(pass --confirm-status-commit to proceed)",
         });
     }
+    return null;
 }
 const MAJOR_STATUS_COMMIT_TRANSITIONS = new Set([
     "READY->DOING",
@@ -169,7 +180,3 @@ export function defaultCommitEmojiForStatus(status) {
         return "⛔";
     return "🧩";
 }
-export async function defaultCommitEmojiForAgentId(ctx, agentId) {
-    const agentsDir = path.join(ctx.resolvedProject.gitRoot, ctx.config.paths.agents_dir);
-    return await resolveCommitEmojiForAgent({ agentsDirAbs: agentsDir, agentId });
-}

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

@@ -1,7 +1,7 @@
 export { dedupeStrings } from "../../shared/strings.js";
-export { nowIso, normalizeTaskDocVersion, taskObservationSectionName, extractTaskObservationSection, VERIFY_STEPS_PLACEHOLDER, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, extractDocSection, isVerifyStepsFilled, isDocSectionFilled, ensureAgentFilledRequiredDocSections, normalizeVerificationSectionLayout, } from "./shared/docs.js";
+export { decodeEscapedTaskTextNewlines, nowIso, normalizeTaskDocVersion, taskObservationSectionName, extractTaskObservationSection, VERIFY_STEPS_PLACEHOLDER, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, extractDocSection, isVerifyStepsFilled, isDocSectionFilled, ensureAgentFilledRequiredDocSections, normalizeVerificationSectionLayout, } from "./shared/docs.js";
 export { normalizeDependsOnInput, normalizeTaskStatus, toStringArray, requiresVerify, type PrimaryTagResolution, type TaskTagPolicy, readTaskTagPolicy, resolvePrimaryTagFromConfig, requiresVerifyStepsByPrimary, requiresVerificationByPrimary, resolvePrimaryTag, warnIfUnknownOwner, } from "./shared/tags.js";
-export { type DependencyState, ensureTaskDependsOnGraphIsAcyclic, resolveTaskDependencyState, buildDependencyState, formatTaskLine, } from "./shared/dependencies.js";
-export { appendTaskEvent, ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, isTransitionAllowed, ensureStatusTransitionAllowed, ensureCommentCommitAllowed, requireStructuredComment, enforceStatusCommitPolicy, isMajorStatusCommitTransition, readHeadCommit, readCommitInfo, defaultCommitEmojiForStatus, defaultCommitEmojiForAgentId, } from "./shared/transitions.js";
+export { type DependencyState, dependencyWarningMessages, ensureTaskDependsOnGraphIsAcyclic, resolveTaskDependencyState, buildDependencyState, formatTaskLine, } from "./shared/dependencies.js";
+export { appendTaskEvent, ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, isTransitionAllowed, ensureStatusTransitionAllowed, ensureCommentCommitAllowed, resolveCommentCommitWarning, requireStructuredComment, enforceStatusCommitPolicy, resolveStatusCommitPolicyWarning, isMajorStatusCommitTransition, readHeadCommit, readCommitInfo, defaultCommitEmojiForStatus, } from "./shared/transitions.js";
 export { type TaskListFilters, parseTaskListFilters, handleTaskListWarnings, taskTextBlob, } from "./shared/listing.js";
 //# sourceMappingURL=shared.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,MAAM,EACN,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,eAAe,EACpB,iCAAiC,EACjC,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,qCAAqC,EACrC,mBAAmB,EACnB,6BAA6B,EAC7B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,cAAc,EACd,cAAc,EACd,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,eAAe,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,6BAA6B,EAC7B,MAAM,EACN,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,eAAe,EACpB,yBAAyB,EACzB,iCAAiC,EACjC,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,qCAAqC,EACrC,mBAAmB,EACnB,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,gCAAgC,EAChC,6BAA6B,EAC7B,cAAc,EACd,cAAc,EACd,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,eAAe,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/dist/commands/task/shared.js

@@ -1,6 +1,6 @@
 export { dedupeStrings } from "../../shared/strings.js";
-export { nowIso, normalizeTaskDocVersion, taskObservationSectionName, extractTaskObservationSection, VERIFY_STEPS_PLACEHOLDER, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, extractDocSection, isVerifyStepsFilled, isDocSectionFilled, ensureAgentFilledRequiredDocSections, normalizeVerificationSectionLayout, } from "./shared/docs.js";
+export { decodeEscapedTaskTextNewlines, nowIso, normalizeTaskDocVersion, taskObservationSectionName, extractTaskObservationSection, VERIFY_STEPS_PLACEHOLDER, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, extractDocSection, isVerifyStepsFilled, isDocSectionFilled, ensureAgentFilledRequiredDocSections, normalizeVerificationSectionLayout, } from "./shared/docs.js";
 export { normalizeDependsOnInput, normalizeTaskStatus, toStringArray, requiresVerify, readTaskTagPolicy, resolvePrimaryTagFromConfig, requiresVerifyStepsByPrimary, requiresVerificationByPrimary, resolvePrimaryTag, warnIfUnknownOwner, } from "./shared/tags.js";
-export { ensureTaskDependsOnGraphIsAcyclic, resolveTaskDependencyState, buildDependencyState, formatTaskLine, } from "./shared/dependencies.js";
-export { appendTaskEvent, ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, isTransitionAllowed, ensureStatusTransitionAllowed, ensureCommentCommitAllowed, requireStructuredComment, enforceStatusCommitPolicy, isMajorStatusCommitTransition, readHeadCommit, readCommitInfo, defaultCommitEmojiForStatus, defaultCommitEmojiForAgentId, } from "./shared/transitions.js";
+export { dependencyWarningMessages, ensureTaskDependsOnGraphIsAcyclic, resolveTaskDependencyState, buildDependencyState, formatTaskLine, } from "./shared/dependencies.js";
+export { appendTaskEvent, ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, isTransitionAllowed, ensureStatusTransitionAllowed, ensureCommentCommitAllowed, resolveCommentCommitWarning, requireStructuredComment, enforceStatusCommitPolicy, resolveStatusCommitPolicyWarning, isMajorStatusCommitTransition, readHeadCommit, readCommitInfo, defaultCommitEmojiForStatus, } from "./shared/transitions.js";
 export { parseTaskListFilters, handleTaskListWarnings, taskTextBlob, } from "./shared/listing.js";

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

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAwBnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,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,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiMlB"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAyEnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,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,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkLlB"}

package/dist/commands/task/start.js

@@ -1,13 +1,49 @@
 import { mapBackendError } from "../../cli/error-map.js";
-import { invalidValueMessage, successMessage, warnMessage } from "../../cli/output.js";
+import { infoMessage, successMessage, warnMessage } from "../../cli/output.js";
 import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { commitFromComment } from "../guard/index.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
 import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
-import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
+import { appendTaskCommentIntent, appendTaskEventIntent, backendIsLocalFileBackend, getTaskStore, mutateTaskStore, setTaskFieldsIntent, touchTaskDocMetaIntent, } from "../shared/task-store.js";
 import { readDirectWorkLock } from "../../shared/direct-work-lock.js";
-import { appendTaskEvent, ensurePlanApprovedIfRequired, ensureCommentCommitAllowed, ensureStatusTransitionAllowed, extractTaskObservationSection, defaultCommitEmojiForAgentId, extractDocSection, isVerifyStepsFilled, normalizeTaskDocVersion, nowIso, requiresVerifyStepsByPrimary, requireStructuredComment, resolveTaskDependencyState, resolvePrimaryTag, taskObservationSectionName, toStringArray, } from "./shared.js";
+import { appendTaskEvent, ensurePlanApprovedIfRequired, ensureCommentCommitAllowed, ensureStatusTransitionAllowed, extractTaskObservationSection, defaultCommitEmojiForStatus, extractDocSection, isVerifyStepsFilled, normalizeTaskDocVersion, nowIso, requiresVerifyStepsByPrimary, requireStructuredComment, resolveTaskDependencyState, resolvePrimaryTag, taskObservationSectionName, toStringArray, } from "./shared.js";
+function assertStartDocRequirements(task, config) {
+    if (config.agents?.approvals?.require_plan === true)
+        return;
+    const enforce = config.tasks.verify.enforce_on_start_when_no_plan !== false;
+    if (!enforce)
+        return;
+    const tags = toStringArray(task.tags);
+    const spikeTag = (config.tasks.verify.spike_tag ?? "spike").trim().toLowerCase();
+    const verifyRequired = requiresVerifyStepsByPrimary(tags, config);
+    const isSpike = tags.some((tag) => tag.trim().toLowerCase() === spikeTag);
+    const doc = typeof task.doc === "string" ? task.doc : "";
+    if (verifyRequired || isSpike) {
+        const verifySteps = extractDocSection(doc, "Verify Steps");
+        if (!isVerifyStepsFilled(verifySteps)) {
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: `${task.id}: cannot start work: ## Verify Steps section is missing/empty/unfilled ` +
+                    "(fill it before starting work when plan approval is disabled)",
+            });
+        }
+    }
+    if (!isSpike)
+        return;
+    const docVersion = normalizeTaskDocVersion(task.doc_version);
+    const observationSection = taskObservationSectionName(docVersion);
+    const observation = extractTaskObservationSection(doc, docVersion);
+    if (!observation || observation.trim().length === 0) {
+        throw new CliError({
+            exitCode: 3,
+            code: "E_VALIDATION",
+            message: `${task.id}: cannot start spike: ## ${observationSection} section is missing or empty ` +
+                "(include Findings/Decision/Next Steps)",
+        });
+    }
+}
 export async function cmdStart(opts) {
     try {
         const ctx = opts.ctx ??
@@ -27,47 +63,18 @@ export async function cmdStart(opts) {
         const task = useStore
             ? await store.get(opts.taskId)
             : await loadTaskFromContext({ ctx, taskId: opts.taskId });
-        if (ctx.config.agents?.approvals?.require_plan !== true) {
-            const enforce = ctx.config.tasks.verify.enforce_on_start_when_no_plan !== false;
-            if (enforce) {
-                const tags = toStringArray(task.tags);
-                const spikeTag = (ctx.config.tasks.verify.spike_tag ?? "spike").trim().toLowerCase();
-                const verifyRequired = requiresVerifyStepsByPrimary(tags, ctx.config);
-                const isSpike = tags.some((tag) => tag.trim().toLowerCase() === spikeTag);
-                const doc = typeof task.doc === "string" ? task.doc : "";
-                if (verifyRequired || isSpike) {
-                    const verifySteps = extractDocSection(doc, "Verify Steps");
-                    if (!isVerifyStepsFilled(verifySteps)) {
-                        throw new CliError({
-                            exitCode: 3,
-                            code: "E_VALIDATION",
-                            message: `${task.id}: cannot start work: ## Verify Steps section is missing/empty/unfilled ` +
-                                "(fill it before starting work when plan approval is disabled)",
-                        });
-                    }
-                }
-                if (isSpike) {
-                    const docVersion = normalizeTaskDocVersion(task.doc_version);
-                    const observationSection = taskObservationSectionName(docVersion);
-                    const observation = extractTaskObservationSection(doc, docVersion);
-                    if (!observation || observation.trim().length === 0) {
-                        throw new CliError({
-                            exitCode: 3,
-                            code: "E_VALIDATION",
-                            message: `${task.id}: cannot start spike: ## ${observationSection} section is missing or empty ` +
-                                "(include Findings/Decision/Next Steps)",
-                        });
-                    }
-                }
-            }
+        if (!useStore) {
+            assertStartDocRequirements(task, ctx.config);
+            ensurePlanApprovedIfRequired(task, ctx.config);
         }
-        ensurePlanApprovedIfRequired(task, ctx.config);
         const currentStatus = String(task.status || "TODO").toUpperCase();
-        ensureStatusTransitionAllowed({
-            currentStatus,
-            nextStatus: "DOING",
-            force: opts.force,
-        });
+        if (!useStore) {
+            ensureStatusTransitionAllowed({
+                currentStatus,
+                nextStatus: "DOING",
+                force: opts.force,
+            });
+        }
         ensureCommentCommitAllowed({
             enabled: opts.commitFromComment,
             config: ctx.config,
@@ -107,27 +114,58 @@ export async function cmdStart(opts) {
             { author: opts.author, body: commentBody },
         ];
         const at = nowIso();
-        const nextTask = {
-            ...task,
-            status: "DOING",
-            comments: commentsValue,
-            events: appendTaskEvent(task, {
-                type: "status",
-                at,
-                author: opts.author,
-                from: currentStatus,
-                to: "DOING",
-                note: commentBody,
-            }),
-            doc_version: normalizeTaskDocVersion(task.doc_version),
-            doc_updated_at: at,
-            doc_updated_by: opts.author,
-        };
+        let currentStatusForCommit = currentStatus;
+        let primaryTagForCommit = resolvePrimaryTag(toStringArray(task.tags), ctx).primary;
         await (useStore
-            ? store.update(opts.taskId, () => nextTask)
-            : ctx.taskBackend.writeTask(nextTask));
+            ? mutateTaskStore(store, opts.taskId, (current) => {
+                assertStartDocRequirements(current, ctx.config);
+                ensurePlanApprovedIfRequired(current, ctx.config);
+                const currentStatus = String(current.status || "TODO").toUpperCase();
+                currentStatusForCommit = currentStatus;
+                primaryTagForCommit = resolvePrimaryTag(toStringArray(current.tags), ctx).primary;
+                ensureStatusTransitionAllowed({
+                    currentStatus,
+                    nextStatus: "DOING",
+                    force: opts.force,
+                });
+                return [
+                    setTaskFieldsIntent({ status: "DOING" }),
+                    appendTaskCommentIntent({ author: opts.author, body: commentBody }),
+                    appendTaskEventIntent({
+                        type: "status",
+                        at,
+                        author: opts.author,
+                        from: currentStatus,
+                        to: "DOING",
+                        note: commentBody,
+                    }),
+                    touchTaskDocMetaIntent({
+                        updatedBy: opts.author,
+                        version: normalizeTaskDocVersion(current.doc_version),
+                    }),
+                ];
+            })
+            : ctx.taskBackend.writeTask({
+                ...task,
+                status: "DOING",
+                comments: commentsValue,
+                events: appendTaskEvent(task, {
+                    type: "status",
+                    at,
+                    author: opts.author,
+                    from: currentStatus,
+                    to: "DOING",
+                    note: commentBody,
+                }),
+                doc_version: normalizeTaskDocVersion(task.doc_version),
+                doc_updated_at: at,
+                doc_updated_by: opts.author,
+            }));
         let commitInfo = null;
         if (opts.commitFromComment) {
+            if (!opts.quiet) {
+                process.stdout.write(`${infoMessage("task marked DOING; creating commit from start comment")}\n`);
+            }
             const mode = ctx.config.workflow_mode;
             let executorAgent = opts.author;
             if (mode === "direct") {
@@ -136,27 +174,19 @@ export async function cmdStart(opts) {
                 if (lockAgent)
                     executorAgent = lockAgent;
             }
-            const expectedEmoji = await defaultCommitEmojiForAgentId(ctx, executorAgent);
-            if (typeof opts.commitEmoji === "string" && opts.commitEmoji.trim() !== expectedEmoji) {
-                throw new CliError({
-                    exitCode: 2,
-                    code: "E_USAGE",
-                    message: invalidValueMessage("--commit-emoji", opts.commitEmoji, `${expectedEmoji} (executor agent=${executorAgent})`),
-                });
-            }
             commitInfo = await commitFromComment({
                 ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: opts.taskId,
-                primaryTag: resolvePrimaryTag(toStringArray(task.tags), ctx).primary,
+                primaryTag: primaryTagForCommit,
                 executorAgent,
                 author: opts.author,
-                statusFrom: currentStatus,
+                statusFrom: currentStatusForCommit,
                 statusTo: "DOING",
                 commentBody: opts.body,
                 formattedComment,
-                emoji: opts.commitEmoji ?? expectedEmoji,
+                emoji: opts.commitEmoji ?? defaultCommitEmojiForStatus("DOING"),
                 allow: opts.commitAllow,
                 autoAllow: opts.commitAutoAllow || opts.commitAllow.length === 0,
                 allowTasks: opts.commitAllowTasks,

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

@@ -0,0 +1,8 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+type TaskGroupParsed = {
+    cmd: string[];
+};
+export declare const taskSpec: CommandSpec<TaskGroupParsed>;
+export declare const runTask: CommandHandler<TaskGroupParsed>;
+export {};
+//# sourceMappingURL=task.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/task.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAItF,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA6BzC,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,eAAe,CA8BjD,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,eAAe,CAWnD,CAAC"}

package/dist/commands/task/task.command.js

@@ -0,0 +1,71 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { suggestOne } from "../../cli/spec/suggest.js";
+const TASK_SUBCOMMANDS = [
+    "add",
+    "close-duplicate",
+    "close-noop",
+    "comment",
+    "derive",
+    "doc",
+    "export",
+    "lint",
+    "list",
+    "migrate",
+    "migrate-doc",
+    "new",
+    "next",
+    "normalize",
+    "plan",
+    "rebuild-index",
+    "scrub",
+    "search",
+    "set-status",
+    "show",
+    "start-ready",
+    "update",
+    "verify",
+    "verify-show",
+];
+export const taskSpec = {
+    id: ["task"],
+    group: "Task",
+    summary: "Task lifecycle and task-store commands.",
+    synopsis: ["agentplane task <subcommand> [args] [options]"],
+    args: [{ name: "cmd", required: false, variadic: true, valueHint: "<subcommand>" }],
+    notes: [
+        "Direct task route: task new -> task plan set -> task plan approve -> task start-ready -> task verify-show -> verify -> finish.",
+        "Use `agentplane help task plan`, `agentplane help task doc`, and `agentplane help task verify` to inspect task sub-areas.",
+        "Verification recording and closure stay top-level lifecycle commands: `agentplane verify ...` and `agentplane finish ...`.",
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task new --title "..." --description "..." --owner CODER --tag code',
+            why: "Create a task.",
+        },
+        {
+            cmd: 'agentplane task plan set <task-id> --text "..." --updated-by ORCHESTRATOR',
+            why: "Write the execution plan.",
+        },
+        {
+            cmd: 'agentplane task start-ready <task-id> --author CODER --body "Start: ..."',
+            why: "Start the task after approval.",
+        },
+        {
+            cmd: "agentplane task verify-show <task-id>",
+            why: "Show Verify Steps before running checks.",
+        },
+    ],
+    parse: (raw) => ({ cmd: (raw.args.cmd ?? []) }),
+};
+export const runTask = (_ctx, p) => {
+    const input = p.cmd.join(" ");
+    const suggestion = suggestOne(input, [...TASK_SUBCOMMANDS]);
+    const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
+    const message = p.cmd.length === 0 ? "Missing subcommand." : `Unknown subcommand: ${p.cmd[0]}.`;
+    throw usageError({
+        spec: taskSpec,
+        command: "task",
+        message: `${message}${suffix}`,
+        context: { command: "task" },
+    });
+};

package/dist/commands/task/verify-command-shared.d.ts

@@ -0,0 +1,16 @@
+import type { CommandSpec, OptionSpec, ParsedRaw } from "../../cli/spec/spec.js";
+export type VerifyCommonParsed = {
+    by: string;
+    note: string;
+    details?: string;
+    file?: string;
+    quiet: boolean;
+};
+export declare const verifyCommonOptions: readonly OptionSpec[];
+export declare function validateVerifyDetailsFileExclusive<TParsed>(raw: ParsedRaw, spec: CommandSpec<TParsed>, opts?: {
+    command?: string;
+    message?: string;
+}): void;
+export declare function validateVerifyNonEmptyInput<TParsed>(raw: ParsedRaw, spec: CommandSpec<TParsed>, name: "by" | "note"): void;
+export declare function parseVerifyCommonOptions(raw: ParsedRaw): VerifyCommonParsed;
+//# sourceMappingURL=verify-command-shared.d.ts.map

package/dist/commands/task/verify-command-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-command-shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-command-shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEjF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,SAAS,UAAU,EA2B3C,CAAC;AAEX,wBAAgB,kCAAkC,CAAC,OAAO,EACxD,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,IAAI,CAQN;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EACjD,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,GAClB,IAAI,CAKN;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,GAAG,kBAAkB,CAQ3E"}

package/dist/commands/task/verify-command-shared.js

@@ -0,0 +1,53 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const verifyCommonOptions = [
+    { kind: "string", name: "by", valueHint: "<id>", required: true, description: "Verifier id." },
+    {
+        kind: "string",
+        name: "note",
+        valueHint: "<text>",
+        required: true,
+        description: "Short verification note.",
+    },
+    {
+        kind: "string",
+        name: "details",
+        valueHint: "<text>",
+        description: "Optional details text (mutually exclusive with --file).",
+    },
+    {
+        kind: "string",
+        name: "file",
+        valueHint: "<path>",
+        description: "Optional details file path (mutually exclusive with --details).",
+    },
+    {
+        kind: "boolean",
+        name: "quiet",
+        default: false,
+        description: "Suppress normal output (still prints errors).",
+    },
+];
+export function validateVerifyDetailsFileExclusive(raw, spec, opts) {
+    if (typeof raw.opts.details === "string" && typeof raw.opts.file === "string") {
+        throw usageError({
+            spec,
+            command: opts?.command,
+            message: opts?.message ?? "Options --details and --file are mutually exclusive.",
+        });
+    }
+}
+export function validateVerifyNonEmptyInput(raw, spec, name) {
+    const value = raw.opts[name];
+    if (typeof value === "string" && value.trim().length === 0) {
+        throw usageError({ spec, message: `Invalid value for --${name}: empty.` });
+    }
+}
+export function parseVerifyCommonOptions(raw) {
+    return {
+        by: typeof raw.opts.by === "string" ? raw.opts.by : "",
+        note: typeof raw.opts.note === "string" ? raw.opts.note : "",
+        details: typeof raw.opts.details === "string" ? raw.opts.details : undefined,
+        file: typeof raw.opts.file === "string" ? raw.opts.file : undefined,
+        quiet: raw.opts.quiet === true,
+    };
+}

package/dist/commands/task/verify-ok.command.d.ts

@@ -1,12 +1,8 @@
 import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
 import type { CommandContext } from "../shared/task-backend.js";
-export type TaskVerifyOkParsed = {
+import { type VerifyCommonParsed } from "./verify-command-shared.js";
+export type TaskVerifyOkParsed = VerifyCommonParsed & {
     taskId: string;
-    by: string;
-    note: string;
-    details?: string;
-    file?: string;
-    quiet: boolean;
 };
 export declare const taskVerifyOkSpec: CommandSpec<TaskVerifyOkParsed>;
 export declare function makeRunTaskVerifyOkHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskVerifyOkParsed) => Promise<number>;

package/dist/commands/task/verify-ok.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-ok.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-ok.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAiE5D,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC3E,KAAK,UAAU,EAAE,GAAG,kBAAkB,KAAG,OAAO,CAAC,MAAM,CAAC,CAavE"}
+{"version":3,"file":"verify-ok.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-ok.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAuB5D,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC3E,KAAK,UAAU,EAAE,GAAG,kBAAkB,KAAG,OAAO,CAAC,MAAM,CAAC,CAavE"}