oclaw/docs/OCLAW_COMPAT_REMOVAL_CHECKLIST.md
oliver 420abac9f1 refactor: root-package imports (svc/runtime/interfaces) and fix PYTHONPATH
- Rename platform/ to svc/ to avoid shadowing stdlib platform.
- Replace from oclaw.* with from svc/runtime/interfaces; update -m CLI paths.
- tests/conftest: prepend repo root to sys.path (no parent-folder package name).
- CI: paths and offline_eval script under repo root.
- Ops scripts: PYTHONPATH must be repo root for python -m runtime.* (fixes gateway/WhatsApp sidecar startup).
- Fix default oclaw.json path in tabular/file attachment limits; stabilize attachment test config.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-13 14:51:17 +08:00

35 lines
1.4 KiB
Markdown

# OCLAW Compat Layer Removal Checklist
Use this checklist to verify readiness and post-delete safety for `oclaw/app_server/*` compatibility-module removal.
## Import graph checks
- [x] `rg "src\.app_server\."` has no runtime/code matches (tests excluded or updated).
- [x] CLI/runtime startup paths import from `interfaces.*` only.
- [x] WebSocket entrypoint imports resolve through `interfaces.ws.*`.
## Behavior parity checks
- [x] HTTP gateway smoke tests pass (`/health`, `/inbound`, `/gateway/method`, `/ws` handshake).
- [x] WS request/response contract remains unchanged for:
- [x] `connect`
- [x] `chat.send/chat.history/chat.abort`
- [x] `sessions.*`
- [x] `agent.run/agent.wait`
- [x] Plugin bootstrap still loads expected extension set.
## Prompt/skill checks
- [x] Runtime role context now loads from `oclaw/runtime/workspaces/*`.
- [x] Skill root priority still effective:
- [x] `AIA_SKILLS_ROOT`
- [x] `oclaw/skills`(仓库根)
- [x] `oclaw/runtime/skills`(旧路径回退)
## Extension policy checks
- [x] Primary extension source remains `oclaw/extensions/`.
- [x] Legacy root `extensions/` has been fully merged and removed.
- [x] Duplicate plugin-id diagnostics still emitted as expected.
## Final cleanup
- [x] Delete compatibility files under `oclaw/app_server/*` only after all checks are green.
- [x] Remove stale docs/comments referring to old primary entrypoints.
- [x] Re-run lint and targeted compile checks after deletion.