workstream-cli 0.0.1__py3-none-any.whl

workstream/commands/stale.py

@@ -0,0 +1,116 @@
+"""ws stale — find workstreams that need attention."""
+
+from __future__ import annotations
+
+from datetime import date
+from pathlib import Path
+from face import Command
+
+from workstream.config import Config
+from workstream.cli import load_all_workstreams
+from workstream.models import Workstream
+
+
+def get_stale_workstreams(
+    workstreams_dir: Path,
+    days: int = 7,
+) -> tuple[list[Workstream], list[Workstream], list[Workstream], list[Workstream], list[Workstream]]:
+    """Return (snoozed_stale, active_idle, snoozed_expired, needs_direction, blocked) workstreams."""
+    workstreams = load_all_workstreams(workstreams_dir)
+
+    snoozed_stale = [
+        w for w in workstreams
+        if w.status == 'snoozed' and w.days_idle() > days
+    ]
+    active_idle = [
+        w for w in workstreams
+        if w.status == 'active' and w.days_idle() > days
+    ]
+
+    # Sort both by days idle descending
+    snoozed_stale.sort(key=lambda w: w.days_idle(), reverse=True)
+    active_idle.sort(key=lambda w: w.days_idle(), reverse=True)
+
+    today_str = date.today().isoformat()
+    snoozed_expired = [
+        w for w in workstreams
+        if w.snooze_until and w.snooze_until <= today_str
+    ]
+    snoozed_expired.sort(key=lambda w: w.snooze_until)
+
+    needs_direction = [
+        w for w in workstreams
+        if w.needs_direction()
+    ]
+
+    blocked = [
+        w for w in workstreams
+        if w.status == 'blocked'
+    ]
+    blocked.sort(key=lambda w: w.days_idle(), reverse=True)
+
+    return snoozed_stale, active_idle, snoozed_expired, needs_direction, blocked
+
+
+def _stale_handler(config: Config, days: int = 7) -> None:
+    snoozed_stale, active_idle, snoozed_expired, needs_direction, blocked = get_stale_workstreams(
+        config.workstreams_path, days=days,
+    )
+
+    if not snoozed_stale and not active_idle and not snoozed_expired and not needs_direction and not blocked:
+        print('Nothing stale. Nice work.')
+        return
+
+    print(f'Stale workstreams (no activity in {days}+ days):')
+    print()
+
+    if snoozed_stale:
+        print('  SNOOZED (check if still blocked):')
+        for ws in snoozed_stale:
+            idle = ws.days_idle()
+            print(f'  - {ws.title} (snoozed {idle} days ago)')
+            if ws.snooze_reason:
+                print(f'    Reason: "{ws.snooze_reason}"')
+        print()
+
+    if active_idle:
+        print('  IDLE (active but no recent work):')
+        for ws in active_idle:
+            idle = ws.days_idle()
+            last = ws.computed_last_activity
+            print(f'  - {ws.title} ({idle} days) -- last: {last}')
+        print()
+
+    if snoozed_expired:
+        today_str = date.today().isoformat()
+        print('  SNOOZED (snooze expired, needs attention):')
+        for ws in snoozed_expired:
+            print(f'  - {ws.title} (snoozed until {ws.snooze_until}, {ws.snooze_count} times)')
+            expired_thoughts = [
+                t for t in ws.thoughts
+                if t.snooze_until and t.snooze_until <= today_str
+            ]
+            if expired_thoughts:
+                print('    Thoughts:')
+                for t in expired_thoughts:
+                    print(f'    - [{t.date}] {t.text} (snoozed until {t.snooze_until})')
+
+    if needs_direction:
+        print('  NEEDS DIRECTION (active but no clear next step):')
+        for ws in needs_direction:
+            print(f'  - {ws.title} (no next actions, no active plans)')
+        print()
+
+    if blocked:
+        print('  BLOCKED (waiting on external dependency):')
+        for ws in blocked:
+            idle = ws.days_idle()
+            print(f'  - {ws.title} ({idle} days idle)')
+            if ws.blocked_notes:
+                print(f'    Blocked: "{ws.blocked_notes}"')
+        print()
+
+def get_command() -> Command:
+    cmd = Command(_stale_handler, name='stale', doc='Find stale workstreams needing attention.')
+    cmd.add('--days', parse_as=int, missing=7, doc='Idle threshold in days')
+    return cmd