fix: address all PR review comments — CHANGELOG accuracy, test alignment

- CHANGELOG.md: Fix handlerReady description to say "omitted = unverified/unknown"
  instead of "default false" to match actual .optional() schema semantics
- CHANGELOG.md: Remove references to notImplemented() and serviceUnavailable()
  helpers that were removed in 5bf1696, keep only routeNotFound()
- http-dispatcher.root.test.ts: Update POST-to-root test to expect semantic 404
  (ROUTE_NOT_FOUND with handled: true) instead of handled: false, matching the
  new dispatch fallback behavior

Agent-Logs-Url: https://github.com/objectstack-ai/spec/sessions/284f8784-d253-4a1a-85f4-bcc2fda55523

Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>

Author: Copilot

CHANGELOG.md

@@ -10,8 +10,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - **Discovery Schema — `ServiceStatus` enum & `handlerReady` field** — Added `'registered'`
   status to `ServiceInfoSchema` to distinguish routes that are declared in the dispatcher
-  table but whose HTTP handler has not been verified. Added `handlerReady` boolean field
-  (default `false`) so clients can filter handler-ready services before displaying endpoints.
+  table but whose HTTP handler has not been verified. Added optional `handlerReady` boolean
+  field (omitted = unverified/unknown) so clients can filter handler-ready services before
+  displaying endpoints when the value is explicitly `true`.
 - **Discovery Schema — `RouteHealthReportSchema`** — New schema for automated route/handler
   coverage reporting at startup. Includes per-route health entries (`pass`, `fail`, `missing`,
   `skip`) and summary counters.
@@ -54,8 +55,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - **Runtime Dispatcher — semantic error differentiation** — `HttpDispatcher.dispatch()` now
   returns typed 404 (`ROUTE_NOT_FOUND`) with diagnostic info instead of bare `{ handled: false }`.
-  Added `notImplemented()` (501), `serviceUnavailable()` (503), and `routeNotFound()` (404)
-  helper methods.
+  Added `routeNotFound()` (404) helper method.
 - **Runtime Dispatcher — `/health` handler** — Added health endpoint returning `status`,
   `timestamp`, `version`, and `uptime`.
 - **Runtime Dispatcher — `handlerReady` in discovery** — `getDiscoveryInfo()` now emits

packages/runtime/src/http-dispatcher.root.test.ts

@@ -61,13 +61,16 @@ describe('HttpDispatcher Root Handling', () => {
         expect(data.routes).toBeDefined();
     });
 
-    it('should NOT handle POST request to root path ("")', async () => {
+    it('should return semantic 404 for POST request to root path ("")', async () => {
         const context = { request: {} };
         const method = 'POST';
         const path = '';
 
         const result = await dispatcher.dispatch(method, path, {}, {}, context);
 
-        expect(result.handled).toBe(false);
+        // The dispatcher now returns a typed 404 (ROUTE_NOT_FOUND) instead of { handled: false }
+        expect(result.handled).toBe(true);
+        expect(result.response?.status).toBe(404);
+        expect(result.response?.body?.error?.type).toBe('ROUTE_NOT_FOUND');
     });
 });