generic-ml-wrapper 0.4.0__tar.gz → 0.6.0__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 (307) hide show
  1. generic_ml_wrapper-0.6.0/.github/workflows/release.yml +47 -0
  2. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/CHANGELOG.md +84 -1
  3. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/PKG-INFO +2 -1
  4. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/ROADMAP.md +117 -47
  5. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/SECURITY.md +1 -1
  6. generic_ml_wrapper-0.6.0/VERSION +1 -0
  7. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/CLI.md +144 -5
  8. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/WORKFLOWS.md +22 -5
  9. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/hatch_build.py +7 -20
  10. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/pyproject.toml +7 -1
  11. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/__init__.py +1 -1
  12. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/inbound/cli/app.py +568 -117
  13. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/adapter/inbound/cli/help_topics.py +57 -0
  14. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/adapter/inbound/cli/hints.py +66 -0
  15. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/adapter/inbound/cli/index.py +72 -0
  16. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_seeder.py +13 -33
  17. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_guided_chooser.py +53 -0
  18. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_workflow_chooser.py +53 -0
  19. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/claude_cli_caller.py +2 -1
  20. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/codex_cli_caller.py +2 -1
  21. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/status_line_config.py +3 -2
  22. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_cli_caller.py +4 -3
  23. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/compress/cache_backed_compressor.py +5 -3
  24. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/adapter/outbound/config/__init__.py +3 -0
  25. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/adapter/outbound/config/tomlkit_config_writer.py +79 -0
  26. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/gateway/relay.py +2 -1
  27. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/size_logger.py +2 -1
  28. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/adapter/outbound/status/claude_status_parser.py +125 -0
  29. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/status/cursor_status_parser.py +8 -0
  30. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/workflow/filesystem_workflow_source.py +82 -2
  31. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/client_status.py +15 -1
  32. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/domain/model/draft.py +27 -0
  33. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/greeting.py +21 -0
  34. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/hook_runner.py +2 -1
  35. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/statusline_renderer.py +39 -1
  36. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/port/inbound/config_commands.py +84 -0
  37. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/port/inbound/edit_workflow.py +47 -0
  38. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/port/inbound/new_workflow.py +87 -0
  39. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/start_job.py +17 -2
  40. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/port/outbound/config_writer.py +41 -0
  41. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/port/outbound/workflow_source.py +134 -0
  42. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/usecase/new_workflow.py → generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/usecase/edit_workflow.py +38 -24
  43. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/launch.py +2 -1
  44. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/usecase/new_workflow.py +172 -0
  45. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/start_job.py +45 -3
  46. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/application/usecase/update_config.py +86 -0
  47. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/wiring/composition.py +70 -0
  48. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/common/config.py +81 -11
  49. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/common/i18n.py +53 -2
  50. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/common/paths.py +7 -0
  51. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/common/settings_registry.py +371 -0
  52. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/resources/i18n/en.json +157 -0
  53. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/resources/i18n/fr.json +157 -0
  54. generic_ml_wrapper-0.6.0/src/generic_ml_wrapper/resources/workflows/create-workflow/guided.md +60 -0
  55. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/resources/workflows/create-workflow/workflow.md +20 -8
  56. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_authoring_separation.py +3 -2
  57. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_cli.py +403 -40
  58. generic_ml_wrapper-0.4.0/tests/test_new_workflow_usecase.py → generic_ml_wrapper-0.6.0/tests/test_edit_workflow_usecase.py +48 -19
  59. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_exit_handling.py +0 -6
  60. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_filesystem_workflow_source.py +45 -0
  61. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_greeting.py +7 -0
  62. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_i18n.py +40 -0
  63. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_list_workflows_usecase.py +16 -0
  64. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_model_invariants.py +5 -0
  65. generic_ml_wrapper-0.6.0/tests/test_new_workflow_usecase.py +229 -0
  66. generic_ml_wrapper-0.6.0/tests/test_settings_registry.py +115 -0
  67. generic_ml_wrapper-0.6.0/tests/test_smoke.py +28 -0
  68. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_start_job_usecase.py +79 -3
  69. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_statusline.py +53 -6
  70. generic_ml_wrapper-0.6.0/tests/test_tty_guided_chooser.py +50 -0
  71. generic_ml_wrapper-0.6.0/tests/test_tty_workflow_chooser.py +59 -0
  72. generic_ml_wrapper-0.6.0/tests/test_update_config_usecase.py +86 -0
  73. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/uv.lock +164 -1
  74. generic_ml_wrapper-0.4.0/.github/workflows/release.yml +0 -28
  75. generic_ml_wrapper-0.4.0/VERSION +0 -1
  76. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/status/claude_status_parser.py +0 -76
  77. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/inbound/new_workflow.py +0 -48
  78. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/workflow_source.py +0 -69
  79. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/resources/i18n/en.json +0 -36
  80. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/resources/i18n/fr.json +0 -36
  81. generic_ml_wrapper-0.4.0/tests/test_smoke.py +0 -20
  82. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/.coveragerc +0 -0
  83. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/.gitattributes +0 -0
  84. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/.github/workflows/ci.yml +0 -0
  85. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/.github/workflows/pr-hygiene.yml +0 -0
  86. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/.github/workflows/sonar.yml +0 -0
  87. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/.gitignore +0 -0
  88. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/.importlinter +0 -0
  89. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/.pre-commit-config.yaml +0 -0
  90. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/AGENTS.md +0 -0
  91. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/CODE_OF_CONDUCT.md +0 -0
  92. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/CONTRIBUTING.md +0 -0
  93. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/GOVERNANCE.md +0 -0
  94. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/LICENSE +0 -0
  95. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/NOTICE +0 -0
  96. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/README.md +0 -0
  97. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/RELEASE.md +0 -0
  98. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/CLIENTS.md +0 -0
  99. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/CONFIGURATION.md +0 -0
  100. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/DESIGN.md +0 -0
  101. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/TROUBLESHOOTING.md +0 -0
  102. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/USER_GUIDE.md +0 -0
  103. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/images/gmlw-favicon.svg +0 -0
  104. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/images/gmlw-lockup-dark.svg +0 -0
  105. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/images/gmlw-lockup.svg +0 -0
  106. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/images/gmlw-statusline.gif +0 -0
  107. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/images/gmlw-usage.gif +0 -0
  108. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/tapes/README.md +0 -0
  109. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/tapes/render.sh +0 -0
  110. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/tapes/seed.py +0 -0
  111. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/tapes/statusline.tape +0 -0
  112. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/docs/tapes/usage.tape +0 -0
  113. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/noxfile.py +0 -0
  114. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/pyrightconfig.json +0 -0
  115. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/sonar-project.properties +0 -0
  116. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/__init__.py +0 -0
  117. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/inbound/__init__.py +0 -0
  118. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/inbound/cli/__init__.py +0 -0
  119. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/inbound/cli/banner.py +0 -0
  120. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/__init__.py +0 -0
  121. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/__init__.py +0 -0
  122. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_migrator.py +0 -0
  123. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/http_client_versions.py +0 -0
  124. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/path_client_detector.py +0 -0
  125. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/subprocess_command_runner.py +0 -0
  126. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/system_clipboard.py +0 -0
  127. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_client_setup.py +0 -0
  128. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_language_chooser.py +0 -0
  129. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_persona_chooser.py +0 -0
  130. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_prompt.py +0 -0
  131. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_text_prompt.py +0 -0
  132. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/__init__.py +0 -0
  133. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_file.py +0 -0
  134. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_opening.py +0 -0
  135. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/cursor_cli_caller.py +0 -0
  136. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/default_provider.py +0 -0
  137. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/loader.py +0 -0
  138. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_config.py +0 -0
  139. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/compress/__init__.py +0 -0
  140. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/credentials/__init__.py +0 -0
  141. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/credentials/filesystem_credentials_store.py +0 -0
  142. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/gateway/__init__.py +0 -0
  143. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/gateway/anthropic_sse.py +0 -0
  144. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_chat.py +0 -0
  145. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_responses.py +0 -0
  146. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/hook/__init__.py +0 -0
  147. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/hook/session_logger.py +0 -0
  148. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/__init__.py +0 -0
  149. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/persona/__init__.py +0 -0
  150. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/persona/filesystem_persona_source.py +0 -0
  151. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/plugin/__init__.py +0 -0
  152. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/plugin/filesystem_plugin_source.py +0 -0
  153. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/status/__init__.py +0 -0
  154. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/store/__init__.py +0 -0
  155. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/store/filesystem_transcript_store.py +0 -0
  156. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/store/ledger.py +0 -0
  157. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_per_turn_store.py +0 -0
  158. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_session_store.py +0 -0
  159. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_usage_store.py +0 -0
  160. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/workflow/__init__.py +0 -0
  161. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/workspace/__init__.py +0 -0
  162. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/adapter/outbound/workspace/local_workspace_inspector.py +0 -0
  163. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/__init__.py +0 -0
  164. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/__init__.py +0 -0
  165. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/__init__.py +0 -0
  166. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/client_catalog.py +0 -0
  167. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/context_source.py +0 -0
  168. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/identifiers.py +0 -0
  169. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/learned.py +0 -0
  170. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/migration.py +0 -0
  171. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/persona.py +0 -0
  172. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/plugin.py +0 -0
  173. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/rules.py +0 -0
  174. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/run.py +0 -0
  175. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/session.py +0 -0
  176. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/turn_usage.py +0 -0
  177. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/model/workspace.py +0 -0
  178. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/__init__.py +0 -0
  179. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/hook.py +0 -0
  180. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/interceptor.py +0 -0
  181. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/interceptor_chain.py +0 -0
  182. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/persona_parser.py +0 -0
  183. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/rule_cleaner.py +0 -0
  184. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/domain/service/session_naming.py +0 -0
  185. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/__init__.py +0 -0
  186. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/__init__.py +0 -0
  187. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/bootstrap.py +0 -0
  188. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/check_client_ready.py +0 -0
  189. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/export_usage.py +0 -0
  190. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/init.py +0 -0
  191. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/list_jobs.py +0 -0
  192. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/list_personas.py +0 -0
  193. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/list_plugins.py +0 -0
  194. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/list_sessions.py +0 -0
  195. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/list_workflows.py +0 -0
  196. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/migrate_layout.py +0 -0
  197. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/render_greeting.py +0 -0
  198. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/render_statusline.py +0 -0
  199. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/inbound/set_credential.py +0 -0
  200. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/__init__.py +0 -0
  201. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/cli_caller.py +0 -0
  202. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/client_detector.py +0 -0
  203. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/client_setup.py +0 -0
  204. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/client_status.py +0 -0
  205. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/client_version.py +0 -0
  206. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/clipboard.py +0 -0
  207. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/command_runner.py +0 -0
  208. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/context_compressor.py +0 -0
  209. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/credentials_store.py +0 -0
  210. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/hook.py +0 -0
  211. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/interceptor.py +0 -0
  212. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/language_chooser.py +0 -0
  213. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/layout_migrator.py +0 -0
  214. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/layout_seeder.py +0 -0
  215. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/per_turn_metering.py +0 -0
  216. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/persona_chooser.py +0 -0
  217. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/persona_source.py +0 -0
  218. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/plugin_source.py +0 -0
  219. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/session_store.py +0 -0
  220. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/text_prompt.py +0 -0
  221. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/transcript.py +0 -0
  222. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/usage_store.py +0 -0
  223. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/port/outbound/workspace.py +0 -0
  224. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/__init__.py +0 -0
  225. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/bootstrap.py +0 -0
  226. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/check_client_ready.py +0 -0
  227. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/export_usage.py +0 -0
  228. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/init.py +0 -0
  229. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/list_jobs.py +0 -0
  230. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/list_personas.py +0 -0
  231. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/list_plugins.py +0 -0
  232. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/list_sessions.py +0 -0
  233. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/list_workflows.py +0 -0
  234. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/migrate_layout.py +0 -0
  235. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/render_greeting.py +0 -0
  236. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/render_statusline.py +0 -0
  237. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/usecase/set_credential.py +0 -0
  238. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/application/wiring/__init__.py +0 -0
  239. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/common/__init__.py +0 -0
  240. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/common/log.py +0 -0
  241. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/common/spec_loader.py +0 -0
  242. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/py.typed +0 -0
  243. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/resources/personas/_floor.md +0 -0
  244. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/resources/personas/butler.md +0 -0
  245. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/resources/personas/companion.md +0 -0
  246. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/resources/personas/mentor.md +0 -0
  247. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/resources/personas/plain.md +0 -0
  248. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/resources/personas/terse.md +0 -0
  249. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/src/generic_ml_wrapper/resources/workflows/_common/base.md +0 -0
  250. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/_conformance.py +0 -0
  251. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/conftest.py +0 -0
  252. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_anthropic_sse.py +0 -0
  253. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_banner.py +0 -0
  254. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_bootstrap.py +0 -0
  255. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_cache_backed_compressor.py +0 -0
  256. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_caller_loader.py +0 -0
  257. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_callers.py +0 -0
  258. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_check_client_ready.py +0 -0
  259. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_client_catalog.py +0 -0
  260. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_client_versions.py +0 -0
  261. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_config.py +0 -0
  262. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_context_file.py +0 -0
  263. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_context_source.py +0 -0
  264. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_credentials_store.py +0 -0
  265. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_cursor_status_parser.py +0 -0
  266. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_docs_consistency.py +0 -0
  267. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_export_usage_usecase.py +0 -0
  268. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_filesystem_persona_source.py +0 -0
  269. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_filesystem_plugin_source.py +0 -0
  270. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_filesystem_transcript_store.py +0 -0
  271. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_hook_runner.py +0 -0
  272. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_identifiers.py +0 -0
  273. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_init_usecase.py +0 -0
  274. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_interceptor_chain.py +0 -0
  275. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_layout_migrator.py +0 -0
  276. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_learned.py +0 -0
  277. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_list_jobs_usecase.py +0 -0
  278. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_list_personas_usecase.py +0 -0
  279. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_list_plugins_usecase.py +0 -0
  280. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_list_sessions_usecase.py +0 -0
  281. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_local_workspace_inspector.py +0 -0
  282. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_log.py +0 -0
  283. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_migrate_layout_usecase.py +0 -0
  284. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_openai_chat.py +0 -0
  285. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_openai_responses.py +0 -0
  286. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_path_client_detector.py +0 -0
  287. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_persona_parser.py +0 -0
  288. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_relay.py +0 -0
  289. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_render_greeting_usecase.py +0 -0
  290. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_rule_cleaner.py +0 -0
  291. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_session_logger.py +0 -0
  292. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_session_naming.py +0 -0
  293. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_size_logger.py +0 -0
  294. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_sqlite_per_turn_store.py +0 -0
  295. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_sqlite_session_store.py +0 -0
  296. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_sqlite_usage_store.py +0 -0
  297. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_status_line_config.py +0 -0
  298. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_store_conformance.py +0 -0
  299. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_tty_client_setup.py +0 -0
  300. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_tty_language_chooser.py +0 -0
  301. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_tty_persona_chooser.py +0 -0
  302. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_tty_prompt.py +0 -0
  303. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_tty_text_prompt.py +0 -0
  304. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_version.py +0 -0
  305. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tests/test_vibe_config.py +0 -0
  306. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tools/hooks/check-commit-msg.sh +0 -0
  307. {generic_ml_wrapper-0.4.0 → generic_ml_wrapper-0.6.0}/tools/hooks/guard-branch.sh +0 -0
@@ -0,0 +1,47 @@
1
+ # Publish to PyPI via Trusted Publishing (OIDC) on a version tag (e.g. v0.5.0). No token
2
+ # or secret: PyPI trusts this exact repo + workflow + environment, and GitHub mints a
3
+ # short-lived OIDC credential for the upload. Release flow (matches generic-ml-cache):
4
+ # bump VERSION + CHANGELOG on a release branch, merge to main, then tag the head. Every
5
+ # build-time input is pinned (Actions by commit SHA, uv by [tool.uv] required-version).
6
+ name: release
7
+
8
+ on:
9
+ push:
10
+ tags: ["v*"]
11
+
12
+ permissions:
13
+ contents: read
14
+
15
+ jobs:
16
+ # Fail fast if the tag does not match VERSION, so a mistagged release (e.g. v0.5.0
17
+ # pointing at a commit still on 0.4.0) never builds and publishes the wrong version.
18
+ guard:
19
+ name: Tag matches version
20
+ runs-on: ubuntu-latest
21
+ steps:
22
+ - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
23
+ - name: Tag must equal VERSION
24
+ run: |
25
+ tag="${GITHUB_REF_NAME#v}"
26
+ version="$(tr -d '[:space:]' < VERSION)"
27
+ if [ "$version" != "$tag" ]; then
28
+ echo "::error::tag ${GITHUB_REF_NAME} does not match VERSION ($version)"
29
+ exit 1
30
+ fi
31
+ echo "tag v$tag matches VERSION $version"
32
+
33
+ pypi-publish:
34
+ name: Build and publish to PyPI
35
+ needs: guard
36
+ runs-on: ubuntu-latest
37
+ environment: pypi
38
+ permissions:
39
+ id-token: write # OIDC token for Trusted Publishing
40
+ contents: read
41
+ steps:
42
+ - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
43
+ - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
44
+ - name: Build sdist + wheel
45
+ run: uv build
46
+ - name: Publish to PyPI (Trusted Publishing)
47
+ run: uv publish --trusted-publishing always
@@ -6,6 +6,87 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.6.0] - 2026-07-19
10
+
11
+ The workflow, made first-class — a direct way to run one, name-at-the-end authoring, and
12
+ a guided authoring experience — plus a truthful context meter on the status line.
13
+
14
+ ### Added
15
+ - **`run <workflow>`.** Launch a workflow directly: the job is named after the workflow
16
+ and its sessions accumulate there — the recurring-procedure counterpart to `start`
17
+ (which enters a job you return to), equivalent to `gmlw start <workflow> -w <workflow>`.
18
+ With no workflow given, a trigger-gated pre-launch chooser offers the authored ones at a
19
+ terminal and echoes the equivalent one-liner so interactive use teaches the fast path;
20
+ full argv never prompts, and a non-interactive run degrades cleanly.
21
+ - **`workflow new` decides the name at the end.** The name is optional and proposed at the
22
+ end of the interview, not demanded up front. Authoring runs in a private draft folder
23
+ under `~/.gmlw/drafts/` (sessions accumulate under `create-workflow`); on a finished
24
+ marker, gmlw atomically deploys the draft into `~/.gmlw/workflows/<name>/`, so a
25
+ half-authored workflow never appears in `workflow list` or `run`. A name given up front
26
+ is a seed that fails fast on a collision; a name taken at deploy, or an unfinished
27
+ session, keeps the draft and points at `workflow edit`.
28
+ - **Guided authoring.** `workflow new` / `edit` offer a richer, facilitative guide — a
29
+ parking lot for tangents, a diverge→converge rhythm, process-leveling ("a step, or its
30
+ own workflow?"), proposing the upstream/downstream stages you left out, with
31
+ anti-railroading and consent-gate guardrails, and distilled-state files (`draft.md`,
32
+ `parking-lot.md`) so a long session survives context compaction. The choice is asked on
33
+ every interactive run (Enter takes guided); `--guided` / `--quick` answer up front, and a
34
+ non-interactive run defaults to quick. The guide is injected only when chosen, so quick
35
+ is genuinely cheaper.
36
+ - **Status line: a truthful context meter.** The claude status line now shows the
37
+ denominator — `ctx 155.6k/200k (78%)` instead of a bare percentage — so a window
38
+ under-reported behind the metering relay (which looks like a gateway, capping the
39
+ reported window at 200k) is visible. Rate-limit windows also render their time-to-reset
40
+ (`5h 90% (↻ 12m) · wk 40% (↻ 3d)`) from `resets_at`, since a percentage without a reset
41
+ time is not actionable. Both degrade to the previous output when a client omits the
42
+ fields; the cursor parser reads the same context shape.
43
+
44
+ ## [0.5.0] - 2026-07-19
45
+
46
+ Discoverability and progressive disclosure — shortening time-to-first-session and
47
+ revealing depth gradually — plus app-wide localisation.
48
+
49
+ ### Added
50
+ - **App-wide localisation.** Every user-facing message **and every diagnostic log line**
51
+ now renders through a process-global active localiser (`i18n.set_active` / `active` /
52
+ `t`), bound once at startup from the configured language, English-fallback then raw-key
53
+ safe. The EN/FR catalogues are kept in lockstep by a drift-guard test. Localising the
54
+ logs too is a deliberate choice, not the usual English-only-logs convention.
55
+ - **Config registry + `config` commands.** A `pydantic-settings` model is the typed source
56
+ of truth for every settable scalar key (type, default, allowed values, description).
57
+ `gmlw config list / get / set` render and validate against it; `set` merges through a
58
+ shared tomlkit writer (comments and formatting preserved, never rewritten) and surfaces
59
+ the old→new change. The home for changing `default_role` / `default_environment` after
60
+ init. Scope is the scalar keys; the structural matrices (`[[hooks]]`, `[[interceptors]]`,
61
+ `[startup.*.context]`, `[compress.prompts]`) stay hand-rolled, a deferred follow-up.
62
+ - **Bare `gmlw` capability index + `gmlw help <topic>`.** Bare `gmlw` is first-run-aware: a
63
+ fresh install runs `init`, thereafter it shows a grouped capability index
64
+ (launch / inspect / author) with a next-action footer. `gmlw help` explains the core
65
+ concepts (`job-vs-workflow`, `start-vs-run`, `personas`, `cost`). `--help` keeps the
66
+ argparse view.
67
+ - **Exit receipt.** On the return (client exit), a persistent summary: this session's and
68
+ the job's cost, the resume/report commands, and one usage-driven, suppressible tip (shown
69
+ once each; `[hints] show = false` disables). `StartJob` now returns a `StartJobResult` so
70
+ the receipt can name the session.
71
+ - **Ambient capability card.** An off-by-default context injection
72
+ (`[ambient] capability_card`): a localised "how do I … in gmlw" card appended to a new
73
+ session's context so the client can answer gmlw questions mid-session.
74
+ - **`gmlw workflow edit`.** Amend an existing workflow in an authoring session — opens its
75
+ folder, never creates or overwrites; an unknown workflow exits non-zero with guidance.
76
+
77
+ ### Changed
78
+ - **Greeting → context.** The launch-time host greeting (structurally invisible once the
79
+ client clears the screen) is no longer printed to stderr; it is injected into a new
80
+ session's context so the client renders it in-band. The parting `Bye, <name>.` on exit
81
+ stays.
82
+ - **`--version`.** Reports `gmlw <version> (build <id>)`; the git sha was dropped — it was
83
+ captured at build time and every distributed artifact is built without a `.git` checkout,
84
+ so it was always `unknown` where it would matter.
85
+
86
+ ### Notes
87
+ - Authoring-cost visibility is deferred: the authoring bucket is deliberately kept out of
88
+ `gmlw jobs`; surfacing its spend cleanly is its own design.
89
+
9
90
  ## [0.4.0] - 2026-07-19
10
91
 
11
92
  The first-run release — a mandatory `init` that establishes the model the rest of the app
@@ -177,7 +258,9 @@ First public release — a metering wrapper around ML coding CLIs.
177
258
  over `src` and `tests`; `nox` gates mirrored by CI across Python 3.11–3.14; a
178
259
  server-side no-AI-attribution check and branch protection.
179
260
 
180
- [Unreleased]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.4.0...HEAD
261
+ [Unreleased]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.6.0...HEAD
262
+ [0.6.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.5.0...v0.6.0
263
+ [0.5.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.4.0...v0.5.0
181
264
  [0.4.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.3.0...v0.4.0
182
265
  [0.3.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.2.0...v0.3.0
183
266
  [0.2.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.1.0...v0.2.0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: generic-ml-wrapper
3
- Version: 0.4.0
3
+ Version: 0.6.0
4
4
  Summary: A wrapper around an ML coding CLI: enter at a job, get a named resumable session, optionally driven by a workflow.
5
5
  Project-URL: Homepage, https://github.com/danielslobozian/generic-ml-wrapper
6
6
  Project-URL: Repository, https://github.com/danielslobozian/generic-ml-wrapper
@@ -26,6 +26,7 @@ Requires-Python: >=3.11
26
26
  Requires-Dist: generic-ml-cache-adapters>=1.0.0
27
27
  Requires-Dist: generic-ml-cache-bootstrap>=1.0.0
28
28
  Requires-Dist: generic-ml-cache-core>=1.0.0
29
+ Requires-Dist: pydantic-settings>=2
29
30
  Requires-Dist: tomlkit>=0.13
30
31
  Provides-Extra: dev
31
32
  Requires-Dist: import-linter>=2; extra == 'dev'
@@ -148,46 +148,52 @@ costume and makeup, briefs the director, then cedes the screen ([[wrapper-not-st
148
148
 
149
149
  Deferred but homed: a detached model call to synthesise a `role.md` for an unfamiliar role
150
150
  (e.g. product owner) is a natural future consumer of the 0.3.0 `pre-launch` seam — parked,
151
- not built. **Persona *previews* moved to 0.7.0** — sample lines are only worth shipping once
151
+ not built. **Persona *previews* moved to 0.8.0** — sample lines are only worth shipping once
152
152
  the personas behind them are proven to actually differ, and doing them in French requires
153
- localising persona content, which is the same job (see 0.7.0).
154
-
155
- ## Planned
153
+ localising persona content, which is the same job (see 0.8.0).
156
154
 
157
155
  ### 0.5.0 — discoverability & progressive disclosure
158
156
  Reframed around the real metric for a new user: **time to a first live session**, and then
159
- revealing depth *gradually* rather than dumping it up front. Because the wrapper cedes the
160
- screen to the client, discovery lives in the thin surfaces **around** a run — bare-command
161
- indexes, the return, and ambient context pushed *into* the client — never a persistent UI
162
- over a live session.
163
-
164
- - **Bare `gmlw` is first-run-aware** — first time → the 0.4.0 init; thereafter → a grouped
165
- capability index (*launch / inspect / author*), with `gmlw help <topic>` for the core
166
- concepts (job vs workflow, start vs run, personas, cost). `--help` keeps the argparse
167
- view; every listing ends with a next-action footer.
168
- - **Config registry** — one typed source of truth (a `pydantic-settings` model) for every
169
- setting: key, type, default, allowed values, description. It replaces the hand-rolled
170
- accessors, and every surface (help, `config`, per-workflow settings, the 0.4.0
171
- role/environment keys) renders from it.
172
- - **`config` commands** — `config list / get / set`, rendering the registry with inline
173
- allowed-value validation. The home for changing `default_role` / `default_environment`
174
- after init.
175
- - **`--version`** — surface the running version.
176
- - **Progressive disclosure** — depth is revealed over time, not dumped up front:
177
- - **Exit receipt** — on the return (client exit), a persistent summary: this session's
178
- and the job's cost, the resume/report commands, and one usage-driven, suppressible
179
- tip (the channel that surfaces features as they become relevant). Also the home for
180
- **authoring-cost visibility** — workflow authoring is already a metered session;
181
- surface it in listings/export instead of hiding it, keeping the work/authoring split.
182
- - **Ambient capability card** — an optional, off-by-default context injection so the
183
- client itself answers "how do I …" gmlw questions mid-session. Kept minimal and
184
- counted against the context budget.
185
- - **Greeting → context** — retire the launch-time host greeting (structurally invisible:
186
- the client clears the screen) and inject it as a context instruction the client
187
- renders in-band, with live metadata (time, name, recent activity).
188
- - **`workflow edit`** — update an existing workflow, not only create.
189
- - **Robustness** — clean interrupt/exit: catch Ctrl+C / an interrupt so leaving a client
190
- session ends cleanly instead of surfacing the child's raw error.
157
+ revealing depth *gradually*. Because the wrapper cedes the screen to the client, discovery
158
+ lives in the thin surfaces **around** a run — bare-command indexes, the return, and ambient
159
+ context pushed *into* the client — never a persistent UI over a live session.
160
+
161
+ - **App-wide localisation** (`0fe8c0a`) — the init-only JSON catalogue now spans the whole
162
+ app: every user-facing message **and every diagnostic log line** renders through a
163
+ process-global active localiser (`i18n.set_active`/`active`/`t`), English-fallback then
164
+ raw-key safe. A catalogue-drift guard keeps EN/FR key sets identical. Localising the logs
165
+ too was a deliberate choice, not the usual English-only-logs convention.
166
+ - **Config registry** (`9fe05b6`) — a `pydantic-settings` model is the typed source of
167
+ truth for every settable scalar key (type, default, allowed values, description);
168
+ `registry_rows()`/`coerce()`/`load()` drive help, `config`, and validation. `config.py`
169
+ sources its defaults from it (no duplicated literals) while keeping its tolerant reads.
170
+ *Scope:* scalar keys only — the structural matrices (`[[hooks]]`, `[[interceptors]]`,
171
+ `[startup.*.context]`, `[compress.prompts]`) stay hand-rolled, a deferred follow-up.
172
+ - **`config` commands** (`0db3ca7`) — `config list / get / set`, rendering + validating
173
+ against the registry; `set` merges through the shared tomlkit writer (comments preserved,
174
+ never rewritten) and surfaces the old→new change. The home for changing `default_role` /
175
+ `default_environment` after init.
176
+ - **Bare `gmlw` + `gmlw help`** (`61bb15f`) — bare `gmlw` is first-run-aware: fresh install
177
+ → init; thereafter → a grouped capability index (*launch / inspect / author*) with a
178
+ next-action footer. `gmlw help <topic>` explains the core concepts (job-vs-workflow,
179
+ start-vs-run, personas, cost). `--help` keeps the argparse view.
180
+ - **Greeting → context** (`85a77da`) — the launch-time host greeting (structurally
181
+ invisible once the client clears the screen) is retired from stderr and injected into a
182
+ new session's context, so the client renders it in-band. `_farewell` (exit) stays.
183
+ - **Exit receipt + ambient card** (`f36fcd8`) — on the return, a persistent receipt: this
184
+ session's and the job's cost, the resume/report commands, and one usage-driven,
185
+ suppressible tip (shown once each; `[hints] show` to disable). `StartJob` returns a
186
+ `StartJobResult` so the receipt can name the session. The off-by-default ambient
187
+ capability card (`[ambient] capability_card`) injects a "how do I …" gmlw card into the
188
+ context. **Authoring-cost visibility deferred** — the authoring bucket is deliberately
189
+ kept out of `gmlw jobs`; surfacing its spend cleanly is its own design.
190
+ - **`workflow edit`** (`0445c6d`) — amend an existing workflow in an authoring session
191
+ (opens its folder, never creates/overwrites; unknown name → clean error).
192
+ - **Already shipped earlier, verified here:** **`--version`** (surfaces the running version)
193
+ and **robustness** (clean Ctrl+C / SIGTERM interrupt-exit) were already present; their few
194
+ strings were folded into the app-wide localisation pass.
195
+
196
+ ## Planned
191
197
 
192
198
  ### 0.6.0 — the workflow, first-class
193
199
  Two ways people relate to a workflow: *applied to a job* (a ticket it treats), or *the
@@ -213,14 +219,68 @@ model of their own process.
213
219
  against railroading a novice and a **consent gate** on anything personal. Authoring
214
220
  keeps distilled state (a draft plus the parking lot) as files in the workflow folder,
215
221
  so it survives context compaction.
216
- - **Per-workflow persona, composed as voice over method** — a workflow can carry its own
217
- persona instead of the single global tone. Persona is **manner**; the authoring
218
- behavior above is **method**. They compose by layer: the method lives in the mode
219
- floor (guaranteed, persona-independent), and the persona colors delivery on top — it
220
- can voice the invariants but not break them. Personas carry an **authoring-friendliness**
221
- expectation, so a voice built around brutal efficiency can't sabotage the facilitation.
222
222
 
223
- ### 0.7.0 — personas, proven (and multilingual)
223
+ #### Statusline — render the data Claude Code already hands us
224
+ A separate, self-contained thread riding in this release: the status payload gmlw
225
+ receives already carries more than it displays, and two of those fields are parsed out
226
+ and dropped. No new plumbing — the data arrives at the status parser today; the fix is to
227
+ keep it and render it. Claude-first (the cursor parser shares the context shape and
228
+ benefits where the fields overlap); codex and vibe pipe no status payload, so this
229
+ degrades honestly rather than fabricating a denominator.
230
+
231
+ - **Show the denominator** — today gmlw renders a bare `78%` against an *unstated*
232
+ window size. The payload also carries `context_window_size` (200k default, 1M for
233
+ extended-context models), so render `155.6k/200k (78%)` instead. This is what makes the
234
+ percentage falsifiable: a Max user who sees `/200k` knows the window is being
235
+ under-reported (the metering relay looks like a gateway, so Claude Code can't verify 1M
236
+ support and budgets 200k) and can act on it themselves. Extend the client status with
237
+ `context_window_size` and `context_tokens`.
238
+ - **Quota: time-to-reset, not just percentage** — `5h 90%` is unactionable without
239
+ knowing whether reset is in 10 minutes or 4 hours. The payload carries `resets_at`
240
+ (epoch seconds) per window; render it as a relative duration — `5h 90% (↻12m) · wk 40%
241
+ (↻3d)`. Each window may be independently absent (subscriber-only, appears after the
242
+ first response), so tolerate a missing reset per field exactly as the percentage
243
+ already is. The single most decision-relevant pair a metering wrapper can show.
244
+ - **Baseline & drift (candidate)** — a session that opens at 26% full looks identical to
245
+ one at 5% until it's too late. A pre-launch / first-turn line surfacing the baseline
246
+ cost (tools · mcp · skills), and a note when the baseline drifts upward across a client
247
+ auto-update. Softer than the two above; carried as a candidate, not a commitment.
248
+
249
+ ### 0.7.0 — TUI refactoring: the terminal UX as one system
250
+ The discoverability surfaces landed piecemeal across 0.4.0–0.6.0 — the first-run chooser, the
251
+ bare-`gmlw` index, `help` topics, `config list`, the exit receipt, the ambient card, the
252
+ pre-launch workflow chooser. Each was built when its feature needed it. This release stops
253
+ adding surfaces and makes the ones that exist read as **one system**: a consistency and
254
+ quality pass over the terminal UX, from the design deliverable in `generic-ml-wrapper-030-ui-concepts.md`.
255
+
256
+ **Not a TUI app.** The curses/full-screen "Hub" (that doc's Concept 3) stays **dropped** — it
257
+ carries the only real dependency bill, and a persistent full-screen surface pulls against
258
+ [[wrapper-not-standalone]]. "TUI refactoring" here means refactoring the *text* UX gmlw already
259
+ owns, not adopting a widget toolkit. gmlw's UI lives only on the five legal surfaces and never
260
+ as a persistent UI over a live session.
261
+
262
+ - **The five surfaces, made consistent** — utility commands (S1), pre-launch (S2), the handoff
263
+ (S3), ambient in-client greeting/statusline (S4), and **the return** (S5). Audit each for the
264
+ house rules the codebase already implies: chrome to stderr so stdout stays clean for `--json`,
265
+ non-TTY degrades to silent/scriptable, and anything shown at the handoff (S3, instantly wiped)
266
+ is duplicated at S4/S5 so nothing is lost.
267
+ - **Next-action footers everywhere** — the core mechanic of the enriched CLI: every
268
+ run-and-return command ends with 1–2 contextual next commands, so discovery rides on commands
269
+ the user already runs. Make it uniform across *all* listings/inspections, not just the ones
270
+ that happen to have it.
271
+ - **The chooser teaches the fast path** — the pre-launch chooser always echoes the equivalent
272
+ one-liner before handoff, and `?` at any prompt prints the relevant `help` topic inline then
273
+ re-prompts, so interactive use graduates the user out of the chooser. Full argv still means
274
+ zero interaction, always.
275
+ - **Receipt / card parity** — the exit receipt (S5) and the ambient capability card (S4) must
276
+ describe the same command surface in the same vocabulary, so "what can gmlw do" gets the same
277
+ answer whether asked mid-session or read on the return. One suppressible, usage-driven tip per
278
+ return, rotated, never off-TTY.
279
+ - **A visual-consistency pass** — shared alignment, colour/emphasis conventions, and the
280
+ status-of vs manual split (statusline = ambient *state*; card = ambient *manual*) applied
281
+ uniformly, so the surfaces look like one product rather than several sittings.
282
+
283
+ ### 0.8.0 — personas, proven (and multilingual)
224
284
  Today "personas shape tone" is an **untested claim**. A persona ships a tone block, but
225
285
  nothing demonstrates that `mentor` and `terse` actually answer differently — and the tone
226
286
  block is injected *on top of* each client's own system prompt, which may simply swamp it.
@@ -243,6 +303,15 @@ is an evaluation loop, not a feature.
243
303
  block, re-run, watch the matrix separate. The honest possible outcome is that personas must
244
304
  become **bolder** to survive a client's own voice — or that they differentiate on some
245
305
  clients and not others. That finding is a deliverable, not a failure.
306
+ - **Per-workflow persona, composed as voice over method** — a workflow can carry its own
307
+ persona instead of the single global tone. Persona is **manner**; the facilitative +
308
+ constructive authoring behavior (0.6.0) is **method**. They compose by layer: the method
309
+ lives in the mode floor (guaranteed, persona-independent), and the persona colors delivery
310
+ on top — it can voice the invariants but not break them. Personas carry an
311
+ **authoring-friendliness** expectation, so a voice built around brutal efficiency can't
312
+ sabotage the facilitation. *Landed here, after the harness proves the personas actually
313
+ differ* — layering per-workflow persona on top of personas that collapse would build on
314
+ sand, so composition follows the proof rather than preceding it.
246
315
  - **Persona content becomes multilingual** — required for previews in French, and a real gap
247
316
  today: only the *prompt header* is localised, so a French user gets an English description
248
317
  and an **English greeting at every launch**. This is not a strings port: French carries a
@@ -261,10 +330,11 @@ is an evaluation loop, not a feature.
261
330
  the full side-by-side behind `gmlw persona preview`. Samples are labelled as indicative:
262
331
  they come from one model at authoring time, and the user's client may differ.
263
332
 
264
- **Sequencing risk, stated plainly:** 0.6.0 layers *per-workflow persona* on top of personas
265
- whose distinctness this release is what proves. If the matrix shows they collapse, 0.6.0's
266
- persona composition needs revisiting — so pull this earlier if that work starts leaning hard
267
- on the foundation.
333
+ **Sequencing, resolved:** *per-workflow persona* used to sit in 0.6.0, ahead of the release
334
+ that proves personas are distinct at all — building composition on an unproven foundation. It
335
+ now lives here in 0.8.0, after the harness and the tuning, so the composition follows the
336
+ proof. If the matrix shows personas collapse even after tuning, per-workflow persona is
337
+ reconsidered in place rather than shipped on sand.
268
338
 
269
339
  ## Parked
270
340
 
@@ -1,6 +1,6 @@
1
1
  # Security Policy
2
2
 
3
- `generic-ml-wrapper` is early software (`0.4.0`). It is published
3
+ `generic-ml-wrapper` is early software (`0.5.0`). It is published
4
4
  openly and takes security seriously regardless of maturity. Thank you for helping keep it
5
5
  and its users safe.
6
6
 
@@ -0,0 +1 @@
1
+ 0.6.0
@@ -11,15 +11,19 @@ and flag. For deeper behaviour, follow the cross-links to [CONFIGURATION.md](CON
11
11
  gmlw init # forced first-run setup (auto-runs when needed)
12
12
  gmlw <job> # shorthand for: gmlw start <job>
13
13
  gmlw start [job] [--client X] [--resume-latest] [--workflow|-w NAME]
14
+ gmlw run [workflow] [--client X] # run a workflow directly (job named after it)
14
15
  gmlw jobs [--json]
15
16
  gmlw sessions <job> [--json]
16
17
  gmlw export <job> [--json]
17
18
  gmlw statusline # called by the client, not by hand
18
- gmlw workflow new <name> [--client X]
19
+ gmlw workflow new [name] [--client X] [--guided|--quick] # name optional; asks depth if unset
19
20
  gmlw workflow list [--json]
20
21
  gmlw persona list [--json]
21
22
  gmlw plugins list [--json]
22
23
  gmlw creds set <workflow> <ENV_VAR_NAME>
24
+ gmlw config list [--json]
25
+ gmlw config get <key> [--json]
26
+ gmlw config set <key> <value>
23
27
  ```
24
28
 
25
29
  `--json` is accepted by the read commands only: `jobs`, `sessions`, `export`,
@@ -110,6 +114,35 @@ Example:
110
114
  gmlw start billing-api --client claude -w tidy-review --resume-latest
111
115
  ```
112
116
 
117
+ ## run
118
+
119
+ Run a workflow directly. The job is named after the workflow and its sessions accumulate
120
+ there, so `run` is the counterpart to `start` for a *recurring procedure* — where `start`
121
+ enters a job you return to, `run` launches a repeatable workflow. It is equivalent to
122
+ `gmlw start <workflow> -w <workflow>`.
123
+
124
+ ```
125
+ gmlw run [workflow] [--client CLIENT]
126
+ ```
127
+
128
+ - `workflow` (optional positional) — the workflow to run. With no workflow given, `run`
129
+ offers a chooser at an interactive terminal and, once you pick, echoes the equivalent
130
+ one-liner (`gmlw run <workflow>`) so the interactive path teaches the fast one. Off a
131
+ terminal (piped/scripted), or when you decline, it prints a guide and exits 2 rather
132
+ than blocking. Full argv (`gmlw run <workflow>`) never prompts. With no workflows
133
+ authored yet, it points you at `gmlw workflow new <name>`.
134
+ - `--client CLIENT` — which client to wrap (`claude`, `cursor`, `codex`, `vibe`).
135
+ Defaults to the configured default client, or `claude`. See [CLIENTS.md](CLIENTS.md).
136
+
137
+ Like `start`, `run` preflights the working directory and the client before launching, and
138
+ reports an unknown workflow cleanly. See [WORKFLOWS.md](WORKFLOWS.md).
139
+
140
+ Example:
141
+
142
+ ```
143
+ gmlw run nightly-etl
144
+ ```
145
+
113
146
  ## jobs
114
147
 
115
148
  List the jobs with recorded activity. Authoring sessions (`workflow new`) are hidden.
@@ -179,23 +212,67 @@ status line is installed and parsed.
179
212
  Author and list workflows. Invoked with no action, prints its own help.
180
213
 
181
214
  ```
182
- gmlw workflow new <name> [--client CLIENT]
215
+ gmlw workflow new [name] [--client CLIENT] [--guided | --quick]
216
+ gmlw workflow edit <name> [--client CLIENT] [--guided | --quick]
183
217
  gmlw workflow list [--json]
184
218
  ```
185
219
 
186
220
  ### workflow new
187
221
 
188
222
  Author a new workflow by running the shipped `create-workflow` meta-workflow as a
189
- metered authoring session (no job — it is hidden from `gmlw jobs`).
223
+ metered authoring session (no job — it is hidden from `gmlw jobs`; sessions accumulate
224
+ under `create-workflow`).
225
+
226
+ The workflow's name is decided at the **end** of the interview, not the start — forcing a
227
+ name up front presumes you already know the shape. So authoring happens in a private draft
228
+ folder under `~/.gmlw/drafts/`, and when the session marks the workflow finished, gmlw
229
+ deploys the draft into `~/.gmlw/workflows/<name>/` (an atomic move). A half-authored
230
+ workflow never appears in `workflow list` or `run`.
231
+
232
+ - `name` (positional, **optional**) — a suggested name. Omit it and the authoring session
233
+ proposes one at convergence. When given, it is only a seed (the session may rename it),
234
+ but it lets a known name **fail fast** on a collision before any work is done.
235
+ - `--client CLIENT` — which client to wrap; defaults to the configured default, or
236
+ `claude`.
237
+ - `--guided` / `--quick` — the authoring depth. **Guided** adds a facilitative
238
+ consultant layer (a parking lot for tangents, diverge→converge, process-leveling,
239
+ proposing the stages you left out) and keeps distilled state on disk so a long session
240
+ survives compaction — richer, and it costs a bit more. **Quick** is the lean interview.
241
+ With neither flag, an interactive run **asks** (Enter takes guided); a non-interactive
242
+ run defaults to quick. Passing a flag skips the prompt.
243
+
244
+ On the return, gmlw reports how the draft resolved:
245
+
246
+ - **deployed** — the workflow was named, finished, and moved into place; run it with
247
+ `gmlw run <name>`.
248
+ - **name already taken** — the draft is kept under `~/.gmlw/drafts/`; change the existing
249
+ workflow with `gmlw workflow edit <name>` instead.
250
+ - **not finished** — the session left no finished marker; the draft is kept so nothing is
251
+ lost.
252
+
253
+ Example:
254
+
255
+ ```
256
+ gmlw workflow new # interview, name it at the end, gmlw deploys it
257
+ gmlw workflow new tidy-review # same, but seed the name (fails fast if it exists)
258
+ ```
190
259
 
191
- - `name` (positional, required) — the new workflow's name.
260
+ ### workflow edit
261
+
262
+ Open an existing workflow for changes in a metered authoring session (no job). Unlike
263
+ `new`, it never creates or overwrites — it opens the workflow's existing folder and amends
264
+ its `workflow.md`. An unknown workflow exits non-zero with guidance.
265
+
266
+ - `name` (positional, required) — the workflow to edit.
192
267
  - `--client CLIENT` — which client to wrap; defaults to the configured default, or
193
268
  `claude`.
269
+ - `--guided` / `--quick` — the authoring depth, exactly as for `workflow new` (an
270
+ interactive run asks when neither is given).
194
271
 
195
272
  Example:
196
273
 
197
274
  ```
198
- gmlw workflow new tidy-review
275
+ gmlw workflow edit tidy-review
199
276
  ```
200
277
 
201
278
  ### workflow list
@@ -276,6 +353,68 @@ gmlw creds set deploy-bot DEPLOY_TOKEN
276
353
 
277
354
  ---
278
355
 
356
+ ## config
357
+
358
+ View and change the settable `~/.gmlw/config.toml` settings. Every key is backed by a
359
+ typed registry (its type, default, allowed values, and description); `set` validates
360
+ against it and merges the change into your file, preserving comments and formatting.
361
+ Invoked with no action, prints its own help.
362
+
363
+ ```
364
+ gmlw config list [--json]
365
+ gmlw config get <key> [--json]
366
+ gmlw config set <key> <value>
367
+ ```
368
+
369
+ ### config list
370
+
371
+ List every setting with its current value and description.
372
+
373
+ ### config get
374
+
375
+ Show one setting — its value, description, default, and any allowed values.
376
+
377
+ - `key` (positional, required) — the dotted setting key (e.g. `profile.default_role`).
378
+
379
+ ### config set
380
+
381
+ Change one setting. The value is validated against the registry (type and allowed
382
+ values) before anything is written; the change is echoed (old → new), never silent. Use
383
+ `none` to clear an optional key back to its default.
384
+
385
+ - `key` (positional, required) — the dotted setting key.
386
+ - `value` (positional, required) — the new value.
387
+
388
+ Example:
389
+
390
+ ```
391
+ gmlw config set profile.default_role reviewer
392
+ gmlw config set logging.level debug
393
+ gmlw config get client.default
394
+ ```
395
+
396
+ The home for changing `default_role` / `default_environment` after `init`.
397
+
398
+ ---
399
+
400
+ ## help
401
+
402
+ Explain a core concept. `gmlw help` lists the topics; `gmlw help <topic>` prints one.
403
+
404
+ ```
405
+ gmlw help
406
+ gmlw help <topic>
407
+ ```
408
+
409
+ - `topic` (positional, optional) — one of `job-vs-workflow`, `start-vs-run`, `personas`,
410
+ `cost`. Omit to list the topics. An unknown topic exits non-zero with guidance.
411
+
412
+ Bare `gmlw` (no arguments) is first-run-aware: on a fresh install it runs `init`;
413
+ thereafter it prints a grouped capability index (**launch / inspect / author**) with a
414
+ next-action footer. The flat argparse view is still available via `gmlw --help`.
415
+
416
+ ---
417
+
279
418
  ## See also
280
419
 
281
420
  - [USER_GUIDE.md](USER_GUIDE.md) — task-oriented walkthrough.
@@ -12,11 +12,25 @@ If you have never authored one, you can ignore this file entirely and use
12
12
 
13
13
  ## Creating one
14
14
 
15
- gmlw workflow new <name>
15
+ gmlw workflow new # name it at the end
16
+ gmlw workflow new <name> # or seed a name up front (optional)
16
17
 
17
18
  This runs the shipped `create-workflow` meta-workflow as a metered **authoring**
18
- session (kind `authoring`, so it stays hidden from `gmlw jobs`). It is a warm,
19
- one-question-at-a-time interview, not a form. It:
19
+ session (kind `authoring`, so it stays hidden from `gmlw jobs`; sessions accumulate
20
+ under `create-workflow`). The name is decided at the **end** of the interview, not the
21
+ start — a name given up front is only a seed you can change (though it lets a known name
22
+ fail fast if it is already taken). It is a warm, one-question-at-a-time interview, not a
23
+ form.
24
+
25
+ **Guided or quick.** Creating a workflow well is the part that pays off — a well-shaped
26
+ one makes every future run smoother — so at the start you choose the depth: **guided**
27
+ adds a facilitative consultant (a parking lot for tangents, a diverge→converge rhythm,
28
+ process-leveling on "is this a step or its own workflow?", and proposing the stages you
29
+ left out), keeping a `draft.md` and `parking-lot.md` on disk so a long session survives
30
+ compaction — richer, and a bit costlier. **quick** is the lean interview. An interactive
31
+ run asks (Enter takes guided); `--guided` / `--quick` answer up front, and a
32
+ non-interactive run defaults to quick. The steps below are the quick core; guided layers
33
+ on top of them. It:
20
34
 
21
35
  1. **Interviews you** about a task you do repeatedly — what it's for, how you do it
22
36
  today start to finish, what "done" looks like, and what you always check. It keeps
@@ -32,8 +46,11 @@ one-question-at-a-time interview, not a form. It:
32
46
  approve each one; a scripted step then becomes "run `scripts/<name>`" instead of
33
47
  re-reasoning it every run — faster, cheaper, reliable. Judgment steps stay with
34
48
  the model.
35
- 4. **Writes `workflow.md`** into the new workflow's folder and tells you how to run
36
- it.
49
+ 4. **Names it and writes `workflow.md`** into a private draft folder
50
+ (`~/.gmlw/drafts/`), then proposes the workflow's name and marks it finished. gmlw
51
+ deploys the finished draft into `~/.gmlw/workflows/<name>/` (an atomic move) and tells
52
+ you how to run it. A half-authored workflow never appears in `workflow list` or `run`;
53
+ if the name is taken, the draft is kept and you are pointed at `gmlw workflow edit`.
37
54
 
38
55
  You can pass `--client X` to author under a specific client. See [CLI.md](CLI.md) for
39
56
  the full command surface.