issue-flow 0.7.0__tar.gz → 0.8.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. {issue_flow-0.7.0 → issue_flow-0.8.0}/PKG-INFO +7 -5
  2. {issue_flow-0.7.0 → issue_flow-0.8.0}/README.md +6 -4
  3. {issue_flow-0.7.0 → issue_flow-0.8.0}/pyproject.toml +1 -1
  4. {issue_flow-0.7.0 → issue_flow-0.8.0}/pyproject.toml.orig +1 -1
  5. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/agent.py +50 -1
  6. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/cli.py +200 -1
  7. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/config.py +16 -0
  8. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/config_ops.py +1 -0
  9. issue_flow-0.8.0/src/issue_flow/hooks.py +250 -0
  10. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/init.py +24 -1
  11. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/modes.py +29 -0
  12. issue_flow-0.8.0/src/issue_flow/skill_lint.py +207 -0
  13. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/docs/issue-workflow.md.j2 +1 -0
  14. issue_flow-0.8.0/src/issue_flow/templates/hooks/pre-commit.sh.j2 +19 -0
  15. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/rules/_body.md.j2 +11 -1
  16. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_essential_tests_close_sanity.md.j2 +2 -2
  17. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_essential_tests_review.md.j2 +1 -1
  18. issue_flow-0.8.0/src/issue_flow/templates/skills/_gh_body_file_short.md.j2 +1 -0
  19. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_model_directive.md.j2 +29 -22
  20. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_noob_next.md.j2 +3 -3
  21. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_worktree_start.md.j2 +6 -6
  22. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/caveman/SKILL.md.j2 +3 -3
  23. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/grill_me/SKILL.md.j2 +1 -1
  24. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_build/SKILL.md.j2 +15 -18
  25. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_cleanup/SKILL.md.j2 +9 -8
  26. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_cleanup/archive.md.j2 +4 -4
  27. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_cleanup/github.md.j2 +1 -1
  28. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_cleanup/prs.md.j2 +2 -2
  29. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_cleanup/workspace.md.j2 +2 -2
  30. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_close/SKILL.md.j2 +12 -12
  31. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_close/changelog.md.j2 +14 -15
  32. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_close/ci.md.j2 +2 -2
  33. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_close/merge.md.j2 +1 -1
  34. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_close/ops.md.j2 +1 -1
  35. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_close/version.md.j2 +11 -9
  36. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_iflow/SKILL.md.j2 +10 -12
  37. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_issue/SKILL.md.j2 +6 -5
  38. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_issue/epic.md.j2 +17 -15
  39. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_issue/fix.md.j2 +3 -3
  40. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_issue/new.md.j2 +3 -3
  41. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_issue/review.md.j2 +7 -7
  42. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_issue/split.md.j2 +8 -8
  43. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_pause/SKILL.md.j2 +4 -4
  44. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_pick/SKILL.md.j2 +16 -18
  45. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_pick/capture.md.j2 +7 -8
  46. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_pick/comments.md.j2 +10 -10
  47. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_plan/SKILL.md.j2 +9 -11
  48. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_run/SKILL.md.j2 +10 -8
  49. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_run/auto.md.j2 +16 -15
  50. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_run/cycle.md.j2 +15 -13
  51. issue_flow-0.8.0/src/issue_flow/templates/skills/iflow_run/direct.md.j2 +49 -0
  52. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_run/drive.md.j2 +13 -12
  53. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_run/yolo.md.j2 +5 -5
  54. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_setup/SKILL.md.j2 +10 -9
  55. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_setup/harness.md.j2 +8 -9
  56. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_status/SKILL.md.j2 +7 -8
  57. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_status/doctor.md.j2 +10 -9
  58. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_status/graph.md.j2 +4 -4
  59. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templating.py +33 -7
  60. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/tracking.py +7 -0
  61. {issue_flow-0.7.0 → issue_flow-0.8.0}/LICENSE +0 -0
  62. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/__init__.py +0 -0
  63. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/changelog.py +0 -0
  64. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/console_io.py +0 -0
  65. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/convert.py +0 -0
  66. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/dependencies.py +0 -0
  67. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/editors.py +0 -0
  68. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/epic_session.py +0 -0
  69. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/epicplan.py +0 -0
  70. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/gitutils.py +0 -0
  71. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/graphify.py +0 -0
  72. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/history.py +0 -0
  73. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/migrate.py +0 -0
  74. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/modes.toml +0 -0
  75. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/project.py +0 -0
  76. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/publishintent.py +0 -0
  77. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/py.typed +0 -0
  78. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/queueplan.py +0 -0
  79. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/readiness.py +0 -0
  80. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/self_update.py +0 -0
  81. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/skill_ownership.py +0 -0
  82. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/step_profiles.py +0 -0
  83. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/step_profiles.toml +0 -0
  84. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/surfaces.py +0 -0
  85. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/sync.py +0 -0
  86. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/__init__.py +0 -0
  87. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/commands/__init__.py +0 -0
  88. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/commands/_wrapper.md.j2 +0 -0
  89. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/designs/essential-tests.md.j2 +0 -0
  90. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/designs/python-quality-tools.md.j2 +0 -0
  91. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/designs/test-registry.md.j2 +0 -0
  92. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/docs/__init__.py +0 -0
  93. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/docs/this-project.md.j2 +0 -0
  94. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/rules/AGENTS.md.j2 +0 -0
  95. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/rules/CLAUDE.md.j2 +0 -0
  96. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/rules/__init__.py +0 -0
  97. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/rules/issueflow-rules.mdc.j2 +0 -0
  98. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_default_sync_recover.md.j2 +0 -0
  99. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_gh_body_file.md.j2 +0 -0
  100. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_invocation_forms.md.j2 +0 -0
  101. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_pstack_LICENSE.txt +0 -0
  102. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_resolve_project_root.md.j2 +0 -0
  103. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/_worktree_close_remove.md.j2 +0 -0
  104. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_cleanup/classify.md.j2 +0 -0
  105. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_close/sync.md.j2 +0 -0
  106. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/iflow_status/git.md.j2 +0 -0
  107. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_blast_radius/SKILL.md.j2 +0 -0
  108. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_bro/SKILL.md.j2 +0 -0
  109. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_principle_fix_root_causes/SKILL.md.j2 +0 -0
  110. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_principle_prove_it_works/SKILL.md.j2 +0 -0
  111. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_principle_subtract_before_you_add/SKILL.md.j2 +0 -0
  112. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_principle_test_behavior_not_implementation/SKILL.md.j2 +0 -0
  113. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_tdd/SKILL.md.j2 +0 -0
  114. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_technical_writing/SKILL.md.j2 +0 -0
  115. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/skills/pstack_unslop/SKILL.md.j2 +0 -0
  116. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/templates/tools/README.md.j2 +0 -0
  117. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/user_global.py +0 -0
  118. {issue_flow-0.7.0 → issue_flow-0.8.0}/src/issue_flow/versionplan.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: issue-flow
3
- Version: 0.7.0
3
+ Version: 0.8.0
4
4
  Summary: Agents should behave. Let them follow the issue flow.
5
5
  Keywords: cursor,ai,agents,issue-tracking,workflow
6
6
  Author: jepegit
@@ -91,7 +91,7 @@ The Agent Skills give agents a repeatable flow and appear in the slash menu. In
91
91
  | `/iflow-pause` | — | Park unfinished work with resume notes. |
92
92
  | `/iflow-close` | `yolo`, `ops`, `draft`, `bump` | Tests, bump, changelog trailers, commit, push, PR. |
93
93
  | `/iflow-cleanup` | `all`, `github`, `prs`, `archive` | After merge: default branch, pull, delete landed branches. |
94
- | `/iflow-run` | `yolo`, `cycle`, `auto`, `drive` | Hands-off runs under one up-front confirm. |
94
+ | `/iflow-run` | `yolo`, `direct`, `cycle`, `auto`, `drive` | Hands-off runs under one up-front confirm. |
95
95
  | `/iflow-issue` | `fix`, `epic`, `split`, `review` | Create and shape GitHub issues. |
96
96
  | `/iflow-status` | `doctor`, `git`, `graph` | Read-only overview of every issue. |
97
97
 
@@ -255,12 +255,13 @@ https://issue-flow.readthedocs.io/
255
255
  ## CLI overview
256
256
 
257
257
  ```
258
- issue-flow init [PROJECT_DIR] [--force] [--skip-dep-check] [--editor EDITOR] [--mode MODE] [--skill-level LEVEL]
258
+ issue-flow init [PROJECT_DIR] [--force] [--skip-dep-check] [--editor EDITOR] [--mode MODE] [--skill-level LEVEL] [--install-hooks]
259
259
  issue-flow update [PROJECT_DIR] [--skip-dep-check] [--editor EDITOR]
260
260
  issue-flow graphify [-C PROJECT_DIR] [...graphify subcommand + args]
261
261
  issue-flow status [PROJECT_DIR] [--local] [--json]
262
262
  issue-flow agent state|preflight|switchback|resolve|sweep|archive|capture [...]
263
263
  issue-flow config add [-C PROJECT_DIR] [--force] [--json]
264
+ issue-flow hooks install|uninstall|status|run [pre-commit] [-C PROJECT_DIR]
264
265
  issue-flow workspace bootstrap|init|update [WORKSPACE_DIR] [...]
265
266
  ```
266
267
 
@@ -268,13 +269,15 @@ issue-flow workspace bootstrap|init|update [WORKSPACE_DIR] [...]
268
269
  - `update` refreshes generated files after upgrading the package (overwrites scaffolds, never your issue markdown).
269
270
  - `workspace bootstrap` / `init` / `update` cover a **parent folder of sibling repos** (see [how-to](docs/how-to/workspaces.md)).
270
271
  - `status` / `agent ...` give agents (and you) **deterministic** answers about lifecycle state — focus issue, stage, branch hygiene — instead of having the agent re-derive it by hand.
272
+ - `hooks install` (or `init --install-hooks`) adds an **opt-in** git `pre-commit` hook that moves issue groups marked `- [x] Done` to `03-solved-issues/` and stages the move in the same commit. It never blocks a commit; see the [CLI reference](https://github.com/jepegit/issue-flow/blob/main/docs/cli.md#issue-flow-hooks) for Husky / pre-commit setups and how to disable it.
271
273
  - `issue-flow --install-completion` enables Tab completion for subcommands (bash / zsh / fish).
272
274
 
273
275
  Full option tables and the `agent` subcommand reference live in the [CLI reference](https://github.com/jepegit/issue-flow/blob/main/docs/cli.md).
274
276
 
275
277
  ## Going further
276
278
 
277
- - **[Configuration](https://github.com/jepegit/issue-flow/blob/main/docs/configuration.md)** — `.env` variables and `.issueflows/config.toml`; **modes** (`standard` vs the markdown-only `simple`), **skill levels** (`basic` / `standard` / `advanced` quality-tooling guidance), the optional **caveman** and **grill-me** skills, the opt-in vendored **pstack** skills (`pstack_skills`), and **label-driven flows** (a `yolo` label routes an issue through the hands-off chain).
279
+ - **[Configuration](https://github.com/jepegit/issue-flow/blob/main/docs/configuration.md)** — `.env` variables and `.issueflows/config.toml`; **modes** (`standard` vs the markdown-only `simple`), **skill levels** (`basic` / `standard` / `advanced` quality-tooling guidance), the optional **caveman** and **grill-me** skills, the opt-in vendored **pstack** skills (`pstack_skills`), **label-driven flows** (a `yolo` label routes an issue through the hands-off chain), and **`issue-flow prep fable`** for Claude Fable 5.2 and similar models.
280
+ - **[Prepare for a capable model](https://github.com/jepegit/issue-flow/blob/main/docs/how-to/capable-model.md)** — re-render skills so long runs finish the task, post one-line updates, and end with a recap that stands alone.
278
281
  - **[Editor support](https://github.com/jepegit/issue-flow/blob/main/docs/editors.md)** — what gets scaffolded per editor (Cursor, Claude Code, opencode, Codex), and how multi-root workspaces resolve the right repo.
279
282
  - **[Folder of repos](https://github.com/jepegit/issue-flow/blob/main/docs/how-to/workspaces.md)** — `workspace bootstrap` / `init` / `update` from a parent folder.
280
283
  - **[Graphify integration](https://github.com/jepegit/issue-flow/blob/main/docs/graphify.md)** — optional knowledge graph of your codebase that agents can read instead of grepping; enabled simply by installing `graphifyy`.
@@ -368,7 +371,6 @@ with `install_mode: workspace` via [`.github/workflows/issueflow-sync.yml`](.git
368
371
 
369
372
  - **More editors** — extend `--editor` coverage to further AI coding tools (e.g. Windsurf) on top of the current Cursor / Claude Code / opencode / Codex support.
370
373
  - **Custom templates** — let users supply their own Jinja2 templates to tailor slash commands and rules to their team's conventions.
371
- - **Git hook integration** — optionally move issue files on commit based on status markers.
372
374
 
373
375
  ## Acknowledgements
374
376
 
@@ -64,7 +64,7 @@ The Agent Skills give agents a repeatable flow and appear in the slash menu. In
64
64
  | `/iflow-pause` | — | Park unfinished work with resume notes. |
65
65
  | `/iflow-close` | `yolo`, `ops`, `draft`, `bump` | Tests, bump, changelog trailers, commit, push, PR. |
66
66
  | `/iflow-cleanup` | `all`, `github`, `prs`, `archive` | After merge: default branch, pull, delete landed branches. |
67
- | `/iflow-run` | `yolo`, `cycle`, `auto`, `drive` | Hands-off runs under one up-front confirm. |
67
+ | `/iflow-run` | `yolo`, `direct`, `cycle`, `auto`, `drive` | Hands-off runs under one up-front confirm. |
68
68
  | `/iflow-issue` | `fix`, `epic`, `split`, `review` | Create and shape GitHub issues. |
69
69
  | `/iflow-status` | `doctor`, `git`, `graph` | Read-only overview of every issue. |
70
70
 
@@ -228,12 +228,13 @@ https://issue-flow.readthedocs.io/
228
228
  ## CLI overview
229
229
 
230
230
  ```
231
- issue-flow init [PROJECT_DIR] [--force] [--skip-dep-check] [--editor EDITOR] [--mode MODE] [--skill-level LEVEL]
231
+ issue-flow init [PROJECT_DIR] [--force] [--skip-dep-check] [--editor EDITOR] [--mode MODE] [--skill-level LEVEL] [--install-hooks]
232
232
  issue-flow update [PROJECT_DIR] [--skip-dep-check] [--editor EDITOR]
233
233
  issue-flow graphify [-C PROJECT_DIR] [...graphify subcommand + args]
234
234
  issue-flow status [PROJECT_DIR] [--local] [--json]
235
235
  issue-flow agent state|preflight|switchback|resolve|sweep|archive|capture [...]
236
236
  issue-flow config add [-C PROJECT_DIR] [--force] [--json]
237
+ issue-flow hooks install|uninstall|status|run [pre-commit] [-C PROJECT_DIR]
237
238
  issue-flow workspace bootstrap|init|update [WORKSPACE_DIR] [...]
238
239
  ```
239
240
 
@@ -241,13 +242,15 @@ issue-flow workspace bootstrap|init|update [WORKSPACE_DIR] [...]
241
242
  - `update` refreshes generated files after upgrading the package (overwrites scaffolds, never your issue markdown).
242
243
  - `workspace bootstrap` / `init` / `update` cover a **parent folder of sibling repos** (see [how-to](docs/how-to/workspaces.md)).
243
244
  - `status` / `agent ...` give agents (and you) **deterministic** answers about lifecycle state — focus issue, stage, branch hygiene — instead of having the agent re-derive it by hand.
245
+ - `hooks install` (or `init --install-hooks`) adds an **opt-in** git `pre-commit` hook that moves issue groups marked `- [x] Done` to `03-solved-issues/` and stages the move in the same commit. It never blocks a commit; see the [CLI reference](https://github.com/jepegit/issue-flow/blob/main/docs/cli.md#issue-flow-hooks) for Husky / pre-commit setups and how to disable it.
244
246
  - `issue-flow --install-completion` enables Tab completion for subcommands (bash / zsh / fish).
245
247
 
246
248
  Full option tables and the `agent` subcommand reference live in the [CLI reference](https://github.com/jepegit/issue-flow/blob/main/docs/cli.md).
247
249
 
248
250
  ## Going further
249
251
 
250
- - **[Configuration](https://github.com/jepegit/issue-flow/blob/main/docs/configuration.md)** — `.env` variables and `.issueflows/config.toml`; **modes** (`standard` vs the markdown-only `simple`), **skill levels** (`basic` / `standard` / `advanced` quality-tooling guidance), the optional **caveman** and **grill-me** skills, the opt-in vendored **pstack** skills (`pstack_skills`), and **label-driven flows** (a `yolo` label routes an issue through the hands-off chain).
252
+ - **[Configuration](https://github.com/jepegit/issue-flow/blob/main/docs/configuration.md)** — `.env` variables and `.issueflows/config.toml`; **modes** (`standard` vs the markdown-only `simple`), **skill levels** (`basic` / `standard` / `advanced` quality-tooling guidance), the optional **caveman** and **grill-me** skills, the opt-in vendored **pstack** skills (`pstack_skills`), **label-driven flows** (a `yolo` label routes an issue through the hands-off chain), and **`issue-flow prep fable`** for Claude Fable 5.2 and similar models.
253
+ - **[Prepare for a capable model](https://github.com/jepegit/issue-flow/blob/main/docs/how-to/capable-model.md)** — re-render skills so long runs finish the task, post one-line updates, and end with a recap that stands alone.
251
254
  - **[Editor support](https://github.com/jepegit/issue-flow/blob/main/docs/editors.md)** — what gets scaffolded per editor (Cursor, Claude Code, opencode, Codex), and how multi-root workspaces resolve the right repo.
252
255
  - **[Folder of repos](https://github.com/jepegit/issue-flow/blob/main/docs/how-to/workspaces.md)** — `workspace bootstrap` / `init` / `update` from a parent folder.
253
256
  - **[Graphify integration](https://github.com/jepegit/issue-flow/blob/main/docs/graphify.md)** — optional knowledge graph of your codebase that agents can read instead of grepping; enabled simply by installing `graphifyy`.
@@ -341,7 +344,6 @@ with `install_mode: workspace` via [`.github/workflows/issueflow-sync.yml`](.git
341
344
 
342
345
  - **More editors** — extend `--editor` coverage to further AI coding tools (e.g. Windsurf) on top of the current Cursor / Claude Code / opencode / Codex support.
343
346
  - **Custom templates** — let users supply their own Jinja2 templates to tailor slash commands and rules to their team's conventions.
344
- - **Git hook integration** — optionally move issue files on commit based on status markers.
345
347
 
346
348
  ## Acknowledgements
347
349
 
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "issue-flow"
3
- version = "0.7.0"
3
+ version = "0.8.0"
4
4
  description = "Agents should behave. Let them follow the issue flow."
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "issue-flow"
3
- version = "0.7.0"
3
+ version = "0.8.0"
4
4
  description = "Agents should behave. Let them follow the issue flow."
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -36,6 +36,7 @@ from issue_flow import (
36
36
  modes,
37
37
  project,
38
38
  readiness,
39
+ skill_lint,
39
40
  tracking,
40
41
  )
41
42
  from issue_flow.config import Settings
@@ -5269,6 +5270,53 @@ def audit_unmanaged_editor_skills(
5269
5270
  return findings
5270
5271
 
5271
5272
 
5273
+ def audit_skill_spec(
5274
+ project_root: Path, settings: Settings
5275
+ ) -> list[tracking.DirtyFinding]:
5276
+ """Lint every editor skill folder against the Agent Skills spec (#268).
5277
+
5278
+ Spec errors in a packaged skill are ``error`` (the render or a local edit
5279
+ broke it); in a user's own skill they are ``warn``, so doctor flags them
5280
+ without failing on files issue-flow does not own. Authoring hints stay
5281
+ ``info``. Skipped when ``ISSUEFLOW_AGENT_DIR`` overrides the layout.
5282
+ """
5283
+ if settings.agent_dir_override:
5284
+ return []
5285
+
5286
+ packaged = packaged_skill_output_names()
5287
+ severity_for = {
5288
+ skill_lint.LINT_WARN: tracking.SEVERITY_WARN,
5289
+ skill_lint.LINT_INFO: tracking.SEVERITY_INFO,
5290
+ }
5291
+ findings: list[tracking.DirtyFinding] = []
5292
+ seen: set[Path] = set()
5293
+ for profile in EDITORS.values():
5294
+ skills_dir = project_root / profile.agent_dir / "skills"
5295
+ if not skills_dir.is_dir() or skills_dir.resolve() in seen:
5296
+ continue
5297
+ seen.add(skills_dir.resolve())
5298
+ for hit in skill_lint.lint_skills_root(skills_dir):
5299
+ if hit.severity == skill_lint.LINT_ERROR:
5300
+ skill_name = (hit.path if hit.path.is_dir() else hit.path.parent).name
5301
+ severity = (
5302
+ tracking.SEVERITY_ERROR
5303
+ if skill_name in packaged
5304
+ else tracking.SEVERITY_WARN
5305
+ )
5306
+ else:
5307
+ severity = severity_for[hit.severity]
5308
+ rel = hit.path.relative_to(project_root).as_posix()
5309
+ findings.append(
5310
+ tracking.DirtyFinding(
5311
+ code=f"skill_spec_{hit.check}",
5312
+ severity=severity,
5313
+ message=f"{rel}: {hit.message}",
5314
+ repairable=False,
5315
+ )
5316
+ )
5317
+ return findings
5318
+
5319
+
5272
5320
  def _audit_payload(project_root: Path) -> dict[str, Any]:
5273
5321
  """JSON-shaped doctor audit for one project root."""
5274
5322
  settings = Settings()
@@ -5283,6 +5331,7 @@ def _audit_payload(project_root: Path) -> dict[str, Any]:
5283
5331
  )
5284
5332
  findings.extend(audit_editor_scaffolds(project_root, settings))
5285
5333
  findings.extend(audit_unmanaged_editor_skills(project_root, settings))
5334
+ findings.extend(audit_skill_spec(project_root, settings))
5286
5335
  has_error = any(f.severity == tracking.SEVERITY_ERROR for f in findings)
5287
5336
  return {
5288
5337
  "findings": [_finding_payload(f) for f in findings],
@@ -5753,7 +5802,7 @@ def _print_config_guide(console: Console, cfg_path: Path) -> None:
5753
5802
  "[bold]worktree_first[/bold] / "
5754
5803
  "[bold]auto_close[/bold] / [bold]auto_cleanup[/bold] / "
5755
5804
  "[bold]auto_plan[/bold] / [bold]auto_build[/bold] / "
5756
- "[bold]hands_off[/bold] / "
5805
+ "[bold]hands_off[/bold] / [bold]capable_model[/bold] / "
5757
5806
  "[bold]early_pr[/bold] / [bold]fix_auto_name[/bold]; "
5758
5807
  "[bold]confirm_version_bump[/bold] / [bold]confirm_changelog_update[/bold] / "
5759
5808
  "[bold]defer_changelog[/bold]; "
@@ -167,6 +167,14 @@ def init(
167
167
  "local editor directories."
168
168
  ),
169
169
  ),
170
+ install_hooks: bool = typer.Option(
171
+ False,
172
+ "--install-hooks",
173
+ help=(
174
+ "Also install the opt-in git pre-commit hook that moves issue groups "
175
+ "marked '- [x] Done' to solved-issues (see `issue-flow hooks`)."
176
+ ),
177
+ ),
170
178
  ) -> None:
171
179
  """Scaffold issue-flow directories and editor config files in a project."""
172
180
  from issue_flow.init import run_init
@@ -179,6 +187,7 @@ def init(
179
187
  mode=mode,
180
188
  skill_level=skill_level,
181
189
  canonical=canonical,
190
+ install_hooks=install_hooks,
182
191
  )
183
192
 
184
193
 
@@ -390,6 +399,88 @@ def execution_mode(
390
399
  )
391
400
 
392
401
 
402
+ @app.command("prep")
403
+ def prep_capable_model(
404
+ target: str | None = typer.Argument(
405
+ None,
406
+ help="fable to enable the capable-model posture, or off to disable. Omit to print.",
407
+ ),
408
+ yes: bool = typer.Option(
409
+ False,
410
+ "--yes",
411
+ "-y",
412
+ help="Skip the confirm when turning the posture on.",
413
+ ),
414
+ project_dir: Path = typer.Option(
415
+ Path("."),
416
+ "--project-dir",
417
+ "-C",
418
+ help="Project root (defaults to the current directory).",
419
+ exists=True,
420
+ file_okay=False,
421
+ resolve_path=True,
422
+ ),
423
+ skip_dep_check: bool = typer.Option(
424
+ False,
425
+ "--skip-dep-check",
426
+ help="Skip the git/gh check while re-rendering skills.",
427
+ ),
428
+ ) -> None:
429
+ """Prepare rendered skills for Claude Fable 5.2 and similar models.
430
+
431
+ Sets ``[issueflow].capable_model`` and re-renders skills. ``fable`` also
432
+ turns ``caveman_default`` off. ``off`` clears the posture and leaves
433
+ caveman as it is.
434
+ """
435
+ from issue_flow.config import Settings
436
+ from issue_flow.config_ops import upsert_config_value
437
+ from issue_flow.init import run_update
438
+
439
+ settings = Settings()
440
+ if target is None or not target.strip():
441
+ current = settings.resolve_capable_model(project_dir)
442
+ _console.print(f"capable_model = {'true' if current else 'false'}")
443
+ return
444
+
445
+ token = target.strip().lower()
446
+ if token in {"fable", "capable", "on"}:
447
+ enabled = True
448
+ elif token in {"off", "standard"}:
449
+ enabled = False
450
+ else:
451
+ _console.print(
452
+ "[red]error[/red] unknown prep target "
453
+ f"{target!r}. Use fable or off."
454
+ )
455
+ raise typer.Exit(code=2)
456
+
457
+ if enabled and not yes:
458
+ _console.print(
459
+ "Prep re-renders skills for Claude Fable 5.2 and similar models. "
460
+ "Long runs finish the task, post a one-line update every few tool "
461
+ "calls, and end with a recap that stands alone. Bookkeeping steps "
462
+ "leave effort at the editor setting. [bold]caveman_default[/bold] "
463
+ "is set to false. Plan Accept stays for [bold]/iflow-plan[/bold]. "
464
+ "[bold]/iflow-run direct[/bold] still skips the plan file."
465
+ )
466
+ if not typer.confirm("Turn on capable-model prep and re-render skills?"):
467
+ raise typer.Exit(code=1)
468
+
469
+ cfg_path = settings.config_path(project_dir)
470
+ upsert_config_value(cfg_path, "capable_model", enabled)
471
+ if enabled:
472
+ upsert_config_value(cfg_path, "caveman_default", False)
473
+ _console.print(f"capable_model = {'true' if enabled else 'false'}")
474
+ if enabled:
475
+ _console.print("caveman_default = false")
476
+ run_update(
477
+ project_root=project_dir,
478
+ skip_dep_check=skip_dep_check,
479
+ editors=None,
480
+ force=False,
481
+ )
482
+
483
+
393
484
  @app.command()
394
485
  def sync(
395
486
  project_dir: Path = typer.Argument(
@@ -1474,7 +1565,7 @@ def config_add(
1474
1565
  ``cycle_nonyolo``, ``auto_adversarial_loops``,
1475
1566
  ``confirm_version_bump``,
1476
1567
  ``ruff_autofix``, ``auto_close``, ``auto_cleanup``, ``auto_plan``, ``auto_build``,
1477
- ``hands_off``,
1568
+ ``hands_off``, ``capable_model``,
1478
1569
  ``early_pr``, ``fix_auto_name``, ``confirm_changelog_update``,
1479
1570
  ``defer_changelog``,
1480
1571
  ``essential_tests``, ``test_runner``, ``essential_marker``,
@@ -2274,9 +2365,117 @@ def changelog_check(
2274
2365
  raise typer.Exit(code=1)
2275
2366
 
2276
2367
 
2368
+ hooks_app = typer.Typer(
2369
+ name="hooks",
2370
+ add_completion=False,
2371
+ help=(
2372
+ "Opt-in git hooks. pre-commit moves issue groups marked "
2373
+ "'- [x] Done' to solved-issues and stages the move. Never blocks a commit."
2374
+ ),
2375
+ )
2376
+
2377
+ _HOOK_NAME_ARGUMENT = typer.Argument(
2378
+ "pre-commit", help="Hook name (only pre-commit today)."
2379
+ )
2380
+
2381
+
2382
+ def _hook_name(name: str) -> str:
2383
+ from issue_flow.hooks import HOOK_NAMES
2384
+
2385
+ if name not in HOOK_NAMES:
2386
+ _console.print(
2387
+ f"[red]unknown hook[/red] {name} (known: {', '.join(HOOK_NAMES)})"
2388
+ )
2389
+ raise typer.Exit(code=2)
2390
+ return name
2391
+
2392
+
2393
+ def _print_hook_result(result, json_output: bool) -> None:
2394
+ if json_output:
2395
+ _console.print_json(
2396
+ data={
2397
+ "hook": result.name,
2398
+ "action": result.action,
2399
+ "script": str(result.script) if result.script else None,
2400
+ "target": str(result.target) if result.target else None,
2401
+ "message": result.message,
2402
+ }
2403
+ )
2404
+ return
2405
+ color = {"foreign": "yellow", "not_repo": "red", "absent": "dim"}.get(
2406
+ result.action, "green"
2407
+ )
2408
+ where = f" {result.target}" if result.target else ""
2409
+ _console.print(f"[{color}]{result.action}[/{color}] {result.name}{where}")
2410
+ if result.message:
2411
+ _console.print(f" {result.message}", markup=False)
2412
+
2413
+
2414
+ @hooks_app.command("install")
2415
+ def hooks_install(
2416
+ name: str = _HOOK_NAME_ARGUMENT,
2417
+ project_dir: Path = _PROJECT_DIR_OPTION,
2418
+ force: bool = typer.Option(
2419
+ False, "--force", help="Replace a hook that is not issue-flow's."
2420
+ ),
2421
+ json_output: bool = typer.Option(False, "--json", help="Emit JSON."),
2422
+ ) -> None:
2423
+ """Write .issueflows/hooks/<name> and link it into git's hooks directory."""
2424
+ from issue_flow.hooks import install
2425
+
2426
+ result = install(project_dir, _hook_name(name), force=force)
2427
+ _print_hook_result(result, json_output)
2428
+ if result.action in ("foreign", "not_repo"):
2429
+ raise typer.Exit(code=1)
2430
+
2431
+
2432
+ @hooks_app.command("uninstall")
2433
+ def hooks_uninstall(
2434
+ name: str = _HOOK_NAME_ARGUMENT,
2435
+ project_dir: Path = _PROJECT_DIR_OPTION,
2436
+ json_output: bool = typer.Option(False, "--json", help="Emit JSON."),
2437
+ ) -> None:
2438
+ """Remove the issue-flow hook from git's hooks directory (foreign hooks stay)."""
2439
+ from issue_flow.hooks import uninstall
2440
+
2441
+ result = uninstall(project_dir, _hook_name(name))
2442
+ _print_hook_result(result, json_output)
2443
+ if result.action in ("foreign", "not_repo"):
2444
+ raise typer.Exit(code=1)
2445
+
2446
+
2447
+ @hooks_app.command("status")
2448
+ def hooks_status(
2449
+ name: str = _HOOK_NAME_ARGUMENT,
2450
+ project_dir: Path = _PROJECT_DIR_OPTION,
2451
+ json_output: bool = typer.Option(False, "--json", help="Emit JSON."),
2452
+ ) -> None:
2453
+ """Show whether the issue-flow hook is installed, and where."""
2454
+ from issue_flow.hooks import status
2455
+
2456
+ _print_hook_result(status(project_dir, _hook_name(name)), json_output)
2457
+
2458
+
2459
+ @hooks_app.command("run")
2460
+ def hooks_run(
2461
+ name: str = _HOOK_NAME_ARGUMENT,
2462
+ project_dir: Path = _PROJECT_DIR_OPTION,
2463
+ ) -> None:
2464
+ """Run a hook's work now (what the installed git hook calls)."""
2465
+ from issue_flow.hooks import run_pre_commit
2466
+
2467
+ _hook_name(name)
2468
+ for move in run_pre_commit(project_dir):
2469
+ _console.print(
2470
+ f"issue-flow: moved #{move.number} (done): {move.source} -> {move.destination}",
2471
+ markup=False,
2472
+ )
2473
+
2474
+
2277
2475
  app.add_typer(agent_app)
2278
2476
  app.add_typer(config_app)
2279
2477
  app.add_typer(changelog_app)
2478
+ app.add_typer(hooks_app)
2280
2479
  workspace_app.add_typer(workspace_git_app)
2281
2480
  app.add_typer(workspace_app)
2282
2481
 
@@ -17,6 +17,7 @@ from issue_flow.modes import (
17
17
  DEFAULT_AUTO_CLEANUP,
18
18
  DEFAULT_AUTO_CLOSE,
19
19
  DEFAULT_AUTO_PLAN,
20
+ DEFAULT_CAPABLE_MODEL,
20
21
  DEFAULT_HANDS_OFF,
21
22
  DEFAULT_CHECKS_WATCH_MINUTES,
22
23
  DEFAULT_CONFIRM_CHANGELOG_UPDATE,
@@ -751,6 +752,16 @@ class Settings:
751
752
  "hands_off", _env_flag("ISSUEFLOW_HANDS_OFF", default=DEFAULT_HANDS_OFF)
752
753
  )
753
754
 
755
+ def resolve_capable_model(self, project_root: Path) -> bool:
756
+ """Resolve the Fable-class prompting posture (``issue-flow prep fable``)."""
757
+ persisted = modes_module.read_capable_model(self.config_path(project_root))
758
+ if persisted is not None:
759
+ return persisted
760
+ return self.user_global_or(
761
+ "capable_model",
762
+ _env_flag("ISSUEFLOW_CAPABLE_MODEL", default=DEFAULT_CAPABLE_MODEL),
763
+ )
764
+
754
765
  def resolve_early_pr(self, project_root: Path) -> bool:
755
766
  """Resolve whether ``/iflow-build`` opens a draft PR after the first push."""
756
767
  persisted = modes_module.read_early_pr(self.config_path(project_root))
@@ -1052,6 +1063,9 @@ class Settings:
1052
1063
  "auto_plan": _env_flag("ISSUEFLOW_AUTO_PLAN", default=DEFAULT_AUTO_PLAN),
1053
1064
  "auto_build": _env_flag("ISSUEFLOW_AUTO_BUILD", default=DEFAULT_AUTO_BUILD),
1054
1065
  "hands_off": _env_flag("ISSUEFLOW_HANDS_OFF", default=DEFAULT_HANDS_OFF),
1066
+ "capable_model": _env_flag(
1067
+ "ISSUEFLOW_CAPABLE_MODEL", default=DEFAULT_CAPABLE_MODEL
1068
+ ),
1055
1069
  "early_pr": _env_flag("ISSUEFLOW_EARLY_PR", default=DEFAULT_EARLY_PR),
1056
1070
  "fix_auto_name": _env_flag(
1057
1071
  "ISSUEFLOW_FIX_AUTO_NAME", default=DEFAULT_FIX_AUTO_NAME
@@ -1125,6 +1139,7 @@ class Settings:
1125
1139
  "auto_plan": self.resolve_auto_plan(project_root),
1126
1140
  "auto_build": self.resolve_auto_build(project_root),
1127
1141
  "hands_off": self.resolve_hands_off(project_root),
1142
+ "capable_model": self.resolve_capable_model(project_root),
1128
1143
  "early_pr": self.resolve_early_pr(project_root),
1129
1144
  "fix_auto_name": self.resolve_fix_auto_name(project_root),
1130
1145
  "locked": self.resolve_locked(project_root),
@@ -1237,6 +1252,7 @@ class Settings:
1237
1252
  "auto_plan": self.resolve_auto_plan(project_root),
1238
1253
  "auto_build": self.resolve_auto_build(project_root),
1239
1254
  "hands_off": self.resolve_hands_off(project_root),
1255
+ "capable_model": self.resolve_capable_model(project_root),
1240
1256
  "early_pr": self.resolve_early_pr(project_root),
1241
1257
  "fix_auto_name": self.resolve_fix_auto_name(project_root),
1242
1258
  "confirm_changelog_update": self.resolve_confirm_changelog_update(
@@ -90,6 +90,7 @@ CONFIG_KEYS: dict[str, ConfigKeySpec] = {
90
90
  "auto_plan": ConfigKeySpec("bool"),
91
91
  "auto_build": ConfigKeySpec("bool"),
92
92
  "hands_off": ConfigKeySpec("bool"),
93
+ "capable_model": ConfigKeySpec("bool"),
93
94
  "early_pr": ConfigKeySpec("bool"),
94
95
  "fix_auto_name": ConfigKeySpec("bool"),
95
96
  "locked": ConfigKeySpec("bool", needs_update=False),