lemming-cli 0.9.1__tar.gz → 0.10.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.
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/.github/workflows/ci.yml +5 -5
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/.github/workflows/publish.yml +3 -3
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/.github/workflows/screenshots.yml +3 -3
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/Dockerfile +2 -2
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/PKG-INFO +81 -62
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/README.md +79 -60
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/SKILL.md +42 -31
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/biome.json +37 -2
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/docs/EVALS.md +3 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/docs/HOOKS.md +20 -19
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/docs/WORKSPACE.md +9 -5
- lemming_cli-0.10.0/docs/screenshots/dashboard-desktop.png +0 -0
- lemming_cli-0.10.0/docs/screenshots/dashboard-mobile.png +0 -0
- lemming_cli-0.10.0/docs/screenshots/task-log-desktop.png +0 -0
- lemming_cli-0.10.0/docs/screenshots/task-log-mobile.png +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/package-lock.json +260 -599
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/package.json +5 -6
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/pyproject.toml +2 -2
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/config.py +7 -21
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/config_test.py +2 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/conftest.py +1 -1
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/files.py +1 -1
- lemming_cli-0.10.0/src/lemming/api/loop.py +70 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/loop_test.py +2 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/main.py +27 -1
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/tasks.py +13 -7
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/tasks_test.py +61 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/artifact_test.py +10 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/brief_test.py +42 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/artifact.py +3 -1
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/brief.py +12 -5
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/exec_cli.py +111 -25
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/exec_cli_test.py +377 -15
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/goal.py +6 -6
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/goal_test.py +20 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/machine_output_test.py +2 -2
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/main.py +26 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/operations.py +93 -38
- lemming_cli-0.10.0/src/lemming/cli/operations_test.py +529 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/progress.py +2 -2
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/stop_test.py +5 -6
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/tasks.py +47 -22
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/tasks_test.py +131 -11
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/readability.py +0 -1
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/roadmap.py +0 -6
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/trial.py +10 -14
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/integration_test.py +38 -33
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/main.py +7 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/models.py +47 -3
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/models_test.py +21 -1
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/orchestrator.py +254 -603
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/orchestrator_test.py +517 -289
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/prompts/hooks/50-readability.md +27 -26
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/prompts/hooks/60-testing.md +12 -12
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/prompts/hooks/70-ux.md +6 -6
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/prompts/hooks/90-roadmap.md +41 -41
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/prompts/taskrunner.md +27 -28
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/prompts.py +9 -8
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/prompts_test.py +9 -13
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/runner.py +35 -8
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/runner_test.py +145 -12
- lemming_cli-0.10.0/src/lemming/scope.py +173 -0
- lemming_cli-0.10.0/src/lemming/scope_test.py +215 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/snapshots.py +12 -8
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/snapshots_test.py +57 -2
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/lifecycle.py +140 -257
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/lifecycle_test.py +118 -114
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/operations.py +33 -77
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/operations_test.py +47 -7
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/queries.py +23 -42
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/queries_test.py +3 -3
- lemming_cli-0.10.0/src/lemming/tasks/state_machine.py +330 -0
- lemming_cli-0.10.0/src/lemming/tasks/state_machine_test.py +165 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/dashboard.spec.js +1 -1
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/dashboard.test.js +19 -16
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/favicon.spec.js +3 -3
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/files.html +164 -166
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/index.html +127 -104
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/index.js +16 -15
- lemming_cli-0.10.0/src/lemming/web/logs.html +386 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/logs.test.js +8 -6
- lemming_cli-0.10.0/src/lemming/web/mancha.js +46 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/screenshots.spec.js +1 -1
- lemming_cli-0.10.0/uv.lock +534 -0
- lemming_cli-0.9.1/.prettierignore +0 -13
- lemming_cli-0.9.1/.prettierrc +0 -6
- lemming_cli-0.9.1/docs/screenshots/dashboard-desktop.png +0 -0
- lemming_cli-0.9.1/docs/screenshots/dashboard-mobile.png +0 -0
- lemming_cli-0.9.1/docs/screenshots/task-log-desktop.png +0 -0
- lemming_cli-0.9.1/docs/screenshots/task-log-mobile.png +0 -0
- lemming_cli-0.9.1/src/lemming/api/loop.py +0 -45
- lemming_cli-0.9.1/src/lemming/cli/operations_test.py +0 -205
- lemming_cli-0.9.1/src/lemming/scope.py +0 -173
- lemming_cli-0.9.1/src/lemming/scope_test.py +0 -125
- lemming_cli-0.9.1/src/lemming/web/logs.html +0 -377
- lemming_cli-0.9.1/src/lemming/web/mancha.js +0 -46
- lemming_cli-0.9.1/uv.lock +0 -493
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/.dockerignore +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/.gitignore +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/LICENSE +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/docker-compose.yml +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/playwright.config.js +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/auth.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/auth_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/context.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/context_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/directories.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/directories_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/files_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/hooks.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/hooks_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/logging.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/logging_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/api/main_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/config.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/config_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/hooks.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/hooks_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/main_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/progress_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/readability_cli.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/readability_cli_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/skill.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/cli/skill_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/conftest.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/__main__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/cli.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/cli_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/container.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/container_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/fixtures.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/fixtures_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/harness.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/harness_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/metrics.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/metrics_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/base/README.md +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/base/calc/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/base/calc/legacy.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/base/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/base/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/clean/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/clean/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/dead-code/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/dead-code/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/duplicated-behavior/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/duplicated-behavior/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/false-reuse/calc/limits.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/false-reuse/calc/limits_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/lint-debt/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/readability/lint-debt/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/add-only/README.md +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/add-only/calc/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/add-only/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/add-only/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/buggy-subtract/README.md +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/buggy-subtract/calc/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/buggy-subtract/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/buggy-subtract/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/full-ops/README.md +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/full-ops/calc/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/full-ops/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/full-ops/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/unwired-cli/README.md +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/unwired-cli/calc/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/unwired-cli/calc/cli.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/unwired-cli/calc/cli_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/unwired-cli/calc/ops.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/roadmap/unwired-cli/calc/ops_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/task/hidden/stats/summary_hidden_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/task/summary/README.md +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/task/summary/stats/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/task/summary/stats/summary.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/projects/task/summary/stats/summary_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/readability_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/report.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/report_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/roadmap_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/scenarios.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/scenarios_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/suites.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/task.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/task_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/evals/trial_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/hooks.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/hooks_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/main_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/paths.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/paths_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/persistence.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/persistence_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/providers.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/providers_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/shutdown.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/shutdown_integration_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/shutdown_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/__init__.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/limits.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/progress.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/tasks/progress_test.py +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/favicon.js +0 -0
- {lemming_cli-0.9.1 → lemming_cli-0.10.0}/src/lemming/web/files.spec.js +0 -0
|
@@ -14,20 +14,20 @@ jobs:
|
|
|
14
14
|
runs-on: ubuntu-latest
|
|
15
15
|
|
|
16
16
|
steps:
|
|
17
|
-
- uses: actions/checkout@
|
|
17
|
+
- uses: actions/checkout@v7
|
|
18
18
|
|
|
19
19
|
- name: Set up Python
|
|
20
|
-
uses: astral-sh/setup-uv@
|
|
20
|
+
uses: astral-sh/setup-uv@v10.3.3
|
|
21
21
|
with:
|
|
22
|
-
python-version: '3.
|
|
22
|
+
python-version: '3.15'
|
|
23
23
|
|
|
24
24
|
- name: Install Python dependencies
|
|
25
25
|
run: uv sync --locked
|
|
26
26
|
|
|
27
27
|
- name: Set up Node.js
|
|
28
|
-
uses: actions/setup-node@
|
|
28
|
+
uses: actions/setup-node@v7
|
|
29
29
|
with:
|
|
30
|
-
node-version: '
|
|
30
|
+
node-version: '26'
|
|
31
31
|
|
|
32
32
|
# Before the Python tests: they invoke readability, which runs this.
|
|
33
33
|
- name: Install Node.js dependencies
|
|
@@ -12,12 +12,12 @@ jobs:
|
|
|
12
12
|
id-token: write
|
|
13
13
|
|
|
14
14
|
steps:
|
|
15
|
-
- uses: actions/checkout@
|
|
15
|
+
- uses: actions/checkout@v7
|
|
16
16
|
|
|
17
17
|
- name: Set up Python
|
|
18
|
-
uses: astral-sh/setup-uv@
|
|
18
|
+
uses: astral-sh/setup-uv@v10.3.3
|
|
19
19
|
with:
|
|
20
|
-
python-version: '3.
|
|
20
|
+
python-version: '3.15'
|
|
21
21
|
|
|
22
22
|
- name: Build distribution
|
|
23
23
|
run: uv build
|
|
@@ -21,12 +21,12 @@ jobs:
|
|
|
21
21
|
runs-on: ubuntu-latest
|
|
22
22
|
|
|
23
23
|
steps:
|
|
24
|
-
- uses: actions/checkout@
|
|
24
|
+
- uses: actions/checkout@v7
|
|
25
25
|
|
|
26
26
|
- name: Set up Node.js
|
|
27
|
-
uses: actions/setup-node@
|
|
27
|
+
uses: actions/setup-node@v7
|
|
28
28
|
with:
|
|
29
|
-
node-version: '
|
|
29
|
+
node-version: '26'
|
|
30
30
|
|
|
31
31
|
- name: Install Node.js dependencies
|
|
32
32
|
run: npm ci
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
FROM python:3.
|
|
1
|
+
FROM python:3.15-slim
|
|
2
2
|
|
|
3
3
|
# Install common dev tools
|
|
4
4
|
RUN apt-get update && apt-get install -y \
|
|
@@ -6,7 +6,7 @@ RUN apt-get update && apt-get install -y \
|
|
|
6
6
|
&& rm -rf /var/lib/apt/lists/*
|
|
7
7
|
|
|
8
8
|
# Install Node.js (LTS) and npm
|
|
9
|
-
RUN curl -fsSL https://deb.nodesource.com/
|
|
9
|
+
RUN curl -fsSL https://deb.nodesource.com/setup_26.x | bash - \
|
|
10
10
|
&& apt-get install -y nodejs \
|
|
11
11
|
&& rm -rf /var/lib/apt/lists/*
|
|
12
12
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: lemming-cli
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.10.0
|
|
4
4
|
Summary: An autonomous, iterative task runner for AI coding agents.
|
|
5
5
|
Project-URL: Homepage, https://github.com/owahltinez/lemming
|
|
6
6
|
Project-URL: Repository, https://github.com/owahltinez/lemming
|
|
@@ -14,7 +14,7 @@ Requires-Dist: click>=8.0.0
|
|
|
14
14
|
Requires-Dist: fastapi>=0.124.4
|
|
15
15
|
Requires-Dist: pydantic>=2.12.5
|
|
16
16
|
Requires-Dist: pyyaml>=6.0.3
|
|
17
|
-
Requires-Dist: readability-cli>=0.
|
|
17
|
+
Requires-Dist: readability-cli>=0.11.1
|
|
18
18
|
Requires-Dist: uvicorn>=0.33.0
|
|
19
19
|
Description-Content-Type: text/markdown
|
|
20
20
|
|
|
@@ -95,7 +95,7 @@ Start the autonomous loop.
|
|
|
95
95
|
# claude, or codex)
|
|
96
96
|
lemming run
|
|
97
97
|
|
|
98
|
-
#
|
|
98
|
+
# Arguments after -- are sent directly to the underlying runner
|
|
99
99
|
lemming run -- --model claude-3-5-sonnet
|
|
100
100
|
```
|
|
101
101
|
|
|
@@ -123,11 +123,11 @@ lemming exec "Fix the flaky test in runner_test.py" --retries 3
|
|
|
123
123
|
cat handoff.md | lemming -v exec -f - --runner agy
|
|
124
124
|
```
|
|
125
125
|
|
|
126
|
-
The runner receives no conversation history and cannot be steered mid-run.
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
126
|
+
The runner receives no conversation history and cannot be steered mid-run. Make
|
|
127
|
+
the handoff self-contained: state the goal, hard constraints, relevant findings
|
|
128
|
+
and evidence, approaches ruled out and why, and the definition of done and
|
|
129
|
+
verification. The installed skill includes a complete here-document example for
|
|
130
|
+
orchestrating agents.
|
|
131
131
|
|
|
132
132
|
With no description there is nothing for a task runner to do, so only the
|
|
133
133
|
reviews run — against work that already exists.
|
|
@@ -136,25 +136,32 @@ reviews run — against work that already exists.
|
|
|
136
136
|
# Review uncommitted work before opening a pull request
|
|
137
137
|
lemming exec --review readability
|
|
138
138
|
|
|
139
|
-
# Review
|
|
140
|
-
lemming
|
|
139
|
+
# Review specific paths, or globs the shell should leave alone
|
|
140
|
+
lemming exec --review readability --scope src/api --scope 'src/**/*.ts'
|
|
141
|
+
|
|
142
|
+
# Review what a branch changed, with paths on stdin
|
|
143
|
+
git diff -z --name-only --relative --diff-filter=d main... |
|
|
144
|
+
lemming exec --review testing --scope -
|
|
141
145
|
|
|
142
146
|
# Do the work, then gate it
|
|
143
147
|
lemming exec "Add pagination to the tasks API" --review '*'
|
|
144
148
|
```
|
|
145
149
|
|
|
146
|
-
`--scope` takes
|
|
147
|
-
|
|
148
|
-
|
|
150
|
+
`--scope` takes a path or glob, and each must match something; repeat it for
|
|
151
|
+
several, or pass `-` to read them from stdin. It only applies with `--review`
|
|
152
|
+
and is an error with a description: a task's reviews look at what the task
|
|
153
|
+
changed. Without `--scope`, reviews cover uncommitted work, or the whole tree
|
|
154
|
+
outside a git repository; a clean tree reviews nothing. Arguments for the agent
|
|
155
|
+
CLI go after `--`.
|
|
149
156
|
|
|
150
157
|
Reviews may edit the working directory. The built-in readability review
|
|
151
|
-
intentionally applies fixes, and testing may repair production code or tests.
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
+
intentionally applies fixes, and testing may repair production code or tests. UX
|
|
159
|
+
is instructed to remain advisory, but its prompt and `--no-yolo` do not enforce
|
|
160
|
+
filesystem isolation. A global review override may perform any actions its
|
|
161
|
+
prompt requests. There is no read-only review mode: runners keep write access,
|
|
162
|
+
so a prompt-only flag could not be enforced. When isolation is required, follow
|
|
163
|
+
the working-copy guidance below and pass a separate VCS-managed working copy
|
|
164
|
+
with `lemming -C <working-copy> exec --review ...`.
|
|
158
165
|
|
|
159
166
|
Each run is self-contained: nothing is read from the project's roadmap or its
|
|
160
167
|
local hooks, it runs only the requested task and reviews, and its state
|
|
@@ -164,9 +171,8 @@ printed, so the log can be read. Kept directories live in
|
|
|
164
171
|
recent failure is always still there to inspect. Stdout carries the agent's
|
|
165
172
|
message alone and everything else goes to stderr, so the output can be consumed
|
|
166
173
|
directly. Stderr reports the ephemeral tasks file and task ID at startup; pass
|
|
167
|
-
those to
|
|
168
|
-
|
|
169
|
-
run. Use the global verbose flag (`lemming -v exec ...`) to stream runner
|
|
174
|
+
those to `lemming --tasks-file <path> status <id>` or `logs <id>` to inspect an
|
|
175
|
+
active run. Use the global verbose flag (`lemming -v exec ...`) to stream runner
|
|
170
176
|
activity.
|
|
171
177
|
|
|
172
178
|
Note that the agent runs unattended (`--yolo` by default), so it does not
|
|
@@ -206,8 +212,7 @@ lemming skill status
|
|
|
206
212
|
|
|
207
213
|
`lemming skill uninstall` reverses the default installation sweep. Both refuse
|
|
208
214
|
to touch a directory that does not hold this skill, so a mistyped `--to` fails
|
|
209
|
-
instead of deleting work.
|
|
210
|
-
package upgrades without reinstalling.
|
|
215
|
+
instead of deleting work.
|
|
211
216
|
|
|
212
217
|
---
|
|
213
218
|
|
|
@@ -250,14 +255,14 @@ loops through each pending task:
|
|
|
250
255
|
with `lemming add`, breaking down complex work into smaller steps that
|
|
251
256
|
Lemming will pick up automatically.
|
|
252
257
|
4. **Retry or advance**: On failure, timeout, or cancellation, Lemming saves
|
|
253
|
-
the discarded workspace diff as an `attempt-<N>.patch` artifact
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
to the next task.
|
|
258
|
+
the discarded workspace diff as an `attempt-<N>.patch` artifact (a repeated
|
|
259
|
+
number gets `-2`, `-3`, ... rather than overwriting), restores the working
|
|
260
|
+
tree to the task's pre-run snapshot, and retries up to the configured limit
|
|
261
|
+
with accumulated progress as context. On success, it moves to the next task.
|
|
257
262
|
5. **Orchestration**: After each task, Lemming can run one or more
|
|
258
263
|
**Orchestrator Hooks** (like the built-in `roadmap` hook) to evaluate the
|
|
259
|
-
results and adapt the roadmap if needed.
|
|
260
|
-
|
|
264
|
+
results and adapt the roadmap if needed. Only `roadmap` runs by default;
|
|
265
|
+
reviews are opt-in.
|
|
261
266
|
|
|
262
267
|
---
|
|
263
268
|
|
|
@@ -385,35 +390,39 @@ These come before the subcommand and apply to all of them.
|
|
|
385
390
|
- `--json`: Emit machine-readable JSON instead of formatted text, so scripts
|
|
386
391
|
never have to parse the internal state file.
|
|
387
392
|
- `--brief`: Omit task descriptions, which otherwise dominate the output.
|
|
393
|
+
- A task is `pending`, then `running`; once its agent finishes it is
|
|
394
|
+
`completing` or `failing` while hooks review it, and it ends `completed`,
|
|
395
|
+
`failed`, `cancelled`, or `superseded`.
|
|
396
|
+
- An active task with no loop running is flagged as abandoned;
|
|
397
|
+
`lemming run --detach` reclaims it. If its runner outlived the loop,
|
|
398
|
+
`status` names the runner's pid to kill first, and `run` refuses to start a
|
|
399
|
+
second runner until it is gone.
|
|
388
400
|
- **`goal [<text>]`**: Set or view the long-term goal shared by all tasks.
|
|
389
401
|
Supports `-f/--file`.
|
|
390
402
|
- **`add <desc>`**: Append a new task. Supports `--index`, `--runner`,
|
|
391
403
|
`--model`, `--oneshot`, and `--hooks` (the task's reviews, comma-separated;
|
|
392
404
|
inherited from `--parent` when omitted).
|
|
393
|
-
- **`edit <id>`**: Modify a task's description, runner, model, position,
|
|
394
|
-
|
|
395
|
-
|
|
405
|
+
- **`edit <id>`**: Modify a task's description, runner, model, position, oneshot
|
|
406
|
+
flag (`--oneshot/--no-oneshot`), or reviews (`--hooks`; `--project-hooks`
|
|
407
|
+
restores the project's).
|
|
396
408
|
- **`brief <id> [text]`**: View or set a task's long-form brief. Unlike the
|
|
397
409
|
description it has no length cap, and it is appended to the runner prompt
|
|
398
410
|
automatically — the right home for measured timings, exact failing selectors,
|
|
399
411
|
or why a previous attempt was wrong. Supports `-f/--file`.
|
|
400
|
-
- **`artifact <id> [name] [text]`**: Store or read a task's verbose
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
412
|
+
- **`artifact <id> [name] [text]`**: Store or read a task's verbose diagnostics
|
|
413
|
+
— stack traces, test dumps, long logs — outside `tasks.yml`, so they never
|
|
414
|
+
bloat the prompts of later attempts. With no name it lists what the task has
|
|
415
|
+
stored; with `--note` it also records the one-line progress pointer for you.
|
|
416
|
+
Later attempts see the artifact names in their prompt automatically. Supports
|
|
417
|
+
`-f/--file`.
|
|
406
418
|
- **`delete <id>`**: Remove an unstarted task while retaining its runner log;
|
|
407
419
|
its artifacts go with it. Tasks with execution history require `--force`;
|
|
408
420
|
autonomous restructuring should use `supersede`. Supports `--all` and
|
|
409
421
|
`--completed` for bulk cleanup, including logs.
|
|
410
422
|
- **`supersede <id> --reason <text>`**: Retire a replaced or split task without
|
|
411
423
|
losing its progress, timings, log, or links to replacement tasks.
|
|
412
|
-
- **`progress`**:
|
|
413
|
-
|
|
414
|
-
- `add <id> <finding>`: Record a new technical detail.
|
|
415
|
-
- `edit <id> <index> <text>`: Modify an existing progress entry.
|
|
416
|
-
- `delete <id> <index>`: Remove a progress entry.
|
|
424
|
+
- **`progress <id> [text]`**: Record a progress entry or finding for a task;
|
|
425
|
+
`status <id>` lists them. Supports `-f/--file`.
|
|
417
426
|
- **`config`**: Manage project configuration (runner, model, retries, time
|
|
418
427
|
limit).
|
|
419
428
|
- `list`: View current configuration.
|
|
@@ -427,20 +436,22 @@ These come before the subcommand and apply to all of them.
|
|
|
427
436
|
[readability](https://github.com/owahltinez/readability) package. Ruff and
|
|
428
437
|
Pyrefly run with bundled Google-style defaults unless the target project
|
|
429
438
|
defines its own configuration.
|
|
430
|
-
- `check <paths>...`: Run formatters and linters
|
|
439
|
+
- `check <paths>...`: Run formatters and linters; exits non-zero on any
|
|
440
|
+
finding. `--fix` applies safe fixes, `--unsafe` also behavior-changing ones.
|
|
431
441
|
- `guide <language>`: Fetch and view style guides.
|
|
432
|
-
- `
|
|
433
|
-
- `sync`: Synchronize style guides from the web.
|
|
442
|
+
- `sync`: Refetch style guides from the web.
|
|
434
443
|
|
|
435
444
|
### Task Status
|
|
436
445
|
|
|
437
|
-
- **`complete <id>`**: Mark a task as successful.
|
|
446
|
+
- **`complete <id>`**: Mark a task as successful; requires recorded progress.
|
|
447
|
+
`--force` finalizes an in-progress task at once, without running hooks.
|
|
448
|
+
- **`uncomplete <id>`**: Move a completed task back to pending.
|
|
438
449
|
- **`fail <id>`**: Mark a task as a terminal failure (will not be retried).
|
|
439
450
|
- **`reject <id> <reason>`**: Reject a finalizing task's completion from a
|
|
440
451
|
review hook, sending it back for a retry.
|
|
441
|
-
- **`cancel <id>`**:
|
|
442
|
-
|
|
443
|
-
- **`reset <id>`**: Clear attempts and
|
|
452
|
+
- **`cancel <id>`**: Cancel a pending or in-progress task (an active one's
|
|
453
|
+
runner is killed and its pre-run workspace snapshot restored).
|
|
454
|
+
- **`reset <id>`**: Clear attempts, progress, and logs to start a task fresh.
|
|
444
455
|
- **`diff [<id>]`**: Print the workspace diff captured for a task (defaults to
|
|
445
456
|
the active or most recent snapshotted task).
|
|
446
457
|
- `--stat`: Show diffstat summary instead of the full patch.
|
|
@@ -467,15 +478,20 @@ These come before the subcommand and apply to all of them.
|
|
|
467
478
|
- `--env`: Set environment variables for the runner (e.g., `--env KEY=VALUE`).
|
|
468
479
|
- `--no-defaults`: Skip default flag injection for known runners.
|
|
469
480
|
- `--until <task-id>`: Stop between tasks once that task has completed or
|
|
470
|
-
failed, printing `Reached milestone <id>; M pending.` so a supervising
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
481
|
+
failed, printing `Reached milestone <id>; M pending.` so a supervising agent
|
|
482
|
+
can review before queueing the next milestone. Tasks inserted ahead of it
|
|
483
|
+
still run; if the roadmap hook supersedes it, the run continues until every
|
|
484
|
+
replacement has settled. Deleting it stops the run with exit 1.
|
|
474
485
|
- `--max-tasks N`: Stop between tasks once `N` have completed or failed,
|
|
475
486
|
printing `Stopped after N tasks; M pending.` Attempts that leave a task
|
|
476
487
|
pending do not count. Combine with `--until` as a budget cap.
|
|
477
|
-
-
|
|
478
|
-
|
|
488
|
+
- `--detach`: Start the loop in its own session and return, printing its PID
|
|
489
|
+
and log file (`loop.log` in the project's state directory; one over 1 MB
|
|
490
|
+
moves to `loop.log.1` first). The loop outlives the shell or agent harness
|
|
491
|
+
that started it; check on it with `status --brief` and end it with `stop`.
|
|
492
|
+
- `--`: Arguments after `--` go directly to the underlying runner; any other
|
|
493
|
+
extra argument is an error. A per-task `--runner`/`--model` overrides
|
|
494
|
+
anything passed here.
|
|
479
495
|
- **`exec [<description>]`**: Run one task, or one set of reviews, outside any
|
|
480
496
|
roadmap. Prints the agent's closing message to stdout and everything else to
|
|
481
497
|
stderr, including its tasks file and task ID at startup. Use
|
|
@@ -487,9 +503,11 @@ These come before the subcommand and apply to all of them.
|
|
|
487
503
|
repeated; `'*'` selects every one. With no description, only the reviews
|
|
488
504
|
run. Reviews may edit the working directory. Hooks that revise the roadmap
|
|
489
505
|
cannot be selected.
|
|
490
|
-
- `--scope <path
|
|
491
|
-
|
|
492
|
-
|
|
506
|
+
- `--scope <path>`: With `--review` and no description, a path or glob to
|
|
507
|
+
review instead of uncommitted work; an error with a description. Each must
|
|
508
|
+
match something. Repeat it for several, or pass `-` to read them from stdin:
|
|
509
|
+
NUL-separated if it holds any NUL, as from `git diff -z`, or else one per
|
|
510
|
+
line.
|
|
493
511
|
- `--runner`, `--model`: Which agent CLI and model to use.
|
|
494
512
|
- `--retries`: Maximum total task-runner attempts, including the first
|
|
495
513
|
(default 1). Does not retry review-only runs.
|
|
@@ -497,11 +515,12 @@ These come before the subcommand and apply to all of them.
|
|
|
497
515
|
limit).
|
|
498
516
|
- `--yolo/--no-yolo`: Run the agent unattended (default: True).
|
|
499
517
|
- `--keep`: Keep the run's state directory even when it succeeds.
|
|
518
|
+
- `--`: Everything after it goes to the agent CLI; any other extra argument is
|
|
519
|
+
an error.
|
|
500
520
|
- **`skill install`**: Install the packaged Agent Skill so agents discover
|
|
501
521
|
Lemming. Writes to `~/.agents/skills` and every detected tool-specific
|
|
502
522
|
directory by default. Re-running it refreshes existing Lemming copies.
|
|
503
523
|
- `--to <dir>`: Install into a specific skills directory.
|
|
504
|
-
- `--link`: Symlink instead of copying, so upgrades take effect immediately.
|
|
505
524
|
- `--dry-run`: Print what would happen, refusals included.
|
|
506
525
|
- **`skill uninstall`**: Remove it again. Supports `--to` and `--dry-run`.
|
|
507
526
|
- **`skill status`**: Show every supported location and installation state.
|
|
@@ -75,7 +75,7 @@ Start the autonomous loop.
|
|
|
75
75
|
# claude, or codex)
|
|
76
76
|
lemming run
|
|
77
77
|
|
|
78
|
-
#
|
|
78
|
+
# Arguments after -- are sent directly to the underlying runner
|
|
79
79
|
lemming run -- --model claude-3-5-sonnet
|
|
80
80
|
```
|
|
81
81
|
|
|
@@ -103,11 +103,11 @@ lemming exec "Fix the flaky test in runner_test.py" --retries 3
|
|
|
103
103
|
cat handoff.md | lemming -v exec -f - --runner agy
|
|
104
104
|
```
|
|
105
105
|
|
|
106
|
-
The runner receives no conversation history and cannot be steered mid-run.
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
106
|
+
The runner receives no conversation history and cannot be steered mid-run. Make
|
|
107
|
+
the handoff self-contained: state the goal, hard constraints, relevant findings
|
|
108
|
+
and evidence, approaches ruled out and why, and the definition of done and
|
|
109
|
+
verification. The installed skill includes a complete here-document example for
|
|
110
|
+
orchestrating agents.
|
|
111
111
|
|
|
112
112
|
With no description there is nothing for a task runner to do, so only the
|
|
113
113
|
reviews run — against work that already exists.
|
|
@@ -116,25 +116,32 @@ reviews run — against work that already exists.
|
|
|
116
116
|
# Review uncommitted work before opening a pull request
|
|
117
117
|
lemming exec --review readability
|
|
118
118
|
|
|
119
|
-
# Review
|
|
120
|
-
lemming
|
|
119
|
+
# Review specific paths, or globs the shell should leave alone
|
|
120
|
+
lemming exec --review readability --scope src/api --scope 'src/**/*.ts'
|
|
121
|
+
|
|
122
|
+
# Review what a branch changed, with paths on stdin
|
|
123
|
+
git diff -z --name-only --relative --diff-filter=d main... |
|
|
124
|
+
lemming exec --review testing --scope -
|
|
121
125
|
|
|
122
126
|
# Do the work, then gate it
|
|
123
127
|
lemming exec "Add pagination to the tasks API" --review '*'
|
|
124
128
|
```
|
|
125
129
|
|
|
126
|
-
`--scope` takes
|
|
127
|
-
|
|
128
|
-
|
|
130
|
+
`--scope` takes a path or glob, and each must match something; repeat it for
|
|
131
|
+
several, or pass `-` to read them from stdin. It only applies with `--review`
|
|
132
|
+
and is an error with a description: a task's reviews look at what the task
|
|
133
|
+
changed. Without `--scope`, reviews cover uncommitted work, or the whole tree
|
|
134
|
+
outside a git repository; a clean tree reviews nothing. Arguments for the agent
|
|
135
|
+
CLI go after `--`.
|
|
129
136
|
|
|
130
137
|
Reviews may edit the working directory. The built-in readability review
|
|
131
|
-
intentionally applies fixes, and testing may repair production code or tests.
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
+
intentionally applies fixes, and testing may repair production code or tests. UX
|
|
139
|
+
is instructed to remain advisory, but its prompt and `--no-yolo` do not enforce
|
|
140
|
+
filesystem isolation. A global review override may perform any actions its
|
|
141
|
+
prompt requests. There is no read-only review mode: runners keep write access,
|
|
142
|
+
so a prompt-only flag could not be enforced. When isolation is required, follow
|
|
143
|
+
the working-copy guidance below and pass a separate VCS-managed working copy
|
|
144
|
+
with `lemming -C <working-copy> exec --review ...`.
|
|
138
145
|
|
|
139
146
|
Each run is self-contained: nothing is read from the project's roadmap or its
|
|
140
147
|
local hooks, it runs only the requested task and reviews, and its state
|
|
@@ -144,9 +151,8 @@ printed, so the log can be read. Kept directories live in
|
|
|
144
151
|
recent failure is always still there to inspect. Stdout carries the agent's
|
|
145
152
|
message alone and everything else goes to stderr, so the output can be consumed
|
|
146
153
|
directly. Stderr reports the ephemeral tasks file and task ID at startup; pass
|
|
147
|
-
those to
|
|
148
|
-
|
|
149
|
-
run. Use the global verbose flag (`lemming -v exec ...`) to stream runner
|
|
154
|
+
those to `lemming --tasks-file <path> status <id>` or `logs <id>` to inspect an
|
|
155
|
+
active run. Use the global verbose flag (`lemming -v exec ...`) to stream runner
|
|
150
156
|
activity.
|
|
151
157
|
|
|
152
158
|
Note that the agent runs unattended (`--yolo` by default), so it does not
|
|
@@ -186,8 +192,7 @@ lemming skill status
|
|
|
186
192
|
|
|
187
193
|
`lemming skill uninstall` reverses the default installation sweep. Both refuse
|
|
188
194
|
to touch a directory that does not hold this skill, so a mistyped `--to` fails
|
|
189
|
-
instead of deleting work.
|
|
190
|
-
package upgrades without reinstalling.
|
|
195
|
+
instead of deleting work.
|
|
191
196
|
|
|
192
197
|
---
|
|
193
198
|
|
|
@@ -230,14 +235,14 @@ loops through each pending task:
|
|
|
230
235
|
with `lemming add`, breaking down complex work into smaller steps that
|
|
231
236
|
Lemming will pick up automatically.
|
|
232
237
|
4. **Retry or advance**: On failure, timeout, or cancellation, Lemming saves
|
|
233
|
-
the discarded workspace diff as an `attempt-<N>.patch` artifact
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
to the next task.
|
|
238
|
+
the discarded workspace diff as an `attempt-<N>.patch` artifact (a repeated
|
|
239
|
+
number gets `-2`, `-3`, ... rather than overwriting), restores the working
|
|
240
|
+
tree to the task's pre-run snapshot, and retries up to the configured limit
|
|
241
|
+
with accumulated progress as context. On success, it moves to the next task.
|
|
237
242
|
5. **Orchestration**: After each task, Lemming can run one or more
|
|
238
243
|
**Orchestrator Hooks** (like the built-in `roadmap` hook) to evaluate the
|
|
239
|
-
results and adapt the roadmap if needed.
|
|
240
|
-
|
|
244
|
+
results and adapt the roadmap if needed. Only `roadmap` runs by default;
|
|
245
|
+
reviews are opt-in.
|
|
241
246
|
|
|
242
247
|
---
|
|
243
248
|
|
|
@@ -365,35 +370,39 @@ These come before the subcommand and apply to all of them.
|
|
|
365
370
|
- `--json`: Emit machine-readable JSON instead of formatted text, so scripts
|
|
366
371
|
never have to parse the internal state file.
|
|
367
372
|
- `--brief`: Omit task descriptions, which otherwise dominate the output.
|
|
373
|
+
- A task is `pending`, then `running`; once its agent finishes it is
|
|
374
|
+
`completing` or `failing` while hooks review it, and it ends `completed`,
|
|
375
|
+
`failed`, `cancelled`, or `superseded`.
|
|
376
|
+
- An active task with no loop running is flagged as abandoned;
|
|
377
|
+
`lemming run --detach` reclaims it. If its runner outlived the loop,
|
|
378
|
+
`status` names the runner's pid to kill first, and `run` refuses to start a
|
|
379
|
+
second runner until it is gone.
|
|
368
380
|
- **`goal [<text>]`**: Set or view the long-term goal shared by all tasks.
|
|
369
381
|
Supports `-f/--file`.
|
|
370
382
|
- **`add <desc>`**: Append a new task. Supports `--index`, `--runner`,
|
|
371
383
|
`--model`, `--oneshot`, and `--hooks` (the task's reviews, comma-separated;
|
|
372
384
|
inherited from `--parent` when omitted).
|
|
373
|
-
- **`edit <id>`**: Modify a task's description, runner, model, position,
|
|
374
|
-
|
|
375
|
-
|
|
385
|
+
- **`edit <id>`**: Modify a task's description, runner, model, position, oneshot
|
|
386
|
+
flag (`--oneshot/--no-oneshot`), or reviews (`--hooks`; `--project-hooks`
|
|
387
|
+
restores the project's).
|
|
376
388
|
- **`brief <id> [text]`**: View or set a task's long-form brief. Unlike the
|
|
377
389
|
description it has no length cap, and it is appended to the runner prompt
|
|
378
390
|
automatically — the right home for measured timings, exact failing selectors,
|
|
379
391
|
or why a previous attempt was wrong. Supports `-f/--file`.
|
|
380
|
-
- **`artifact <id> [name] [text]`**: Store or read a task's verbose
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
392
|
+
- **`artifact <id> [name] [text]`**: Store or read a task's verbose diagnostics
|
|
393
|
+
— stack traces, test dumps, long logs — outside `tasks.yml`, so they never
|
|
394
|
+
bloat the prompts of later attempts. With no name it lists what the task has
|
|
395
|
+
stored; with `--note` it also records the one-line progress pointer for you.
|
|
396
|
+
Later attempts see the artifact names in their prompt automatically. Supports
|
|
397
|
+
`-f/--file`.
|
|
386
398
|
- **`delete <id>`**: Remove an unstarted task while retaining its runner log;
|
|
387
399
|
its artifacts go with it. Tasks with execution history require `--force`;
|
|
388
400
|
autonomous restructuring should use `supersede`. Supports `--all` and
|
|
389
401
|
`--completed` for bulk cleanup, including logs.
|
|
390
402
|
- **`supersede <id> --reason <text>`**: Retire a replaced or split task without
|
|
391
403
|
losing its progress, timings, log, or links to replacement tasks.
|
|
392
|
-
- **`progress`**:
|
|
393
|
-
|
|
394
|
-
- `add <id> <finding>`: Record a new technical detail.
|
|
395
|
-
- `edit <id> <index> <text>`: Modify an existing progress entry.
|
|
396
|
-
- `delete <id> <index>`: Remove a progress entry.
|
|
404
|
+
- **`progress <id> [text]`**: Record a progress entry or finding for a task;
|
|
405
|
+
`status <id>` lists them. Supports `-f/--file`.
|
|
397
406
|
- **`config`**: Manage project configuration (runner, model, retries, time
|
|
398
407
|
limit).
|
|
399
408
|
- `list`: View current configuration.
|
|
@@ -407,20 +416,22 @@ These come before the subcommand and apply to all of them.
|
|
|
407
416
|
[readability](https://github.com/owahltinez/readability) package. Ruff and
|
|
408
417
|
Pyrefly run with bundled Google-style defaults unless the target project
|
|
409
418
|
defines its own configuration.
|
|
410
|
-
- `check <paths>...`: Run formatters and linters
|
|
419
|
+
- `check <paths>...`: Run formatters and linters; exits non-zero on any
|
|
420
|
+
finding. `--fix` applies safe fixes, `--unsafe` also behavior-changing ones.
|
|
411
421
|
- `guide <language>`: Fetch and view style guides.
|
|
412
|
-
- `
|
|
413
|
-
- `sync`: Synchronize style guides from the web.
|
|
422
|
+
- `sync`: Refetch style guides from the web.
|
|
414
423
|
|
|
415
424
|
### Task Status
|
|
416
425
|
|
|
417
|
-
- **`complete <id>`**: Mark a task as successful.
|
|
426
|
+
- **`complete <id>`**: Mark a task as successful; requires recorded progress.
|
|
427
|
+
`--force` finalizes an in-progress task at once, without running hooks.
|
|
428
|
+
- **`uncomplete <id>`**: Move a completed task back to pending.
|
|
418
429
|
- **`fail <id>`**: Mark a task as a terminal failure (will not be retried).
|
|
419
430
|
- **`reject <id> <reason>`**: Reject a finalizing task's completion from a
|
|
420
431
|
review hook, sending it back for a retry.
|
|
421
|
-
- **`cancel <id>`**:
|
|
422
|
-
|
|
423
|
-
- **`reset <id>`**: Clear attempts and
|
|
432
|
+
- **`cancel <id>`**: Cancel a pending or in-progress task (an active one's
|
|
433
|
+
runner is killed and its pre-run workspace snapshot restored).
|
|
434
|
+
- **`reset <id>`**: Clear attempts, progress, and logs to start a task fresh.
|
|
424
435
|
- **`diff [<id>]`**: Print the workspace diff captured for a task (defaults to
|
|
425
436
|
the active or most recent snapshotted task).
|
|
426
437
|
- `--stat`: Show diffstat summary instead of the full patch.
|
|
@@ -447,15 +458,20 @@ These come before the subcommand and apply to all of them.
|
|
|
447
458
|
- `--env`: Set environment variables for the runner (e.g., `--env KEY=VALUE`).
|
|
448
459
|
- `--no-defaults`: Skip default flag injection for known runners.
|
|
449
460
|
- `--until <task-id>`: Stop between tasks once that task has completed or
|
|
450
|
-
failed, printing `Reached milestone <id>; M pending.` so a supervising
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
461
|
+
failed, printing `Reached milestone <id>; M pending.` so a supervising agent
|
|
462
|
+
can review before queueing the next milestone. Tasks inserted ahead of it
|
|
463
|
+
still run; if the roadmap hook supersedes it, the run continues until every
|
|
464
|
+
replacement has settled. Deleting it stops the run with exit 1.
|
|
454
465
|
- `--max-tasks N`: Stop between tasks once `N` have completed or failed,
|
|
455
466
|
printing `Stopped after N tasks; M pending.` Attempts that leave a task
|
|
456
467
|
pending do not count. Combine with `--until` as a budget cap.
|
|
457
|
-
-
|
|
458
|
-
|
|
468
|
+
- `--detach`: Start the loop in its own session and return, printing its PID
|
|
469
|
+
and log file (`loop.log` in the project's state directory; one over 1 MB
|
|
470
|
+
moves to `loop.log.1` first). The loop outlives the shell or agent harness
|
|
471
|
+
that started it; check on it with `status --brief` and end it with `stop`.
|
|
472
|
+
- `--`: Arguments after `--` go directly to the underlying runner; any other
|
|
473
|
+
extra argument is an error. A per-task `--runner`/`--model` overrides
|
|
474
|
+
anything passed here.
|
|
459
475
|
- **`exec [<description>]`**: Run one task, or one set of reviews, outside any
|
|
460
476
|
roadmap. Prints the agent's closing message to stdout and everything else to
|
|
461
477
|
stderr, including its tasks file and task ID at startup. Use
|
|
@@ -467,9 +483,11 @@ These come before the subcommand and apply to all of them.
|
|
|
467
483
|
repeated; `'*'` selects every one. With no description, only the reviews
|
|
468
484
|
run. Reviews may edit the working directory. Hooks that revise the roadmap
|
|
469
485
|
cannot be selected.
|
|
470
|
-
- `--scope <path
|
|
471
|
-
|
|
472
|
-
|
|
486
|
+
- `--scope <path>`: With `--review` and no description, a path or glob to
|
|
487
|
+
review instead of uncommitted work; an error with a description. Each must
|
|
488
|
+
match something. Repeat it for several, or pass `-` to read them from stdin:
|
|
489
|
+
NUL-separated if it holds any NUL, as from `git diff -z`, or else one per
|
|
490
|
+
line.
|
|
473
491
|
- `--runner`, `--model`: Which agent CLI and model to use.
|
|
474
492
|
- `--retries`: Maximum total task-runner attempts, including the first
|
|
475
493
|
(default 1). Does not retry review-only runs.
|
|
@@ -477,11 +495,12 @@ These come before the subcommand and apply to all of them.
|
|
|
477
495
|
limit).
|
|
478
496
|
- `--yolo/--no-yolo`: Run the agent unattended (default: True).
|
|
479
497
|
- `--keep`: Keep the run's state directory even when it succeeds.
|
|
498
|
+
- `--`: Everything after it goes to the agent CLI; any other extra argument is
|
|
499
|
+
an error.
|
|
480
500
|
- **`skill install`**: Install the packaged Agent Skill so agents discover
|
|
481
501
|
Lemming. Writes to `~/.agents/skills` and every detected tool-specific
|
|
482
502
|
directory by default. Re-running it refreshes existing Lemming copies.
|
|
483
503
|
- `--to <dir>`: Install into a specific skills directory.
|
|
484
|
-
- `--link`: Symlink instead of copying, so upgrades take effect immediately.
|
|
485
504
|
- `--dry-run`: Print what would happen, refusals included.
|
|
486
505
|
- **`skill uninstall`**: Remove it again. Supports `--to` and `--dry-run`.
|
|
487
506
|
- **`skill status`**: Show every supported location and installation state.
|