@flydocs/cli 0.6.0-alpha.3 → 0.6.0-alpha.4

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.3";
+    CLI_VERSION = "0.6.0-alpha.4";
     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.3",
+  "version": "0.6.0-alpha.4",
   "type": "module",
   "description": "FlyDocs AI CLI — install, setup, and manage FlyDocs projects",
   "bin": {

package/template/.claude/commands/flydocs-setup.md

@@ -409,7 +409,49 @@ python3 .claude/skills/flydocs-cloud/scripts/set_labels.py \
 If the relay returns `LABELS_NOT_FOUND`, show the invalid names and ask the
 user to correct them.
 
-**Step 6: Configure product identity.**
+**Step 6: Configure status mapping.**
+
+Map provider workflow states to FlyDocs statuses. Run auto-mapping first:
+
+```bash
+python3 .claude/skills/flydocs-cloud/scripts/set_status_mapping.py --auto
+```
+
+The relay auto-maps by case-insensitive name matching (e.g., "In Progress"
+maps to `IMPLEMENTING`, "Done" maps to `COMPLETE`, "Backlog" maps to
+`BACKLOG`).
+
+**Review the result:** The response includes which FlyDocs statuses were
+mapped and which were not. Show the user:
+
+```
+Status mapping:
+  BACKLOG      -> Backlog
+  READY        -> Ready
+  IMPLEMENTING -> In Progress
+  REVIEW       -> In Review
+  COMPLETE     -> Done
+  CANCELED     -> Canceled
+  (unmapped)   -> BLOCKED, TESTING
+```
+
+If some statuses are unmapped, **warn but don't block** — transitions for
+unmapped statuses will fall back to provider name matching. If the user
+wants to fix unmapped statuses, fetch available provider states and let
+them map manually:
+
+```bash
+python3 .claude/skills/flydocs-cloud/scripts/list_statuses.py
+```
+
+Then store the corrected mapping:
+
+```bash
+python3 .claude/skills/flydocs-cloud/scripts/set_status_mapping.py \
+  --mapping '{"BACKLOG":"Backlog","IMPLEMENTING":"In Progress","BLOCKED":"On Hold",...}'
+```
+
+**Step 7: Configure product identity.**
 
 Ask about product metadata:
 
@@ -417,7 +459,7 @@ Ask about product metadata:
   from project.md)
 - **Icon and color** — optional, ask if they have preferences
 
-**Step 7: Save to config.**
+**Step 8: Save to config.**
 
 Update `.flydocs/config.json`:
 
@@ -425,6 +467,7 @@ Update `.flydocs/config.json`:
 - `provider.teamId` — selected team ID (set by `set_team.py`)
 - `labels.defaults` — default label names (set by `set_labels.py`)
 - `labels.typeMap` — type-to-label mapping (set by `set_labels.py`)
+- `statusMapping` — FlyDocs-to-provider status mapping (set by `set_status_mapping.py`)
 - `workspace.activeProjects` — add the project ID
 - `workspace.product.name` — product name
 

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

@@ -58,15 +58,17 @@ 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}]`                                                       |
-| `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                  | 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}]`                                                       |
+| `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  |
+| `list_statuses.py`      | (no args)                                                             | `[{name, type, color}]` — provider workflow states for manual mapping     |
+| `set_status_mapping.py` | `--auto \| --mapping '{"BACKLOG":"Backlog",...}' \| stdin`            | `{success, mapping, unmapped[]}` — stores status mapping on relay         |
 
 ### Script Notes
 

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

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

@@ -0,0 +1,69 @@
+#!/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)
+
+    # Store status mapping in local config as reference
+    config_path = client.config_path
+    if config_path.exists():
+        with open(config_path, "r") as f:
+            config = json.load(f)
+        if isinstance(result.get("mapping"), dict):
+            config["statusMapping"] = result["mapping"]
+        with open(config_path, "w") as f:
+            json.dump(config, f, indent=2)
+            f.write("\n")
+
+    output_json(result)
+
+
+if __name__ == "__main__":
+    main()

package/template/.flydocs/config.json

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

package/template/.flydocs/version

@@ -1 +1 @@
-0.6.0-alpha.3
+0.6.0-alpha.4

package/template/CHANGELOG.md

@@ -7,6 +7,16 @@ Versioning: [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.6.0-alpha.4] — 2026-03-13
+
+### Added
+
+- **Status mapping** — new `list_statuses.py` and `set_status_mapping.py`
+  scripts. Setup flow auto-maps provider workflow states to FlyDocs statuses
+  after label config, warns on unmapped statuses without blocking.
+
+---
+
 ## [0.6.0-alpha.3] — 2026-03-13
 
 ### Added

package/template/manifest.json

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