docs: add documentation and completion for --luna

docs/user-guide/commands.md

@@ -126,6 +126,8 @@ You can also use special shortcut options for easier timespan control:
 `--day` sets the log timespan to the current day (beginning at 00:00h)
 and `--year`, `--month` and `--week` to the current year, month or week
 respectively.
+The shortcut `--luna` sets the timespan to the current moon cycle with
+the last full moon marking the start of the cycle.
 
 If you are outputting to the terminal, you can selectively enable a pager
 through the `--pager` option.
@@ -172,6 +174,7 @@ Flag | Help
 `-t, --to DATE` | The date at which the log should stop (inclusive). Defaults to tomorrow.
 `-y, --year` | Reports activity for the current year.
 `-m, --month` | Reports activity for the current month.
+`-l, --luna` | Reports activity for the current moon cycle.
 `-w, --week` | Reports activity for the current week.
 `-d, --day` | Reports activity for the current day.
 `-a, --all` | Reports all activities.
@@ -329,6 +332,8 @@ You can also use special shortcut options for easier timespan control:
 `--day` sets the report timespan to the current day (beginning at 00:00h)
 and `--year`, `--month` and `--week` to the current year, month or week
 respectively.
+The shortcut `--luna` sets the timespan to the current moon cycle with
+the last full moon marking the start of the cycle.
 
 You can limit the report to a project or a tag using the `--project` and
 `--tag` options. They can be specified several times each to add multiple
@@ -416,6 +421,7 @@ Flag | Help
 `-t, --to DATE` | The date at which the report should stop (inclusive). Defaults to tomorrow.
 `-y, --year` | Reports activity for the current year.
 `-m, --month` | Reports activity for the current month.
+`-l, --luna` | Reports activity for the current moon cycle.
 `-w, --week` | Reports activity for the current week.
 `-d, --day` | Reports activity for the current day.
 `-a, --all` | Reports all activities.

watson.completion

@@ -58,7 +58,7 @@ _watson_complete () {
               COMPREPLY=($(compgen -W "$tags" -- ${cur}))
               ;;
             *)
-              COMPREPLY=($(compgen -W "-a -c -C -d -f -g -G -j -m -p -t -T -w -y --all --current --no-current --pager --no-pager --from --to --project --tag --day --week --month --year --json" -- ${cur})) ;;
+              COMPREPLY=($(compgen -W "-a -c -C -d -f -g -G -j -m -p -t -T -w -y --all --current --no-current --pager --no-pager --from --to --project --tag --day --week --month --year --luna --json" -- ${cur})) ;;
           esac
           ;;
         merge)

watson/cli.py

@@ -371,6 +371,8 @@ def report(watson, current, from_, to, projects, tags, year, month,
     `--day` sets the report timespan to the current day (beginning at 00:00h)
     and `--year`, `--month` and `--week` to the current year, month or week
     respectively.
+    The shortcut `--luna` sets the timespan to the current moon cycle with
+    the last full moon marking the start of the cycle.
 
     You can limit the report to a project or a tag using the `--project` and
     `--tag` options. They can be specified several times each to add multiple
@@ -580,6 +582,8 @@ def log(watson, current, from_, to, projects, tags, year, month, week, day,
     `--day` sets the log timespan to the current day (beginning at 00:00h)
     and `--year`, `--month` and `--week` to the current year, month or week
     respectively.
+    The shortcut `--luna` sets the timespan to the current moon cycle with
+    the last full moon marking the start of the cycle.
 
     If you are outputting to the terminal, you can selectively enable a pager
     through the `--pager` option.