akm-cli 0.9.16 → 0.9.17-alpha.10

package/dist/commands/tasks/tasks-cli.js

@@ -226,7 +226,7 @@ const tasksAddCommand = defineJsonCommand({
         force: { type: "boolean", description: "Overwrite an existing task with the same id", default: false },
         rebind: {
             type: "boolean",
-            description: "Explicitly permit scheduler creation from this ineligible local invocation",
+            description: "Also point the bundle's installed scheduler rows at this akm invocation (as `task sync --rebind`)",
             default: false,
         },
     },
@@ -358,13 +358,13 @@ export function taskSyncDryRunExitCode(preview) {
 const tasksSyncCommand = defineJsonCommand({
     meta: {
         name: "sync",
-        description: "Atomically preflight and reconcile a bundle's task/workflow schedules with the OS scheduler",
+        description: "Reconcile enabled task/workflow schedules with the OS scheduler, one row at a time",
     },
     args: {
         ...bundleArg,
         rebind: {
             type: "boolean",
-            description: "Replace installed bindings with the current invocation",
+            description: "Point installed rows at this akm invocation instead of keeping their launcher",
             default: false,
         },
         "dry-run": {
@@ -435,13 +435,12 @@ const tasksDoctorCommand = defineJsonCommand({
     },
 });
 /**
- * #907: `akm task validate`'s exit-code contract — only current-schema
- * `valid` is successful (exit 0); `blocked`/`invalid`/`not-a-task` are
- * diagnosed defects the caller must act on (exit 1, mirroring `task sync`'s
- * own `failures.length > 0 -> EXIT_CODES.GENERAL`). A missing path or an
- * unreadable file never reaches this function at all — `akmTaskValidate`
- * throws a `UsageError` for those, which `defineJsonCommand`'s wrapping
- * already maps to exit 2.
+ * #907: `akm task validate`'s exit-code contract — `valid` succeeds (exit
+ * 0); `blocked`/`invalid`/`not-a-task` are diagnosed defects the caller must
+ * act on (exit 1, mirroring `task sync`'s own `failures.length > 0 ->
+ * EXIT_CODES.GENERAL`). A missing path or an unreadable file never reaches
+ * this function at all — `akmTaskValidate` throws a `UsageError` for those,
+ * which `defineJsonCommand`'s wrapping already maps to exit 2.
  */
 export function taskValidateExitCode(result) {
     return result.outcome === "valid" ? undefined : EXIT_CODES.GENERAL;
@@ -477,9 +476,9 @@ export function taskPruneExitCode(result) {
 const tasksPruneCommand = defineJsonCommand({
     meta: {
         name: "prune",
-        description: "Remove installed scheduler entries `sync` can never reclaim because their own descriptor no longer " +
-            "resolves to a live bundle (corrupt/missing --scheduler-context, or the owning bundle directory is " +
-            "gone). Defaults to a dry-run preview — zero scheduler writes. Requires --yes to remove anything; " +
+        description: "Remove installed scheduler entries `sync` can never reclaim because they no longer resolve to a live " +
+            "bundle (the bundle directory a row names is gone, or an older row's --scheduler-context descriptor " +
+            "cannot be read). Defaults to a dry-run preview — zero scheduler writes. Requires --yes to remove anything; " +
             "--id narrows removal to specific binding ids (comma-separated).",
     },
     args: {