task-utils v0.2.0 R7 — in-session validation of redesigned hooks

[jack-nsheaps]

Summary

Phases R1–R6 of the task-utils redesign landed on branch claude/ai-3d-model-generator-XjoUi (PR #157). R7 is in-session validation: the new PreToolUse/PostToolUse hooks only load at SessionStart, so verification must happen in a fresh Claude Code session with this branch checked out. R7 blocks merge of #157.

Requirements

• Restart Claude Code with PR Add opt-out for require-task-in-progress gate via env var #157 branch checked out (so hooks/task-native-warning.sh, hooks/task-sync-from-legacy.sh, updated hooks/require-task-in-progress.sh load).
• Verify task-native-warning.sh (PreToolUse on TaskCreate/TaskUpdate) fires an additionalContext advisory in warn mode (the plugin default per task-utils.settings.yaml).
• Verify task-sync-from-legacy.sh (PostToolUse on TaskCreate/TaskUpdate) copies legacy ~/.claude/tasks/<sid>/<id>.{json,yaml} into the project-local flat YAML store, with JSON→YAML conversion via jq, and a best-effort git add + git commit + git push.
• Verify require-task-in-progress.sh denies Write/Edit/MultiEdit/NotebookEdit when no flat-store task is in_progress.
• Verify the gate allows once an MCP-created task is moved to in_progress (mcp__task-utils__task_create + mcp__task-utils__task_update(status=in_progress)).
• Verify the requireTaskInProgress: false settings opt-out (3-tier plugin-settings-lib.sh reader) actually disables the gate.
• Verify git-helper.ts in the MCP server still auto-commits on every MCP task write (existing behaviour — sanity check, not changed in R1–R6).
• Record results in the plan file (.claude/plans/post-r6-tasks.md) and the redesign report (.claude/tmp/task-utils-redesign-report.md).
• Once all of the above pass, unblock merge of PR Add opt-out for require-task-in-progress gate via env var #157.

Source

Handler ask in this session: "Split up those tasks into one per each item that we discussed, probably going beyond just my original message. Make each properly dependent on each other so they execute in order and make them all pending." R7 was deferred during the R1–R6 implementation per handler instruction "If R7 needs restart, REPORT and STOP."

Related

• PR: nsheaps/agents#157 — the redesign this validates
• Plan: .claude/plans/task-utils-redesign.md §Phase R7
• Report: .claude/tmp/task-utils-redesign-report.md
• Reference: CLAUDE_CODE_ENABLE_TASKS docs, VSCode re-enable bug GH#23874

---

Issue created by Jack Oat (AI agent) on behalf of nsheaps.