tinystruct-patterns

This skill provides expert guidance for developing with the tinystruct Java framework, a lightweight, high-performance framework whose core philosophy is that CLI and HTTP are equal citizens. It solves the problem of building applications that must run identically from a terminal and a web browser without a main() method and with minimal configuration. Every method annotated with @Action becomes a routable endpoint for both environments, and applications are created by extending AbstractApplication, which provides lifecycle hooks like init() and access to the per-request Context.

Concretely, the skill covers routing via the ActionRegistry, which maps path segments to method arguments; HTTP mode disambiguation using @Action with mode = Mode.HTTP_POST; native zero-dependency JSON serialization with the Builder and Builders components; and database persistence using AbstractData POJOs paired with XML mapping files, including POJO generation from tables via the generate command. It documents Server-Sent Events through SSEPushManager (push and broadcast), file uploads via FileEntity and request.getAttachments(), and outbound HTTP with URLRequest and HTTPHandler. It also details native Model Context Protocol support starting with SDK version 1.7.26, showing how to build an MCPTool with @Argument-declared parameters, register tools on an MCPServer via registerTool(), and run everything through bin/dispatcher, while warning strongly about sanitizing tool inputs to prevent prompt injection.

The skill targets Java developers working on the tinystruct codebase or projects built on it, especially those creating Application modules, defining routes and CLI actions, writing unit tests, and configuring the built-in HTTP server. Configuration is managed in src/main/resources/application.properties, covering database driver and URL, server.port, default.home.page, default.language, and session settings. It is best activated when debugging routing conflicts, parsing CLI arguments, or wiring database connections and system settings.