From 9af6653841e5b774a6bb3b347467d25ca53e27b8 Mon Sep 17 00:00:00 2001 From: mikim <1441941+mikim@users.noreply.github.com> Date: Sat, 25 Jul 2026 09:40:55 +0900 Subject: [PATCH] docs(readme): correct two claims that the code does not back MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two present-tense statements described behavior that is not implemented: - Product Philosophy #3 said "Stale and low-signal events are filtered." Time/age-based stale filtering does not exist — classify only does recent-window burst detection (countBurst / DEFAULT_BURST_THRESHOLD), and the roadmap itself lists the "stale-noise (time-based) gate" as pending. Reworded to "Low-signal noise is suppressed and true burst behavior is surfaced early" so the principle matches reality (and the roadmap). - Input Model listed "error payload and stack hints", but runtimeError in the v2 schema exposes only { type, message, status, code, retryable } with additionalProperties:false — a stack field would be rejected by validation. Dropped "and stack hints". Co-Authored-By: Claude Opus 4.8 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2f78df9..ff52eb6 100644 --- a/README.md +++ b/README.md @@ -61,7 +61,7 @@ ARK follows five strict principles: Every hard failure should include precise reason and next action. 3. **Noise suppression without blindness** - Stale and low-signal events are filtered, but true burst behavior is surfaced early. + Low-signal noise is suppressed and true burst behavior is surfaced early. 4. **Composable by design** Teams can adopt only what they need: sanitize, classify, policy, report. @@ -128,7 +128,7 @@ ARK consumes runtime events with standardized fields (see the - session and turn metadata - provider/model context - request/response envelope -- error payload and stack hints +- error payload - recent-window context for burst/noise detection ## Output Model