refactor: integra reconcile no boot, dedup categoria/pasta, CI, Go 1.24

- Boot chama ReconcileBlobs com log de órfãos (era código morto)
- treeNode/validTreeName/siblingDup/moveCreatesCycle compartilhados
  entre Create/Update Category/Folder (mesma regra, um só lugar)
- mapStoreErrorFor com mensagens 404 por recurso (nota/arquivo/pasta/categoria)
- revisionHash helper + teste GET /revisions/{hash} (200 + 404)
- ReconcileBlobs com lock curto (coleta sob RLock, I/O fora do lock)
- AddFile com LimitReader no stream (cap antes de gravar, não depois)
- DeleteFile/DeleteFolder transacionais com rollback em memória
- attachmentKind único no frontend (syntax/html/preview)
- CI: gofmt, vet, test -race, node --check; go.mod 1.24 = Dockerfile
- README: notas operacionais (memória, proxy, boot, SSE, 413/400)

internal/api/revisions.go

@@ -11,6 +11,17 @@ import (
 
 var hashRe = regexp.MustCompile(`^[0-9a-f]{64}$`)
 
+// revisionHash valida o hash da rota; em hash inválido responde 404 e retorna
+// ("", false) — o chamador deve apenas retornar.
+func revisionHash(w http.ResponseWriter, r *http.Request) (string, bool) {
+	hash := r.PathValue("hash")
+	if !hashRe.MatchString(hash) {
+		writeError(w, http.StatusNotFound, "revisão não encontrada")
+		return "", false
+	}
+	return hash, true
+}
+
 func (s *Server) handleListRevisions(w http.ResponseWriter, r *http.Request) {
 	revs, err := s.st.History(r.PathValue("id"))
 	if err != nil {
@@ -26,9 +37,8 @@ func (s *Server) handleListRevisions(w http.ResponseWriter, r *http.Request) {
 }
 
 func (s *Server) handleGetRevision(w http.ResponseWriter, r *http.Request) {
-	hash := r.PathValue("hash")
-	if !hashRe.MatchString(hash) {
-		writeError(w, http.StatusNotFound, "revisão não encontrada")
+	hash, ok := revisionHash(w, r)
+	if !ok {
 		return
 	}
 	rc, err := s.st.RevisionWithContent(r.PathValue("id"), hash)
@@ -51,9 +61,8 @@ type diffView struct {
 }
 
 func (s *Server) handleRevisionDiff(w http.ResponseWriter, r *http.Request) {
-	hash := r.PathValue("hash")
-	if !hashRe.MatchString(hash) {
-		writeError(w, http.StatusNotFound, "revisão não encontrada")
+	hash, ok := revisionHash(w, r)
+	if !ok {
 		return
 	}
 	before, after, rev, err := s.st.DiffBetween(r.PathValue("id"), hash)
@@ -80,15 +89,13 @@ type restoreInput struct {
 }
 
 func (s *Server) handleRestore(w http.ResponseWriter, r *http.Request) {
-	hash := r.PathValue("hash")
-	if !hashRe.MatchString(hash) {
-		writeError(w, http.StatusNotFound, "revisão não encontrada")
+	hash, ok := revisionHash(w, r)
+	if !ok {
 		return
 	}
 	var in restoreInput
 	if r.ContentLength > 0 {
 		if err := decodeJSON(w, r, &in, 1<<16); err != nil {
-			writeError(w, http.StatusBadRequest, "corpo JSON inválido")
 			return
 		}
 	}