@flydocs/cli 0.6.0-alpha.13 → 0.6.0-alpha.20

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

@@ -1,19 +0,0 @@
-#!/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,28 +0,0 @@
-#!/usr/bin/env python3
-"""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
-
-
-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,31 +0,0 @@
-#!/usr/bin/env python3
-"""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
-
-
-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

@@ -1,19 +0,0 @@
-#!/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

@@ -1,19 +0,0 @@
-#!/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

@@ -1,19 +0,0 @@
-#!/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,29 +0,0 @@
-#!/usr/bin/env python3
-"""Set priority on an issue 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) < 3:
-    fail("Usage: priority.py <ref> <0-4>")
-
-ref = sys.argv[1]
-try:
-    priority = int(sys.argv[2])
-except ValueError:
-    fail("Priority must be a number (0-4)")
-
-if priority not in range(5):
-    fail("Priority must be 0 (none), 1 (urgent), 2 (high), 3 (medium), or 4 (low)")
-
-client = get_client()
-result = client.put(f"/issues/{ref}/priority", {"priority": 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,45 +0,0 @@
-#!/usr/bin/env python3
-"""Post a project update 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
-
-
-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

@@ -1,87 +0,0 @@
-#!/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

@@ -1,54 +0,0 @@
-#!/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.
-
-Also writes .flydocs/me.json for local identity resolution (e.g. --mine
-in list_issues.py). This file is gitignored — each developer has their own.
-"""
-
-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
-
-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,
-})
-
-# Write me.json for local identity resolution
-me_data = {
-    "provider": result.get("provider", provider),
-    "providerId": result.get("providerId", provider_id),
-    "displayName": result.get("displayName"),
-    "email": result.get("email"),
-}
-me_path = Path(".flydocs/me.json")
-me_path.parent.mkdir(parents=True, exist_ok=True)
-me_path.write_text(json.dumps(me_data, indent=2) + "\n")
-
-output_json({
-    "success": result.get("success", True),
-    "provider": me_data["provider"],
-    "providerId": me_data["providerId"],
-    "meJson": str(me_path),
-})

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

@@ -1,54 +0,0 @@
-#!/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)
-    output_json(result)
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,49 +0,0 @@
-#!/usr/bin/env python3
-"""Get or set user preferences via the FlyDocs Relay API.
-
-With no arguments, returns current preferences (GET).
-With flags, updates preferences (POST).
-"""
-
-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
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Get or set user preferences")
-    parser.add_argument("--workspace", default=None, help="Default workspace ID")
-    parser.add_argument("--assignee", default=None, help="Default assignee ('self' or user ID)")
-    parser.add_argument("--display", default=None, help="Display preferences (JSON string)")
-    args = parser.parse_args()
-
-    client = get_client()
-
-    # If no flags provided, GET current preferences
-    if args.workspace is None and args.assignee is None and args.display is None:
-        result = client.get("/auth/preferences")
-        output_json(result)
-        return
-
-    # Build update body from provided flags
-    body: dict = {}
-    if args.workspace is not None:
-        body["defaultWorkspaceId"] = args.workspace
-    if args.assignee is not None:
-        body["defaultAssignee"] = args.assignee
-    if args.display is not None:
-        body["displayPreferences"] = args.display
-
-    result = client.post("/auth/preferences", body)
-
-    output_json({
-        "success": result.get("success", True),
-        "preferences": result.get("preferences", body),
-    })
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,31 +0,0 @@
-#!/usr/bin/env python3
-"""Set provider preference via the FlyDocs Relay API.
-
-Stores the provider type on the relay for server-side routing.
-Local config is updated by generate_config.py after all setup steps complete.
-"""
-
-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
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Set provider preference")
-    parser.add_argument(
-        "provider_type",
-        choices=["linear", "jira"],
-        help="Provider type",
-    )
-    args = parser.parse_args()
-
-    client = get_client()
-    result = client.post("/auth/provider", {"providerType": args.provider_type})
-    output_json(result)
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,57 +0,0 @@
-#!/usr/bin/env python3
-"""Set status mapping on the relay API key.
-
-Maps provider workflow states to FlyDocs statuses. Pass "auto" for
-case-insensitive auto-mapping, or provide a manual mapping object.
-
-Usage:
-    set_status_mapping.py --auto
-    set_status_mapping.py --mapping '{"BACKLOG":"Backlog","IMPLEMENTING":"In Progress",...}'
-    echo '{"mapping":"auto"}' | set_status_mapping.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 status mapping on relay")
-    parser.add_argument(
-        "--auto",
-        action="store_true",
-        help="Auto-map provider states to FlyDocs statuses by name",
-    )
-    parser.add_argument(
-        "--mapping",
-        default=None,
-        help="JSON object mapping FlyDocs statuses to provider state names",
-    )
-    args = parser.parse_args()
-
-    if args.auto:
-        body: dict = {"mapping": "auto"}
-    elif args.mapping is not None:
-        try:
-            body = {"mapping": json.loads(args.mapping)}
-        except json.JSONDecodeError:
-            fail("Invalid JSON for --mapping")
-    elif not sys.stdin.isatty():
-        try:
-            body = json.loads(sys.stdin.read().strip())
-        except json.JSONDecodeError:
-            fail("Invalid JSON on stdin")
-    else:
-        fail("Provide --auto, --mapping '{...}', or pipe JSON via stdin")
-
-    client = get_client()
-    result = client.post("/auth/statuses", body)
-    output_json(result)
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,28 +0,0 @@
-#!/usr/bin/env python3
-"""Set team/project preference via the FlyDocs Relay API.
-
-Stores the team preference on the relay for server-side scoping.
-Local config is updated by generate_config.py after all setup steps complete.
-For Jira, this sets the active Jira project.
-"""
-
-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
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Set team or project preference")
-    parser.add_argument("team_id", help="Provider team/workspace UUID")
-    args = parser.parse_args()
-
-    client = get_client()
-    result = client.post("/auth/team", {"teamId": args.team_id})
-    output_json(result)
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,26 +0,0 @@
-#!/usr/bin/env python3
-"""Transition an issue to a new status with a required comment."""
-
-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) < 4:
-    fail("Usage: transition.py <ref> <STATUS> <comment>")
-
-ref, status, comment = sys.argv[1], sys.argv[2].upper(), sys.argv[3]
-client = get_client()
-
-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),
-})

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

@@ -1,36 +0,0 @@
-#!/usr/bin/env python3
-"""Update an issue's description 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="Update issue description")
-parser.add_argument("ref", help="Issue reference (e.g., ENG-123)")
-parser.add_argument("--text", default=None)
-parser.add_argument("--file", default=None)
-args = parser.parse_args()
-
-# Resolve text: --file > stdin > --text
-text = args.text
-if args.file:
-    try:
-        text = Path(args.file).read_text()
-    except FileNotFoundError:
-        fail(f"File not found: {args.file}")
-elif text is None and not sys.stdin.isatty():
-    text = sys.stdin.read().strip()
-
-if not text:
-    fail("Provide text via --text, --file, or stdin")
-
-client = get_client()
-result = client.put(f"/issues/{args.ref}/description", {"text": text})
-
-output_json({
-    "success": result.get("success", True),
-    "issue": result.get("issue", args.ref),
-})