feat: mark branch follower migration-only

config/cicd-gitea-actions-poc.yaml

@@ -17,6 +17,25 @@ spec:
     preferredTarget: agentrun-jd01-v02
     decisionGate: env-reuse-must-pass-before-replacement
 
+  migration:
+    issue: https://github.com/pikasTech/unidesk/issues/1549
+    primaryEntrypoint: bun scripts/cli.ts cicd gitea-actions-poc plan
+    replacementTarget: gitea-actions-driven-cicd
+    branchFollower:
+      status: deprecated
+      mode: migration-only
+      reason: self-maintained branch observation and controller state machine are being replaced by Gitea mirror and Gitea Actions.
+      allowedDuringMigration:
+        - read-only-status
+        - debug-migration-evidence
+        - existing-production-controller-until-cutover
+      frozenCapabilities:
+        - new-controller-loop-features
+        - new-self-maintained-branch-observer
+        - source-commit-driven-big-loop-debugging
+        - new-fallbacks-around-gitea-actions
+      finalDisposition: remove-apply-run-once-or-convert-to-readonly-archive-after-cutover
+
   sourceAuthority:
     mode: immutable-snapshot-ref
     allowMutableBranchAsCiSource: false