agentplane 0.3.15 → 0.3.16

package/dist/cli/spec/errors.js

@@ -1,5 +1,17 @@
-import { CliError } from "../../shared/errors.js";
+import { UsageError } from "../../shared/errors.js";
 import { renderCommandHelpText } from "./help-render.js";
+/**
+ * Usage-error helpers for command-spec parsing/rendering only.
+ *
+ * Allowed here:
+ * - E_USAGE construction tied to CLI spec/help rendering
+ * - command-specific usage context shaping
+ *
+ * Do not add:
+ * - shared runtime error primitives
+ * - backend/domain errors
+ * - non-CLI formatting or transport concerns
+ */
 export function usageError(opts) {
     const command = opts.command ?? (opts.spec ? opts.spec.id.join(" ") : undefined);
     const usage = opts.spec && renderCommandHelpText(opts.spec, { compact: true, includeHeader: false });
@@ -9,9 +21,7 @@ export function usageError(opts) {
         context.command = command;
     if (opts.context)
         Object.assign(context, opts.context);
-    return new CliError({
-        exitCode: 2,
-        code: "E_USAGE",
+    return new UsageError({
         message: fullMessage,
         context: Object.keys(context).length > 0 ? context : undefined,
     });

package/dist/commands/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAInF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB;AAED,wBAAsB,qCAAqC,CAAC,IAAI,EAAE;IAChE,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,kCAAkC,CAAC;CAC3C,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DlB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CAiElB"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAInF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAqDF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,qCAAqC,CAAC,IAAI,EAAE;IAChE,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,kCAAkC,CAAC;CAC3C,GAAG,OAAO,CAAC,MAAM,CAAC,CAoClB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CA2ClB"}

package/dist/commands/backend.js

@@ -4,36 +4,47 @@ import { CliError } from "../shared/errors.js";
 import { loadCommandContext } from "./shared/task-backend.js";
 import { ensureNetworkApproved } from "./shared/network-approval.js";
 const output = createCliEmitter();
+async function resolveBackendCommandContext(opts, descriptor) {
+    const ctx = opts.ctx ??
+        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    const backend = ctx.taskBackend;
+    const backendId = ctx.backendId;
+    if (descriptor.flags.backendId && backendId && descriptor.flags.backendId !== backendId) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: `Configured backend is "${backendId}", not "${descriptor.flags.backendId}"`,
+            context: { command: descriptor.command, reason_code: descriptor.mismatchReasonCode },
+        });
+    }
+    if (!backend[descriptor.operation]) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: backendNotSupportedMessage(descriptor.unsupportedLabel),
+        });
+    }
+    if (backendId !== "local") {
+        await ensureNetworkApproved({
+            action: descriptor.networkAction,
+            config: ctx.config,
+            yes: descriptor.flags.yes,
+            reason: descriptor.networkReason(backendId),
+        });
+    }
+    return { ctx, backend, backendId };
+}
 export async function cmdBackendSyncParsed(opts) {
     try {
-        const ctx = opts.ctx ??
-            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-        const backend = ctx.taskBackend;
-        const backendId = ctx.backendId;
-        const config = ctx.config;
-        if (opts.flags.backendId && backendId && opts.flags.backendId !== backendId) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: `Configured backend is "${backendId}", not "${opts.flags.backendId}"`,
-                context: { command: "backend sync", reason_code: "sync_backend_mismatch" },
-            });
-        }
-        if (!backend.sync) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: backendNotSupportedMessage("sync()"),
-            });
-        }
-        if (backendId !== "local") {
-            await ensureNetworkApproved({
-                action: "backend_sync",
-                config,
-                yes: opts.flags.yes,
-                reason: `backend sync may access the network (backend: ${backendId})`,
-            });
-        }
+        const { backend } = await resolveBackendCommandContext(opts, {
+            command: "backend sync",
+            operation: "sync",
+            unsupportedLabel: "sync()",
+            mismatchReasonCode: "sync_backend_mismatch",
+            networkAction: "backend_sync",
+            networkReason: (backendId) => `backend sync may access the network (backend: ${backendId})`,
+            flags: opts.flags,
+        });
         await backend.sync({
             direction: opts.flags.direction,
             conflict: opts.flags.conflict,
@@ -50,34 +61,15 @@ export async function cmdBackendSyncParsed(opts) {
 }
 export async function cmdSyncParsed(opts) {
     try {
-        const ctx = opts.ctx ??
-            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-        const backend = ctx.taskBackend;
-        const backendId = ctx.backendId;
-        const config = ctx.config;
-        if (opts.flags.backendId && backendId && opts.flags.backendId !== backendId) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: `Configured backend is "${backendId}", not "${opts.flags.backendId}"`,
-                context: { command: "sync", reason_code: "sync_backend_mismatch" },
-            });
-        }
-        if (!backend.sync) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: backendNotSupportedMessage("sync()"),
-            });
-        }
-        if (backendId !== "local") {
-            await ensureNetworkApproved({
-                action: "backend_sync",
-                config,
-                yes: opts.flags.yes,
-                reason: `sync may access the network (backend: ${backendId})`,
-            });
-        }
+        const { backend } = await resolveBackendCommandContext(opts, {
+            command: "sync",
+            operation: "sync",
+            unsupportedLabel: "sync()",
+            mismatchReasonCode: "sync_backend_mismatch",
+            networkAction: "backend_sync",
+            networkReason: (backendId) => `sync may access the network (backend: ${backendId})`,
+            flags: opts.flags,
+        });
         await backend.sync({
             direction: opts.flags.direction,
             conflict: opts.flags.conflict,
@@ -94,37 +86,15 @@ export async function cmdSyncParsed(opts) {
 }
 export async function cmdBackendMigrateCanonicalStateParsed(opts) {
     try {
-        const ctx = opts.ctx ??
-            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-        const backend = ctx.taskBackend;
-        const backendId = ctx.backendId;
-        const config = ctx.config;
-        if (opts.flags.backendId && backendId && opts.flags.backendId !== backendId) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: `Configured backend is "${backendId}", not "${opts.flags.backendId}"`,
-                context: {
-                    command: "backend migrate-canonical-state",
-                    reason_code: "sync_backend_mismatch",
-                },
-            });
-        }
-        if (!backend.migrateCanonicalState) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: backendNotSupportedMessage("migrateCanonicalState()"),
-            });
-        }
-        if (backendId !== "local") {
-            await ensureNetworkApproved({
-                action: "backend_migrate_canonical_state",
-                config,
-                yes: opts.flags.yes,
-                reason: `backend migrate-canonical-state may access the network (backend: ${backendId})`,
-            });
-        }
+        const { backend } = await resolveBackendCommandContext(opts, {
+            command: "backend migrate-canonical-state",
+            operation: "migrateCanonicalState",
+            unsupportedLabel: "migrateCanonicalState()",
+            mismatchReasonCode: "sync_backend_mismatch",
+            networkAction: "backend_migrate_canonical_state",
+            networkReason: (backendId) => `backend migrate-canonical-state may access the network (backend: ${backendId})`,
+            flags: opts.flags,
+        });
         const result = await backend.migrateCanonicalState();
         if (!opts.flags.quiet) {
             output.success("backend migrate-canonical-state", undefined, `scanned=${result.scanned} migrated=${result.migrated.length} skipped-structured=${result.skippedStructured.length} skipped-no-doc=${result.skippedNoDoc.length} failed=${result.failed.length}`);
@@ -148,37 +118,15 @@ export async function cmdBackendMigrateCanonicalStateParsed(opts) {
 }
 export async function cmdBackendInspectParsed(opts) {
     try {
-        const ctx = opts.ctx ??
-            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-        const backend = ctx.taskBackend;
-        const backendId = ctx.backendId;
-        const config = ctx.config;
-        if (opts.flags.backendId && backendId && opts.flags.backendId !== backendId) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: `Configured backend is "${backendId}", not "${opts.flags.backendId}"`,
-                context: {
-                    command: "backend inspect",
-                    reason_code: "inspect_backend_mismatch",
-                },
-            });
-        }
-        if (!backend.inspectConfiguration) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: backendNotSupportedMessage("inspectConfiguration()"),
-            });
-        }
-        if (backendId !== "local") {
-            await ensureNetworkApproved({
-                action: "backend_inspect",
-                config,
-                yes: opts.flags.yes,
-                reason: `backend inspect may access the network (backend: ${backendId})`,
-            });
-        }
+        const { backend } = await resolveBackendCommandContext(opts, {
+            command: "backend inspect",
+            operation: "inspectConfiguration",
+            unsupportedLabel: "inspectConfiguration()",
+            mismatchReasonCode: "inspect_backend_mismatch",
+            networkAction: "backend_inspect",
+            networkReason: (backendId) => `backend inspect may access the network (backend: ${backendId})`,
+            flags: opts.flags,
+        });
         const result = await backend.inspectConfiguration();
         if (opts.flags.quiet)
             return 0;

package/dist/commands/block.spec.js

@@ -1,5 +1,5 @@
 import { usageError } from "../cli/spec/errors.js";
-import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "../shared/allow-prefix-policy.js";
+import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "./shared/allow-prefix-policy.js";
 import { toStringList } from "../cli/spec/parse-utils.js";
 export const blockSpec = {
     id: ["block"],

package/dist/commands/branch/work-start.js

@@ -11,7 +11,7 @@ import { execFileAsync, gitEnv } from "../shared/git.js";
 import { gitAheadBehind } from "../shared/git-diff.js";
 import { gitBranchExists, gitBranchUpstream, gitCurrentBranch } from "../shared/git-ops.js";
 import { isPathWithin } from "../shared/path.js";
-import { resolveRuntimeSourceInfo } from "../../shared/runtime-source.js";
+import { resolveRuntimeSourceInfo } from "../../runtime/shared/runtime-source.js";
 import { loadBackendTask, loadCommandContext, } from "../shared/task-backend.js";
 function isPresentString(value) {
     return value !== null;

package/dist/commands/commit.spec.js

@@ -1,5 +1,5 @@
 import { usageError } from "../cli/spec/errors.js";
-import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "../shared/allow-prefix-policy.js";
+import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "./shared/allow-prefix-policy.js";
 export const commitSpec = {
     id: ["commit"],
     group: "Guard",

package/dist/commands/doctor/branch-pr.js

@@ -1,6 +1,6 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { renderDiagnosticFinding } from "../../shared/diagnostics.js";
+import { renderDiagnosticFinding } from "../shared/diagnostics.js";
 import { backendUsesLocalTaskStore } from "../shared/task-backend.js";
 import { findDoneBranchPrTasksWithOpenPrArtifacts, findLocallyShippedBranchPrTasks, } from "../task/hosted-merge-sync.js";
 export async function checkBranchPrShippedTaskDrift(ctx) {

package/dist/commands/doctor/fixes.js

@@ -1,7 +1,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { parseTaskReadme } from "@agentplaneorg/core";
-import { RUNTIME_GITIGNORE_LINES } from "../../shared/runtime-artifacts.js";
+import { RUNTIME_GITIGNORE_LINES } from "../../runtime/shared/runtime-artifacts.js";
 import { GitContext } from "../shared/git-context.js";
 import { loadCommandContext } from "../shared/task-backend.js";
 export async function safeFixGitignore(repoRoot) {

package/dist/commands/doctor/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAsB5D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,EAAE,CA+BxF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAM1E"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAyB5D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,EAAE,CA+BxF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAM1E"}

package/dist/commands/doctor/runtime.js

@@ -1,5 +1,5 @@
-import { evaluateRepoCliVersionExpectation, } from "../../shared/repo-cli-version.js";
-import { describeRuntimeMode, resolveRuntimeSourceInfo } from "../../shared/runtime-source.js";
+import { evaluateRepoCliVersionExpectation, } from "../../runtime/shared/repo-cli-version.js";
+import { describeRuntimeMode, resolveRuntimeSourceInfo, } from "../../runtime/shared/runtime-source.js";
 function renderCliVersionFacts(expectation) {
     if (!expectation.expectedVersion)
         return [];

package/dist/commands/doctor/workspace.js

@@ -2,7 +2,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { parseTaskReadme, renderTaskDocFromSections } from "@agentplaneorg/core";
-import { renderDiagnosticFinding } from "../../shared/diagnostics.js";
+import { renderDiagnosticFinding } from "../shared/diagnostics.js";
 import { resolvePolicyGatewayForRepo } from "../../shared/policy-gateway.js";
 import { GitContext } from "../shared/git-context.js";
 import { listTaskProjection } from "../shared/task-backend.js";

package/dist/commands/finish.spec.js

@@ -1,7 +1,7 @@
 import { usageError } from "../cli/spec/errors.js";
 import { verifyFindingOptions, validateVerifyFindingSource } from "./task/verify-command-shared.js";
 import { toStringList } from "../cli/spec/parse-utils.js";
-import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "../shared/allow-prefix-policy.js";
+import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "./shared/allow-prefix-policy.js";
 export const finishSpec = {
     id: ["finish"],
     group: "Lifecycle",

package/dist/commands/guard/commit.command.js

@@ -1,6 +1,6 @@
 import { usageError } from "../../cli/spec/errors.js";
 import { CliError } from "../../shared/errors.js";
-import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "../../shared/allow-prefix-policy.js";
+import { findRepoWideAllowPrefixes, repoWideAllowPrefixMessage, } from "../shared/allow-prefix-policy.js";
 import { cmdGuardCommit } from "./index.js";
 export const guardCommitSpec = {
     id: ["guard", "commit"],

package/dist/commands/guard/impl/clean.d.ts

@@ -0,0 +1,6 @@
+export declare function cmdGuardClean(opts: {
+    cwd: string;
+    rootOverride?: string;
+    quiet: boolean;
+}): Promise<number>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/commands/guard/impl/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/clean.ts"],"names":[],"mappings":"AAKA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB"}

package/dist/commands/guard/impl/clean.js

@@ -0,0 +1,29 @@
+import { mapCoreError } from "../../../cli/error-map.js";
+import { successMessage } from "../../../cli/output.js";
+import { CliError } from "../../../shared/errors.js";
+import { loadCommandContext } from "../../shared/task-backend.js";
+export async function cmdGuardClean(opts) {
+    try {
+        const ctx = await loadCommandContext({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const staged = await ctx.git.statusStagedPaths();
+        if (staged.length > 0) {
+            throw new CliError({
+                exitCode: 5,
+                code: "E_GIT",
+                message: "Staged files exist",
+            });
+        }
+        if (!opts.quiet) {
+            process.stdout.write(`${successMessage("index clean", undefined, "no staged files")}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "guard clean", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/guard/impl/close-dirt.d.ts

@@ -0,0 +1,6 @@
+import type { CommandContext } from "../../shared/task-backend.js";
+export declare function resolveIgnoredDirectCloseDirtyPaths(opts: {
+    ctx: CommandContext;
+    taskId: string;
+}): Promise<string[]>;
+//# sourceMappingURL=close-dirt.d.ts.map

package/dist/commands/guard/impl/close-dirt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-dirt.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/close-dirt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAmCnE,wBAAsB,mCAAmC,CAAC,IAAI,EAAE;IAC9D,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BpB"}

package/dist/commands/guard/impl/close-dirt.js

@@ -0,0 +1,56 @@
+import { loadTaskFromContext } from "../../shared/task-backend.js";
+function normalizeGitPath(value) {
+    return value.replaceAll("\\", "/").replace(/\/+$/, "");
+}
+function otherTaskIdForReadmePath(opts) {
+    const relPath = normalizeGitPath(opts.relPath);
+    const workflowDir = normalizeGitPath(opts.workflowDir);
+    const prefix = `${workflowDir}/`;
+    if (!relPath.startsWith(prefix) || !relPath.endsWith("/README.md")) {
+        return null;
+    }
+    const remainder = relPath.slice(prefix.length);
+    const parts = remainder.split("/");
+    if (parts.length !== 2 || parts[1] !== "README.md") {
+        return null;
+    }
+    const candidateTaskId = parts[0]?.trim() ?? "";
+    if (!candidateTaskId || candidateTaskId === opts.taskId) {
+        return null;
+    }
+    return candidateTaskId;
+}
+function isActiveTaskStatus(status) {
+    if (typeof status !== "string")
+        return true;
+    return status.trim().toUpperCase() !== "DONE";
+}
+export async function resolveIgnoredDirectCloseDirtyPaths(opts) {
+    if (opts.ctx.config.workflow_mode !== "direct")
+        return [];
+    if (opts.ctx.config.close_commit.direct_dirty_policy !== "allow_other_task_readmes") {
+        return [];
+    }
+    const unstagedTrackedPaths = await opts.ctx.git.statusUnstagedTrackedPaths();
+    const ignored = new Set();
+    for (const relPath of unstagedTrackedPaths) {
+        const otherTaskId = otherTaskIdForReadmePath({
+            relPath,
+            workflowDir: opts.ctx.config.paths.workflow_dir,
+            taskId: opts.taskId,
+        });
+        if (!otherTaskId)
+            continue;
+        try {
+            const otherTask = await loadTaskFromContext({ ctx: opts.ctx, taskId: otherTaskId });
+            if (isActiveTaskStatus(otherTask.status)) {
+                ignored.add(relPath);
+            }
+        }
+        catch {
+            // Missing or unreadable tasks stay blocking; close-tail should only ignore
+            // dirt that is both structurally recognized and backed by an active task.
+        }
+    }
+    return [...ignored].toSorted((a, b) => a.localeCompare(b));
+}

package/dist/commands/guard/impl/commands.d.ts

@@ -1,37 +1,5 @@
-import { type CommandContext } from "../../shared/task-backend.js";
-import { type GuardCommitOptions } from "./policy.js";
-export declare function cmdGuardClean(opts: {
-    cwd: string;
-    rootOverride?: string;
-    quiet: boolean;
-}): Promise<number>;
-export declare function cmdGuardSuggestAllow(opts: {
-    cwd: string;
-    rootOverride?: string;
-    format: "lines" | "args";
-}): Promise<number>;
-export declare function cmdGuardCommit(opts: GuardCommitOptions): Promise<number>;
-export declare function cmdCommit(opts: {
-    ctx?: CommandContext;
-    cwd: string;
-    rootOverride?: string;
-    baseBranchOverride?: string | null;
-    taskId: string;
-    message: string;
-    close: boolean;
-    allow: string[];
-    autoAllow: boolean;
-    allowTasks: boolean;
-    allowBase: boolean;
-    allowPolicy: boolean;
-    allowConfig: boolean;
-    allowHooks: boolean;
-    allowCI: boolean;
-    requireClean: boolean;
-    quiet: boolean;
-    closeUnstageOthers: boolean;
-    closeCheckOnly: boolean;
-    closeStageTaskArtifacts?: boolean;
-    closeRefreshTaskArtifacts?: boolean;
-}): Promise<number>;
+export { cmdCommit } from "./commit.js";
+export { cmdGuardClean } from "./clean.js";
+export { cmdGuardCommit } from "./guard-commit.js";
+export { cmdGuardSuggestAllow } from "./suggest.js";
 //# sourceMappingURL=commands.d.ts.map

package/dist/commands/guard/impl/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAaA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQvF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA+SxE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwPlB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}