docs: clarify generic continuity adapter paths

This commit is contained in:
2026-04-24 19:49:45 +08:00
parent 981759c56a
commit d35fe70c21
8 changed files with 469 additions and 138 deletions

View File

@@ -1,20 +1,37 @@
# HOOK.md
This document reserves the hook adapter contract for the continuity plugin MVP.
This document defines the hook/host adapter boundary for the continuity plugin.
## Target adapter
## Target adapters
Primary MVP integration target:
Current supported adapter paths:
- `force-recall`
- `generic-preflight`
## Planned responsibilities
`force-recall` is the current primary OpenClaw integration path, but it is not the only intended host.
- derive continuity input from hook context
- invoke the plugin evaluator
## Adapter responsibilities
Adapters should:
- derive or normalize continuity input from host context
- invoke the shared continuity evaluator/engine
- return a prompt block / gate result without duplicating continuity rules
- keep host-specific parsing outside the core evaluator
## Contract boundary
The host-facing contract lives in the plugin engine and adapter exports:
- `normalizeContinuityEngineInput()`
- `createContinuityEngineContract()`
- `runForceRecallContinuityAdapter()`
- `runGenericPreflightContinuityAdapter()`
- `runManualContinuityPreflight()`
## Current status
- contract placeholder only
- implementation deferred to later plan tasks
- `force-recall` adapter: implemented and parity-oriented
- `generic-preflight` adapter: implemented for host-agnostic/manual preflight integration
- full installer/registry integration: intentionally out of scope for this package