@mhome/app-facade-protocol 1.7.0 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -42,6 +42,10 @@ a single parent, containment, or acyclicity. Durable relations remain present
42
42
  while unavailable, and partial snapshots preserve confirmed structure when one
43
43
  source cannot be observed.
44
44
 
45
+ Device topology is read on page entry and explicit Refresh only. It has no
46
+ changed event or subscription. Its generation and revision identify reads;
47
+ revision is a process-local read sequence, not a domain-change counter.
48
+
45
49
  `artifact` exposes the MeowLink-facing `/app/artifact/resolve` operation. Its
46
50
  domain input and output reuse `mhome-artifact-api`; Node runtimes use the
47
51
  separate transport-neutral `/artifact/*` targets and never enter the App
@@ -61,3 +65,22 @@ supervise Hub and Node processes, but it is not a public App Facade executor;
61
65
  Host process management remains an implementation detail behind the selected
62
66
  Hub. Lion's legacy controller annotations and non-`/app/*` protocols are
63
67
  outside this contract.
68
+
69
+ ### System plugin catalog
70
+
71
+ `/app/plugin/catalog/list` returns `manifest/plugin-catalog.v1.json` from Cloud,
72
+ without requiring a local Space or connected Hub. Authentication and Space
73
+ membership still apply. Core also serves this catalog for clients with an older
74
+ routing manifest. The response schema is `schema/plugin-catalog.v1.schema.json`.
75
+
76
+ The catalog describes supported types, not installed software or bindings.
77
+ `componentId` joins to Host runtime inspection; `nodeType` joins to existing
78
+ Plugin candidate and installed/binding queries. Platform installability and
79
+ versions come from the Host release catalog, not this directory. Host inventory
80
+ is a native management API, not a portable App Facade executor.
81
+
82
+ Core and Cloud embed generated copies. After editing the catalog, run
83
+ `node scripts/sync-plugin-catalog.mjs --write <core-resource> <cloud-resource>`
84
+ from the Foundation root; omit `--write` to check conformance. Resource paths are
85
+ `src/application/plugin-catalog.v1.json` (Core) and
86
+ `src/main/resources/app/plugin-catalog.v1.json` (Cloud module-service).