docs: effective configuration and dry-run validation

.github/workflows/contract.yml

@@ -0,0 +1,27 @@
+name: Contract
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+      - name: Enable Yarn Classic
+        run: |
+          corepack enable
+          corepack prepare yarn@1.22.22 --activate
+      - run: yarn install --frozen-lockfile
+      - run: yarn check:contract
+      - run: yarn exec hexo clean && yarn exec hexo generate

_config.cackle.yml

@@ -1,28 +1,46 @@
-# dae API - Cackle Theme Configuration
-
 # 侧边栏导航
 menu:
   - title: Overview
     file: index
+  - title: Discovery
+    file: docs/discovery
   - title: Version
     file: docs/version
+  - title: Capabilities
+    file: docs/capabilities
   - title: API Configuration
     file: docs/api-config
-  - title: Runtime Status
+  - title: Errors
+    file: docs/errors
+  - title: Operations
+    file: docs/operations
+  - title: Runtime
     file: docs/runtime-status
-  - title: Node Latency
+  - title: Runtime Memory
+    file: docs/runtime-memory
+  - title: Datapath
+    file: docs/datapath
+  - title: Nodes
     file: docs/node-latency
-  - title: Check Nodes
+  - title: Probes
     file: docs/check-nodes
   - title: Groups
     file: docs/groups
   - title: Connections
     file: docs/connections
+  - title: Recorded Flows
+    file: docs/flows
+  - title: Routing Simulation
+    file: docs/routing-trace
+  - title: Events
+    file: docs/events
+  - title: honk Implementation Evidence
+    file: docs/honk-mapping
   - title: DNS Query
     file: docs/dns-query
   - title: DNS Cache
     file: docs/dns-cache
-  - title: Configuration
+  - title: Configuration (Deferred)
     file: docs/configuration
   - title: Reload
     file: docs/reload
@@ -49,7 +67,7 @@ language_negotiation:
 # 品牌标识
 brand:
   logo: i-menu-book
-  text: dae API
+  text: dae/honk API
   favicon: /images/favicon.svg
 
 # 首页内容
@@ -58,23 +76,23 @@ home:
     - hero
     - features
     - versions
-  hero_badge: dae API
-  hero_title: dae API Documentation
-  hero_subtitle: REST API for dae transparent proxy
+  hero_badge: dae/honk API
+  hero_title: dae/honk Native API
+  hero_subtitle: Per-flow decisions, runtime evidence, and capability-driven control
   hero_cta: Get Started
   versions_title: Versions
   versions_subtitle: Documentation versions
   features:
     - icon: i-history
-      title: Runtime Statistics
-      desc: Monitor real-time runtime statistics
+      title: Native API
+      desc: Draft resources, operations, errors, and compatibility rules
     - icon: i-light-mode
-      title: Node Latency
-      desc: Check latency of each node
+      title: Datapath Semantics
+      desc: Keep direct, proxy, DNS, and visibility semantics explicit
     - icon: i-search
       title: DNS Cache
-      desc: Query and manage DNS cache
+      desc: Inspect, flush, and delete cache entries when the engine exposes it
 
 # 底部信息
 footer:
-  text: dae © 2026 · Built with Hexo
+  text: dae/honk © 2026 · Built with Hexo

_config.yml

@@ -33,6 +33,7 @@ category_dir: categories
 code_dir: downloads/code
 i18n_dir: :lang
 skip_render:
+  - openapi.yaml
 
 # Writing
 new_post_name: :title.md # File name of new posts