Files

airlongdian e2fd375a1c feat: 品牌替换 + 启动优化 + AGENTS.md 模板定制

- 品牌替换：OpenCode/opencode → AirCoding/aircoding（16+ 文件）
- Logo ASCII art：修复 left/right 行数不匹配导致的启动崩溃
- 启动诊断：添加 OPENCODE_PRINT_TIMING 计时探针
- dev 模式默认 --pure 跳过外部插件加载
- AGENTS.md 模板：追加 AirCoding 多 Agent 专项段落
- architect prompt + plugin：强化 AGENTS.md 产出验证

2026-06-14 09:31:29 +08:00

2.1 KiB

Raw Blame History

Server Package Extraction

Practical reference for a future packages/server split after the opencode server moved to the Effect HttpApi backend.

Current State

The server still lives in packages/opencode.
The runtime and app layer are centralized in src/effect/app-runtime.ts and src/effect/run-service.ts.
The route tree lives under src/server/routes/instance/httpapi and is hosted from src/server/server.ts.
OpenAPI generation is based on the HttpApi contract plus compatibility translation in src/server/routes/instance/httpapi/public.ts.
There is no standalone packages/server workspace yet.

Future State

Target package layout:

packages/core - shared domain services and schemas
packages/server - HTTP contracts, handlers, OpenAPI generation, and an embeddable server API
packages/cli - TUI and CLI entrypoints
packages/sdk - generated from the server OpenAPI spec
packages/plugin - plugin authoring surface

Extraction Rule

Do not create a package cycle.

Until enough shared service code lives outside packages/opencode, a future packages/server should either:

own pure HttpApi contracts only, or
accept host-provided services/layers/callbacks from packages/opencode

It should not import packages/opencode services while packages/opencode imports it to host routes.

Suggested PR Sequence

Keep shrinking OpenAPI compatibility shims in httpapi/public.ts.
Move stable domain schemas into shared packages only when they no longer depend on opencode-local runtime modules.
Extract pure HttpApi contract modules into packages/server once the contract can compile without importing packages/opencode implementation details.
Extract handler factories after their service dependencies can be supplied by a host layer instead of imported directly.
Move server hosting last, after package ownership is clear.

Non-Goals

Do not revive the old dual-backend migration shape.
Do not split server hosting before service dependencies have a clean package boundary.
Do not switch SDK generation to a new package until generated output is known to remain compatible.

2.1 KiB Raw Blame History