feature: add Jetty server bootstrap for license validation

Adds embedded Jetty 12 server with:
- jetty-server 12.1.5 (core only, no servlets)
- Jackson 3.0.3 for JSON processing
- SLF4J 2.0.17 for logging
- CatLicenseServer main class with Handler.Abstract
- Health endpoint at /health using Jetty Core API
- Configurable port via server-config.properties

Task ID: v2.0-license-validation-server-jetty-setup

Author: cowwoc

.claude/cat/issues/v2/v2.0/license-validation-server-jetty-setup/STATE.md

@@ -1,6 +1,9 @@
 # State
 
-- **Status:** pending
-- **Progress:** 0%
+- **Status:** completed
+- **Progress:** 100%
+- **Resolution:** implemented
 - **Dependencies:** [jwt-token-generation, tier-feature-mapping]
-- **Last Updated:** 2026-01-23
+- **Completed:** 2026-01-24 12:30
+- **Tokens Used:** ~25,000
+- **Last Updated:** 2026-01-24

.claude/rules/java-style.md

@@ -0,0 +1,13 @@
+# Java Style Conventions
+
+## String Comparisons
+
+Use `Objects.equals(variable, "literal")` instead of `"literal".equals(variable)`.
+
+```java
+// Preferred
+if (Objects.equals(path, "/health"))
+
+// Avoid
+if ("/health".equals(path))
+```

server/pom.xml

@@ -17,6 +17,9 @@
         <maven.compiler.target>21</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <testng.version>7.9.0</testng.version>
+        <jetty.version>12.1.5</jetty.version>
+        <slf4j.version>2.0.17</slf4j.version>
+        <jackson.version>3.0.3</jackson.version>
     </properties>
 
     <dependencies>
@@ -26,6 +29,24 @@
             <version>${testng.version}</version>
             <scope>test</scope>
         </dependency>
+        <!-- Jetty 12 Server (core) -->
+        <dependency>
+            <groupId>org.eclipse.jetty</groupId>
+            <artifactId>jetty-server</artifactId>
+            <version>${jetty.version}</version>
+        </dependency>
+        <!-- JSON processing (Jackson 3.x) -->
+        <dependency>
+            <groupId>tools.jackson.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+            <version>${jackson.version}</version>
+        </dependency>
+        <!-- SLF4J for Jetty logging -->
+        <dependency>
+            <groupId>org.slf4j</groupId>
+            <artifactId>slf4j-simple</artifactId>
+            <version>${slf4j.version}</version>
+        </dependency>
     </dependencies>
 
     <build>
@@ -47,6 +68,18 @@
                 <artifactId>maven-surefire-plugin</artifactId>
                 <version>3.2.5</version>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <version>3.3.0</version>
+                <configuration>
+                    <archive>
+                        <manifest>
+                            <mainClass>io.github.cowwoc.claudecodecat.CatLicenseServer</mainClass>
+                        </manifest>
+                    </archive>
+                </configuration>
+            </plugin>
         </plugins>
     </build>
 </project>

server/src/main/java/io/github/cowwoc/claudecodecat/CatLicenseServer.java

@@ -0,0 +1,151 @@
+package io.github.cowwoc.claudecodecat;
+
+import org.eclipse.jetty.io.Content;
+import org.eclipse.jetty.server.Handler;
+import org.eclipse.jetty.server.Request;
+import org.eclipse.jetty.server.Response;
+import org.eclipse.jetty.server.Server;
+import org.eclipse.jetty.util.Callback;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.util.Objects;
+import java.util.Properties;
+
+/**
+ * Main entry point for the CAT License Server.
+ * Embedded Jetty server providing license validation endpoints.
+ */
+public class CatLicenseServer
+{
+    private final int port;
+    private Server server;
+
+    /**
+     * Creates a new license server instance.
+     *
+     * @param port the port to listen on
+     */
+    public CatLicenseServer(int port)
+    {
+        this.port = port;
+    }
+
+    /**
+     * Starts the server.
+     *
+     * @throws Exception if the server fails to start
+     */
+    public void start() throws Exception
+    {
+        server = new Server(port);
+
+        // Use Jetty Core Handler API for routing
+        Handler handler = new Handler.Abstract()
+        {
+            @Override
+            public boolean handle(Request request, Response response, Callback callback) throws Exception
+            {
+                String path = request.getHttpURI().getPath();
+
+                if (Objects.equals(path, "/health"))
+                {
+                    response.setStatus(200);
+                    response.getHeaders().put("Content-Type", "application/json");
+                    Content.Sink.write(response, true, "{\"status\":\"healthy\"}", callback);
+                    return true;
+                }
+
+                // Not handled - return 404
+                return false;
+            }
+        };
+
+        server.setHandler(handler);
+        server.start();
+        System.out.println("CAT License Server started on port " + port);
+    }
+
+    /**
+     * Stops the server.
+     *
+     * @throws Exception if the server fails to stop
+     */
+    public void stop() throws Exception
+    {
+        if (server != null)
+        {
+            server.stop();
+        }
+    }
+
+    /**
+     * Blocks until the server is terminated.
+     *
+     * @throws InterruptedException if interrupted while waiting
+     */
+    public void join() throws InterruptedException
+    {
+        if (server != null)
+        {
+            server.join();
+        }
+    }
+
+    /**
+     * Returns the port the server is listening on.
+     *
+     * @return the server port
+     */
+    public int getPort()
+    {
+        return port;
+    }
+
+    /**
+     * Main entry point.
+     *
+     * @param args command line arguments (unused)
+     * @throws Exception if the server fails to start
+     */
+    public static void main(String[] args) throws Exception
+    {
+        Properties props = loadConfig();
+        int port = Integer.parseInt(props.getProperty("server.port", "8080"));
+
+        CatLicenseServer server = new CatLicenseServer(port);
+        server.start();
+
+        // Add shutdown hook for graceful shutdown
+        Runtime.getRuntime().addShutdownHook(new Thread(() -> {
+            try
+            {
+                server.stop();
+            }
+            catch (Exception e)
+            {
+                e.printStackTrace();
+            }
+        }));
+
+        server.join();
+    }
+
+    private static Properties loadConfig()
+    {
+        Properties props = new Properties();
+        try (InputStream input = CatLicenseServer.class.getClassLoader()
+                .getResourceAsStream("server-config.properties"))
+        {
+            if (input != null)
+            {
+                props.load(input);
+            }
+        }
+        catch (IOException e)
+        {
+            System.err.println("Warning: Could not load server-config.properties, using defaults");
+        }
+        return props;
+    }
+}

server/src/main/resources/server-config.properties

@@ -0,0 +1,2 @@
+# CAT License Server Configuration
+server.port=8080