generic-ml-wrapper 0.2.0__tar.gz → 0.3.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 (256) hide show
  1. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.gitignore +3 -0
  2. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/CHANGELOG.md +31 -1
  3. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/PKG-INFO +1 -1
  4. generic_ml_wrapper-0.3.0/ROADMAP.md +173 -0
  5. generic_ml_wrapper-0.3.0/VERSION +1 -0
  6. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/CLIENTS.md +0 -2
  7. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/CONFIGURATION.md +47 -5
  8. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/DESIGN.md +19 -3
  9. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/TROUBLESHOOTING.md +9 -0
  10. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/USER_GUIDE.md +3 -2
  11. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/WORKFLOWS.md +6 -7
  12. generic_ml_wrapper-0.3.0/hatch_build.py +53 -0
  13. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/pyproject.toml +8 -1
  14. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/__init__.py +1 -1
  15. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/inbound/cli/app.py +132 -18
  16. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_seeder.py +17 -1
  17. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/claude_cli_caller.py +1 -1
  18. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/cursor_cli_caller.py +1 -1
  19. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/status_line_config.py +21 -0
  20. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/adapter/outbound/hook/__init__.py +3 -0
  21. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/adapter/outbound/hook/session_logger.py +61 -0
  22. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/plugin/filesystem_plugin_source.py +17 -4
  23. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/workflow/filesystem_workflow_source.py +16 -8
  24. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/domain/model/rules.py +94 -0
  25. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/domain/service/hook.py +75 -0
  26. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/domain/service/hook_runner.py +49 -0
  27. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/port/outbound/hook.py +25 -0
  28. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/plugin_source.py +19 -0
  29. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/usecase/launch.py +70 -0
  30. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/new_workflow.py +6 -5
  31. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/start_job.py +7 -6
  32. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/wiring/composition.py +27 -0
  33. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/common/config.py +40 -1
  34. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/resources/workflows/_common/base.md +25 -0
  35. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_authoring_separation.py +2 -0
  36. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_callers.py +3 -0
  37. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_config.py +27 -1
  38. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_docs_consistency.py +14 -0
  39. generic_ml_wrapper-0.3.0/tests/test_exit_handling.py +118 -0
  40. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_filesystem_plugin_source.py +19 -0
  41. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_filesystem_workflow_source.py +40 -5
  42. generic_ml_wrapper-0.3.0/tests/test_hook_runner.py +76 -0
  43. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_list_plugins_usecase.py +3 -0
  44. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_new_workflow_usecase.py +4 -1
  45. generic_ml_wrapper-0.3.0/tests/test_session_logger.py +64 -0
  46. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_start_job_usecase.py +38 -0
  47. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_status_line_config.py +16 -0
  48. generic_ml_wrapper-0.3.0/tests/test_version.py +24 -0
  49. generic_ml_wrapper-0.2.0/ROADMAP.md +0 -86
  50. generic_ml_wrapper-0.2.0/VERSION +0 -1
  51. generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/application/domain/model/rules.py +0 -43
  52. generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/resources/workflows/_common/base.md +0 -52
  53. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.coveragerc +0 -0
  54. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.gitattributes +0 -0
  55. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.github/workflows/ci.yml +0 -0
  56. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.github/workflows/pr-hygiene.yml +0 -0
  57. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.github/workflows/release.yml +0 -0
  58. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.github/workflows/sonar.yml +0 -0
  59. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.importlinter +0 -0
  60. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/.pre-commit-config.yaml +0 -0
  61. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/AGENTS.md +0 -0
  62. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/CODE_OF_CONDUCT.md +0 -0
  63. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/CONTRIBUTING.md +0 -0
  64. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/GOVERNANCE.md +0 -0
  65. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/LICENSE +0 -0
  66. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/NOTICE +0 -0
  67. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/README.md +0 -0
  68. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/RELEASE.md +0 -0
  69. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/SECURITY.md +0 -0
  70. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/CLI.md +0 -0
  71. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/images/gmlw-favicon.svg +0 -0
  72. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/images/gmlw-lockup-dark.svg +0 -0
  73. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/images/gmlw-lockup.svg +0 -0
  74. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/images/gmlw-statusline.gif +0 -0
  75. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/images/gmlw-usage.gif +0 -0
  76. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/tapes/README.md +0 -0
  77. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/tapes/render.sh +0 -0
  78. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/tapes/seed.py +0 -0
  79. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/tapes/statusline.tape +0 -0
  80. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/docs/tapes/usage.tape +0 -0
  81. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/noxfile.py +0 -0
  82. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/pyrightconfig.json +0 -0
  83. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/sonar-project.properties +0 -0
  84. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/__init__.py +0 -0
  85. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/inbound/__init__.py +0 -0
  86. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/inbound/cli/__init__.py +0 -0
  87. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/inbound/cli/banner.py +0 -0
  88. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/__init__.py +0 -0
  89. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/__init__.py +0 -0
  90. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/path_client_detector.py +0 -0
  91. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_client_chooser.py +0 -0
  92. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_persona_chooser.py +0 -0
  93. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/__init__.py +0 -0
  94. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/codex_cli_caller.py +0 -0
  95. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_file.py +0 -0
  96. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_opening.py +0 -0
  97. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/default_provider.py +0 -0
  98. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/loader.py +0 -0
  99. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_cli_caller.py +0 -0
  100. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_config.py +0 -0
  101. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/compress/__init__.py +0 -0
  102. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/compress/cache_backed_compressor.py +0 -0
  103. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/credentials/__init__.py +0 -0
  104. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/credentials/filesystem_credentials_store.py +0 -0
  105. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/gateway/__init__.py +0 -0
  106. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/gateway/anthropic_sse.py +0 -0
  107. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_chat.py +0 -0
  108. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_responses.py +0 -0
  109. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/gateway/relay.py +0 -0
  110. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/__init__.py +0 -0
  111. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/size_logger.py +0 -0
  112. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/persona/__init__.py +0 -0
  113. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/persona/filesystem_persona_source.py +0 -0
  114. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/plugin/__init__.py +0 -0
  115. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/status/__init__.py +0 -0
  116. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/status/claude_status_parser.py +0 -0
  117. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/status/cursor_status_parser.py +0 -0
  118. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/store/__init__.py +0 -0
  119. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/store/filesystem_transcript_store.py +0 -0
  120. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/store/ledger.py +0 -0
  121. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_per_turn_store.py +0 -0
  122. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_session_store.py +0 -0
  123. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_usage_store.py +0 -0
  124. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/workflow/__init__.py +0 -0
  125. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/workspace/__init__.py +0 -0
  126. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/adapter/outbound/workspace/local_workspace_inspector.py +0 -0
  127. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/__init__.py +0 -0
  128. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/__init__.py +0 -0
  129. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/__init__.py +0 -0
  130. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/client_catalog.py +0 -0
  131. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/client_status.py +0 -0
  132. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/context_source.py +0 -0
  133. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/identifiers.py +0 -0
  134. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/learned.py +0 -0
  135. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/persona.py +0 -0
  136. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/plugin.py +0 -0
  137. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/run.py +0 -0
  138. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/session.py +0 -0
  139. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/turn_usage.py +0 -0
  140. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/model/workspace.py +0 -0
  141. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/service/__init__.py +0 -0
  142. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/service/greeting.py +0 -0
  143. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/service/interceptor.py +0 -0
  144. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/service/interceptor_chain.py +0 -0
  145. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/service/persona_parser.py +0 -0
  146. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/service/rule_cleaner.py +0 -0
  147. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/service/session_naming.py +0 -0
  148. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/domain/service/statusline_renderer.py +0 -0
  149. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/__init__.py +0 -0
  150. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/__init__.py +0 -0
  151. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/bootstrap.py +0 -0
  152. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/check_client_ready.py +0 -0
  153. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/export_usage.py +0 -0
  154. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/first_run_init.py +0 -0
  155. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/list_jobs.py +0 -0
  156. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/list_personas.py +0 -0
  157. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/list_plugins.py +0 -0
  158. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/list_sessions.py +0 -0
  159. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/list_workflows.py +0 -0
  160. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/new_workflow.py +0 -0
  161. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/render_greeting.py +0 -0
  162. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/render_statusline.py +0 -0
  163. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/set_credential.py +0 -0
  164. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/inbound/start_job.py +0 -0
  165. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/__init__.py +0 -0
  166. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/cli_caller.py +0 -0
  167. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/client_chooser.py +0 -0
  168. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/client_detector.py +0 -0
  169. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/client_status.py +0 -0
  170. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/context_compressor.py +0 -0
  171. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/credentials_store.py +0 -0
  172. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/interceptor.py +0 -0
  173. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/layout_seeder.py +0 -0
  174. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/per_turn_metering.py +0 -0
  175. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/persona_chooser.py +0 -0
  176. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/persona_source.py +0 -0
  177. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/session_store.py +0 -0
  178. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/transcript.py +0 -0
  179. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/usage_store.py +0 -0
  180. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/workflow_source.py +0 -0
  181. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/port/outbound/workspace.py +0 -0
  182. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/__init__.py +0 -0
  183. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/bootstrap.py +0 -0
  184. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/check_client_ready.py +0 -0
  185. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/export_usage.py +0 -0
  186. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/first_run_init.py +0 -0
  187. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/list_jobs.py +0 -0
  188. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/list_personas.py +0 -0
  189. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/list_plugins.py +0 -0
  190. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/list_sessions.py +0 -0
  191. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/list_workflows.py +0 -0
  192. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/render_greeting.py +0 -0
  193. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/render_statusline.py +0 -0
  194. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/usecase/set_credential.py +0 -0
  195. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/application/wiring/__init__.py +0 -0
  196. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/common/__init__.py +0 -0
  197. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/common/log.py +0 -0
  198. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/common/paths.py +0 -0
  199. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/common/spec_loader.py +0 -0
  200. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/py.typed +0 -0
  201. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/resources/personas/_floor.md +0 -0
  202. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/resources/personas/butler.md +0 -0
  203. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/resources/personas/companion.md +0 -0
  204. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/resources/personas/mentor.md +0 -0
  205. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/resources/personas/plain.md +0 -0
  206. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/resources/personas/terse.md +0 -0
  207. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/src/generic_ml_wrapper/resources/workflows/create-workflow/workflow.md +0 -0
  208. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/_conformance.py +0 -0
  209. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/conftest.py +0 -0
  210. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_anthropic_sse.py +0 -0
  211. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_banner.py +0 -0
  212. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_bootstrap.py +0 -0
  213. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_cache_backed_compressor.py +0 -0
  214. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_caller_loader.py +0 -0
  215. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_check_client_ready.py +0 -0
  216. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_cli.py +0 -0
  217. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_context_file.py +0 -0
  218. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_context_source.py +0 -0
  219. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_credentials_store.py +0 -0
  220. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_cursor_status_parser.py +0 -0
  221. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_export_usage_usecase.py +0 -0
  222. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_filesystem_persona_source.py +0 -0
  223. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_filesystem_transcript_store.py +0 -0
  224. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_first_run_init.py +0 -0
  225. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_greeting.py +0 -0
  226. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_identifiers.py +0 -0
  227. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_interceptor_chain.py +0 -0
  228. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_learned.py +0 -0
  229. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_list_jobs_usecase.py +0 -0
  230. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_list_personas_usecase.py +0 -0
  231. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_list_sessions_usecase.py +0 -0
  232. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_list_workflows_usecase.py +0 -0
  233. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_local_workspace_inspector.py +0 -0
  234. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_log.py +0 -0
  235. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_model_invariants.py +0 -0
  236. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_openai_chat.py +0 -0
  237. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_openai_responses.py +0 -0
  238. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_path_client_detector.py +0 -0
  239. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_persona_parser.py +0 -0
  240. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_relay.py +0 -0
  241. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_render_greeting_usecase.py +0 -0
  242. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_rule_cleaner.py +0 -0
  243. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_session_naming.py +0 -0
  244. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_size_logger.py +0 -0
  245. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_smoke.py +0 -0
  246. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_sqlite_per_turn_store.py +0 -0
  247. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_sqlite_session_store.py +0 -0
  248. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_sqlite_usage_store.py +0 -0
  249. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_statusline.py +0 -0
  250. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_store_conformance.py +0 -0
  251. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_tty_client_chooser.py +0 -0
  252. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_tty_persona_chooser.py +0 -0
  253. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tests/test_vibe_config.py +0 -0
  254. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tools/hooks/check-commit-msg.sh +0 -0
  255. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/tools/hooks/guard-branch.sh +0 -0
  256. {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.3.0}/uv.lock +0 -0
@@ -42,3 +42,6 @@ credentials.toml
42
42
  # not be committed (it would reintroduce the very leak it checks for).
43
43
  /setup-repo.sh
44
44
  /secret-audit.sh
45
+
46
+ # Build-time generated (stamped by hatch_build.py at wheel build); never committed.
47
+ /src/generic_ml_wrapper/_build_info.py
@@ -6,6 +6,35 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.3.0] - 2026-07-18
10
+
11
+ The lifecycle release — hooks that act at the seams around a run, and rule capture that
12
+ works everywhere.
13
+
14
+ ### Added
15
+ - **Lifecycle action hooks.** gmlw already hooks *content* (the interceptor chain); it now
16
+ hooks *actions* at two seams bracketing the client run. A `[[hooks]]` entry binds a
17
+ `HookPort` spec (a `module:Class` / `/path.py:Class`, or a plugin id) to a `phase` —
18
+ `pre-launch` (after the context is compiled and the caller resolved, before the client
19
+ starts) or `post-session` (after the client exits, with its exit code) — with an optional
20
+ `client` scope, under the same trusted-code boundary as `[[interceptors]]` and `[callers]`.
21
+ Hooks are best-effort: a failing hook never breaks a launch or its teardown. Both launch
22
+ paths (`start`, `workflow new`) route through one `run_with_hooks` sequence. Ships the
23
+ built-in `SessionLogger` as a reference hook.
24
+ - **Always-on rule lifecycle.** Rule capture is no longer workflow-only: the `rules`
25
+ context source (now active by default in a plain start, config-overridable) leads with
26
+ a capture directive so a demanded correction becomes a draft rule in **any** session.
27
+ The directive carries the full loop — offer to record a durable, reusable reflex;
28
+ **dedup** against the existing rules and update/supersede a match instead of stacking a
29
+ near-duplicate; and, when a rule is **mechanically enforceable**, offer to realise it as
30
+ a script or check rather than a standing reminder.
31
+
32
+ ### Fixed
33
+ - Docs: removed a stray tool artifact from `docs/CLIENTS.md`; corrected the workflow
34
+ compression default in `docs/CONFIGURATION.md` (every source defaults to
35
+ `compression = false`); documented `[companion] name`. Added a doc-consistency guard
36
+ against leaked tool-artifact tags.
37
+
9
38
  ## [0.2.0] - 2026-07-16
10
39
 
11
40
  The companion release — everything a session inherits, and the ergonomics around it.
@@ -75,6 +104,7 @@ First public release — a metering wrapper around ML coding CLIs.
75
104
  over `src` and `tests`; `nox` gates mirrored by CI across Python 3.11–3.14; a
76
105
  server-side no-AI-attribution check and branch protection.
77
106
 
78
- [Unreleased]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.2.0...HEAD
107
+ [Unreleased]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.3.0...HEAD
108
+ [0.3.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.2.0...v0.3.0
79
109
  [0.2.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.1.0...v0.2.0
80
110
  [0.1.0]: https://github.com/danielslobozian/generic-ml-wrapper/releases/tag/v0.1.0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: generic-ml-wrapper
3
- Version: 0.2.0
3
+ Version: 0.3.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
@@ -0,0 +1,173 @@
1
+ <!-- SPDX-FileCopyrightText: 2026 Daniel Slobozian -->
2
+ <!-- SPDX-License-Identifier: Apache-2.0 -->
3
+
4
+ # Roadmap
5
+
6
+ Where `generic-ml-wrapper` has been and where it's going. Direction, not a
7
+ commitment — see [CHANGELOG.md](CHANGELOG.md) for what has actually shipped.
8
+
9
+ The through-line: turn a metering wrapper into something a person *wants* to open —
10
+ a companion that carries **who you are and how you work across every client**, and
11
+ stays a wrapper (it extends each client; it never reimplements one).
12
+
13
+ ## Shipped
14
+
15
+ ### 0.1.0
16
+ The metering foundation — jobs & sessions, four clients (claude / cursor / codex /
17
+ vibe), a per-turn metering relay into a SQLite ledger, a client-aware status line,
18
+ and the workflow system. On PyPI.
19
+
20
+ ### 0.2.0 — the companion
21
+ Everything a session inherits, and the ergonomics around it.
22
+
23
+ - **First-run init** — detect installed clients, seed a filled config with a default.
24
+ - **Config-driven, mode-aware context packaging** — a `[startup.<mode>]` matrix picks
25
+ which sources compose (persona · profile · learned · company · rules · workflow
26
+ base/steps) for each mode (default / workflow / authoring), with **typed per-source
27
+ compression** (`[compress.prompts]`).
28
+ - **Personas** — selectable tone with a universal floor; `gmlw persona list`; a free,
29
+ local **host greeting** at launch; a first-run persona choice.
30
+ - **Learned** — a portable, user-owned notebook the client mirrors into, read into
31
+ every client so what one learns they all inherit; **negatives are first-class**.
32
+ - **Rule format** — a domain-neutral `Rule / When / Signals / Strength / Origin`
33
+ (+ optional `Precedence`), with in-session capture during a workflow.
34
+ - **Formal plugins folder** — reference a caller by id (`~/.gmlw/plugins/<id>/`),
35
+ `gmlw plugins list`.
36
+ - **Cursor allowance block** — the status line renders cursor's plan pools from an
37
+ optional local cache when the client doesn't pipe them.
38
+ - **Ergonomics** — client & working-directory preflight (clear guidance instead of a
39
+ cryptic crash), implicit `gmlw <job>` (shorthand for `start`), a friendly no-job
40
+ message, and auto-help for an incomplete sub-command.
41
+ - **Create-workflow** — the interviewer assesses each step's *codeability* and offers
42
+ to script the mechanical ones, keeping the AI for the judgment steps.
43
+
44
+ ## Planned
45
+
46
+ ### 0.3.0 — lifecycle action hooks — done (Unreleased)
47
+ gmlw already hooks **content**: the interceptor chain transforms context sections at
48
+ compile time and wire traffic at relay time (e.g. anonymisation on `request`). It now
49
+ also hooks **actions** — "after this phase, run something" — at two lifecycle seams
50
+ that bracket the client run:
51
+
52
+ - **`pre-launch`** — after the context is compiled and the caller resolved, before the
53
+ client starts. Knows the client, the working directory, and the session. For
54
+ per-client setup: deploying skills/rules into a client's *native* mechanism, writing
55
+ MCP config, warming a cache.
56
+ - **`post-session`** — after the client exits. Knows the exit code and the session.
57
+ For cleanup, notification, archival, or roll-up.
58
+
59
+ Config mirrors the existing extension points — a `[[hooks]]` entry with a `phase`, a
60
+ `spec` (a plugin id or `path.py:Class`), and an optional `client` scope — under the
61
+ same trusted-code boundary as `[[interceptors]]`, `[callers]`, and plugins. Hooks are
62
+ best-effort and never break a launch. Both launch paths (`start`, `workflow new`) route
63
+ through one shared launch sequence, so the seams bracket every run. Shipped with a
64
+ built-in `SessionLogger` reference hook.
65
+
66
+ **Still open — the flagship example hook:** a **cross-client skills/rules deployer** that
67
+ consumes a git repo of skills and installs them, per client, as faithfully as each
68
+ client's format allows. It is its own initiative (per-client format knowledge), built on
69
+ the seam above; the infrastructure is done and waiting for it.
70
+
71
+ #### Rule lifecycle — done (Unreleased)
72
+ 0.2.0 shipped rule *capture*, but only inside a workflow (the directive lived in the
73
+ workflow base) and without dedup or a path to code. The rule loop is now rounded out —
74
+ the directive moved out of the workflow base to the head of the always-on `rules`
75
+ context source (verbatim, gmlw's voice), and the source is active by default in a plain
76
+ start:
77
+
78
+ - **Rule proposal in normal usage** — the "offer to record a rule" directive is
79
+ always-on, so a demanded correction becomes a draft rule wherever it happens, not only
80
+ inside a workflow.
81
+ - **Existing-rule check (dedup / update-not-duplicate)** — before proposing, the client
82
+ reads the existing rules and updates or supersedes a matching one instead of stacking a
83
+ near-duplicate, mirroring the learned notebook's supersede-on-contradiction.
84
+ - **Rule → code feasibility** — a captured rule is judged for *mechanical
85
+ enforceability* and, if so, offered as a script/check rather than a reminder — the
86
+ step-codeability logic (create-workflow) generalised from workflow steps to rules, and
87
+ a natural future `pre-launch` hook consumer.
88
+
89
+ ### 0.4.0 — discoverability & first-run: getting captivated fast
90
+ Reframed around the real metric for a new user: **time to a first live session.**
91
+ Captivation lives in the model session, not the wrapper — so the job is to remove
92
+ everything between a stranger and that first response, then reveal depth *gradually*
93
+ (progressive disclosure). Because the wrapper cedes the screen to the client, discovery
94
+ lives in the thin surfaces **around** a run — pre-launch, run-and-return commands, the
95
+ return, and ambient context pushed *into* the client — never a persistent UI over a
96
+ live session.
97
+
98
+ - **First-run onboarding** — on first launch, a greeting instead of the help menu:
99
+ *"looks like your first time — set up (about a minute), or skip? (`gmlw init`
100
+ anytime)."* Setup establishes the two things that shape every later run:
101
+ - **A working client** — the one hard requirement (no client, no session). *Fast path*
102
+ when a client is already installed and authenticated: detect it and reach a session
103
+ in seconds. *Guided path* when none is: a subscription→client mapping (*"do you pay
104
+ for Claude / ChatGPT / Cursor / Mistral?"* → the matching supported client CLI), a
105
+ link/script to install, and **guide-and-verify auth** — print the exact login
106
+ command, then poll readiness until it goes green (guide, don't drive the login).
107
+ - **A default persona** — the experience-defining choice (otherwise every launch needs
108
+ a flag). Picked from **static previews** (sample lines per persona), not a live
109
+ model quiz, so choosing costs nothing.
110
+ - **Bare `gmlw` is first-run-aware** — first time → the greeting/onboarding; thereafter →
111
+ a grouped capability index (*launch / inspect / author*), with `gmlw help <topic>` for
112
+ the core concepts (job vs workflow, start vs run, personas, cost). `--help` keeps the
113
+ argparse view; every listing ends with a next-action footer.
114
+ - **Config registry** — one typed source of truth (a `pydantic-settings` model) for
115
+ every setting: key, type, default, allowed values, description. It replaces the
116
+ hand-rolled accessors, and every surface (help, `config`, per-workflow settings)
117
+ renders from it — so the config file no longer has to be pre-populated to be found.
118
+ - **`config` commands** — `config list / get / set`, rendering the registry with inline
119
+ allowed-value validation.
120
+ - **`--version`** — surface the running version.
121
+ - **Progressive disclosure** — depth is revealed over time, not dumped up front:
122
+ - **Exit receipt** — on the return (client exit), a persistent summary: this session's
123
+ and the job's cost, the resume/report commands, and one usage-driven, suppressible
124
+ tip (the channel that surfaces features as they become relevant). Also the home for
125
+ **authoring-cost visibility** — workflow authoring is already a metered session;
126
+ surface it in listings/export instead of hiding it, keeping the work/authoring split.
127
+ - **Ambient capability card** — an optional, off-by-default context injection so the
128
+ client itself answers "how do I …" gmlw questions mid-session. Kept minimal and
129
+ counted against the context budget.
130
+ - **Greeting → context** — retire the launch-time host greeting (structurally invisible:
131
+ the client clears the screen) and inject it as a context instruction the client
132
+ renders in-band, with live metadata (time, name, recent activity).
133
+ - **`workflow edit`** — update an existing workflow, not only create.
134
+ - **Robustness** — clean interrupt/exit: catch Ctrl+C / an interrupt so leaving a client
135
+ session ends cleanly instead of surfacing the child's raw error.
136
+
137
+ ### 0.5.0 — the workflow, first-class
138
+ Two ways people relate to a workflow: *applied to a job* (a ticket it treats), or *the
139
+ recurring job itself* (a repeatable extraction). Make both first-class, and make
140
+ authoring one a guided conversation — because most people don't arrive with a clear
141
+ model of their own process.
142
+
143
+ - **`run <workflow>`** — launch a workflow directly; the job defaults to the workflow
144
+ name and sessions accumulate under it. `start <job> [--workflow]` stays for the
145
+ applied case. A trigger-gated pre-launch chooser fills only *missing* arguments and
146
+ always echoes the equivalent one-liner, so interactive use teaches the fast path
147
+ (full argv never gains a prompt).
148
+ - **Name at the end, not the start** — `workflow new` no longer demands a name up front;
149
+ forcing one presumes the user already knows the shape. The authoring conversation
150
+ shapes the workflow and *proposes* the name at convergence. (Distinct from
151
+ `run <workflow>`, where an existing, recurring workflow's name has already earned it.)
152
+ - **Facilitative + constructive authoring** — the create-workflow conversation as a
153
+ blended consultant. Two axes: *facilitate* (a **parking lot** for tangents so nothing
154
+ is lost, reflective listening, a **diverge → converge** phase model, and **process
155
+ leveling** to answer "step or its own workflow?") and *contribute* (start in inquiry
156
+ and **move to expert when warranted**, propose the upstream/downstream stages the
157
+ author omitted, surface **implications** they haven't hit) — bounded by guardrails
158
+ against railroading a novice and a **consent gate** on anything personal. Authoring
159
+ keeps distilled state (a draft plus the parking lot) as files in the workflow folder,
160
+ so it survives context compaction.
161
+ - **Per-workflow persona, composed as voice over method** — a workflow can carry its own
162
+ persona instead of the single global tone. Persona is **manner**; the authoring
163
+ behavior above is **method**. They compose by layer: the method lives in the mode
164
+ floor (guaranteed, persona-independent), and the persona colors delivery on top — it
165
+ can voice the invariants but not break them. Personas carry an **authoring-friendliness**
166
+ expectation, so a voice built around brutal efficiency can't sabotage the facilitation.
167
+
168
+ ## Parked
169
+
170
+ - **External source connectors** — let a workflow pull from external systems (APIs,
171
+ cloud storage, platforms) rather than manual input. Large; its own initiative.
172
+ - Relay extraction to a standalone project (shelved — no second consumer yet).
173
+ - Workspace layout feature.
@@ -0,0 +1 @@
1
+ 0.3.0
@@ -133,5 +133,3 @@ same throwaway-`VIBE_HOME` relay path used for metering.
133
133
  - [CLI.md](CLI.md) — every `gmlw` command.
134
134
  - [DESIGN.md](DESIGN.md) — the caller model and metering relay in depth.
135
135
  - [../SECURITY.md](../SECURITY.md) — the trust and credential boundary.
136
- </content>
137
- </invoke>
@@ -12,9 +12,9 @@ Related guides: [WORKFLOWS.md](WORKFLOWS.md), [CLIENTS.md](CLIENTS.md),
12
12
 
13
13
  ## Trusted-code boundary
14
14
 
15
- The `[callers]` and `[[interceptors]]` sections name Python code that gmlw **loads and
16
- runs with your permissions** on the next invocation — this file is a trusted-code
17
- boundary. Point them only at code you wrote or trust. A configured-but-unloadable spec
15
+ The `[callers]`, `[[interceptors]]`, and `[[hooks]]` sections name Python code that gmlw
16
+ **loads and runs with your permissions** on the next invocation — this file is a
17
+ trusted-code boundary. Point them only at code you wrote or trust. A configured-but-unloadable spec
18
18
  fails **loudly** (it does not silently degrade); an absent one is a silent no-op. See
19
19
  [SECURITY.md](../SECURITY.md).
20
20
 
@@ -93,6 +93,45 @@ target = "response"
93
93
  spec = "generic_ml_wrapper.adapter.outbound.interceptor.size_logger:MessageSizeLogger"
94
94
  ```
95
95
 
96
+ ## `[[hooks]]`
97
+
98
+ Zero or more ordered *actions* (`HookPort`) run at a lifecycle seam bracketing the
99
+ client run — where an interceptor transforms content, a hook performs a side effect and
100
+ returns nothing. Declare each as its own `[[hooks]]` array-of-tables entry.
101
+
102
+ | Key | Meaning |
103
+ | --- | --- |
104
+ | `phase` | The lifecycle seam: `pre-launch` \| `post-session` |
105
+ | `spec` | The `"module:Class"` / `"/path.py:Class"` to load, or a plugin id |
106
+ | `client` | *(optional)* scope the hook to one client; omit to run for every client |
107
+
108
+ **`pre-launch`** runs after the context is compiled and the caller resolved, before the
109
+ client starts — it knows the client, working directory, and session. For per-client setup:
110
+ deploying skills/rules into a client's native mechanism, writing MCP config, warming a
111
+ cache. **`post-session`** runs after the client exits — it knows the exit code and the
112
+ session. For cleanup, notification, archival, or roll-up.
113
+
114
+ Hooks are **best-effort**: a failing hook is logged and skipped, never breaking a launch
115
+ or its teardown. A `spec` may be a plugin id (resolved through `~/.gmlw/plugins/<id>/`,
116
+ the same as a `[callers]` reference) or a direct spec. The built-in `SessionLogger`
117
+ appends a line to `~/.gmlw/sessions.log` at each seam — a template to copy for your own.
118
+
119
+ Default: no hooks.
120
+
121
+ > **Trusted code.** Hook specs are loaded and run as you — see the
122
+ > [trusted-code boundary](#trusted-code-boundary).
123
+
124
+ ```toml
125
+ [[hooks]]
126
+ phase = "pre-launch"
127
+ spec = "generic_ml_wrapper.adapter.outbound.hook.session_logger:SessionLogger"
128
+
129
+ [[hooks]]
130
+ phase = "post-session"
131
+ spec = "generic_ml_wrapper.adapter.outbound.hook.session_logger:SessionLogger"
132
+ client = "claude" # optional; omit to run for every client
133
+ ```
134
+
96
135
  ## `[startup.<mode>]`
97
136
 
98
137
  On every run gmlw composes an operating context from a fixed set of sources.
@@ -137,12 +176,14 @@ rules = { activated = false, compression = false }
137
176
  persona = { activated = false, compression = false }
138
177
  ```
139
178
 
140
- Workflow mode ships `base` verbatim and compresses `steps`:
179
+ Every source defaults to `compression = false` — nothing is compressed unless you turn
180
+ it on *and* a prompt resolves (see [`[compress]`](#compress)). For a workflow run you
181
+ might, for example, opt to compress the longer `steps` while leaving `base` verbatim:
141
182
 
142
183
  ```toml
143
184
  [startup.workflow.context]
144
185
  base = { compression = false }
145
- steps = { compression = true }
186
+ steps = { compression = true } # opt-in; the default is false
146
187
  ```
147
188
 
148
189
  See [WORKFLOWS.md](WORKFLOWS.md) for how base and steps are compiled.
@@ -157,6 +198,7 @@ source is `activated` in the relevant `[startup.<mode>]` block above). Off — i
157
198
  | Key | Meaning | Default |
158
199
  | --- | --- | --- |
159
200
  | `persona` | Built-in persona or a custom file name | unset (invisible) |
201
+ | `name` | The name the host greeting addresses you by | unset (falls back to the OS user) |
160
202
 
161
203
  Built-in personas: `plain` \| `companion` \| `mentor` \| `butler` \| `terse`. List
162
204
  them with `gmlw persona list`. Author your own by dropping a file into
@@ -138,6 +138,7 @@ resume unsupported) records no session, so there are no ghost sessions.
138
138
  | `CredentialsStorePort` | resolve/set per-workflow credentials |
139
139
  | `ClientStatusParserPort` | parse a client's native status payload → `ClientStatus` |
140
140
  | `InterceptorPort` | transform a named target (`profile`/`rules`/`workflow`/`context` at compile time; `request`/`response` on the wire) |
141
+ | `HookPort` | run an action at a lifecycle seam bracketing the client run (`pre-launch` / `post-session`) |
141
142
  | `WorkspaceInspectorPort` | report the run's folder + git state |
142
143
  | `LayoutSeederPort` | create the runtime dirs + a default config, missing-only |
143
144
  | `ContextCompressorPort` | compress one context source through its typed prompt (via `generic-ml-cache`) |
@@ -240,6 +241,11 @@ _common/base.md → profile/* → global rules → workflow rules → workflow s
240
241
  Each stage passes through the **interceptor chain**, so a transform like context
241
242
  compression is an opt-in plug-in bound to a target, not a fork of the engine.
242
243
 
244
+ - **Rule capture (always-on):** the `rules` stage leads with a fixed capture directive
245
+ (gmlw's voice, verbatim) whenever the source is active — on by default in every mode,
246
+ including a plain start — so a demanded correction becomes a draft rule in any session,
247
+ is deduped against the existing rules, and, when mechanically enforceable, is offered as
248
+ a script rather than a reminder.
243
249
  - **Rule cleaning (always, lossless):** drop each rule's YAML frontmatter and the
244
250
  human-only `Origin` / `Notes` sections; skip rules marked `status: draft`.
245
251
  - **Compression (optional, off):** each source can be compressed through its *typed*
@@ -262,15 +268,25 @@ Seeded on first run, fully commented, every section optional:
262
268
  | `[client] default` | the client used when `--client` is absent | `claude` |
263
269
  | `[callers]` | override a client with a `module:Class` / `/path.py:Class` spec or plugin id | none |
264
270
  | `[[interceptors]]` | bind an interceptor spec to a `target` | none |
271
+ | `[[hooks]]` | bind a hook spec to a lifecycle `phase` (`pre-launch` / `post-session`), optional `client` scope | none |
265
272
  | `[startup.<mode>]` | per-mode (default / workflow / authoring) source activation + compression matrix | built-in |
266
273
  | `[companion]` | the persona gmlw adopts (host greeting + the `persona` source) | off |
267
274
  | `[compress]` | compressor adapter / model / effort + `[compress.prompts]` (typed per-source prompts) | off |
268
275
  | `[transcript]` | enable the opt-in transcript + its root | off |
269
276
  | `[logging] level` | log verbosity (also `GMLW_LOG_LEVEL`) | `warning` |
270
277
 
271
- `[callers]` and `[[interceptors]]` load and **run Python** with your permissions — a
272
- trusted-code extension point (see `SECURITY.md`). A configured-but-unloadable spec
273
- **fails loudly**; only an absent one is a silent no-op.
278
+ `[callers]`, `[[interceptors]]`, and `[[hooks]]` load and **run Python** with your
279
+ permissions — a trusted-code extension point (see `SECURITY.md`). A
280
+ configured-but-unloadable spec **fails loudly**; only an absent one is a silent no-op.
281
+
282
+ **Hooks vs interceptors.** An interceptor transforms *content* (a context section, a wire
283
+ body) and returns text; a hook performs an *action* at a lifecycle *seam* and returns
284
+ nothing. The `HookRunner` runs the hooks bound to a phase — `pre-launch` (after the context
285
+ is compiled and the caller resolved, before the client starts) or `post-session` (after the
286
+ client exits, with its exit code) — filtered by an optional `client` scope, in declared
287
+ order. Both use cases that launch a client (`start`, `workflow new`) route through the same
288
+ `run_with_hooks` sequence, so the seams bracket every run. Hooks are **best-effort**: a
289
+ failing hook is logged and skipped, never breaking a launch or its teardown.
274
290
 
275
291
  ## 12. The home — `~/.gmlw`
276
292
 
@@ -13,6 +13,15 @@ not a bug and nothing is missing from your ledger. Cursor still gets a status li
13
13
  resume support; it just never contributes a cost. See [CLIENTS.md](CLIENTS.md) for the
14
14
  per-client capability matrix.
15
15
 
16
+ ## Why does Cursor's status line vanish when I paste a file path?
17
+
18
+ Upstream Cursor behaviour, not a `gmlw` bug. `cursor-agent` treats `/` as a
19
+ slash-command trigger **even mid-input**, so a pasted file path (which contains `/`)
20
+ makes Cursor's slash UI take over the status-line row — and it stays hidden until you
21
+ delete the text containing the `/`. It is independent of what `gmlw` renders into the
22
+ status line, and the wrapper has no hook into Cursor's input mode to prevent it. Remove
23
+ the `/` (or send/clear the input) and the status line comes back.
24
+
16
25
  ## Why can't Codex or Vibe resume?
17
26
 
18
27
  Codex and Vibe don't expose a stable client-side session id, so the wrapper has nothing
@@ -98,8 +98,9 @@ $EDITOR ~/.gmlw/rules/no-force-push.rule.md # write Rule / When / Signals / St
98
98
  # edit the front matter: status: draft -> status: active
99
99
  ```
100
100
 
101
- During a workflow, when you're dissatisfied and want something to never recur, the client offers
102
- to record it as a draft rule for you. See [WORKFLOWS.md](WORKFLOWS.md).
101
+ In any session, when you're dissatisfied and want something to never recur, the client offers to
102
+ record it as a draft rule for you — updating an existing rule instead of duplicating it, and
103
+ offering to turn a mechanically enforceable one into a script. See [WORKFLOWS.md](WORKFLOWS.md).
103
104
 
104
105
  ## 8. Enable transcripts safely
105
106
 
@@ -102,13 +102,12 @@ Fields: `Rule`, `When`, `Signals`, `Strength` (`soft` | `hard`), `Origin`
102
102
  wins) added only when a rule may conflict with another.
103
103
 
104
104
  A rule with `status: draft` is **not injected** until you promote it to `active` by
105
- editing that field. Rules are captured during a workflow: when you are dissatisfied
106
- with something and want it to never happen again, the client offers to record it as a
107
- draft for your approval.
108
-
109
- > Forward note: proposing rules during normal, non-workflow usage is on the 0.3.0
110
- > roadmap — see [../ROADMAP.md](../ROADMAP.md). Today only workflow sessions offer
111
- > them.
105
+ editing that field. Rule capture is **always-on**, in any session (not only a
106
+ workflow): when you are dissatisfied with something and want it to never happen again,
107
+ the client offers to record it as a draft for your approval. Before proposing, it reads
108
+ your existing rules and updates or supersedes a match rather than stacking a
109
+ near-duplicate; and if the rule is mechanically enforceable, it offers to realise it as
110
+ a small script or check rather than a standing reminder.
112
111
 
113
112
  ## Scripts
114
113
 
@@ -0,0 +1,53 @@
1
+ # SPDX-FileCopyrightText: 2026 Daniel Slobozian
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ """Hatchling build hook: stamp a build id into the wheel.
4
+
5
+ Writes ``src/generic_ml_wrapper/_build_info.py`` (git-ignored, force-included via
6
+ ``[tool.hatch.build.targets.wheel] artifacts``) at build time so ``gmlw --version``
7
+ can report the exact build. A source checkout that was never built has no
8
+ ``_build_info`` module and reports a plain ``(source, unbuilt)`` version instead.
9
+ """
10
+
11
+ from __future__ import annotations
12
+
13
+ import subprocess
14
+ from datetime import UTC, datetime
15
+ from pathlib import Path
16
+ from typing import Any
17
+
18
+ from hatchling.builders.hooks.plugin.interface import BuildHookInterface
19
+
20
+
21
+ class BuildInfoHook(BuildHookInterface):
22
+ """Write ``_build_info.py`` with a UTC build timestamp and the short git sha."""
23
+
24
+ PLUGIN_NAME = "custom"
25
+
26
+ def initialize(self, version: str, build_data: dict[str, Any]) -> None: # noqa: ARG002
27
+ """Stamp the build-info module before the wheel's files are collected."""
28
+ root = Path(self.root)
29
+ build_id = datetime.now(UTC).strftime("%Y%m%dT%H%M%SZ")
30
+ target = root / "src" / "generic_ml_wrapper" / "_build_info.py"
31
+ target.write_text(
32
+ "# SPDX-FileCopyrightText: 2026 Daniel Slobozian\n"
33
+ "# SPDX-License-Identifier: Apache-2.0\n"
34
+ '"""Generated at build time by hatch_build.py -- do not edit or commit."""\n\n'
35
+ f'BUILD_ID = "{build_id}"\n'
36
+ f'GIT_SHA = "{_git_sha(root)}"\n',
37
+ encoding="utf-8",
38
+ )
39
+
40
+
41
+ def _git_sha(root: Path) -> str:
42
+ """Return the short git sha, or ``"unknown"`` outside a git checkout."""
43
+ try:
44
+ completed = subprocess.run(
45
+ ["git", "rev-parse", "--short", "HEAD"], # noqa: S607
46
+ cwd=root,
47
+ capture_output=True,
48
+ text=True,
49
+ check=True,
50
+ )
51
+ except (OSError, subprocess.SubprocessError):
52
+ return "unknown"
53
+ return completed.stdout.strip() or "unknown"
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "generic-ml-wrapper"
7
- version = "0.2.0"
7
+ version = "0.3.0"
8
8
  description = "A wrapper around an ML coding CLI: enter at a job, get a named resumable session, optionally driven by a workflow."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
@@ -67,6 +67,13 @@ gmlw = "generic_ml_wrapper.adapter.inbound.cli.app:main"
67
67
 
68
68
  [tool.hatch.build.targets.wheel]
69
69
  packages = ["src/generic_ml_wrapper"]
70
+ # _build_info.py is generated (and git-ignored) by the build hook below; force-include
71
+ # it so the stamped build id ships in the wheel.
72
+ artifacts = ["src/generic_ml_wrapper/_build_info.py"]
73
+
74
+ [tool.hatch.build.targets.wheel.hooks.custom]
75
+ # Stamps src/generic_ml_wrapper/_build_info.py with a build timestamp + git sha.
76
+ path = "hatch_build.py"
70
77
 
71
78
  [tool.pytest.ini_options]
72
79
  testpaths = ["tests"]
@@ -10,4 +10,4 @@ for the architecture the use cases will fill in.
10
10
 
11
11
  from __future__ import annotations
12
12
 
13
- __version__ = "0.2.0"
13
+ __version__ = "0.3.0"