Enhance Planning AI with Roadmap-First Architecture and New Features
Deploy Development / deploy (push) Successful in 49s
Test Suite / pytest-backend (push) Failing after 43s
Test Suite / lint-backend (push) Successful in 0s
Test Suite / build-frontend (push) Successful in 15s
Test Suite / k6 /health Baseline (push) Successful in 44s
Test Suite / playwright-tests (push) Successful in 1m15s

- Introduced a roadmap-first approach for the planning AI, allowing for a structured progression graph that aligns with the overall project roadmap.
- Added new functionality to strip off-topic steps from exercise paths, improving the relevance of generated exercise suggestions.
- Implemented a detailed goal text generation for AI proposals, enhancing the context provided for new exercises.
- Updated the ExerciseProgressionPathBuilder component to support new features, including roadmap previews and improved focus area handling.
- Incremented application version to 0.8.205 and updated database schema version to 20260606086 to reflect these changes.
This commit is contained in:
Lars committed 2026-06-08 08:10:53 +02:00
1 parent a9a6153ed5
commit dd0fae4bf5
20 files changed
+1491 -94

No files matched your search

+38 -5
View File
@@ -1,7 +1,8 @@
"""
Planungs-KI Phase C3/E: Pfad-Vorschläge für Progressionsgraphen.
Planungs-KI Phase C3/E/F: Pfad-Vorschläge für Progressionsgraphen.
Ziel-Freitext → semantisch gewichtete Schritte → Lücken/Brücken → optional LLM-QA.
Legacy: retrieval-first. Phase F: optional Roadmap-Preview (A→B→C) parallel — siehe
planning_progression_roadmap.py und PLANNING_PROGRESSION_ROADMAP_SPEC.md.
"""
from __future__ import annotations
@@ -19,6 +20,7 @@ from planning_exercise_path_qa import (
detect_path_gaps,
insert_bridge_exercises,
parse_llm_suggested_new_exercises,
strip_off_topic_steps_from_path,
try_llm_qa_progression_path,
)
from planning_exercise_path_ai_fill import apply_gap_fill_after_qa, collect_gap_fill_specs
@@ -44,6 +46,10 @@ from planning_exercise_suggest import (
_normalize_query,
resolve_planning_exercise_intent,
)
from planning_progression_roadmap import (
progression_roadmap_to_api_dict,
run_progression_roadmap_pipeline,
)
from routers.training_planning import _has_planning_role
@@ -55,6 +61,9 @@ class ProgressionPathSuggestRequest(BaseModel):
include_llm_path_qa: bool = True
include_path_reorder: bool = True
include_ai_gap_fill: bool = True
include_roadmap_preview: bool = False
include_llm_roadmap: bool = True
roadmap_first: bool = False
progression_graph_id: Optional[int] = Field(default=None, ge=1)
exercise_kind_any: Optional[List[str]] = None
@@ -398,6 +407,7 @@ def suggest_progression_path(
ai_proposals: List[Dict[str, Any]] = []
gap_fill_offers: List[Dict[str, Any]] = []
off_topic_steps: List[Dict[str, Any]] = []
stripped_off_topic: List[Dict[str, Any]] = []
llm_qa: Optional[Dict[str, Any]] = None
llm_qa_applied = False
reorder_applied = False
@@ -448,6 +458,11 @@ def suggest_progression_path(
steps, reorder_applied, reorder_notes = apply_llm_path_reorder(steps, llm_qa)
off_topic_steps = detect_off_topic_steps(cur, steps, brief=semantic_brief)
steps, stripped_off_topic = strip_off_topic_steps_from_path(steps, off_topic_steps)
if stripped_off_topic:
off_topic_steps = []
gaps = detect_path_gaps(cur, steps, brief=semantic_brief)
llm_gap_specs = parse_llm_suggested_new_exercises(
llm_qa,
brief=semantic_brief,
@@ -455,9 +470,10 @@ def suggest_progression_path(
)
if body.include_ai_gap_fill:
fresh_large_gaps = [g for g in gaps if g.get("is_large_gap")]
gap_specs = collect_gap_fill_specs(
steps=steps,
unfilled_gaps=unfilled_gaps,
unfilled_gaps=fresh_large_gaps or unfilled_gaps,
off_topic_steps=off_topic_steps,
llm_specs=llm_gap_specs,
brief=semantic_brief,
@@ -469,8 +485,8 @@ def suggest_progression_path(
gap_specs,
goal_query=goal_query,
brief=semantic_brief,
include_ai_calls=True,
max_ai_proposals=3,
include_ai_calls=False,
max_ai_proposals=0,
auto_insert_proposals=False,
)
@@ -480,6 +496,7 @@ def suggest_progression_path(
ai_proposals=ai_proposals,
gap_fill_offers=gap_fill_offers,
off_topic_steps=off_topic_steps,
stripped_off_topic=stripped_off_topic,
llm_qa=llm_qa,
llm_applied=llm_qa_applied,
reorder_applied=reorder_applied,
@@ -499,6 +516,20 @@ def suggest_progression_path(
if gap_fill_offers:
retrieval_parts.append("gap_fill_offers")
progression_roadmap: Optional[Dict[str, Any]] = None
if body.include_roadmap_preview or body.roadmap_first:
roadmap_ctx = run_progression_roadmap_pipeline(
goal_query,
max_steps=max_steps,
semantic_brief=semantic_brief,
cur=cur,
include_llm_roadmap=body.include_llm_roadmap,
)
progression_roadmap = progression_roadmap_to_api_dict(roadmap_ctx)
retrieval_parts.append("roadmap_preview")
if body.roadmap_first:
retrieval_parts.append("roadmap_first_pending")
return {
"goal_query": goal_query,
"max_steps_requested": max_steps,
@@ -511,6 +542,8 @@ def suggest_progression_path(
"progression_graph_id": body.progression_graph_id,
"path_qa": path_qa,
"gap_fill_offers": gap_fill_offers,
"progression_roadmap": progression_roadmap,
"roadmap_first": body.roadmap_first,
"retrieval_phase": "+".join(retrieval_parts),
}