froid-loop 0.11.1__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 (254) hide show
  1. froid_loop-0.11.1/.bandit +14 -0
  2. froid_loop-0.11.1/.claude-plugin/marketplace.json +26 -0
  3. froid_loop-0.11.1/.github/CODE_OF_CONDUCT.md +128 -0
  4. froid_loop-0.11.1/.github/FUNDING.yaml +15 -0
  5. froid_loop-0.11.1/.github/ISSUE_TEMPLATE/bug-report.yaml +139 -0
  6. froid_loop-0.11.1/.github/ISSUE_TEMPLATE/config.yaml +11 -0
  7. froid_loop-0.11.1/.github/ISSUE_TEMPLATE/documentation.yaml +55 -0
  8. froid_loop-0.11.1/.github/ISSUE_TEMPLATE/feature-request.md +22 -0
  9. froid_loop-0.11.1/.github/PULL_REQUEST_TEMPLATE.md +23 -0
  10. froid_loop-0.11.1/.github/dependabot.yml +22 -0
  11. froid_loop-0.11.1/.github/workflows/ci.yml +335 -0
  12. froid_loop-0.11.1/.github/workflows/release.yml +56 -0
  13. froid_loop-0.11.1/.github/zizmor.yml +33 -0
  14. froid_loop-0.11.1/.gitignore +22 -0
  15. froid_loop-0.11.1/.python-version +1 -0
  16. froid_loop-0.11.1/AGENTS.md +97 -0
  17. froid_loop-0.11.1/CHANGELOG.md +4218 -0
  18. froid_loop-0.11.1/CLAUDE.md +7 -0
  19. froid_loop-0.11.1/CONTRIBUTING.md +231 -0
  20. froid_loop-0.11.1/CONTRIBUTORS.md +31 -0
  21. froid_loop-0.11.1/LICENSE +30 -0
  22. froid_loop-0.11.1/PKG-INFO +728 -0
  23. froid_loop-0.11.1/README.md +706 -0
  24. froid_loop-0.11.1/SECURITY.md +88 -0
  25. froid_loop-0.11.1/TRADEMARK.md +55 -0
  26. froid_loop-0.11.1/docs/FEATURES.md +300 -0
  27. froid_loop-0.11.1/docs/README.md +34 -0
  28. froid_loop-0.11.1/docs/ROADMAP.md +182 -0
  29. froid_loop-0.11.1/docs/adapter-authoring-guide.md +825 -0
  30. froid_loop-0.11.1/docs/game-engine-mcp-guide.md +258 -0
  31. froid_loop-0.11.1/docs/game-engine-plugin-guide.md +393 -0
  32. froid_loop-0.11.1/docs/images/dashboard.png +0 -0
  33. froid_loop-0.11.1/docs/images/dashboard.svg +247 -0
  34. froid_loop-0.11.1/docs/images/decision-answer.png +0 -0
  35. froid_loop-0.11.1/docs/images/decision-answer.svg +251 -0
  36. froid_loop-0.11.1/docs/images/deferred-modal.png +0 -0
  37. froid_loop-0.11.1/docs/images/deferred-modal.svg +250 -0
  38. froid_loop-0.11.1/docs/images/demo.gif +0 -0
  39. froid_loop-0.11.1/docs/images/settings-scm.png +0 -0
  40. froid_loop-0.11.1/docs/images/settings-scm.svg +233 -0
  41. froid_loop-0.11.1/docs/images/settings.png +0 -0
  42. froid_loop-0.11.1/docs/images/settings.svg +228 -0
  43. froid_loop-0.11.1/docs/images/start-run-modal.png +0 -0
  44. froid_loop-0.11.1/docs/images/start-run-modal.svg +260 -0
  45. froid_loop-0.11.1/docs/images/sweep-decision.png +0 -0
  46. froid_loop-0.11.1/docs/images/sweep-decision.svg +248 -0
  47. froid_loop-0.11.1/docs/multiplexer-backends.md +313 -0
  48. froid_loop-0.11.1/docs/plugin-authoring-guide.md +789 -0
  49. froid_loop-0.11.1/docs/porting-to-a-new-os.md +476 -0
  50. froid_loop-0.11.1/docs/setup-guide.md +436 -0
  51. froid_loop-0.11.1/docs/tea-plugin-guide.md +181 -0
  52. froid_loop-0.11.1/docs/testing.md +409 -0
  53. froid_loop-0.11.1/docs/tui-guide.md +727 -0
  54. froid_loop-0.11.1/examples/plugins/guardrails/guardrails.py +63 -0
  55. froid_loop-0.11.1/examples/plugins/guardrails/plugin.toml +57 -0
  56. froid_loop-0.11.1/module.yaml +19 -0
  57. froid_loop-0.11.1/prettier.config.mjs +31 -0
  58. froid_loop-0.11.1/pyproject.toml +120 -0
  59. froid_loop-0.11.1/scripts/gen_demo.py +348 -0
  60. froid_loop-0.11.1/scripts/gen_screenshots.py +619 -0
  61. froid_loop-0.11.1/scripts/record-demo.sh +79 -0
  62. froid_loop-0.11.1/scripts/release.py +671 -0
  63. froid_loop-0.11.1/scripts/seed_skills.py +121 -0
  64. froid_loop-0.11.1/scripts/sync_version.py +189 -0
  65. froid_loop-0.11.1/src/froid_loop/__init__.py +11 -0
  66. froid_loop-0.11.1/src/froid_loop/__main__.py +12 -0
  67. froid_loop-0.11.1/src/froid_loop/adapters/__init__.py +3 -0
  68. froid_loop-0.11.1/src/froid_loop/adapters/base.py +254 -0
  69. froid_loop-0.11.1/src/froid_loop/adapters/entrypoints.py +63 -0
  70. froid_loop-0.11.1/src/froid_loop/adapters/env_fault.py +290 -0
  71. froid_loop-0.11.1/src/froid_loop/adapters/generic.py +2013 -0
  72. froid_loop-0.11.1/src/froid_loop/adapters/mock.py +49 -0
  73. froid_loop-0.11.1/src/froid_loop/adapters/multiplexer.py +914 -0
  74. froid_loop-0.11.1/src/froid_loop/adapters/opencode_http.py +1687 -0
  75. froid_loop-0.11.1/src/froid_loop/adapters/profile.py +650 -0
  76. froid_loop-0.11.1/src/froid_loop/adapters/psmux_backend.py +1428 -0
  77. froid_loop-0.11.1/src/froid_loop/adapters/registry.py +322 -0
  78. froid_loop-0.11.1/src/froid_loop/adapters/tmux_backend.py +35 -0
  79. froid_loop-0.11.1/src/froid_loop/adapters/tmux_base.py +630 -0
  80. froid_loop-0.11.1/src/froid_loop/checks.py +187 -0
  81. froid_loop-0.11.1/src/froid_loop/cli.py +5041 -0
  82. froid_loop-0.11.1/src/froid_loop/data/__init__.py +0 -0
  83. froid_loop-0.11.1/src/froid_loop/data/froid_loop_hook.py +228 -0
  84. froid_loop-0.11.1/src/froid_loop/data/froid_loop_probe_hook.py +88 -0
  85. froid_loop-0.11.1/src/froid_loop/data/plugins/example/plugin.toml +21 -0
  86. froid_loop-0.11.1/src/froid_loop/data/plugins/tea/plugin.toml +184 -0
  87. froid_loop-0.11.1/src/froid_loop/data/plugins/tea/tea_plugin.py +258 -0
  88. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/plugin.toml +140 -0
  89. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_assets/FroidLoop.Unity.Editor.asmdef +16 -0
  90. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_assets/FroidLoop.Unity.Editor.asmdef.meta +7 -0
  91. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_assets/SceneAutoSaveGuard.cs +221 -0
  92. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_assets/SceneAutoSaveGuard.cs.meta +11 -0
  93. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_assets/_folders/Editor.meta +8 -0
  94. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_assets/_folders/FroidLoop.meta +8 -0
  95. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_cleanup.py +125 -0
  96. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_dialog_probe.py +239 -0
  97. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_facts.md +17 -0
  98. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_plugin.py +415 -0
  99. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_quiesce.py +234 -0
  100. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_ready.py +230 -0
  101. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_seed_assets.py +298 -0
  102. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_setup.py +551 -0
  103. froid_loop-0.11.1/src/froid_loop/data/plugins/unity/unity_teardown.py +362 -0
  104. froid_loop-0.11.1/src/froid_loop/data/profiles/antigravity.toml +52 -0
  105. froid_loop-0.11.1/src/froid_loop/data/profiles/claude.toml +85 -0
  106. froid_loop-0.11.1/src/froid_loop/data/profiles/codex.toml +22 -0
  107. froid_loop-0.11.1/src/froid_loop/data/profiles/copilot.toml +52 -0
  108. froid_loop-0.11.1/src/froid_loop/data/profiles/gemini.toml +26 -0
  109. froid_loop-0.11.1/src/froid_loop/data/profiles/opencode.toml +54 -0
  110. froid_loop-0.11.1/src/froid_loop/data/settings/core.toml +458 -0
  111. froid_loop-0.11.1/src/froid_loop/data/skills/README.md +93 -0
  112. froid_loop-0.11.1/src/froid_loop/data/skills/froid-loop-resolve/SKILL.md +288 -0
  113. froid_loop-0.11.1/src/froid_loop/data/skills/froid-loop-setup/SKILL.md +161 -0
  114. froid_loop-0.11.1/src/froid_loop/data/skills/froid-loop-setup/assets/module-help.csv +3 -0
  115. froid_loop-0.11.1/src/froid_loop/data/skills/froid-loop-setup/assets/module.yaml +19 -0
  116. froid_loop-0.11.1/src/froid_loop/data/skills/froid-loop-sweep/SKILL.md +100 -0
  117. froid_loop-0.11.1/src/froid_loop/data/skills/froid-loop-sweep/automation-mode.md +127 -0
  118. froid_loop-0.11.1/src/froid_loop/data/skills/froid-loop-sweep/deferred-work-format.md +302 -0
  119. froid_loop-0.11.1/src/froid_loop/data/skills/froid-loop-sweep/migration-mode.md +86 -0
  120. froid_loop-0.11.1/src/froid_loop/decisions.py +202 -0
  121. froid_loop-0.11.1/src/froid_loop/deferredwork.py +2282 -0
  122. froid_loop-0.11.1/src/froid_loop/devcontract.py +892 -0
  123. froid_loop-0.11.1/src/froid_loop/diagnostics.py +1104 -0
  124. froid_loop-0.11.1/src/froid_loop/documents.py +532 -0
  125. froid_loop-0.11.1/src/froid_loop/engine.py +7732 -0
  126. froid_loop-0.11.1/src/froid_loop/envvars.py +111 -0
  127. froid_loop-0.11.1/src/froid_loop/escalation.py +225 -0
  128. froid_loop-0.11.1/src/froid_loop/events.py +266 -0
  129. froid_loop-0.11.1/src/froid_loop/fences.py +103 -0
  130. froid_loop-0.11.1/src/froid_loop/froidconfig.py +226 -0
  131. froid_loop-0.11.1/src/froid_loop/frontmatter.py +526 -0
  132. froid_loop-0.11.1/src/froid_loop/gates.py +133 -0
  133. froid_loop-0.11.1/src/froid_loop/install.py +2936 -0
  134. froid_loop-0.11.1/src/froid_loop/journal.py +178 -0
  135. froid_loop-0.11.1/src/froid_loop/machine.py +148 -0
  136. froid_loop-0.11.1/src/froid_loop/model.py +898 -0
  137. froid_loop-0.11.1/src/froid_loop/operatoractions.py +474 -0
  138. froid_loop-0.11.1/src/froid_loop/platform_util.py +1490 -0
  139. froid_loop-0.11.1/src/froid_loop/plugins/__init__.py +64 -0
  140. froid_loop-0.11.1/src/froid_loop/plugins/bus.py +259 -0
  141. froid_loop-0.11.1/src/froid_loop/plugins/context.py +319 -0
  142. froid_loop-0.11.1/src/froid_loop/plugins/loader.py +145 -0
  143. froid_loop-0.11.1/src/froid_loop/plugins/manifest.py +279 -0
  144. froid_loop-0.11.1/src/froid_loop/plugins/model.py +296 -0
  145. froid_loop-0.11.1/src/froid_loop/plugins/registry.py +245 -0
  146. froid_loop-0.11.1/src/froid_loop/plugins/trust.py +75 -0
  147. froid_loop-0.11.1/src/froid_loop/policy.py +1569 -0
  148. froid_loop-0.11.1/src/froid_loop/probe.py +1044 -0
  149. froid_loop-0.11.1/src/froid_loop/process_host.py +408 -0
  150. froid_loop-0.11.1/src/froid_loop/recovery_flow.py +1561 -0
  151. froid_loop-0.11.1/src/froid_loop/resolve.py +283 -0
  152. froid_loop-0.11.1/src/froid_loop/runs.py +4715 -0
  153. froid_loop-0.11.1/src/froid_loop/runsetup.py +1293 -0
  154. froid_loop-0.11.1/src/froid_loop/sanitize.py +593 -0
  155. froid_loop-0.11.1/src/froid_loop/settings_schema.py +276 -0
  156. froid_loop-0.11.1/src/froid_loop/signals.py +160 -0
  157. froid_loop-0.11.1/src/froid_loop/sprintstatus.py +609 -0
  158. froid_loop-0.11.1/src/froid_loop/statemachine.py +57 -0
  159. froid_loop-0.11.1/src/froid_loop/stories.py +615 -0
  160. froid_loop-0.11.1/src/froid_loop/stories_engine.py +796 -0
  161. froid_loop-0.11.1/src/froid_loop/sweep.py +1892 -0
  162. froid_loop-0.11.1/src/froid_loop/tokens.py +196 -0
  163. froid_loop-0.11.1/src/froid_loop/tui/__init__.py +11 -0
  164. froid_loop-0.11.1/src/froid_loop/tui/app.py +1584 -0
  165. froid_loop-0.11.1/src/froid_loop/tui/data.py +840 -0
  166. froid_loop-0.11.1/src/froid_loop/tui/launch.py +1003 -0
  167. froid_loop-0.11.1/src/froid_loop/tui/screens/__init__.py +1 -0
  168. froid_loop-0.11.1/src/froid_loop/tui/screens/dashboard.py +1071 -0
  169. froid_loop-0.11.1/src/froid_loop/tui/screens/modals.py +943 -0
  170. froid_loop-0.11.1/src/froid_loop/tui/screens/settings_screen.py +477 -0
  171. froid_loop-0.11.1/src/froid_loop/tui/settings.py +135 -0
  172. froid_loop-0.11.1/src/froid_loop/tui/widgets.py +981 -0
  173. froid_loop-0.11.1/src/froid_loop/verify.py +4545 -0
  174. froid_loop-0.11.1/src/froid_loop/workspace.py +320 -0
  175. froid_loop-0.11.1/src/froid_loop/worktree_flow.py +2301 -0
  176. froid_loop-0.11.1/tests/conftest.py +1424 -0
  177. froid_loop-0.11.1/tests/fixtures/stories.yaml +48 -0
  178. froid_loop-0.11.1/tests/test_adapter_registry.py +1260 -0
  179. froid_loop-0.11.1/tests/test_backend_registry.py +614 -0
  180. froid_loop-0.11.1/tests/test_cleanup.py +777 -0
  181. froid_loop-0.11.1/tests/test_cli.py +10975 -0
  182. froid_loop-0.11.1/tests/test_conftest.py +264 -0
  183. froid_loop-0.11.1/tests/test_decisions.py +423 -0
  184. froid_loop-0.11.1/tests/test_deferredwork.py +4297 -0
  185. froid_loop-0.11.1/tests/test_devcontract.py +1986 -0
  186. froid_loop-0.11.1/tests/test_diagnostics.py +1715 -0
  187. froid_loop-0.11.1/tests/test_engine.py +15659 -0
  188. froid_loop-0.11.1/tests/test_engine_plugin.py +1233 -0
  189. froid_loop-0.11.1/tests/test_engine_worktree.py +5855 -0
  190. froid_loop-0.11.1/tests/test_entry_point.py +254 -0
  191. froid_loop-0.11.1/tests/test_env_fault_patterns.py +584 -0
  192. froid_loop-0.11.1/tests/test_envvars.py +190 -0
  193. froid_loop-0.11.1/tests/test_escalation.py +259 -0
  194. froid_loop-0.11.1/tests/test_events.py +671 -0
  195. froid_loop-0.11.1/tests/test_external_backends.py +312 -0
  196. froid_loop-0.11.1/tests/test_froidconfig.py +306 -0
  197. froid_loop-0.11.1/tests/test_frontmatter.py +792 -0
  198. froid_loop-0.11.1/tests/test_gates.py +222 -0
  199. froid_loop-0.11.1/tests/test_generic_tmux.py +5174 -0
  200. froid_loop-0.11.1/tests/test_hook_bus.py +590 -0
  201. froid_loop-0.11.1/tests/test_hook_script.py +418 -0
  202. froid_loop-0.11.1/tests/test_install.py +9974 -0
  203. froid_loop-0.11.1/tests/test_journal.py +160 -0
  204. froid_loop-0.11.1/tests/test_model.py +713 -0
  205. froid_loop-0.11.1/tests/test_module_skills_sync.py +56 -0
  206. froid_loop-0.11.1/tests/test_multiplexer.py +1027 -0
  207. froid_loop-0.11.1/tests/test_opencode_http.py +2891 -0
  208. froid_loop-0.11.1/tests/test_opencode_live.py +166 -0
  209. froid_loop-0.11.1/tests/test_operatoractions.py +929 -0
  210. froid_loop-0.11.1/tests/test_platform_util.py +2799 -0
  211. froid_loop-0.11.1/tests/test_plugin_loader.py +493 -0
  212. froid_loop-0.11.1/tests/test_plugin_tea.py +620 -0
  213. froid_loop-0.11.1/tests/test_plugin_trust.py +238 -0
  214. froid_loop-0.11.1/tests/test_plugin_workflows.py +636 -0
  215. froid_loop-0.11.1/tests/test_policy.py +1597 -0
  216. froid_loop-0.11.1/tests/test_portability_guard.py +1240 -0
  217. froid_loop-0.11.1/tests/test_probe.py +946 -0
  218. froid_loop-0.11.1/tests/test_probe_hook.py +84 -0
  219. froid_loop-0.11.1/tests/test_process_host.py +384 -0
  220. froid_loop-0.11.1/tests/test_profile.py +983 -0
  221. froid_loop-0.11.1/tests/test_psmux_backend.py +2432 -0
  222. froid_loop-0.11.1/tests/test_psmux_live.py +1005 -0
  223. froid_loop-0.11.1/tests/test_recovery_flow.py +2700 -0
  224. froid_loop-0.11.1/tests/test_release.py +501 -0
  225. froid_loop-0.11.1/tests/test_resolve.py +3274 -0
  226. froid_loop-0.11.1/tests/test_resolve_skill_contract.py +155 -0
  227. froid_loop-0.11.1/tests/test_runs.py +5545 -0
  228. froid_loop-0.11.1/tests/test_runsetup.py +844 -0
  229. froid_loop-0.11.1/tests/test_sanitize.py +545 -0
  230. froid_loop-0.11.1/tests/test_seed_skills.py +95 -0
  231. froid_loop-0.11.1/tests/test_settings_schema.py +329 -0
  232. froid_loop-0.11.1/tests/test_setup_skill_contract.py +97 -0
  233. froid_loop-0.11.1/tests/test_signals.py +181 -0
  234. froid_loop-0.11.1/tests/test_sprintstatus.py +323 -0
  235. froid_loop-0.11.1/tests/test_sprintstatus_advance.py +1114 -0
  236. froid_loop-0.11.1/tests/test_statemachine.py +90 -0
  237. froid_loop-0.11.1/tests/test_stories.py +824 -0
  238. froid_loop-0.11.1/tests/test_stories_e2e.py +1076 -0
  239. froid_loop-0.11.1/tests/test_stories_engine.py +2023 -0
  240. froid_loop-0.11.1/tests/test_sweep.py +5587 -0
  241. froid_loop-0.11.1/tests/test_sweep_skill_contract.py +28 -0
  242. froid_loop-0.11.1/tests/test_sync_version.py +105 -0
  243. froid_loop-0.11.1/tests/test_tokens.py +242 -0
  244. froid_loop-0.11.1/tests/test_tui_app.py +6141 -0
  245. froid_loop-0.11.1/tests/test_tui_data.py +1161 -0
  246. froid_loop-0.11.1/tests/test_tui_launch.py +2066 -0
  247. froid_loop-0.11.1/tests/test_tui_settings.py +785 -0
  248. froid_loop-0.11.1/tests/test_unity_dialog_probe.py +182 -0
  249. froid_loop-0.11.1/tests/test_unity_quiesce.py +286 -0
  250. froid_loop-0.11.1/tests/test_unity_scene_guard.py +347 -0
  251. froid_loop-0.11.1/tests/test_verify.py +6545 -0
  252. froid_loop-0.11.1/tests/test_verify_worktree.py +2077 -0
  253. froid_loop-0.11.1/tests/test_worktree_flow.py +706 -0
  254. froid_loop-0.11.1/uv.lock +596 -0
@@ -0,0 +1,14 @@
1
+ # Bandit configuration (read by trunk via `bandit --ini .bandit`).
2
+ #
3
+ # froid-loop is a deterministic orchestrator: it shells out to tmux and coding-CLI
4
+ # binaries by design, and uses `assert` for internal type-narrowing invariants.
5
+ # Skip the low-severity rules those patterns trip so the signal isn't drowned out.
6
+ # Higher-signal checks stay ON — notably B602 (subprocess with shell=True), which is
7
+ # acknowledged at its single legitimate call site with an inline `# nosec B602`.
8
+ #
9
+ # B101 assert_used - intentional type-narrowing / invariant asserts
10
+ # B404 import_subprocess - the orchestrator drives external processes
11
+ # B603 subprocess_without_shell_equals_true - args are built internally, not user input
12
+ # B607 start_process_with_partial_path - relies on PATH to find tmux/CLIs
13
+ [bandit]
14
+ skips = B101,B404,B603,B607
@@ -0,0 +1,26 @@
1
+ {
2
+ "name": "froid-loop",
3
+ "owner": {
4
+ "name": "cordya-ai"
5
+ },
6
+ "license": "MIT",
7
+ "homepage": "",
8
+ "repository": "https://github.com/cordya-ai/froid-loop",
9
+ "keywords": ["froid", "froid-loop", "automation"],
10
+ "plugins": [
11
+ {
12
+ "name": "froid-loop",
13
+ "source": "./src/froid_loop/data/skills",
14
+ "description": "Automation-mode skills driven by the froid-loop orchestrator: project bootstrap (froid-loop-setup), interactive escalation resolution (froid-loop-resolve) and deferred-work sweep triage (froid-loop-sweep) — the inner dev primitive (which self-reviews and commits) is the upstream froid-dev-auto skill",
15
+ "version": "0.11.1",
16
+ "author": {
17
+ "name": "pinkyd"
18
+ },
19
+ "skills": [
20
+ "./src/froid_loop/data/skills/froid-loop-setup",
21
+ "./src/froid_loop/data/skills/froid-loop-resolve",
22
+ "./src/froid_loop/data/skills/froid-loop-sweep"
23
+ ]
24
+ }
25
+ ]
26
+ }
@@ -0,0 +1,128 @@
1
+ # Contributor Covenant Code of Conduct
2
+
3
+ ## Our Pledge
4
+
5
+ We as members, contributors, and leaders pledge to make participation in our
6
+ community a harassment-free experience for everyone, regardless of age, body
7
+ size, visible or invisible disability, ethnicity, sex characteristics, gender
8
+ identity and expression, level of experience, education, socio-economic status,
9
+ nationality, personal appearance, race, religion, or sexual identity
10
+ and orientation.
11
+
12
+ We pledge to act and interact in ways that contribute to an open, welcoming,
13
+ diverse, inclusive, and healthy community.
14
+
15
+ ## Our Standards
16
+
17
+ Examples of behavior that contributes to a positive environment for our
18
+ community include:
19
+
20
+ * Demonstrating empathy and kindness toward other people
21
+ * Being respectful of differing opinions, viewpoints, and experiences
22
+ * Giving and gracefully accepting constructive feedback
23
+ * Accepting responsibility and apologizing to those affected by our mistakes,
24
+ and learning from the experience
25
+ * Focusing on what is best not just for us as individuals, but for the
26
+ overall community
27
+
28
+ Examples of unacceptable behavior include:
29
+
30
+ * The use of sexualized language or imagery, and sexual attention or
31
+ advances of any kind
32
+ * Trolling, insulting or derogatory comments, and personal or political attacks
33
+ * Public or private harassment
34
+ * Publishing others' private information, such as a physical or email
35
+ address, without their explicit permission
36
+ * Other conduct which could reasonably be considered inappropriate in a
37
+ professional setting
38
+
39
+ ## Enforcement Responsibilities
40
+
41
+ Community leaders are responsible for clarifying and enforcing our standards of
42
+ acceptable behavior and will take appropriate and fair corrective action in
43
+ response to any behavior that they deem inappropriate, threatening, offensive,
44
+ or harmful.
45
+
46
+ Community leaders have the right and responsibility to remove, edit, or reject
47
+ comments, commits, code, wiki edits, issues, and other contributions that are
48
+ not aligned to this Code of Conduct, and will communicate reasons for moderation
49
+ decisions when appropriate.
50
+
51
+ ## Scope
52
+
53
+ This Code of Conduct applies within all community spaces, and also applies when
54
+ an individual is officially representing the community in public spaces.
55
+ Examples of representing our community include using an official e-mail address,
56
+ posting via an official social media account, or acting as an appointed
57
+ representative at an online or offline event.
58
+
59
+ ## Enforcement
60
+
61
+ Instances of abusive, harassing, or otherwise unacceptable behavior may be
62
+ reported to the community leaders responsible for enforcement at
63
+ the official FROID Discord server (<https://discord.com/invite/gk8jAdXWmj>) - DM a moderator or flag a post.
64
+ All complaints will be reviewed and investigated promptly and fairly.
65
+
66
+ All community leaders are obligated to respect the privacy and security of the
67
+ reporter of any incident.
68
+
69
+ ## Enforcement Guidelines
70
+
71
+ Community leaders will follow these Community Impact Guidelines in determining
72
+ the consequences for any action they deem in violation of this Code of Conduct:
73
+
74
+ ### 1. Correction
75
+
76
+ **Community Impact**: Use of inappropriate language or other behavior deemed
77
+ unprofessional or unwelcome in the community.
78
+
79
+ **Consequence**: A private, written warning from community leaders, providing
80
+ clarity around the nature of the violation and an explanation of why the
81
+ behavior was inappropriate. A public apology may be requested.
82
+
83
+ ### 2. Warning
84
+
85
+ **Community Impact**: A violation through a single incident or series
86
+ of actions.
87
+
88
+ **Consequence**: A warning with consequences for continued behavior. No
89
+ interaction with the people involved, including unsolicited interaction with
90
+ those enforcing the Code of Conduct, for a specified period of time. This
91
+ includes avoiding interactions in community spaces as well as external channels
92
+ like social media. Violating these terms may lead to a temporary or
93
+ permanent ban.
94
+
95
+ ### 3. Temporary Ban
96
+
97
+ **Community Impact**: A serious violation of community standards, including
98
+ sustained inappropriate behavior.
99
+
100
+ **Consequence**: A temporary ban from any sort of interaction or public
101
+ communication with the community for a specified period of time. No public or
102
+ private interaction with the people involved, including unsolicited interaction
103
+ with those enforcing the Code of Conduct, is allowed during this period.
104
+ Violating these terms may lead to a permanent ban.
105
+
106
+ ### 4. Permanent Ban
107
+
108
+ **Community Impact**: Demonstrating a pattern of violation of community
109
+ standards, including sustained inappropriate behavior, harassment of an
110
+ individual, or aggression toward or disparagement of classes of individuals.
111
+
112
+ **Consequence**: A permanent ban from any sort of public interaction within
113
+ the community.
114
+
115
+ ## Attribution
116
+
117
+ This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118
+ version 2.0, available at
119
+ <https://www.contributor-covenant.org/version/2/0/code_of_conduct.html>.
120
+
121
+ Community Impact Guidelines were inspired by [Mozilla's code of conduct
122
+ enforcement ladder](https://github.com/mozilla/diversity).
123
+
124
+ [homepage]: https://www.contributor-covenant.org
125
+
126
+ For answers to common questions about this code of conduct, see the FAQ at
127
+ <https://www.contributor-covenant.org/faq>. Translations are available at
128
+ <https://www.contributor-covenant.org/translations>.
@@ -0,0 +1,15 @@
1
+ # These are supported funding model platforms
2
+
3
+ github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
4
+ patreon: # Replace with a single Patreon username
5
+ open_collective: # Replace with a single Open Collective username
6
+ ko_fi: # Replace with a single Ko-fi username
7
+ tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
8
+ community_bridge: # Replace with a single Community Bridge project_name e.g., cloud-foundry
9
+ liberapay: # Replace with a single Liberapay username
10
+ issuehunt: # Replace with a single IssueHunt username
11
+ lfx_crowdfunding: # Replace with a single LFX Crowdfunding project_name e.g., cloud-foundry
12
+ polar: # Replace with a single Polar username
13
+ buy_me_a_coffee: froid
14
+ thanks_dev: # Replace with a single thanks.dev username
15
+ custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
@@ -0,0 +1,139 @@
1
+ name: Bug Report
2
+ description: File a bug report to help us improve froid-loop
3
+ title: "[BUG] "
4
+ labels: bug
5
+ assignees: []
6
+ body:
7
+ - type: markdown
8
+ attributes:
9
+ value: |
10
+ Thanks for filing a bug report! Please fill out the information below to help us reproduce and fix the issue.
11
+
12
+ Running `froid-loop diagnose --out diag.md` produces a **sanitized** dump (no code, specs, prompts, paths, or PII) that helps us debug — please attach it below. **Review it first** and confirm it contains nothing private.
13
+
14
+ - type: textarea
15
+ id: description
16
+ attributes:
17
+ label: Description
18
+ description: Clear and concise description of what the bug is
19
+ placeholder: e.g., When I start a run, the loop hangs after the dev session ends
20
+ validations:
21
+ required: true
22
+
23
+ - type: textarea
24
+ id: steps
25
+ attributes:
26
+ label: Steps to reproduce
27
+ description: Step-by-step instructions to reproduce the behavior
28
+ placeholder: |
29
+ 1. Run 'froid-loop run <story-key>'
30
+ 2. Watch the TUI / journal
31
+ 3. See error
32
+ validations:
33
+ required: true
34
+
35
+ - type: textarea
36
+ id: expected
37
+ attributes:
38
+ label: Expected behavior
39
+ description: What you expected to happen
40
+ placeholder: The run should advance to the review stage
41
+ validations:
42
+ required: true
43
+
44
+ - type: textarea
45
+ id: actual
46
+ attributes:
47
+ label: Actual behavior
48
+ description: What actually happened
49
+ placeholder: The run stalled with no further journal output
50
+ validations:
51
+ required: true
52
+
53
+ - type: textarea
54
+ id: screenshots
55
+ attributes:
56
+ label: Screenshots
57
+ description: Add screenshots if applicable (paste images directly)
58
+ placeholder: Paste any relevant screenshots here
59
+
60
+ - type: dropdown
61
+ id: area
62
+ attributes:
63
+ label: Which area is this for?
64
+ description: Select the part of froid-loop this issue relates to
65
+ options:
66
+ - Orchestrator / control loop
67
+ - TUI (dashboard)
68
+ - Plugins
69
+ - Skills (froid-loop-*)
70
+ - CLI adapters & profiles
71
+ - Setup / init
72
+ - Not sure / Other
73
+ validations:
74
+ required: true
75
+
76
+ - type: input
77
+ id: version
78
+ attributes:
79
+ label: froid-loop Version
80
+ description: "Check with: froid-loop --version"
81
+ placeholder: e.g., 0.5.1
82
+ validations:
83
+ required: true
84
+
85
+ - type: dropdown
86
+ id: cli
87
+ attributes:
88
+ label: Which coding CLI are you using?
89
+ options:
90
+ - Claude (claude)
91
+ - Codex (codex)
92
+ - Gemini (gemini)
93
+ - Cursor (cursor)
94
+ - Other
95
+ validations:
96
+ required: true
97
+
98
+ - type: dropdown
99
+ id: platform
100
+ attributes:
101
+ label: Operating System
102
+ description: On WSL, run `froid-loop mux` and read the `selection:` line — `platform default for linux`
103
+ is the supported setup, `platform default for win32` means you are on the Windows build
104
+ and should say so below. A forced `FROID_LOOP_MUX_BACKEND`/`[mux] backend` choice replaces
105
+ that line with the forced reason; `froid-loop diagnose` reports `sys.platform` either way.
106
+ options:
107
+ - macOS
108
+ - Windows
109
+ - Windows (WSL)
110
+ - Linux
111
+ - Other
112
+ validations:
113
+ required: true
114
+
115
+ - type: textarea
116
+ id: logs
117
+ attributes:
118
+ label: Relevant log output
119
+ description: Copy and paste any relevant log output (journal, run directory, tmux session)
120
+ render: shell
121
+
122
+ - type: textarea
123
+ id: diagnostics
124
+ attributes:
125
+ label: Diagnostic dump (froid-loop diagnose)
126
+ description: |
127
+ Output of `froid-loop diagnose --out diag.md` (add `--all` to cover every run; `--json --out diag.json` writes a machine-readable JSON document instead of the markdown report). **Drag-and-drop the written file here** (or paste its contents). It's sanitized — identifiers are pseudonymized and the output is re-scanned by a fail-closed leak check before it's written — but **no scrubber is perfect**: open the file and verify it contains no PII, secrets, or project-specific content before attaching.
128
+
129
+ - type: checkboxes
130
+ id: terms
131
+ attributes:
132
+ label: Confirm
133
+ options:
134
+ - label: I've searched for existing issues
135
+ required: true
136
+ - label: If I attached a diagnose dump, I reviewed it and confirmed it contains no PII, secrets, or project-specific information
137
+ required: false
138
+ - label: I'm using the latest version
139
+ required: false
@@ -0,0 +1,11 @@
1
+ blank_issues_enabled: false
2
+ contact_links:
3
+ - name: 📚 Documentation
4
+ url: https://docs.froid-plane.org
5
+ about: Check the docs first — tutorials, guides, and reference
6
+ - name: 💬 Discord Community
7
+ url: https://discord.gg/gk8jAdXWmj
8
+ about: Join for questions, discussion, and help before opening an issue
9
+ - name: 🛠 Troubleshooting — run `froid-loop diagnose`
10
+ url: https://github.com/cordya-ai/froid-loop/blob/main/README.md#contributing
11
+ about: Before filing a bug, run `froid-loop diagnose` and attach the sanitized dump — and verify it has no PII first
@@ -0,0 +1,55 @@
1
+ name: Documentation
2
+ description: Report issues or suggest improvements to documentation
3
+ title: "[DOCS] "
4
+ labels: documentation
5
+ assignees: []
6
+ body:
7
+ - type: markdown
8
+ attributes:
9
+ value: |
10
+ Help us improve the froid-loop documentation!
11
+
12
+ - type: dropdown
13
+ id: doc-type
14
+ attributes:
15
+ label: What type of documentation issue is this?
16
+ options:
17
+ - Error or inaccuracy
18
+ - Missing information
19
+ - Unclear or confusing
20
+ - Outdated content
21
+ - Request for new documentation
22
+ - Typo or grammar
23
+ validations:
24
+ required: true
25
+
26
+ - type: textarea
27
+ id: location
28
+ attributes:
29
+ label: Documentation location
30
+ description: Where is the documentation that needs improvement?
31
+ placeholder: e.g., docs/setup-guide.md, or "In the README Quick start section"
32
+ validations:
33
+ required: true
34
+
35
+ - type: textarea
36
+ id: issue
37
+ attributes:
38
+ label: What's the issue?
39
+ description: Describe the documentation issue in detail
40
+ placeholder: e.g., Step 3 says to run command X but it should be command Y
41
+ validations:
42
+ required: true
43
+
44
+ - type: textarea
45
+ id: suggestion
46
+ attributes:
47
+ label: Suggested improvement
48
+ description: How would you like to see this improved?
49
+ placeholder: e.g., Change the command to X and add an example
50
+
51
+ - type: input
52
+ id: version
53
+ attributes:
54
+ label: froid-loop Version (if applicable)
55
+ placeholder: e.g., 0.5.1
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: Feature Request
3
+ about: Suggest an idea or new feature
4
+ title: ''
5
+ labels: ''
6
+ assignees: ''
7
+ ---
8
+
9
+ **Describe your idea**
10
+ A clear and concise description of what you'd like to see added or changed.
11
+
12
+ **Why is this needed?**
13
+ Explain the problem this solves or the benefit it brings to the froid-loop community.
14
+
15
+ **How should it work?**
16
+ Describe your proposed solution. If you have ideas on implementation, share them here.
17
+
18
+ **PR**
19
+ If you'd like to contribute, please indicate you're working on this or link to your PR. Please review [CONTRIBUTING.md](../../CONTRIBUTING.md) — contributions are always welcome!
20
+
21
+ **Additional context**
22
+ Add any other context, screenshots, or links that help explain your idea.
@@ -0,0 +1,23 @@
1
+ ## What
2
+
3
+ <!-- 1-2 sentences describing WHAT changed -->
4
+
5
+ ## Why
6
+
7
+ <!-- 1-2 sentences explaining WHY this change is needed -->
8
+ <!-- Fixes `#issue_number` (if applicable) -->
9
+
10
+ ## How
11
+
12
+ <!-- 2-3 bullets listing HOW you implemented it -->
13
+
14
+ -
15
+
16
+ ## Testing
17
+
18
+ <!-- 1-2 sentences on how you tested this -->
19
+
20
+ ## Changelog
21
+
22
+ <!-- Entry added under `## [Unreleased]` in CHANGELOG.md, under one of: Added, Changed,
23
+ Deprecated, Removed, Fixed, Security. Write "n/a" if nothing user-visible changed. -->
@@ -0,0 +1,22 @@
1
+ version: 2
2
+ updates:
3
+ # Keep the pinned GitHub Actions majors current.
4
+ - package-ecosystem: github-actions
5
+ directory: /
6
+ schedule:
7
+ interval: weekly
8
+ commit-message:
9
+ prefix: ci
10
+
11
+ # Security advisories only, for the Python dependencies in uv.lock.
12
+ # `open-pull-requests-limit: 0` switches off routine version-update PRs;
13
+ # security updates are exempt from the limit and still open. Version pins here
14
+ # are deliberate (pyright is pinned exactly so CI and contributors run one
15
+ # version), so a weekly bump stream would be noise — an advisory is not.
16
+ - package-ecosystem: uv
17
+ directory: /
18
+ schedule:
19
+ interval: weekly
20
+ open-pull-requests-limit: 0
21
+ commit-message:
22
+ prefix: chore