feat: add optional ticket selection to planning report generation

Add a `numbers` form field to the planning report endpoint, allowing
admins to generate a report for a specific subset of open tickets
instead of always planning all open tickets. The selected numbers are
parsed from a comma-separated string, deduplicated, and passed to the
background job. The job's scope is recorded in the audit log and the
Devii tool description is updated to document the new parameter.

devplacepy/services/devii/actions/catalog.py

@@ -965,13 +965,22 @@ ACTIONS: tuple[Action, ...] = (
         name="planning_report_generate",
         method="POST",
         path="/issues/planning",
-        summary="Queue an admin planning report of all open tickets.",
+        summary="Queue an admin planning report of open tickets.",
         description=(
-            "Queues a background job that builds a grouped, ordered markdown planning report "
-            "of every open ticket and returns {uid, status_url}. Poll the status_url until "
-            "status is 'done', then show the markdown and the download_url. Admin only."
+            "Queues a background job that builds a phased, ordered markdown implementation "
+            "document for open tickets and returns {uid, status_url}. Pass 'numbers' as a "
+            "comma-separated list of issue numbers to plan only those tickets; omit it to plan "
+            "every open ticket. Each ticket's full description is reproduced verbatim, both "
+            "inline and in a 'Source Tickets (verbatim)' appendix, so the document is "
+            "self-contained. Poll the status_url until status is 'done', then show the markdown "
+            "and the download_url. Admin only."
+        ),
+        params=(
+            body(
+                "numbers",
+                "Comma-separated issue numbers to include (e.g. '1,4,7'). Omit for all open tickets.",
+            ),
         ),
-        params=(),
         requires_auth=True,
         requires_admin=True,
     ),