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

1.4 KiB

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

  • rg "src\.app_server\." has no runtime/code matches (tests excluded or updated).
  • CLI/runtime startup paths import from interfaces.* only.
  • WebSocket entrypoint imports resolve through interfaces.ws.*.

Behavior parity checks

  • HTTP gateway smoke tests pass (/health, /inbound, /gateway/method, /ws handshake).
  • WS request/response contract remains unchanged for:
    • connect
    • chat.send/chat.history/chat.abort
    • sessions.*
    • agent.run/agent.wait
  • Plugin bootstrap still loads expected extension set.

Prompt/skill checks

  • Runtime role context now loads from oclaw/runtime/workspaces/*.
  • Skill root priority still effective:
    • AIA_SKILLS_ROOT
    • oclaw/skills(仓库根)
    • oclaw/runtime/skills(旧路径回退)

Extension policy checks

  • Primary extension source remains oclaw/extensions/.
  • Legacy root extensions/ has been fully merged and removed.
  • Duplicate plugin-id diagnostics still emitted as expected.

Final cleanup

  • Delete compatibility files under oclaw/app_server/* only after all checks are green.
  • Remove stale docs/comments referring to old primary entrypoints.
  • Re-run lint and targeted compile checks after deletion.