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.
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/CHANGELOG.md +75 -1
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/PKG-INFO +2 -1
- generic_ml_wrapper-0.4.0/ROADMAP.md +274 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/SECURITY.md +1 -1
- generic_ml_wrapper-0.4.0/VERSION +1 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/CLI.md +28 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/CONFIGURATION.md +7 -3
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/DESIGN.md +4 -2
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/USER_GUIDE.md +19 -5
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/WORKFLOWS.md +2 -1
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/pyproject.toml +6 -1
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/__init__.py +1 -1
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/app.py +90 -21
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_migrator.py +61 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_seeder.py +403 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/http_client_versions.py +169 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/subprocess_command_runner.py +33 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/system_clipboard.py +57 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_client_setup.py +246 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_language_chooser.py +54 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_persona_chooser.py +51 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_prompt.py +120 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_text_prompt.py +56 -0
- {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
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/domain/model/client_catalog.py +224 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/domain/model/migration.py +33 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/inbound/init.py +50 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/inbound/migrate_layout.py +23 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/client_setup.py +35 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/client_version.py +46 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/clipboard.py +23 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/command_runner.py +22 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/language_chooser.py +28 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/layout_migrator.py +31 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/layout_seeder.py +85 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/persona_chooser.py +5 -1
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/port/outbound/text_prompt.py +32 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/usecase/init.py +126 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/usecase/migrate_layout.py +42 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/wiring/composition.py +77 -9
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/config.py +63 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/common/i18n.py +95 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/paths.py +3 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/resources/i18n/en.json +36 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/resources/i18n/fr.json +36 -0
- generic_ml_wrapper-0.4.0/tests/test_bootstrap.py +205 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_check_client_ready.py +4 -1
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_cli.py +169 -61
- generic_ml_wrapper-0.4.0/tests/test_client_catalog.py +43 -0
- generic_ml_wrapper-0.4.0/tests/test_client_versions.py +99 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_config.py +25 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_workflow_source.py +85 -12
- generic_ml_wrapper-0.4.0/tests/test_i18n.py +67 -0
- generic_ml_wrapper-0.4.0/tests/test_init_usecase.py +196 -0
- generic_ml_wrapper-0.4.0/tests/test_layout_migrator.py +84 -0
- generic_ml_wrapper-0.4.0/tests/test_migrate_layout_usecase.py +32 -0
- generic_ml_wrapper-0.4.0/tests/test_tty_client_setup.py +204 -0
- generic_ml_wrapper-0.4.0/tests/test_tty_language_chooser.py +60 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_tty_persona_chooser.py +11 -9
- generic_ml_wrapper-0.4.0/tests/test_tty_prompt.py +86 -0
- generic_ml_wrapper-0.4.0/tests/test_tty_text_prompt.py +62 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/uv.lock +12 -1
- generic_ml_wrapper-0.3.0/ROADMAP.md +0 -173
- generic_ml_wrapper-0.3.0/VERSION +0 -1
- generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_seeder.py +0 -197
- generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_client_chooser.py +0 -49
- generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_persona_chooser.py +0 -52
- generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/domain/model/client_catalog.py +0 -77
- generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/port/inbound/first_run_init.py +0 -37
- generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/port/outbound/client_chooser.py +0 -23
- generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/port/outbound/layout_seeder.py +0 -25
- generic_ml_wrapper-0.3.0/src/generic_ml_wrapper/application/usecase/first_run_init.py +0 -71
- generic_ml_wrapper-0.3.0/tests/test_bootstrap.py +0 -101
- generic_ml_wrapper-0.3.0/tests/test_first_run_init.py +0 -123
- generic_ml_wrapper-0.3.0/tests/test_tty_client_chooser.py +0 -55
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.coveragerc +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.gitattributes +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.github/workflows/ci.yml +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.github/workflows/pr-hygiene.yml +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.github/workflows/release.yml +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.github/workflows/sonar.yml +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.gitignore +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.importlinter +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/.pre-commit-config.yaml +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/AGENTS.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/CODE_OF_CONDUCT.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/CONTRIBUTING.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/GOVERNANCE.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/LICENSE +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/NOTICE +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/README.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/RELEASE.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/CLIENTS.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/TROUBLESHOOTING.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-favicon.svg +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-lockup-dark.svg +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-lockup.svg +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-statusline.gif +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-usage.gif +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/README.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/render.sh +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/seed.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/statusline.tape +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/docs/tapes/usage.tape +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/hatch_build.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/noxfile.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/pyrightconfig.json +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/sonar-project.properties +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/banner.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/__init__.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/__init__.py +0 -0
- {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
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_file.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_opening.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/default_provider.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/loader.py +0 -0
- {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
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_config.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/compress/__init__.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/credentials/__init__.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/anthropic_sse.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_chat.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_responses.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/relay.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/hook/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/hook/session_logger.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/size_logger.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/persona/__init__.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/plugin/__init__.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/status/__init__.py +0 -0
- {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
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/__init__.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/ledger.py +0 -0
- {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
- {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
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workflow/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workspace/__init__.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/client_status.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/context_source.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/identifiers.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/learned.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/persona.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/plugin.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/rules.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/run.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/session.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/turn_usage.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/workspace.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/greeting.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/hook.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/hook_runner.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/interceptor.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/interceptor_chain.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/persona_parser.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/rule_cleaner.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/session_naming.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/statusline_renderer.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/bootstrap.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/export_usage.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_jobs.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_personas.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_plugins.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_sessions.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_workflows.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/new_workflow.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/render_greeting.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/render_statusline.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/set_credential.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/start_job.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/cli_caller.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/client_detector.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/client_status.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/context_compressor.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/credentials_store.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/hook.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/interceptor.py +0 -0
- {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
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/persona_source.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/plugin_source.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/session_store.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/transcript.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/usage_store.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/workflow_source.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/workspace.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/bootstrap.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/check_client_ready.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/export_usage.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/launch.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_jobs.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_personas.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_plugins.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_sessions.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_workflows.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/new_workflow.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/render_greeting.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/render_statusline.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/set_credential.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/start_job.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/wiring/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/__init__.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/log.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/spec_loader.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/py.typed +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/_floor.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/butler.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/companion.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/mentor.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/plain.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/terse.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/workflows/_common/base.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/workflows/create-workflow/workflow.md +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/_conformance.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/conftest.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_anthropic_sse.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_authoring_separation.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_banner.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_cache_backed_compressor.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_caller_loader.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_callers.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_context_file.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_context_source.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_credentials_store.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_cursor_status_parser.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_docs_consistency.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_exit_handling.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_export_usage_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_persona_source.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_plugin_source.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_transcript_store.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_greeting.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_hook_runner.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_identifiers.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_interceptor_chain.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_learned.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_jobs_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_personas_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_plugins_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_sessions_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_list_workflows_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_local_workspace_inspector.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_log.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_model_invariants.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_new_workflow_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_openai_chat.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_openai_responses.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_path_client_detector.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_persona_parser.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_relay.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_render_greeting_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_rule_cleaner.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_session_logger.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_session_naming.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_size_logger.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_smoke.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_per_turn_store.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_session_store.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_usage_store.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_start_job_usecase.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_status_line_config.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_statusline.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_store_conformance.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_version.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tests/test_vibe_config.py +0 -0
- {generic_ml_wrapper-0.3.0 → generic_ml_wrapper-0.4.0}/tools/hooks/check-commit-msg.sh +0 -0
- {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.
|
|
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
|
+
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.
|
|
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
|
-
|
|
152
|
-
- `
|
|
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/`
|
|
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)
|
|
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
|
|
60
|
+
## 5. Add profile and environment context
|
|
61
61
|
|
|
62
|
-
Drop markdown files under `~/.gmlw/profile/me/` (about you) and
|
|
63
|
-
|
|
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/
|
|
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`
|
|
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
|
|
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.
|
|
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]
|