@flydocs/cli 0.5.0-beta.9 → 0.6.0-alpha.10

package/template/.claude/skills/flydocs-cloud/scripts/list_issues.py

@@ -1,18 +1,18 @@
 #!/usr/bin/env python3
-"""List issues with optional filters."""
+"""List issues with optional filters via the FlyDocs Relay API."""
 
 import argparse
 import sys
 from pathlib import Path
 
 sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
+from flydocs_api import get_client, output_json
 
 
 def main():
     parser = argparse.ArgumentParser(description="List issues")
     parser.add_argument("--status", default="", help="Single status or comma-separated: READY,IMPLEMENTING,BLOCKED")
-    parser.add_argument("--active", action="store_true", help="All non-terminal states (excludes Done, Archived, Canceled, Duplicate)")
+    parser.add_argument("--active", action="store_true", help="All non-terminal states")
     parser.add_argument("--project", default="")
     parser.add_argument("--assignee", default="")
     parser.add_argument("--milestone", default="", help="Filter by milestone ID")
@@ -20,85 +20,24 @@ def main():
     parser.add_argument("--limit", type=int, default=50)
     args = parser.parse_args()
 
-    client = get_client()
-
-    # Build filter — all conditions added to base dict, then product scope applied last
-    filters = {"team": {"id": {"eq": client.team_id}}}
-
-    if args.project:
-        filters["project"] = {"id": {"eq": args.project}}
-
+    params: dict = {"limit": str(args.limit)}
+    if args.status:
+        params["status"] = args.status.upper()
     if args.active:
-        # Exclude terminal states
-        terminal = ["COMPLETE", "ARCHIVED", "CANCELED", "DUPLICATE"]
-        terminal_ids = [client.get_state_id(s) for s in terminal]
-        terminal_ids = [sid for sid in terminal_ids if sid]
-        if terminal_ids:
-            filters["state"] = {"id": {"nin": terminal_ids}}
-    elif args.status:
-        statuses = [s.strip().upper() for s in args.status.split(",")]
-        if len(statuses) == 1:
-            state_id = client.get_state_id(statuses[0])
-            if state_id:
-                filters["state"] = {"id": {"eq": state_id}}
-        else:
-            state_ids = [client.get_state_id(s) for s in statuses]
-            state_ids = [sid for sid in state_ids if sid]
-            if state_ids:
-                filters["state"] = {"id": {"in": state_ids}}
-
+        params["active"] = "true"
+    if args.project:
+        params["project"] = args.project
+    if args.assignee:
+        params["assignee"] = args.assignee
     if args.milestone:
-        filters["projectMilestone"] = {"id": {"eq": args.milestone}}
-
+        params["milestone"] = args.milestone
     if args.mine:
-        viewer = client.query("query { viewer { id } }")
-        user_id = viewer.get("data", {}).get("viewer", {}).get("id")
-        if user_id:
-            filters["assignee"] = {"id": {"eq": user_id}}
-    elif args.assignee:
-        user_id, _ = client.resolve_user_id(args.assignee)
-        if user_id:
-            filters["assignee"] = {"id": {"eq": user_id}}
+        params["mine"] = "true"
 
-    # Product scope applied last — wraps complete filter with label AND conditions
-    if not args.project:
-        filters = client.build_product_scope(filters)
-
-    result = client.query(
-        """query($filter: IssueFilter!, $limit: Int!) {
-            issues(filter: $filter, first: $limit, orderBy: updatedAt) {
-                nodes {
-                    id identifier title
-                    state { name }
-                    assignee { name }
-                    priority dueDate
-                    project { id name }
-                    projectMilestone { id name sortOrder }
-                }
-            }
-        }""",
-        {"filter": filters, "limit": args.limit},
-    )
+    client = get_client()
+    result = client.get("/issues", params=params)
 
-    nodes = result.get("data", {}).get("issues", {}).get("nodes", [])
-    issues = [
-        {
-            "id": n["id"],
-            "identifier": n["identifier"],
-            "title": n["title"],
-            "status": n.get("state", {}).get("name", ""),
-            "assignee": (n.get("assignee") or {}).get("name", ""),
-            "priority": n.get("priority", 0),
-            "dueDate": n.get("dueDate") or "",
-            "milestone": (n.get("projectMilestone") or {}).get("name", ""),
-            "milestoneId": (n.get("projectMilestone") or {}).get("id", ""),
-            "milestoneSortOrder": (n.get("projectMilestone") or {}).get("sortOrder", 0),
-            "project": (n.get("project") or {}).get("name", ""),
-            "projectId": (n.get("project") or {}).get("id", ""),
-        }
-        for n in nodes
-    ]
-    output_json(issues)
+    output_json(result)
 
 
 if __name__ == "__main__":

package/template/.claude/skills/flydocs-cloud/scripts/list_labels.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+"""List available team labels via the FlyDocs Relay API."""
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+from flydocs_api import get_client, output_json
+
+
+def main():
+    client = get_client()
+    result = client.get("/labels")
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/flydocs-cloud/scripts/list_milestones.py

@@ -1,40 +1,28 @@
 #!/usr/bin/env python3
-"""List milestones."""
+"""List milestones via the FlyDocs Relay API."""
 
 import argparse
 import sys
 from pathlib import Path
 
 sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-parser = argparse.ArgumentParser(description="List milestones")
-parser.add_argument("--all", action="store_true", dest="show_all", help="Include completed")
-args = parser.parse_args()
-
-client = get_client()
-
-# Linear doesn't have team-scoped milestones — query all accessible
-result = client.query(
-    """query {
-        projectMilestones(first: 50) {
-            nodes { id name sortOrder targetDate project { id name } }
-        }
-    }"""
-)
-
-nodes = result.get("data", {}).get("projectMilestones", {}).get("nodes", [])
-milestones = [
-    {
-        "id": n["id"],
-        "name": n["name"],
-        "sortOrder": n.get("sortOrder", 0),
-        "targetDate": n.get("targetDate", ""),
-        "project": (n.get("project") or {}).get("name", ""),
-        "projectId": (n.get("project") or {}).get("id", ""),
-    }
-    for n in nodes
-]
-# Sort by project then sortOrder for consistent display
-milestones.sort(key=lambda m: (m["project"], m["sortOrder"]))
-output_json(milestones)
+from flydocs_api import get_client, output_json
+
+
+def main():
+    parser = argparse.ArgumentParser(description="List milestones")
+    parser.add_argument("--all", action="store_true", dest="show_all")
+    args = parser.parse_args()
+
+    params: dict = {}
+    if args.show_all:
+        params["all"] = "true"
+
+    client = get_client()
+    result = client.get("/milestones", params=params)
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/flydocs-cloud/scripts/list_projects.py

@@ -1,45 +1,31 @@
 #!/usr/bin/env python3
-"""List projects."""
+"""List projects via the FlyDocs Relay API."""
 
 import argparse
 import sys
 from pathlib import Path
 
 sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-parser = argparse.ArgumentParser(description="List projects")
-parser.add_argument("--active", action="store_true", help="Only started projects")
-parser.add_argument("--all", action="store_true", dest="show_all", help="Include completed and canceled")
-args = parser.parse_args()
-
-client = get_client()
-
-filters = {"accessibleTeams": {"some": {"id": {"eq": client.team_id}}}}
-
-if args.active:
-    filters["state"] = {"eq": "started"}
-elif not args.show_all:
-    filters["state"] = {"nin": ["completed", "canceled"]}
-
-# Product scope — filter to activeProjects if configured (--all bypasses)
-if not args.show_all:
-    active_projects = client.workspace.get("activeProjects", [])
-    if active_projects:
-        if len(active_projects) == 1:
-            filters["id"] = {"eq": active_projects[0]}
-        else:
-            filters["id"] = {"in": active_projects}
-
-result = client.query(
-    """query($filter: ProjectFilter!) {
-        projects(filter: $filter, first: 50, orderBy: updatedAt) {
-            nodes { id name state description }
-        }
-    }""",
-    {"filter": filters},
-)
-
-nodes = result.get("data", {}).get("projects", {}).get("nodes", [])
-projects = [{"id": n["id"], "name": n["name"], "state": n.get("state", "")} for n in nodes]
-output_json(projects)
+from flydocs_api import get_client, output_json
+
+
+def main():
+    parser = argparse.ArgumentParser(description="List projects")
+    parser.add_argument("--active", action="store_true")
+    parser.add_argument("--all", action="store_true", dest="show_all")
+    args = parser.parse_args()
+
+    params: dict = {}
+    if args.active:
+        params["active"] = "true"
+    if args.show_all:
+        params["all"] = "true"
+
+    client = get_client()
+    result = client.get("/projects", params=params)
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/flydocs-cloud/scripts/list_providers.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+"""List available providers via the FlyDocs Relay API."""
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+from flydocs_api import get_client, output_json
+
+
+def main():
+    client = get_client()
+    result = client.get("/providers")
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/flydocs-cloud/scripts/list_statuses.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+"""List provider workflow states via the FlyDocs Relay API."""
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+from flydocs_api import get_client, output_json
+
+
+def main():
+    client = get_client()
+    result = client.get("/auth/statuses")
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/flydocs-cloud/scripts/list_teams.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+"""List available teams/projects via the FlyDocs Relay API."""
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+from flydocs_api import get_client, output_json
+
+
+def main():
+    client = get_client()
+    result = client.get("/teams")
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/flydocs-cloud/scripts/priority.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Set priority on an issue."""
+"""Set priority on an issue via the FlyDocs Relay API."""
 
 import sys
 from pathlib import Path
@@ -16,23 +16,14 @@ try:
 except ValueError:
     fail("Priority must be a number (0-4)")
 
-client = get_client()
-issue_uuid = client.resolve_issue_id(ref)
-if not issue_uuid:
-    fail(f"Issue not found: {ref}")
-
-result = client.query(
-    """mutation($id: String!, $priority: Int!) {
-        issueUpdate(id: $id, input: { priority: $priority }) {
-            success
-            issue { identifier priority }
-        }
-    }""",
-    {"id": issue_uuid, "priority": priority},
-)
+if priority not in range(5):
+    fail("Priority must be 0 (none), 1 (urgent), 2 (high), 3 (medium), or 4 (low)")
 
-if not result.get("data", {}).get("issueUpdate", {}).get("success"):
-    fail(f"Failed to set priority: {result}")
+client = get_client()
+result = client.put(f"/issues/{ref}/priority", {"priority": priority})
 
-issue = result["data"]["issueUpdate"]["issue"]
-output_json({"success": True, "issue": issue["identifier"], "priority": issue["priority"]})
+output_json({
+    "success": result.get("success", True),
+    "issue": result.get("issue", ref),
+    "priority": result.get("priority", priority),
+})

package/template/.claude/skills/flydocs-cloud/scripts/project_update.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Post a project health update."""
+"""Post a project update via the FlyDocs Relay API."""
 
 import argparse
 import sys
@@ -8,52 +8,38 @@ from pathlib import Path
 sys.path.insert(0, str(Path(__file__).parent))
 from flydocs_api import get_client, output_json, fail
 
-HEALTH_MAP = {"onTrack": "onTrack", "atRisk": "atRisk", "offTrack": "offTrack"}
-
-parser = argparse.ArgumentParser(description="Post project update")
-parser.add_argument("--health", required=True, choices=HEALTH_MAP.keys())
-parser.add_argument("--body", default="")
-parser.add_argument("--body-file", default="")
-parser.add_argument("--project", default=None)
-args = parser.parse_args()
-
-body = args.body
-if args.body_file:
-    try:
-        body = Path(args.body_file).read_text().strip()
-    except FileNotFoundError:
-        fail(f"File not found: {args.body_file}")
-if not body and not sys.stdin.isatty():
-    body = sys.stdin.read().strip()
-if not body:
-    fail("Provide --body, --body-file, or pipe via stdin")
-
-client = get_client()
-
-project_id = args.project
-if not project_id:
-    active = client.workspace.get("activeProjects", [])
-    if active:
-        project_id = active[0]
-if not project_id:
-    fail("No project specified and no active project configured")
-
-result = client.query(
-    """mutation($projectId: String!, $body: String!, $health: ProjectUpdateHealthType!) {
-        projectUpdateCreate(input: {
-            projectId: $projectId,
-            body: $body,
-            health: $health
-        }) {
-            success
-            projectUpdate { id }
-        }
-    }""",
-    {"projectId": project_id, "body": body, "health": HEALTH_MAP[args.health]},
-)
-
-data = result.get("data", {}).get("projectUpdateCreate", {})
-if not data.get("success"):
-    fail(f"Failed to post update: {result}")
-
-output_json({"success": True, "id": data.get("projectUpdate", {}).get("id", "")})
+
+def main():
+    parser = argparse.ArgumentParser(description="Post project update")
+    parser.add_argument("--health", required=True, choices=["onTrack", "atRisk", "offTrack"])
+    parser.add_argument("--body", default=None)
+    parser.add_argument("--body-file", default=None, dest="body_file")
+    args = parser.parse_args()
+
+    # Resolve body: --body-file > stdin > --body
+    body = args.body
+    if args.body_file:
+        try:
+            body = Path(args.body_file).read_text()
+        except FileNotFoundError:
+            fail(f"File not found: {args.body_file}")
+    elif body is None and not sys.stdin.isatty():
+        body = sys.stdin.read().strip()
+
+    if not body:
+        fail("Provide body via --body, --body-file, or stdin")
+
+    client = get_client()
+    result = client.post("/projects/update", {
+        "health": args.health,
+        "body": body,
+    })
+
+    output_json({
+        "success": result.get("success", True),
+        "id": result.get("id", ""),
+    })
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/flydocs-cloud/scripts/refresh_labels.py

@@ -0,0 +1,87 @@
+#!/usr/bin/env python3
+"""Refresh label config from the relay — validates and updates local config.
+
+Fetches current team labels from the relay, compares against local config,
+and reports any stale or missing label IDs. With --fix, updates local config
+to match the relay's current state.
+"""
+
+import json
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+from flydocs_api import get_client, output_json, fail
+
+
+def main():
+    fix_mode = "--fix" in sys.argv
+
+    client = get_client()
+
+    # Fetch current labels from relay
+    labels = client.get("/labels")
+    label_map = {l["id"]: l["name"] for l in labels}
+    label_by_name = {l["name"].lower(): l["id"] for l in labels}
+
+    # Load local config
+    config_path = client.config_path
+    if not config_path.exists():
+        fail("No .flydocs/config.json found")
+
+    with open(config_path, "r") as f:
+        config = json.load(f)
+
+    issue_labels = config.get("issueLabels", {})
+    stale: list[dict] = []
+    valid: list[dict] = []
+
+    # Check each label ID in config against relay
+    for category, entries in issue_labels.items():
+        if isinstance(entries, dict):
+            for key, label_id in entries.items():
+                if label_id in label_map:
+                    valid.append({"category": category, "key": key, "id": label_id, "name": label_map[label_id]})
+                else:
+                    # Try to find by key name
+                    resolved = label_by_name.get(key.lower())
+                    stale.append({
+                        "category": category,
+                        "key": key,
+                        "staleId": label_id,
+                        "resolvedId": resolved,
+                        "resolvedName": key if resolved else None,
+                    })
+
+    if fix_mode and stale:
+        # Update stale IDs in config
+        fixed = 0
+        for item in stale:
+            if item["resolvedId"]:
+                issue_labels[item["category"]][item["key"]] = item["resolvedId"]
+                fixed += 1
+
+        with open(config_path, "w") as f:
+            json.dump(config, f, indent=2)
+            f.write("\n")
+
+        output_json({
+            "success": True,
+            "valid": len(valid),
+            "stale": len(stale),
+            "fixed": fixed,
+            "unfixable": len(stale) - fixed,
+            "details": stale,
+        })
+    else:
+        output_json({
+            "valid": len(valid),
+            "stale": len(stale),
+            "totalProviderLabels": len(labels),
+            "details": stale if stale else "All label IDs are current",
+            "hint": "Run with --fix to update stale IDs" if stale else None,
+        })
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/skills/flydocs-cloud/scripts/set_identity.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+"""Set provider identity via the FlyDocs Relay API.
+
+Binds the user's provider-specific ID to their FlyDocs user record.
+Once set, ?mine=true resolves via exact provider ID matching.
+"""
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+from flydocs_api import get_client, output_json, fail
+
+VALID_PROVIDERS = ("linear", "jira", "gitlab")
+
+if len(sys.argv) < 3:
+    fail(f"Usage: set_identity.py <provider> <provider-user-id>\n  Providers: {', '.join(VALID_PROVIDERS)}")
+
+provider = sys.argv[1].lower()
+provider_id = sys.argv[2]
+
+if provider not in VALID_PROVIDERS:
+    fail(f"Invalid provider: {provider}. Must be one of: {', '.join(VALID_PROVIDERS)}")
+
+if not provider_id:
+    fail("Provider user ID cannot be empty")
+
+client = get_client()
+result = client.post("/auth/identity", {
+    "provider": provider,
+    "providerId": provider_id,
+})
+
+output_json({
+    "success": result.get("success", True),
+    "provider": result.get("provider", provider),
+    "providerId": result.get("providerId", provider_id),
+})

package/template/.claude/skills/flydocs-cloud/scripts/set_labels.py

@@ -0,0 +1,68 @@
+#!/usr/bin/env python3
+"""Set label config on the relay API key.
+
+Configures default labels and type-to-label mapping for automatic label
+application during issue creation.
+
+Usage:
+    set_labels.py --defaults '["app"]' --type-map '{"feature":["Feature"],...}'
+    echo '{"defaults":["app"],"typeMap":{...}}' | set_labels.py
+"""
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+from flydocs_api import get_client, output_json, fail
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Set label config on relay")
+    parser.add_argument("--defaults", default=None, help="JSON array of default label names")
+    parser.add_argument("--type-map", default=None, dest="type_map", help="JSON object mapping issue types to label arrays")
+    args = parser.parse_args()
+
+    # Build body from flags or stdin
+    if args.defaults is not None or args.type_map is not None:
+        body: dict = {}
+        if args.defaults is not None:
+            try:
+                body["defaults"] = json.loads(args.defaults)
+            except json.JSONDecodeError:
+                fail("Invalid JSON for --defaults")
+        if args.type_map is not None:
+            try:
+                body["typeMap"] = json.loads(args.type_map)
+            except json.JSONDecodeError:
+                fail("Invalid JSON for --type-map")
+    elif not sys.stdin.isatty():
+        try:
+            body = json.loads(sys.stdin.read().strip())
+        except json.JSONDecodeError:
+            fail("Invalid JSON on stdin")
+    else:
+        fail("Provide --defaults/--type-map flags or pipe JSON via stdin")
+
+    client = get_client()
+    result = client.post("/auth/labels", body)
+
+    # Store label config in local config as reference
+    config_path = client.config_path
+    if config_path.exists():
+        with open(config_path, "r") as f:
+            config = json.load(f)
+        config["labels"] = {
+            "defaults": body.get("defaults", []),
+            "typeMap": body.get("typeMap", {}),
+        }
+        with open(config_path, "w") as f:
+            json.dump(config, f, indent=2)
+            f.write("\n")
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()