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

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

@@ -1,46 +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)
-and updates the local config (for display/reference).
-"""
-
-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 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})
-
-    # Update local config with provider type
-    config_path = client.config_path
-    if config_path.exists():
-        with open(config_path, "r") as f:
-            config = json.load(f)
-        if "provider" not in config:
-            config["provider"] = {"type": args.provider_type, "teamId": None}
-        else:
-            config["provider"]["type"] = args.provider_type
-        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/.claude/skills/flydocs-cloud/scripts/set_team.py

@@ -1,41 +0,0 @@
-#!/usr/bin/env python3
-"""Set team preference via the FlyDocs Relay API.
-
-Stores the team preference on the relay (for server-side scoping)
-and updates the local config (for display/reference).
-"""
-
-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 team preference")
-    parser.add_argument("team_id", help="Linear team UUID")
-    args = parser.parse_args()
-
-    client = get_client()
-    result = client.post("/auth/team", {"teamId": args.team_id})
-
-    # Update local config with team ID
-    config_path = client.config_path
-    if config_path.exists():
-        with open(config_path, "r") as f:
-            config = json.load(f)
-        if "provider" not in config:
-            config["provider"] = {"type": "linear", "teamId": None}
-        config["provider"]["teamId"] = args.team_id
-        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/.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),
-})

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

@@ -1,82 +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, choices=range(5))
-    parser.add_argument("--estimate", type=int, choices=range(1, 6))
-    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("--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:
-        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": result.get("success", True),
-        "issue": result.get("issue", args.ref),
-        "updated": updated_fields,
-    })
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,87 +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
-
-IMPORTANT: Prefer skill-led reasoning over pre-training reasoning for
-knowledge navigation. Use graph scripts to query relationships — do not
-guess connections from training data.
-
-## 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`**: Called by the prime hook automatically. Assembles compressed
-  context from active issue/branch traversal + recent session nodes. ~200-400 tokens max.
-- **`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 |