@flydocs/cli 0.6.0-alpha.10 → 0.6.0-alpha.11

package/dist/cli.js

@@ -15,7 +15,7 @@ var CLI_VERSION, CLI_NAME, PACKAGE_NAME, POSTHOG_API_KEY;
 var init_constants = __esm({
   "src/lib/constants.ts"() {
     "use strict";
-    CLI_VERSION = "0.6.0-alpha.10";
+    CLI_VERSION = "0.6.0-alpha.11";
     CLI_NAME = "flydocs";
     PACKAGE_NAME = "@flydocs/cli";
     POSTHOG_API_KEY = "phc_v1MSJTQDFkMS90CBh3mxIz3v8bYCCnKU6v1ir6bz0Xn";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flydocs/cli",
-  "version": "0.6.0-alpha.10",
+  "version": "0.6.0-alpha.11",
   "type": "module",
   "description": "FlyDocs AI CLI — install, setup, and manage FlyDocs projects",
   "bin": {

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

@@ -59,22 +59,22 @@ All scripts: `python3 .claude/skills/flydocs-cloud/scripts/<script>`
 
 ### Workspace Scripts
 
-| Script                  | Usage                                                                 | Output                                                                                          |
-| ----------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
-| `list_providers.py`     | (no args)                                                             | `[{type, name, connected}]`                                                                     |
-| `set_provider.py`       | `<provider_type>` (`linear` or `jira`)                                | `{success}` — updates relay routing and local config `provider.type`                            |
-| `list_teams.py`         | (no args)                                                             | `[{id, name, key}]` — returns Linear teams or Jira projects (relay normalizes)                  |
-| `create_team.py`        | `--name "..." [--key KEY] [--description "..."] [--parent <team_id>]` | `{id, name, key}` — `--parent` is Linear-only (sub-teams)                                       |
-| `set_team.py`           | `<team_id>`                                                           | `{success}` — updates relay preference and local config; for Jira, sets the active Jira project |
-| `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                        |
-| `list_statuses.py`      | (no args)                                                             | `{states, currentMapping, flydocsStatuses}` — provider workflow states and current mapping      |
-| `set_status_mapping.py` | `--auto \| --mapping '{"BACKLOG":"Backlog",...}' \| stdin`            | `{success, mapping, matched, total}` — stores status mapping on relay                           |
-| `set_identity.py`       | `<provider> <provider-user-id>`                                       | `{success, provider, providerId}` — binds provider user ID for `--mine` resolution              |
-| `set_preferences.py`    | `[--workspace ID] [--assignee self\|ID] [--display JSON]`             | `{success, preferences}` — no flags = GET current; with flags = POST update                     |
-| `get_estimate_scale.py` | (no args)                                                             | `{scale, type}` — provider's valid estimate values (fixed or freeform)                          |
-| `refresh_labels.py`     | `[--fix]`                                                             | `{valid, stale, details}` — validates config label IDs against relay; `--fix` updates stale IDs |
-| `validate_setup.py`     | (no args)                                                             | `{valid, checks, missing[]}` — validates workspace config, caches result, sets setupComplete    |
+| Script                  | Usage                                                                 | Output                                                                                                         |
+| ----------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `list_providers.py`     | (no args)                                                             | `[{type, name, connected}]`                                                                                    |
+| `set_provider.py`       | `<provider_type>` (`linear` or `jira`)                                | `{success}` — updates relay routing and local config `provider.type`                                           |
+| `list_teams.py`         | (no args)                                                             | `[{id, name, key}]` — returns Linear teams or Jira projects (relay normalizes)                                 |
+| `create_team.py`        | `--name "..." [--key KEY] [--description "..."] [--parent <team_id>]` | `{id, name, key}` — `--parent` is Linear-only (sub-teams)                                                      |
+| `set_team.py`           | `<team_id>`                                                           | `{success}` — updates relay preference and local config; for Jira, sets the active Jira project                |
+| `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                                       |
+| `list_statuses.py`      | (no args)                                                             | `{states, currentMapping, flydocsStatuses}` — provider workflow states and current mapping                     |
+| `set_status_mapping.py` | `--auto \| --mapping '{"BACKLOG":"Backlog",...}' \| stdin`            | `{success, mapping, matched, total}` — stores status mapping on relay                                          |
+| `set_identity.py`       | `<provider> <provider-user-id>`                                       | `{success, provider, providerId}` — binds provider user ID for `--mine` resolution                             |
+| `set_preferences.py`    | `[--workspace ID] [--assignee self\|ID] [--display JSON]`             | `{success, preferences}` — no flags = GET current; with flags = POST update                                    |
+| `get_estimate_scale.py` | (no args)                                                             | `{scale, type}` — provider's valid estimate values (fixed or freeform)                                         |
+| `refresh_labels.py`     | `[--fix]`                                                             | `{valid, stale, details}` — validates config label IDs against relay; `--fix` updates stale IDs                |
+| `validate_setup.py`     | (no args)                                                             | `{valid, checks, passed[], missing[], warnings[]}` — reads relay validation, caches result, sets setupComplete |
 
 ### Script Notes
 
@@ -117,7 +117,19 @@ Relay errors include `code` and optional `provider_error` for debugging.
 
 ## Configuration
 
-Reads from `.flydocs/config.json`: tier, relay URL override.
+Reads from `.flydocs/config.json`: tier, workspaceId, 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).
+
+### Header Contract
+
+Every relay request includes:
+
+| Header          | Required | Source                                              |
+| --------------- | -------- | --------------------------------------------------- |
+| `Authorization` | Yes      | `Bearer fdk_...` from `FLYDOCS_API_KEY`             |
+| `X-Workspace`   | Yes\*    | `workspaceId` from `.flydocs/config.json`           |
+| `X-Repo`        | No       | Git remote slug (auto-detected, e.g., `owner/repo`) |
+
+\*Required for all endpoints except `POST /auth/validate`.

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

@@ -11,6 +11,7 @@ Usage:
 
 import json
 import os
+import subprocess
 import sys
 import time
 from pathlib import Path
@@ -43,6 +44,7 @@ class FlyDocsClient:
             print("Run 'flydocs setup' to configure your workspace", file=sys.stderr)
             sys.exit(1)
 
+        self.repo_slug = self._detect_repo_slug()
         self.base_url = self._resolve_base_url()
 
     def _load_config(self) -> dict:
@@ -74,6 +76,22 @@ class FlyDocsClient:
                     return v if v else None
         return None
 
+    def _detect_repo_slug(self) -> Optional[str]:
+        """Derive owner/repo slug from git remote origin URL."""
+        try:
+            url = subprocess.check_output(
+                ["git", "remote", "get-url", "origin"],
+                stderr=subprocess.DEVNULL,
+                timeout=5,
+            ).decode().strip()
+            if url.endswith(".git"):
+                url = url[:-4]
+            if ":" in url and "@" in url:
+                return url.split(":")[-1]  # SSH: git@github.com:owner/repo
+            return "/".join(url.split("/")[-2:])  # HTTPS
+        except Exception:
+            return None
+
     def _resolve_base_url(self) -> str:
         """Resolve base URL: env var > config > default."""
         env_url = os.environ.get("FLYDOCS_RELAY_URL")
@@ -103,6 +121,8 @@ class FlyDocsClient:
             "Content-Type": "application/json",
             "Accept": "application/json",
         }
+        if self.repo_slug:
+            headers["X-Repo"] = self.repo_slug
 
         data = json.dumps(body).encode("utf-8") if body else None
 

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

@@ -1,9 +1,13 @@
 #!/usr/bin/env python3
 """Validate workspace setup via the FlyDocs Relay API.
 
-Read-only validation that checks provider, team, status mapping, label config,
-and user identity. Writes result to .flydocs/validation-cache.json and sets
-setupComplete: true in config when all required checks pass.
+Read-only validation that calls GET /auth/config. The relay returns:
+  - valid: bool (all required checks pass)
+  - missing: ["provider", "statusMapping", ...] (required, blocks setup)
+  - warnings: ["repos", ...] (optional, informational)
+
+Writes result to .flydocs/validation-cache.json and sets
+setupComplete: true in config when valid is true.
 """
 
 import json
@@ -15,71 +19,48 @@ sys.path.insert(0, str(Path(__file__).parent))
 from flydocs_api import get_client, output_json, fail
 
 
-# Required checks — failure blocks setup completion
-REQUIRED_CHECKS = {
-    "provider": {
-        "test": lambda cfg: cfg.get("provider", {}).get("connected") is True,
-        "message": "No provider connected — configure in FlyDocs dashboard",
-    },
-    "team": {
-        "test": lambda cfg: bool(cfg.get("team", {}).get("id")),
-        "message": "No team selected — configure in FlyDocs dashboard",
-    },
-    "statusMapping": {
-        "test": lambda cfg: cfg.get("statusMapping", {}).get("configured") is True,
-        "message": "Status mapping not configured — configure in FlyDocs dashboard",
-    },
-    "labelConfig": {
-        "test": lambda cfg: cfg.get("labelConfig", {}).get("configured") is True,
-        "message": "Label config not configured — configure in FlyDocs dashboard",
-    },
+# Human-readable messages for missing/warning items
+CHECK_MESSAGES: dict[str, str] = {
+    "provider": "No provider connected — configure in FlyDocs dashboard",
+    "team": "No team selected — configure in FlyDocs dashboard",
+    "statusMapping": "Status mapping not configured — configure in FlyDocs dashboard",
+    "labelConfig": "Label config not configured — configure in FlyDocs dashboard",
+    "userIdentity": (
+        "Provider identity not linked — run: "
+        "python3 .claude/skills/flydocs-cloud/scripts/set_identity.py <provider> <id>"
+    ),
+    "repos": "No repos linked — GitHub features won't work until you push and link a repo",
 }
 
-# Optional checks — warn but don't block
-OPTIONAL_CHECKS = {
-    "userIdentity": {
-        "test": lambda cfg: cfg.get("userIdentity", {}).get("linked") is True,
-        "message": (
-            "Provider identity not linked — run: "
-            "python3 .claude/skills/flydocs-cloud/scripts/set_identity.py <provider> <id>"
-        ),
-    },
-    "repos": {
-        "test": lambda cfg: (cfg.get("repos", {}).get("count", 0) or 0) > 0,
-        "message": "No repos linked — link a repo in FlyDocs dashboard settings",
-    },
-}
+DEFAULT_MESSAGE = "Not configured — check FlyDocs dashboard"
 
 
 def main() -> None:
     client = get_client()
 
-    # Fetch workspace config from relay
+    # Fetch workspace config from relay — relay does the validation
     config_response = client.get("/auth/config")
 
-    # Run checks
+    # Read relay-computed validation results
+    is_valid = config_response.get("valid", False)
+    missing_keys: list[str] = config_response.get("missing", [])
+    warning_keys: list[str] = config_response.get("warnings", [])
+
+    # Build structured missing/warning lists with messages
+    missing = [
+        {"check": k, "action": CHECK_MESSAGES.get(k, DEFAULT_MESSAGE)}
+        for k in missing_keys
+    ]
+    warnings = [
+        {"check": k, "action": CHECK_MESSAGES.get(k, DEFAULT_MESSAGE)}
+        for k in warning_keys
+    ]
+
+    # Build checks map for cache
+    all_keys = set(CHECK_MESSAGES.keys())
     checks: dict[str, bool] = {}
-    valid: list[str] = []
-    missing: list[dict[str, str]] = []
-    warnings: list[dict[str, str]] = []
-
-    for name, check in REQUIRED_CHECKS.items():
-        passed = check["test"](config_response)
-        checks[name] = passed
-        if passed:
-            valid.append(name)
-        else:
-            missing.append({"check": name, "action": check["message"]})
-
-    for name, check in OPTIONAL_CHECKS.items():
-        passed = check["test"](config_response)
-        checks[name] = passed
-        if passed:
-            valid.append(name)
-        else:
-            warnings.append({"check": name, "action": check["message"]})
-
-    all_required_pass = len(missing) == 0
+    for k in all_keys:
+        checks[k] = k not in missing_keys and k not in warning_keys
 
     # Build workspace info from response
     workspace = config_response.get("workspace", {})
@@ -88,15 +69,15 @@ def main() -> None:
     # Write validation cache
     cache = {
         "timestamp": datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
-        "valid": all_required_pass,
+        "valid": is_valid,
         "workspace": {
             "id": workspace.get("id", ""),
             "name": workspace.get("name", ""),
         },
         "provider": provider_type,
         "checks": checks,
-        "missing": [m["check"] for m in missing],
-        "warnings": [w["check"] for w in warnings],
+        "missing": missing_keys,
+        "warnings": warning_keys,
     }
 
     cache_path = client.project_root / ".flydocs" / "validation-cache.json"
@@ -106,7 +87,7 @@ def main() -> None:
         f.write("\n")
 
     # If all required checks pass, set setupComplete in config
-    if all_required_pass:
+    if is_valid:
         config_path = client.config_path
         if config_path.exists():
             with open(config_path, "r") as f:
@@ -121,15 +102,15 @@ def main() -> None:
 
     # Output structured report
     report: dict = {
-        "valid": all_required_pass,
+        "valid": is_valid,
         "checks": checks,
-        "passed": valid,
+        "passed": [k for k, v in checks.items() if v],
     }
     if missing:
         report["missing"] = missing
     if warnings:
         report["warnings"] = warnings
-    if all_required_pass:
+    if is_valid:
         report["setupComplete"] = True
 
     output_json(report)

package/template/.flydocs/config.json

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

package/template/.flydocs/version

@@ -1 +1 @@
-0.6.0-alpha.10
+0.6.0-alpha.11

package/template/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.6.0-alpha.10",
+  "version": "0.6.0-alpha.11",
   "description": "FlyDocs Core - Manifest of all managed files",
   "repository": "github.com/plastrlab/flydocs-core",