# Olons Server Manual Actions Entry Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** 让 Gitea 在 `olons_server` 仓库的 Actions 页面识别 `dev` 分支现有的手动部署工作流。

**Architecture:** 不复制或修改工作流文件，不触发部署；仅将仓库默认分支从初始化用的 `main` 改为实际开发与部署分支 `dev`。通过 Gitea API 在变更前后验证默认分支、工作流识别结果和 Actions 运行数量。

**Tech Stack:** Gitea 1.27 API、Gitea Actions、Git

---

### Task 1: 验证变更前状态

**Files:**
- Verify: `.gitea/workflows/deploy.yml`

- [ ] **Step 1: 确认远端 `dev` 包含手动部署工作流**

Run:

```bash
git show origin/dev:.gitea/workflows/deploy.yml | grep -F 'workflow_dispatch:'
```

Expected: 输出 `workflow_dispatch:`。

- [ ] **Step 2: 运行远端契约断言并确认其按预期失败**

使用现有 Gitea 登录态读取仓库与 Actions API，断言：

```python
assert repository["default_branch"] == "dev"
assert any(item["path"] == ".gitea/workflows/deploy.yml" and item["state"] == "active" for item in workflows["workflows"])
```

Expected: FAIL；变更前默认分支为 `main`，识别到的工作流数量为 0。

### Task 2: 修改默认分支

**Files:**
- Modify: Gitea repository setting `im_team/olons_server.default_branch`

- [ ] **Step 1: 通过 Gitea API 将默认分支改为 `dev`**

Run:

```bash
credential_data=$(printf 'protocol=https\nhost=git.118im.com\n\n' | git credential fill)
gitea_user=$(printf '%s\n' "$credential_data" | sed -n 's/^username=//p')
gitea_password=$(printf '%s\n' "$credential_data" | sed -n 's/^password=//p')
curl -u "$gitea_user:$gitea_password" \
  -X PATCH https://git.118im.com/api/v1/repos/im_team/olons_server \
  -H 'Content-Type: application/json' \
  --data '{"default_branch":"dev"}'
unset credential_data gitea_user gitea_password
```

认证信息仅从本机现有 Git credential helper 注入进程，不写入文件、不输出到日志。

Expected: HTTP 200，响应中的 `default_branch` 为 `dev`。

### Task 3: 验证手动入口并记录结果

**Files:**
- Create: `/Users/aa/.codex/memories/extensions/ad_hoc/notes/2026-10-13T14-34-07-olons-server-manual-actions.md`

- [ ] **Step 1: 重新运行远端契约断言**

Expected: PASS；默认分支为 `dev`，`.gitea/workflows/deploy.yml` 状态为 `active`。

- [ ] **Step 2: 确认没有因默认分支变更产生新的部署运行**

Run: 调用 `GET /api/v1/repos/im_team/olons_server/actions/runs?limit=5`。

Expected: 运行数量与变更前相同；本任务不触发 `workflow_dispatch`。

- [ ] **Step 3: 推送设计与计划提交**

Run:

```bash
git push origin dev
```

Expected: 本地 `dev` 与 `origin/dev` 一致。

- [ ] **Step 4: 更新记忆扩展说明**

记录默认分支变更、工作流可见性验证、未触发部署以及后续手动运行入口；不得记录凭据值。