xworkmate-app/docs
Haitao Pan 830759313f docs(cases/06): definitive 4-layer chain incl. multi-session plugin + live verification
Rewrites the timeline (§1) and topology (§2) as the correct FOUR-layer chain
App → bridge → openclaw-multi-session-plugins → OpenClaw gateway, and documents the
plugin's multi-session/multi-thread role: session mapping (appThreadKey⇄openclawSessionKey),
per-(session,run) artifactScope = tasks/<sanitize(sessionKey)>/<runId>, the strict
sessionKey/runId/artifactScope triplet validation, and the expectedArtifactDirs
workspace-root fallback scan.

Live-verified against 127.0.0.1:8787 (plugin loaded, commit 2333c3e):
- session.prepare returns a real mapping; chat.send returns runId; xworkmate.tasks.get
  is handled by the plugin but returns no_native_task_record with an empty task scope
  (chain reaches the plugin layer; the agent run produced no queryable task / no file —
  a layer-4 execution/landing issue).

Adds §7 stability improvements grounded in this live run:
- S0 install the plugin from a stable path (not /private/tmp) — the primary reliability fix.
- S1 expectedArtifactDirs was [] → the plugin's workspace-root fallback is inert; bridge
  should always pass default dirs (reports/, artifacts/).
- S2 no_native_task_record status ambiguity (running vs completed-without-artifact).
- S3 sessionKey/runId/artifactScope triplet consistency (don't pre-prefix agent:main:).
- S4 runtime observability across all four layers.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-26 23:18:04 +08:00
..
ai-context fix: align OpenClaw task key flow 2026-06-06 13:56:03 +08:00
architecture fix: prioritize managed bridge sync state 2026-06-16 06:20:13 +08:00
cases docs(cases/06): definitive 4-layer chain incl. multi-session plugin + live verification 2026-06-26 23:18:04 +08:00
codex-integration chore: retire rust ffi scaffold 2026-06-06 12:00:13 +08:00
compliance/dsa-trader-identity chore: add ios release verification assets 2026-05-25 08:54:48 +08:00
feature Fix gateway routing when provider catalog is empty 2026-04-16 13:54:33 +08:00
howto Refactor bridge runtime routing 2026-04-21 16:28:26 +08:00
plans chore: retire rust ffi scaffold 2026-06-06 12:00:13 +08:00
quality docs: consolidate core integration cases 2026-04-05 18:24:10 +08:00
releases Release v1.1.3 2026-05-27 15:10:07 +08:00
reports chore: retire rust ffi scaffold 2026-06-06 12:00:13 +08:00
runbooks Remove managed local bridge mode 2026-04-12 22:09:20 +08:00
security Remove managed local bridge mode 2026-04-12 22:09:20 +08:00
testing test,docs: fix all stale references to deleted multi-agent subsystem 2026-06-04 06:31:45 +00:00
README_TESTING.md Remove Patrol from macOS package 2026-06-05 21:47:08 +08:00
xworkmate-app-core-functional-test-plan-v1.md Remove OpenClaw direct ACP route 2026-05-26 11:06:22 +08:00