feat: mark branch follower migration-only

scripts/src/cicd.ts

@@ -8,11 +8,17 @@ import { cicdGiteaActionsPocHelp, runGiteaActionsPocCommand } from "./cicd-gitea
 
 export function cicdHelp(): unknown {
   return {
-    command: "cicd branch-follower|gitea-actions-poc",
+    command: "cicd gitea-actions-poc|branch-follower",
     output: "text by default for subcommands; top-level help is json",
+    migration: {
+      issue: "https://github.com/pikasTech/unidesk/issues/1549",
+      primary: "cicd gitea-actions-poc",
+      deprecated: "cicd branch-follower",
+      note: "New CI/CD replacement work should use the Gitea Actions driven path; branch-follower is migration-only.",
+    },
     subcommands: [
-      branchFollowerHelp(),
       cicdGiteaActionsPocHelp(),
+      branchFollowerHelp(),
     ],
   };
 }
@@ -22,5 +28,5 @@ export async function runCicdCommand(config: UniDeskConfig | null, args: string[
   if (top === undefined || top === "help" || top === "--help" || top === "-h") return renderMachine("cicd", cicdHelp(), "json");
   if (top === "branch-follower") return await runBranchFollowerCommand(config, args);
   if (top === "gitea-actions-poc" || top === "gitea-builder-poc") return await runGiteaActionsPocCommand(config, args.slice(1), top);
-  throw new Error("cicd usage: cicd branch-follower|gitea-actions-poc");
+  throw new Error("cicd usage: cicd gitea-actions-poc|branch-follower");
 }