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

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

@@ -1,100 +0,0 @@
-#!/usr/bin/env python3
-"""Bulk update an issue — set multiple fields in a single API call."""
-
-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="Update issue fields")
-    parser.add_argument("ref", help="Issue reference (e.g., ENG-123)")
-    parser.add_argument("--title", default=None)
-    parser.add_argument("--priority", type=int, help="Priority (0-4, relay translates per provider)")
-    parser.add_argument("--estimate", type=int, help="Estimate points (relay translates per provider)")
-    parser.add_argument("--assignee", default=None)
-    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("--milestone", default=None, help="Milestone ID or name (resolved by name lookup)")
-    parser.add_argument("--comment", default=None)
-    args = parser.parse_args()
-
-    # Build request body from provided args
-    body: dict = {}
-    updated_fields: list[str] = []
-
-    if args.title is not None:
-        body["title"] = args.title
-        updated_fields.append("title")
-
-    if args.priority is not None:
-        body["priority"] = args.priority
-        updated_fields.append("priority")
-
-    if args.estimate is not None:
-        body["estimate"] = args.estimate
-        updated_fields.append("estimate")
-
-    if args.assignee is not None:
-        body["assignee"] = args.assignee
-        updated_fields.append("assignee")
-
-    if args.state is not None:
-        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}")
-        body["description"] = path.read_text()
-        updated_fields.append("description")
-    elif args.description is not None:
-        body["description"] = args.description
-        updated_fields.append("description")
-
-    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")
-
-    if not body and args.milestone is None:
-        fail("No fields to update. Use --title, --priority, --estimate, --assignee, --state, --description, --labels, --milestone, or --comment")
-
-    client = get_client()
-
-    if args.milestone is not None:
-        milestone_id = args.milestone
-        # If it doesn't look like a UUID, resolve by name
-        if len(milestone_id) != 36 or "-" not in milestone_id:
-            milestones = client.get("/milestones")
-            match = None
-            for m in milestones:
-                if m["name"].lower() == milestone_id.lower():
-                    match = m
-                    break
-            if not match:
-                fail(f"Milestone not found: {milestone_id}")
-            milestone_id = match["id"]
-        body["milestoneId"] = milestone_id
-        updated_fields.append("milestone")
-
-    result = client.patch(f"/issues/{args.ref}", body)
-
-    output_json({
-        "success": result.get("success", True),
-        "issue": result.get("issue", args.ref),
-        "updated": updated_fields,
-    })
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,42 +0,0 @@
-#!/usr/bin/env python3
-"""Update a milestone 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="Update milestone")
-    parser.add_argument("milestone_id", help="Milestone UUID")
-    parser.add_argument("--name", default=None)
-    parser.add_argument("--target-date", default=None, dest="target_date")
-    parser.add_argument("--description", default=None)
-    args = parser.parse_args()
-
-    body: dict = {}
-    if args.name is not None:
-        body["name"] = args.name
-    if args.target_date is not None:
-        body["targetDate"] = args.target_date
-    if args.description is not None:
-        body["description"] = args.description
-
-    if not body:
-        fail("No fields to update. Use --name, --target-date, or --description")
-
-    client = get_client()
-    result = client.patch(f"/milestones/{args.milestone_id}", body)
-
-    output_json({
-        "success": result.get("success", True),
-        "id": result.get("id", args.milestone_id),
-        "name": result.get("name", args.name),
-    })
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,120 +0,0 @@
-#!/usr/bin/env python3
-"""Validate workspace setup via the FlyDocs Relay API.
-
-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
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-
-# 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",
-}
-
-DEFAULT_MESSAGE = "Not configured — check FlyDocs dashboard"
-
-
-def main() -> None:
-    client = get_client()
-
-    # Fetch workspace config from relay — relay does the validation
-    config_response = client.get("/auth/config")
-
-    # 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] = {}
-    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", {})
-    provider_type = config_response.get("provider", {}).get("type", "unknown")
-
-    # Write validation cache
-    cache = {
-        "timestamp": datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
-        "valid": is_valid,
-        "workspace": {
-            "id": workspace.get("id", ""),
-            "name": workspace.get("name", ""),
-        },
-        "provider": provider_type,
-        "checks": checks,
-        "missing": missing_keys,
-        "warnings": warning_keys,
-    }
-
-    cache_path = client.project_root / ".flydocs" / "validation-cache.json"
-    cache_path.parent.mkdir(parents=True, exist_ok=True)
-    with open(cache_path, "w") as f:
-        json.dump(cache, f, indent=2)
-        f.write("\n")
-
-    # If all required checks pass, set setupComplete in config
-    if is_valid:
-        config_path = client.config_path
-        if config_path.exists():
-            with open(config_path, "r") as f:
-                local_config = json.load(f)
-        else:
-            local_config = {}
-
-        local_config["setupComplete"] = True
-        with open(config_path, "w") as f:
-            json.dump(local_config, f, indent=2)
-            f.write("\n")
-
-    # Output structured report
-    report: dict = {
-        "valid": is_valid,
-        "checks": checks,
-        "passed": [k for k, v in checks.items() if v],
-    }
-    if missing:
-        report["missing"] = missing
-    if warnings:
-        report["warnings"] = warnings
-    if is_valid:
-        report["setupComplete"] = True
-
-    output_json(report)
-
-
-if __name__ == "__main__":
-    main()

package/template/.claude/skills/flydocs-context-graph/SKILL.md

@@ -1,94 +0,0 @@
----
-name: flydocs-context-graph
-description: |
-  Project knowledge graph — relationship-aware context assembly from skills,
-  ADRs, issues, modules, and sessions. Use when navigating dependencies,
-  understanding impact, or assembling session context.
-triggers:
-  - context graph
-  - knowledge graph
-  - graph
-  - dependencies
-  - impact analysis
-  - session context
-  - related decisions
----
-
-# Context Graph
-
-On-demand query layer for structural relationships in the project knowledge
-graph. Use graph scripts to explore dependencies, impact, and cross-references
-between skills, ADRs, issues, and sessions.
-
-The graph is **not** auto-injected into prompts. The prompt hook reads
-lightweight orientation files directly (`.flydocs/session/last-summary.json`,
-`flydocs/context/project.md`). Use the graph scripts below when you need
-deeper structural queries — relationship traversal, impact analysis, or
-dependency chains.
-
-## Key Rules
-
-1. **Graph is derived, not authored.** Run `graph_build.py` to rebuild from
-   source files. Manual edges use `graph_update.py` and are preserved on rebuild.
-2. **Stdlib-only Python.** No external dependencies in any script.
-3. **JSON storage.** Graph lives at `flydocs/context/graph.json` — no database.
-4. **Gitignored.** The graph contains session-specific data. Rebuild from sources.
-
-## Script Catalog
-
-All scripts: `python3 .claude/skills/flydocs-context-graph/scripts/<script>`
-
-| Script             | Usage                                                                | Output                                               |
-| ------------------ | -------------------------------------------------------------------- | ---------------------------------------------------- |
-| `graph_build.py`   | `[--root PATH]`                                                      | Rebuild graph from skills, ADRs. Writes `graph.json` |
-| `graph_query.py`   | `--node ID [--depth N] [--rel TYPE] [--reverse] [--format json\|md]` | Context block (markdown or JSON)                     |
-| `graph_update.py`  | `add-node ID --type TYPE [--label STR] [--path STR]`                 | `{success, node}`                                    |
-|                    | `remove-node ID`                                                     | `{success, removed}`                                 |
-|                    | `add-edge FROM TO REL [--weight N] [--manual]`                       | `{success, edge}`                                    |
-|                    | `remove-edge FROM TO REL`                                            | `{success, removed}`                                 |
-| `graph_context.py` | `[--issue REF] [--branch NAME]`                                      | Plain text context block for prime hook              |
-| `graph_session.py` | `--summary "..." [--issue REF]... [--decision NNN]...`               | `{success, sessionId, edges[]}`                      |
-
-### Script Notes
-
-- **`graph_build.py`**: Scans `.claude/skills/*/SKILL.md` and
-  `flydocs/knowledge/decisions/*.md`. Extracts cross-references from ADR
-  "Relationship to Other ADRs" sections. Preserves edges marked `"manual": true`.
-- **`graph_query.py --depth`**: BFS traversal depth (default 2). Higher depth
-  returns more context but may be noisy.
-- **`graph_query.py --reverse`**: Follow edges in reverse direction (who points to this node?).
-- **`graph_update.py --manual`**: Mark edge as manually added (preserved on rebuild).
-- **`graph_context.py`**: Available for manual queries. Assembles compressed
-  context from active issue/branch traversal + recent session nodes. ~200-400 tokens max.
-  Not called automatically by the prompt hook (replaced by direct file reads in v0.6.0).
-- **`graph_session.py`**: Called during session wrap. Creates a session node with
-  WORKED_ON edges to issues. Session nodes older than 30 days get reduced weight;
-  nodes within 7 days get full weight.
-
-## Node Types
-
-| Type       | ID Pattern           | Source               |
-| ---------- | -------------------- | -------------------- |
-| `skill`    | `skill:{name}`       | SKILL.md frontmatter |
-| `decision` | `decision:{number}`  | ADR directory        |
-| `issue`    | `issue:{identifier}` | Issue tracker        |
-| `module`   | `module:{name}`      | Manual               |
-| `session`  | `session:{date-seq}` | Session wrap         |
-| `concept`  | `concept:{name}`     | Manual               |
-
-## Edge Types
-
-| Relationship   | Meaning                    |
-| -------------- | -------------------------- |
-| `EXTENDS`      | Builds on, refines         |
-| `IMPLEMENTS`   | Realizes in code/config    |
-| `DELEGATES_TO` | Hands off execution        |
-| `PRECEDES`     | Should load/execute before |
-| `MODIFIES`     | Changes/affects            |
-| `WORKED_ON`    | Session activity           |
-| `PRODUCED`     | Created as output          |
-| `RELATES_TO`   | General association        |
-| `SUPERSEDES`   | Replaces                   |
-| `BLOCKS`       | Prevents progress          |
-
-For full schema details, see `schema.md`.

package/template/.claude/skills/flydocs-context-graph/schema.md

@@ -1,78 +0,0 @@
-# Context Graph Schema
-
-Reference for the graph JSON structure stored at `flydocs/context/graph.json`.
-
-## Top-Level Structure
-
-```json
-{
-  "version": 1,
-  "updated": "ISO-8601 timestamp",
-  "nodes": { "<id>": { ... } },
-  "edges": [ { ... } ]
-}
-```
-
-## Node Schema
-
-```json
-{
-  "type": "skill | decision | issue | module | session | concept",
-  "label": "Human-readable name",
-  "path": "Relative file path (optional)",
-  "status": "Node-specific status (optional)",
-  "date": "ISO date for temporal nodes (optional)",
-  "tier": "Skill tier: behavioral | mechanism | premium (optional)",
-  "manual": true
-}
-```
-
-**ID conventions:**
-
-| Type | Pattern | Example |
-|------|---------|---------|
-| skill | `skill:{directory-name}` | `skill:typescript-strict` |
-| decision | `decision:{3-digit-number}` | `decision:001` |
-| issue | `issue:{identifier}` | `issue:FLY-56` |
-| module | `module:{kebab-name}` | `module:install-script` |
-| session | `session:{YYYY-MM-DD-seq}` | `session:2026-02-03-a` |
-| concept | `concept:{kebab-name}` | `concept:progressive-disclosure` |
-
-## Edge Schema
-
-```json
-{
-  "from": "source node ID",
-  "to": "target node ID",
-  "rel": "RELATIONSHIP_TYPE",
-  "weight": 0.0-1.0,
-  "manual": true
-}
-```
-
-**Weight guidelines:**
-
-| Weight | Meaning |
-|--------|---------|
-| 1.0 | Direct, strong relationship |
-| 0.7-0.9 | Strong but indirect |
-| 0.4-0.6 | Moderate association |
-| 0.1-0.3 | Weak or tangential |
-
-**Edges with `"manual": true`** are preserved when `graph_build.py` rebuilds
-the graph from sources. Auto-derived edges are regenerated on each build.
-
-## Relationship Types
-
-| Relationship | Direction | Example |
-|-------------|-----------|---------|
-| `EXTENDS` | A extends B | ADR-004 extends ADR-001 |
-| `IMPLEMENTS` | A implements B | Issue implements a decision |
-| `DELEGATES_TO` | A delegates to B | Workflow delegates to mechanism |
-| `PRECEDES` | A should load before B | typescript-strict precedes implementation |
-| `MODIFIES` | A modifies B | Issue modifies a module |
-| `WORKED_ON` | A worked on B | Session worked on an issue |
-| `PRODUCED` | A produced B | Session produced a decision |
-| `RELATES_TO` | A relates to B | General association |
-| `SUPERSEDES` | A supersedes B | New decision replaces old |
-| `BLOCKS` | A blocks B | Issue blocks another issue |