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

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Update an issue's description."""
+"""Update an issue's description via the FlyDocs Relay API."""
 
 import argparse
 import sys
@@ -9,39 +9,28 @@ 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")
-parser.add_argument("--text", default="")
-parser.add_argument("--file", default="", dest="filepath")
+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.filepath:
+if args.file:
     try:
-        text = Path(args.filepath).read_text()
+        text = Path(args.file).read_text()
     except FileNotFoundError:
-        fail(f"File not found: {args.filepath}")
-if not text and not sys.stdin.isatty():
+        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, --file, or pipe via stdin")
+    fail("Provide text via --text, --file, or stdin")
 
 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!, $description: String!) {
-        issueUpdate(id: $id, input: { description: $description }) {
-            success
-            issue { identifier }
-        }
-    }""",
-    {"id": issue_uuid, "description": text},
-)
-
-if not result.get("data", {}).get("issueUpdate", {}).get("success"):
-    fail(f"Failed to update: {result}")
+result = client.put(f"/issues/{args.ref}/description", {"text": text})
 
-issue = result["data"]["issueUpdate"]["issue"]
-output_json({"success": True, "issue": issue["identifier"]})
+output_json({
+    "success": result.get("success", True),
+    "issue": result.get("issue", args.ref),
+})

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

@@ -19,90 +19,61 @@ def main():
     parser.add_argument("--state", default=None)
     parser.add_argument("--description", default=None)
     parser.add_argument("--description-file", default=None)
+    parser.add_argument("--labels", default=None, help="Comma-separated label names")
     parser.add_argument("--comment", default=None)
     args = parser.parse_args()
 
-    client = get_client()
-
-    issue_uuid = client.resolve_issue_id(args.ref)
-    if not issue_uuid:
-        fail(f"Issue not found: {args.ref}")
-
-    # Build mutation input from provided args
-    mutation_input: dict = {}
+    # Build request body from provided args
+    body: dict = {}
     updated_fields: list[str] = []
 
     if args.title is not None:
-        mutation_input["title"] = args.title
+        body["title"] = args.title
         updated_fields.append("title")
 
     if args.priority is not None:
-        mutation_input["priority"] = args.priority
+        body["priority"] = args.priority
         updated_fields.append("priority")
 
     if args.estimate is not None:
-        mutation_input["estimate"] = args.estimate
+        body["estimate"] = args.estimate
         updated_fields.append("estimate")
 
     if args.assignee is not None:
-        user_id, user_name = client.resolve_user_id(args.assignee)
-        if not user_id:
-            fail(f"User not found: {args.assignee}")
-        mutation_input["assigneeId"] = user_id
+        body["assignee"] = args.assignee
         updated_fields.append("assignee")
 
     if args.state is not None:
-        state_id = client.get_state_id(args.state.upper())
-        if not state_id:
-            fail(f"Unknown status: {args.state}")
-        mutation_input["stateId"] = state_id
+        body["state"] = args.state.upper()
         updated_fields.append("state")
 
     if args.description_file is not None:
         path = Path(args.description_file)
         if not path.exists():
             fail(f"File not found: {args.description_file}")
-        mutation_input["description"] = path.read_text()
+        body["description"] = path.read_text()
         updated_fields.append("description")
     elif args.description is not None:
-        mutation_input["description"] = args.description
+        body["description"] = args.description
         updated_fields.append("description")
 
-    if not mutation_input and not args.comment:
-        fail("No fields to update. Use --title, --priority, --estimate, --assignee, --state, --description, or --comment")
-
-    # Single mutation for all field updates
-    result = None
-    if mutation_input:
-        result = client.query(
-            """mutation($id: String!, $input: IssueUpdateInput!) {
-                issueUpdate(id: $id, input: $input) {
-                    success
-                    issue { identifier title state { name } assignee { name } priority estimate }
-                }
-            }""",
-            {"id": issue_uuid, "input": mutation_input},
-        )
-        if not result.get("data", {}).get("issueUpdate", {}).get("success"):
-            fail(f"Failed to update: {result}")
-
-    # Comment is a separate mutation (Linear doesn't combine these)
-    if args.comment:
-        client.query(
-            """mutation($id: String!, $body: String!) {
-                commentCreate(input: { issueId: $id, body: $body }) { success }
-            }""",
-            {"id": issue_uuid, "body": args.comment},
-        )
+    if args.labels is not None:
+        body["labels"] = [l.strip() for l in args.labels.split(",") if l.strip()]
+        updated_fields.append("labels")
+
+    if args.comment is not None:
+        body["comment"] = args.comment
         updated_fields.append("comment")
 
-    issue = {}
-    if result:
-        issue = result["data"]["issueUpdate"]["issue"]
+    if not body:
+        fail("No fields to update. Use --title, --priority, --estimate, --assignee, --state, --description, --labels, or --comment")
+
+    client = get_client()
+    result = client.patch(f"/issues/{args.ref}", body)
 
     output_json({
-        "success": True,
-        "issue": issue.get("identifier", args.ref),
+        "success": result.get("success", True),
+        "issue": result.get("issue", args.ref),
         "updated": updated_fields,
     })
 

package/template/.env.example

@@ -15,16 +15,25 @@
 #   → Value auto-loads when you cd into the project!
 #
 # Option B: Add to shell profile (~/.zshrc)
-#   export LINEAR_API_KEY="your_key_here"
+#   export FLYDOCS_API_KEY="your_key_here"
 #
 # Option C: Export manually before opening Cursor
 #   source .env && cursor .
 #
 
 # ===========================================
-# CLOUD TIER ONLY: Linear API Key
+# CLOUD TIER: FlyDocs API Key (Recommended)
 # ===========================================
-# Only needed if you use cloud tier (tier: "cloud" in .flydocs/config.json)
+# Use this if connecting via FlyDocs Cloud (managed relay).
+# Get from: your FlyDocs dashboard → API Keys
+# Format: fdk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+# Set up with: flydocs connect
+FLYDOCS_API_KEY=
+
+# ===========================================
+# CLOUD TIER: Direct Linear API Key (Legacy)
+# ===========================================
+# Use this ONLY if connecting directly to Linear without the relay.
 # Get from: Linear → Settings → API → Personal API Keys
 # Format: lin_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 LINEAR_API_KEY=
@@ -45,9 +54,9 @@ FIGMA_ACCESS_TOKEN=
 CONTEXT7_API_KEY=
 
 # ===========================================
-# NOTE: Team ID and Project ID are discovered automatically
+# NOTE: Provider configuration is discovered automatically
 # ===========================================
 # Run /flydocs-setup and the agent will:
-# 1. Query your Linear teams (you select one)
-# 2. Query projects in that team (you select one)
-# 3. Save both IDs to .flydocs/config.json
+# 1. Detect your provider connection
+# 2. Query teams and projects (you select)
+# 3. Save IDs to .flydocs/config.json

package/template/.flydocs/config.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.0-beta.9",
+  "version": "0.6.0-alpha.2",
   "sourceRepo": "github.com/plastrlab/flydocs-core",
   "tier": "local",
   "setupComplete": false,

package/template/.flydocs/version

@@ -1 +1 @@
-0.5.0-beta.9
+0.6.0-alpha.2

package/template/CHANGELOG.md

@@ -7,6 +7,150 @@ Versioning: [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.6.0-alpha.1] — 2026-03-12
+
+### Added
+
+- **Cloud relay scripts** — all cloud mechanism scripts rewritten as thin REST
+  wrappers calling the FlyDocs Relay API (`app.flydocs.ai/api/relay`). Provider
+  translation (Linear, Jira) happens server-side.
+- **Team discovery** — new `list_teams.py` and `set_team.py` scripts for
+  discovering available teams and storing team preference on the relay.
+- **Label configuration** — new `list_labels.py` and `set_labels.py` scripts
+  for server-side label resolution. Labels are configured per API key with
+  defaults and type-to-label mapping.
+- **`--labels` flag** — `create_issue.py` and `update_issue.py` now accept
+  optional `--labels "name1,name2"` for ad-hoc labels alongside the `type` field.
+- **Cloud tier install** — `flydocs install` supports tier selection (local/cloud).
+  Cloud installs the relay mechanism skill and premium skills.
+- **`flydocs connect`** — new command to validate and store `fdk_` API keys.
+- **`/flydocs-upgrade`** — upgrade from local to cloud tier.
+- **Alpha dist-tag** — `-alpha.x` versions publish to npm `alpha` dist-tag.
+
+### Changed
+
+- **Setup flow updated** — `/flydocs-setup` Phase 2 now uses `list_teams.py`
+  for team discovery, `set_team.py` for selection, and `list_labels.py` +
+  `set_labels.py` for label configuration with auto-detection.
+- **API key reference** — setup instructions now reference `FLYDOCS_API_KEY`
+  instead of `LINEAR_API_KEY`.
+- **Relay URL** — `app.flydocs.ai/api/relay` (same Vercel deployment, no
+  separate API domain). Override with `FLYDOCS_RELAY_URL` env var.
+
+---
+
+## [0.5.0-beta.19] — 2026-02-27
+
+### Fixed
+
+- **Install always confirms before proceeding** — the "Install FlyDocs here?"
+  prompt now shows even when an existing config is detected. Previously, reinstalls
+  with an existing `.flydocs/config.json` skipped the confirmation entirely.
+
+---
+
+## [0.5.0-beta.18] — 2026-02-27
+
+### Changed
+
+- **Telemetry disabled by default** — analytics are opt-in only. No data is sent
+  until a user explicitly runs `flydocs telemetry enable`. Removed first-run notice.
+
+---
+
+## [0.5.0-beta.17] — 2026-02-26
+
+### Added
+
+- **Anonymous usage analytics** — opt-in PostHog telemetry tracks install/update
+  funnel events (started, tier selected, completed). No personal data or code
+  collected. Opt out with `flydocs telemetry disable` or `FLYDOCS_TELEMETRY=0`.
+- **`flydocs telemetry` command** — `enable`, `disable`, `status` subcommands
+  for managing anonymous analytics.
+- **`flydocs uninstall` command** — cleanly removes FlyDocs from a project.
+  Interactive mode prompts to archive or delete user content. Supports `--force`,
+  `--all`, `--yes`, `--here`, `--path` flags. Preserves community skills and `.env`.
+
+---
+
+## [0.5.0-beta.16] — 2026-02-24
+
+### Changed
+
+- **Premium skills are cloud-only** — `flydocs-figma` and `flydocs-estimates` are no
+  longer installed on local tier. Existing local installs have them cleaned up on
+  next update. Core skills (workflow, context-graph, context7) remain on all tiers.
+
+---
+
+## [0.5.0-beta.15] — 2026-02-24
+
+### Changed
+
+- **CTA links use full URLs** — Discord and flydocs.ai links now display as full URLs
+  (`https://discord.com/invite/...`, `https://www.flydocs.ai`) for terminal compatibility.
+  Discord section shows "Join the Discord" heading with invite link on its own line.
+  Setup command CTA updated to match.
+
+---
+
+## [0.5.0-beta.14] — 2026-02-24
+
+### Changed
+
+- **Discord CTA restyled** — "Join the Discord" is now a bold cyan clickable hyperlink
+  with descriptive copy ("for upcoming features, support, and early access to what's
+  next"), matching the docs page CTA style. "flydocs.ai" link also bold cyan and clickable.
+
+---
+
+## [0.5.0-beta.13] — 2026-02-24
+
+### Changed
+
+- **New ASCII banner** — gradient block-letter "FlyDocs" heading with subtle drop shadow,
+  replacing the block mark logo. Pink-to-purple gradient matches brand colors using true
+  color (24-bit) escape sequences. Tagline in bold white, version label in dim.
+
+---
+
+## [0.5.0-beta.12] — 2026-02-24
+
+### Changed
+
+- **Optional sub-agents** — sub-agents (PM, implementation, review, research) are now
+  an opt-in prompt during install and update. Recommended but not required. Existing
+  installs are silently updated on next `flydocs update`.
+- **Removed hardcoded model selections** — Claude Code agent files no longer specify
+  `model: opus` or `model: sonnet`. Agents inherit the user's configured model,
+  matching the Cursor agent behavior.
+- **CLI copy alignment** — banner tagline updated to "Structured context for AI coding
+  tools", beta CTA refocused on Discord community, docs references point to flydocs.ai.
+- **Setup command CTA** — updated to show community links (Discord, flydocs.ai) and
+  upcoming features instead of "join the beta" messaging.
+
+---
+
+## [0.5.0-beta.11] — 2026-02-23
+
+### Fixed
+
+- **Beta CTA hyperlink** — fixed OSC 8 escape sequence (BEL terminator, color inside
+  hyperlink wrapper). Display text changed to `https://www.flydocs.ai` for terminals
+  that don't support clickable links. UTM tracking preserved in the link target.
+
+---
+
+## [0.5.0-beta.10] — 2026-02-22
+
+### Fixed
+
+- **`.env.example` not updating** — reclassified from `template_files` to `owned_files`
+  in manifest. Now overwritten on update so new config entries (like `CONTEXT7_API_KEY`)
+  and copy fixes propagate to existing installations.
+
+---
+
 ## [0.5.0-beta.9] — 2026-02-22
 
 ### Changed

package/template/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.0-beta.9",
+  "version": "0.6.0-alpha.2",
   "description": "FlyDocs Core - Manifest of all managed files",
   "repository": "github.com/plastrlab/flydocs-core",
 
@@ -36,6 +36,7 @@
         ".claude/commands/close.md",
         ".claude/commands/flydocs-setup.md",
         ".claude/commands/flydocs-update.md",
+        ".claude/commands/flydocs-upgrade.md",
         ".claude/commands/implement.md",
         ".claude/commands/new-project.md",
         ".claude/commands/project-update.md",
@@ -49,7 +50,8 @@
         ".cursor/hooks.json",
         ".flydocs/version",
         ".flydocs/CHANGELOG.md",
-        "AGENTS.md"
+        "AGENTS.md",
+        ".env.example"
       ]
     },
 
@@ -88,7 +90,6 @@
     "template_files": {
       "description": "Initial scaffolding - created on setup, then maintained by user as project evolves",
       "paths": [
-        ".env.example",
         "flydocs/context/project.md",
         "flydocs/knowledge/INDEX.md",
         "flydocs/knowledge/README.md",
@@ -122,6 +123,7 @@
           "close.md",
           "flydocs-setup.md",
           "flydocs-update.md",
+          "flydocs-upgrade.md",
           "implement.md",
           "new-project.md",
           "project-update.md",