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

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_teams.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+"""List available teams 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/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()

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

@@ -0,0 +1,41 @@
+#!/usr/bin/env python3
+"""Set team preference via the FlyDocs Relay API.
+
+Stores the team preference on the relay (for server-side scoping)
+and updates the local config (for display/reference).
+"""
+
+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 team preference")
+    parser.add_argument("team_id", help="Linear team UUID")
+    args = parser.parse_args()
+
+    client = get_client()
+    result = client.post("/auth/team", {"teamId": args.team_id})
+
+    # Update local config with team ID
+    config_path = client.config_path
+    if config_path.exists():
+        with open(config_path, "r") as f:
+            config = json.load(f)
+        if "provider" not in config:
+            config["provider"] = {"type": "linear", "teamId": None}
+        config["provider"]["teamId"] = args.team_id
+        with open(config_path, "w") as f:
+            json.dump(config, f, indent=2)
+            f.write("\n")
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()

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

@@ -1,7 +1,6 @@
 #!/usr/bin/env python3
 """Transition an issue to a new status with a required comment."""
 
-import json
 import sys
 from pathlib import Path
 
@@ -14,54 +13,14 @@ if len(sys.argv) < 4:
 ref, status, comment = sys.argv[1], sys.argv[2].upper(), sys.argv[3]
 client = get_client()
 
-# Resolve issue
-issue_uuid = client.resolve_issue_id(ref)
-if not issue_uuid:
-    fail(f"Issue not found: {ref}")
-
-# Get current state for previousStatus
-current_result = client.query(
-    """query($id: String!) {
-        issue(id: $id) { state { name } }
-    }""",
-    {"id": issue_uuid},
-)
-prev_state = (current_result.get("data") or {}).get("issue", {}).get("state", {}).get("name", "Unknown")
-
-# Resolve target state
-state_id = client.get_state_id(status)
-if not state_id:
-    fail(f"Unknown status: {status}. Check statusMapping in .flydocs/config.json")
-
-# Build mutation input — combine state + cycle in one call
-mutation_input: dict = {"stateId": state_id}
-if status == "IMPLEMENTING":
-    cycle = client.get_active_cycle()
-    if cycle:
-        mutation_input["cycleId"] = cycle["id"]
-
-# Update state (and cycle if IMPLEMENTING) in a single mutation
-result = client.query(
-    """mutation($id: String!, $input: IssueUpdateInput!) {
-        issueUpdate(id: $id, input: $input) {
-            success
-            issue { identifier state { name } }
-        }
-    }""",
-    {"id": issue_uuid, "input": mutation_input},
-)
-update_data = result.get("data", {}).get("issueUpdate", {})
-if not update_data.get("success"):
-    fail(f"Failed to transition: {result}")
-
-# Add comment
-formatted = f"**{status}** — {comment}"
-client.query(
-    """mutation($id: String!, $body: String!) {
-        commentCreate(input: { issueId: $id, body: $body }) { success }
-    }""",
-    {"id": issue_uuid, "body": formatted},
-)
-
-issue = update_data["issue"]
-output_json({"success": True, "issue": issue["identifier"], "previousStatus": prev_state, "newStatus": status})
+result = client.post(f"/issues/{ref}/transition", {
+    "status": status,
+    "comment": comment,
+})
+
+output_json({
+    "success": result.get("success", True),
+    "issue": result.get("issue", ref),
+    "previousStatus": result.get("previousStatus", ""),
+    "newStatus": result.get("newStatus", status),
+})