javi-forge 1.2.0 → 1.3.0

package/ai-config/skills/backend/graphql-spring/SKILL.md

@@ -1,398 +0,0 @@
----
-name: graphql-spring
-description: >
-  Spring Boot GraphQL. Spring for GraphQL, resolvers, DataLoader, subscriptions.
-  Trigger: apigen-graphql, @QueryMapping, @MutationMapping, DataLoader, GraphQL Java
-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Grep
-metadata:
-  author: apigen-team
-  version: "1.0"
-  tags: [graphql, spring-boot, resolvers, java]
-  scope: ["apigen-graphql/**"]
----
-
-# GraphQL Spring Boot (apigen-graphql)
-
-## Configuration
-
-```yaml
-spring:
-  graphql:
-    graphiql:
-      enabled: true
-      path: /graphiql
-    schema:
-      locations: classpath:graphql/
-      printer:
-        enabled: true
-    websocket:
-      path: /graphql
-
-apigen:
-  graphql:
-    enabled: true
-    max-depth: 10
-    max-complexity: 200
-    introspection-enabled: ${DEBUG:false}
-```
-
-## Schema Definition
-
-```graphql
-# src/main/resources/graphql/schema.graphqls
-
-type Query {
-  user(id: ID!): User
-  users(page: Int = 0, size: Int = 20): UserConnection!
-  searchUsers(query: String!): [User!]!
-}
-
-type Mutation {
-  createUser(input: CreateUserInput!): User!
-  updateUser(id: ID!, input: UpdateUserInput!): User!
-  deleteUser(id: ID!): Boolean!
-}
-
-type Subscription {
-  userCreated: User!
-  userUpdated(id: ID!): User!
-}
-
-type User {
-  id: ID!
-  email: String!
-  name: String
-  posts(first: Int, after: String): PostConnection!
-  createdAt: DateTime!
-}
-
-type Post {
-  id: ID!
-  title: String!
-  author: User!
-}
-
-type UserConnection {
-  edges: [UserEdge!]!
-  pageInfo: PageInfo!
-  totalCount: Int!
-}
-
-type UserEdge {
-  cursor: String!
-  node: User!
-}
-
-type PageInfo {
-  hasNextPage: Boolean!
-  hasPreviousPage: Boolean!
-  startCursor: String
-  endCursor: String
-}
-
-input CreateUserInput {
-  email: String!
-  name: String
-  password: String!
-}
-
-input UpdateUserInput {
-  name: String
-  email: String
-}
-
-scalar DateTime
-```
-
-## Query Controller
-
-```java
-@Controller
-public class UserGraphQLController {
-
-    private final UserService userService;
-
-    @QueryMapping
-    public User user(@Argument UUID id) {
-        return userService.findById(id)
-            .orElse(null);
-    }
-
-    @QueryMapping
-    public Connection<User> users(
-            @Argument int page,
-            @Argument int size) {
-        Page<User> userPage = userService.findAll(PageRequest.of(page, size));
-        return toConnection(userPage);
-    }
-
-    @QueryMapping
-    public List<User> searchUsers(@Argument String query) {
-        return userService.search(query);
-    }
-
-    // Nested field resolver
-    @SchemaMapping(typeName = "User", field = "posts")
-    public Connection<Post> posts(
-            User user,
-            @Argument Integer first,
-            @Argument String after) {
-        return postService.findByAuthorId(user.getId(), first, after);
-    }
-}
-```
-
-## Mutation Controller
-
-```java
-@Controller
-public class UserMutationController {
-
-    private final UserService userService;
-    private final ApplicationEventPublisher eventPublisher;
-
-    @MutationMapping
-    public User createUser(@Argument("input") @Valid CreateUserInput input) {
-        User user = userService.create(input);
-        eventPublisher.publishEvent(new UserCreatedEvent(user));
-        return user;
-    }
-
-    @MutationMapping
-    public User updateUser(
-            @Argument UUID id,
-            @Argument("input") @Valid UpdateUserInput input) {
-        return userService.update(id, input);
-    }
-
-    @MutationMapping
-    public boolean deleteUser(@Argument UUID id) {
-        userService.delete(id);
-        return true;
-    }
-}
-```
-
-## Subscription Controller
-
-```java
-@Controller
-public class UserSubscriptionController {
-
-    private final Sinks.Many<User> userCreatedSink =
-        Sinks.many().multicast().onBackpressureBuffer();
-
-    @SubscriptionMapping
-    public Flux<User> userCreated() {
-        return userCreatedSink.asFlux();
-    }
-
-    @SubscriptionMapping
-    public Flux<User> userUpdated(@Argument UUID id) {
-        return userUpdatedSink.asFlux()
-            .filter(user -> user.getId().equals(id));
-    }
-
-    @EventListener
-    public void onUserCreated(UserCreatedEvent event) {
-        userCreatedSink.tryEmitNext(event.getUser());
-    }
-}
-```
-
-## DataLoader Configuration
-
-```java
-@Configuration
-public class DataLoaderConfiguration {
-
-    @Bean
-    public BatchLoaderRegistry batchLoaderRegistry(
-            UserRepository userRepository,
-            PostRepository postRepository) {
-
-        return BatchLoaderRegistry.create()
-            .registerMappedBatchLoader(
-                "usersById",
-                (Set<UUID> ids, BatchLoaderEnvironment env) ->
-                    Mono.fromCallable(() ->
-                        userRepository.findAllById(ids).stream()
-                            .collect(Collectors.toMap(User::getId, Function.identity()))
-                    )
-            )
-            .registerMappedBatchLoader(
-                "postsByAuthorId",
-                (Set<UUID> authorIds, BatchLoaderEnvironment env) ->
-                    Mono.fromCallable(() ->
-                        postRepository.findByAuthorIdIn(authorIds).stream()
-                            .collect(Collectors.groupingBy(Post::getAuthorId))
-                    )
-            );
-    }
-}
-
-// Using DataLoader in resolver
-@Controller
-public class PostGraphQLController {
-
-    @SchemaMapping(typeName = "Post", field = "author")
-    public CompletableFuture<User> author(
-            Post post,
-            DataLoader<UUID, User> usersById) {
-        return usersById.load(post.getAuthorId());
-    }
-}
-```
-
-## Custom Scalar
-
-```java
-@Configuration
-public class ScalarConfiguration {
-
-    @Bean
-    public RuntimeWiringConfigurer runtimeWiringConfigurer() {
-        return wiringBuilder -> wiringBuilder
-            .scalar(ExtendedScalars.DateTime)
-            .scalar(ExtendedScalars.UUID)
-            .scalar(ExtendedScalars.JSON);
-    }
-}
-```
-
-## Exception Handling
-
-```java
-@ControllerAdvice
-public class GraphQLExceptionHandler {
-
-    @GraphQlExceptionHandler
-    public GraphQLError handleNotFoundException(ResourceNotFoundException ex) {
-        return GraphQLError.newError()
-            .errorType(ErrorType.NOT_FOUND)
-            .message(ex.getMessage())
-            .build();
-    }
-
-    @GraphQlExceptionHandler
-    public GraphQLError handleValidation(ConstraintViolationException ex) {
-        return GraphQLError.newError()
-            .errorType(ErrorType.BAD_REQUEST)
-            .message("Validation failed")
-            .extensions(Map.of(
-                "errors", ex.getConstraintViolations().stream()
-                    .map(cv -> Map.of(
-                        "field", cv.getPropertyPath().toString(),
-                        "message", cv.getMessage()
-                    ))
-                    .toList()
-            ))
-            .build();
-    }
-}
-```
-
-## Query Complexity
-
-```java
-@Configuration
-public class GraphQLSecurityConfiguration {
-
-    @Bean
-    public Instrumentation maxQueryDepthInstrumentation() {
-        return new MaxQueryDepthInstrumentation(10);
-    }
-
-    @Bean
-    public Instrumentation maxQueryComplexityInstrumentation() {
-        return new MaxQueryComplexityInstrumentation(200);
-    }
-}
-```
-
-## Authorization
-
-```java
-@Controller
-public class SecuredGraphQLController {
-
-    @QueryMapping
-    @PreAuthorize("hasRole('USER')")
-    public User me(@AuthenticationPrincipal UserDetails user) {
-        return userService.findByEmail(user.getUsername())
-            .orElseThrow();
-    }
-
-    @MutationMapping
-    @PreAuthorize("hasRole('ADMIN')")
-    public boolean deleteUser(@Argument UUID id) {
-        userService.delete(id);
-        return true;
-    }
-
-    // Field-level authorization
-    @SchemaMapping(typeName = "User", field = "email")
-    @PreAuthorize("hasRole('ADMIN') or #user.id == authentication.principal.id")
-    public String email(User user) {
-        return user.getEmail();
-    }
-}
-```
-
-## Testing
-
-```java
-@GraphQlTest(UserGraphQLController.class)
-class UserGraphQLControllerTest {
-
-    @Autowired
-    private GraphQlTester graphQlTester;
-
-    @MockBean
-    private UserService userService;
-
-    @Test
-    void shouldGetUser() {
-        User user = new User(UUID.randomUUID(), "test@example.com", "Test");
-        when(userService.findById(user.getId())).thenReturn(Optional.of(user));
-
-        graphQlTester.documentName("getUser")
-            .variable("id", user.getId())
-            .execute()
-            .path("user.email").entity(String.class).isEqualTo("test@example.com")
-            .path("user.name").entity(String.class).isEqualTo("Test");
-    }
-
-    @Test
-    void shouldCreateUser() {
-        graphQlTester.document("""
-                mutation CreateUser($input: CreateUserInput!) {
-                  createUser(input: $input) {
-                    id
-                    email
-                  }
-                }
-                """)
-            .variable("input", Map.of(
-                "email", "new@example.com",
-                "name", "New User",
-                "password", "SecurePass123"
-            ))
-            .execute()
-            .path("createUser.email").entity(String.class).isEqualTo("new@example.com");
-    }
-}
-```
-
-## Related Skills
-
-- `graphql-concepts`: GraphQL concepts
-- `spring-boot-4`: Spring Boot 4.0 patterns
-- `apigen-architecture`: Overall system architecture
-
-

package/ai-config/skills/backend/grpc-concepts/SKILL.md

@@ -1,283 +0,0 @@
----
-name: grpc-concepts
-description: >
-  gRPC concepts. Protocol Buffers, service definitions, streaming, error handling.
-  Trigger: gRPC, protobuf, Protocol Buffers, RPC, streaming, service definition
-tools:
-  - Read
-  - Write
-  - Edit
-  - Grep
-metadata:
-  author: apigen-team
-  version: "1.0"
-  tags: [grpc, protobuf, rpc, microservices]
-  scope: ["**/grpc/**"]
----
-
-# gRPC Concepts
-
-## What is gRPC?
-
-```
-gRPC = Google Remote Procedure Call
-
-Features:
-- Binary protocol (Protocol Buffers)
-- HTTP/2 transport
-- Bi-directional streaming
-- Language agnostic
-- Strong typing
-
-Use cases:
-- Microservices communication
-- Real-time data streaming
-- Mobile-backend communication
-- IoT device communication
-```
-
-## Protocol Buffers (Protobuf)
-
-### Message Definition
-```protobuf
-syntax = "proto3";
-
-package com.example.user;
-
-option java_package = "com.example.user.proto";
-option java_multiple_files = true;
-
-message User {
-  string id = 1;
-  string email = 2;
-  string name = 3;
-  UserStatus status = 4;
-  google.protobuf.Timestamp created_at = 5;
-  repeated Role roles = 6;
-  optional string phone = 7;  // proto3 optional
-}
-
-enum UserStatus {
-  USER_STATUS_UNSPECIFIED = 0;
-  USER_STATUS_ACTIVE = 1;
-  USER_STATUS_INACTIVE = 2;
-  USER_STATUS_SUSPENDED = 3;
-}
-
-message Role {
-  string id = 1;
-  string name = 2;
-}
-```
-
-### Field Numbers
-```
-Rules:
-- 1-15: Single byte encoding (use for frequent fields)
-- 16-2047: Two byte encoding
-- 19000-19999: Reserved by protobuf
-- Once assigned, never change
-
-Best practices:
-- Reserve removed field numbers
-- Document field number allocations
-```
-
-## Service Definition
-
-```protobuf
-service UserService {
-  // Unary RPC
-  rpc GetUser(GetUserRequest) returns (User);
-
-  // Server streaming
-  rpc ListUsers(ListUsersRequest) returns (stream User);
-
-  // Client streaming
-  rpc CreateUsers(stream CreateUserRequest) returns (BatchCreateResponse);
-
-  // Bi-directional streaming
-  rpc Chat(stream ChatMessage) returns (stream ChatMessage);
-}
-
-message GetUserRequest {
-  string user_id = 1;
-}
-
-message ListUsersRequest {
-  int32 page_size = 1;
-  string page_token = 2;
-  UserFilter filter = 3;
-}
-
-message UserFilter {
-  optional UserStatus status = 1;
-  optional string email_contains = 2;
-}
-```
-
-## RPC Types
-
-### Unary RPC
-```
-Client sends single request, server returns single response
-
-Client ──request──> Server
-Client <──response── Server
-
-Use for: CRUD operations, simple queries
-```
-
-### Server Streaming
-```
-Client sends single request, server returns stream of responses
-
-Client ──request──> Server
-Client <──response1── Server
-Client <──response2── Server
-Client <──response3── Server
-
-Use for: Large result sets, real-time updates
-```
-
-### Client Streaming
-```
-Client sends stream of requests, server returns single response
-
-Client ──request1──> Server
-Client ──request2──>
-Client ──request3──>
-Client <──response── Server
-
-Use for: File uploads, batch operations
-```
-
-### Bi-directional Streaming
-```
-Both client and server send streams
-
-Client ──request1──> Server
-Client <──response1──
-Client ──request2──>
-Client <──response2──
-
-Use for: Chat, real-time collaboration
-```
-
-## Error Handling
-
-### Status Codes
-```
-OK (0): Success
-CANCELLED (1): Operation cancelled
-UNKNOWN (2): Unknown error
-INVALID_ARGUMENT (3): Client error
-DEADLINE_EXCEEDED (4): Timeout
-NOT_FOUND (5): Resource not found
-ALREADY_EXISTS (6): Duplicate
-PERMISSION_DENIED (7): Authorization failed
-UNAUTHENTICATED (16): Authentication required
-RESOURCE_EXHAUSTED (8): Rate limited
-FAILED_PRECONDITION (9): State conflict
-ABORTED (10): Concurrency conflict
-OUT_OF_RANGE (11): Invalid range
-UNIMPLEMENTED (12): Not implemented
-INTERNAL (13): Server error
-UNAVAILABLE (14): Service unavailable
-DATA_LOSS (15): Unrecoverable data loss
-```
-
-### Rich Error Details
-```protobuf
-import "google/rpc/error_details.proto";
-
-// Error with field violations
-google.rpc.BadRequest bad_request = {
-  field_violations: [
-    {field: "email", description: "Invalid email format"},
-    {field: "password", description: "Too short"}
-  ]
-};
-
-// Error with retry info
-google.rpc.RetryInfo retry_info = {
-  retry_delay: {seconds: 30}
-};
-```
-
-## Metadata
-
-```
-Headers sent with requests:
-
-Standard metadata:
-- :authority (host)
-- :path (method)
-- content-type
-- user-agent
-- grpc-timeout
-
-Custom metadata:
-- authorization: Bearer token
-- x-request-id: correlation ID
-- x-tenant-id: multi-tenancy
-```
-
-## Interceptors
-
-```
-Client-side:
-1. Add authentication token
-2. Log request/response
-3. Handle errors
-4. Add tracing context
-
-Server-side:
-1. Validate authentication
-2. Rate limiting
-3. Log request/response
-4. Extract tracing context
-```
-
-## Best Practices
-
-```
-Proto design:
-✅ Use descriptive field names
-✅ Reserve deprecated field numbers
-✅ Use well-known types (Timestamp, Duration)
-✅ Define enums with UNSPECIFIED = 0
-✅ Use optional for nullable fields
-
-Performance:
-✅ Reuse channels/stubs
-✅ Use streaming for large data
-✅ Set appropriate deadlines
-✅ Enable compression
-
-Versioning:
-✅ Add fields (backward compatible)
-❌ Remove/rename fields
-❌ Change field types
-❌ Change field numbers
-```
-
-## gRPC vs REST
-
-```
-| Aspect | gRPC | REST |
-|--------|------|------|
-| Protocol | HTTP/2 | HTTP/1.1 or 2 |
-| Format | Binary (Protobuf) | Text (JSON) |
-| Contract | Strong (.proto) | Weak (OpenAPI) |
-| Streaming | Native | Limited |
-| Browser | Needs grpc-web | Native |
-| Tools | Limited | Extensive |
-```
-
-## Related Skills
-
-- `grpc-spring`: Spring Boot gRPC implementation
-- `apigen-architecture`: Overall system architecture
-
-