feat(plan): services/planning — start_planning aggregator

src/fabledassistant/services/planning.py

@@ -0,0 +1,63 @@
+"""Planning service — start_planning aggregates plan-task creation with the
+project's applicable Rulebook rules and a little context, so planning happens
+in Scribe and rules surface at the planning moment.
+"""
+from __future__ import annotations
+
+from fabledassistant.services import notes as notes_svc
+from fabledassistant.services import projects as projects_svc
+from fabledassistant.services import rulebooks as rulebooks_svc
+
+PLAN_TEMPLATE = """## Goal
+
+## Approach
+
+## Steps
+- [ ]
+
+## Verification
+"""
+
+
+async def start_planning(user_id: int, project_id: int, title: str) -> dict:
+    """Create a plan-task seeded with the plan template and return it with the
+    project's applicable rules + brief context.
+
+    Returns:
+        {
+          "task": <task dict>,
+          "applicable_rules": [...],
+          "subscribed_rulebooks": [...],
+          "applicable_rules_truncated": bool,
+          "project_goal": str,
+          "open_task_count": int,
+        }
+    """
+    project = await projects_svc.get_project(user_id, project_id)
+    if project is None:
+        raise ValueError(f"project {project_id} not found")
+
+    note = await notes_svc.create_note(
+        user_id,
+        title=title,
+        body=PLAN_TEMPLATE,
+        status="todo",
+        task_kind="plan",
+        project_id=project_id,
+    )
+
+    applicable = await rulebooks_svc.get_applicable_rules(
+        project_id=project_id, user_id=user_id,
+    )
+    _, open_count = await notes_svc.list_notes(
+        user_id, is_task=True, status="todo", project_id=project_id, limit=1,
+    )
+
+    return {
+        "task": note.to_dict(),
+        "applicable_rules": applicable["rules"],
+        "subscribed_rulebooks": applicable["subscribed_rulebooks"],
+        "applicable_rules_truncated": applicable["truncated"],
+        "project_goal": getattr(project, "goal", "") or "",
+        "open_task_count": open_count,
+    }