generic-ml-wrapper 0.3.0__tar.gz → 0.4.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 (292) hide show
  1. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/CHANGELOG.md +75 -1
  2. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/PKG-INFO +2 -1
  3. generic_ml_wrapper-0.4.0/ROADMAP.md +274 -0
  4. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/SECURITY.md +1 -1
  5. generic_ml_wrapper-0.4.0/VERSION +1 -0
  6. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/CLI.md +28 -0
  7. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/CONFIGURATION.md +7 -3
  8. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/DESIGN.md +4 -2
  9. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/USER_GUIDE.md +19 -5
  10. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/WORKFLOWS.md +2 -1
  11. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/pyproject.toml +6 -1
  12. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/__init__.py +1 -1
  13. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/app.py +90 -21
  14. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_migrator.py +61 -0
  15. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_seeder.py +403 -0
  16. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/http_client_versions.py +169 -0
  17. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/subprocess_command_runner.py +33 -0
  18. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/system_clipboard.py +57 -0
  19. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_client_setup.py +246 -0
  20. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_language_chooser.py +54 -0
  21. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_persona_chooser.py +51 -0
  22. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_prompt.py +120 -0
  23. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_text_prompt.py +56 -0
  24. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workflow/filesystem_workflow_source.py +48 -8
  25. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/domain/model/client_catalog.py +224 -0
  26. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/domain/model/migration.py +33 -0
  27. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/inbound/init.py +50 -0
  28. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/inbound/migrate_layout.py +23 -0
  29. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/client_setup.py +35 -0
  30. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/client_version.py +46 -0
  31. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/clipboard.py +23 -0
  32. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/command_runner.py +22 -0
  33. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/language_chooser.py +28 -0
  34. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/layout_migrator.py +31 -0
  35. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/layout_seeder.py +85 -0
  36. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/persona_chooser.py +5 -1
  37. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/text_prompt.py +32 -0
  38. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/usecase/init.py +126 -0
  39. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/usecase/migrate_layout.py +42 -0
  40. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/wiring/composition.py +77 -9
  41. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/config.py +63 -0
  42. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/common/i18n.py +95 -0
  43. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/paths.py +3 -0
  44. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/resources/i18n/en.json +36 -0
  45. generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/resources/i18n/fr.json +36 -0
  46. generic_ml_wrapper-0.4.0/tests/test_bootstrap.py +205 -0
  47. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_check_client_ready.py +4 -1
  48. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_cli.py +169 -61
  49. generic_ml_wrapper-0.4.0/tests/test_client_catalog.py +43 -0
  50. generic_ml_wrapper-0.4.0/tests/test_client_versions.py +99 -0
  51. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_config.py +25 -0
  52. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_workflow_source.py +85 -12
  53. generic_ml_wrapper-0.4.0/tests/test_i18n.py +67 -0
  54. generic_ml_wrapper-0.4.0/tests/test_init_usecase.py +196 -0
  55. generic_ml_wrapper-0.4.0/tests/test_layout_migrator.py +84 -0
  56. generic_ml_wrapper-0.4.0/tests/test_migrate_layout_usecase.py +32 -0
  57. generic_ml_wrapper-0.4.0/tests/test_tty_client_setup.py +204 -0
  58. generic_ml_wrapper-0.4.0/tests/test_tty_language_chooser.py +60 -0
  59. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_tty_persona_chooser.py +11 -9
  60. generic_ml_wrapper-0.4.0/tests/test_tty_prompt.py +86 -0
  61. generic_ml_wrapper-0.4.0/tests/test_tty_text_prompt.py +62 -0
  62. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/uv.lock +12 -1
  63. generic_ml_wrapper-0.3.0/ROADMAP.md +0 -173
  64. generic_ml_wrapper-0.3.0/VERSION +0 -1
  65. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_seeder.py +0 -197
  66. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_client_chooser.py +0 -49
  67. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_persona_chooser.py +0 -52
  68. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/domain/model/client_catalog.py +0 -77
  69. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/port/inbound/first_run_init.py +0 -37
  70. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/port/outbound/client_chooser.py +0 -23
  71. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/port/outbound/layout_seeder.py +0 -25
  72. generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/usecase/first_run_init.py +0 -71
  73. generic_ml_wrapper-0.3.0/tests/test_bootstrap.py +0 -101
  74. generic_ml_wrapper-0.3.0/tests/test_first_run_init.py +0 -123
  75. generic_ml_wrapper-0.3.0/tests/test_tty_client_chooser.py +0 -55
  76. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.coveragerc +0 -0
  77. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.gitattributes +0 -0
  78. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.github/workflows/ci.yml +0 -0
  79. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.github/workflows/pr-hygiene.yml +0 -0
  80. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.github/workflows/release.yml +0 -0
  81. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.github/workflows/sonar.yml +0 -0
  82. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.gitignore +0 -0
  83. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.importlinter +0 -0
  84. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.pre-commit-config.yaml +0 -0
  85. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/AGENTS.md +0 -0
  86. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/CODE_OF_CONDUCT.md +0 -0
  87. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/CONTRIBUTING.md +0 -0
  88. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/GOVERNANCE.md +0 -0
  89. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/LICENSE +0 -0
  90. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/NOTICE +0 -0
  91. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/README.md +0 -0
  92. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/RELEASE.md +0 -0
  93. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/CLIENTS.md +0 -0
  94. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/TROUBLESHOOTING.md +0 -0
  95. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-favicon.svg +0 -0
  96. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-lockup-dark.svg +0 -0
  97. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-lockup.svg +0 -0
  98. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-statusline.gif +0 -0
  99. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-usage.gif +0 -0
  100. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/README.md +0 -0
  101. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/render.sh +0 -0
  102. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/seed.py +0 -0
  103. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/statusline.tape +0 -0
  104. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/usage.tape +0 -0
  105. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/hatch_build.py +0 -0
  106. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/noxfile.py +0 -0
  107. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/pyrightconfig.json +0 -0
  108. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/sonar-project.properties +0 -0
  109. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/__init__.py +0 -0
  110. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/__init__.py +0 -0
  111. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/__init__.py +0 -0
  112. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/banner.py +0 -0
  113. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/__init__.py +0 -0
  114. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/__init__.py +0 -0
  115. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/path_client_detector.py +0 -0
  116. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/__init__.py +0 -0
  117. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/claude_cli_caller.py +0 -0
  118. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/codex_cli_caller.py +0 -0
  119. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_file.py +0 -0
  120. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_opening.py +0 -0
  121. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/cursor_cli_caller.py +0 -0
  122. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/default_provider.py +0 -0
  123. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/loader.py +0 -0
  124. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/status_line_config.py +0 -0
  125. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_cli_caller.py +0 -0
  126. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_config.py +0 -0
  127. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/compress/__init__.py +0 -0
  128. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/compress/cache_backed_compressor.py +0 -0
  129. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/credentials/__init__.py +0 -0
  130. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/credentials/filesystem_credentials_store.py +0 -0
  131. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/__init__.py +0 -0
  132. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/anthropic_sse.py +0 -0
  133. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_chat.py +0 -0
  134. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_responses.py +0 -0
  135. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/relay.py +0 -0
  136. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/hook/__init__.py +0 -0
  137. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/hook/session_logger.py +0 -0
  138. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/__init__.py +0 -0
  139. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/size_logger.py +0 -0
  140. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/persona/__init__.py +0 -0
  141. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/persona/filesystem_persona_source.py +0 -0
  142. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/plugin/__init__.py +0 -0
  143. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/plugin/filesystem_plugin_source.py +0 -0
  144. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/status/__init__.py +0 -0
  145. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/status/claude_status_parser.py +0 -0
  146. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/status/cursor_status_parser.py +0 -0
  147. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/__init__.py +0 -0
  148. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/filesystem_transcript_store.py +0 -0
  149. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/ledger.py +0 -0
  150. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_per_turn_store.py +0 -0
  151. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_session_store.py +0 -0
  152. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_usage_store.py +0 -0
  153. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workflow/__init__.py +0 -0
  154. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workspace/__init__.py +0 -0
  155. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workspace/local_workspace_inspector.py +0 -0
  156. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/__init__.py +0 -0
  157. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/__init__.py +0 -0
  158. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/__init__.py +0 -0
  159. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/client_status.py +0 -0
  160. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/context_source.py +0 -0
  161. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/identifiers.py +0 -0
  162. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/learned.py +0 -0
  163. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/persona.py +0 -0
  164. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/plugin.py +0 -0
  165. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/rules.py +0 -0
  166. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/run.py +0 -0
  167. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/session.py +0 -0
  168. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/turn_usage.py +0 -0
  169. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/workspace.py +0 -0
  170. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/__init__.py +0 -0
  171. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/greeting.py +0 -0
  172. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/hook.py +0 -0
  173. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/hook_runner.py +0 -0
  174. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/interceptor.py +0 -0
  175. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/interceptor_chain.py +0 -0
  176. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/persona_parser.py +0 -0
  177. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/rule_cleaner.py +0 -0
  178. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/session_naming.py +0 -0
  179. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/statusline_renderer.py +0 -0
  180. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/__init__.py +0 -0
  181. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/__init__.py +0 -0
  182. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/bootstrap.py +0 -0
  183. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/check_client_ready.py +0 -0
  184. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/export_usage.py +0 -0
  185. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_jobs.py +0 -0
  186. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_personas.py +0 -0
  187. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_plugins.py +0 -0
  188. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_sessions.py +0 -0
  189. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_workflows.py +0 -0
  190. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/new_workflow.py +0 -0
  191. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/render_greeting.py +0 -0
  192. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/render_statusline.py +0 -0
  193. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/set_credential.py +0 -0
  194. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/start_job.py +0 -0
  195. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/__init__.py +0 -0
  196. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/cli_caller.py +0 -0
  197. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/client_detector.py +0 -0
  198. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/client_status.py +0 -0
  199. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/context_compressor.py +0 -0
  200. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/credentials_store.py +0 -0
  201. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/hook.py +0 -0
  202. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/interceptor.py +0 -0
  203. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/per_turn_metering.py +0 -0
  204. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/persona_source.py +0 -0
  205. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/plugin_source.py +0 -0
  206. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/session_store.py +0 -0
  207. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/transcript.py +0 -0
  208. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/usage_store.py +0 -0
  209. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/workflow_source.py +0 -0
  210. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/workspace.py +0 -0
  211. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/__init__.py +0 -0
  212. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/bootstrap.py +0 -0
  213. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/check_client_ready.py +0 -0
  214. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/export_usage.py +0 -0
  215. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/launch.py +0 -0
  216. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_jobs.py +0 -0
  217. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_personas.py +0 -0
  218. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_plugins.py +0 -0
  219. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_sessions.py +0 -0
  220. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_workflows.py +0 -0
  221. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/new_workflow.py +0 -0
  222. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/render_greeting.py +0 -0
  223. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/render_statusline.py +0 -0
  224. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/set_credential.py +0 -0
  225. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/start_job.py +0 -0
  226. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/wiring/__init__.py +0 -0
  227. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/__init__.py +0 -0
  228. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/log.py +0 -0
  229. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/spec_loader.py +0 -0
  230. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/py.typed +0 -0
  231. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/_floor.md +0 -0
  232. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/butler.md +0 -0
  233. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/companion.md +0 -0
  234. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/mentor.md +0 -0
  235. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/plain.md +0 -0
  236. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/terse.md +0 -0
  237. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/workflows/_common/base.md +0 -0
  238. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/workflows/create-workflow/workflow.md +0 -0
  239. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/_conformance.py +0 -0
  240. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/conftest.py +0 -0
  241. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_anthropic_sse.py +0 -0
  242. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_authoring_separation.py +0 -0
  243. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_banner.py +0 -0
  244. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_cache_backed_compressor.py +0 -0
  245. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_caller_loader.py +0 -0
  246. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_callers.py +0 -0
  247. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_context_file.py +0 -0
  248. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_context_source.py +0 -0
  249. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_credentials_store.py +0 -0
  250. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_cursor_status_parser.py +0 -0
  251. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_docs_consistency.py +0 -0
  252. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_exit_handling.py +0 -0
  253. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_export_usage_usecase.py +0 -0
  254. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_persona_source.py +0 -0
  255. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_plugin_source.py +0 -0
  256. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_transcript_store.py +0 -0
  257. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_greeting.py +0 -0
  258. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_hook_runner.py +0 -0
  259. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_identifiers.py +0 -0
  260. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_interceptor_chain.py +0 -0
  261. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_learned.py +0 -0
  262. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_jobs_usecase.py +0 -0
  263. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_personas_usecase.py +0 -0
  264. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_plugins_usecase.py +0 -0
  265. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_sessions_usecase.py +0 -0
  266. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_workflows_usecase.py +0 -0
  267. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_local_workspace_inspector.py +0 -0
  268. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_log.py +0 -0
  269. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_model_invariants.py +0 -0
  270. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_new_workflow_usecase.py +0 -0
  271. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_openai_chat.py +0 -0
  272. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_openai_responses.py +0 -0
  273. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_path_client_detector.py +0 -0
  274. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_persona_parser.py +0 -0
  275. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_relay.py +0 -0
  276. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_render_greeting_usecase.py +0 -0
  277. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_rule_cleaner.py +0 -0
  278. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_session_logger.py +0 -0
  279. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_session_naming.py +0 -0
  280. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_size_logger.py +0 -0
  281. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_smoke.py +0 -0
  282. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_per_turn_store.py +0 -0
  283. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_session_store.py +0 -0
  284. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_usage_store.py +0 -0
  285. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_start_job_usecase.py +0 -0
  286. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_status_line_config.py +0 -0
  287. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_statusline.py +0 -0
  288. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_store_conformance.py +0 -0
  289. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_version.py +0 -0
  290. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_vibe_config.py +0 -0
  291. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tools/hooks/check-commit-msg.sh +0 -0
  292. {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tools/hooks/guard-branch.sh +0 -0
@@ -6,6 +6,79 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.4.0] - 2026-07-19
10
+
11
+ The first-run release — a mandatory `init` that establishes the model the rest of the app
12
+ runs on, migrates the on-disk layout to match, and settles a working client before the
13
+ first session.
14
+
15
+ ### Added
16
+ - **Guided client setup.** The init client step is no longer a silent chooser — it always
17
+ talks the choice through. It lists each installed client with its version, and when a
18
+ first-party release channel reports a newer one it flags an **old install** and offers
19
+ the one-line update (comparing on numeric components, so a build *ahead* of a lagging
20
+ stable channel is never nagged). It lets you switch, or **install a different client**:
21
+ it prints the OS-specific install command (macOS/Linux vs Windows), copies it to the
22
+ clipboard when a clipboard tool is present, offers to **run it for you** or let you run
23
+ it yourself, then polls `PATH` until the client appears — and installs a prerequisite
24
+ first (`uv` for Vibe) when it is missing. Every client's latest version comes from its
25
+ vendor's own channel with a changelog/registry fallback: Claude Code's native stable
26
+ manifest → GitHub `CHANGELOG.md`; Cursor's install-script version → the Homebrew cask
27
+ JSON; the npm registry → GitHub releases for Codex; PyPI → GitHub releases for Vibe.
28
+ All version reads are best-effort — an offline machine degrades to a plain list, never
29
+ a block. The launch-time "client not on your PATH" guidance now shows the same
30
+ OS-specific command. The client catalog (`client_catalog.py`) carries per-OS
31
+ install/update commands, the paid-plan framing, and the version sources.
32
+ - **Forced init + the gate.** A mandatory first-run setup, `gmlw init`, is now both a
33
+ command and a first-class gate: `[init] version` in `config.toml` records that it ran,
34
+ and any command on an un-initialised or pre-0.4.0 install is funnelled through init
35
+ before it runs (`statusline` and bare `--help` are exempt). The interview captures, in
36
+ order — each with a sensible default so a non-interactive run never blocks — **language
37
+ → name → role → environment → persona → client**: language sets the voice the rest of
38
+ the interview speaks (chosen language re-localises every later prompt), name is what the
39
+ companion calls you, role and environment seed the movie-set axes (`[profile]
40
+ default_role` / `default_environment`), persona and client reuse the existing choosers.
41
+ A fresh install gets a full seeded `config.toml`; a legacy install gets every answer
42
+ merged into its existing file (see below). Retires the thinner 0.2.0 `FirstRunInit`.
43
+ - **Every init answer is persisted — on a legacy install too.** Previously a pre-0.4.0
44
+ install had only the `[init]` marker appended, so the language, name, role, environment,
45
+ persona and client you had just chosen were discarded and had to be re-entered. They are
46
+ now **merged into the existing `config.toml`**: each value is written into its table
47
+ (created when missing) through a round-trip TOML edit, so **every other setting, every
48
+ comment, and the file's formatting survive untouched** — arrays like `[[interceptors]]`
49
+ included. The persona and client are written only when one was chosen, so declining never
50
+ clears an existing value. Any setting a fresh choice replaced is reported on stderr
51
+ (`client.default: cursor → claude`) rather than changed silently.
52
+ - **Environment migration.** Place-specific context is now a first-class **environment**:
53
+ it lives under `environments/<env>/` (one folder per environment, the movie set) instead
54
+ of the single `profile/company/`. On any command, gmlw non-destructively wraps an old
55
+ `profile/company/` into the **active** environment (`[profile] default_environment`,
56
+ `work` by default) — a move (nothing copied or lost), a name that already exists at the
57
+ target is left in place and reported (never overwritten), and the emptied old folder is
58
+ retired. What moved and what was skipped is printed to stderr. The move runs on both the
59
+ forced-init and the normal bootstrap paths, so an install initialised before the
60
+ migration existed is caught too. The `company` context source is unchanged as a config
61
+ key; only its on-disk home moved to `environments/<env>/`.
62
+ - **Role-scoped rules & learned.** The role chosen at init (`[profile] default_role`, a lens
63
+ over `me`) now shapes context: rules under `profile/roles/<role>/rules/*.md` and a
64
+ `profile/roles/<role>/learned.md` compose into the `rules` and `me.learned` sources **only
65
+ when that role is active** — layered after the global rules/learned (general → specific).
66
+ `gmlw init` seeds the chosen role's folder with an empty `rules/` drop-zone. Capture stays
67
+ global for now (new reflexes are still written to `rules/` and `profile/me/learned.md`);
68
+ role-aware capture is a later step.
69
+
70
+ ### Changed
71
+ - **New runtime dependency: `tomlkit`** (MIT, pure Python, no transitive deps) — the
72
+ round-trip TOML editor that merges init's answers into an existing `config.toml`
73
+ without disturbing the user's comments or settings. stdlib `tomllib` reads TOML but
74
+ cannot write it. `LayoutSeederPort.initialize` now returns an `InitPersist`
75
+ (`fresh` + `overwrites`) instead of a bare bool.
76
+ - **`ClientInfo` gained per-OS commands.** The single `install` field became
77
+ `install_unix` / `install_windows` (plus `update`, `subscription`, `version_probes`,
78
+ `prereq`); callers use `install_for(system)` / `update_for(system)`. The 0.2.0
79
+ `TtyClientChooser` and its `ClientChooserPort` were **removed**, superseded by the new
80
+ `ClientSetupPort` (`TtyClientSetup`) that owns the full guided conversation.
81
+
9
82
  ## [0.3.0] - 2026-07-18
10
83
 
11
84
  The lifecycle release — hooks that act at the seams around a run, and rule capture that
@@ -104,7 +177,8 @@ First public release — a metering wrapper around ML coding CLIs.
104
177
  over `src` and `tests`; `nox` gates mirrored by CI across Python 3.11–3.14; a
105
178
  server-side no-AI-attribution check and branch protection.
106
179
 
107
- [Unreleased]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.3.0...HEAD
180
+ [Unreleased]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.4.0...HEAD
181
+ [0.4.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.3.0...v0.4.0
108
182
  [0.3.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.2.0...v0.3.0
109
183
  [0.2.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.1.0...v0.2.0
110
184
  [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.3.0
3
+ Version: 0.4.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: tomlkit>=0.13
29
30
  Provides-Extra: dev
30
31
  Requires-Dist: import-linter>=2; extra == 'dev'
31
32
  Requires-Dist: pyright==1.1.411; extra == 'dev'
@@ -0,0 +1,274 @@
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
+ ### 0.3.0 — lifecycle action hooks
45
+ gmlw already hooks **content**: the interceptor chain transforms context sections at
46
+ compile time and wire traffic at relay time (e.g. anonymisation on `request`). It now
47
+ also hooks **actions** — "after this phase, run something" — at two lifecycle seams
48
+ that bracket the client run:
49
+
50
+ - **`pre-launch`** — after the context is compiled and the caller resolved, before the
51
+ client starts. Knows the client, the working directory, and the session. For
52
+ per-client setup: deploying skills/rules into a client's *native* mechanism, writing
53
+ MCP config, warming a cache.
54
+ - **`post-session`** — after the client exits. Knows the exit code and the session.
55
+ For cleanup, notification, archival, or roll-up.
56
+
57
+ Config mirrors the existing extension points — a `[[hooks]]` entry with a `phase`, a
58
+ `spec` (a plugin id or `path.py:Class`), and an optional `client` scope — under the
59
+ same trusted-code boundary as `[[interceptors]]`, `[callers]`, and plugins. Hooks are
60
+ best-effort and never break a launch. Both launch paths (`start`, `workflow new`) route
61
+ through one shared launch sequence, so the seams bracket every run. Shipped with a
62
+ built-in `SessionLogger` reference hook.
63
+
64
+ **Still open — the flagship example hook:** a **cross-client skills/rules deployer** that
65
+ consumes a git repo of skills and installs them, per client, as faithfully as each
66
+ client's format allows. It is its own initiative (per-client format knowledge), built on
67
+ the seam above; the infrastructure is done and waiting for it.
68
+
69
+ #### Rule lifecycle
70
+ 0.2.0 shipped rule *capture*, but only inside a workflow (the directive lived in the
71
+ workflow base) and without dedup or a path to code. The rule loop is now rounded out —
72
+ the directive moved out of the workflow base to the head of the always-on `rules`
73
+ context source (verbatim, gmlw's voice), and the source is active by default in a plain
74
+ start:
75
+
76
+ - **Rule proposal in normal usage** — the "offer to record a rule" directive is
77
+ always-on, so a demanded correction becomes a draft rule wherever it happens, not only
78
+ inside a workflow.
79
+ - **Existing-rule check (dedup / update-not-duplicate)** — before proposing, the client
80
+ reads the existing rules and updates or supersedes a matching one instead of stacking a
81
+ near-duplicate, mirroring the learned notebook's supersede-on-contradiction.
82
+ - **Rule → code feasibility** — a captured rule is judged for *mechanical
83
+ enforceability* and, if so, offered as a script/check rather than a reminder — the
84
+ step-codeability logic (create-workflow) generalised from workflow steps to rules, and
85
+ a natural future `pre-launch` hook consumer.
86
+
87
+ ### 0.4.0 — first run: the forced setup that shapes every session
88
+ One job, done properly: a **mandatory `init`** every user passes through once — new or
89
+ existing — because it establishes the model the rest of the app runs on and migrates the
90
+ on-disk layout to match. It is a *forced update*: the old single-context folder layout is
91
+ wrapped into the new one non-destructively, and role + environment are chosen before the
92
+ first session. The discoverability work that used to sit here has moved to 0.5.0; this
93
+ release is the init and the two concepts under it.
94
+
95
+ **The movie-set model.** A launch composes four axes — three describe *you and your
96
+ context* (they become the briefing the wrapper hands the companion), one describes *the
97
+ companion itself*:
98
+
99
+ - **Me — the actor.** Who you are, invariant across everything: name, language, the
100
+ journal. Spans every launch.
101
+ - **Role — the character.** The functional hat you're wearing (software engineer, product
102
+ owner, QA, a private individual buying groceries). A *lens over `me`*, not a copy — it
103
+ parameterises the `me`-extraction (which facets are in scope) and scopes rules/learned.
104
+ You stay one person; you play different parts.
105
+ - **Environment — the movie set.** Where the work happens (work-at-a-company, a personal
106
+ project, open source). It swaps the *place-specific context* — today's forced `company`
107
+ becomes one environment's bucket. Changing environment changes the set and the
108
+ guidelines, not who you are.
109
+ - **Persona — the director.** The one entity you actually talk to: the companion. Persona
110
+ is *its* manner (manner over method — see 0.6.0).
111
+
112
+ gmlw itself is the **stage organiser / assistant director**: it builds the set, arranges
113
+ costume and makeup, briefs the director, then cedes the screen ([[wrapper-not-standalone]]).
114
+
115
+ - **Forced init (`gmlw init`, and the gate)** — init is both a command and a first-class
116
+ gate: a stored marker records that it ran, and bare `gmlw` routes an un-initialised or
117
+ old-layout install into it before anything else runs. It captures, in order, **language
118
+ → name → role → environment → persona**, then does the technical client step. Each
119
+ answer carries a sensible default so the forced pass stays short.
120
+ - **Two new concepts — role & environment** — the two axes above, made real: `default_role`
121
+ and `default_environment` in `config.toml` (read directly — no registry yet), a
122
+ `profile/roles/<role>/` folder for role-scoped rules/learned, and an
123
+ `environments/<env>/` folder for place-specific context. Both are changeable later (via
124
+ the `config` commands landing in 0.5.0). This **resolves the parked _profiles_ fork** —
125
+ `me` spans, role is a lens over it, environment is the external place — by splitting one
126
+ container into two orthogonal axes.
127
+ - **Forced migration** — the existing global layout (`profile/company`, single-context
128
+ `rules`) is wrapped non-destructively into the new shape — `profile/company` →
129
+ `environments/work/`, a `default` role seeded — surfacing exactly what moved
130
+ ([[no-silent-removals]]). No install is left on the old layout.
131
+ - **Localised setup (EN / FR)** — onboarding strings move into a keyed language file
132
+ (`i18n/en.*`, `i18n/fr.*`) read through a small `t(key, lang)` lookup with English
133
+ fallback; the default is seeded from `$LANG`. Mechanism built to extend; content scoped
134
+ to onboarding for now.
135
+ - **`language` — our voice only** — a `language` setting fixes the language gmlw speaks to
136
+ *you* (onboarding now, receipts/help later). It does **not** force the companion's
137
+ language: only Claude Code exposes a real language setting; Cursor, Codex and Vibe have
138
+ none, so pushing it would be a leaky per-client hack for one client out of four. gmlw
139
+ speaks your language; the companion stays as its own config leaves it.
140
+ - **A working client — the one hard requirement** — after the human setup, the technical
141
+ step. *Fast path*: detect an installed, authenticated client and reach a session in
142
+ seconds. *Guided path* when none is found: a subscription→client map (*"do you pay for
143
+ Claude / ChatGPT / Cursor / Mistral?"*), the **official install command for the detected
144
+ OS** (Windows / Linux / macOS), and **guide-and-verify auth** — print the exact login
145
+ command, poll readiness until it goes green (guide, don't drive).
146
+ - **A default persona** — the experience-defining choice, offered with a one-line
147
+ description per persona so it can be made without reading docs.
148
+
149
+ Deferred but homed: a detached model call to synthesise a `role.md` for an unfamiliar role
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
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
156
+
157
+ ### 0.5.0 — discoverability & progressive disclosure
158
+ 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.
191
+
192
+ ### 0.6.0 — the workflow, first-class
193
+ Two ways people relate to a workflow: *applied to a job* (a ticket it treats), or *the
194
+ recurring job itself* (a repeatable extraction). Make both first-class, and make
195
+ authoring one a guided conversation — because most people don't arrive with a clear
196
+ model of their own process.
197
+
198
+ - **`run <workflow>`** — launch a workflow directly; the job defaults to the workflow
199
+ name and sessions accumulate under it. `start <job> [--workflow]` stays for the
200
+ applied case. A trigger-gated pre-launch chooser fills only *missing* arguments and
201
+ always echoes the equivalent one-liner, so interactive use teaches the fast path
202
+ (full argv never gains a prompt).
203
+ - **Name at the end, not the start** — `workflow new` no longer demands a name up front;
204
+ forcing one presumes the user already knows the shape. The authoring conversation
205
+ shapes the workflow and *proposes* the name at convergence. (Distinct from
206
+ `run <workflow>`, where an existing, recurring workflow's name has already earned it.)
207
+ - **Facilitative + constructive authoring** — the create-workflow conversation as a
208
+ blended consultant. Two axes: *facilitate* (a **parking lot** for tangents so nothing
209
+ is lost, reflective listening, a **diverge → converge** phase model, and **process
210
+ leveling** to answer "step or its own workflow?") and *contribute* (start in inquiry
211
+ and **move to expert when warranted**, propose the upstream/downstream stages the
212
+ author omitted, surface **implications** they haven't hit) — bounded by guardrails
213
+ against railroading a novice and a **consent gate** on anything personal. Authoring
214
+ keeps distilled state (a draft plus the parking lot) as files in the workflow folder,
215
+ 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
+
223
+ ### 0.7.0 — personas, proven (and multilingual)
224
+ Today "personas shape tone" is an **untested claim**. A persona ships a tone block, but
225
+ nothing demonstrates that `mentor` and `terse` actually answer differently — and the tone
226
+ block is injected *on top of* each client's own system prompt, which may simply swamp it.
227
+ This release makes the claim falsifiable first, then builds on it. Its own initiative: it
228
+ is an evaluation loop, not a feature.
229
+
230
+ - **A persona evaluation harness** — the core of the release. Run every persona against a
231
+ fixed question set and compare. Two design calls, both deliberate:
232
+ - **Questions curated against the declared dimensions, not scraped.** Generic benchmark
233
+ sets measure *correctness* and would show almost no tone variance. Each persona already
234
+ declares `Warmth · Verbosity · Formality · Proactivity`, so the set probes exactly those,
235
+ plus the high-divergence moments — being corrected, delivering bad news, being handed a
236
+ half-formed request.
237
+ - **A distinctness metric, not eyeballing.** A judge scores each answer on the declared
238
+ dimensions and yields a **pairwise distance matrix**, so collapsed pairs are named rather
239
+ than sensed (`plain`/`terse` and `companion`/`mentor` are the likely offenders). Runs go
240
+ through **generic-ml-cache**, so re-running one persona after a tweak replays the other
241
+ four for free and keeps iterations deterministic and diffable.
242
+ - **Tune until distinct** — the back-and-forth the harness exists to serve: adapt each tone
243
+ block, re-run, watch the matrix separate. The honest possible outcome is that personas must
244
+ become **bolder** to survive a client's own voice — or that they differentiate on some
245
+ clients and not others. That finding is a deliverable, not a failure.
246
+ - **Persona content becomes multilingual** — required for previews in French, and a real gap
247
+ today: only the *prompt header* is localised, so a French user gets an English description
248
+ and an **English greeting at every launch**. This is not a strings port: French carries a
249
+ `tu`/`vous` register English cannot express, and a butler is *defined* by register — so the
250
+ directives themselves need per-language authoring, not translation.
251
+ - Layout: a **folder per persona** — a language-neutral `body.md` (dimensions, do/don't)
252
+ plus `en.md` / `fr.md` carrying description, greeting, register notes, and samples.
253
+ - **A flat `<name>.md` must keep working.** Users author personas by dropping a file in
254
+ `~/.gmlw/personas/`; a folder gets the full treatment, a flat file behaves as it does
255
+ today (English, no samples, falls back to its description). Breaking user-authored
256
+ personas to gain previews would be a bad trade.
257
+ - **Previews, as a byproduct** — once the answers are generated, reviewed, and committed as
258
+ data, the first-run chooser can show a real sample line per persona. It stays **static** at
259
+ runtime: generated at authoring time, read from disk, **zero tokens and zero latency**, so
260
+ choosing still costs nothing. Length forces a split — one short line inline in the chooser,
261
+ the full side-by-side behind `gmlw persona preview`. Samples are labelled as indicative:
262
+ they come from one model at authoring time, and the user's client may differ.
263
+
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.
268
+
269
+ ## Parked
270
+
271
+ - **External source connectors** — let a workflow pull from external systems (APIs,
272
+ cloud storage, platforms) rather than manual input. Large; its own initiative.
273
+ - Relay extraction to a standalone project (shelved — no second consumer yet).
274
+ - Workspace layout feature.
@@ -1,6 +1,6 @@
1
1
  # Security Policy
2
2
 
3
- `generic-ml-wrapper` is early software (`0.2.0`). It is published
3
+ `generic-ml-wrapper` is early software (`0.4.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.4.0
@@ -8,6 +8,7 @@ and flag. For deeper behaviour, follow the cross-links to [CONFIGURATION.md](CON
8
8
  ## Synopsis
9
9
 
10
10
  ```
11
+ gmlw init # forced first-run setup (auto-runs when needed)
11
12
  gmlw <job> # shorthand for: gmlw start <job>
12
13
  gmlw start [job] [--client X] [--resume-latest] [--workflow|-w NAME]
13
14
  gmlw jobs [--json]
@@ -46,6 +47,33 @@ prints its own help, then exits 0.
46
47
 
47
48
  ---
48
49
 
50
+ ## init
51
+
52
+ Run the forced first-run setup that shapes every session. `init` is both a command and
53
+ a **gate**: the first time you run *any* command on a new or pre-0.4.0 install, gmlw
54
+ funnels you through it before that command runs. Once it has run, a marker
55
+ (`[init] version` in `~/.gmlw/config.toml`) records it, and the gate stays out of the way.
56
+
57
+ ```
58
+ gmlw init
59
+ ```
60
+
61
+ The interview captures, in order — each with a sensible default, so a non-interactive
62
+ run completes without blocking:
63
+
64
+ 1. **language** — which language gmlw speaks *to you* (`en` | `fr`); it does not force the
65
+ companion's language. Seeded from `$LANG`.
66
+ 2. **name** — what the companion calls you (defaults to your OS user).
67
+ 3. **role** — the functional hat you wear (a lens over *you*), e.g. `engineer`, `qa`.
68
+ 4. **environment** — where the work happens, e.g. `work`, a personal project.
69
+ 5. **persona** — the companion's voice (skippable; leaves the companion off).
70
+ 6. **client** — the client to wrap by default; a lone installed one is taken silently,
71
+ several prompt a choice, none leaves it unset.
72
+
73
+ On a **fresh** install a full `config.toml` is seeded with your choices. On a **legacy**
74
+ install (a pre-0.4.0 config already exists) only the `[init]` marker is appended — your
75
+ existing file is left untouched; migrating the older layout comes in a later release.
76
+
49
77
  ## start
50
78
 
51
79
  Start or resume a session on a job.
@@ -147,9 +147,13 @@ On every run gmlw composes an operating context from a fixed set of sources.
147
147
  **Sources:**
148
148
 
149
149
  - `me.user` — `profile/me/*.md`
150
- - `me.learned` — `profile/me/learned*`
151
- - `company` — `profile/company/*.md`
152
- - `rules` — `rules/*.md`
150
+ - `me.learned` — `profile/me/learned*`, plus the active role's
151
+ `profile/roles/<role>/learned*` (role-scoped learnings)
152
+ - `company` — `environments/<env>/*.md`, where `<env>` is the active
153
+ `[profile] default_environment` (the config key stays `company`; only its on-disk home
154
+ moved from the old `profile/company/`)
155
+ - `rules` — `rules/*.md`, plus the active role's `profile/roles/<role>/rules/*.md`
156
+ (role-scoped reflexes), where `<role>` is the active `[profile] default_role`
153
157
  - `persona` — the selected persona plus the shared floor (see [`[companion]`](#companion))
154
158
  - `base` / `steps` — a workflow run also composes its `base` and `steps`
155
159
 
@@ -257,7 +257,8 @@ compression is an opt-in plug-in bound to a target, not a fork of the engine.
257
257
  as a normal (metered) authoring session, kept out of `gmlw jobs`.
258
258
 
259
259
  Hidden folders `_common` and `create-workflow` are not listed as runnable workflows;
260
- `profile/` has `me/` and `company/` subdirs.
260
+ `profile/` has a `me/` subdir (place-specific context lives per-environment under
261
+ `environments/<env>/` — the old `profile/company/` is migrated there on first run).
261
262
 
262
263
  ## 11. Config — `~/.gmlw/config.toml`
263
264
 
@@ -300,7 +301,8 @@ Created owner-only (`0700`) on first run:
300
301
  contexts/<job>/<session>.context.md the context a session launched with
301
302
  transcripts/<job>/<session>/ opt-in per-call in/out/usage trio
302
303
  workflows/ _common/ · create-workflow/ · <name>/
303
- profile/ me/*.md (incl. learned.md) · company/*.md
304
+ profile/ me/*.md (incl. learned.md)
305
+ environments/<env>/*.md place-specific context (migrated from profile/company)
304
306
  personas/ *.md user-authored personas (built-ins are packaged)
305
307
  plugins/ <id>/plugin.toml caller plugins referenced by id
306
308
  rules/ *.md
@@ -57,18 +57,32 @@ gmlw start PROJ-482 -w triage
57
57
  The authoring session is hidden from `gmlw jobs`. See [WORKFLOWS.md](WORKFLOWS.md) for the compile
58
58
  order and the `rules/` and `scripts/` folders.
59
59
 
60
- ## 5. Add profile and company context
60
+ ## 5. Add profile and environment context
61
61
 
62
- Drop markdown files under `~/.gmlw/profile/me/` (about you) and `~/.gmlw/profile/company/` (about
63
- your organisation). They are compiled into the launch context so every session knows who you are.
62
+ Drop markdown files under `~/.gmlw/profile/me/` (about you — spans every session) and
63
+ `~/.gmlw/environments/<env>/` (about where the work happens: your organisation, a personal
64
+ project). `<env>` is your active `[profile] default_environment` (`work` by default), chosen at
65
+ `gmlw init`. They are compiled into the launch context so every session knows who you are.
64
66
 
65
67
  ```
66
68
  $EDITOR ~/.gmlw/profile/me/about.md
67
- $EDITOR ~/.gmlw/profile/company/overview.md
69
+ $EDITOR ~/.gmlw/environments/work/overview.md
70
+ ```
71
+
72
+ Rules and learnings can also be **role-scoped**: drop them under
73
+ `~/.gmlw/profile/roles/<role>/rules/` and `~/.gmlw/profile/roles/<role>/learned.md`, and they
74
+ compose only when `<role>` is your active `[profile] default_role` (the functional hat you
75
+ picked at `gmlw init` — a lens over `me`, not a separate you). Global `rules/` and
76
+ `profile/me/learned.md` always apply; the role's add on top.
77
+
78
+ ```
79
+ $EDITOR ~/.gmlw/profile/roles/engineer/rules/review.rule.md
68
80
  ```
69
81
 
70
82
  Which sources are activated (and compressed) per mode is controlled by the `[startup.<mode>]`
71
- matrix in [CONFIGURATION.md](CONFIGURATION.md); `me.user` and `company` are active by default.
83
+ matrix in [CONFIGURATION.md](CONFIGURATION.md); `me.user` and `company` (the environment source)
84
+ are active by default. If you upgraded from an older layout, `gmlw` migrates your old
85
+ `profile/company/` into `environments/work/` automatically on first run.
72
86
 
73
87
  ## 6. Choose a persona
74
88
 
@@ -66,7 +66,8 @@ The stages are assembled in this **fixed order**:
66
66
 
67
67
  - `_common/base.md` — the shared "how to behave" base (orient first, one step at a
68
68
  time, work in the user's language, offer to capture rules).
69
- - `profile/*` — your `me/` and `company/` context.
69
+ - `profile/me/` — your `me/` context; place-specific context comes from the active
70
+ `environments/<env>/`.
70
71
  - global rules — `~/.gmlw/rules/*`.
71
72
  - workflow rules — the workflow's own `rules/`.
72
73
  - workflow steps — this workflow's `workflow.md`.
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "generic-ml-wrapper"
7
- version = "0.3.0"
7
+ version = "0.4.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"
@@ -32,6 +32,11 @@ dependencies = [
32
32
  "generic-ml-cache-core>=1.0.0",
33
33
  "generic-ml-cache-adapters>=1.0.0",
34
34
  "generic-ml-cache-bootstrap>=1.0.0",
35
+ # tomlkit (MIT) is a round-trip TOML editor: it merges the init interview's answers
36
+ # into an *existing* config.toml while preserving the user's comments, keys, and
37
+ # formatting exactly. stdlib tomllib reads TOML but cannot write it. Pure Python,
38
+ # no transitive deps.
39
+ "tomlkit>=0.13",
35
40
  ]
36
41
 
37
42
  [project.urls]
@@ -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.3.0"
13
+ __version__ = "0.4.0"