docs: standardize gitea pac cicd architecture

config/cicd-branch-followers.yaml

@@ -66,9 +66,9 @@ followers:
       repository: pikasTech/HWLAB
       branch: v0.3
       branchRef: config/hwlab-node-lanes.yaml#lanes.v03.sourceBranch
-      authorityRef: config/platform-infra/gitea.yaml#sourceAuthority.repositories.hwlab-jd01-v03
+      authorityRef: config/platform-infra/gitea.yaml#sourceAuthority.repositories
       snapshotPrefix: refs/unidesk/snapshots/gitea-actions/hwlab-node-runtime/v0.3
-      snapshotRef: config/platform-infra/gitea.yaml#sourceAuthority.repositories.hwlab-jd01-v03.snapshot.prefix
+      snapshotRef: config/platform-infra/gitea.yaml#sourceAuthority.repositories
     target:
       node: JD01
       lane: v03

config/cicd-gitea-actions-poc.yaml

@@ -1,16 +1,18 @@
-# SPEC: GH-1548 Gitea mirror/Actions visibility and controlled Docker builder POC
+# SPEC: GH-1548 archived Gitea Actions POC; GH-1560 active path is Gitea mirror + Pipelines-as-Code.
 apiVersion: unidesk.pikapython.com/v1alpha1
 kind: CicdGiteaActionsPoc
 metadata:
   id: gitea-actions-builder-poc
   owner: UniDesk
   issue: https://github.com/pikasTech/unidesk/issues/1548
-  specRef: GH-1548
-  version: draft-2026-07-05-p0-gitea-actions-builder-poc
+  specRef: GH-1548/GH-1560
+  version: archived-2026-07-06-gitea-actions-poc
+  status: archived-readonly
+  replacement: config/platform-infra/pipelines-as-code.yaml
 
 spec:
   scope:
-    phase: p1-spec-p2-poc
+    phase: archived-readonly
     productionFollowerReplacement: false
     rolloutEnabled: false
     rolloutMode: diagnostic-only
@@ -19,12 +21,14 @@ spec:
 
   migration:
     issue: https://github.com/pikasTech/unidesk/issues/1549
-    primaryEntrypoint: bun scripts/cli.ts cicd gitea-actions-poc plan
-    replacementTarget: gitea-actions-driven-cicd
+    activeCloseoutIssue: https://github.com/pikasTech/unidesk/issues/1560
+    primaryEntrypoint: bun scripts/cli.ts platform-infra pipelines-as-code status --target JD01
+    replacementTarget: gitea-pac-driven-cicd
+    archivedEntrypoint: bun scripts/cli.ts cicd gitea-actions-poc plan
     branchFollower:
       status: deprecated
       mode: migration-only
-      reason: self-maintained branch observation and controller state machine are being replaced by Gitea mirror and Gitea Actions.
+      reason: self-maintained branch observation and controller state machine have been replaced for JD01 consumers by Gitea mirror and Pipelines-as-Code.
       allowedDuringMigration:
         - read-only-status
         - debug-migration-evidence

config/platform-infra/gitea.yaml

@@ -4,23 +4,27 @@ kind: platform-infra-gitea
 metadata:
   id: gitea-internal-mirror
   owner: unidesk
-  spec: GH-1548/GH-1550
+  spec: GH-1548/GH-1550/GH-1560
   relatedIssues:
     - 1548
     - 1549
     - 1550
     - 1557
+    - 1560
 
 defaults:
   targetId: JD01
 
 migration:
-  role: gitea-actions-driven-cicd-source-authority
+  role: gitea-pac-cicd-source-authority
   replaces: branch-follower-self-maintained-branch-observer
   parentConfigRef: config/cicd-gitea-actions-poc.yaml#spec.sourceAuthority.giteaMirror
+  archivedPocRef: config/cicd-gitea-actions-poc.yaml
+  activePacConfigRef: config/platform-infra/pipelines-as-code.yaml
   envReusePolicy: preserve-existing-runtime-env-reuse
   buildPlane: controlled-docker-or-buildkit-outside-runtime
   runtimePlane: k3s-gitea-service-zero-docker
+  activeTriggerPath: gitea-webhook-to-pipelines-as-code-to-tekton-to-argo
 
 sourceAuthority:
   enabled: true
@@ -113,6 +117,7 @@ sourceAuthority:
         branch: jd01-v0.2-gitops
         flushDisposition: retained-for-gitops-flush
       snapshot:
+        naming: historical-gitea-actions-prefix-retained-for-existing-refs
         prefix: refs/unidesk/snapshots/gitea-actions/agentrun-v0.2
       legacyGitMirror:
         readUrl: http://git-mirror-http.devops-infra.svc.cluster.local:8080/pikasTech/agentrun.git
@@ -134,6 +139,7 @@ sourceAuthority:
         branch: master
         flushDisposition: not-a-gitops-branch
       snapshot:
+        naming: historical-gitea-actions-prefix-retained-for-existing-refs
         prefix: refs/unidesk/snapshots/gitea-actions/unidesk-master
       legacyGitMirror:
         readUrl: http://git-mirror-http.devops-infra.svc.cluster.local:8080/pikasTech/unidesk.git
@@ -155,6 +161,7 @@ sourceAuthority:
         branch: v0.3-gitops
         flushDisposition: retained-for-gitops-flush
       snapshot:
+        naming: historical-gitea-actions-prefix-retained-for-existing-refs
         prefix: refs/unidesk/snapshots/gitea-actions/hwlab-node-runtime/v0.3
       legacyGitMirror:
         readUrl: http://git-mirror-http.devops-infra.svc.cluster.local:8080/pikasTech/HWLAB.git
@@ -165,7 +172,7 @@ targets:
   - id: JD01
     route: JD01:k3s
     namespace: devops-infra
-    role: active-poc
+    role: active-source-authority
     enabled: true
     createNamespace: true
     storageClassName: local-path

config/platform-infra/pipelines-as-code.yaml

@@ -4,11 +4,12 @@ kind: platform-infra-pipelines-as-code
 metadata:
   id: pac-gitea-consumers
   owner: unidesk
-  spec: GH-1552/GH-1555
+  spec: GH-1552/GH-1555/GH-1560
   relatedIssues:
     - 1552
     - 1555
     - 1557
+    - 1560
 
 defaults:
   targetId: JD01
@@ -29,7 +30,7 @@ targets:
   - id: JD01
     route: JD01:k3s
     namespace: agentrun-ci
-    role: active-poc
+    role: active-cicd-trigger-authority
     enabled: true
 
 gitea:
@@ -67,6 +68,7 @@ repositories:
       git_write_url: http://gitea-http.devops-infra.svc.cluster.local:3000/mirrors/pikasTech-agentrun.git
       source_branch: v0.2
       gitops_branch: jd01-v0.2-gitops
+      # Historical prefix name retained for existing snapshot refs; active architecture is Gitea + PaC, not Gitea Actions.
       source_snapshot_prefix: refs/unidesk/snapshots/gitea-actions/agentrun-v0.2
       pipeline_name: agentrun-jd01-v02-ci-image-publish
       pipeline_run_prefix: agentrun-jd01-v02-ci
@@ -87,6 +89,7 @@ repositories:
     params:
       git_read_url: http://gitea-http.devops-infra.svc.cluster.local:3000/mirrors/pikasTech-unidesk.git
       source_branch: master
+      # Historical prefix name retained for existing snapshot refs; active architecture is Gitea + PaC, not Gitea Actions.
       source_snapshot_prefix: refs/unidesk/snapshots/gitea-actions/unidesk-master
       node: JD01
       lane: v03
@@ -110,6 +113,7 @@ repositories:
       git_write_url: http://git-mirror-write.devops-infra.svc.cluster.local:8080/pikasTech/HWLAB.git
       source_branch: v0.3
       gitops_branch: v0.3-gitops
+      # Historical prefix name retained for existing snapshot refs; active architecture is Gitea + PaC, not Gitea Actions.
       source_snapshot_prefix: refs/unidesk/snapshots/gitea-actions/hwlab-node-runtime/v0.3
       pipeline_name: hwlab-jd01-v03-ci-image-publish
       pipeline_run_prefix: hwlab-jd01-v03-ci-poll