crowdtime-cli 0.20.0__tar.gz → 0.21.0__tar.gz

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdtime-cli
-Version: 0.20.0
+Version: 0.21.0
 Summary: AI-powered time tracking CLI — a modern, developer-friendly alternative to Harvest
 Project-URL: Homepage, https://crowdtime.lat
 Project-URL: Documentation, https://crowdtime.lat/docs

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "crowdtime-cli"
-version = "0.20.0"
+version = "0.21.0"
 description = "AI-powered time tracking CLI — a modern, developer-friendly alternative to Harvest"
 readme = "README.md"
 license = {text = "Proprietary"}

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/src/crowdtime_cli/__init__.py

@@ -1,3 +1,3 @@
 """CrowdTime CLI - AI-powered time tracking from the command line."""
 
-__version__ = "0.20.0"
+__version__ = "0.21.0"

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/src/crowdtime_cli/commands/pto_cmd.py

@@ -55,7 +55,7 @@ console = Console()
 
 
 # Valid enum values mirrored from the contract.
-_VALID_KINDS = {"vacation", "sick", "holiday", "personal", "other"}
+_VALID_KINDS = {"vacation", "sick", "holiday", "personal", "birthday", "other"}
 _VALID_STATUSES = {"pending", "approved", "rejected", "canceled"}
 
 
@@ -211,7 +211,7 @@ def request_cmd(
         ...,
         help="Date or range: '2026-06-01', '2026-06-01:2026-06-05', 'today', 'next-monday'.",
     ),
-    kind: str = typer.Option("vacation", "--kind", "-k", help="vacation|sick|holiday|personal|other."),
+    kind: str = typer.Option("vacation", "--kind", "-k", help="vacation|sick|holiday|personal|birthday|other. Birthday: one day, once per calendar year."),
     hours_per_day: Optional[str] = typer.Option(
         None, "--hours-per-day",
         help="Decimal hours. Empty/omitted = full day from membership capacity.",
@@ -256,7 +256,7 @@ def add_cmd(
         ...,
         help="Date or range: '2026-06-01', '2026-06-01:2026-06-05', 'today', 'next-monday'.",
     ),
-    kind: str = typer.Option("vacation", "--kind", "-k", help="vacation|sick|holiday|personal|other."),
+    kind: str = typer.Option("vacation", "--kind", "-k", help="vacation|sick|holiday|personal|birthday|other. Birthday: one day, once per calendar year."),
     hours_per_day: Optional[str] = typer.Option(
         None, "--hours-per-day",
         help="Decimal hours per day. Omit for full-day from membership.",

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/src/crowdtime_cli/commands/timesheet_cmd.py

@@ -1,4 +1,4 @@
-"""Timesheet commands: list, submit, approve, reject, recall, reopen, team overview."""
+"""Timesheet commands: list, submit, remind, approve, reject, recall, reopen, team overview."""
 
 from __future__ import annotations
 
@@ -246,17 +246,27 @@ def submit_timesheet(
     period_end: str = typer.Option(
         ..., "--to", help="Period end date (YYYY-MM-DD or keyword)."
     ),
+    user: Optional[str] = typer.Option(
+        None, "--user", "-u",
+        help="Submit on someone's behalf (email or UUID). Reviewers only.",
+    ),
     force: bool = typer.Option(False, "--force", "-f", help="Skip confirmation prompt."),
     output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
 ) -> None:
     """Submit a timesheet for approval.
 
-    Computes total hours from your time entries in the given period.
+    Computes total hours from the time entries in the given period.
     Shows a preview of hours before submitting (use --force to skip).
 
+    --user submits a week someone logged but never sent. It needs the same
+    authority as approving their whole timesheet (admin, their manager, or
+    running every project they logged on); the submission is then reviewed
+    as usual.
+
     Examples:
         ct timesheet submit --from 2026-03-09 --to 2026-03-15
         ct timesheet submit --from monday --to friday --force
+        ct timesheet submit --from 2026-03-09 --to 2026-03-15 --user ana@acme.com
     """
     try:
         start = format_date(parse_date(period_start))
@@ -267,13 +277,23 @@ def submit_timesheet(
 
     client = CrowdTimeClient(require_auth=True, require_org=True)
 
+    user_id = None
+    if user:
+        from .pto_cmd import _resolve_user_to_uuid
+
+        try:
+            user_id = _resolve_user_to_uuid(client, user)
+        except APIError as e:
+            format_error(e.message)
+            raise typer.Exit(1)
+
     # Preview: fetch entries for the period and show summary before confirming
     if not force and not output_json:
         try:
-            entries_data = client.get("/time-entries/", params={
-                "date_from": start,
-                "date_to": end,
-            })
+            entry_params = {"date_from": start, "date_to": end}
+            if user_id:
+                entry_params["user"] = user_id
+            entries_data = client.get("/time-entries/", params=entry_params)
             entries = extract_results(entries_data)
             total_h = sum(Decimal(str(e.get("hours", 0))) for e in entries)
             billable_h = sum(
@@ -296,10 +316,10 @@ def submit_timesheet(
             pass  # If preview fails, proceed to submit (server will validate)
 
     try:
-        result = client.post("/timesheets/submit/", data={
-            "period_start": start,
-            "period_end": end,
-        })
+        payload = {"period_start": start, "period_end": end}
+        if user_id:
+            payload["user_id"] = user_id
+        result = client.post("/timesheets/submit/", data=payload)
 
         if output_json:
             print_json(result)
@@ -316,6 +336,50 @@ def submit_timesheet(
         raise typer.Exit(1)
 
 
+@app.command("remind")
+def remind_timesheet(
+    user: str = typer.Option(..., "--user", "-u", help="Who to remind (email or UUID)."),
+    period_start: str = typer.Option(
+        ..., "--from", help="Period start date (YYYY-MM-DD or keyword)."
+    ),
+    period_end: str = typer.Option(
+        ..., "--to", help="Period end date (YYYY-MM-DD or keyword)."
+    ),
+    output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
+) -> None:
+    """Email someone a reminder to submit their timesheet (project_manager+).
+
+    For a week they haven't submitted. One reminder per person and period an hour.
+
+    Examples:
+        ct timesheet remind --user ana@acme.com --from 2026-03-09 --to 2026-03-15
+    """
+    from .pto_cmd import _resolve_user_to_uuid
+
+    try:
+        start = format_date(parse_date(period_start))
+        end = format_date(parse_date(period_end))
+    except ValueError as e:
+        format_error(str(e))
+        raise typer.Exit(1)
+
+    client = CrowdTimeClient(require_auth=True, require_org=True)
+    try:
+        user_id = _resolve_user_to_uuid(client, user)
+        result = client.post("/timesheets/remind/", data={
+            "user_id": user_id,
+            "period_start": start,
+            "period_end": end,
+        })
+        if output_json:
+            print_json(result)
+        else:
+            format_success(f"Reminder sent to {user} for {start} → {end}.")
+    except APIError as e:
+        format_error(e.message)
+        raise typer.Exit(1)
+
+
 @app.command("approve")
 def approve_timesheet(
     timesheet_id: str = typer.Argument(..., help="Timesheet ID to approve."),

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/src/crowdtime_cli/skills/crowdtime/SKILL.md

@@ -300,6 +300,8 @@ ct timesheet list                       # List your timesheets
 ct timesheet list --status submitted    # Filter by status
 ct timesheet submit --from 2026-03-10 --to 2026-03-16  # Submit full week
 ct timesheet submit --from 2026-03-30 --to 2026-03-31  # Partial week (end-of-month split)
+ct timesheet submit --from 2026-03-10 --to 2026-03-16 --user ana@acme.com  # Submit a week someone logged but never sent (same authority as whole approve)
+ct timesheet remind --user ana@acme.com --from 2026-03-10 --to 2026-03-16  # Email them a reminder to submit (project_manager+)
 ct timesheet recall <id>                # Recall submitted timesheet back to draft (--force to skip confirm)
 ct timesheet approve <id>               # Approve the whole timesheet (admin, direct manager, or PM of every project in it)
 ct timesheet approve <id> --project <project-id>  # Approve one project's portion (PM for that project)
@@ -424,7 +426,7 @@ ct log 0.25 --project argo --task BE --notes "Daily standup"
 
 ### Time Off (PTO)
 
-Per-user time-off entries with a kind (vacation, sick, holiday, personal, other) and a status lifecycle (pending → approved/rejected; pending → canceled). Members submit requests that await approval, and their approvers are emailed automatically; project managers and above can also add PTO directly on behalf of someone in their scope (auto-approved).
+Per-user time-off entries with a kind (vacation, sick, holiday, personal, birthday, other) and a status lifecycle (pending → approved/rejected; pending → canceled). Members submit requests that await approval, and their approvers are emailed automatically; project managers and above can also add PTO directly on behalf of someone in their scope (auto-approved).
 
 > **IMPORTANT**: Never use magic routing (`ct "..."`) or `ct ai parse` for PTO operations. Always construct explicit `ct pto ...` commands.
 > Full reference: `references/pto.md` and `references/commands.md` § PTO.

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/src/crowdtime_cli/skills/crowdtime/references/commands.md

@@ -1735,13 +1735,14 @@ Lists your timesheets, plus — for managers and project managers — the timesh
 ### ct timesheet submit
 
 ```
-ct timesheet submit --from DATE --to DATE [--force/-f] [--json]
+ct timesheet submit --from DATE --to DATE [--user/-u USER] [--force/-f] [--json]
 ```
 
 | Option | Type | Description |
 |--------|------|-------------|
 | `--from` | string (required) | Period start date |
 | `--to` | string (required) | Period end date |
+| `--user`, `-u` | string | Submit on someone's behalf (email or UUID) |
 | `--force`, `-f` | flag | Skip confirmation prompt |
 | `--json` | flag | JSON output |
 
@@ -1749,6 +1750,23 @@ Submits a timesheet for the given period (any date range — not limited to full
 
 A zero-hour period is rejected **unless every working day in it is covered by approved time off** — a full vacation week has no time entries by design and is submitted as-is. If someone was away and the submit is rejected, the fix is an approved PTO entry (`ct pto request`), not a fake time entry. Endpoint: `POST /timesheets/submit/`
 
+`--user` submits a week someone logged but never sent (body `user_id`). It needs the same authority as approving their whole timesheet — admin/owner, their direct manager, or running every project they logged on that period — otherwise `403`. The submission is recorded as theirs (the audit event names who sent it) and is then approved or rejected as usual. To nudge them to do it themselves, use `ct timesheet remind`.
+
+### ct timesheet remind
+
+```
+ct timesheet remind --user USER --from DATE --to DATE [--json]
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `--user`, `-u` | string (required) | Who to remind (email or UUID) |
+| `--from` | string (required) | Period start date |
+| `--to` | string (required) | Period end date |
+| `--json` | flag | JSON output |
+
+Emails the person a reminder to submit their timesheet for the period, naming who asked (project_manager+, anyone on your roster — `ct timesheet viewable-users`). Refused with `400` when a timesheet for the period is already submitted or approved, and with `429` when that person was reminded about the same period less than an hour ago. Endpoint: `POST /timesheets/remind/` → `202`.
+
 ### ct timesheet approve
 
 ```
@@ -2740,7 +2758,7 @@ Submit a PTO request for yourself. Created with `status=pending` — must be app
 | Argument/Option | Type | Required | Description |
 |-----------------|------|----------|-------------|
 | `<dates>` | string | yes | `YYYY-MM-DD` or `YYYY-MM-DD:YYYY-MM-DD` |
-| `--kind`, `-k` | string | no | `vacation` (default), `sick`, `holiday`, `personal`, `other` |
+| `--kind`, `-k` | string | no | `vacation` (default), `sick`, `holiday`, `personal`, `birthday` (one day, once per calendar year), `other` |
 | `--hours-per-day`, `-h` | decimal | no | Hours/day. Empty = capacity-based default (see `references/pto.md`) |
 | `--notes`, `-n` | string | no | Reason or notes |
 | `--json` | flag | no | JSON output |
@@ -2786,7 +2804,7 @@ Add a PTO entry on behalf of another user (project manager and above). The entry
 |-----------------|------|----------|-------------|
 | `<user>` | string | yes | User email or UUID |
 | `<dates>` | string | yes | `YYYY-MM-DD` or `YYYY-MM-DD:YYYY-MM-DD` |
-| `--kind`, `-k` | string | no | `vacation` (default), `sick`, `holiday`, `personal`, `other` |
+| `--kind`, `-k` | string | no | `vacation` (default), `sick`, `holiday`, `personal`, `birthday` (one day, once per calendar year), `other` |
 | `--hours-per-day`, `-h` | decimal | no | Hours/day. Empty = capacity-based default |
 | `--notes`, `-n` | string | no | Reason or context notes |
 | `--json` | flag | no | JSON output |

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/src/crowdtime_cli/skills/crowdtime/references/pto.md

@@ -25,6 +25,7 @@ A `TimeOffEntry` represents a block of time off for a single user within an orga
 | `sick` | Sick Leave | Illness, medical appointment, recovery. |
 | `holiday` | Public Holiday | National or regional public holiday observed by the org. |
 | `personal` | Personal Day | Personal errands, family obligations, other non-vacation personal time. |
+| `birthday` | Birthday | The person's birthday day off. **One day, once per calendar year** — a second one in the same year, or a multi-day range, is rejected. |
 | `other` | Other | Anything that doesn't fit the above categories. |
 
 If the user doesn't specify a kind, default to `vacation` but **confirm before submitting**.

{crowdtime_cli-0.20.0 → crowdtime_cli-0.21.0}/src/crowdtime_cli/skills/crowdtime/references/workflows.md

@@ -634,6 +634,11 @@ ct timesheet reject <timesheet-id> --notes "Missing entries for Wednesday — pl
 # Reject multiple timesheets at once
 ct timesheet bulk-reject <id1> <id2> --notes "Incomplete entries for the week"
 
+# Someone logged the week but never submitted ("No timesheet" in `ct timesheet team`)?
+# There's nothing to reopen — nudge them, or submit it for them and then approve it
+ct timesheet remind --user ana@acme.com --from 2026-03-09 --to 2026-03-15
+ct timesheet submit --from 2026-03-09 --to 2026-03-15 --user ana@acme.com --force
+
 # Approved it too early? Reopen — back to draft, entries unlocked, user fixes & resubmits
 ct timesheet reopen <timesheet-id> --notes "Approved before Friday's entries were added"
 ct timesheet reopen <timesheet-id> --notes "Wrong project on Tuesday" --force
@@ -1477,7 +1482,7 @@ Use this when a member wants to request time off. The request goes into `pending
 
 **Before running any command, ask the user:**
 1. What dates? (single day or range) — if they say "next week" or "a few days in June", ASK for the exact dates. Never assume.
-2. What kind? (vacation / sick / holiday / personal / other) — if not specified, default to `vacation` and confirm.
+2. What kind? (vacation / sick / holiday / personal / birthday / other) — if not specified, default to `vacation` and confirm. Birthday is a single day, once per calendar year.
 3. Hours per day? — leave empty unless they want partial days (e.g. half-day sick leave).
 4. Notes? — optional but useful for the manager.