docs: mark v0.2 complete, set next-up context for v0.2.5

2026-05-17 09:26:47 +02:00
parent e31fd3f023
commit f7076c9ac8
6 changed files with 162 additions and 518 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -80,95 +80,25 @@ When acting as a coding agent on this project:
 6. Always work on a feature branch and open a PR — never push directly to main
 7. For client projects: never send code or context to cloud APIs — use local models via LiteLLM

-## Current sprint — gitea-mcp v0.2 patch (2026-05-14)
+## Current state — v0.2.5 (2026-05-17)

-### Context
-The main v0.2 batch (repo_create, repo_update, repo_mirror_push, repo_delete,
-repo_tree, repo_topics_update, file_read dir-fix, issue_get, release_create,
-create_project_from_template) was implemented and pushed directly to main.
+All v0.2 work is complete and deployed. No active sprint.

-This sprint fixes three remaining gaps found during code review on 2026-05-14.
-These are blockers for `hyperguild new-project`.
+### What shipped

-### Issues to fix (all three in one PR: `fix/v02-patch`)
+| Tag | PR | Tools / fixes |
+|-----|----|---------------|
+| v0.2.2 | #21 | repo_create, repo_update, repo_mirror_push |
+| v0.2.3 | #22 | repo_tree, repo_topics_update, file_read dir fix |
+| v0.2.4 | #23 | issue_get, release_create, repo_delete |
+| v0.2.5 | #26 | repo_update archived+template, create_project_from_template template_name, pr_files_diff loop fix |

-#### #12 — repo_update: add `archived` and `template` fields
-**File:** `internal/gitea/repos.go` → `UpdateRepoArgs` struct
-**File:** `internal/tools/repo_update.go` → input schema + args struct
+Current main: `e31fd3f`. CI green. Deployed via Flux.

-Add to `UpdateRepoArgs`:
-```go
-Archived *bool
-Template *bool
-```
+### Next up

-Add to tool input schema:
-```json
-"archived": {
-  "type": "boolean",
-  "description": "Mark repo as archived (read-only). Requires confirm=<repo name>."
-},
-"template": {
-  "type": "boolean",
-  "description": "Toggle template repo flag."
-}
-```
+1. **`hyperguild new-project` v1** — primary next target.
+   See brain node `adr-new-project-gitea-first-github-mirror` for full flow spec.

-Add confirm-guard for `archived=true` (same pattern as `private=false`):
-```go
-if args.Archived != nil && *args.Archived {
-    if args.Confirm != args.Name {
-        return nil, fmt.Errorf("setting archived=true is irreversible: set confirm=%q to proceed", args.Name)
-    }
-}
-```
-
-New test cases to add in `repo_update_test.go`:
- `TestRepoUpdateTool_Archive` — happy path with confirm
- `TestRepoUpdateTool_ArchiveRequiresConfirm` — missing confirm returns error
- `TestRepoUpdateTool_SetTemplate` — no confirm needed
-
-#### #24 — create_project_from_template: make template selectable
-**File:** `internal/tools/create_project_from_template.go`
-
-Add optional `template_name` param to input schema:
-```json
-"template_name": {
-  "type": "string",
-  "enum": ["template-go-web", "template-go-agent"],
-  "description": "Template repo to generate from. Defaults to template-go-web.",
-  "default": "template-go-web"
-}
-```
-
-The tool should use `args.TemplateName` if set, fall back to the hardcoded default.
-Remove the hardcoded template name from `cmd/gitea-mcp/main.go` constructor call —
-the tool resolves it internally.
-
-New test case: `TestCreateProjectFromTemplate_AgentTemplate`
-
-#### #25 — pr_files_diff: fix same diff returned for all files
-**File:** `internal/tools/pr_files_diff.go`
-
-There is a loop bug where all file entries in the response contain the same diff
-(the first file's diff is reused for every subsequent file). Find the loop and
-ensure each iteration reads and assigns the correct diff for its own file.
-
-Reproduce: call `pr_files_diff` on any PR with 3+ files, verify each file has
-a distinct diff.
-
-### Definition of done
-
- [ ] `task check` passes
- [ ] `repo_update` accepts `archived` and `template` params
- [ ] `archived=true` requires `confirm=<repo name>`
- [ ] `create_project_from_template` accepts `template_name` param, defaults to `template-go-web`
- [ ] `pr_files_diff` returns distinct diff per file
- [ ] All new test cases pass
- [ ] PR `fix/v02-patch` merged to main via PR (not direct push)
-
-### After this sprint
-
-Next: `hyperguild new-project` v1 implementation.
-See brain node `adr-new-project-gitea-first-github-mirror` for the full flow spec.
-Also: verify end-to-end mirror flow (issue #19) once `repo_mirror_push` is confirmed working.
+2. **Issue #19** — end-to-end mirror flow verification.
+   `repo_mirror_push` is implemented but the full flow (create repo → add push mirror → verify sync to GitHub) has not been tested manually. Do this before relying on it in production.