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

package/template/.claude/skills/flydocs-cloud/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: flydocs-cloud
 description: |
-  Connected issue management via Linear GraphQL API.
-  Implements the FlyDocs mechanism contract with extended cloud-only operations.
+  Connected issue management via FlyDocs Relay API.
+  Implements the FlyDocs mechanism contract with extended cloud operations.
+  All provider translation (Linear, Jira) happens server-side.
 triggers:
   - create issue
   - transition
@@ -18,7 +19,9 @@ triggers:
 
 # FlyDocs Cloud Mechanism
 
-Issues managed in Linear. Reads config from `.flydocs/config.json` and API key from `.env`.
+Issues managed via the FlyDocs Relay API. The relay handles provider translation server-side — scripts are thin REST wrappers.
+
+Reads config from `.flydocs/config.json` and API key (`FLYDOCS_API_KEY`) from `.env`.
 
 ## Script Catalog
 
@@ -26,42 +29,51 @@ All scripts: `python3 .claude/skills/flydocs-cloud/scripts/<script>`
 
 ### Shared Contract Scripts
 
-| Script | Usage | Output |
-|--------|-------|--------|
-| `create_issue.py` | `--title "..." --type feature [--description "..."] [--description-file PATH] [--priority 0-4] [--estimate 1-5] [--assignee STR] [--triage] \| stdin` | `{id, identifier, title, url}` |
-| `transition.py` | `<ref> <STATUS> "<comment>"` | `{success, issue, previousStatus, newStatus}` |
-| `comment.py` | `<ref> ["<comment>"] \| stdin` | `{success, commentId}` |
-| `list_issues.py` | `[--status STATUS[,STATUS]] [--active] [--project ID] [--milestone ID] [--assignee STR] [--mine] [--limit N]` | `[{id, identifier, title, status, assignee, priority, dueDate, milestone, milestoneId, milestoneSortOrder, project, projectId}]` |
-| `get_issue.py` | `<ref> [--fields basic\|full]` | `{id, identifier, title, description, status, assignee, priority, estimate, dueDate, milestone, milestoneId, project, projectId, comments[]}` |
-| `assign.py` | `<ref> <assignee>` | `{success, issue, assignee}` |
-| `update_description.py` | `<ref> --text "..." \| --file PATH \| stdin` | `{success, issue}` |
-
-### Extended Scripts (cloud-only)
-
-| Script | Usage | Output |
-|--------|-------|--------|
-| `update_issue.py` | `<ref> [--title "..."] [--priority 0-4] [--estimate 1-5] [--assignee STR] [--state STATUS] [--description "..."] [--description-file PATH] [--comment "..."]` | `{success, issue, updated[]}` |
-| `estimate.py` | `<ref> <1-5>` | `{success, issue, estimate}` |
-| `priority.py` | `<ref> <0-4>` | `{success, issue, priority}` |
-| `link.py` | `<ref> <related_ref> <type>` | `{success, type}` |
-| `project_update.py` | `--health STATUS --body "..." [--body-file PATH]` | `{success, id}` |
-| `list_projects.py` | `[--active] [--all]` | `[{id, name, state}]` — `--all` bypasses product scope |
-| `create_project.py` | `--name "..." [--description "..."]` | `{id, name, url}` |
-| `assign_cycle.py` | `<ref> [cycle_id]` | `{success, issue, cycle}` |
-| `list_cycles.py` | `[--active]` | `[{id, name, number, startsAt, endsAt}]` |
-| `list_milestones.py` | `[--all]` | `[{id, name, targetDate}]` |
-| `create_milestone.py` | `--name "..." [--project ID] [--target-date DATE]` | `{id, name}` — defaults to first activeProject |
-| `assign_milestone.py` | `<ref> <milestone_id>` | `{success, issue, milestone}` |
+| Script                  | Usage                                                                                                                                                                  | Output                                                                                                                                        |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `create_issue.py`       | `--title "..." --type feature [--description "..."] [--description-file PATH] [--priority 0-4] [--estimate 1-5] [--assignee STR] [--labels "a,b"] [--triage] \| stdin` | `{id, identifier, title, url}`                                                                                                                |
+| `transition.py`         | `<ref> <STATUS> "<comment>"`                                                                                                                                           | `{success, issue, previousStatus, newStatus}`                                                                                                 |
+| `comment.py`            | `<ref> ["<comment>"] \| stdin`                                                                                                                                         | `{success, commentId}`                                                                                                                        |
+| `list_issues.py`        | `[--status STATUS[,STATUS]] [--active] [--project ID] [--milestone ID] [--assignee STR] [--mine] [--limit N]`                                                          | `[{id, identifier, title, status, assignee, priority, dueDate, milestone, milestoneId, milestoneSortOrder, project, projectId}]`              |
+| `get_issue.py`          | `<ref> [--fields basic\|full]`                                                                                                                                         | `{id, identifier, title, description, status, assignee, priority, estimate, dueDate, milestone, milestoneId, project, projectId, comments[]}` |
+| `assign.py`             | `<ref> <assignee>`                                                                                                                                                     | `{success, issue, assignee}`                                                                                                                  |
+| `update_description.py` | `<ref> --text "..." \| --file PATH \| stdin`                                                                                                                           | `{success, issue}`                                                                                                                            |
+
+### Extended Scripts
+
+| Script                | Usage                                                                                                                                                                          | Output                                                 |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |
+| `update_issue.py`     | `<ref> [--title "..."] [--priority 0-4] [--estimate 1-5] [--assignee STR] [--state STATUS] [--description "..."] [--description-file PATH] [--labels "a,b"] [--comment "..."]` | `{success, issue, updated[]}`                          |
+| `estimate.py`         | `<ref> <1-5>`                                                                                                                                                                  | `{success, issue, estimate}`                           |
+| `priority.py`         | `<ref> <0-4>`                                                                                                                                                                  | `{success, issue, priority}`                           |
+| `link.py`             | `<ref> <related_ref> <type>`                                                                                                                                                   | `{success, type}`                                      |
+| `project_update.py`   | `--health STATUS --body "..." [--body-file PATH]`                                                                                                                              | `{success, id}`                                        |
+| `list_projects.py`    | `[--active] [--all]`                                                                                                                                                           | `[{id, name, state}]` — `--all` bypasses product scope |
+| `create_project.py`   | `--name "..." [--description "..."]`                                                                                                                                           | `{id, name, url}`                                      |
+| `assign_cycle.py`     | `<ref> [cycle_id]`                                                                                                                                                             | `{success, issue, cycle}`                              |
+| `list_cycles.py`      | `[--active]`                                                                                                                                                                   | `[{id, name, number, startsAt, endsAt}]`               |
+| `list_milestones.py`  | `[--all]`                                                                                                                                                                      | `[{id, name, targetDate}]`                             |
+| `create_milestone.py` | `--name "..." [--project ID] [--target-date DATE]`                                                                                                                             | `{id, name}`                                           |
+| `assign_milestone.py` | `<ref> <milestone_id>`                                                                                                                                                         | `{success, issue, milestone}`                          |
+
+### Workspace Scripts
+
+| Script           | Usage                                                                 | Output                                                                    |
+| ---------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `list_teams.py`  | (no args)                                                             | `[{id, name, key}]`                                                       |
+| `create_team.py` | `--name "..." [--key KEY] [--description "..."] [--parent <team_id>]` | `{id, name, key}` — `--parent` creates a sub-team                         |
+| `set_team.py`    | `<team_id>`                                                           | `{success}` — updates relay preference and local config `provider.teamId` |
+| `list_labels.py` | (no args)                                                             | `[{id, name, color}]` — requires team to be set first                     |
+| `set_labels.py`  | `--defaults '["a"]' --type-map '{"feature":["F"],...}' \| stdin`      | `{success, validated, defaults, typeMap}` — stores label config on relay  |
 
 ### Script Notes
 
-- **`list_issues.py` product scope**: Automatically scopes results using config cascade — `activeProjects` → `product.labelIds` → team-wide. Explicit `--project` overrides. All flags (`--active`, `--status`, `--mine`, `--assignee`) filter within the scoped results.
-- **`list_issues.py --active`**: Returns all non-terminal issues (excludes Done, Archived, Canceled, Duplicate). Replaces `status_summary.py` — group results by status field instead.
-- **`list_issues.py --milestone`**: Filter issues by project milestone ID. Get IDs from `list_milestones.py`.
+- **How it works**: Scripts call the FlyDocs Relay REST API, which translates to the provider (Linear, Jira) server-side. Same interface and output as before — the transport changed from direct GraphQL to managed REST.
+- **`list_issues.py --active`**: Returns all non-terminal issues (excludes Done, Archived, Canceled, Duplicate).
 - **`list_issues.py --status`**: Accepts comma-separated statuses: `--status READY,IMPLEMENTING,BLOCKED`
-- **`get_issue.py --fields basic`**: Skips comment fetch for faster responses when comments aren't needed.
-- **`update_issue.py`**: Bulk update — sets multiple fields in a single API call. Prefer over separate `estimate.py`/`priority.py`/`assign.py` calls when updating more than one field.
-- **Shell-safe text input**: For descriptions, comments, or any text with special characters (apostrophes, quotes, parentheses), pipe via stdin with a single-quoted heredoc instead of `--text`:
+- **`get_issue.py --fields basic`**: Skips comment fetch for faster responses.
+- **`update_issue.py`**: Bulk update — sets multiple fields in a single API call. Prefer over separate scripts when updating more than one field.
+- **Shell-safe text input**: For text with special characters, pipe via stdin with a single-quoted heredoc:
   ```bash
   python3 update_description.py ENG-123 <<'EOF'
   Description with 'apostrophes', (parens), and "quotes"
@@ -83,14 +95,17 @@ All scripts: `python3 .claude/skills/flydocs-cloud/scripts/<script>`
 
 ### Issue Reference
 
-`<ref>`: Provider identifier, e.g., `ENG-123`. Resolved via Linear search API.
+`<ref>`: Provider identifier, e.g., `ENG-123`. Resolved server-side by the relay.
 
 ## Error Handling
 
 Exit 0 = success (JSON on stdout). Exit 1 = error (message on stderr).
 Network errors: exponential backoff, 3 retries, 2s base delay.
+Relay errors include `code` and optional `provider_error` for debugging.
 
 ## Configuration
 
-Reads from `.flydocs/config.json`: tier, provider.teamId, statusMapping, issueLabels.
-Reads `LINEAR_API_KEY` from environment or `.env` / `.env.local`.
+Reads from `.flydocs/config.json`: tier, relay URL override.
+Reads `FLYDOCS_API_KEY` from environment or `.env` / `.env.local`.
+
+Optional: `FLYDOCS_RELAY_URL` env var or `relay.url` in config to override the base URL (e.g., for local development).

package/template/.claude/skills/flydocs-cloud/cursor-rule.mdc

@@ -1,5 +1,5 @@
 ---
-description: Connected issue management via Linear — cloud mechanism for FlyDocs
+description: Connected issue management via FlyDocs Relay API — cloud mechanism for FlyDocs
 alwaysApply: true
 ---
 
@@ -7,7 +7,7 @@ alwaysApply: true
 
 # FlyDocs Cloud Mechanism
 
-Issues managed in Linear. Reads config from `.flydocs/config.json` and API key from `.env`.
+Issues managed via FlyDocs Relay API. Reads config from `.flydocs/config.json` and API key (`FLYDOCS_API_KEY`) from `.env`.
 
 ## Shared Contract Scripts
 
@@ -23,7 +23,7 @@ All scripts: `python3 .claude/skills/flydocs-cloud/scripts/<script>`
 | `assign.py` | `<ref> <assignee>` |
 | `update_description.py` | `<ref> --text "..." \| --file PATH` |
 
-## Extended Scripts (cloud-only)
+## Extended Scripts
 
 | Script | Key Arguments |
 |--------|---------------|
@@ -46,5 +46,5 @@ Network errors: exponential backoff, 3 retries, 2s base delay.
 
 ## Configuration
 
-Reads from `.flydocs/config.json`: tier, provider.teamId, statusMapping, issueLabels.
-Reads `LINEAR_API_KEY` from environment or `.env` / `.env.local`.
+Reads from `.flydocs/config.json`: tier, relay URL override.
+Reads `FLYDOCS_API_KEY` from environment or `.env` / `.env.local`.

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Assign an issue to a person."""
+"""Assign an issue to a user via the FlyDocs Relay API."""
 
 import sys
 from pathlib import Path
@@ -10,29 +10,13 @@ from flydocs_api import get_client, output_json, fail
 if len(sys.argv) < 3:
     fail("Usage: assign.py <ref> <assignee>")
 
-ref, assignee_query = sys.argv[1], sys.argv[2]
+ref, assignee = sys.argv[1], sys.argv[2]
 client = get_client()
 
-issue_uuid = client.resolve_issue_id(ref)
-if not issue_uuid:
-    fail(f"Issue not found: {ref}")
+result = client.post(f"/issues/{ref}/assign", {"assignee": assignee})
 
-user_id, user_name = client.resolve_user_id(assignee_query)
-if not user_id:
-    fail(f"User not found: {assignee_query}")
-
-result = client.query(
-    """mutation($id: String!, $assigneeId: String!) {
-        issueUpdate(id: $id, input: { assigneeId: $assigneeId }) {
-            success
-            issue { identifier }
-        }
-    }""",
-    {"id": issue_uuid, "assigneeId": user_id},
-)
-
-if not result.get("data", {}).get("issueUpdate", {}).get("success"):
-    fail(f"Failed to assign: {result}")
-
-issue = result["data"]["issueUpdate"]["issue"]
-output_json({"success": True, "issue": issue["identifier"], "assignee": user_name})
+output_json({
+    "success": result.get("success", True),
+    "issue": result.get("issue", ref),
+    "assignee": result.get("assignee", assignee),
+})

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
@@ -18,7 +18,7 @@ def main():
     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("--assignee", default=None)
-    parser.add_argument("--project", default=None)
+    parser.add_argument("--labels", default=None, help="Comma-separated ad-hoc label names")
     parser.add_argument("--triage", action="store_true")
     args = parser.parse_args()
 
@@ -32,68 +32,31 @@ 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})
-
-    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}")
+        body["assignee"] = args.assignee
+    if args.labels:
+        body["labels"] = [l.strip() for l in args.labels.split(",") if l.strip()]
+    if args.triage:
+        body["triage"] = True
 
-    issue = data["issue"]
-    output_json({"id": issue["id"], "identifier": issue["identifier"], "title": issue["title"], "url": issue["url"]})
+    client = get_client()
+    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()