website: generate the API reference from source (cordis + all 15 harness services)

scripts/gen-website-api.ts renders website/zh-CN/api/{cordis,harness}/* and the
api-sidebar.json fragment the VitePress config imports, so pages and navigation
can never drift from the code: signatures, @param/@returns prose, dispatch
modes, and GitHub source links are extracted, never transcribed, and the
generator hard-errors on any rendered member missing docs. verify-website-api
(doc-sync + run-gates) is the freshness gate.

Replaces the hand-written zh api pages (7 pages covering 7 of 15 services,
with phantom APIs: Context.current/Context.events, agent/post-step, tool/call,
compact/*, llm/pre-request none of which exist) with generated English
references: 5 cordis pages, 15 per-service pages, and a 35-event catalog
grouped by scope. The hand-written hub api/index.md stays and now indexes the
full surface; zh for these pages arrives with the unified translation flow.

website/zh-CN/api/cordis/context.md

@@ -1,85 +1,192 @@
+<!-- Generated by scripts/gen-website-api.ts — do not edit by hand. Run `pnpm run gen-website-api` to regenerate. -->
+
 # Context
 
-上下文对象是 Cordis 的核心。所有服务、方法、属性都通过 `ctx` 访问。
+The context is the core cordis object: every service, event, and lifecycle API is reached through `ctx`. Event methods (`ctx.on`, `ctx.emit`, …) are documented on [Events](./events.md); `ctx.effect` and `ctx.fiber` on [Fiber](./fiber.md); `ctx.plugin` and `ctx.inject` on [Registry](./registry.md).
 
-## 服务与混入
+Root and child dependency containers for Cordis plugins.
+A context is a proxy: normal property reads go through the service resolver, while `extend()`, `isolate()`, and `intercept()` create scoped child contexts without mutating their parent.
 
-Context 基于组合式 API 设计，大部分属性和方法挂载在服务上。以下是核心 API：
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L42)
 
-- [`ctx.on`](./events#ctx-on) — 注册事件监听器
-- [`ctx.emit`](./events#ctx-emit) — 触发事件
-- [`ctx.bail`](./events#ctx-bail) — 短路事件
-- [`ctx.serial`](./events#ctx-serial) — 顺序异步事件
-- [`ctx.waterfall`](./events#ctx-waterfall) — 管道事件
-- [`ctx.effect`](./fiber#fiber-effect) — 注册可逆效果
-- [`ctx.plugin`](./registry#ctx-plugin) — 加载子插件
-- [`ctx.inject`](./registry#ctx-inject) — 获取依赖的插件
-- [`ctx.get`](#ctx-get) — 获取服务
-- [`ctx.set`](#ctx-set) — 设置服务
-- [`ctx.provide`](#ctx-provide) — 声明服务
+### ctx.extend(meta?)
 
-## 实例属性
+```ts website-api
+extend(meta = {}): this
+```
 
-### ctx.fiber
+Create a child context with extra metadata on top of the current scope.
+The child prototypally inherits every property of this context; own properties of `meta` shadow the inherited ones. The parent is not mutated.
 
-- **类型:** [`Fiber`](./fiber)
+- `meta` — own properties (including symbol keys) to define on the child.
 
-当前上下文的作用域对象。
+**Returns** a child context inheriting from this one.
 
-## 实例方法
-
-### ctx.extend(meta)
-
-- **meta:** `object`
-- **返回值:** `Context`
-
-构造一个以当前上下文为原型的新上下文实例。
-
-### ctx.intercept(name, config)
-
-- **name:** `string` 服务名称
-- **config:** `object` 配置拦截
-- **返回值:** `Context`
-
-为指定服务添加一层配置拦截，返回新的上下文实例。
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L99)
 
 ### ctx.isolate(name, label?)
 
-- **name:** `string` 服务名称
-- **label:** `symbol` 隔离域符号（可选）
-- **返回值:** `Context`
+```ts website-api
+isolate(name: string, label?: symbol)
+```
 
-创建一个针对指定服务的隔离域，返回新的上下文实例。隔离域中的同名服务互不影响。
+Create a child context with an independent service scope for `name`.
+Below the returned context, reads and writes of the service `name` resolve against the new label instead of the parent's, so a different implementation can be provided without affecting the parent scope. Passing the same `label` to two `isolate()` calls joins their scopes.
 
-### ctx.get(name)
+- `name` — the service name to isolate.
+- `label` — scope label to join; defaults to a fresh unique symbol.
 
-- **name:** `string` 服务名称
-- **返回值:** `Service | undefined`
+**Returns** a child context whose `name` service resolves in the new scope.
 
-获取指定名称的服务实例。
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L121)
+
+### ctx.intercept(name, config)
+
+```ts website-api
+intercept<K extends InjectKey>(name: K, config: Context[K] extends { [symbols.config]: infer T } ? T : never): this
+intercept(name: string, config: any): this
+```
+
+Add service-specific intercept config for plugins started below this context.
+Plugins loaded under the returned context see `config` merged into the service's resolved config (ancestor entries first; see `Service[symbols.resolveConfig]`). The parent context is not affected.
+
+- `name` — the service name whose config to intercept.
+- `config` — the intercept config to merge for that service.
+
+**Returns** a child context carrying the additional intercept entry.
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L139)
+
+## Static members
+
+### Context.effect
+
+```ts website-api
+static readonly effect: unique symbol
+```
+
+Symbol key under which a disposer exposes its EffectMeta diagnostics tree.
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L44)
+
+### Context.filter
+
+```ts website-api
+static readonly filter: unique symbol
+```
+
+Symbol key for a context's listener filter, consulted on every event dispatch.
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L46)
+
+### Context.isolate
+
+```ts website-api
+static readonly isolate: unique symbol
+```
+
+Symbol key of the isolation map (see the `Context[symbols.isolate]` property).
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L48)
+
+### Context.intercept
+
+```ts website-api
+static readonly intercept: unique symbol
+```
+
+Symbol key of the intercept map (see the `Context[symbols.intercept]` property).
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L50)
+
+### Context.is(value)
+
+```ts website-api
+static is(value: any): value is Context
+```
+
+Returns true for Cordis context proxies and context prototypes.
+Works across realms and across multiple copies of cordis, because the brand is keyed by a global symbol rather than by `instanceof`.
+
+- `value` — the value to test.
+
+**Returns** `true` if `value` is a Cordis context, narrowing its type.
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/context.ts#L61)
+
+### ctx.get(name, strict?)
+
+```ts website-api
+get<K extends string & keyof this>(name: K, strict?: boolean): undefined | this[K]
+get(name: string, strict?: boolean): any
+```
+
+Read a service from the store without the inject requirement.
+
+- `name` — the service name.
+- `strict` — when `true` (default), only return implementations whose providing fiber is currently active.
+
+**Returns** the service value, or `undefined` when not (yet) provided.
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/reflect.ts#L16)
 
 ### ctx.set(name, value)
 
-- **name:** `string` 服务名称
-- **value:** `any` 服务值
+```ts website-api
+set<K extends string & keyof this>(name: K, value: undefined | this[K]): void
+set(name: string, value: any): void
+```
 
-设置指定名称的服务。
+Overwrite a provided service's value.
+Only the fiber that provided the service may set it; setting an unprovided name throws.
 
-### ctx.provide(name, value?, options?)
+- `name` — the service name.
+- `value` — the new service value.
 
-- **name:** `string` 服务名称
-- **value:** `any` 初始值（可选）
-- **options:** `object`
-- **返回值:** `void`
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/reflect.ts#L28)
 
-声明一个服务。声明后其他插件可以通过 `inject` 依赖它。
+### ctx.provide(name, value)
 
-## 静态属性
+```ts website-api
+provide<K extends string & keyof this>(name: K, value: undefined | this[K]): () => void
+provide(name: string, value?: any): () => void
+```
 
-### Context.events
+Register a service implementation owned by the current fiber.
+The service becomes visible to dependents in the same isolation scope once the fiber is active; it is unregistered (waking dependents) when the returned disposer runs or the fiber unloads. Throws if the name is already provided in this scope or declared as an accessor.
 
-内置事件服务的 symbol key。
+- `name` — the service name.
+- `value` — the service value.
 
-### Context.current
+**Returns** a disposer that unregisters the service.
 
-当前活跃的 Context 实例（在异步链中通过 AsyncLocalStorage 追踪）。
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/reflect.ts#L43)
+
+### ctx.accessor(name, options)
+
+```ts website-api
+accessor(name: string, options: Omit<Property.Accessor, 'type'>): void
+```
+
+Define a computed context property backed by get/set hooks.
+The accessor is removed when the current fiber unloads. Throws if the name is already declared.
+
+- `name` — the context property name.
+- `options` — the `get` hook and optional `set` hook.
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/reflect.ts#L55)
+
+### ctx.mixin(name, mixins)
+
+```ts website-api
+mixin<K extends string & keyof this>(name: K, mixins: (keyof this & keyof this[K])[] | Dict<string>): void
+mixin<T extends {}>(source: T, mixins: (keyof this & keyof T)[] | Dict<string>): void
+```
+
+Expose selected members of a service directly on `ctx`.
+Each mixed-in key becomes an accessor that forwards to the service (binding methods to it), so e.g. `ctx.on` forwards to `ctx.events.on`. Mixins are removed when the current fiber unloads.
+
+- `name` — the context property holding the source service.
+- `mixins` — keys to forward, or a source-key → ctx-key map.
+
+[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/vendor/cordis/src/reflect.ts#L66)