feat: bind workflow guidance to plan system prompt with structured field specs (#28)

* feat: expose structured workflow guidance to plan system prompt

- Enhanced _extract_latest_workflow_guidance to return full guidance object
- Added comprehensive guidance formatting for plan system prompt
- Exposed plan_required_fields with types, conditions, and descriptions
- Updated plan evaluation protocol to use structured guidance
- Added comprehensive test coverage for guidance exposure
- Created documentation and examples for the enhanced system

This enables AI coding assistants to receive detailed field specifications,
conditional requirements, and preparation instructions, significantly
improving plan validation success rates.

* fix: remove low-quality static risk generation fallback and fix formatting

- Removed _generate_default_risk_profile function (hardcoded patterns)
- Cleaned up risk assessment logic to avoid static fallbacks
- Fixed formatting issues for CI compliance
- Maintained backward compatibility for client APIs

* fix: final formatting fix for CI compliance

* fix: add noqa comments for mutable default arguments to preserve client compatibility

- Added # noqa: B006 comments to ignore mutable default warnings
- Preserves existing API contracts for all client tools
- Maintains backward compatibility while satisfying linting requirements

* fix: resolve mypy type checking errors

- Fixed duplicate variable name 'plan_required_fields' in workflow_guidance.py
- Added missing 'workflow_guidance' field to SystemVars model
- All type checking now passes without errors

* remove example

* dynamic field spesicifcation

* update task size task_size_definitions

* refactor code review tools

* fmt

* update risk mgmt

* imports

---------

Co-authored-by: mcp-release-bot <[email protected]>

Author: OtherVibes

pyproject.toml

@@ -62,6 +62,7 @@ dev-dependencies = [
     "types-requests>=2.31.0",
     "pre-commit>=3.0.0",
     "bandit>=1.8.6",
+    "jinja2>=3.1.6",
 ]
 
 [tool.hatch.envs.default]

scripts/bump_version.py

@@ -17,6 +17,7 @@
   - Prints a machine-readable list of other files containing the old version preceded by 'FOUND: '
   - Exits non-zero on validation failure or if expected files are missing
 """
+
 from __future__ import annotations
 
 import argparse
@@ -49,7 +50,9 @@ def extract_current_version() -> str:
     # naive toml line parse to avoid adding deps
     m = re.search(r'^version\s*=\s*"([^"]+)"', text, re.MULTILINE)
     if not m:
-        print("ERROR: Could not find [project].version in pyproject.toml", file=sys.stderr)
+        print(
+            "ERROR: Could not find [project].version in pyproject.toml", file=sys.stderr
+        )
         sys.exit(2)
     return m.group(1)
 
@@ -90,15 +93,32 @@ def bump_init(version: str) -> bool:
 
 def find_other_references(old_version: str) -> None:
     # Report-only scan for the old version string across repo (excluding venvs, git, dist, etc.)
-    skip_dirs = {".git", ".venv", "dist", "build", "__pycache__", ".mypy_cache", ".ruff_cache"}
+    skip_dirs = {
+        ".git",
+        ".venv",
+        "dist",
+        "build",
+        "__pycache__",
+        ".mypy_cache",
+        ".ruff_cache",
+    }
     for path in REPO_ROOT.rglob("*"):
         if path.is_dir():
             if path.name in skip_dirs:
                 # prune by skipping children
                 for _ in []:
                     pass
             continue
-        if path.suffix in {".png", ".jpg", ".jpeg", ".gif", ".zip", ".whl", ".tar", ".gz"}:
+        if path.suffix in {
+            ".png",
+            ".jpg",
+            ".jpeg",
+            ".gif",
+            ".zip",
+            ".whl",
+            ".tar",
+            ".gz",
+        }:
             continue
         # Avoid scanning the lock file for noisy matches
         if path.name == "uv.lock":
@@ -113,7 +133,9 @@ def find_other_references(old_version: str) -> None:
 
 def main() -> None:
     parser = argparse.ArgumentParser(description="Bump project version across files")
-    parser.add_argument("--version", required=True, help="Semantic version, e.g., 0.3.0")
+    parser.add_argument(
+        "--version", required=True, help="Semantic version, e.g., 0.3.0"
+    )
     args = parser.parse_args()
 
     new_version = args.version.strip()
@@ -146,4 +168,3 @@ def main() -> None:
 
 if __name__ == "__main__":
     main()
-