feat(core): bootstrap packages/server and document extraction plan (#22492)

packages/server/src/api/index.ts

@@ -0,0 +1 @@
+export {}

packages/server/src/definition/api.ts

@@ -0,0 +1,6 @@
+import type { ServerApi } from "../types.js"
+
+export const api: ServerApi = {
+  name: "opencode",
+  groups: [],
+}

packages/server/src/definition/index.ts

@@ -0,0 +1 @@
+export { api } from "./api.js"

packages/server/src/index.ts

@@ -0,0 +1,3 @@
+export { openapi } from "./openapi.js"
+export { api } from "./definition/api.js"
+export type { OpenApiSpec, ServerApi } from "./types.js"

packages/server/src/openapi.ts

@@ -0,0 +1,14 @@
+import { api } from "./definition/api.js"
+import type { OpenApiSpec } from "./types.js"
+
+export function openapi(): OpenApiSpec {
+  return {
+    openapi: "3.1.1",
+    info: {
+      title: api.name,
+      version: "0.0.0",
+      description: "Contract-first server package scaffold.",
+    },
+    paths: {},
+  }
+}

packages/server/src/types.ts

@@ -0,0 +1,14 @@
+export interface ServerApi {
+  readonly name: string
+  readonly groups: readonly string[]
+}
+
+export interface OpenApiSpec {
+  readonly openapi: string
+  readonly info: {
+    readonly title: string
+    readonly version: string
+    readonly description: string
+  }
+  readonly paths: Record<string, never>
+}