generic-ml-wrapper 0.2.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.2.0 → generic_ml_wrapper-0.4.0}/.gitignore +3 -0
- generic_ml_wrapper-0.4.0/CHANGELOG.md +184 -0
- {generic_ml_wrapper-0.2.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.2.0 → generic_ml_wrapper-0.4.0}/SECURITY.md +1 -1
- generic_ml_wrapper-0.4.0/VERSION +1 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/CLI.md +28 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/CLIENTS.md +0 -2
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/CONFIGURATION.md +54 -8
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/DESIGN.md +23 -5
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/TROUBLESHOOTING.md +9 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/USER_GUIDE.md +22 -7
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/WORKFLOWS.md +8 -8
- generic_ml_wrapper-0.4.0/hatch_build.py +53 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/pyproject.toml +13 -1
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/__init__.py +1 -1
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/app.py +222 -39
- 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.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/claude_cli_caller.py +1 -1
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/cursor_cli_caller.py +1 -1
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/status_line_config.py +21 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/hook/__init__.py +3 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/adapter/outbound/hook/session_logger.py +61 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/plugin/filesystem_plugin_source.py +17 -4
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workflow/filesystem_workflow_source.py +63 -15
- 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/domain/model/rules.py +94 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/domain/service/hook.py +75 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/domain/service/hook_runner.py +49 -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/hook.py +25 -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.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/persona_chooser.py +5 -1
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/plugin_source.py +19 -0
- 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/launch.py +70 -0
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/application/usecase/migrate_layout.py +42 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/new_workflow.py +6 -5
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/start_job.py +7 -6
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/wiring/composition.py +104 -9
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/config.py +103 -1
- generic_ml_wrapper-0.4.0/src/generic_ml_wrapper/common/i18n.py +95 -0
- {generic_ml_wrapper-0.2.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/src/generic_ml_wrapper/resources/workflows/_common/base.md +25 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_authoring_separation.py +2 -0
- generic_ml_wrapper-0.4.0/tests/test_bootstrap.py +205 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_callers.py +3 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_check_client_ready.py +4 -1
- {generic_ml_wrapper-0.2.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.2.0 → generic_ml_wrapper-0.4.0}/tests/test_config.py +52 -1
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_docs_consistency.py +14 -0
- generic_ml_wrapper-0.4.0/tests/test_exit_handling.py +118 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_plugin_source.py +19 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_workflow_source.py +125 -17
- generic_ml_wrapper-0.4.0/tests/test_hook_runner.py +76 -0
- 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.2.0 → generic_ml_wrapper-0.4.0}/tests/test_list_plugins_usecase.py +3 -0
- generic_ml_wrapper-0.4.0/tests/test_migrate_layout_usecase.py +32 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_new_workflow_usecase.py +4 -1
- generic_ml_wrapper-0.4.0/tests/test_session_logger.py +64 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_start_job_usecase.py +38 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_status_line_config.py +16 -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.2.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.4.0/tests/test_version.py +24 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/uv.lock +12 -1
- generic_ml_wrapper-0.2.0/CHANGELOG.md +0 -80
- generic_ml_wrapper-0.2.0/ROADMAP.md +0 -86
- generic_ml_wrapper-0.2.0/VERSION +0 -1
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/filesystem_layout_seeder.py +0 -181
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_client_chooser.py +0 -49
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/adapter/outbound/bootstrap/tty_persona_chooser.py +0 -52
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/application/domain/model/client_catalog.py +0 -77
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/application/domain/model/rules.py +0 -43
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/application/port/inbound/first_run_init.py +0 -37
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/application/port/outbound/client_chooser.py +0 -23
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/application/port/outbound/layout_seeder.py +0 -25
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/application/usecase/first_run_init.py +0 -71
- generic_ml_wrapper-0.2.0/src/generic_ml_wrapper/resources/workflows/_common/base.md +0 -52
- generic_ml_wrapper-0.2.0/tests/test_bootstrap.py +0 -101
- generic_ml_wrapper-0.2.0/tests/test_first_run_init.py +0 -123
- generic_ml_wrapper-0.2.0/tests/test_tty_client_chooser.py +0 -55
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/.coveragerc +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/.gitattributes +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/.github/workflows/ci.yml +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/.github/workflows/pr-hygiene.yml +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/.github/workflows/release.yml +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/.github/workflows/sonar.yml +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/.importlinter +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/.pre-commit-config.yaml +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/AGENTS.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/CODE_OF_CONDUCT.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/CONTRIBUTING.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/GOVERNANCE.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/LICENSE +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/NOTICE +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/README.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/RELEASE.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-favicon.svg +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-lockup-dark.svg +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-lockup.svg +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-statusline.gif +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/images/gmlw-usage.gif +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/tapes/README.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/tapes/render.sh +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/tapes/seed.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/tapes/statusline.tape +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/docs/tapes/usage.tape +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/noxfile.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/pyrightconfig.json +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/sonar-project.properties +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/inbound/cli/banner.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/bootstrap/path_client_detector.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/codex_cli_caller.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_file.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/context_opening.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/default_provider.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/loader.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_cli_caller.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/caller/vibe_config.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/compress/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/compress/cache_backed_compressor.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/credentials/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/credentials/filesystem_credentials_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/anthropic_sse.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_chat.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/openai_responses.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/gateway/relay.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/interceptor/size_logger.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/persona/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/persona/filesystem_persona_source.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/plugin/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/status/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/status/claude_status_parser.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/status/cursor_status_parser.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/filesystem_transcript_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/ledger.py +0 -0
- {generic_ml_wrapper-0.2.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.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_session_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/store/sqlite_usage_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workflow/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workspace/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/adapter/outbound/workspace/local_workspace_inspector.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/client_status.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/context_source.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/identifiers.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/learned.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/persona.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/plugin.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/run.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/session.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/turn_usage.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/model/workspace.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/greeting.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/interceptor.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/interceptor_chain.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/persona_parser.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/rule_cleaner.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/session_naming.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/domain/service/statusline_renderer.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/bootstrap.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/check_client_ready.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/export_usage.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_jobs.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_personas.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_plugins.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_sessions.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/list_workflows.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/new_workflow.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/render_greeting.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/render_statusline.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/set_credential.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/inbound/start_job.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/cli_caller.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/client_detector.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/client_status.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/context_compressor.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/credentials_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/interceptor.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/per_turn_metering.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/persona_source.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/session_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/transcript.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/usage_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/workflow_source.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/port/outbound/workspace.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/bootstrap.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/check_client_ready.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/export_usage.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_jobs.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_personas.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_plugins.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_sessions.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/list_workflows.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/render_greeting.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/render_statusline.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/usecase/set_credential.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/application/wiring/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/__init__.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/log.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/common/spec_loader.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/py.typed +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/_floor.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/butler.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/companion.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/mentor.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/plain.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/personas/terse.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/src/generic_ml_wrapper/resources/workflows/create-workflow/workflow.md +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/_conformance.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/conftest.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_anthropic_sse.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_banner.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_cache_backed_compressor.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_caller_loader.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_context_file.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_context_source.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_credentials_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_cursor_status_parser.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_export_usage_usecase.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_persona_source.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_filesystem_transcript_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_greeting.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_identifiers.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_interceptor_chain.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_learned.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_list_jobs_usecase.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_list_personas_usecase.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_list_sessions_usecase.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_list_workflows_usecase.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_local_workspace_inspector.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_log.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_model_invariants.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_openai_chat.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_openai_responses.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_path_client_detector.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_persona_parser.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_relay.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_render_greeting_usecase.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_rule_cleaner.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_session_naming.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_size_logger.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_smoke.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_per_turn_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_session_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_sqlite_usage_store.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_statusline.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_store_conformance.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tests/test_vibe_config.py +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tools/hooks/check-commit-msg.sh +0 -0
- {generic_ml_wrapper-0.2.0 → generic_ml_wrapper-0.4.0}/tools/hooks/guard-branch.sh +0 -0
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project are documented here. The format follows
|
|
4
|
+
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project adheres
|
|
5
|
+
to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
|
+
|
|
7
|
+
## [Unreleased]
|
|
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
|
+
|
|
82
|
+
## [0.3.0] - 2026-07-18
|
|
83
|
+
|
|
84
|
+
The lifecycle release — hooks that act at the seams around a run, and rule capture that
|
|
85
|
+
works everywhere.
|
|
86
|
+
|
|
87
|
+
### Added
|
|
88
|
+
- **Lifecycle action hooks.** gmlw already hooks *content* (the interceptor chain); it now
|
|
89
|
+
hooks *actions* at two seams bracketing the client run. A `[[hooks]]` entry binds a
|
|
90
|
+
`HookPort` spec (a `module:Class` / `/path.py:Class`, or a plugin id) to a `phase` —
|
|
91
|
+
`pre-launch` (after the context is compiled and the caller resolved, before the client
|
|
92
|
+
starts) or `post-session` (after the client exits, with its exit code) — with an optional
|
|
93
|
+
`client` scope, under the same trusted-code boundary as `[[interceptors]]` and `[callers]`.
|
|
94
|
+
Hooks are best-effort: a failing hook never breaks a launch or its teardown. Both launch
|
|
95
|
+
paths (`start`, `workflow new`) route through one `run_with_hooks` sequence. Ships the
|
|
96
|
+
built-in `SessionLogger` as a reference hook.
|
|
97
|
+
- **Always-on rule lifecycle.** Rule capture is no longer workflow-only: the `rules`
|
|
98
|
+
context source (now active by default in a plain start, config-overridable) leads with
|
|
99
|
+
a capture directive so a demanded correction becomes a draft rule in **any** session.
|
|
100
|
+
The directive carries the full loop — offer to record a durable, reusable reflex;
|
|
101
|
+
**dedup** against the existing rules and update/supersede a match instead of stacking a
|
|
102
|
+
near-duplicate; and, when a rule is **mechanically enforceable**, offer to realise it as
|
|
103
|
+
a script or check rather than a standing reminder.
|
|
104
|
+
|
|
105
|
+
### Fixed
|
|
106
|
+
- Docs: removed a stray tool artifact from `docs/CLIENTS.md`; corrected the workflow
|
|
107
|
+
compression default in `docs/CONFIGURATION.md` (every source defaults to
|
|
108
|
+
`compression = false`); documented `[companion] name`. Added a doc-consistency guard
|
|
109
|
+
against leaked tool-artifact tags.
|
|
110
|
+
|
|
111
|
+
## [0.2.0] - 2026-07-16
|
|
112
|
+
|
|
113
|
+
The companion release — everything a session inherits, and the ergonomics around it.
|
|
114
|
+
|
|
115
|
+
### Added
|
|
116
|
+
- **Mode-aware context packaging.** A `[startup.<mode>]` matrix picks which sources
|
|
117
|
+
compose (persona · profile · learned · company · rules · workflow base/steps) for
|
|
118
|
+
each mode (default / workflow / authoring), with typed per-source compression
|
|
119
|
+
(`[compress.prompts]`).
|
|
120
|
+
- **Personas.** Selectable tone with a universal floor (`gmlw persona list`), a free
|
|
121
|
+
local host greeting at launch, and a first-run persona choice — configured under
|
|
122
|
+
`[companion]`.
|
|
123
|
+
- **Learned notebook.** A portable, user-owned notebook (`profile/me/learned.md`) the
|
|
124
|
+
client mirrors into, read into every client so what one learns they all inherit;
|
|
125
|
+
negatives are first-class.
|
|
126
|
+
- **Rule format.** A domain-neutral `Rule / When / Signals / Strength / Origin`
|
|
127
|
+
(+ optional `Precedence`), captured as a draft during a workflow.
|
|
128
|
+
- **Formal plugins folder.** Reference a caller by id (`~/.gmlw/plugins/<id>/` with a
|
|
129
|
+
`plugin.toml`); `gmlw plugins list`.
|
|
130
|
+
- **Cursor allowance block.** The status line renders cursor's plan pools from an
|
|
131
|
+
optional local cache when the client does not pipe them.
|
|
132
|
+
- **First-run init.** Detect installed clients and seed a filled config with a default.
|
|
133
|
+
- **JSON output** for the listing/reporting commands (`--json`).
|
|
134
|
+
- **Ergonomics.** Client and working-directory preflight, implicit `gmlw <job>`
|
|
135
|
+
(shorthand for `start`), a friendly no-job message, and auto-help for an incomplete
|
|
136
|
+
sub-command.
|
|
137
|
+
|
|
138
|
+
### Changed
|
|
139
|
+
- Documentation overhaul: task-oriented guides (`docs/USER_GUIDE.md`, `docs/CLI.md`,
|
|
140
|
+
`docs/CONFIGURATION.md`, `docs/CLIENTS.md`, `docs/WORKFLOWS.md`,
|
|
141
|
+
`docs/TROUBLESHOOTING.md`), a client capability matrix in the README, and `DESIGN.md`
|
|
142
|
+
synchronised with the code; `GOVERNANCE.md` corrected. Supported Python stated as
|
|
143
|
+
3.11–3.14 to match CI.
|
|
144
|
+
|
|
145
|
+
## [0.1.0] - 2026-07-14
|
|
146
|
+
|
|
147
|
+
First public release — a metering wrapper around ML coding CLIs.
|
|
148
|
+
|
|
149
|
+
### Added
|
|
150
|
+
- **Jobs & sessions.** Enter at a **job** you tag; the wrapper mints a named,
|
|
151
|
+
resumable **session** on the client and persists it. `gmlw start`, `jobs`,
|
|
152
|
+
`sessions`, `export`.
|
|
153
|
+
- **Four clients** driven the same way: **claude**, **cursor**, **codex**, **vibe**.
|
|
154
|
+
Which one is config-driven (`[client]`) or `--client`.
|
|
155
|
+
- **Metering relay.** A local, capability-URL-authenticated relay records **per-turn
|
|
156
|
+
tokens and cost** for the metered clients (claude/codex/vibe) into a SQLite ledger;
|
|
157
|
+
`gmlw export` reports per-turn rows, per-model totals, and per-session cost.
|
|
158
|
+
- **Status line** for the clients that host one (claude, cursor): git · folder ·
|
|
159
|
+
model · context% · a client-specific allowance block, plus a per-session and
|
|
160
|
+
per-job usage footer.
|
|
161
|
+
- **Workflows.** Author a small operating context once (`gmlw workflow new`, a warm
|
|
162
|
+
create-workflow interview) and launch a job with it; context is compiled from a
|
|
163
|
+
shared base + your profile + rules + the workflow steps, through an interceptor
|
|
164
|
+
chain (with opt-in context compression via `generic-ml-cache`).
|
|
165
|
+
- **Durable provenance.** The exact compiled context is written per session
|
|
166
|
+
(`contexts/<job>/<session>.context.md`); an **opt-in transcript** keeps each metered
|
|
167
|
+
call's request/response/usage.
|
|
168
|
+
- **Credentials.** Per-workflow secrets stored `0600` and injected into the client's
|
|
169
|
+
environment at launch (`gmlw creds set`).
|
|
170
|
+
- **Storage.** A single SQLite ledger (`~/.gmlw/ledger.db`, WAL) for jobs, sessions,
|
|
171
|
+
per-turn usage, and session costs.
|
|
172
|
+
- **Safety.** Validated `JobId` + filesystem containment under an owner-only `~/.gmlw`;
|
|
173
|
+
never overwriting an unparseable client-settings or credentials file.
|
|
174
|
+
|
|
175
|
+
### Engineering
|
|
176
|
+
- Hexagonal (ports & adapters), enforced by `import-linter`; strict `ruff` + `pyright`
|
|
177
|
+
over `src` and `tests`; `nox` gates mirrored by CI across Python 3.11–3.14; a
|
|
178
|
+
server-side no-AI-attribution check and branch protection.
|
|
179
|
+
|
|
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
|
|
182
|
+
[0.3.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.2.0...v0.3.0
|
|
183
|
+
[0.2.0]: https://github.com/danielslobozian/generic-ml-wrapper/compare/v0.1.0...v0.2.0
|
|
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.
|
|
@@ -133,5 +133,3 @@ same throwaway-`VIBE_HOME` relay path used for metering.
|
|
|
133
133
|
- [CLI.md](CLI.md) — every `gmlw` command.
|
|
134
134
|
- [DESIGN.md](DESIGN.md) — the caller model and metering relay in depth.
|
|
135
135
|
- [../SECURITY.md](../SECURITY.md) — the trust and credential boundary.
|
|
136
|
-
</content>
|
|
137
|
-
</invoke>
|
|
@@ -12,9 +12,9 @@ Related guides: [WORKFLOWS.md](WORKFLOWS.md), [CLIENTS.md](CLIENTS.md),
|
|
|
12
12
|
|
|
13
13
|
## Trusted-code boundary
|
|
14
14
|
|
|
15
|
-
The `[callers]` and `[[
|
|
16
|
-
runs with your permissions** on the next invocation — this file is a
|
|
17
|
-
boundary. Point them only at code you wrote or trust. A configured-but-unloadable spec
|
|
15
|
+
The `[callers]`, `[[interceptors]]`, and `[[hooks]]` sections name Python code that gmlw
|
|
16
|
+
**loads and runs with your permissions** on the next invocation — this file is a
|
|
17
|
+
trusted-code boundary. Point them only at code you wrote or trust. A configured-but-unloadable spec
|
|
18
18
|
fails **loudly** (it does not silently degrade); an absent one is a silent no-op. See
|
|
19
19
|
[SECURITY.md](../SECURITY.md).
|
|
20
20
|
|
|
@@ -93,6 +93,45 @@ target = "response"
|
|
|
93
93
|
spec = "generic_ml_wrapper.adapter.outbound.interceptor.size_logger:MessageSizeLogger"
|
|
94
94
|
```
|
|
95
95
|
|
|
96
|
+
## `[[hooks]]`
|
|
97
|
+
|
|
98
|
+
Zero or more ordered *actions* (`HookPort`) run at a lifecycle seam bracketing the
|
|
99
|
+
client run — where an interceptor transforms content, a hook performs a side effect and
|
|
100
|
+
returns nothing. Declare each as its own `[[hooks]]` array-of-tables entry.
|
|
101
|
+
|
|
102
|
+
| Key | Meaning |
|
|
103
|
+
| --- | --- |
|
|
104
|
+
| `phase` | The lifecycle seam: `pre-launch` \| `post-session` |
|
|
105
|
+
| `spec` | The `"module:Class"` / `"/path.py:Class"` to load, or a plugin id |
|
|
106
|
+
| `client` | *(optional)* scope the hook to one client; omit to run for every client |
|
|
107
|
+
|
|
108
|
+
**`pre-launch`** runs after the context is compiled and the caller resolved, before the
|
|
109
|
+
client starts — it knows the client, working directory, and session. For per-client setup:
|
|
110
|
+
deploying skills/rules into a client's native mechanism, writing MCP config, warming a
|
|
111
|
+
cache. **`post-session`** runs after the client exits — it knows the exit code and the
|
|
112
|
+
session. For cleanup, notification, archival, or roll-up.
|
|
113
|
+
|
|
114
|
+
Hooks are **best-effort**: a failing hook is logged and skipped, never breaking a launch
|
|
115
|
+
or its teardown. A `spec` may be a plugin id (resolved through `~/.gmlw/plugins/<id>/`,
|
|
116
|
+
the same as a `[callers]` reference) or a direct spec. The built-in `SessionLogger`
|
|
117
|
+
appends a line to `~/.gmlw/sessions.log` at each seam — a template to copy for your own.
|
|
118
|
+
|
|
119
|
+
Default: no hooks.
|
|
120
|
+
|
|
121
|
+
> **Trusted code.** Hook specs are loaded and run as you — see the
|
|
122
|
+
> [trusted-code boundary](#trusted-code-boundary).
|
|
123
|
+
|
|
124
|
+
```toml
|
|
125
|
+
[[hooks]]
|
|
126
|
+
phase = "pre-launch"
|
|
127
|
+
spec = "generic_ml_wrapper.adapter.outbound.hook.session_logger:SessionLogger"
|
|
128
|
+
|
|
129
|
+
[[hooks]]
|
|
130
|
+
phase = "post-session"
|
|
131
|
+
spec = "generic_ml_wrapper.adapter.outbound.hook.session_logger:SessionLogger"
|
|
132
|
+
client = "claude" # optional; omit to run for every client
|
|
133
|
+
```
|
|
134
|
+
|
|
96
135
|
## `[startup.<mode>]`
|
|
97
136
|
|
|
98
137
|
On every run gmlw composes an operating context from a fixed set of sources.
|
|
@@ -108,9 +147,13 @@ On every run gmlw composes an operating context from a fixed set of sources.
|
|
|
108
147
|
**Sources:**
|
|
109
148
|
|
|
110
149
|
- `me.user` — `profile/me/*.md`
|
|
111
|
-
- `me.learned` — `profile/me/learned
|
|
112
|
-
|
|
113
|
-
- `
|
|
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`
|
|
114
157
|
- `persona` — the selected persona plus the shared floor (see [`[companion]`](#companion))
|
|
115
158
|
- `base` / `steps` — a workflow run also composes its `base` and `steps`
|
|
116
159
|
|
|
@@ -137,12 +180,14 @@ rules = { activated = false, compression = false }
|
|
|
137
180
|
persona = { activated = false, compression = false }
|
|
138
181
|
```
|
|
139
182
|
|
|
140
|
-
|
|
183
|
+
Every source defaults to `compression = false` — nothing is compressed unless you turn
|
|
184
|
+
it on *and* a prompt resolves (see [`[compress]`](#compress)). For a workflow run you
|
|
185
|
+
might, for example, opt to compress the longer `steps` while leaving `base` verbatim:
|
|
141
186
|
|
|
142
187
|
```toml
|
|
143
188
|
[startup.workflow.context]
|
|
144
189
|
base = { compression = false }
|
|
145
|
-
steps = { compression = true }
|
|
190
|
+
steps = { compression = true } # opt-in; the default is false
|
|
146
191
|
```
|
|
147
192
|
|
|
148
193
|
See [WORKFLOWS.md](WORKFLOWS.md) for how base and steps are compiled.
|
|
@@ -157,6 +202,7 @@ source is `activated` in the relevant `[startup.<mode>]` block above). Off — i
|
|
|
157
202
|
| Key | Meaning | Default |
|
|
158
203
|
| --- | --- | --- |
|
|
159
204
|
| `persona` | Built-in persona or a custom file name | unset (invisible) |
|
|
205
|
+
| `name` | The name the host greeting addresses you by | unset (falls back to the OS user) |
|
|
160
206
|
|
|
161
207
|
Built-in personas: `plain` \| `companion` \| `mentor` \| `butler` \| `terse`. List
|
|
162
208
|
them with `gmlw persona list`. Author your own by dropping a file into
|