@synopackageland/cli 0.4.0 → 0.4.1

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.
Files changed (438) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +37 -0
  3. package/dist/build-spk/generator.js +3 -0
  4. package/dist/build-spk/notices.d.ts +5 -0
  5. package/dist/build-spk/notices.js +60 -0
  6. package/dist/cli.js +9 -2
  7. package/dist/error-registry.js +20 -0
  8. package/dist/init.d.ts +4 -0
  9. package/dist/init.js +20 -12
  10. package/dist/standalone/build.js +3 -1
  11. package/dist/standalone/daemon.d.ts +23 -0
  12. package/dist/standalone/daemon.js +114 -0
  13. package/dist/standalone/dsm-window.d.ts +1 -1
  14. package/dist/standalone/dsm-window.js +50 -10
  15. package/dist/standalone/helper-inventory.d.ts +16 -0
  16. package/dist/standalone/helper-inventory.js +2 -0
  17. package/dist/standalone/helper.d.ts +2 -12
  18. package/dist/standalone/helper.js +8 -7
  19. package/dist/standalone/host-adapter.d.ts +5 -0
  20. package/dist/standalone/host-adapter.js +148 -0
  21. package/dist/standalone/host-platform.d.ts +13 -0
  22. package/dist/standalone/host-platform.js +42 -0
  23. package/dist/standalone/host-types.d.ts +49 -0
  24. package/dist/standalone/host-types.js +1 -0
  25. package/dist/standalone/inspect-helper.d.ts +6 -0
  26. package/dist/standalone/inspect-helper.js +88 -0
  27. package/dist/standalone/inspect-spk.d.ts +2 -0
  28. package/dist/standalone/inspect-spk.js +49 -0
  29. package/dist/standalone/lifecycle-helper.d.ts +2 -0
  30. package/dist/standalone/lifecycle-helper.js +12 -0
  31. package/dist/standalone/lifecycle.d.ts +3 -0
  32. package/dist/standalone/lifecycle.js +53 -0
  33. package/dist/standalone/manifest.d.ts +2 -0
  34. package/dist/standalone/manifest.js +4 -1
  35. package/dist/standalone/reopen-events.d.ts +2 -0
  36. package/dist/standalone/reopen-events.js +28 -0
  37. package/dist/standalone/root-messages.js +9 -0
  38. package/dist/standalone/root-window.d.ts +4 -3
  39. package/dist/standalone/root-window.js +17 -5
  40. package/dist/standalone/spk.d.ts +4 -3
  41. package/dist/standalone/spk.js +20 -33
  42. package/dist/template-paths.d.ts +2 -0
  43. package/dist/template-paths.js +9 -0
  44. package/dist/templates/_daemon/fixture_linux_test.go +15 -0
  45. package/dist/templates/_daemon/fixture_other_test.go +7 -0
  46. package/dist/templates/_daemon/go.mod +3 -0
  47. package/dist/templates/_daemon/main.go +608 -0
  48. package/dist/templates/_daemon/main_test.go +242 -0
  49. package/dist/templates/_daemon/process_linux.go +55 -0
  50. package/dist/templates/_daemon/process_linux_test.go +161 -0
  51. package/dist/templates/_daemon/process_other.go +14 -0
  52. package/dist/templates/_daemon/testdata/child.go +41 -0
  53. package/dist/templates/_shared/GO-LICENSE +27 -0
  54. package/dist/templates/_shared/GO-PATENTS +22 -0
  55. package/dist/templates/_shared/LICENSES/TEMPLATE.txt +21 -0
  56. package/dist/templates/_shared/notice-overrides/index.json +14 -0
  57. package/dist/templates/_shared/notice-overrides/utils-0.4.2-LICENSE +21 -0
  58. package/dist/templates/_shared/notice-overrides/utils-0.5.0-LICENSE +21 -0
  59. package/dist/templates/_shared/third-party-notices.mjs +51 -0
  60. package/dist/templates/native-go/README.md +57 -1
  61. package/dist/templates/native-go/backend/THIRD_PARTY_NOTICES.txt +59 -0
  62. package/dist/templates/native-go/backend/cmd/dsm-readonly-probe/main_linux.go +46 -0
  63. package/dist/templates/native-go/backend/go.mod +4 -0
  64. package/dist/templates/native-go/backend/go.sum +4 -0
  65. package/dist/templates/native-go/backend/internal/api/binary.go +154 -0
  66. package/dist/templates/native-go/backend/internal/api/binary_test.go +165 -0
  67. package/dist/templates/native-go/backend/internal/api/registry.go +14 -4
  68. package/dist/templates/native-go/backend/internal/api/server.go +4 -0
  69. package/dist/templates/native-go/backend/internal/app/nas_cgi_artifact_test.go +121 -0
  70. package/dist/templates/native-go/backend/internal/app/nas_refusal_test.go +46 -0
  71. package/dist/templates/native-go/backend/internal/app/routes.go +11 -0
  72. package/dist/templates/native-go/backend/internal/app/routes_test.go +10 -5
  73. package/dist/templates/native-go/backend/internal/dsmprobe/collector_linux.go +335 -0
  74. package/dist/templates/native-go/backend/internal/dsmprobe/collector_linux_test.go +41 -0
  75. package/dist/templates/native-go/backend/internal/dsmprobe/protocol.go +179 -0
  76. package/dist/templates/native-go/backend/internal/dsmprobe/protocol_test.go +29 -0
  77. package/dist/templates/native-go/backend/internal/helper/cohort.go +393 -0
  78. package/dist/templates/native-go/backend/internal/helper/cohort_publication.go +18 -0
  79. package/dist/templates/native-go/backend/internal/helper/cohort_publication_test.go +105 -0
  80. package/dist/templates/native-go/backend/internal/helper/cohort_test.go +372 -0
  81. package/dist/templates/native-go/backend/internal/helper/control.go +226 -21
  82. package/dist/templates/native-go/backend/internal/helper/control_test.go +10 -2
  83. package/dist/templates/native-go/backend/internal/helper/data_contract.go +242 -0
  84. package/dist/templates/native-go/backend/internal/helper/data_contract_test.go +51 -0
  85. package/dist/templates/native-go/backend/internal/helper/data_decode.go +184 -0
  86. package/dist/templates/native-go/backend/internal/helper/data_decode_pointer_test.go +30 -0
  87. package/dist/templates/native-go/backend/internal/helper/data_protocol.go +416 -0
  88. package/dist/templates/native-go/backend/internal/helper/data_protocol_test.go +449 -0
  89. package/dist/templates/native-go/backend/internal/helper/dsm_acl_linux.go +139 -0
  90. package/dist/templates/native-go/backend/internal/helper/dsm_acl_linux_test.go +121 -0
  91. package/dist/templates/native-go/backend/internal/helper/dsm_acl_syscall_linux.go +95 -0
  92. package/dist/templates/native-go/backend/internal/helper/dsm_acl_syscall_linux_test.go +56 -0
  93. package/dist/templates/native-go/backend/internal/helper/dsm_bridge_linux.go +144 -0
  94. package/dist/templates/native-go/backend/internal/helper/dsm_bridge_linux_test.go +89 -0
  95. package/dist/templates/native-go/backend/internal/helper/dsm_home_linux.go +107 -0
  96. package/dist/templates/native-go/backend/internal/helper/dsm_home_linux_test.go +82 -0
  97. package/dist/templates/native-go/backend/internal/helper/dsm_probe_transport_linux.go +151 -0
  98. package/dist/templates/native-go/backend/internal/helper/dsm_probe_transport_linux_test.go +66 -0
  99. package/dist/templates/native-go/backend/internal/helper/grant_authority.go +516 -0
  100. package/dist/templates/native-go/backend/internal/helper/grant_authority_contract.go +88 -0
  101. package/dist/templates/native-go/backend/internal/helper/grant_authority_test.go +510 -0
  102. package/dist/templates/native-go/backend/internal/helper/grant_cohort.go +389 -0
  103. package/dist/templates/native-go/backend/internal/helper/grant_cohort_test.go +239 -0
  104. package/dist/templates/native-go/backend/internal/helper/grant_delivery.go +49 -0
  105. package/dist/templates/native-go/backend/internal/helper/grant_delivery_methods.go +273 -0
  106. package/dist/templates/native-go/backend/internal/helper/grant_delivery_test.go +322 -0
  107. package/dist/templates/native-go/backend/internal/helper/grant_operation_contract.go +47 -0
  108. package/dist/templates/native-go/backend/internal/helper/grant_readonly_test.go +180 -0
  109. package/dist/templates/native-go/backend/internal/helper/grant_repository_linux.go +415 -0
  110. package/dist/templates/native-go/backend/internal/helper/grant_repository_linux_test.go +468 -0
  111. package/dist/templates/native-go/backend/internal/helper/grant_rpc.go +147 -0
  112. package/dist/templates/native-go/backend/internal/helper/grant_rpc_test.go +51 -0
  113. package/dist/templates/native-go/backend/internal/helper/grant_snapshot.go +75 -0
  114. package/dist/templates/native-go/backend/internal/helper/grant_supervisor_linux.go +134 -0
  115. package/dist/templates/native-go/backend/internal/helper/grant_supervisor_linux_test.go +254 -0
  116. package/dist/templates/native-go/backend/internal/helper/lease.go +112 -0
  117. package/dist/templates/native-go/backend/internal/helper/lease_linux.go +44 -0
  118. package/dist/templates/native-go/backend/internal/helper/lease_other.go +8 -0
  119. package/dist/templates/native-go/backend/internal/helper/lifecycle.go +234 -0
  120. package/dist/templates/native-go/backend/internal/helper/lifecycle_test.go +473 -0
  121. package/dist/templates/native-go/backend/internal/helper/managed_pilot.go +284 -0
  122. package/dist/templates/native-go/backend/internal/helper/managed_pilot_repository_linux.go +74 -0
  123. package/dist/templates/native-go/backend/internal/helper/managed_pilot_repository_linux_test.go +40 -0
  124. package/dist/templates/native-go/backend/internal/helper/managed_pilot_test.go +210 -0
  125. package/dist/templates/native-go/backend/internal/helper/nas_shipped_refusal_linux_test.go +97 -0
  126. package/dist/templates/native-go/backend/internal/helper/native_discovery.go +79 -0
  127. package/dist/templates/native-go/backend/internal/helper/native_identity.go +89 -0
  128. package/dist/templates/native-go/backend/internal/helper/native_provider.go +159 -0
  129. package/dist/templates/native-go/backend/internal/helper/native_provider_test.go +421 -0
  130. package/dist/templates/native-go/backend/internal/helper/observation.go +204 -0
  131. package/dist/templates/native-go/backend/internal/helper/observation_health_test.go +115 -0
  132. package/dist/templates/native-go/backend/internal/helper/observation_reload_budget_test.go +117 -0
  133. package/dist/templates/native-go/backend/internal/helper/observation_test.go +196 -0
  134. package/dist/templates/native-go/backend/internal/helper/observer_diagnostic.go +109 -0
  135. package/dist/templates/native-go/backend/internal/helper/observer_diagnostic_linux.go +76 -0
  136. package/dist/templates/native-go/backend/internal/helper/observer_diagnostic_linux_test.go +124 -0
  137. package/dist/templates/native-go/backend/internal/helper/observer_diagnostic_test.go +98 -0
  138. package/dist/templates/native-go/backend/internal/helper/operation_bootstrap_linux.go +193 -0
  139. package/dist/templates/native-go/backend/internal/helper/operation_credentials_linux.go +56 -0
  140. package/dist/templates/native-go/backend/internal/helper/operation_linux.go +480 -0
  141. package/dist/templates/native-go/backend/internal/helper/operation_linux_test.go +528 -0
  142. package/dist/templates/native-go/backend/internal/helper/process_linux.go +11 -1
  143. package/dist/templates/native-go/backend/internal/helper/publication_test.go +178 -0
  144. package/dist/templates/native-go/backend/internal/helper/read_stream_cohort_linux_test.go +156 -0
  145. package/dist/templates/native-go/backend/internal/helper/read_transfer.go +40 -0
  146. package/dist/templates/native-go/backend/internal/helper/read_transfer_linux.go +109 -0
  147. package/dist/templates/native-go/backend/internal/helper/read_transfer_linux_test.go +118 -0
  148. package/dist/templates/native-go/backend/internal/helper/read_transfer_test.go +177 -0
  149. package/dist/templates/native-go/backend/internal/helper/readonly.go +105 -0
  150. package/dist/templates/native-go/backend/internal/helper/readonly_admission.go +85 -0
  151. package/dist/templates/native-go/backend/internal/helper/readonly_cohort_linux_test.go +253 -0
  152. package/dist/templates/native-go/backend/internal/helper/readonly_linux_test.go +378 -0
  153. package/dist/templates/native-go/backend/internal/helper/readonly_mount_linux.go +65 -0
  154. package/dist/templates/native-go/backend/internal/helper/readonly_mount_proxy_linux.go +113 -0
  155. package/dist/templates/native-go/backend/internal/helper/readonly_operations_linux.go +168 -0
  156. package/dist/templates/native-go/backend/internal/helper/readonly_resolver_linux.go +241 -0
  157. package/dist/templates/native-go/backend/internal/helper/readonly_test.go +40 -0
  158. package/dist/templates/native-go/backend/internal/helper/relaxed_identity.go +252 -0
  159. package/dist/templates/native-go/backend/internal/helper/relaxed_identity_contract.go +105 -0
  160. package/dist/templates/native-go/backend/internal/helper/relaxed_identity_test.go +406 -0
  161. package/dist/templates/native-go/backend/internal/helper/relaxed_invalidation.go +200 -0
  162. package/dist/templates/native-go/backend/internal/helper/repair.go +132 -0
  163. package/dist/templates/native-go/backend/internal/helper/repair_test.go +271 -0
  164. package/dist/templates/native-go/backend/internal/helper/s1r_actor_acl_linux_test.go +303 -0
  165. package/dist/templates/native-go/backend/internal/helper/s1r_actor_fixture_linux_test.go +184 -0
  166. package/dist/templates/native-go/backend/internal/helper/s1r_actor_races_linux_test.go +231 -0
  167. package/dist/templates/native-go/backend/internal/helper/s1r_fixture_contract_linux_test.go +18 -0
  168. package/dist/templates/native-go/backend/internal/helper/server_linux.go +44 -3
  169. package/dist/templates/native-go/backend/internal/helper/status.go +74 -11
  170. package/dist/templates/native-go/backend/internal/helper/status_test.go +83 -0
  171. package/dist/templates/native-go/backend/internal/helper/supervision.go +28 -5
  172. package/dist/templates/native-go/backend/internal/helper/supervisor_frame.go +76 -0
  173. package/dist/templates/native-go/backend/internal/helper/supervisor_frame_linux_test.go +69 -0
  174. package/dist/templates/native-go/backend/internal/helper/supervisor_frame_test.go +107 -0
  175. package/dist/templates/native-go/backend/internal/helper/supervisor_linux.go +187 -16
  176. package/dist/templates/native-go/backend/internal/helper/supervisor_linux_test.go +618 -7
  177. package/dist/templates/native-go/backend/internal/helper/supervisor_socket_eof_test.go +74 -0
  178. package/dist/templates/native-go/backend/internal/helper/supervisor_socket_test.go +45 -0
  179. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/create.json +23 -0
  180. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/frames.json +67 -0
  181. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/grant-store.json +52 -0
  182. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/intent.json +20 -0
  183. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/list.json +20 -0
  184. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/publish.json +20 -0
  185. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/read.json +22 -0
  186. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/stat.json +22 -0
  187. package/dist/templates/native-go/backend/internal/helper/testdata/protocol2/write-stream.json +22 -0
  188. package/dist/templates/native-go/backend/internal/helper/unit_connection.go +75 -0
  189. package/dist/templates/native-go/backend/internal/helper/unit_connection_linux_test.go +135 -0
  190. package/dist/templates/native-go/backend/internal/helper/unit_connection_test.go +133 -0
  191. package/dist/templates/native-go/backend/internal/helper/unit_frame_test.go +32 -0
  192. package/dist/templates/native-go/backend/internal/helper/unit_linux.go +364 -0
  193. package/dist/templates/native-go/backend/internal/helper/unit_linux_test.go +46 -0
  194. package/dist/templates/native-go/backend/internal/helper/unit_mechanisms_linux_test.go +217 -0
  195. package/dist/templates/native-go/backend/internal/helper/unit_padding_linux_test.go +178 -0
  196. package/dist/templates/native-go/backend/internal/helper/unit_query_linux.go +111 -0
  197. package/dist/templates/native-go/backend/internal/helper/unit_reload_linux_test.go +372 -0
  198. package/dist/templates/native-go/backend/internal/helper/unit_reload_sequence_linux_test.go +232 -0
  199. package/dist/templates/native-go/backend/internal/helper/write.go +77 -0
  200. package/dist/templates/native-go/backend/internal/helper/write_admission.go +260 -0
  201. package/dist/templates/native-go/backend/internal/helper/write_admission_test.go +135 -0
  202. package/dist/templates/native-go/backend/internal/helper/write_cohort_linux_test.go +218 -0
  203. package/dist/templates/native-go/backend/internal/helper/write_files_linux.go +202 -0
  204. package/dist/templates/native-go/backend/internal/helper/write_files_linux_test.go +199 -0
  205. package/dist/templates/native-go/backend/internal/helper/write_intent_linux.go +116 -0
  206. package/dist/templates/native-go/backend/internal/helper/write_intent_linux_test.go +74 -0
  207. package/dist/templates/native-go/backend/internal/helper/write_operation_linux.go +245 -0
  208. package/dist/templates/native-go/backend/internal/helper/write_test.go +53 -0
  209. package/dist/templates/native-go/ui/app.js +8 -1
  210. package/dist/templates/native-go-better-auth/node/build.mjs +2 -0
  211. package/dist/templates/native-go-vue/README.md +115 -1
  212. package/dist/templates/native-go-vue/frontend/DESIGN.md +1 -1
  213. package/dist/templates/native-go-vue/frontend/package-lock.json +132 -229
  214. package/dist/templates/native-go-vue/frontend/package.json +1 -1
  215. package/dist/templates/native-go-vue/frontend/src/App.vue +33 -6
  216. package/dist/templates/native-go-vue/frontend/src/context.ts +41 -2
  217. package/dist/templates/native-go-vue/frontend/src/main.ts +4 -1
  218. package/dist/templates/native-go-vue/frontend/src/nas/NasGrantSettings.vue +74 -0
  219. package/dist/templates/native-go-vue/frontend/src/nas/NasPathPicker.vue +106 -0
  220. package/dist/templates/native-go-vue/frontend/src/nas/NasUnavailable.vue +20 -0
  221. package/dist/templates/native-go-vue/frontend/src/nas/i18n/de.json +74 -0
  222. package/dist/templates/native-go-vue/frontend/src/nas/i18n/en.json +74 -0
  223. package/dist/templates/native-go-vue/frontend/src/nas/i18n/es.json +74 -0
  224. package/dist/templates/native-go-vue/frontend/src/nas/i18n/fr.json +74 -0
  225. package/dist/templates/native-go-vue/frontend/src/nas/i18n/it.json +74 -0
  226. package/dist/templates/native-go-vue/frontend/src/nas/i18n/ja.json +74 -0
  227. package/dist/templates/native-go-vue/frontend/src/nas/i18n/ko.json +74 -0
  228. package/dist/templates/native-go-vue/frontend/src/nas/i18n/zh-CN.json +74 -0
  229. package/dist/templates/native-go-vue/frontend/src/nas/i18n/zh-TW.json +74 -0
  230. package/dist/templates/native-go-vue/frontend/src/nas/i18n.ts +38 -0
  231. package/dist/templates/native-go-vue/frontend/src/nas/mock-provider.ts +119 -0
  232. package/dist/templates/native-go-vue/frontend/src/nas/provider.ts +59 -0
  233. package/dist/templates/native-go-vue/frontend/src/nas/use-request.ts +27 -0
  234. package/dist/templates/native-go-vue/frontend/src/style.css +17 -0
  235. package/dist/templates/native-go-vue/frontend/test/apps.test.ts +44 -2
  236. package/dist/templates/native-go-vue/frontend/test/nas-provider.test.ts +81 -0
  237. package/dist/templates/native-go-vue/frontend/test/nas-request.test.ts +21 -0
  238. package/dist/templates/native-go-vue/frontend/test/nas-ui.test.ts +261 -0
  239. package/dist/templates/native-go-vue/frontend/tsconfig.json +1 -1
  240. package/dist/templates/native-go-vue/frontend/vite.config.ts +6 -4
  241. package/package.json +3 -2
  242. package/templates/_daemon/fixture_linux_test.go +15 -0
  243. package/templates/_daemon/fixture_other_test.go +7 -0
  244. package/templates/_daemon/go.mod +3 -0
  245. package/templates/_daemon/main.go +608 -0
  246. package/templates/_daemon/main_test.go +242 -0
  247. package/templates/_daemon/process_linux.go +55 -0
  248. package/templates/_daemon/process_linux_test.go +161 -0
  249. package/templates/_daemon/process_other.go +14 -0
  250. package/templates/_daemon/testdata/child.go +41 -0
  251. package/templates/_shared/GO-LICENSE +27 -0
  252. package/templates/_shared/GO-PATENTS +22 -0
  253. package/templates/_shared/LICENSES/TEMPLATE.txt +21 -0
  254. package/templates/_shared/notice-overrides/index.json +14 -0
  255. package/templates/_shared/notice-overrides/utils-0.4.2-LICENSE +21 -0
  256. package/templates/_shared/notice-overrides/utils-0.5.0-LICENSE +21 -0
  257. package/templates/_shared/third-party-notices.mjs +51 -0
  258. package/templates/native-go/README.md +57 -1
  259. package/templates/native-go/backend/THIRD_PARTY_NOTICES.txt +59 -0
  260. package/templates/native-go/backend/cmd/dsm-readonly-probe/main_linux.go +46 -0
  261. package/templates/native-go/backend/go.mod +4 -0
  262. package/templates/native-go/backend/go.sum +4 -0
  263. package/templates/native-go/backend/internal/api/binary.go +154 -0
  264. package/templates/native-go/backend/internal/api/binary_test.go +165 -0
  265. package/templates/native-go/backend/internal/api/registry.go +14 -4
  266. package/templates/native-go/backend/internal/api/server.go +4 -0
  267. package/templates/native-go/backend/internal/app/nas_cgi_artifact_test.go +121 -0
  268. package/templates/native-go/backend/internal/app/nas_refusal_test.go +46 -0
  269. package/templates/native-go/backend/internal/app/routes.go +11 -0
  270. package/templates/native-go/backend/internal/app/routes_test.go +10 -5
  271. package/templates/native-go/backend/internal/dsmprobe/collector_linux.go +335 -0
  272. package/templates/native-go/backend/internal/dsmprobe/collector_linux_test.go +41 -0
  273. package/templates/native-go/backend/internal/dsmprobe/protocol.go +179 -0
  274. package/templates/native-go/backend/internal/dsmprobe/protocol_test.go +29 -0
  275. package/templates/native-go/backend/internal/helper/cohort.go +393 -0
  276. package/templates/native-go/backend/internal/helper/cohort_publication.go +18 -0
  277. package/templates/native-go/backend/internal/helper/cohort_publication_test.go +105 -0
  278. package/templates/native-go/backend/internal/helper/cohort_test.go +372 -0
  279. package/templates/native-go/backend/internal/helper/control.go +226 -21
  280. package/templates/native-go/backend/internal/helper/control_test.go +10 -2
  281. package/templates/native-go/backend/internal/helper/data_contract.go +242 -0
  282. package/templates/native-go/backend/internal/helper/data_contract_test.go +51 -0
  283. package/templates/native-go/backend/internal/helper/data_decode.go +184 -0
  284. package/templates/native-go/backend/internal/helper/data_decode_pointer_test.go +30 -0
  285. package/templates/native-go/backend/internal/helper/data_protocol.go +416 -0
  286. package/templates/native-go/backend/internal/helper/data_protocol_test.go +449 -0
  287. package/templates/native-go/backend/internal/helper/dsm_acl_linux.go +139 -0
  288. package/templates/native-go/backend/internal/helper/dsm_acl_linux_test.go +121 -0
  289. package/templates/native-go/backend/internal/helper/dsm_acl_syscall_linux.go +95 -0
  290. package/templates/native-go/backend/internal/helper/dsm_acl_syscall_linux_test.go +56 -0
  291. package/templates/native-go/backend/internal/helper/dsm_bridge_linux.go +144 -0
  292. package/templates/native-go/backend/internal/helper/dsm_bridge_linux_test.go +89 -0
  293. package/templates/native-go/backend/internal/helper/dsm_home_linux.go +107 -0
  294. package/templates/native-go/backend/internal/helper/dsm_home_linux_test.go +82 -0
  295. package/templates/native-go/backend/internal/helper/dsm_probe_transport_linux.go +151 -0
  296. package/templates/native-go/backend/internal/helper/dsm_probe_transport_linux_test.go +66 -0
  297. package/templates/native-go/backend/internal/helper/grant_authority.go +516 -0
  298. package/templates/native-go/backend/internal/helper/grant_authority_contract.go +88 -0
  299. package/templates/native-go/backend/internal/helper/grant_authority_test.go +510 -0
  300. package/templates/native-go/backend/internal/helper/grant_cohort.go +389 -0
  301. package/templates/native-go/backend/internal/helper/grant_cohort_test.go +239 -0
  302. package/templates/native-go/backend/internal/helper/grant_delivery.go +49 -0
  303. package/templates/native-go/backend/internal/helper/grant_delivery_methods.go +273 -0
  304. package/templates/native-go/backend/internal/helper/grant_delivery_test.go +322 -0
  305. package/templates/native-go/backend/internal/helper/grant_operation_contract.go +47 -0
  306. package/templates/native-go/backend/internal/helper/grant_readonly_test.go +180 -0
  307. package/templates/native-go/backend/internal/helper/grant_repository_linux.go +415 -0
  308. package/templates/native-go/backend/internal/helper/grant_repository_linux_test.go +468 -0
  309. package/templates/native-go/backend/internal/helper/grant_rpc.go +147 -0
  310. package/templates/native-go/backend/internal/helper/grant_rpc_test.go +51 -0
  311. package/templates/native-go/backend/internal/helper/grant_snapshot.go +75 -0
  312. package/templates/native-go/backend/internal/helper/grant_supervisor_linux.go +134 -0
  313. package/templates/native-go/backend/internal/helper/grant_supervisor_linux_test.go +254 -0
  314. package/templates/native-go/backend/internal/helper/lease.go +112 -0
  315. package/templates/native-go/backend/internal/helper/lease_linux.go +44 -0
  316. package/templates/native-go/backend/internal/helper/lease_other.go +8 -0
  317. package/templates/native-go/backend/internal/helper/lifecycle.go +234 -0
  318. package/templates/native-go/backend/internal/helper/lifecycle_test.go +473 -0
  319. package/templates/native-go/backend/internal/helper/managed_pilot.go +284 -0
  320. package/templates/native-go/backend/internal/helper/managed_pilot_repository_linux.go +74 -0
  321. package/templates/native-go/backend/internal/helper/managed_pilot_repository_linux_test.go +40 -0
  322. package/templates/native-go/backend/internal/helper/managed_pilot_test.go +210 -0
  323. package/templates/native-go/backend/internal/helper/nas_shipped_refusal_linux_test.go +97 -0
  324. package/templates/native-go/backend/internal/helper/native_discovery.go +79 -0
  325. package/templates/native-go/backend/internal/helper/native_identity.go +89 -0
  326. package/templates/native-go/backend/internal/helper/native_provider.go +159 -0
  327. package/templates/native-go/backend/internal/helper/native_provider_test.go +421 -0
  328. package/templates/native-go/backend/internal/helper/observation.go +204 -0
  329. package/templates/native-go/backend/internal/helper/observation_health_test.go +115 -0
  330. package/templates/native-go/backend/internal/helper/observation_reload_budget_test.go +117 -0
  331. package/templates/native-go/backend/internal/helper/observation_test.go +196 -0
  332. package/templates/native-go/backend/internal/helper/observer_diagnostic.go +109 -0
  333. package/templates/native-go/backend/internal/helper/observer_diagnostic_linux.go +76 -0
  334. package/templates/native-go/backend/internal/helper/observer_diagnostic_linux_test.go +124 -0
  335. package/templates/native-go/backend/internal/helper/observer_diagnostic_test.go +98 -0
  336. package/templates/native-go/backend/internal/helper/operation_bootstrap_linux.go +193 -0
  337. package/templates/native-go/backend/internal/helper/operation_credentials_linux.go +56 -0
  338. package/templates/native-go/backend/internal/helper/operation_linux.go +480 -0
  339. package/templates/native-go/backend/internal/helper/operation_linux_test.go +528 -0
  340. package/templates/native-go/backend/internal/helper/process_linux.go +11 -1
  341. package/templates/native-go/backend/internal/helper/publication_test.go +178 -0
  342. package/templates/native-go/backend/internal/helper/read_stream_cohort_linux_test.go +156 -0
  343. package/templates/native-go/backend/internal/helper/read_transfer.go +40 -0
  344. package/templates/native-go/backend/internal/helper/read_transfer_linux.go +109 -0
  345. package/templates/native-go/backend/internal/helper/read_transfer_linux_test.go +118 -0
  346. package/templates/native-go/backend/internal/helper/read_transfer_test.go +177 -0
  347. package/templates/native-go/backend/internal/helper/readonly.go +105 -0
  348. package/templates/native-go/backend/internal/helper/readonly_admission.go +85 -0
  349. package/templates/native-go/backend/internal/helper/readonly_cohort_linux_test.go +253 -0
  350. package/templates/native-go/backend/internal/helper/readonly_linux_test.go +378 -0
  351. package/templates/native-go/backend/internal/helper/readonly_mount_linux.go +65 -0
  352. package/templates/native-go/backend/internal/helper/readonly_mount_proxy_linux.go +113 -0
  353. package/templates/native-go/backend/internal/helper/readonly_operations_linux.go +168 -0
  354. package/templates/native-go/backend/internal/helper/readonly_resolver_linux.go +241 -0
  355. package/templates/native-go/backend/internal/helper/readonly_test.go +40 -0
  356. package/templates/native-go/backend/internal/helper/relaxed_identity.go +252 -0
  357. package/templates/native-go/backend/internal/helper/relaxed_identity_contract.go +105 -0
  358. package/templates/native-go/backend/internal/helper/relaxed_identity_test.go +406 -0
  359. package/templates/native-go/backend/internal/helper/relaxed_invalidation.go +200 -0
  360. package/templates/native-go/backend/internal/helper/repair.go +132 -0
  361. package/templates/native-go/backend/internal/helper/repair_test.go +271 -0
  362. package/templates/native-go/backend/internal/helper/s1r_actor_acl_linux_test.go +303 -0
  363. package/templates/native-go/backend/internal/helper/s1r_actor_fixture_linux_test.go +184 -0
  364. package/templates/native-go/backend/internal/helper/s1r_actor_races_linux_test.go +231 -0
  365. package/templates/native-go/backend/internal/helper/s1r_fixture_contract_linux_test.go +18 -0
  366. package/templates/native-go/backend/internal/helper/server_linux.go +44 -3
  367. package/templates/native-go/backend/internal/helper/status.go +74 -11
  368. package/templates/native-go/backend/internal/helper/status_test.go +83 -0
  369. package/templates/native-go/backend/internal/helper/supervision.go +28 -5
  370. package/templates/native-go/backend/internal/helper/supervisor_frame.go +76 -0
  371. package/templates/native-go/backend/internal/helper/supervisor_frame_linux_test.go +69 -0
  372. package/templates/native-go/backend/internal/helper/supervisor_frame_test.go +107 -0
  373. package/templates/native-go/backend/internal/helper/supervisor_linux.go +187 -16
  374. package/templates/native-go/backend/internal/helper/supervisor_linux_test.go +618 -7
  375. package/templates/native-go/backend/internal/helper/supervisor_socket_eof_test.go +74 -0
  376. package/templates/native-go/backend/internal/helper/supervisor_socket_test.go +45 -0
  377. package/templates/native-go/backend/internal/helper/testdata/protocol2/create.json +23 -0
  378. package/templates/native-go/backend/internal/helper/testdata/protocol2/frames.json +67 -0
  379. package/templates/native-go/backend/internal/helper/testdata/protocol2/grant-store.json +52 -0
  380. package/templates/native-go/backend/internal/helper/testdata/protocol2/intent.json +20 -0
  381. package/templates/native-go/backend/internal/helper/testdata/protocol2/list.json +20 -0
  382. package/templates/native-go/backend/internal/helper/testdata/protocol2/publish.json +20 -0
  383. package/templates/native-go/backend/internal/helper/testdata/protocol2/read.json +22 -0
  384. package/templates/native-go/backend/internal/helper/testdata/protocol2/stat.json +22 -0
  385. package/templates/native-go/backend/internal/helper/testdata/protocol2/write-stream.json +22 -0
  386. package/templates/native-go/backend/internal/helper/unit_connection.go +75 -0
  387. package/templates/native-go/backend/internal/helper/unit_connection_linux_test.go +135 -0
  388. package/templates/native-go/backend/internal/helper/unit_connection_test.go +133 -0
  389. package/templates/native-go/backend/internal/helper/unit_frame_test.go +32 -0
  390. package/templates/native-go/backend/internal/helper/unit_linux.go +364 -0
  391. package/templates/native-go/backend/internal/helper/unit_linux_test.go +46 -0
  392. package/templates/native-go/backend/internal/helper/unit_mechanisms_linux_test.go +217 -0
  393. package/templates/native-go/backend/internal/helper/unit_padding_linux_test.go +178 -0
  394. package/templates/native-go/backend/internal/helper/unit_query_linux.go +111 -0
  395. package/templates/native-go/backend/internal/helper/unit_reload_linux_test.go +372 -0
  396. package/templates/native-go/backend/internal/helper/unit_reload_sequence_linux_test.go +232 -0
  397. package/templates/native-go/backend/internal/helper/write.go +77 -0
  398. package/templates/native-go/backend/internal/helper/write_admission.go +260 -0
  399. package/templates/native-go/backend/internal/helper/write_admission_test.go +135 -0
  400. package/templates/native-go/backend/internal/helper/write_cohort_linux_test.go +218 -0
  401. package/templates/native-go/backend/internal/helper/write_files_linux.go +202 -0
  402. package/templates/native-go/backend/internal/helper/write_files_linux_test.go +199 -0
  403. package/templates/native-go/backend/internal/helper/write_intent_linux.go +116 -0
  404. package/templates/native-go/backend/internal/helper/write_intent_linux_test.go +74 -0
  405. package/templates/native-go/backend/internal/helper/write_operation_linux.go +245 -0
  406. package/templates/native-go/backend/internal/helper/write_test.go +53 -0
  407. package/templates/native-go/ui/app.js +8 -1
  408. package/templates/native-go-better-auth/node/build.mjs +2 -0
  409. package/templates/native-go-vue/README.md +115 -1
  410. package/templates/native-go-vue/frontend/DESIGN.md +1 -1
  411. package/templates/native-go-vue/frontend/package-lock.json +132 -229
  412. package/templates/native-go-vue/frontend/package.json +1 -1
  413. package/templates/native-go-vue/frontend/src/App.vue +33 -6
  414. package/templates/native-go-vue/frontend/src/context.ts +41 -2
  415. package/templates/native-go-vue/frontend/src/main.ts +4 -1
  416. package/templates/native-go-vue/frontend/src/nas/NasGrantSettings.vue +74 -0
  417. package/templates/native-go-vue/frontend/src/nas/NasPathPicker.vue +106 -0
  418. package/templates/native-go-vue/frontend/src/nas/NasUnavailable.vue +20 -0
  419. package/templates/native-go-vue/frontend/src/nas/i18n/de.json +74 -0
  420. package/templates/native-go-vue/frontend/src/nas/i18n/en.json +74 -0
  421. package/templates/native-go-vue/frontend/src/nas/i18n/es.json +74 -0
  422. package/templates/native-go-vue/frontend/src/nas/i18n/fr.json +74 -0
  423. package/templates/native-go-vue/frontend/src/nas/i18n/it.json +74 -0
  424. package/templates/native-go-vue/frontend/src/nas/i18n/ja.json +74 -0
  425. package/templates/native-go-vue/frontend/src/nas/i18n/ko.json +74 -0
  426. package/templates/native-go-vue/frontend/src/nas/i18n/zh-CN.json +74 -0
  427. package/templates/native-go-vue/frontend/src/nas/i18n/zh-TW.json +74 -0
  428. package/templates/native-go-vue/frontend/src/nas/i18n.ts +38 -0
  429. package/templates/native-go-vue/frontend/src/nas/mock-provider.ts +119 -0
  430. package/templates/native-go-vue/frontend/src/nas/provider.ts +59 -0
  431. package/templates/native-go-vue/frontend/src/nas/use-request.ts +27 -0
  432. package/templates/native-go-vue/frontend/src/style.css +17 -0
  433. package/templates/native-go-vue/frontend/test/apps.test.ts +44 -2
  434. package/templates/native-go-vue/frontend/test/nas-provider.test.ts +81 -0
  435. package/templates/native-go-vue/frontend/test/nas-request.test.ts +21 -0
  436. package/templates/native-go-vue/frontend/test/nas-ui.test.ts +261 -0
  437. package/templates/native-go-vue/frontend/tsconfig.json +1 -1
  438. package/templates/native-go-vue/frontend/vite.config.ts +6 -4
@@ -0,0 +1,177 @@
1
+ package helper
2
+
3
+ import (
4
+ "bytes"
5
+ "context"
6
+ "encoding/json"
7
+ "fmt"
8
+ "io"
9
+ "syscall"
10
+ "testing"
11
+ "time"
12
+ )
13
+
14
+ func TestReadStreamControlCeilings(t *testing.T) {
15
+ s, repo, _, _, g, _ := grantCohortFixture(t)
16
+ _ = s
17
+ repo.store.Grants[0].Actions = []Action{ActionReadStream}
18
+ r := grantControl(t, g, '1', '2', '3', MaxTransferBytes)
19
+ r.Op = ActionReadStream
20
+ b, _ := json.Marshal(r)
21
+ if _, c := DecodeDataRequest(bytes.NewReader(b)); c != "" {
22
+ t.Fatal(c)
23
+ }
24
+ r.Args = []byte(`{"segments":["fixture"],"maxBytes":67108865}`)
25
+ b, _ = json.Marshal(r)
26
+ if _, c := DecodeDataRequest(bytes.NewReader(b)); c != ErrLimit {
27
+ t.Fatal(c)
28
+ }
29
+ r.Op = ActionRead
30
+ b, _ = json.Marshal(r)
31
+ if _, c := DecodeDataRequest(bytes.NewReader(b)); c == "" {
32
+ t.Fatal("bounded mode accepted stream ceiling")
33
+ }
34
+ }
35
+ func TestReadStreamIdleAndTotalDeadline(t *testing.T) {
36
+ now := time.Now()
37
+ op := &cohortOperation{work: &readOnlyWork{Action: ActionReadStream}, admittedAt: now, lastActivity: now}
38
+ if op.expired(now.Add(StreamIdleTimeout - time.Nanosecond)) {
39
+ t.Fatal("early timeout")
40
+ }
41
+ if !op.expired(now.Add(StreamIdleTimeout)) {
42
+ t.Fatal("idle ignored")
43
+ }
44
+ op.lastActivity = now.Add(StreamTotalTimeout - time.Second)
45
+ if !op.expired(now.Add(StreamTotalTimeout)) {
46
+ t.Fatal("total ignored")
47
+ }
48
+ }
49
+ func TestReadStreamFreshGrantProofEveryChunk(t *testing.T) {
50
+ for _, kind := range []string{"valid", "acl", "groups", "epoch", "replay", "R", "busy"} {
51
+ t.Run(kind, func(t *testing.T) {
52
+ s, repo, c, carriers, g, _ := grantCohortFixture(t)
53
+ repo.store.Grants[0].Actions = []Action{ActionReadStream}
54
+ p := &metadataProcessStub{operationFixture: &operationFixture{}, result: &readOnlyResult{Bytes: 2 * MaxChunkBytes}, released: true}
55
+ c.startChild = func(NativeActor, operationBinding) (operationProcess, error) { return p, nil }
56
+ r := grantControl(t, g, '1', '2', '3', 2*MaxChunkBytes)
57
+ r.Op = ActionReadStream
58
+ if code := s.start(context.Background(), operationPeer{42, 0}, carriers, r); code != "" {
59
+ t.Fatal(code)
60
+ }
61
+ chunk := grantControl(t, g, '1', '4', '5', MaxChunkBytes)
62
+ chunk.Op = ActionReadStream
63
+ if code := s.chunk(context.Background(), operationPeer{42, 0}, carriers, chunk); code != "" {
64
+ t.Fatal(code)
65
+ }
66
+ p.pending = false
67
+ chunk.Nonce = grantRef('6')
68
+ chunk.Ticket = grantRef('7')
69
+ switch kind {
70
+ case "acl":
71
+ s.services.operations = grantOperationStub{code: ErrDenied}
72
+ case "groups":
73
+ c.operations[r.OperationID].actor.account.Groups = []uint32{999}
74
+ case "epoch":
75
+ chunk.Epoch = grantRef('f')
76
+ case "replay":
77
+ chunk.Nonce = grantRef('4')
78
+ chunk.Ticket = grantRef('5')
79
+ case "R":
80
+ repo.store.Grants[0].State = GrantRevoked
81
+ repo.store.Grants[0].Revision++
82
+ repo.store.Grants[0].RevokedAt = g.CreatedAt
83
+ repo.store.Grants[0].Reason = ErrRevoked
84
+ case "busy":
85
+ p.pending = true
86
+ }
87
+ code := s.chunk(context.Background(), operationPeer{42, 0}, carriers, chunk)
88
+ if kind == "valid" {
89
+ if code != "" || c.operations[r.OperationID].bytes != 2*MaxChunkBytes {
90
+ t.Fatal(code)
91
+ }
92
+ } else if code == "" || c.operations[r.OperationID].bytes != MaxChunkBytes {
93
+ t.Fatal("invalid lease admitted", code)
94
+ }
95
+ })
96
+ }
97
+ }
98
+
99
+ func TestStreamTicketWindowDoesNotTruncateAtBoundedReadWindow(t *testing.T) {
100
+ s, repo, _, carriers, g, _ := grantCohortFixture(t)
101
+ repo.store.Grants[0].Actions = []Action{ActionReadStream}
102
+ a, code := s.authority.actor(context.Background(), carriers, nil)
103
+ if code != "" {
104
+ t.Fatal(code)
105
+ }
106
+ for i := 0; i < MaxTransferBytes/MaxChunkBytes+1; i++ {
107
+ r := grantControl(t, g, '1', '2', '3', MaxChunkBytes)
108
+ r.Op = ActionReadStream
109
+ r.Nonce = fmt.Sprintf("%064x", i+1)
110
+ r.Ticket = fmt.Sprintf("%064x", i+10000)
111
+ proof, code := (grantOperationStub{}).ValidateOperation(context.Background(), a, r, g)
112
+ if code != "" {
113
+ t.Fatal(code)
114
+ }
115
+ if code = s.ticketLocked(r, proof.Ticket, a); code != "" {
116
+ t.Fatal(i, code)
117
+ }
118
+ s.burnTicket(r)
119
+ if code = s.ticketLocked(r, proof.Ticket, a); code != ErrReplay {
120
+ t.Fatal(i, code)
121
+ }
122
+ }
123
+ }
124
+
125
+ type relayFailureFixture struct{ *operationFixture }
126
+
127
+ func (p relayFailureFixture) idle() (bool, error) { return true, io.ErrClosedPipe }
128
+ func TestCohortPollCancelsDisconnectedOutput(t *testing.T) {
129
+ c, _, _, a, b, _ := cohortFixture(t)
130
+ f := &operationFixture{childFixture: childFixture{exitOn: syscall.SIGKILL}}
131
+ op := &cohortOperation{binding: b, actor: a, process: relayFailureFixture{f}, admittedAt: c.now()}
132
+ c.operations[b.OperationID] = op
133
+ c.started = 1
134
+ if err := c.poll(); err != nil {
135
+ t.Fatal(err)
136
+ }
137
+ if !op.canceled || !f.stopped {
138
+ t.Fatal("disconnected client retained live transfer")
139
+ }
140
+ if err := c.poll(); err != nil {
141
+ t.Fatal(err)
142
+ }
143
+ if len(c.operations) != 0 || c.reaped != 1 {
144
+ t.Fatal("disconnect did not reach observed quiescence")
145
+ }
146
+ }
147
+
148
+ func TestTransferSubjectFreshnessIncludesSessionObservation(t *testing.T) {
149
+ p, s, _, carriers, now := nativeFixture()
150
+ s.value.CheckedAt = now.Add(-NativeProofFreshness / 2)
151
+ a, code := p.Resolve(context.Background(), carriers)
152
+ if code != "" {
153
+ t.Fatal(code)
154
+ }
155
+ if !a.account.CheckedAt.Equal(s.value.CheckedAt) {
156
+ t.Fatal("transfer extended older session proof", a.account.CheckedAt, s.value.CheckedAt)
157
+ }
158
+ }
159
+
160
+ func TestReadStreamServerIssuedWindowCompletesMaximumTransfer(t *testing.T) {
161
+ tickets, actor, request, _ := deliveryFixture(t)
162
+ request.Op = ActionReadStream
163
+ for i := 0; i < MaxTransferBytes/MaxChunkBytes+1; i++ {
164
+ request.Nonce = fmt.Sprintf("%064x", i+10000)
165
+ issued, code := tickets.issue(context.Background(), actor, request)
166
+ if code != "" {
167
+ t.Fatal(i, code)
168
+ }
169
+ if _, code = tickets.consume(context.Background(), actor, issued); code != "" {
170
+ t.Fatal(i, code)
171
+ }
172
+ }
173
+ request.Op = ActionRead
174
+ if _, code := tickets.issue(context.Background(), actor, request); code != "" {
175
+ t.Fatal("stream consumed independent bounded window", code)
176
+ }
177
+ }
@@ -0,0 +1,105 @@
1
+ package helper
2
+
3
+ import (
4
+ "context"
5
+ "strings"
6
+ )
7
+
8
+ // Fixed internal work, assembled only by the trusted supervisor. Never accept
9
+ // RootPath or descriptors from package/browser RPC. Grant admission stays S3-owned.
10
+ type readOnlyWork struct {
11
+ RootPath string `json:"rootPath"`
12
+ Action Action `json:"action"`
13
+ Segments []string `json:"segments"`
14
+ MaxBytes uint64 `json:"maxBytes"`
15
+ Limit uint32 `json:"limit"`
16
+ }
17
+
18
+ type readOnlyResult struct {
19
+ Mutation *MutationReceipt `json:"mutation,omitempty"`
20
+ Code Code `json:"code"`
21
+ Entry *Entry `json:"entry,omitempty"`
22
+ List *ListResult `json:"list,omitempty"`
23
+ Bytes uint64 `json:"bytes"`
24
+ }
25
+
26
+ // Mandatory child-side native share/home and action ACL adapter. Unknown native
27
+ // semantics MUST refuse; syscall success cannot substitute for DSM share gates.
28
+ // fd is an actor-opened object, never a caller path or root-opened readable FD.
29
+ // No adapter is installed in shipped binaries until separate DSM proof passes.
30
+ type readOnlyACL interface {
31
+ Authorize(context.Context, Action, int) Code
32
+ }
33
+
34
+ func (w readOnlyWork) validate() Code {
35
+ if !strings.HasPrefix(w.RootPath, "/") || w.RootPath == "/" {
36
+ return ErrInvalid
37
+ }
38
+ if code := ValidateRelativeSegments(strings.Split(w.RootPath[1:], "/"), false); code != "" {
39
+ return code
40
+ }
41
+ if !w.Action.ReadOnly() {
42
+ return ErrUnsupported
43
+ }
44
+ if code := ValidateRelativeSegments(w.Segments, w.Action != ActionRead && w.Action != ActionReadStream); code != "" {
45
+ return code
46
+ }
47
+ switch w.Action {
48
+ case ActionRead, ActionReadStream:
49
+ if w.MaxBytes == 0 || w.MaxBytes > readDataCeiling(w.Action) || w.Limit != 0 {
50
+ return ErrLimit
51
+ }
52
+ case ActionList:
53
+ if w.Limit == 0 || w.Limit > MaxPageEntries || w.MaxBytes != 0 {
54
+ return ErrLimit
55
+ }
56
+ case ActionStat:
57
+ if w.Limit != 0 || w.MaxBytes != 0 {
58
+ return ErrInvalid
59
+ }
60
+ }
61
+ return ""
62
+ }
63
+
64
+ // Private child metadata; bulk data only traverses the inherited leased pipe.
65
+ type readOnlyPacket struct {
66
+ Binding operationBinding `json:"binding"`
67
+ Token string `json:"token"`
68
+ Result *readOnlyResult `json:"result,omitempty"`
69
+ MountFD *uint32 `json:"mountFd,omitempty"`
70
+ ChunkSequence uint64 `json:"chunkSequence,omitempty"`
71
+ MountSequence uint64 `json:"mountSequence,omitempty"`
72
+ }
73
+ type readOnlyMountReply struct {
74
+ Token string `json:"token"`
75
+ Sequence uint64 `json:"sequence"`
76
+ Mount uint64 `json:"mount"`
77
+ Code Code `json:"code"`
78
+ }
79
+ type readOnlyPacketOutcome struct {
80
+ result *readOnlyResult
81
+ err error
82
+ mountSequence uint64
83
+ }
84
+
85
+ func (r readOnlyResult) validFor(w readOnlyWork) bool {
86
+ if r.Mutation != nil {
87
+ return false
88
+ }
89
+ if r.Code != "" {
90
+ return r.Code.Valid() && r.Bytes == 0 && r.Entry == nil && r.List == nil
91
+ }
92
+ switch w.Action {
93
+ case ActionRead, ActionReadStream:
94
+ return r.Bytes <= w.MaxBytes && r.Entry == nil && r.List == nil
95
+ case ActionStat:
96
+ return r.Bytes == 0 && r.Entry != nil && r.List == nil
97
+ case ActionList:
98
+ return r.Bytes == 0 && r.Entry == nil && r.List != nil && len(r.List.Entries) <= int(w.Limit) && r.List.Cursor == ""
99
+ }
100
+ return false
101
+ }
102
+
103
+ type operationReadOnlyFinish struct {
104
+ Token string `json:"token"`
105
+ }
@@ -0,0 +1,85 @@
1
+ package helper
2
+
3
+ import (
4
+ "encoding/json"
5
+ "slices"
6
+ )
7
+
8
+ // Private epoch-live capability, supplied by the fixed S3 operation validator.
9
+ // It is not serialized into grant storage or caller controls. On Linux the only
10
+ // concrete production witness accepted by the child factory is an O_PATH pin.
11
+ type readOnlyRootWitness interface {
12
+ readOnlyRootPath() string
13
+ sameReadOnlyRoot(readOnlyRootWitness) bool
14
+ }
15
+ type readOnlyMetadataProcess interface {
16
+ readOnlyMetadata() (*readOnlyResult, bool, error)
17
+ releaseReadOnlyMetadata() error
18
+ readOnlyLeaseReady(uint32) Code
19
+ }
20
+
21
+ func readOnlyRequestWork(r DataRequest, root readOnlyRootWitness) (*readOnlyWork, Code) {
22
+ w := &readOnlyWork{Action: r.Op}
23
+ if root != nil {
24
+ w.RootPath = root.readOnlyRootPath()
25
+ }
26
+ switch r.Op {
27
+ case ActionRead, ActionReadStream:
28
+ var a ReadArgs
29
+ if code := decodeDataObject(bytesReader(r.Args), &a, MaxControlBytes); code != "" {
30
+ return nil, code
31
+ }
32
+ w.Segments = slices.Clone(a.Segments)
33
+ w.MaxBytes = a.MaxBytes
34
+ case ActionStat:
35
+ var a StatArgs
36
+ if code := decodeDataObject(bytesReader(r.Args), &a, MaxControlBytes); code != "" {
37
+ return nil, code
38
+ }
39
+ w.Segments = slices.Clone(a.Segments)
40
+ case ActionList:
41
+ var a ListArgs
42
+ if code := decodeDataObject(bytesReader(r.Args), &a, MaxControlBytes); code != "" {
43
+ return nil, code
44
+ }
45
+ if a.Cursor != "" {
46
+ return nil, ErrUnsupported
47
+ }
48
+ w.Segments = slices.Clone(a.Segments)
49
+ w.Limit = a.Limit
50
+ default:
51
+ return nil, ErrUnsupported
52
+ }
53
+ // Unit-test S3 synthetic factories have no root. The actual Linux factory
54
+ // always refuses nil; production has no native/ACL adapter installed.
55
+ if root != nil {
56
+ if code := w.validate(); code != "" {
57
+ return nil, code
58
+ }
59
+ }
60
+ return w, ""
61
+ }
62
+ func sameReadOnlyRequest(op *cohortOperation, w *readOnlyWork, root readOnlyRootWitness, metadata bool) bool {
63
+ if op.work == nil || op.work.Action != w.Action || !slices.Equal(op.work.Segments, w.Segments) || op.work.Limit != w.Limit {
64
+ return false
65
+ }
66
+ if op.root == nil {
67
+ if root != nil {
68
+ return false
69
+ }
70
+ } else if root == nil || !op.root.sameReadOnlyRoot(root) {
71
+ return false
72
+ }
73
+ return !metadata || op.work.MaxBytes == w.MaxBytes
74
+ }
75
+ func cloneReadOnlyResult(r *readOnlyResult) *readOnlyResult {
76
+ b, err := json.Marshal(r)
77
+ if err != nil {
78
+ return nil
79
+ }
80
+ var result readOnlyResult
81
+ if json.Unmarshal(b, &result) != nil {
82
+ return nil
83
+ }
84
+ return &result
85
+ }
@@ -0,0 +1,253 @@
1
+ package helper
2
+
3
+ import (
4
+ "bytes"
5
+ "context"
6
+ "crypto/rand"
7
+ "encoding/hex"
8
+ "encoding/json"
9
+ "fmt"
10
+ "os"
11
+ "path/filepath"
12
+ "strings"
13
+ "testing"
14
+ "time"
15
+ )
16
+
17
+ func readOnlyVMFixture(t *testing.T) LinuxProcesses {
18
+ t.Helper()
19
+ source := os.Getenv("M2_S5_FIXTURE")
20
+ if source == "" {
21
+ t.Skip("NIC-free root VM fixture")
22
+ }
23
+ digest, err := executableDigest(source)
24
+ if err != nil {
25
+ t.Fatal(err)
26
+ }
27
+ i := Inventory{Package: "root", Version: "1.0.0-0001", Protocol: 2, PayloadDigest: digest, RegistryDigest: strings.Repeat("b", 64)}
28
+ c := NewClient(i)
29
+ for _, dir := range []string{c.StateDir, c.RunDir} {
30
+ if err := os.Mkdir(dir, 0700); err != nil {
31
+ t.Fatal(err)
32
+ }
33
+ t.Cleanup(func() { os.RemoveAll(dir) })
34
+ }
35
+ binary := c.StateDir + "/payload-" + digest
36
+ b, err := os.ReadFile(source)
37
+ if err != nil {
38
+ t.Fatal(err)
39
+ }
40
+ if err := os.WriteFile(binary, b, 0700); err != nil {
41
+ t.Fatal(err)
42
+ }
43
+ root := "/tmp/m2-s5-operations"
44
+ if err := os.Mkdir(root, 0755); err != nil {
45
+ t.Fatal(err)
46
+ }
47
+ t.Cleanup(func() { os.RemoveAll(root) })
48
+ os.WriteFile(root+"/group", bytes.Repeat([]byte("group-only;"), 20000), 0640)
49
+ os.Chown(root+"/group", 0, 105)
50
+ os.WriteFile(root+"/denied", []byte("denied-canary"), 0600)
51
+ vmUnit(t, "start")
52
+ return LinuxProcesses{Client: c, Binary: binary}
53
+ }
54
+ func readOnlyVMRef(t *testing.T) string {
55
+ t.Helper()
56
+ var b [32]byte
57
+ if _, e := rand.Read(b[:]); e != nil {
58
+ t.Fatal(e)
59
+ }
60
+ return hex.EncodeToString(b[:])
61
+ }
62
+ func readOnlyVMRequest(t *testing.T, g Grant, act Action, args any) DataRequest {
63
+ b, _ := json.Marshal(args)
64
+ return DataRequest{Inventory: g.Inventory, Epoch: g.LastValidated.Epoch, Op: act, GrantID: g.ID, GrantRevision: g.Revision, OperationID: readOnlyVMRef(t), Nonce: readOnlyVMRef(t), Ticket: readOnlyVMRef(t), Args: b}
65
+ }
66
+ func grantVMMetadata(t *testing.T, p LinuxProcesses, r DataRequest) *readOnlyResult {
67
+ t.Helper()
68
+ ctx, cancel := context.WithTimeout(context.Background(), 4*time.Second)
69
+ defer cancel()
70
+ var value *readOnlyResult
71
+ if err := waitHealthy(ctx, func(context.Context) bool {
72
+ r.Nonce = readOnlyVMRef(t)
73
+ r.Ticket = readOnlyVMRef(t)
74
+ res := grantVMCall(t, p, "operation.result", r)
75
+ if res.Code == ErrBusy {
76
+ return false
77
+ }
78
+ if res.Code != "" || res.Files == nil {
79
+ t.Fatalf("metadata refused: %+v", res)
80
+ }
81
+ value = res.Files
82
+ return true
83
+ }); err != nil {
84
+ t.Fatal(err)
85
+ }
86
+ return value
87
+ }
88
+ func readOnlyVMCreate(t *testing.T, p LinuxProcesses) Grant {
89
+ t.Helper()
90
+ res := grantVMCall(t, p, "prepare", grantPrepareArgs{grantRef('c'), ScopePersonal, []Action{ActionRead, ActionStat, ActionList}})
91
+ if res.Code != "" || res.Intent == nil {
92
+ t.Fatal(res)
93
+ }
94
+ b, e := os.ReadFile(filepath.Join(p.StateDir, "grants.json"))
95
+ if e != nil {
96
+ t.Fatal(e)
97
+ }
98
+ store, code := DecodeGrantStore(bytes.NewReader(b))
99
+ if code != "" {
100
+ t.Fatal(code)
101
+ }
102
+ res = grantVMCall(t, p, "confirm", grantConfirmArgs{res.Intent.ID, res.Intent.SummaryDigest, store.Revision})
103
+ if res.Code != "" || res.Grant == nil {
104
+ t.Fatal(res)
105
+ }
106
+ return *res.Grant
107
+ }
108
+ func TestLinuxReadOnlyProtocol2ChildrenRelayAndReap(t *testing.T) {
109
+ p := readOnlyVMFixture(t)
110
+ proc := startVMHelper(t, p)
111
+ g := readOnlyVMCreate(t, p)
112
+ for _, kind := range []string{"stat", "list", "read", "deny"} {
113
+ os.Remove(p.RunDir + "/fixture-readonly-bytes")
114
+ act := ActionRead
115
+ var args any = ReadArgs{Segments: []string{"group"}, MaxBytes: MaxBoundedBytes}
116
+ switch kind {
117
+ case "stat":
118
+ act = ActionStat
119
+ args = StatArgs{Segments: []string{"group"}}
120
+ case "list":
121
+ act = ActionList
122
+ args = ListArgs{Segments: []string{}, Limit: 20}
123
+ case "deny":
124
+ args = ReadArgs{Segments: []string{"denied"}, MaxBytes: MaxBoundedBytes}
125
+ }
126
+ r := readOnlyVMRequest(t, g, act, args)
127
+ if res := grantVMCall(t, p, "operation.start", r); res.Code != "" {
128
+ t.Fatal(res)
129
+ }
130
+ result := grantVMMetadata(t, p, r)
131
+ for sent := uint64(0); sent < result.Bytes; {
132
+ n := result.Bytes - sent
133
+ if n > MaxChunkBytes {
134
+ n = MaxChunkBytes
135
+ }
136
+ chunk := r
137
+ chunk.Nonce = readOnlyVMRef(t)
138
+ chunk.Ticket = readOnlyVMRef(t)
139
+ chunk.Args, _ = json.Marshal(ReadArgs{Segments: []string{"group"}, MaxBytes: n})
140
+ res := grantVMCall(t, p, "operation.chunk", chunk)
141
+ if res.Code == ErrBusy {
142
+ time.Sleep(10 * time.Millisecond)
143
+ continue
144
+ }
145
+ if res.Code != "" {
146
+ t.Fatal(res)
147
+ }
148
+ sent += n
149
+ }
150
+ ctx, cancel := context.WithTimeout(context.Background(), 4*time.Second)
151
+ if waitHealthy(ctx, func(context.Context) bool {
152
+ _, err := os.Stat(p.RunDir + "/fixture-readonly-bytes")
153
+ return err == nil && len(processChildren(proc.PID)) == 1
154
+ }) != nil {
155
+ cancel()
156
+ t.Fatal(kind, "operation did not reap")
157
+ }
158
+ cancel()
159
+ data, err := os.ReadFile(p.RunDir + "/fixture-readonly-bytes")
160
+ if err != nil {
161
+ t.Fatal(err)
162
+ }
163
+ switch kind {
164
+ case "stat":
165
+ if result.Code != "" || result.Entry == nil || result.Entry.Bytes != 220000 || len(data) != 0 {
166
+ t.Fatal(result)
167
+ }
168
+ case "list":
169
+ if result.Code != "" || result.List == nil || len(result.List.Entries) != 1 || result.List.Entries[0].Name != "group" || len(data) != 0 {
170
+ t.Fatal(result)
171
+ }
172
+ case "read":
173
+ expected, _ := os.ReadFile("/tmp/m2-s5-operations/group")
174
+ if result.Code != "" || !bytes.Equal(data, expected) {
175
+ t.Fatal(result, len(data))
176
+ }
177
+ case "deny":
178
+ if result.Code != ErrDenied || len(data) != 0 || result.Entry != nil || result.List != nil {
179
+ t.Fatal("denied metadata escaped", result)
180
+ }
181
+ }
182
+ }
183
+ vmUnit(t, "stop")
184
+ ctx, cancel := context.WithTimeout(context.Background(), 4*time.Second)
185
+ defer cancel()
186
+ if waitHealthy(ctx, func(context.Context) bool {
187
+ r, e := readRecord(p.StateDir, 0)
188
+ return e == nil && r.Lifecycle.Phase == "stopped"
189
+ }) != nil {
190
+ t.Fatal("autonomous completion missing")
191
+ }
192
+ record, _ := readRecord(p.StateDir, 0)
193
+ proof, err := completionRecord(p.Client, record)
194
+ if err != nil || proof.Cohort == nil || proof.Cohort.Started != 4 || proof.Cohort.Reaped != 4 || !proof.Cohort.RelaysStopped {
195
+ t.Fatal(proof, err)
196
+ }
197
+ }
198
+ func TestLinuxReadOnlyBlockedRelayRevokeUsesExistingS3Quiescence(t *testing.T) {
199
+ p := readOnlyVMFixture(t)
200
+ proc := startVMHelper(t, p)
201
+ g := readOnlyVMCreate(t, p)
202
+ os.WriteFile(p.RunDir+"/fixture-readonly-block-output", nil, 0600)
203
+ r := readOnlyVMRequest(t, g, ActionRead, ReadArgs{Segments: []string{"group"}, MaxBytes: MaxBoundedBytes})
204
+ if res := grantVMCall(t, p, "operation.start", r); res.Code != "" {
205
+ t.Fatal(res)
206
+ }
207
+ result := grantVMMetadata(t, p, r)
208
+ if result.Code != "" || result.Bytes == 0 {
209
+ t.Fatal(result)
210
+ }
211
+ chunk := r
212
+ chunk.Nonce = readOnlyVMRef(t)
213
+ chunk.Ticket = readOnlyVMRef(t)
214
+ chunk.Args, _ = json.Marshal(ReadArgs{Segments: []string{"group"}, MaxBytes: MaxChunkBytes})
215
+ if res := grantVMCall(t, p, "operation.chunk", chunk); res.Code != "" {
216
+ t.Fatal(res)
217
+ }
218
+ children := processChildren(proc.PID)
219
+ if len(children) != 2 {
220
+ t.Fatal("missing owned child", children)
221
+ }
222
+ b, _ := os.ReadFile(p.StateDir + "/grants.json")
223
+ store, code := DecodeGrantStore(bytes.NewReader(b))
224
+ if code != "" {
225
+ t.Fatal(code)
226
+ }
227
+ res := grantVMCall(t, p, "revoke", grantRevokeArgs{g.ID, g.Revision, store.Revision})
228
+ if res.Code != "" || res.Revoke == nil || !res.Revoke.Revoked || !res.Revoke.Drained {
229
+ t.Fatal(res)
230
+ }
231
+ b, err := os.ReadFile(p.StateDir + "/grant-q-" + g.ID + ".json")
232
+ var q GrantQuiescence
233
+ if err != nil || json.Unmarshal(b, &q) != nil || !completeQuiescence(q) || q.Cohort == nil || q.Cohort.Started != 1 || q.Cohort.Reaped != 1 || q.Cohort.AdmittedBytes != MaxChunkBytes {
234
+ t.Fatal(q, err)
235
+ }
236
+ if len(processChildren(proc.PID)) != 1 {
237
+ t.Fatal("Q before reap")
238
+ }
239
+ if res := grantVMCall(t, p, "operation.result", r); res.Code == "" || res.Files != nil {
240
+ t.Fatal("metadata after R", res)
241
+ }
242
+ if res := grantVMCall(t, p, "operation.chunk", chunk); res.Code == "" {
243
+ t.Fatal("lease after R", res)
244
+ }
245
+ if err := (Controller{Client: p.Client, Processes: p, Observe: observeLinux}).Control(context.Background(), "teardown"); err != nil {
246
+ t.Fatal(err)
247
+ }
248
+ for _, pid := range children {
249
+ if _, e := os.Stat(fmt.Sprintf("/proc/%d", pid)); !os.IsNotExist(e) {
250
+ t.Fatal("child survived teardown", pid)
251
+ }
252
+ }
253
+ }