oysterav 0.2.2__tar.gz

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 (450) hide show
  1. oysterav-0.2.2/.github/dependabot.yml +14 -0
  2. oysterav-0.2.2/.github/workflows/ci.yml +51 -0
  3. oysterav-0.2.2/.github/workflows/publish-pypi.yml +41 -0
  4. oysterav-0.2.2/.github/workflows/release.yml +345 -0
  5. oysterav-0.2.2/.github/workflows/runtime.yml +26 -0
  6. oysterav-0.2.2/.github/workflows/scorecard.yml +42 -0
  7. oysterav-0.2.2/.github/workflows/security-attacker-sim.yml +26 -0
  8. oysterav-0.2.2/.github/workflows/security-scan.yml +43 -0
  9. oysterav-0.2.2/.gitignore +28 -0
  10. oysterav-0.2.2/.pre-commit-config.yaml +21 -0
  11. oysterav-0.2.2/.vscode/extensions.json +22 -0
  12. oysterav-0.2.2/.vscode/settings.json +31 -0
  13. oysterav-0.2.2/AGENTS.md +143 -0
  14. oysterav-0.2.2/CHANGELOG.md +114 -0
  15. oysterav-0.2.2/LICENSE +674 -0
  16. oysterav-0.2.2/PKG-INFO +213 -0
  17. oysterav-0.2.2/README.md +173 -0
  18. oysterav-0.2.2/SECURITY.md +59 -0
  19. oysterav-0.2.2/VERSION +1 -0
  20. oysterav-0.2.2/bandit.yaml +18 -0
  21. oysterav-0.2.2/branding/README.md +38 -0
  22. oysterav-0.2.2/branding/alt/oysterAV-icon-pixel.png +0 -0
  23. oysterav-0.2.2/branding/hicolor/128x128/apps/oysterav.png +0 -0
  24. oysterav-0.2.2/branding/hicolor/16x16/apps/oysterav.png +0 -0
  25. oysterav-0.2.2/branding/hicolor/256x256/apps/oysterav.png +0 -0
  26. oysterav-0.2.2/branding/hicolor/32x32/apps/oysterav.png +0 -0
  27. oysterav-0.2.2/branding/hicolor/48x48/apps/oysterav.png +0 -0
  28. oysterav-0.2.2/branding/hicolor/512x512/apps/oysterav.png +0 -0
  29. oysterav-0.2.2/branding/oysterAV-icon.jpg +0 -0
  30. oysterav-0.2.2/branding/oysterAV-icon.png +0 -0
  31. oysterav-0.2.2/branding/oysterAV-icon2.jpg +0 -0
  32. oysterav-0.2.2/cliff.toml +51 -0
  33. oysterav-0.2.2/docs/adr/001-orchestrator-not-engine.md +23 -0
  34. oysterav-0.2.2/docs/adr/002-cli-first-gui-is-client.md +24 -0
  35. oysterav-0.2.2/docs/adr/003-pack-tier-policy.md +30 -0
  36. oysterav-0.2.2/docs/adr/004-pack-runtime-delivery.md +50 -0
  37. oysterav-0.2.2/docs/adr/005-cli-production-phase.md +45 -0
  38. oysterav-0.2.2/docs/adr/006-dependency-scope.md +57 -0
  39. oysterav-0.2.2/docs/adr/007-gui-remapping-phase.md +47 -0
  40. oysterav-0.2.2/docs/adr/008-clamav-host-cocontrol.md +153 -0
  41. oysterav-0.2.2/docs/adr/009-privilege-concert.md +73 -0
  42. oysterav-0.2.2/docs/adr/README.md +17 -0
  43. oysterav-0.2.2/docs/assets/oysterav-icon-256.png +0 -0
  44. oysterav-0.2.2/docs/assets/screenshots/README.md +19 -0
  45. oysterav-0.2.2/docs/assets/screenshots/dashboard.png +0 -0
  46. oysterav-0.2.2/docs/assets/screenshots/reports.png +0 -0
  47. oysterav-0.2.2/docs/assets/screenshots/scan.png +0 -0
  48. oysterav-0.2.2/docs/assets/screenshots/settings.png +0 -0
  49. oysterav-0.2.2/docs/cli/clamav-yara.md +69 -0
  50. oysterav-0.2.2/docs/cli/gui-contract.md +469 -0
  51. oysterav-0.2.2/docs/cli/pack-commands.md +89 -0
  52. oysterav-0.2.2/docs/cli/reference.md +354 -0
  53. oysterav-0.2.2/docs/cli/rpc-schema.md +179 -0
  54. oysterav-0.2.2/docs/packaging/distro-submit.md +32 -0
  55. oysterav-0.2.2/docs/packaging/release.md +99 -0
  56. oysterav-0.2.2/docs/security/asvs-checklist.md +167 -0
  57. oysterav-0.2.2/docs/security/attacker-sim.md +65 -0
  58. oysterav-0.2.2/docs/security/dependency-exceptions.md +6 -0
  59. oysterav-0.2.2/docs/security/firewall-audit-2026-07-26.md +44 -0
  60. oysterav-0.2.2/docs/security/full-surface-audit-2026-07-23.md +130 -0
  61. oysterav-0.2.2/docs/security/full-surface-audit-2026-07-26.md +56 -0
  62. oysterav-0.2.2/docs/security/hardening-audit-2026-07.md +118 -0
  63. oysterav-0.2.2/docs/security/test-gates.md +80 -0
  64. oysterav-0.2.2/docs/user-guide/clamonacc-prevention.md +230 -0
  65. oysterav-0.2.2/docs/user-guide/getting-started.md +133 -0
  66. oysterav-0.2.2/oyst_cli/__init__.py +1 -0
  67. oysterav-0.2.2/oyst_cli/commands/__init__.py +0 -0
  68. oysterav-0.2.2/oyst_cli/commands/audit_cmd.py +30 -0
  69. oysterav-0.2.2/oyst_cli/commands/auth_cmd.py +60 -0
  70. oysterav-0.2.2/oyst_cli/commands/config_cmd.py +63 -0
  71. oysterav-0.2.2/oyst_cli/commands/desktop_cmd.py +141 -0
  72. oysterav-0.2.2/oyst_cli/commands/doctor.py +42 -0
  73. oysterav-0.2.2/oyst_cli/commands/install_helper_cmd.py +48 -0
  74. oysterav-0.2.2/oyst_cli/commands/job_cmd.py +45 -0
  75. oysterav-0.2.2/oyst_cli/commands/maintenance.py +72 -0
  76. oysterav-0.2.2/oyst_cli/commands/news_cmd.py +127 -0
  77. oysterav-0.2.2/oyst_cli/commands/pack_install_cmd.py +47 -0
  78. oysterav-0.2.2/oyst_cli/commands/packs/__init__.py +31 -0
  79. oysterav-0.2.2/oyst_cli/commands/packs/clamav_cmd.py +126 -0
  80. oysterav-0.2.2/oyst_cli/commands/packs/clamonacc_cmd.py +144 -0
  81. oysterav-0.2.2/oyst_cli/commands/packs/fail2ban_cmd.py +107 -0
  82. oysterav-0.2.2/oyst_cli/commands/packs/firewall_cmd.py +314 -0
  83. oysterav-0.2.2/oyst_cli/commands/packs/firewall_cmd_firewalld.py +161 -0
  84. oysterav-0.2.2/oyst_cli/commands/packs/firewall_cmd_manage.py +79 -0
  85. oysterav-0.2.2/oyst_cli/commands/packs/lynis_cmd.py +107 -0
  86. oysterav-0.2.2/oyst_cli/commands/packs/maldet_cmd.py +158 -0
  87. oysterav-0.2.2/oyst_cli/commands/packs/rkhunter_cmd.py +143 -0
  88. oysterav-0.2.2/oyst_cli/commands/packs/signatures_cmd.py +135 -0
  89. oysterav-0.2.2/oyst_cli/commands/quarantine.py +211 -0
  90. oysterav-0.2.2/oyst_cli/commands/runtime_cmd.py +194 -0
  91. oysterav-0.2.2/oyst_cli/commands/scan.py +104 -0
  92. oysterav-0.2.2/oyst_cli/commands/schedule_cmd.py +361 -0
  93. oysterav-0.2.2/oyst_cli/commands/services_cmd.py +40 -0
  94. oysterav-0.2.2/oyst_cli/commands/setup_cmd.py +225 -0
  95. oysterav-0.2.2/oyst_cli/commands/status.py +223 -0
  96. oysterav-0.2.2/oyst_cli/commands/terminal_cmd.py +89 -0
  97. oysterav-0.2.2/oyst_cli/commands/updates_cmd.py +74 -0
  98. oysterav-0.2.2/oyst_cli/commands/version_cmd.py +43 -0
  99. oysterav-0.2.2/oyst_cli/commands/virusevent_cmd.py +61 -0
  100. oysterav-0.2.2/oyst_cli/confirm.py +18 -0
  101. oysterav-0.2.2/oyst_cli/main.py +188 -0
  102. oysterav-0.2.2/oyst_cli/options.py +23 -0
  103. oysterav-0.2.2/oyst_cli/output.py +39 -0
  104. oysterav-0.2.2/oyst_cli/progress.py +70 -0
  105. oysterav-0.2.2/oyst_core/__init__.py +25 -0
  106. oysterav-0.2.2/oyst_core/app_release.py +214 -0
  107. oysterav-0.2.2/oyst_core/audit.py +159 -0
  108. oysterav-0.2.2/oyst_core/client.py +176 -0
  109. oysterav-0.2.2/oyst_core/client_api.py +338 -0
  110. oysterav-0.2.2/oyst_core/client_api_shield.py +207 -0
  111. oysterav-0.2.2/oyst_core/config.py +76 -0
  112. oysterav-0.2.2/oyst_core/config_access.py +331 -0
  113. oysterav-0.2.2/oyst_core/config_io.py +184 -0
  114. oysterav-0.2.2/oyst_core/config_models.py +231 -0
  115. oysterav-0.2.2/oyst_core/desktop_icons.py +186 -0
  116. oysterav-0.2.2/oyst_core/desktop_util.py +215 -0
  117. oysterav-0.2.2/oyst_core/doctor_cache.py +40 -0
  118. oysterav-0.2.2/oyst_core/events.py +53 -0
  119. oysterav-0.2.2/oyst_core/events_history.py +227 -0
  120. oysterav-0.2.2/oyst_core/events_jobs.py +190 -0
  121. oysterav-0.2.2/oyst_core/finding_status.py +40 -0
  122. oysterav-0.2.2/oyst_core/health.py +216 -0
  123. oysterav-0.2.2/oyst_core/history_actions.py +213 -0
  124. oysterav-0.2.2/oyst_core/history_export.py +175 -0
  125. oysterav-0.2.2/oyst_core/logging_util.py +30 -0
  126. oysterav-0.2.2/oyst_core/maintenance.py +85 -0
  127. oysterav-0.2.2/oyst_core/models.py +130 -0
  128. oysterav-0.2.2/oyst_core/orchestrator.py +268 -0
  129. oysterav-0.2.2/oyst_core/orchestrator_helpers.py +206 -0
  130. oysterav-0.2.2/oyst_core/orchestrator_scan_concert.py +102 -0
  131. oysterav-0.2.2/oyst_core/pack_install.py +283 -0
  132. oysterav-0.2.2/oyst_core/pack_jobs.py +80 -0
  133. oysterav-0.2.2/oyst_core/pack_sources.py +194 -0
  134. oysterav-0.2.2/oyst_core/packs/__init__.py +1 -0
  135. oysterav-0.2.2/oyst_core/packs/base.py +149 -0
  136. oysterav-0.2.2/oyst_core/packs/chkrootkit.py +101 -0
  137. oysterav-0.2.2/oyst_core/packs/clamav.py +280 -0
  138. oysterav-0.2.2/oyst_core/packs/clamd_ensure.py +297 -0
  139. oysterav-0.2.2/oyst_core/packs/clamd_onaccess.py +277 -0
  140. oysterav-0.2.2/oyst_core/packs/clamonacc.py +244 -0
  141. oysterav-0.2.2/oyst_core/packs/fail2ban.py +177 -0
  142. oysterav-0.2.2/oyst_core/packs/fangfrisch.py +156 -0
  143. oysterav-0.2.2/oyst_core/packs/firewall.py +181 -0
  144. oysterav-0.2.2/oyst_core/packs/firewall_batch.py +116 -0
  145. oysterav-0.2.2/oyst_core/packs/firewall_ensure.py +101 -0
  146. oysterav-0.2.2/oyst_core/packs/firewall_ops.py +398 -0
  147. oysterav-0.2.2/oyst_core/packs/firewall_select.py +74 -0
  148. oysterav-0.2.2/oyst_core/packs/firewall_ufw_read.py +214 -0
  149. oysterav-0.2.2/oyst_core/packs/freshclam.py +119 -0
  150. oysterav-0.2.2/oyst_core/packs/lynis.py +182 -0
  151. oysterav-0.2.2/oyst_core/packs/maldet.py +259 -0
  152. oysterav-0.2.2/oyst_core/packs/maldet_parse.py +200 -0
  153. oysterav-0.2.2/oyst_core/packs/rkhunter.py +151 -0
  154. oysterav-0.2.2/oyst_core/packs/rkhunter_disable_tests.py +99 -0
  155. oysterav-0.2.2/oyst_core/packs/rkhunter_overlay.py +208 -0
  156. oysterav-0.2.2/oyst_core/packs/rkhunter_resolve.py +69 -0
  157. oysterav-0.2.2/oyst_core/packs/rkhunter_resolve_plan.py +194 -0
  158. oysterav-0.2.2/oyst_core/packs/rkhunter_resolve_preview.py +73 -0
  159. oysterav-0.2.2/oyst_core/packs/unhide.py +90 -0
  160. oysterav-0.2.2/oyst_core/privilege/__init__.py +46 -0
  161. oysterav-0.2.2/oyst_core/privilege/plan.py +51 -0
  162. oysterav-0.2.2/oyst_core/privilege/preflight.py +38 -0
  163. oysterav-0.2.2/oyst_core/privilege/priority.py +107 -0
  164. oysterav-0.2.2/oyst_core/privilege/recipes.py +291 -0
  165. oysterav-0.2.2/oyst_core/privilege/recipes_firewall.py +61 -0
  166. oysterav-0.2.2/oyst_core/privilege/recipes_update.py +134 -0
  167. oysterav-0.2.2/oyst_core/privilege/run.py +74 -0
  168. oysterav-0.2.2/oyst_core/privileged/__init__.py +6 -0
  169. oysterav-0.2.2/oyst_core/privileged/auth_grant.py +330 -0
  170. oysterav-0.2.2/oyst_core/privileged/auth_grant_expire.py +139 -0
  171. oysterav-0.2.2/oyst_core/privileged/auth_grant_scope.py +67 -0
  172. oysterav-0.2.2/oyst_core/privileged/elevate_cli.py +217 -0
  173. oysterav-0.2.2/oyst_core/privileged/helper.py +146 -0
  174. oysterav-0.2.2/oyst_core/privileged/helper_clamd.py +302 -0
  175. oysterav-0.2.2/oyst_core/privileged/helper_clamd_unit.py +208 -0
  176. oysterav-0.2.2/oyst_core/privileged/helper_concert.py +63 -0
  177. oysterav-0.2.2/oyst_core/privileged/helper_fail2ban.py +122 -0
  178. oysterav-0.2.2/oyst_core/privileged/helper_firewall.py +172 -0
  179. oysterav-0.2.2/oyst_core/privileged/helper_firewall_batch.py +175 -0
  180. oysterav-0.2.2/oyst_core/privileged/helper_fw_enable.py +110 -0
  181. oysterav-0.2.2/oyst_core/privileged/helper_fw_lifecycle.py +326 -0
  182. oysterav-0.2.2/oyst_core/privileged/helper_install_script.py +144 -0
  183. oysterav-0.2.2/oyst_core/privileged/helper_scan_concert.py +159 -0
  184. oysterav-0.2.2/oyst_core/privileged/helper_sealed_scanner.py +114 -0
  185. oysterav-0.2.2/oyst_core/privileged/helper_services.py +143 -0
  186. oysterav-0.2.2/oyst_core/privileged/helper_setup_concert.py +170 -0
  187. oysterav-0.2.2/oyst_core/privileged/helper_setup_harden.py +185 -0
  188. oysterav-0.2.2/oyst_core/privileged/helper_update_concert.py +85 -0
  189. oysterav-0.2.2/oyst_core/privileged/helper_validate.py +317 -0
  190. oysterav-0.2.2/oyst_core/privileged/install_privileged_helper.py +310 -0
  191. oysterav-0.2.2/oyst_core/privileged/oyst_helper.py +206 -0
  192. oysterav-0.2.2/oyst_core/privileged/polkit_policy.py +178 -0
  193. oysterav-0.2.2/oyst_core/privileged/runner.py +235 -0
  194. oysterav-0.2.2/oyst_core/privileged/safe_write.py +28 -0
  195. oysterav-0.2.2/oyst_core/privileged/scanner_exec.py +86 -0
  196. oysterav-0.2.2/oyst_core/privileged/systemctl_route.py +22 -0
  197. oysterav-0.2.2/oyst_core/privileged/validators.py +201 -0
  198. oysterav-0.2.2/oyst_core/quarantine.py +338 -0
  199. oysterav-0.2.2/oyst_core/quarantine_guards.py +62 -0
  200. oysterav-0.2.2/oyst_core/registry.py +57 -0
  201. oysterav-0.2.2/oyst_core/rpc_auth.py +93 -0
  202. oysterav-0.2.2/oyst_core/rpc_errors.py +30 -0
  203. oysterav-0.2.2/oyst_core/rpc_handlers/__init__.py +147 -0
  204. oysterav-0.2.2/oyst_core/rpc_handlers/config_schedule.py +58 -0
  205. oysterav-0.2.2/oyst_core/rpc_handlers/data.py +185 -0
  206. oysterav-0.2.2/oyst_core/rpc_handlers/jobs.py +70 -0
  207. oysterav-0.2.2/oyst_core/rpc_handlers/shield_fw.py +263 -0
  208. oysterav-0.2.2/oyst_core/rpc_handlers/status_pack.py +87 -0
  209. oysterav-0.2.2/oyst_core/rpc_handlers/system.py +264 -0
  210. oysterav-0.2.2/oyst_core/rpc_io.py +92 -0
  211. oysterav-0.2.2/oyst_core/runtime/__init__.py +17 -0
  212. oysterav-0.2.2/oyst_core/runtime/bootstrap.py +320 -0
  213. oysterav-0.2.2/oyst_core/runtime/bundles/__init__.py +1 -0
  214. oysterav-0.2.2/oyst_core/runtime/bundles/clamav.py +102 -0
  215. oysterav-0.2.2/oyst_core/runtime/bundles/fangfrisch_bundle.py +72 -0
  216. oysterav-0.2.2/oyst_core/runtime/bundles/lynis_bundle.py +141 -0
  217. oysterav-0.2.2/oyst_core/runtime/bundles/rootkit_bundles.py +218 -0
  218. oysterav-0.2.2/oyst_core/runtime/bundles/scanners.py +23 -0
  219. oysterav-0.2.2/oyst_core/runtime/checksums.json +6 -0
  220. oysterav-0.2.2/oyst_core/runtime/checksums.py +38 -0
  221. oysterav-0.2.2/oyst_core/runtime/download.py +61 -0
  222. oysterav-0.2.2/oyst_core/runtime/manifest.py +128 -0
  223. oysterav-0.2.2/oyst_core/runtime/progress.py +27 -0
  224. oysterav-0.2.2/oyst_core/runtime/resolver.py +102 -0
  225. oysterav-0.2.2/oyst_core/runtime_full_bootstrap.py +96 -0
  226. oysterav-0.2.2/oyst_core/scan_excludes.py +50 -0
  227. oysterav-0.2.2/oyst_core/schedule_linger.py +122 -0
  228. oysterav-0.2.2/oyst_core/schedule_time.py +76 -0
  229. oysterav-0.2.2/oyst_core/schedule_units.py +387 -0
  230. oysterav-0.2.2/oyst_core/schedule_util.py +58 -0
  231. oysterav-0.2.2/oyst_core/schedule_validate.py +37 -0
  232. oysterav-0.2.2/oyst_core/security_news.py +58 -0
  233. oysterav-0.2.2/oyst_core/security_news_fetch.py +320 -0
  234. oysterav-0.2.2/oyst_core/security_news_parse.py +172 -0
  235. oysterav-0.2.2/oyst_core/security_news_sources.py +161 -0
  236. oysterav-0.2.2/oyst_core/serve.py +182 -0
  237. oysterav-0.2.2/oyst_core/services.py +267 -0
  238. oysterav-0.2.2/oyst_core/setup_concert.py +275 -0
  239. oysterav-0.2.2/oyst_core/setup_harden.py +326 -0
  240. oysterav-0.2.2/oyst_core/setup_harden_fw.py +172 -0
  241. oysterav-0.2.2/oyst_core/setup_workflow.py +271 -0
  242. oysterav-0.2.2/oyst_core/terminal_log.py +342 -0
  243. oysterav-0.2.2/oyst_core/ui_theme.py +53 -0
  244. oysterav-0.2.2/oyst_core/updates.py +283 -0
  245. oysterav-0.2.2/oyst_core/updates_query.py +154 -0
  246. oysterav-0.2.2/oyst_core/virusevent.py +226 -0
  247. oysterav-0.2.2/oysterav/__init__.py +3 -0
  248. oysterav-0.2.2/oysterav/gui/__init__.py +5 -0
  249. oysterav-0.2.2/oysterav/gui/app.py +346 -0
  250. oysterav-0.2.2/oysterav/gui/dashboard_helpers.py +396 -0
  251. oysterav-0.2.2/oysterav/gui/finding_present.py +240 -0
  252. oysterav-0.2.2/oysterav/gui/rpc_actions.py +284 -0
  253. oysterav-0.2.2/oysterav/gui/rpc_actions_shield.py +263 -0
  254. oysterav-0.2.2/oysterav/gui/scan_helpers.py +160 -0
  255. oysterav-0.2.2/oysterav/gui/theme/__init__.py +69 -0
  256. oysterav-0.2.2/oysterav/gui/theme/css.py +309 -0
  257. oysterav-0.2.2/oysterav/gui/theme/manager.py +66 -0
  258. oysterav-0.2.2/oysterav/gui/theme/palettes.py +274 -0
  259. oysterav-0.2.2/oysterav/gui/tray.py +356 -0
  260. oysterav-0.2.2/oysterav/gui/widgets/__init__.py +17 -0
  261. oysterav-0.2.2/oysterav/gui/widgets/bulk_checklist.py +86 -0
  262. oysterav-0.2.2/oysterav/gui/widgets/clamonacc_ui.py +395 -0
  263. oysterav-0.2.2/oysterav/gui/widgets/common.py +387 -0
  264. oysterav-0.2.2/oysterav/gui/widgets/dashboard.py +313 -0
  265. oysterav-0.2.2/oysterav/gui/widgets/finding_actions_ui.py +215 -0
  266. oysterav-0.2.2/oysterav/gui/widgets/finding_list.py +247 -0
  267. oysterav-0.2.2/oysterav/gui/widgets/packs.py +239 -0
  268. oysterav-0.2.2/oysterav/gui/widgets/packs_display.py +91 -0
  269. oysterav-0.2.2/oysterav/gui/widgets/packs_install_all.py +208 -0
  270. oysterav-0.2.2/oysterav/gui/widgets/packs_install_ui.py +221 -0
  271. oysterav-0.2.2/oysterav/gui/widgets/privilege_confirm.py +47 -0
  272. oysterav-0.2.2/oysterav/gui/widgets/progress_button.py +52 -0
  273. oysterav-0.2.2/oysterav/gui/widgets/quarantine.py +331 -0
  274. oysterav-0.2.2/oysterav/gui/widgets/reports.py +393 -0
  275. oysterav-0.2.2/oysterav/gui/widgets/reports_actions.py +376 -0
  276. oysterav-0.2.2/oysterav/gui/widgets/reports_format.py +52 -0
  277. oysterav-0.2.2/oysterav/gui/widgets/runtime_ui.py +152 -0
  278. oysterav-0.2.2/oysterav/gui/widgets/scan.py +359 -0
  279. oysterav-0.2.2/oysterav/gui/widgets/scan_const.py +43 -0
  280. oysterav-0.2.2/oysterav/gui/widgets/scan_job_ui.py +328 -0
  281. oysterav-0.2.2/oysterav/gui/widgets/scan_path_ui.py +137 -0
  282. oysterav-0.2.2/oysterav/gui/widgets/scan_result_dialog.py +122 -0
  283. oysterav-0.2.2/oysterav/gui/widgets/schedule_ui.py +209 -0
  284. oysterav-0.2.2/oysterav/gui/widgets/services_ui.py +345 -0
  285. oysterav-0.2.2/oysterav/gui/widgets/settings.py +388 -0
  286. oysterav-0.2.2/oysterav/gui/widgets/settings_const.py +58 -0
  287. oysterav-0.2.2/oysterav/gui/widgets/settings_general_ui.py +351 -0
  288. oysterav-0.2.2/oysterav/gui/widgets/settings_host_audit_ui.py +74 -0
  289. oysterav-0.2.2/oysterav/gui/widgets/settings_maintenance_ui.py +283 -0
  290. oysterav-0.2.2/oysterav/gui/widgets/settings_maintenance_update.py +96 -0
  291. oysterav-0.2.2/oysterav/gui/widgets/settings_schedule_apply.py +287 -0
  292. oysterav-0.2.2/oysterav/gui/widgets/settings_schedule_build.py +163 -0
  293. oysterav-0.2.2/oysterav/gui/widgets/settings_schedule_ui.py +11 -0
  294. oysterav-0.2.2/oysterav/gui/widgets/settings_terminal_ui.py +280 -0
  295. oysterav-0.2.2/oysterav/gui/widgets/setup_wizard.py +357 -0
  296. oysterav-0.2.2/oysterav/gui/widgets/setup_wizard_actions.py +299 -0
  297. oysterav-0.2.2/oysterav/gui/widgets/setup_wizard_auto.py +191 -0
  298. oysterav-0.2.2/oysterav/gui/widgets/setup_wizard_firewall.py +196 -0
  299. oysterav-0.2.2/oysterav/gui/widgets/setup_wizard_harden.py +106 -0
  300. oysterav-0.2.2/oysterav/gui/widgets/setup_wizard_harden_page.py +155 -0
  301. oysterav-0.2.2/oysterav/gui/widgets/setup_wizard_pages.py +259 -0
  302. oysterav-0.2.2/oysterav/gui/widgets/setup_wizard_text.py +107 -0
  303. oysterav-0.2.2/oysterav/gui/widgets/shield.py +360 -0
  304. oysterav-0.2.2/oysterav/gui/widgets/shield_fail2ban_ui.py +65 -0
  305. oysterav-0.2.2/oysterav/gui/widgets/shield_firewall_add_dialog.py +156 -0
  306. oysterav-0.2.2/oysterav/gui/widgets/shield_firewall_dialogs.py +229 -0
  307. oysterav-0.2.2/oysterav/gui/widgets/shield_firewall_rules_ui.py +202 -0
  308. oysterav-0.2.2/oysterav/gui/widgets/shield_firewall_ui.py +302 -0
  309. oysterav-0.2.2/oysterav/gui/widgets/status_bar.py +254 -0
  310. oysterav-0.2.2/oysterav/main.py +26 -0
  311. oysterav-0.2.2/packaging/arch/.SRCINFO +26 -0
  312. oysterav-0.2.2/packaging/arch/PKGBUILD +60 -0
  313. oysterav-0.2.2/packaging/arch/PKGBUILD.in +60 -0
  314. oysterav-0.2.2/packaging/aur/README.md +22 -0
  315. oysterav-0.2.2/packaging/debian/README.md +16 -0
  316. oysterav-0.2.2/packaging/debian/changelog +12 -0
  317. oysterav-0.2.2/packaging/debian/compat +1 -0
  318. oysterav-0.2.2/packaging/debian/control +37 -0
  319. oysterav-0.2.2/packaging/debian/copyright +17 -0
  320. oysterav-0.2.2/packaging/debian/oyst-helper.in +4 -0
  321. oysterav-0.2.2/packaging/debian/oysterav.install +12 -0
  322. oysterav-0.2.2/packaging/debian/rules +13 -0
  323. oysterav-0.2.2/packaging/debian/source/format +1 -0
  324. oysterav-0.2.2/packaging/fpm/after-install.sh +13 -0
  325. oysterav-0.2.2/packaging/lite/README.md +33 -0
  326. oysterav-0.2.2/packaging/lynis/container-host.prf +15 -0
  327. oysterav-0.2.2/packaging/oysterav/flatpak/README.md +51 -0
  328. oysterav-0.2.2/packaging/oysterav/flatpak/flathub/README.md +29 -0
  329. oysterav-0.2.2/packaging/oysterav/flatpak/flathub/io.github.asafelobotomy.OysterAV.yml +89 -0
  330. oysterav-0.2.2/packaging/oysterav/flatpak/io.github.asafelobotomy.OysterAV.metainfo.xml +61 -0
  331. oysterav-0.2.2/packaging/oysterav/flatpak/io.github.asafelobotomy.OysterAV.yml +39 -0
  332. oysterav-0.2.2/packaging/oysterav/io.github.asafelobotomy.OysterAV.desktop +12 -0
  333. oysterav-0.2.2/packaging/polkit/io.github.asafelobotomy.policy +186 -0
  334. oysterav-0.2.2/packaging/rpm/README.md +18 -0
  335. oysterav-0.2.2/packaging/rpm/oysterav.spec +87 -0
  336. oysterav-0.2.2/pyproject.toml +105 -0
  337. oysterav-0.2.2/scripts/attacker_sim.sh +70 -0
  338. oysterav-0.2.2/scripts/build_flatpak.sh +40 -0
  339. oysterav-0.2.2/scripts/build_native_packages.sh +114 -0
  340. oysterav-0.2.2/scripts/build_runtime.sh +32 -0
  341. oysterav-0.2.2/scripts/check.sh +99 -0
  342. oysterav-0.2.2/scripts/check_loc.py +164 -0
  343. oysterav-0.2.2/scripts/check_security_coverage.py +91 -0
  344. oysterav-0.2.2/scripts/loc_allowlist.json +5 -0
  345. oysterav-0.2.2/scripts/publish_aur.sh +38 -0
  346. oysterav-0.2.2/scripts/render_arch_pkgbuild.sh +75 -0
  347. oysterav-0.2.2/scripts/security.coveragerc +21 -0
  348. oysterav-0.2.2/scripts/sync_version.py +187 -0
  349. oysterav-0.2.2/tests/__init__.py +0 -0
  350. oysterav-0.2.2/tests/conftest.py +22 -0
  351. oysterav-0.2.2/tests/test_cli/__init__.py +0 -0
  352. oysterav-0.2.2/tests/test_cli/test_cli_audit_regressions.py +121 -0
  353. oysterav-0.2.2/tests/test_cli/test_cli_json_contracts.py +53 -0
  354. oysterav-0.2.2/tests/test_cli/test_commands.py +124 -0
  355. oysterav-0.2.2/tests/test_cli/test_confirm_safety.py +137 -0
  356. oysterav-0.2.2/tests/test_cli/test_exit_codes.py +130 -0
  357. oysterav-0.2.2/tests/test_cli/test_gui_cli_parity.py +230 -0
  358. oysterav-0.2.2/tests/test_cli/test_pack_commands.py +99 -0
  359. oysterav-0.2.2/tests/test_cli/test_rpc_parity.py +127 -0
  360. oysterav-0.2.2/tests/test_cli/test_services_auth_cli.py +132 -0
  361. oysterav-0.2.2/tests/test_cli/test_setup_workflow.py +215 -0
  362. oysterav-0.2.2/tests/test_cli/test_version_cmd.py +47 -0
  363. oysterav-0.2.2/tests/test_core/__init__.py +0 -0
  364. oysterav-0.2.2/tests/test_core/test_app_release.py +62 -0
  365. oysterav-0.2.2/tests/test_core/test_audit_privacy.py +38 -0
  366. oysterav-0.2.2/tests/test_core/test_clamd_ensure.py +221 -0
  367. oysterav-0.2.2/tests/test_core/test_clamd_onaccess.py +141 -0
  368. oysterav-0.2.2/tests/test_core/test_client_fallback.py +103 -0
  369. oysterav-0.2.2/tests/test_core/test_config_and_rpc.py +311 -0
  370. oysterav-0.2.2/tests/test_core/test_dashboard_helpers.py +167 -0
  371. oysterav-0.2.2/tests/test_core/test_desktop_icons.py +61 -0
  372. oysterav-0.2.2/tests/test_core/test_desktop_util.py +86 -0
  373. oysterav-0.2.2/tests/test_core/test_doctor_cache.py +47 -0
  374. oysterav-0.2.2/tests/test_core/test_elevate_cli.py +157 -0
  375. oysterav-0.2.2/tests/test_core/test_events_history.py +149 -0
  376. oysterav-0.2.2/tests/test_core/test_fangfrisch.py +43 -0
  377. oysterav-0.2.2/tests/test_core/test_fangfrisch_runtime.py +86 -0
  378. oysterav-0.2.2/tests/test_core/test_finding_present.py +124 -0
  379. oysterav-0.2.2/tests/test_core/test_finding_status.py +195 -0
  380. oysterav-0.2.2/tests/test_core/test_firewall_ops.py +381 -0
  381. oysterav-0.2.2/tests/test_core/test_health.py +74 -0
  382. oysterav-0.2.2/tests/test_core/test_helper_firewall_batch.py +114 -0
  383. oysterav-0.2.2/tests/test_core/test_helper_install_script.py +161 -0
  384. oysterav-0.2.2/tests/test_core/test_helper_sealed_scanner.py +75 -0
  385. oysterav-0.2.2/tests/test_core/test_helper_setup_concert.py +38 -0
  386. oysterav-0.2.2/tests/test_core/test_helper_setup_harden.py +70 -0
  387. oysterav-0.2.2/tests/test_core/test_helper_update_concert.py +77 -0
  388. oysterav-0.2.2/tests/test_core/test_history_export.py +90 -0
  389. oysterav-0.2.2/tests/test_core/test_install_matrix.py +54 -0
  390. oysterav-0.2.2/tests/test_core/test_job_cancel.py +130 -0
  391. oysterav-0.2.2/tests/test_core/test_job_status.py +64 -0
  392. oysterav-0.2.2/tests/test_core/test_maintenance.py +111 -0
  393. oysterav-0.2.2/tests/test_core/test_models.py +176 -0
  394. oysterav-0.2.2/tests/test_core/test_orchestrator_scan_concert.py +68 -0
  395. oysterav-0.2.2/tests/test_core/test_oyst_helper.py +319 -0
  396. oysterav-0.2.2/tests/test_core/test_pack_finding_parsers.py +184 -0
  397. oysterav-0.2.2/tests/test_core/test_pack_install.py +151 -0
  398. oysterav-0.2.2/tests/test_core/test_pack_jobs_bootstrap.py +173 -0
  399. oysterav-0.2.2/tests/test_core/test_pack_sources_maldet.py +34 -0
  400. oysterav-0.2.2/tests/test_core/test_pack_units.py +241 -0
  401. oysterav-0.2.2/tests/test_core/test_privilege_concert.py +219 -0
  402. oysterav-0.2.2/tests/test_core/test_quarantine.py +240 -0
  403. oysterav-0.2.2/tests/test_core/test_rkhunter_resolve.py +249 -0
  404. oysterav-0.2.2/tests/test_core/test_rpc_actions.py +203 -0
  405. oysterav-0.2.2/tests/test_core/test_rpc_auth.py +84 -0
  406. oysterav-0.2.2/tests/test_core/test_rpc_long_methods.py +15 -0
  407. oysterav-0.2.2/tests/test_core/test_runner_allowlist.py +142 -0
  408. oysterav-0.2.2/tests/test_core/test_runtime.py +125 -0
  409. oysterav-0.2.2/tests/test_core/test_runtime_remove_progress.py +138 -0
  410. oysterav-0.2.2/tests/test_core/test_scan_excludes.py +63 -0
  411. oysterav-0.2.2/tests/test_core/test_scan_pack_summary.py +111 -0
  412. oysterav-0.2.2/tests/test_core/test_scanner_exec.py +80 -0
  413. oysterav-0.2.2/tests/test_core/test_schedule_status.py +67 -0
  414. oysterav-0.2.2/tests/test_core/test_schedule_util.py +231 -0
  415. oysterav-0.2.2/tests/test_core/test_security_news.py +252 -0
  416. oysterav-0.2.2/tests/test_core/test_serve_dispatch.py +214 -0
  417. oysterav-0.2.2/tests/test_core/test_services_auth.py +468 -0
  418. oysterav-0.2.2/tests/test_core/test_setup_harden.py +222 -0
  419. oysterav-0.2.2/tests/test_core/test_shield_fw.py +117 -0
  420. oysterav-0.2.2/tests/test_core/test_terminal_log.py +124 -0
  421. oysterav-0.2.2/tests/test_core/test_thin_packs.py +80 -0
  422. oysterav-0.2.2/tests/test_core/test_ui_theme.py +80 -0
  423. oysterav-0.2.2/tests/test_core/test_updates.py +275 -0
  424. oysterav-0.2.2/tests/test_core/test_virusevent.py +74 -0
  425. oysterav-0.2.2/tests/test_gui/__init__.py +0 -0
  426. oysterav-0.2.2/tests/test_gui/test_bulk_checklist.py +17 -0
  427. oysterav-0.2.2/tests/test_gui/test_client.py +57 -0
  428. oysterav-0.2.2/tests/test_gui/test_format_helpers.py +50 -0
  429. oysterav-0.2.2/tests/test_gui/test_progress_button.py +11 -0
  430. oysterav-0.2.2/tests/test_gui/test_setup_wizard.py +122 -0
  431. oysterav-0.2.2/tests/test_security/__init__.py +8 -0
  432. oysterav-0.2.2/tests/test_security/corpora.py +369 -0
  433. oysterav-0.2.2/tests/test_security/test_attacker_sim_contract.py +50 -0
  434. oysterav-0.2.2/tests/test_security/test_audit_redaction.py +67 -0
  435. oysterav-0.2.2/tests/test_security/test_concert_abuse.py +128 -0
  436. oysterav-0.2.2/tests/test_security/test_eicar_detection_path.py +54 -0
  437. oysterav-0.2.2/tests/test_security/test_firewall_security_props.py +312 -0
  438. oysterav-0.2.2/tests/test_security/test_helper_argv_injection.py +112 -0
  439. oysterav-0.2.2/tests/test_security/test_helper_env_argc.py +122 -0
  440. oysterav-0.2.2/tests/test_security/test_helper_fw_lifecycle.py +229 -0
  441. oysterav-0.2.2/tests/test_security/test_helper_seal_install_adversarial.py +157 -0
  442. oysterav-0.2.2/tests/test_security/test_helper_services_argv.py +140 -0
  443. oysterav-0.2.2/tests/test_security/test_quarantine_refuse.py +69 -0
  444. oysterav-0.2.2/tests/test_security/test_rpc_adversarial.py +172 -0
  445. oysterav-0.2.2/tests/test_security/test_rpc_auth_hardening.py +101 -0
  446. oysterav-0.2.2/tests/test_security/test_rpc_dos_bounds.py +238 -0
  447. oysterav-0.2.2/tests/test_security/test_security_module_coverage.py +765 -0
  448. oysterav-0.2.2/tests/test_security/test_validators_adversarial.py +157 -0
  449. oysterav-0.2.2/tests/test_security/test_wave2_privilege.py +60 -0
  450. oysterav-0.2.2/uv.lock +573 -0
@@ -0,0 +1,14 @@
1
+ # Dependabot — keep Actions and Python deps visible for Scorecard / supply-chain hygiene.
2
+ version: 2
3
+ updates:
4
+ - package-ecosystem: github-actions
5
+ directory: /
6
+ schedule:
7
+ interval: weekly
8
+ open-pull-requests-limit: 5
9
+
10
+ - package-ecosystem: pip
11
+ directory: /
12
+ schedule:
13
+ interval: weekly
14
+ open-pull-requests-limit: 5
@@ -0,0 +1,51 @@
1
+ name: CI
2
+
3
+ on:
4
+ push:
5
+ branches: [main, master]
6
+ pull_request:
7
+ branches: [main, master]
8
+
9
+ permissions:
10
+ contents: read
11
+
12
+ jobs:
13
+ test:
14
+ runs-on: ubuntu-latest
15
+ steps:
16
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
17
+ - uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
18
+ with:
19
+ enable-cache: true
20
+ # PyGObject → pycairo needs cairo headers (uv sync --extra all / gui).
21
+ - name: Install GUI native build deps
22
+ run: |
23
+ sudo apt-get update
24
+ sudo apt-get install -y --no-install-recommends \
25
+ pkg-config \
26
+ python3-dev \
27
+ libcairo2-dev \
28
+ libgirepository-2.0-dev \
29
+ gir1.2-gtk-4.0 \
30
+ gir1.2-adw-1
31
+ - run: uv sync --extra all
32
+ - name: Version files must match VERSION
33
+ run: uv run python scripts/sync_version.py --check
34
+ - name: Production files must stay within 400-line hard limit
35
+ run: uv run python scripts/check_loc.py
36
+ - run: uv run ruff format --check oyst_core oyst_cli oysterav tests
37
+ - run: uv run ruff check oyst_core oyst_cli oysterav tests
38
+ - run: uv run mypy oyst_core oyst_cli oysterav
39
+ # Coverage sources + fail_under: pyproject.toml. Do not add --cov=oysterav.
40
+ - run: uv run pytest tests/ --cov=oyst_core --cov=oyst_cli --cov-report=term-missing
41
+ - name: Security property suite
42
+ run: uv run pytest -m security -q --no-cov
43
+ - name: Security module coverage (≥85%)
44
+ run: uv run python scripts/check_security_coverage.py
45
+ - name: Bandit (medium+ severity/confidence)
46
+ run: uv tool run bandit -c bandit.yaml -r oyst_core oyst_cli -ll -ii
47
+ - run: uv tool run pip-audit
48
+ - name: GUI must not call security binaries directly
49
+ run: |
50
+ ! rg -n "subprocess\.(run|call|Popen)|os\.system\(|\bpkexec\b|\bsystemctl\b.*\bclam" oysterav/ || \
51
+ (echo "GUI must use OystClient only" && exit 1)
@@ -0,0 +1,41 @@
1
+ name: Publish PyPI
2
+
3
+ # Publishes wheel/sdist from a GitHub Release to PyPI via Trusted Publishing.
4
+ # One-time setup: https://pypi.org/manage/account/publishing/
5
+ # - Owner: asafelobotomy, Repository: oysterAV, Workflow: publish-pypi.yml, Environment: pypi
6
+
7
+ on:
8
+ release:
9
+ types: [published]
10
+ workflow_dispatch:
11
+ inputs:
12
+ tag:
13
+ description: "Release tag to publish (e.g. v0.2.1)"
14
+ required: true
15
+ type: string
16
+
17
+ permissions:
18
+ contents: read
19
+ id-token: write
20
+
21
+ jobs:
22
+ publish:
23
+ runs-on: ubuntu-latest
24
+ environment: pypi
25
+ steps:
26
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
27
+ with:
28
+ ref: ${{ github.event_name == 'workflow_dispatch' && inputs.tag || github.event.release.tag_name }}
29
+ - uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
30
+ with:
31
+ enable-cache: true
32
+ - name: Build
33
+ run: |
34
+ set -euo pipefail
35
+ uv run python scripts/sync_version.py --check
36
+ uv build
37
+ - name: Publish to PyPI
38
+ uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc # v1.12.4
39
+ with:
40
+ packages-dir: dist/
41
+ skip-existing: true
@@ -0,0 +1,345 @@
1
+ name: Release
2
+
3
+ on:
4
+ push:
5
+ branches: [main, master]
6
+ paths:
7
+ - VERSION
8
+ workflow_dispatch:
9
+ inputs:
10
+ version:
11
+ description: "Version to release (empty = VERSION file)"
12
+ required: false
13
+ type: string
14
+ default: ""
15
+ force:
16
+ description: "Rebuild and (re)publish even if the tag already exists"
17
+ required: false
18
+ type: boolean
19
+ default: false
20
+
21
+ permissions:
22
+ contents: write
23
+
24
+ concurrency:
25
+ group: release-${{ github.ref }}
26
+ cancel-in-progress: false
27
+
28
+ jobs:
29
+ detect:
30
+ runs-on: ubuntu-latest
31
+ outputs:
32
+ should_release: ${{ steps.detect.outputs.should_release }}
33
+ version: ${{ steps.detect.outputs.version }}
34
+ tag: ${{ steps.detect.outputs.tag }}
35
+ force: ${{ steps.detect.outputs.force }}
36
+ build_ref: ${{ steps.detect.outputs.build_ref }}
37
+ steps:
38
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
39
+ with:
40
+ fetch-depth: 0
41
+ - id: detect
42
+ name: Detect release candidate
43
+ run: |
44
+ set -euo pipefail
45
+ FORCE="false"
46
+ if [[ "${{ github.event_name }}" == "workflow_dispatch" && "${{ inputs.force }}" == "true" ]]; then
47
+ FORCE="true"
48
+ fi
49
+ echo "force=${FORCE}" >> "$GITHUB_OUTPUT"
50
+
51
+ if [[ "${{ github.event_name }}" == "workflow_dispatch" && -n "${{ inputs.version }}" ]]; then
52
+ VERSION="${{ inputs.version }}"
53
+ VERSION="${VERSION#v}"
54
+ else
55
+ VERSION="$(tr -d '[:space:]' < VERSION)"
56
+ fi
57
+ TAG="v${VERSION}"
58
+ echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
59
+ echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
60
+
61
+ # Force republish builds from the workflow commit (packaging fixes) while
62
+ # still attaching assets to the existing tag. Normal cuts build the tag tip.
63
+ if [[ "$FORCE" == "true" ]]; then
64
+ echo "build_ref=${{ github.sha }}" >> "$GITHUB_OUTPUT"
65
+ echo "Force republish requested for ${TAG} from ${{ github.sha }}"
66
+ echo "should_release=true" >> "$GITHUB_OUTPUT"
67
+ exit 0
68
+ fi
69
+
70
+ echo "build_ref=${TAG}" >> "$GITHUB_OUTPUT"
71
+
72
+ if git rev-parse "${TAG}" >/dev/null 2>&1; then
73
+ echo "Tag ${TAG} already exists — skipping release (use workflow_dispatch force=true to republish)."
74
+ echo "should_release=false" >> "$GITHUB_OUTPUT"
75
+ exit 0
76
+ fi
77
+
78
+ if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
79
+ echo "Manual dispatch for new tag ${TAG}"
80
+ echo "should_release=true" >> "$GITHUB_OUTPUT"
81
+ exit 0
82
+ fi
83
+
84
+ if git rev-parse HEAD^ >/dev/null 2>&1; then
85
+ if git diff --quiet HEAD^ HEAD -- VERSION; then
86
+ echo "VERSION unchanged vs parent — skipping."
87
+ echo "should_release=false" >> "$GITHUB_OUTPUT"
88
+ exit 0
89
+ fi
90
+ else
91
+ echo "No parent commit; treating as first release candidate."
92
+ fi
93
+
94
+ echo "should_release=true" >> "$GITHUB_OUTPUT"
95
+ echo "Will release ${TAG}"
96
+
97
+ prepare:
98
+ needs: detect
99
+ if: needs.detect.outputs.should_release == 'true'
100
+ runs-on: ubuntu-latest
101
+ steps:
102
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
103
+ with:
104
+ fetch-depth: 0
105
+ token: ${{ secrets.GITHUB_TOKEN }}
106
+ - uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
107
+ with:
108
+ enable-cache: true
109
+ - name: Verify VERSION is synced
110
+ run: |
111
+ set -euo pipefail
112
+ FILE_VERSION="$(tr -d '[:space:]' < VERSION)"
113
+ EXPECTED="${{ needs.detect.outputs.version }}"
114
+ if [[ "$FILE_VERSION" != "$EXPECTED" ]]; then
115
+ echo "VERSION file (${FILE_VERSION}) does not match release version (${EXPECTED})" >&2
116
+ exit 1
117
+ fi
118
+ uv run python scripts/sync_version.py --check
119
+ - name: Create and push tag if missing
120
+ run: |
121
+ set -euo pipefail
122
+ TAG="${{ needs.detect.outputs.tag }}"
123
+ git fetch --tags origin
124
+ if git rev-parse "${TAG}" >/dev/null 2>&1; then
125
+ echo "Tag ${TAG} already exists — leaving in place."
126
+ exit 0
127
+ fi
128
+ git config user.name "github-actions[bot]"
129
+ git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
130
+ git tag -a "$TAG" -m "Release $TAG"
131
+ git push origin "$TAG"
132
+
133
+ python-dist:
134
+ needs: [detect, prepare]
135
+ if: needs.detect.outputs.should_release == 'true'
136
+ runs-on: ubuntu-latest
137
+ steps:
138
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
139
+ with:
140
+ ref: ${{ needs.detect.outputs.build_ref }}
141
+ - uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
142
+ with:
143
+ enable-cache: true
144
+ - name: Install GUI native build deps
145
+ run: |
146
+ sudo apt-get update
147
+ sudo apt-get install -y --no-install-recommends \
148
+ pkg-config \
149
+ python3-dev \
150
+ libcairo2-dev \
151
+ libgirepository-2.0-dev \
152
+ gir1.2-gtk-4.0 \
153
+ gir1.2-adw-1
154
+ - run: uv sync --extra all
155
+ - run: uv run python scripts/sync_version.py --check
156
+ - run: uv build
157
+ - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
158
+ with:
159
+ name: python-dist
160
+ path: |
161
+ dist/*.whl
162
+ dist/*.tar.gz
163
+
164
+ runtime:
165
+ needs: [detect, prepare]
166
+ if: needs.detect.outputs.should_release == 'true'
167
+ runs-on: ubuntu-latest
168
+ steps:
169
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
170
+ with:
171
+ ref: ${{ needs.detect.outputs.build_ref }}
172
+ - name: Install zstd
173
+ run: sudo apt-get update && sudo apt-get install -y zstd curl
174
+ - run: bash scripts/build_runtime.sh x86_64
175
+ - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
176
+ with:
177
+ name: runtime-x86_64
178
+ path: dist/runtime-x86_64.tar.zst
179
+
180
+ flatpak:
181
+ needs: [detect, prepare]
182
+ if: needs.detect.outputs.should_release == 'true'
183
+ runs-on: ubuntu-latest
184
+ timeout-minutes: 120
185
+ steps:
186
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
187
+ with:
188
+ ref: ${{ needs.detect.outputs.build_ref }}
189
+ - name: Install flatpak-builder
190
+ run: |
191
+ sudo apt-get update
192
+ sudo apt-get install -y flatpak flatpak-builder
193
+ - name: Build Flatpak bundle
194
+ run: bash scripts/build_flatpak.sh x86_64
195
+ - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
196
+ with:
197
+ name: flatpak
198
+ path: dist/*.flatpak
199
+
200
+ native-pkgs:
201
+ needs: [detect, prepare]
202
+ if: needs.detect.outputs.should_release == 'true'
203
+ runs-on: ubuntu-latest
204
+ steps:
205
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
206
+ with:
207
+ ref: ${{ needs.detect.outputs.build_ref }}
208
+ - uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
209
+ with:
210
+ enable-cache: true
211
+ - name: Install fpm dependencies
212
+ run: |
213
+ sudo apt-get update
214
+ sudo apt-get install -y ruby ruby-dev build-essential rpm \
215
+ pkg-config python3-dev libcairo2-dev libgirepository-2.0-dev \
216
+ gir1.2-gtk-4.0 gir1.2-adw-1
217
+ sudo gem install --no-document fpm
218
+ - name: Build DEB and RPM
219
+ run: |
220
+ uv sync --extra all
221
+ export PYTHON_BIN="$(uv run which python)"
222
+ bash scripts/build_native_packages.sh x86_64
223
+ - name: Smoke-check native packages
224
+ run: |
225
+ set -euo pipefail
226
+ DEB="$(ls dist/*.deb | head -n1)"
227
+ RPM="$(ls dist/*.rpm | head -n1)"
228
+ dpkg-deb -I "$DEB"
229
+ rpm -qp --info "$RPM"
230
+ DEB_DEPS="$(dpkg-deb -f "$DEB" Depends)"
231
+ RPM_REQS="$(rpm -qpR "$RPM")"
232
+ for dep in python3-click python3-pydantic python3-defusedxml; do
233
+ echo "$DEB_DEPS" | grep -F "$dep"
234
+ echo "$RPM_REQS" | grep -F "$dep"
235
+ done
236
+ - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
237
+ with:
238
+ name: native-pkgs
239
+ path: |
240
+ dist/*.deb
241
+ dist/*.rpm
242
+
243
+ arch:
244
+ needs: [detect, prepare]
245
+ if: needs.detect.outputs.should_release == 'true'
246
+ runs-on: ubuntu-latest
247
+ steps:
248
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
249
+ with:
250
+ ref: ${{ needs.detect.outputs.build_ref }}
251
+ - name: Render PKGBUILD with release checksum
252
+ run: |
253
+ set -euo pipefail
254
+ # Tag is created in prepare; require a real sha256 of the GitHub archive.
255
+ export REQUIRE_SHA256=1
256
+ bash scripts/render_arch_pkgbuild.sh
257
+ if grep -q "sha256sums=('SKIP')" dist/PKGBUILD; then
258
+ echo "ERROR: sha256sums still SKIP" >&2
259
+ exit 1
260
+ fi
261
+ grep -E "python-defusedxml|sha256sums" dist/PKGBUILD dist/.SRCINFO
262
+ - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
263
+ with:
264
+ name: arch-pkgbuild
265
+ include-hidden-files: true
266
+ path: |
267
+ dist/PKGBUILD
268
+ dist/.SRCINFO
269
+
270
+ release:
271
+ needs: [detect, prepare, python-dist, runtime, flatpak, native-pkgs, arch]
272
+ if: needs.detect.outputs.should_release == 'true'
273
+ runs-on: ubuntu-latest
274
+ steps:
275
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
276
+ with:
277
+ fetch-depth: 0
278
+ ref: ${{ needs.detect.outputs.build_ref }}
279
+ token: ${{ secrets.GITHUB_TOKEN }}
280
+ - name: Generate release notes (latest section)
281
+ uses: orhun/git-cliff-action@f50e11560dce63f7c33227798f90b924471a88b5 # v4.8.0
282
+ id: cliff
283
+ with:
284
+ config: cliff.toml
285
+ args: --latest --strip header
286
+ env:
287
+ OUTPUT: CHANGELOG_RELEASE.md
288
+ - name: Generate full CHANGELOG.md
289
+ uses: orhun/git-cliff-action@f50e11560dce63f7c33227798f90b924471a88b5 # v4.8.0
290
+ with:
291
+ config: cliff.toml
292
+ env:
293
+ OUTPUT: CHANGELOG_FULL.md
294
+ - name: Download artifacts
295
+ uses: actions/download-artifact@95815c38cf2ff2164869cbab79da8d1f422bc89e # v4.2.1
296
+ with:
297
+ path: release-assets
298
+ merge-multiple: true
299
+ - name: List assets
300
+ run: find release-assets -type f | sort
301
+ - name: Stage assets for upload
302
+ run: |
303
+ set -euo pipefail
304
+ mkdir -p staged
305
+ find release-assets -type f -exec cp -t staged {} +
306
+ # GitHub Release asset names cannot be leading-dot; publish as SRCINFO.
307
+ if [[ -f staged/.SRCINFO ]]; then
308
+ mv staged/.SRCINFO staged/SRCINFO
309
+ elif [[ ! -f staged/SRCINFO ]]; then
310
+ echo "ERROR: .SRCINFO/SRCINFO missing from arch artifact" >&2
311
+ find release-assets -type f | sort >&2
312
+ exit 1
313
+ fi
314
+ ls -la staged
315
+ - name: Create or update GitHub Release
316
+ uses: softprops/action-gh-release@da05d552573ad5aba039eaac05058a918a7bf631 # v2.2.2
317
+ with:
318
+ tag_name: ${{ needs.detect.outputs.tag }}
319
+ name: oysterAV ${{ needs.detect.outputs.version }}
320
+ body_path: CHANGELOG_RELEASE.md
321
+ files: staged/*
322
+ fail_on_unmatched_files: true
323
+ generate_release_notes: false
324
+ make_latest: true
325
+ draft: false
326
+ overwrite_files: true
327
+ env:
328
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
329
+ - name: Commit full CHANGELOG.md to main
330
+ run: |
331
+ set -euo pipefail
332
+ VERSION="${{ needs.detect.outputs.version }}"
333
+ cp CHANGELOG_FULL.md /tmp/CHANGELOG.md
334
+ git fetch origin main
335
+ git checkout -B main origin/main
336
+ cp /tmp/CHANGELOG.md CHANGELOG.md
337
+ git config user.name "github-actions[bot]"
338
+ git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
339
+ git add CHANGELOG.md
340
+ if git diff --cached --quiet; then
341
+ echo "CHANGELOG.md already up to date."
342
+ exit 0
343
+ fi
344
+ git commit -m "docs(changelog): v${VERSION}"
345
+ git push origin main
@@ -0,0 +1,26 @@
1
+ name: Runtime bundle
2
+
3
+ on:
4
+ workflow_dispatch:
5
+ push:
6
+ paths:
7
+ - "scripts/build_runtime.sh"
8
+ - "oyst_core/runtime/**"
9
+
10
+ permissions:
11
+ contents: read
12
+
13
+ jobs:
14
+ build:
15
+ runs-on: ubuntu-latest
16
+ steps:
17
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
18
+ - name: Install zstd
19
+ run: sudo apt-get update && sudo apt-get install -y zstd curl
20
+ - name: Build runtime tarball
21
+ run: bash scripts/build_runtime.sh x86_64
22
+ - name: Upload artifact
23
+ uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
24
+ with:
25
+ name: runtime-x86_64
26
+ path: dist/runtime-x86_64.tar.zst
@@ -0,0 +1,42 @@
1
+ # OpenSSF Scorecard
2
+
3
+ # Blocking on default branch (see docs/security/test-gates.md).
4
+ name: Scorecard
5
+
6
+ on:
7
+ branch_protection_rule:
8
+ schedule:
9
+ - cron: "17 7 * * 1"
10
+ push:
11
+ branches: [main, master]
12
+ workflow_dispatch:
13
+
14
+ permissions: read-all
15
+
16
+ jobs:
17
+ analysis:
18
+ name: Scorecard analysis
19
+ runs-on: ubuntu-latest
20
+ permissions:
21
+ security-events: write
22
+ id-token: write
23
+ contents: read
24
+ actions: read
25
+
26
+ steps:
27
+ - name: Checkout
28
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
29
+ with:
30
+ persist-credentials: false
31
+
32
+ - name: Run OpenSSF Scorecard
33
+ uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3
34
+ with:
35
+ results_file: results.sarif
36
+ results_format: sarif
37
+ publish_results: true
38
+
39
+ - name: Upload SARIF
40
+ uses: github/codeql-action/upload-sarif@fca7ace96b7d713c7035871441bd52efbe39e27e # v3.28.19
41
+ with:
42
+ sarif_file: results.sarif
@@ -0,0 +1,26 @@
1
+ # Optional hostile-client simulation (not PR-blocking).
2
+ # See docs/security/attacker-sim.md
3
+ name: Security attacker-sim
4
+
5
+ on:
6
+ workflow_dispatch:
7
+ schedule:
8
+ - cron: "0 6 * * 1" # weekly Monday 06:00 UTC
9
+
10
+ permissions:
11
+ contents: read
12
+
13
+ jobs:
14
+ attacker-sim:
15
+ name: Attacker sim dry-run
16
+ runs-on: ubuntu-latest
17
+ steps:
18
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
19
+ - name: Install uv
20
+ uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6
21
+ with:
22
+ enable-cache: true
23
+ - name: Sync deps
24
+ run: uv sync --extra dev
25
+ - name: Run attacker_sim dry-run
26
+ run: ./scripts/attacker_sim.sh --dry-run
@@ -0,0 +1,43 @@
1
+ # Secret scan + Semgrep SAST (blocking). See docs/security/test-gates.md.
2
+ name: Security scan
3
+
4
+ on:
5
+ push:
6
+ branches: [main, master]
7
+ pull_request:
8
+ branches: [main, master]
9
+
10
+ permissions:
11
+ contents: read
12
+
13
+ jobs:
14
+ gitleaks:
15
+ name: Gitleaks
16
+ runs-on: ubuntu-latest
17
+ steps:
18
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
19
+ with:
20
+ fetch-depth: 0
21
+ - name: Run Gitleaks
22
+ uses: gitleaks/gitleaks-action@e0c47f4f8be36e29cdc102c57e68cb5cbf0e8d1e # v3.0.0
23
+ env:
24
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
25
+ GITLEAKS_ENABLE_COMMENTS: "false"
26
+
27
+ semgrep:
28
+ name: Semgrep
29
+ runs-on: ubuntu-latest
30
+ container:
31
+ image: semgrep/semgrep
32
+ steps:
33
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
34
+ - name: Semgrep scan (python + security-audit)
35
+ run: |
36
+ semgrep scan \
37
+ --config p/python \
38
+ --config p/security-audit \
39
+ --exclude-rule python.lang.security.audit.insecure-file-permissions.insecure-file-permissions \
40
+ --exclude-rule python.lang.security.audit.dynamic-urllib-use-detected.dynamic-urllib-use-detected \
41
+ --error \
42
+ --metrics=off \
43
+ oyst_core oyst_cli
@@ -0,0 +1,28 @@
1
+ .venv/
2
+ __pycache__/
3
+ *.py[cod]
4
+ *.egg-info/
5
+ dist/
6
+ build/
7
+ build-dir/
8
+ build-flathub/
9
+ repo/
10
+ .fpm-staging/
11
+ .runtime-staging/
12
+ .aur-oysterav/
13
+ .pytest_cache/
14
+ .mypy_cache/
15
+ .ruff_cache/
16
+ .coverage
17
+ .coverage.*
18
+ coverage.xml
19
+ htmlcov/
20
+ *.log
21
+ .DS_Store
22
+ .idea/
23
+ *.swp
24
+ .cursor/
25
+
26
+ # Never commit local RPC credentials if copied into the tree by mistake
27
+ oyst.token
28
+ oyst.sock
@@ -0,0 +1,21 @@
1
+ repos:
2
+ - repo: local
3
+ hooks:
4
+ - id: ruff-format
5
+ name: ruff format
6
+ entry: uv run ruff format
7
+ language: system
8
+ types: [python]
9
+ pass_filenames: true
10
+ - id: ruff-check
11
+ name: ruff check
12
+ entry: uv run ruff check --fix
13
+ language: system
14
+ types: [python]
15
+ pass_filenames: true
16
+ - id: mypy
17
+ name: mypy (packages)
18
+ entry: uv run mypy oyst_core oyst_cli oysterav
19
+ language: system
20
+ pass_filenames: false
21
+ types: [python]
@@ -0,0 +1,22 @@
1
+ {
2
+ "recommendations": [
3
+ "ms-python.python",
4
+ "anysphere.cursorpyright",
5
+ "ms-python.debugpy",
6
+ "charliermarsh.ruff",
7
+ "ms-python.mypy-type-checker",
8
+ "tamasfe.even-better-toml",
9
+ "timonwong.shellcheck",
10
+ "davidanson.vscode-markdownlint",
11
+ "redhat.vscode-yaml",
12
+ "github.vscode-github-actions"
13
+ ],
14
+ "unwantedRecommendations": [
15
+ "ms-python.vscode-pylance",
16
+ "rust-lang.rust-analyzer",
17
+ "llvm-vs-code-extensions.vscode-clangd",
18
+ "ms-vscode.cmake-tools",
19
+ "theqtcompany.qt-core",
20
+ "theqtcompany.qt-qml"
21
+ ]
22
+ }