chore: sync OpenAPI spec from flashduty-docs

.gitignore

@@ -1,5 +1,6 @@
 /dist/
 /bin/
+.worktrees/
 *.out
 .DS_Store
 

internal/cmd/gen/main.go

@@ -190,7 +190,7 @@ func (g *Gen) collectServices(paths map[string]any) []service {
 		for _, e := range entries {
 			opIDs = append(opIDs, str(e.op, "operationId"))
 		}
-		names := methodNames(opIDs)
+		names := methodNames(tag, opIDs)
 
 		svc := service{Name: serviceName(tag), Tag: tag}
 		for _, e := range entries {

internal/cmd/gen/naming.go

@@ -120,9 +120,14 @@ func commonPrefixLen(opTokens [][]string) int {
 	}
 }
 
+var methodPrefixByTag = map[string][]string{
+	"On-call/Incidents":    {"incident"},
+	"On-call/Integrations": {"webhook", "history"},
+}
+
 // methodNames computes a unique Go method name for each operationId within a
-// service by stripping the shared leading resource tokens, then deduping.
-func methodNames(opIDs []string) map[string]string {
+// service by stripping stable service-specific leading tokens, then deduping.
+func methodNames(tag string, opIDs []string) map[string]string {
 	opTokens := make([][]string, len(opIDs))
 	for i, id := range opIDs {
 		opTokens[i] = tokens(id)
@@ -133,6 +138,9 @@ func methodNames(opIDs []string) map[string]string {
 	used := make(map[string]int)
 	for i, id := range opIDs {
 		toks := opTokens[i][n:]
+		if prefix, ok := methodPrefixByTag[tag]; ok && hasTokenPrefix(opTokens[i], prefix) {
+			toks = opTokens[i][len(prefix):]
+		}
 		if len(toks) == 0 {
 			toks = opTokens[i]
 		}
@@ -155,6 +163,18 @@ func methodNames(opIDs []string) map[string]string {
 	return result
 }
 
+func hasTokenPrefix(toks, prefix []string) bool {
+	if len(toks) <= len(prefix) {
+		return false
+	}
+	for i, p := range prefix {
+		if strings.ToLower(toks[i]) != p {
+			return false
+		}
+	}
+	return true
+}
+
 func itoa(n int) string {
 	if n == 0 {
 		return "0"