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

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Assign an issue to a cycle (sprint)."""
+"""Assign a cycle to an issue via the FlyDocs Relay API."""
 
 import sys
 from pathlib import Path
@@ -11,34 +11,18 @@ if len(sys.argv) < 2:
     fail("Usage: assign_cycle.py <ref> [cycle_id]")
 
 ref = sys.argv[1]
+cycle_id = sys.argv[2] if len(sys.argv) >= 3 else None
+
 client = get_client()
 
-issue_uuid = client.resolve_issue_id(ref)
-if not issue_uuid:
-    fail(f"Issue not found: {ref}")
-
-# Use specified cycle or active cycle
-cycle_id = sys.argv[2] if len(sys.argv) > 2 else None
-cycle_name = cycle_id or ""
-if not cycle_id:
-    cycle = client.get_active_cycle()
-    if not cycle:
-        fail("No active cycle found")
-    cycle_id = cycle["id"]
-    cycle_name = cycle["name"]
-
-result = client.query(
-    """mutation($id: String!, $cycleId: String!) {
-        issueUpdate(id: $id, input: { cycleId: $cycleId }) {
-            success
-            issue { identifier }
-        }
-    }""",
-    {"id": issue_uuid, "cycleId": cycle_id},
-)
-
-if not result.get("data", {}).get("issueUpdate", {}).get("success"):
-    fail(f"Failed to assign cycle: {result}")
-
-issue = result["data"]["issueUpdate"]["issue"]
-output_json({"success": True, "issue": issue["identifier"], "cycle": cycle_name})
+body: dict = {}
+if cycle_id:
+    body["cycleId"] = cycle_id
+
+result = client.put(f"/issues/{ref}/cycle", body)
+
+output_json({
+    "success": result.get("success", True),
+    "issue": result.get("issue", ref),
+    "cycle": result.get("cycle", ""),
+})

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

@@ -1,44 +1,22 @@
 #!/usr/bin/env python3
-"""Assign an issue to a milestone."""
+"""Assign a milestone to an issue 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="Assign issue to milestone")
-parser.add_argument("ref", help="Issue reference (e.g., ENG-123)")
-parser.add_argument("milestone_id", nargs="?", default=None,
-                    help="Milestone UUID (positional)")
-parser.add_argument("--milestone", dest="milestone_flag", default=None,
-                    help="Milestone UUID (flag)")
-args = parser.parse_args()
-
-milestone_id = args.milestone_flag or args.milestone_id
-if not milestone_id:
-    fail("Milestone ID required. Usage: assign_milestone.py <ref> <milestone_id> or --milestone <id>")
+if len(sys.argv) < 3:
+    fail("Usage: assign_milestone.py <ref> <milestone_id>")
 
+ref, milestone_id = sys.argv[1], sys.argv[2]
 client = get_client()
 
-issue_uuid = client.resolve_issue_id(args.ref)
-if not issue_uuid:
-    fail(f"Issue not found: {args.ref}")
-
-result = client.query(
-    """mutation($id: String!, $milestoneId: String!) {
-        issueUpdate(id: $id, input: { projectMilestoneId: $milestoneId }) {
-            success
-            issue { identifier }
-        }
-    }""",
-    {"id": issue_uuid, "milestoneId": milestone_id},
-)
-
-update = result.get("data", {}).get("issueUpdate", {})
-if not update.get("success"):
-    fail(f"Failed to assign milestone: {result}")
+result = client.put(f"/issues/{ref}/milestone", {"milestoneId": milestone_id})
 
-issue = update.get("issue", {})
-output_json({"success": True, "issue": issue.get("identifier", args.ref), "milestone": milestone_id})
+output_json({
+    "success": result.get("success", True),
+    "issue": result.get("issue", ref),
+    "milestone": result.get("milestone", ""),
+})

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Add a comment to an issue."""
+"""Add a comment to an issue via the FlyDocs Relay API."""
 
 import sys
 from pathlib import Path
@@ -8,32 +8,22 @@ sys.path.insert(0, str(Path(__file__).parent))
 from flydocs_api import get_client, output_json, fail
 
 if len(sys.argv) < 2:
-    fail("Usage: comment.py <ref> [<comment>]  (or pipe via stdin)")
+    fail("Usage: comment.py <ref> [comment] | stdin")
 
 ref = sys.argv[1]
-body = sys.argv[2] if len(sys.argv) > 2 else ""
-if not body and not sys.stdin.isatty():
-    body = sys.stdin.read().strip()
-if not body:
-    fail("Provide comment as argument or pipe via stdin")
-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!, $body: String!) {
-        commentCreate(input: { issueId: $id, body: $body }) {
-            success
-            comment { id }
-        }
-    }""",
-    {"id": issue_uuid, "body": body},
-)
+# Comment from arg > stdin
+if len(sys.argv) >= 3:
+    body = sys.argv[2]
+elif not sys.stdin.isatty():
+    body = sys.stdin.read().strip()
+else:
+    fail("Provide comment as argument or via stdin")
 
-data = result.get("data", {}).get("commentCreate", {})
-if not data.get("success"):
-    fail(f"Failed to add comment: {result}")
+client = get_client()
+result = client.post(f"/issues/{ref}/comment", {"body": body})
 
-output_json({"success": True, "commentId": data.get("comment", {}).get("id", "")})
+output_json({
+    "success": result.get("success", True),
+    "commentId": result.get("commentId", ""),
+})

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Create a new issue in Linear."""
+"""Create a new issue via the FlyDocs Relay API."""
 
 import argparse
 import sys
@@ -15,10 +15,12 @@ def main():
     parser.add_argument("--type", required=True, choices=["feature", "bug", "chore", "idea"], dest="issue_type")
     parser.add_argument("--description", default="")
     parser.add_argument("--description-file", default="", dest="description_file")
-    parser.add_argument("--priority", type=int, default=3, choices=range(5))
-    parser.add_argument("--estimate", type=int, default=0, choices=[0, 1, 2, 3, 5])
+    parser.add_argument("--priority", type=int, default=3, help="Priority (0-4, relay translates per provider)")
+    parser.add_argument("--estimate", type=int, default=0, help="Estimate points (relay translates per provider)")
     parser.add_argument("--assignee", default=None)
-    parser.add_argument("--project", default=None)
+    parser.add_argument("--project", default=None, help="Project ID")
+    parser.add_argument("--labels", default=None, help="Comma-separated ad-hoc label names")
+    parser.add_argument("--milestone", default=None, help="Milestone ID or name (resolved by name lookup)")
     parser.add_argument("--triage", action="store_true")
     args = parser.parse_args()
 
@@ -32,68 +34,49 @@ def main():
     elif not description and not sys.stdin.isatty():
         description = sys.stdin.read().strip()
 
-    client = get_client()
-
-    issue_input = {
-        "teamId": client.team_id,
+    body: dict = {
         "title": args.title,
-        "description": description,
+        "type": args.issue_type,
         "priority": args.priority,
     }
+    if description:
+        body["description"] = description
     if args.estimate:
-        issue_input["estimate"] = args.estimate
-
-    # Labels
-    label_ids = []
-    cat_id = client.get_category_label_id(args.issue_type)
-    if cat_id:
-        label_ids.append(cat_id)
-    if args.triage:
-        triage_id = client.get_other_label_id("triage")
-        if triage_id:
-            label_ids.append(triage_id)
-    if label_ids:
-        issue_input["labelIds"] = label_ids
-
-    # Project
-    project_id = args.project
-    if not project_id:
-        active = client.workspace.get("activeProjects", [])
-        if active:
-            project_id = active[0]
-    if project_id:
-        issue_input["projectId"] = project_id
-
-    # Assignee
+        body["estimate"] = args.estimate
     if args.assignee:
-        user_id, _ = client.resolve_user_id(args.assignee)
-        if user_id:
-            issue_input["assigneeId"] = user_id
-
-    mutation = """mutation($input: IssueCreateInput!) {
-        issueCreate(input: $input) {
-            success
-            issue { id identifier title url }
-        }
-    }"""
-
-    result = client.query(mutation, {"input": issue_input})
+        body["assignee"] = args.assignee
+    if args.project:
+        body["projectId"] = args.project
+    if args.labels:
+        body["labels"] = [l.strip() for l in args.labels.split(",") if l.strip()]
+    if args.triage:
+        body["triage"] = True
 
-    data = result.get("data", {}).get("issueCreate", {})
-    if not data.get("success"):
-        # Retry without labels if team mismatch (stale label IDs in config)
-        errors = result.get("errors", [])
-        label_error = any("label" in (e.get("message", "") or "").lower() for e in errors)
-        if label_error and "labelIds" in issue_input:
-            print("Label IDs rejected — retrying without labels...", file=sys.stderr)
-            del issue_input["labelIds"]
-            result = client.query(mutation, {"input": issue_input})
-            data = result.get("data", {}).get("issueCreate", {})
-        if not data.get("success"):
-            fail(f"Failed to create issue: {result}")
+    client = get_client()
 
-    issue = data["issue"]
-    output_json({"id": issue["id"], "identifier": issue["identifier"], "title": issue["title"], "url": issue["url"]})
+    if args.milestone:
+        milestone_id = args.milestone
+        # If it doesn't look like a UUID, resolve by name
+        if len(milestone_id) != 36 or "-" not in milestone_id:
+            milestones = client.get("/milestones")
+            match = None
+            for m in milestones:
+                if m["name"].lower() == milestone_id.lower():
+                    match = m
+                    break
+            if not match:
+                fail(f"Milestone not found: {milestone_id}")
+            milestone_id = match["id"]
+        body["milestoneId"] = milestone_id
+
+    result = client.post("/issues", body)
+
+    output_json({
+        "id": result["id"],
+        "identifier": result["identifier"],
+        "title": result["title"],
+        "url": result["url"],
+    })
 
 
 if __name__ == "__main__":

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Create a milestone."""
+"""Create a milestone via the FlyDocs Relay API."""
 
 import argparse
 import sys
@@ -8,39 +8,28 @@ 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="Create milestone")
-parser.add_argument("--name", required=True)
-parser.add_argument("--project", default="", help="Project ID (defaults to first activeProject)")
-parser.add_argument("--target-date", default=None, help="YYYY-MM-DD")
-args = parser.parse_args()
-
-client = get_client()
-
-project_id = args.project
-if not project_id:
-    active = client.workspace.get("activeProjects", [])
-    if active:
-        project_id = active[0]
-    else:
-        fail("No --project specified and no activeProjects in config")
-
-milestone_input = {"name": args.name, "projectId": project_id}
-if args.target_date:
-    milestone_input["targetDate"] = args.target_date
-
-result = client.query(
-    """mutation($input: ProjectMilestoneCreateInput!) {
-        projectMilestoneCreate(input: $input) {
-            success
-            projectMilestone { id name }
-        }
-    }""",
-    {"input": milestone_input},
-)
-
-data = result.get("data", {}).get("projectMilestoneCreate", {})
-if not data.get("success"):
-    fail(f"Failed to create milestone: {result}")
-
-ms = data["projectMilestone"]
-output_json({"id": ms["id"], "name": ms["name"]})
+
+def main():
+    parser = argparse.ArgumentParser(description="Create milestone")
+    parser.add_argument("--name", required=True)
+    parser.add_argument("--project", default=None, help="Project ID")
+    parser.add_argument("--target-date", default=None, dest="target_date")
+    args = parser.parse_args()
+
+    body: dict = {"name": args.name}
+    if args.project:
+        body["projectId"] = args.project
+    if args.target_date:
+        body["targetDate"] = args.target_date
+
+    client = get_client()
+    result = client.post("/milestones", body)
+
+    output_json({
+        "id": result["id"],
+        "name": result["name"],
+    })
+
+
+if __name__ == "__main__":
+    main()

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Create a new project."""
+"""Create a project via the FlyDocs Relay API."""
 
 import argparse
 import sys
@@ -8,33 +8,26 @@ 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="Create project")
-parser.add_argument("--name", required=True)
-parser.add_argument("--description", default="")
-args = parser.parse_args()
-
-client = get_client()
-
-project_input = {
-    "name": args.name,
-    "teamIds": [client.team_id],
-}
-if args.description:
-    project_input["description"] = args.description
-
-result = client.query(
-    """mutation($input: ProjectCreateInput!) {
-        projectCreate(input: $input) {
-            success
-            project { id name url }
-        }
-    }""",
-    {"input": project_input},
-)
-
-data = result.get("data", {}).get("projectCreate", {})
-if not data.get("success"):
-    fail(f"Failed to create project: {result}")
-
-project = data["project"]
-output_json({"id": project["id"], "name": project["name"], "url": project["url"]})
+
+def main():
+    parser = argparse.ArgumentParser(description="Create project")
+    parser.add_argument("--name", required=True)
+    parser.add_argument("--description", default=None)
+    args = parser.parse_args()
+
+    body: dict = {"name": args.name}
+    if args.description:
+        body["description"] = args.description
+
+    client = get_client()
+    result = client.post("/projects", body)
+
+    output_json({
+        "id": result["id"],
+        "name": result["name"],
+        "url": result.get("url", ""),
+    })
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+"""Create a team/project 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
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Create team or project")
+    parser.add_argument("--name", required=True)
+    parser.add_argument("--key", default=None, help="Team key (e.g., PROD). Auto-generated if omitted.")
+    parser.add_argument("--description", default=None)
+    parser.add_argument("--parent", default=None, dest="parent_id", help="Parent team ID for sub-team (Linear only, ignored for Jira)")
+    args = parser.parse_args()
+
+    body: dict = {"name": args.name}
+    if args.key:
+        body["key"] = args.key
+    if args.description:
+        body["description"] = args.description
+    if args.parent_id:
+        body["parentId"] = args.parent_id
+
+    client = get_client()
+    result = client.post("/teams", body)
+
+    output_json({
+        "id": result["id"],
+        "name": result["name"],
+        "key": result.get("key", ""),
+    })
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,21 @@
+#!/usr/bin/env python3
+"""Delete a milestone 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, fail
+
+if len(sys.argv) < 2:
+    fail("Usage: delete_milestone.py <milestone_id>")
+
+milestone_id = sys.argv[1]
+
+client = get_client()
+result = client.delete(f"/milestones/{milestone_id}")
+
+output_json({
+    "success": result.get("success", True),
+    "id": result.get("id", milestone_id),
+})

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

@@ -1,5 +1,9 @@
 #!/usr/bin/env python3
-"""Set estimate on an issue."""
+"""Set estimate on an issue via the FlyDocs Relay API.
+
+The relay validates the estimate against the provider's scale server-side.
+Use get_estimate_scale.py to discover valid values before setting.
+"""
 
 import sys
 from pathlib import Path
@@ -8,31 +12,22 @@ sys.path.insert(0, str(Path(__file__).parent))
 from flydocs_api import get_client, output_json, fail
 
 if len(sys.argv) < 3:
-    fail("Usage: estimate.py <ref> <1-5>")
+    fail("Usage: estimate.py <ref> <points>")
 
 ref = sys.argv[1]
 try:
     estimate = int(sys.argv[2])
 except ValueError:
-    fail("Estimate must be a number (1-5)")
+    fail("Estimate must be a number")
+
+if estimate < 0:
+    fail("Estimate must be a non-negative integer")
 
 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!, $estimate: Int!) {
-        issueUpdate(id: $id, input: { estimate: $estimate }) {
-            success
-            issue { identifier estimate }
-        }
-    }""",
-    {"id": issue_uuid, "estimate": estimate},
-)
-
-if not result.get("data", {}).get("issueUpdate", {}).get("success"):
-    fail(f"Failed to set estimate: {result}")
-
-issue = result["data"]["issueUpdate"]["issue"]
-output_json({"success": True, "issue": issue["identifier"], "estimate": issue["estimate"]})
+result = client.put(f"/issues/{ref}/estimate", {"estimate": estimate})
+
+output_json({
+    "success": result.get("success", True),
+    "issue": result.get("issue", ref),
+    "estimate": result.get("estimate", estimate),
+})