crowdtime-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdtime-cli
-Version: 0.3.0
+Version: 0.4.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
@@ -118,7 +118,9 @@ ct report --week
 | `ct org list` | — | List your organizations |
 | `ct org switch <slug>` | — | Switch active organization |
 | `ct org members` | — | List organization members |
-| `ct org invite <email>` | — | Invite a new member |
+| `ct org invite <email>` | — | Invite a new member (roles: viewer, member, project_manager, manager, admin) |
+| `ct org invitations` | — | List pending invitations |
+| `ct org resend-invite <id>` | — | Resend a pending invitation email |
 
 ### Reporting & AI
 

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/README.md

@@ -84,7 +84,9 @@ ct report --week
 | `ct org list` | — | List your organizations |
 | `ct org switch <slug>` | — | Switch active organization |
 | `ct org members` | — | List organization members |
-| `ct org invite <email>` | — | Invite a new member |
+| `ct org invite <email>` | — | Invite a new member (roles: viewer, member, project_manager, manager, admin) |
+| `ct org invitations` | — | List pending invitations |
+| `ct org resend-invite <id>` | — | Resend a pending invitation email |
 
 ### Reporting & AI
 

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/pyproject.toml

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

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/src/crowdtime_cli/__init__.py

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

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/src/crowdtime_cli/commands/org_cmd.py

@@ -43,7 +43,7 @@ def list_orgs(
         table.add_column("", width=3)
         table.add_column("Name", width=20)
         table.add_column("Slug", width=15)
-        table.add_column("Role", width=10)
+        table.add_column("Role", width=18)
         table.add_column("Members", justify="right", width=8)
 
         for org in orgs:
@@ -113,7 +113,10 @@ def members(
 @app.command()
 def invite(
     email: str = typer.Argument(..., help="Email address to invite."),
-    role: str = typer.Option("member", "--role", "-r", help="Role: admin, manager, member."),
+    role: str = typer.Option(
+        "member", "--role", "-r",
+        help="Role: admin, manager (account), project_manager, member, viewer.",
+    ),
     output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
 ) -> None:
     """Invite a member to the current organization."""
@@ -132,3 +135,74 @@ def invite(
     except APIError as e:
         format_error(e.message)
         raise typer.Exit(1)
+
+
+@app.command("resend-invite")
+def resend_invite(
+    invitation_id: str = typer.Argument(..., help="Invitation ID to resend."),
+    output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
+) -> None:
+    """Resend a pending invitation email."""
+    client = CrowdTimeClient(require_auth=True, require_org=True)
+
+    try:
+        data = client.post(f"/invitations/{invitation_id}/resend/")
+
+        if output_json:
+            print_json(data)
+        else:
+            format_success("Invitation email resent.")
+    except APIError as e:
+        format_error(e.message)
+        raise typer.Exit(1)
+
+
+@app.command()
+def invitations(
+    output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
+) -> None:
+    """List pending invitations for the current organization."""
+    client = CrowdTimeClient(require_auth=True, require_org=True)
+
+    try:
+        data = client.get("/invitations/")
+        inv_list = data if isinstance(data, list) else data.get("results", [])
+
+        if output_json:
+            print_json(inv_list)
+            return
+
+        pending = [i for i in inv_list if i.get("status") == "pending"]
+        if not pending:
+            console.print("[dim]No pending invitations.[/dim]")
+            return
+
+        table = Table(show_header=True, header_style="bold")
+        table.add_column("ID", style="dim")
+        table.add_column("Email", width=25)
+        table.add_column("Role", width=18)
+        table.add_column("Status", width=10)
+        table.add_column("Expires", width=12)
+
+        role_labels = {
+            "owner": "Owner",
+            "admin": "Admin",
+            "manager": "Account Manager",
+            "project_manager": "Project Manager",
+            "member": "Member",
+            "viewer": "Viewer",
+        }
+
+        for inv in pending:
+            table.add_row(
+                inv.get("id", ""),
+                inv.get("email", ""),
+                role_labels.get(inv.get("role", ""), inv.get("role", "")),
+                inv.get("status", ""),
+                inv.get("expires_at", "")[:10] if inv.get("expires_at") else "",
+            )
+
+        console.print(table)
+    except APIError as e:
+        format_error(e.message)
+        raise typer.Exit(1)

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/src/crowdtime_cli/formatters.py

@@ -362,6 +362,16 @@ def format_report(data: list[dict[str, Any]], group_by: str = "project") -> None
     console.print(table)
 
 
+ROLE_LABELS = {
+    "owner": "Owner",
+    "admin": "Admin",
+    "manager": "Account Manager",
+    "project_manager": "Project Manager",
+    "member": "Member",
+    "viewer": "Viewer",
+}
+
+
 def format_members_table(members: list[dict[str, Any]]) -> None:
     """Display organization members in a table."""
     if not members:
@@ -371,15 +381,17 @@ def format_members_table(members: list[dict[str, Any]]) -> None:
     table = Table(show_header=True, header_style="bold")
     table.add_column("Name", width=20)
     table.add_column("Email", width=25)
-    table.add_column("Role", width=10)
+    table.add_column("Role", width=18)
     table.add_column("Status", width=10)
 
     for m in members:
         status = "[green]Active[/green]" if m.get("is_active", True) else "[dim]Inactive[/dim]"
+        role = m.get("role", "member")
+        role_label = ROLE_LABELS.get(role, role)
         table.add_row(
             m.get("user_name", ""),
             m.get("user_email", ""),
-            m.get("role", "member"),
+            role_label,
             status,
         )
 

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/src/crowdtime_cli/skills/crowdtime/SKILL.md

@@ -213,9 +213,22 @@ ct invoice retainer reverse-withdrawal <id> -w <wd-id> -r "reason"  # Reverse a
 ct org list                             # List your organizations
 ct org switch <slug>                    # Switch active organization
 ct org members                          # List members
+ct org invitations                      # List pending invitations
 ct org invite user@example.com -r member
+ct org invite client@acme.com -r viewer              # External client stakeholder (read-only)
+ct org invite pm@company.com -r project_manager      # Project manager (no financial access)
+ct org invite billing@company.com -r manager          # Account manager (full financial access)
+ct org resend-invite <invitation-id>                  # Resend a pending invitation
 ```
 
+**Role hierarchy** (lowest → highest):
+- **viewer** — external client stakeholder, read-only access scoped to assigned projects
+- **member** — can log time, manage own entries
+- **project_manager** — manage projects, tasks, timesheets, team time; no financial data
+- **manager** (Account Manager) — everything project_manager does + invoices, rates, clients, billing
+- **admin** — manage org settings, members, integrations
+- **owner** — full control, can delete org
+
 ### Configuration
 ```bash
 ct config list                          # Show all config

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/src/crowdtime_cli/skills/crowdtime/references/commands.md

@@ -745,10 +745,33 @@ ct org invite EMAIL [--role/-r ROLE] [--json]
 
 | Option | Type | Description |
 |--------|------|-------------|
-| `--role`, `-r` | string | `admin`, `manager`, `member` (default) |
+| `--role`, `-r` | string | `admin`, `manager`, `project_manager`, `member` (default), `viewer` |
+
+**Roles:**
+- `viewer` — external client stakeholder, read-only access scoped to assigned projects
+- `member` — can log time, manage own entries
+- `project_manager` — manage projects, tasks, timesheets, team time; no financial data (rates, invoices)
+- `manager` — Account Manager: project management + invoices, rates, clients, billing
+- `admin` — manage org settings, members, integrations
 
 Endpoint: `POST /members/invite/`
 
+### ct org invitations
+
+```
+ct org invitations [--json]
+```
+
+Lists pending invitations for the current organization. Endpoint: `GET /invitations/`
+
+### ct org resend-invite
+
+```
+ct org resend-invite INVITATION_ID [--json]
+```
+
+Resends the invitation email for a pending invitation. Endpoint: `POST /invitations/{id}/resend/`
+
 ---
 
 ## ct config

{crowdtime_cli-0.3.0 → crowdtime_cli-0.4.0}/src/crowdtime_cli/skills/crowdtime/references/workflows.md

@@ -173,18 +173,43 @@ ct l -p acme -d 2026-03-05 3h "client meeting"
 ### Onboard a New Team Member
 
 ```bash
-# Invite them
+# Invite a regular team member
 ct org invite newdev@company.com -r member
 
-# They need to:
-# 1. Accept the invitation (via email link)
-# 2. Install CLI: pip install crowdtime-cli
-# 3. Configure:
-#    ct config set server.url https://your-server.com
-#    ct auth login
-#    ct org switch your-org
+# Invite a project manager (can manage projects/tasks/timesheets, no financial access)
+ct org invite pm@company.com -r project_manager
+
+# Invite an account manager (full financial access: invoices, rates, clients)
+ct org invite billing@company.com -r manager
+
+# Invite an external client stakeholder (read-only, scoped to their projects)
+ct org invite client@acme.com -r viewer
+
+# They receive an email with an "Accept Invitation" link
+# New users can sign up with email/password or Google OAuth
+```
+
+### Manage Invitations
+
+```bash
+# List pending invitations
+ct org invitations
+
+# Resend an invitation email
+ct org resend-invite <invitation-id>
 ```
 
+### Role Reference
+
+| Role | Description |
+|------|-------------|
+| `viewer` | External client: read-only, scoped to assigned projects |
+| `member` | Logs time, manages own entries |
+| `project_manager` | Manages projects, tasks, timesheets, team time. No financial data |
+| `manager` | Account Manager: everything above + invoices, rates, clients, billing |
+| `admin` | Manages org settings, members, integrations |
+| `owner` | Full control including org deletion |
+
 ### Check Team Activity
 
 ```bash