qtmos-context-engine/schemas/surface-observe.example.json at main · DaMJMaD/qtmos-context-engine · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
{
  "id": "evt_20260408_surface_0001",
  "ts": "2026-04-08T14:20:00Z",
  "type": "surface.observe",
  "source": {
    "host": "ahk-bridge",
    "workspace": "/path/to/QTMoS-Alp-Beta",
    "session": "linux-local",
    "observer": "window-spy-linux"
  },
  "payload": {
    "surface_claim": {
      "host_kind": "browser",
      "label": "active_surface"
    },
    "surface_observation": {
      "platform": "linux-x11",
      "surface_id": "x11:0x3e00004",
      "x11_id": "0x3e00004",
      "pid": 1066243,
      "process_name": "electron",
      "process_path": "/opt/operator-shell/electron",
      "window_class": "operator-shell | Operator Shell",
      "window_title": "Operator Shell",
      "bounds": {
        "x": 0,
        "y": 69,
        "w": 1920,
        "h": 945
      },
      "focused": true,
      "z_order": "active",
      "visible_text": "",
      "control_tree_hash": "",
      "capture_ts": "2026-04-08T14:20:00Z"
    },
    "surface_signature": {
      "signature_version": "v1",
      "surface_hash": "sha256:example-surface-hash",
      "stable_keys": [
        "platform",
        "surface_id",
        "process_path",
        "window_class"
      ]
    },
    "trust_state": {
      "status": "verified",
      "drift_flags": [],
      "mismatch_flags": []
    }
  },
  "rails": {
    "0rail": {
      "raw_surface": "x11 active window observation"
    },
    "-rail": {
      "risk": "none",
      "stale": false,
      "conflict": false
    },
    "+rail": {
      "meaning": "stable_active_surface",
      "action_hint": "allow_context_binding"
    },
    "pm_rail": {
      "fused_state": "surface_verified",
      "confidence": 0.98
    }
  },
  "tags": [
    "surface_observed",
    "host_identity"
  ]
}