kanban_output.py 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. """Text / ``--json`` output helpers shared by the ``hermes kanban`` CLI modules."""
  2. from __future__ import annotations
  3. import argparse
  4. import json
  5. import sys
  6. import time
  7. from typing import Any, Callable, Iterable, Optional
  8. from hermes_cli import kanban_db as kb
  9. from hermes_cli import kanban_workflow
  10. _STATUS_ICONS = {c.key: c.icon for c in kanban_workflow.DEFAULT_WORKFLOW} | {kanban_workflow.ARCHIVED: "—"}
  11. _TASK_DICT_FIELDS = (
  12. "id", "title", "body", "assignee", "status", "priority", "tenant",
  13. "workspace_kind", "workspace_path", "branch_name", "project_id",
  14. "created_by", "created_at", "started_at", "completed_at", "result",
  15. "skills", "max_runtime_seconds", "max_retries", "model_override", "provider_override",
  16. "session_id", "workflow_template_id", "current_step_key", "completion_contract", "last_failure_error",
  17. )
  18. _SHOW_RUN_FIELDS = (
  19. "id", "profile", "step_key", "status", "outcome", "summary", "error",
  20. "metadata", "worker_pid", "started_at", "ended_at",
  21. )
  22. _RUNS_RUN_FIELDS = (
  23. "id", "profile", "status", "outcome", "started_at", "ended_at",
  24. "summary", "error", "metadata", "worker_pid", "step_key",
  25. )
  26. _ATTACHMENT_FIELDS = ("id", "filename", "content_type", "size", "uploaded_by", "stored_path", "created_at")
  27. def _fmt_ts(ts: Optional[int]) -> str:
  28. return time.strftime("%Y-%m-%d %H:%M", time.localtime(ts)) if ts else ""
  29. def _print_json(obj: Any, *, ascii: bool = False) -> None:
  30. print(json.dumps(obj, indent=2, ensure_ascii=ascii))
  31. def _json_out(args: argparse.Namespace, obj: Any, *, ascii: bool = False) -> bool:
  32. """Print ``obj`` as JSON and return True when ``--json`` was passed."""
  33. if not getattr(args, "json", False):
  34. return False
  35. _print_json(obj, ascii=ascii)
  36. return True
  37. def _fmt_counts(counts: dict, empty: str = "") -> str:
  38. return ", ".join(f"{k}={v}" for k, v in sorted(counts.items())) or empty
  39. def _err(msg: str, rc: int = 1) -> int:
  40. print(msg, file=sys.stderr)
  41. return rc
  42. def _bulk_apply(ids: Iterable[str], op: Callable[[str], Any],
  43. ok_msg: Callable[[str], str], fail_msg: Callable[[str], str]) -> int:
  44. """Run ``op(tid) -> bool`` per id, print ok/fail lines, exit 1 if any failed."""
  45. failed = False
  46. for tid in ids:
  47. if op(tid):
  48. print(ok_msg(tid))
  49. else:
  50. failed = True
  51. print(fail_msg(tid), file=sys.stderr)
  52. return 1 if failed else 0
  53. def _fmt_task_line(t: kb.Task) -> str:
  54. icon = _STATUS_ICONS.get(t.status, "?")
  55. assignee = t.assignee or "(unassigned)"
  56. tenant = f" [{t.tenant}]" if t.tenant else ""
  57. return f"{icon} {t.id} {t.status:8s} {assignee:20s}{tenant} {t.title}"
  58. def _obj_dict(obj: Any, fields: tuple[str, ...]) -> dict[str, Any]:
  59. return {k: getattr(obj, k) for k in fields}
  60. def _task_to_dict(t: kb.Task) -> dict[str, Any]:
  61. d = _obj_dict(t, _TASK_DICT_FIELDS)
  62. d["skills"] = list(t.skills) if t.skills else []
  63. return d