Skip to content

release-acceptance.md

Latest commit

 

History

History
134 lines (87 loc) · 3.67 KB

release-acceptance.md

File metadata and controls

134 lines (87 loc) · 3.67 KB
Raw

Release Acceptance

This document defines the publication gate for the public V2 package.

Pass this matrix before publishing to GitHub release ZIP, ClawHub-style catalog, npm tarball, or any mirrored package feed.

Scope

This matrix validates the public package:

  • shared skill
  • package docs / install flow

It does not require mutating any live host memory or production session history.

Test boundaries

  • Prefer sandbox / harness runs first.
  • Use host smoke checks only after sandbox passes.
  • Do not use 60-second live heartbeat or short continuous polling on production hosts.
  • Do not leave test carryover or test memory in a live user workspace.

Required matrix

1. Language neutrality

Run at least:

  • zh-TW onboarding + zh-TW follow-up flow
  • English onboarding + English follow-up flow

Pass if:

  • the package follows the current user language naturally
  • locale is not forced to English when the host does not provide a locale
  • internal prompt fragments do not leak into frontstage text
  • ordinary user phrases are not rewritten into mixed-language artifacts

2. Timezone / offset neutrality

Run at least:

  • explicit IANA timezone: Europe/Berlin
  • generic offset: UTC+0 or GMT+0

Pass if:

  • explicit IANA timezone is preserved as given
  • generic offset is stored as a generic fixed offset such as UTC+00:00
  • generic offsets are not silently converted into a city timezone
  • natural-language place names are not silently inferred unless the host config supplies an explicit mapping

3. Deterministic onboarding writeback

Run at least one onboarding case per primary language path.

Pass if these fields are written without relying on model-only classification:

  • timezone
  • sleep_time
  • wake_time
  • relationship
  • use_case

And written destinations are correct:

  • settings.json
  • profile.json
  • USER.md

4. Deterministic guided settings writeback

Run at least:

  • proactive on/off
  • proactive cadence
  • quiet hours
  • retry-after cadence
  • stop-after unanswered count

Pass if the package writes the intended structured settings and does not depend on a host-specific hidden prompt to make the change real.

5. /new continuity

Run both:

  • /new or equivalent new-session path
  • post-new bare hi / 嗨

Pass if:

  • the opener reattaches to a real continuity source
  • a bare greeting after /new stays thread-led or neutral
  • the reply does not collapse into generic time-of-day chatter
  • time may support the same thread, but time does not replace the thread

6. Frontstage cleanliness

Pass if the user-visible path does not leak:

  • heartbeat narration
  • runtime-context blocks
  • carryover/internal control text
  • structured-state labels
  • mixed-language contamination created by the package itself

7. Host/adapter boundary

If a host adapter is used for live delivery, validate it separately from the portable skill package.

Pass if:

  • the host adapter does not force a host language by default
  • the host adapter forwards time_modifier_prompt and low-information continuity guard when applicable
  • the host adapter does not re-send internal runtime text after the skill/tool-layer guard

Minimum release evidence

Ship with:

  • one sandbox report covering routing / writeback / /new
  • one neutrality report covering language and timezone/offset checks
  • one host/adapter boundary note if live channel delivery is demonstrated

Fail policy

Do not publish if any of these fail:

  • host language is silently forced by the public package
  • generic timezone offset is silently rewritten into a city timezone
  • /new misanchors or bare hi / 嗨 drops the thread
  • heartbeat or internal runtime text reaches the user-visible reply