agentplane 0.3.15 → 0.3.17

package/dist/cli/spec/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,QAAQ,CAgBX"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,QAAQ,CAcX;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC7B,GAAG,QAAQ,CAgBX"}

package/dist/cli/spec/errors.js

@@ -1,5 +1,17 @@
-import { CliError } from "../../shared/errors.js";
+import { DeprecatedFlagError, 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,10 +21,21 @@ 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,
     });
 }
+export function deprecatedFlagError(opts) {
+    const command = opts.spec ? opts.spec.id.join(" ") : undefined;
+    const usage = opts.spec && renderCommandHelpText(opts.spec, { compact: true, includeHeader: false });
+    const fullMessage = `Deprecated option ${opts.option} is ${opts.deprecated}; remove it or use the documented replacement.${usage ? `\n\n${usage}` : ""}`;
+    return new DeprecatedFlagError({
+        message: fullMessage,
+        context: {
+            option: opts.option,
+            deprecated: opts.deprecated,
+            ...(command ? { command } : {}),
+        },
+    });
+}

package/dist/cli/spec/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,SAAS,EAAE,MAAM,WAAW,CAAC;AAIpE,KAAK,aAAa,CAAC,OAAO,IAAI;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AA6EF,wBAAgB,gBAAgB,CAAC,OAAO,EACtC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,aAAa,CAAC,OAAO,CAAC,CAiIxB"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,SAAS,EAAE,MAAM,WAAW,CAAC;AAIpE,KAAK,aAAa,CAAC,OAAO,IAAI;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAkFF,wBAAgB,gBAAgB,CAAC,OAAO,EACtC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,aAAa,CAAC,OAAO,CAAC,CAmIxB"}

package/dist/cli/spec/parse.js

@@ -1,5 +1,5 @@
 import { suggestOne } from "./suggest.js";
-import { usageError } from "./errors.js";
+import { deprecatedFlagError, usageError } from "./errors.js";
 function isOptionToken(tok) {
     return tok.startsWith("-") && tok !== "-";
 }
@@ -67,6 +67,11 @@ function normalizeForValidation(opt, rawValue) {
     const coerced = opt.coerce(rawValue);
     return typeof coerced === "string" ? coerced : rawValue;
 }
+function assertNotDeprecated(spec, opt, token) {
+    if (!opt.deprecated)
+        return;
+    throw deprecatedFlagError({ spec, option: token, deprecated: opt.deprecated });
+}
 export function parseCommandArgv(spec, argv) {
     const { byLong, byShort, candidates } = indexOptions(spec);
     const raw = { args: {}, opts: {}, extra: [] };
@@ -93,6 +98,7 @@ export function parseCommandArgv(spec, argv) {
                 const suffix = sugg ? ` Did you mean ${sugg}?` : "";
                 throw usageError({ spec, message: `Unknown option: ${head}.${suffix}` });
             }
+            assertNotDeprecated(spec, opt, head);
             if (opt.kind === "boolean") {
                 if (eq === -1) {
                     setOpt(raw, opt, true);
@@ -118,6 +124,7 @@ export function parseCommandArgv(spec, argv) {
             const suffix = sugg ? ` Did you mean ${sugg}?` : "";
             throw usageError({ spec, message: `Unknown option: ${tok}.${suffix}` });
         }
+        assertNotDeprecated(spec, opt, tok);
         if (opt.kind === "boolean") {
             setOpt(raw, opt, true);
             continue;

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work-start.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.ts"],"names":[],"mappings":"AA0BA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAsRnC,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+JlB"}
+{"version":3,"file":"work-start.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAmBnC,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+JlB"}

package/dist/commands/branch/work-start.direct.d.ts

@@ -0,0 +1,13 @@
+type DirectWorkLock = {
+    task_id: string;
+    agent: string;
+    slug: string;
+    branch: string;
+    started_at: string;
+};
+export declare function directWorkLockPath(agentplaneDir: string): string;
+export declare function readDirectWorkLock(agentplaneDir: string): Promise<DirectWorkLock | null>;
+export declare function writeDirectWorkLock(agentplaneDir: string, lock: DirectWorkLock): Promise<void>;
+export declare function ensureGitClean(gitRoot: string): Promise<void>;
+export {};
+//# sourceMappingURL=work-start.direct.d.ts.map

package/dist/commands/branch/work-start.direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.direct.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.direct.ts"],"names":[],"mappings":"AAOA,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkB9F;AAED,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCnE"}

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

@@ -0,0 +1,75 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+export function directWorkLockPath(agentplaneDir) {
+    // Intentionally under cache/ so it stays out of git by default.
+    return path.join(agentplaneDir, "cache", "direct-work.json");
+}
+export async function readDirectWorkLock(agentplaneDir) {
+    try {
+        const text = await readFile(directWorkLockPath(agentplaneDir), "utf8");
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        if (typeof parsed.task_id !== "string" ||
+            typeof parsed.agent !== "string" ||
+            typeof parsed.slug !== "string" ||
+            typeof parsed.branch !== "string" ||
+            typeof parsed.started_at !== "string") {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeDirectWorkLock(agentplaneDir, lock) {
+    const dir = path.dirname(directWorkLockPath(agentplaneDir));
+    await mkdir(dir, { recursive: true });
+    await writeFile(directWorkLockPath(agentplaneDir), JSON.stringify(lock, null, 2) + "\n", "utf8");
+}
+export async function ensureGitClean(gitRoot) {
+    const { stdout } = await execFileAsync("git", ["status", "--porcelain"], {
+        cwd: gitRoot,
+        env: gitEnv(),
+    });
+    const lines = stdout
+        .split("\n")
+        .map((line) => line.trimEnd())
+        .filter((line) => line.trim().length > 0);
+    if (lines.length === 0)
+        return;
+    // Allow task workflow artifacts to be dirty. In direct mode we want a single-stream
+    // workflow without task branches, but we still expect task docs to change.
+    const allowedPrefixes = [
+        ".agentplane/tasks/",
+        ".agentplane/tasks.json",
+        ".agentplane/cache/",
+        ".agentplane/.upgrade/",
+        ".agentplane/upgrade/",
+    ];
+    const isAllowed = (p) => allowedPrefixes.some((prefix) => p.startsWith(prefix));
+    const dirty = lines
+        .map((line) => {
+        // Format: XY <path> (we only need the path-ish tail).
+        const rest = line.slice(2).trim();
+        if (!rest)
+            return "";
+        // Rename/copy format: "old -> new"
+        const arrow = rest.lastIndexOf(" -> ");
+        if (arrow === -1)
+            return rest;
+        return rest.slice(arrow + 4).trim();
+    })
+        .filter((p) => p.length > 0 && !isAllowed(p));
+    if (dirty.length === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: "Working tree has non-task changes. In workflow_mode=direct, agentplane runs tasks in a single stream on the current branch; commit/stash your changes before starting a different task.",
+    });
+}

package/dist/commands/branch/work-start.git.d.ts

@@ -0,0 +1,3 @@
+export { resolveBaseBranch } from "@agentplaneorg/core";
+export declare function ensureCurrentBaseBranch(gitRoot: string, baseBranch: string): Promise<void>;
+//# sourceMappingURL=work-start.git.d.ts.map

package/dist/commands/branch/work-start.git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.git.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.git.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchG"}

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

@@ -0,0 +1,19 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { gitAheadBehind } from "../shared/git-diff.js";
+import { gitBranchUpstream } from "../shared/git-ops.js";
+export { resolveBaseBranch } from "@agentplaneorg/core";
+export async function ensureCurrentBaseBranch(gitRoot, baseBranch) {
+    const upstreamBranch = await gitBranchUpstream(gitRoot, baseBranch);
+    if (!upstreamBranch)
+        return;
+    const { behind } = await gitAheadBehind(gitRoot, upstreamBranch, baseBranch);
+    if (behind === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: `Base branch ${baseBranch} is behind its upstream ${upstreamBranch} by ${behind} commit(s). ` +
+            "Refresh the base branch before `agentplane work start` to avoid DIRTY hosted PRs.",
+    });
+}

package/dist/commands/branch/work-start.hook-shim.d.ts

@@ -0,0 +1,2 @@
+export declare function materializeHookShimForWorktree(worktreePath: string): Promise<void>;
+//# sourceMappingURL=work-start.hook-shim.d.ts.map

package/dist/commands/branch/work-start.hook-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.hook-shim.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.hook-shim.ts"],"names":[],"mappings":"AAkCA,wBAAsB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxF"}

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

@@ -0,0 +1,38 @@
+import { chmod, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileExists } from "../../cli/fs-utils.js";
+const HOOK_SHIM_MARKER = "agentplane-hook-shim";
+function repoLocalHookShimText() {
+    return [
+        "#!/usr/bin/env sh",
+        `# ${HOOK_SHIM_MARKER} (do not edit)`,
+        "set -e",
+        'SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"',
+        'REPO_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"',
+        'LOCAL_BIN="$REPO_ROOT/packages/agentplane/bin/agentplane.js"',
+        'if command -v node >/dev/null 2>&1 && [ -f "$LOCAL_BIN" ]; then',
+        '  exec node "$LOCAL_BIN" "$@"',
+        "fi",
+        'ENV_BIN="${AGENTPLANE_HOOK_RUNNER:-}"',
+        'if [ -n "$ENV_BIN" ] && command -v node >/dev/null 2>&1 && [ -f "$ENV_BIN" ]; then',
+        '  exec node "$ENV_BIN" "$@"',
+        "fi",
+        "if command -v agentplane >/dev/null 2>&1; then",
+        '  exec agentplane "$@"',
+        "fi",
+        "if command -v npx >/dev/null 2>&1; then",
+        '  exec npx --yes agentplane "$@"',
+        "fi",
+        'echo "agentplane shim: runner not found (need env runner, repo-local source, agentplane in PATH, or node+npx)." >&2',
+        "  exit 127",
+        "",
+    ].join("\n");
+}
+export async function materializeHookShimForWorktree(worktreePath) {
+    const shimPath = path.join(worktreePath, ".agentplane", "bin", "agentplane");
+    if (await fileExists(shimPath))
+        return;
+    await mkdir(path.dirname(shimPath), { recursive: true });
+    await writeFile(shimPath, repoLocalHookShimText(), "utf8");
+    await chmod(shimPath, 0o755);
+}