@flydocs/cli 0.5.0-beta.7 → 0.5.0-beta.9

package/dist/cli.js

@@ -15,7 +15,7 @@ var CLI_VERSION, CLI_NAME, PACKAGE_NAME;
 var init_constants = __esm({
   "src/lib/constants.ts"() {
     "use strict";
-    CLI_VERSION = "0.5.0-beta.7";
+    CLI_VERSION = "0.5.0-beta.9";
     CLI_NAME = "flydocs";
     PACKAGE_NAME = "@flydocs/cli";
   }
@@ -136,6 +136,9 @@ var init_template = __esm({
 
 // src/lib/ui.ts
 import pc2 from "picocolors";
+function hyperlink(text3, url) {
+  return `\x1B]8;;${url}\x1B\\${text3}\x1B]8;;\x1B\\`;
+}
 function printStatus(message) {
   console.log(`${pc2.green("\u2714")} ${message}`);
 }
@@ -162,10 +165,10 @@ function printBanner(version) {
   console.log(`  ${pinkBlock12}`);
   console.log(`  ${pinkBlock4}`);
   console.log(
-    `  ${pinkBlock4}  ${purpleBlock12}  ${bold("Fly")}${bold("Docs")} ${bold("Core")}`
+    `  ${pinkBlock4}  ${purpleBlock12}  ${bold("FlyDocs")} ${dim("(Beta)")}`
   );
   console.log(
-    `        ${purpleBlock12}  ${dim("Context-as-a-Service Platform Built for Engineering at Altitude")}`
+    `        ${purpleBlock12}  ${dim("Spec-Driven Context That Helps Engineers Fly")}`
   );
   console.log(`        ${purpleBlock4}`);
   console.log(`        ${purpleBlock4}          ${dim(`v${version}`)}`);
@@ -189,17 +192,16 @@ function printCompletionBox(title, lines) {
 }
 function printBetaCta() {
   const dim = pc2.dim;
+  const url = "https://www.flydocs.ai?utm_source=cli&utm_medium=install&utm_campaign=beta";
   console.log(
     dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")
   );
   console.log();
   console.log(`  ${pc2.bold("Join the FlyDocs Closed Beta")}`);
   console.log(
-    `  ${dim("Early access to cloud features, priority support, and more.")}`
-  );
-  console.log(
-    `  ${pc2.cyan("https://www.flydocs.ai?utm_source=cli&utm_medium=install&utm_campaign=beta")}`
+    `  ${dim("Early access to cloud features, web portal, and more.")}`
   );
+  console.log(`  ${pc2.cyan(hyperlink("flydocs.ai", url))}`);
   console.log();
 }
 var init_ui = __esm({
@@ -371,6 +373,16 @@ async function copyCursorRules(targetDir) {
       await copyFile(mechRule, join4(rulesDir, "flydocs-mechanism.mdc"));
     }
   }
+  const context7Rule = join4(
+    targetDir,
+    ".claude",
+    "skills",
+    "flydocs-context7",
+    "cursor-rule.mdc"
+  );
+  if (await pathExists(context7Rule)) {
+    await copyFile(context7Rule, join4(rulesDir, "flydocs-context7.mdc"));
+  }
 }
 var OWNED_SKILLS, MECHANISM_SKILLS;
 var init_skills = __esm({
@@ -381,7 +393,8 @@ var init_skills = __esm({
       "flydocs-workflow",
       "flydocs-figma",
       "flydocs-estimates",
-      "flydocs-context-graph"
+      "flydocs-context-graph",
+      "flydocs-context7"
     ];
     MECHANISM_SKILLS = {
       local: "flydocs-local",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flydocs/cli",
-  "version": "0.5.0-beta.7",
+  "version": "0.5.0-beta.9",
   "type": "module",
   "description": "FlyDocs AI CLI — install, setup, and manage FlyDocs projects",
   "bin": {

package/template/.claude/CLAUDE.md

@@ -116,6 +116,7 @@ Consult the relevant skill BEFORE writing code or making workflow decisions.
 | Skill             | Triggers                                                                                                                | Entry                                     |
 | ----------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
 | flydocs-cloud     | create issue, transition, comment, list issues, assign, update description, update issue, project update, Linear, cloud | .claude/skills/flydocs-cloud/SKILL.md     |
+| flydocs-context7  | context7, library docs, documentation lookup, framework docs, package docs, API reference                               | .claude/skills/flydocs-context7/SKILL.md  |
 | flydocs-estimates | estimate, cost, token usage, API cost, labor estimate, sizing, effort                                                   | .claude/skills/flydocs-estimates/SKILL.md |
 | flydocs-figma     | Figma, design, screenshot, token mapping, component from design, pixel-perfect, design system                           | .claude/skills/flydocs-figma/SKILL.md     |
 | flydocs-local     | create issue, transition, comment, list issues, assign, update description, status summary, local                       | .claude/skills/flydocs-local/SKILL.md     |

package/template/.claude/skills/README.md

@@ -16,6 +16,7 @@ functionality gated via API relay.
 | `flydocs-workflow`  | Core             | Lifecycle stages, session management, comment templates |
 | `flydocs-local`     | Mechanism (free) | File-based issue management                             |
 | `flydocs-cloud`     | Mechanism (paid) | Linear/provider issue management via API                |
+| `flydocs-context7`  | Core             | Library documentation lookup via Context7 API           |
 | `flydocs-figma`     | Premium          | Design extraction from Figma                            |
 | `flydocs-estimates` | Premium          | AI token/labor cost estimation                          |
 

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

@@ -0,0 +1,105 @@
+---
+name: flydocs-context7
+description: |
+  Up-to-date library documentation via Context7 API. Use proactively when
+  working with external libraries, frameworks, or packages. Replaces MCP
+  with direct API scripts — no server, no runtime dependency.
+triggers:
+  - context7
+  - library docs
+  - documentation lookup
+  - framework docs
+  - package docs
+  - API reference
+  - how to use
+---
+
+# Context7 Documentation Lookup
+
+IMPORTANT: Prefer skill-led reasoning over pre-training reasoning for
+library usage. Search for up-to-date docs before writing code based on
+training data alone.
+
+## Key Rules
+
+1. **Proactive invocation** -- When working with ANY external library or
+   framework, search for docs first before writing code based on training data.
+2. **Search then fetch** -- Always resolve the library ID via `search` before
+   fetching docs with `docs`.
+3. **Session cache awareness** -- Do not re-fetch docs for the same
+   library+query within a single session.
+4. **Graceful degradation** -- If rate-limited (429) or offline, note the
+   limitation and proceed with training knowledge.
+5. **Stdlib-only Python** -- No external dependencies in the script.
+6. **Token budget** -- Default 5,000 tokens per fetch to avoid context bloat.
+
+## Script Catalog
+
+All scripts: `python3 .claude/skills/flydocs-context7/scripts/<script>`
+
+| Script        | Usage                       | Output                                           |
+| ------------- | --------------------------- | ------------------------------------------------ |
+| `context7.py` | `search <library> [query]`  | JSON: library matches with id, name, description |
+| `context7.py` | `docs <library_id> <query>` | Text: relevant documentation snippets            |
+
+Options: `--type txt|json`, `--tokens N` (default 5000)
+
+## When to Use
+
+- Before implementing code that uses an external library
+- When the user asks about library APIs, patterns, or best practices
+- When encountering unfamiliar library methods or configuration
+- When upgrading dependencies and needing current API docs
+- When debugging library-specific issues
+
+## When NOT to Use
+
+- For project-internal code (use knowledge base and context graph instead)
+- For general programming concepts (training knowledge is sufficient)
+- When already fetched docs for the same library in this session
+
+## API Key (Optional)
+
+- Works without a key (anonymous, ~1,000 calls/month)
+- For higher limits, add `CONTEXT7_API_KEY=ctx7sk-xxx` to `.env`
+- Free key available at context7.com/dashboard
+
+## Example Usage
+
+```bash
+# Find the React library
+python3 .claude/skills/flydocs-context7/scripts/context7.py search "react" "hooks"
+
+# Fetch docs for React hooks
+python3 .claude/skills/flydocs-context7/scripts/context7.py docs "/facebook/react" "useState useEffect hooks"
+
+# Get Next.js App Router docs
+python3 .claude/skills/flydocs-context7/scripts/context7.py search "next.js"
+python3 .claude/skills/flydocs-context7/scripts/context7.py docs "/vercel/next.js" "app router middleware"
+
+# Fetch with custom token budget
+python3 .claude/skills/flydocs-context7/scripts/context7.py docs "/expressjs/express" "routing middleware" --tokens 8000
+
+# Get output as JSON
+python3 .claude/skills/flydocs-context7/scripts/context7.py search "prisma" --type json
+```
+
+## Typical Workflow
+
+1. **Identify the library** you need docs for (from import statements,
+   `package.json`, or the task at hand).
+2. **Search** to resolve the library ID:
+   ```bash
+   python3 .claude/skills/flydocs-context7/scripts/context7.py search "react-hook-form"
+   ```
+3. **Fetch docs** for the specific topic:
+   ```bash
+   python3 .claude/skills/flydocs-context7/scripts/context7.py docs "/react-hook-form/react-hook-form" "useForm validation"
+   ```
+4. **Apply** the retrieved documentation to your implementation.
+5. **Do not re-fetch** for the same library+query later in the session.
+
+## Related Skills
+
+- `flydocs-context-graph` -- Project-internal knowledge navigation
+- `flydocs-workflow` -- Development lifecycle and issue operations

package/template/.claude/skills/flydocs-context7/cursor-rule.mdc

@@ -0,0 +1,49 @@
+---
+description: Context7 — look up library and framework documentation before writing code
+alwaysApply: true
+---
+
+<!-- Condensed from SKILL.md — update both when changing patterns -->
+
+# FlyDocs Context7
+
+Proactively look up library documentation via Context7 scripts before writing
+code that uses external packages. Do not rely on training data for API details.
+
+## When to Use
+
+- Installing or importing a library you haven't used in this session
+- Unsure about API signatures, configuration options, or return types
+- Framework-specific patterns (routing, data fetching, middleware, hooks)
+- Resolving version-specific behavior or breaking changes
+
+## Scripts
+
+```bash
+# Step 1: Search for the library
+python3 .claude/skills/flydocs-context7/scripts/context7.py search "<library>" "[query]"
+
+# Step 2: Fetch docs using the library ID from search results
+python3 .claude/skills/flydocs-context7/scripts/context7.py docs "<library_id>" "<query>"
+```
+
+### Examples
+
+React hooks:
+```bash
+python3 .claude/skills/flydocs-context7/scripts/context7.py search "react" "hooks"
+python3 .claude/skills/flydocs-context7/scripts/context7.py docs "/facebook/react" "hooks useState"
+```
+
+Next.js App Router:
+```bash
+python3 .claude/skills/flydocs-context7/scripts/context7.py search "next.js"
+python3 .claude/skills/flydocs-context7/scripts/context7.py docs "/vercel/next.js" "app router middleware"
+```
+
+## Key Rules
+
+- Always resolve the library ID first via `search` — do not guess the ID format
+- Prefer Context7 docs over training data for API specifics
+- If Context7 has no results or is rate-limited, fall back to web search
+- Cache within a session — no need to re-fetch the same library docs repeatedly

package/template/.claude/skills/flydocs-context7/scripts/context7.py

@@ -0,0 +1,293 @@
+#!/usr/bin/env python3
+"""Context7 API client for fetching library documentation.
+
+Queries the Context7 REST API to search for libraries and retrieve
+LLM-ready documentation. Replaces the Context7 MCP server with a
+lightweight script that follows the FlyDocs mechanism pattern.
+
+Usage:
+    python3 .claude/skills/flydocs-context7/scripts/context7.py \\
+        search <library_name> [query]
+
+    python3 .claude/skills/flydocs-context7/scripts/context7.py \\
+        docs <library_id> <query> [--type txt|json] [--tokens N]
+"""
+
+import argparse
+import json
+import os
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+from pathlib import Path
+
+BASE_URL = "https://context7.com/api/v2"
+DEFAULT_TIMEOUT = 10
+DEFAULT_TOKENS = 5000
+
+
+# --- Helpers ---
+
+
+def fail(message):
+    """Print error to stderr and exit 1."""
+    print(message, file=sys.stderr)
+    sys.exit(1)
+
+
+def output_json(data):
+    """Print JSON to stdout."""
+    print(json.dumps(data, indent=2))
+
+
+def find_project_root(start=None):
+    """Walk up from start (or script location) to find the directory containing .flydocs/."""
+    current = Path(start) if start else Path(__file__).resolve().parent
+    for parent in [current] + list(current.parents):
+        if (parent / ".flydocs").is_dir():
+            return parent
+    return None
+
+
+def read_env_file(root):
+    """Read .env file at project root and return a dict of key=value pairs."""
+    env_path = root / ".env"
+    if not env_path.is_file():
+        return {}
+
+    env_vars = {}
+    try:
+        with open(env_path, "r", encoding="utf-8") as f:
+            for line in f:
+                line = line.strip()
+                # Skip empty lines and comments
+                if not line or line.startswith("#"):
+                    continue
+                if "=" not in line:
+                    continue
+                key, _, value = line.partition("=")
+                key = key.strip()
+                value = value.strip()
+                # Strip surrounding quotes if present
+                if len(value) >= 2 and value[0] == value[-1] and value[0] in ('"', "'"):
+                    value = value[1:-1]
+                env_vars[key] = value
+    except OSError:
+        pass
+
+    return env_vars
+
+
+def resolve_api_key(args_key):
+    """Resolve the API key from flag, env var, or .env file. Returns None if unavailable."""
+    # 1. Explicit flag
+    if args_key:
+        return args_key
+
+    # 2. Environment variable
+    env_key = os.environ.get("CONTEXT7_API_KEY")
+    if env_key:
+        return env_key
+
+    # 3. .env file at project root
+    root = find_project_root()
+    if root:
+        env_vars = read_env_file(root)
+        dotenv_key = env_vars.get("CONTEXT7_API_KEY")
+        if dotenv_key:
+            return dotenv_key
+
+    # 4. Anonymous (no key)
+    return None
+
+
+def api_request(path, params, api_key=None):
+    """Make a GET request to the Context7 API and return parsed response data.
+
+    Handles HTTP errors, timeouts, and network failures with clear messages.
+    """
+    query_string = urllib.parse.urlencode(params)
+    url = f"{BASE_URL}/{path}?{query_string}"
+
+    request = urllib.request.Request(url)
+    request.add_header("User-Agent", "flydocs-context7/1.0")
+
+    if api_key:
+        request.add_header("Authorization", f"Bearer {api_key}")
+
+    try:
+        with urllib.request.urlopen(request, timeout=DEFAULT_TIMEOUT) as response:
+            body = response.read().decode("utf-8")
+            content_type = response.headers.get("Content-Type", "")
+            if "application/json" in content_type:
+                return json.loads(body)
+            return body
+    except urllib.error.HTTPError as e:
+        if e.code == 429:
+            fail("Rate limited by Context7 API. Wait a moment and try again.")
+        body_text = ""
+        try:
+            body_text = e.read().decode("utf-8", errors="replace")
+        except Exception:
+            pass
+        fail(f"Context7 API error (HTTP {e.code}): {e.reason}\n{body_text}".strip())
+    except urllib.error.URLError as e:
+        if "timed out" in str(e.reason).lower():
+            fail("Context7 API request timed out (10s). The service may be slow or unavailable.")
+        fail(f"Cannot reach Context7 API. Check your network connection.\nDetails: {e.reason}")
+    except OSError as e:
+        fail(f"Network error connecting to Context7 API: {e}")
+
+
+# --- Commands ---
+
+
+def cmd_search(args):
+    """Search for libraries by name and optional query."""
+    params = {"libraryName": args.library_name}
+    if args.query:
+        params["query"] = args.query
+
+    api_key = resolve_api_key(args.key)
+    data = api_request("libs/search", params, api_key=api_key)
+
+    # Normalize response — API wraps results in {"results": [...]}
+    if isinstance(data, dict) and "results" in data:
+        results = data["results"]
+    elif isinstance(data, list):
+        results = data
+    else:
+        results = []
+
+    if args.type == "json" or args.type is None:
+        # Default for search is JSON
+        compact = []
+        for lib in results:
+            compact.append({
+                "id": lib.get("id", ""),
+                "name": lib.get("title", lib.get("name", "")),
+                "description": lib.get("description", ""),
+                "trustScore": lib.get("trustScore", 0),
+            })
+        output_json(compact)
+    else:
+        # txt format for search — one line per result
+        for lib in results:
+            name = lib.get("title", lib.get("name", "unknown"))
+            lib_id = lib.get("id", "")
+            desc = lib.get("description", "")
+            score = lib.get("trustScore", 0)
+            print(f"{lib_id}  {name}  (trust: {score})")
+            if desc:
+                print(f"  {desc}")
+            print()
+
+
+def cmd_docs(args):
+    """Fetch documentation for a specific library."""
+    params = {
+        "libraryId": args.library_id,
+        "query": args.query,
+    }
+
+    output_type = args.type if args.type else "txt"
+    params["type"] = output_type
+
+    if args.tokens:
+        params["tokens"] = str(args.tokens)
+
+    api_key = resolve_api_key(args.key)
+    data = api_request("context", params, api_key=api_key)
+
+    if output_type == "json":
+        if isinstance(data, str):
+            # API returned text when we asked for JSON; wrap it
+            output_json({"content": data})
+        else:
+            output_json(data)
+    else:
+        # txt — print directly
+        if isinstance(data, str):
+            print(data)
+        elif isinstance(data, dict):
+            content = data.get("content", data.get("text", ""))
+            if content:
+                print(content)
+            else:
+                output_json(data)
+        else:
+            output_json(data)
+
+
+# --- Main ---
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Context7 API client — search libraries and fetch documentation"
+    )
+    parser.add_argument(
+        "--key", type=str, default=None,
+        help="API key override (default: CONTEXT7_API_KEY env var or .env file)"
+    )
+
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    # search subcommand
+    search_parser = subparsers.add_parser(
+        "search",
+        help="Search for libraries by name"
+    )
+    search_parser.add_argument(
+        "library_name",
+        help="Library name to search for (e.g., 'react', 'next.js')"
+    )
+    search_parser.add_argument(
+        "query", nargs="?", default=None,
+        help="Optional search query to refine results"
+    )
+    search_parser.add_argument(
+        "--type", choices=["txt", "json"], default=None,
+        help="Output format (default: json for search)"
+    )
+    search_parser.add_argument(
+        "--tokens", type=int, default=DEFAULT_TOKENS,
+        help=f"Max tokens budget hint (default: {DEFAULT_TOKENS})"
+    )
+
+    # docs subcommand
+    docs_parser = subparsers.add_parser(
+        "docs",
+        help="Fetch documentation for a library"
+    )
+    docs_parser.add_argument(
+        "library_id",
+        help="Library ID from search results (e.g., '/vercel/next.js')"
+    )
+    docs_parser.add_argument(
+        "query",
+        help="Documentation query (e.g., 'server components', 'routing')"
+    )
+    docs_parser.add_argument(
+        "--type", choices=["txt", "json"], default=None,
+        help="Output format (default: txt for docs)"
+    )
+    docs_parser.add_argument(
+        "--tokens", type=int, default=DEFAULT_TOKENS,
+        help=f"Max tokens budget hint (default: {DEFAULT_TOKENS})"
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "search":
+        cmd_search(args)
+    elif args.command == "docs":
+        cmd_docs(args)
+    else:
+        parser.print_help()
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/template/.env.example

@@ -33,9 +33,17 @@ LINEAR_API_KEY=
 # OPTIONAL: Figma Access Token
 # ===========================================
 # Get from: Figma → Settings → Personal Access Tokens
-# Only needed if using Figma MCP for design integration
+# Only needed if using the flydocs-figma skill for design integration
 FIGMA_ACCESS_TOKEN=
 
+# ===========================================
+# OPTIONAL: Context7 API Key
+# ===========================================
+# Enables higher rate limits for library documentation lookup
+# Get from: context7.com/dashboard (free account)
+# Works without a key at lower rate limits (~1,000 calls/month)
+CONTEXT7_API_KEY=
+
 # ===========================================
 # NOTE: Team ID and Project ID are discovered automatically
 # ===========================================

package/template/.flydocs/config.json

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

package/template/.flydocs/hooks/auto-approve.py

@@ -21,7 +21,7 @@ import re
 # Pattern matches any flydocs skill scripts directory
 # Covers: flydocs-local, flydocs-cloud, flydocs-workflow, flydocs-context-graph
 APPROVED_PATTERN = re.compile(
-    r'python3?\s+(?:["\']?(?:\$CLAUDE_PROJECT_DIR|\$\{CLAUDE_PROJECT_DIR\}|\.)["\']?/)?\.?claude/skills/flydocs-(?:local|cloud|workflow|context-graph)/scripts/\w+\.py'
+    r'python3?\s+(?:["\']?(?:\$CLAUDE_PROJECT_DIR|\$\{CLAUDE_PROJECT_DIR\}|\.)["\']?/)?\.?claude/skills/flydocs-(?:local|cloud|workflow|context-graph|context7)/scripts/\w+\.py'
 )
 
 

package/template/.flydocs/version

@@ -1 +1 @@
-0.5.0-beta.7
+0.5.0-beta.9

package/template/AGENTS.md

@@ -95,6 +95,7 @@ Consult the relevant skill BEFORE writing code or making workflow decisions.
 | Skill             | Triggers                                                                                                                | Entry                                     |
 | ----------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
 | flydocs-cloud     | create issue, transition, comment, list issues, assign, update description, update issue, project update, Linear, cloud | .claude/skills/flydocs-cloud/SKILL.md     |
+| flydocs-context7  | context7, library docs, documentation lookup, framework docs, package docs, API reference                               | .claude/skills/flydocs-context7/SKILL.md  |
 | flydocs-estimates | estimate, cost, token usage, API cost, labor estimate, sizing, effort                                                   | .claude/skills/flydocs-estimates/SKILL.md |
 | flydocs-figma     | Figma, design, screenshot, token mapping, component from design, pixel-perfect, design system                           | .claude/skills/flydocs-figma/SKILL.md     |
 | flydocs-local     | create issue, transition, comment, list issues, assign, update description, status summary, local                       | .claude/skills/flydocs-local/SKILL.md     |

package/template/CHANGELOG.md

@@ -7,9 +7,73 @@ Versioning: [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.5.0-beta.9] — 2026-02-22
+
+### Changed
+
+- **Banner copy** — title changed from "FlyDocs Core" to "FlyDocs (Beta)",
+  subtitle changed to "Spec-Driven Context That Helps Engineers Fly"
+- **Beta CTA** — "priority support" replaced with "web portal", URL now
+  renders as clickable `flydocs.ai` hyperlink via OSC 8 terminal escape
+
+---
+
+## [0.5.0-beta.8] — 2026-02-22
+
+### Added
+
+- **Context7 documentation skill** (`flydocs-context7`) — stdlib-only Python script
+  that calls the Context7 REST API to fetch up-to-date library documentation.
+  Replaces the removed Context7 MCP with a skill+script pattern.
+  - `context7.py search <library> [query]` — resolve library name to Context7 ID
+  - `context7.py docs <library_id> <query>` — fetch relevant documentation snippets
+  - Works without API key (anonymous, ~1,000 calls/month); optional
+    `CONTEXT7_API_KEY` in `.env` for higher rate limits
+  - Auto-approved by hook for seamless agent invocation
+  - Cursor rule included for cross-IDE support
+- **Context7 API key** in `.env.example` — optional configuration for higher rate limits
+
+### Fixed
+
+- `.env.example` — corrected "Figma MCP" reference to "flydocs-figma skill"
+
+## [0.5.0-beta.7] — 2026-02-22
+
+### Removed
+
+- **All MCP references** — removed `.cursor/mcp.json`, `prefer-scripts.py` hook,
+  MCP config preservation in update flow, MCP section in instructions template.
+  Skills fully replace MCPs as the FlyDocs architecture.
+- **Phantom skills** — removed references to `implementation-flow`, `review-workflow`,
+  `spec-templates` skills that were never shipped.
+
+### Fixed
+
+- **Command injection** (`connect.ts`) — replaced `execSync` subprocess with native
+  `fetch()` for Linear API key validation.
+- **Version comparison** — pre-release versions (e.g. `0.5.0-beta.3`) now compare
+  correctly instead of returning NaN.
+- **Auto-approve hook** — tightened regex to anchor script paths, preventing potential
+  pattern-matching bypasses.
+- **Post-edit hook** — added path traversal validation using `os.path.realpath()`.
+- **Post-install scripts** — switched from `execSync` to `execFileSync` for subprocess safety.
+
+### Changed
+
+- **Stack detection** — now reads `flydocs/context/project.md` in addition to
+  `package.json` for declared stack frameworks.
+- **Community skills on update** — filters already-installed skills before prompting.
+- **Cloud exposure** — `.env.example` marked as cloud tier only, `flydocs/README.md`
+  rewritten as tier-generic, config defaults changed to `tier: "local"`.
+- **Deprecated cleanup** — `.cursor/mcp.json` and `prefer-scripts.py` added to
+  deprecated files list for automatic cleanup on update.
+
+---
+
 ## [0.4.0] — 2026-02-18
 
 ### Added
+
 - **Context Graph skill** (`flydocs-context-graph`) — relationship-aware knowledge
   graph that connects skills, ADRs, issues, modules, and sessions. Implemented as
   ADR-006 across five phases:
@@ -32,12 +96,14 @@ Versioning: [Semantic Versioning](https://semver.org/).
   graph automatically.
 
 ### Changed
+
 - **Session wrap procedure** — `session.md` now includes a step to record session
   outcomes in the context graph via `graph_session.py`. Skips silently if not installed.
 - **Session staleness policy** — session nodes within 7 days get full weight, linear
   decay to 30 days, then excluded from context.
 
 ### Migration
+
 - **`.gitignore` update** — `flydocs/context/graph.json` is automatically added to
   `.gitignore` during update if missing. The graph is gitignored because it contains
   session-specific data and can be rebuilt from sources.
@@ -47,6 +113,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.10] — 2026-02-17
 
 ### Fixed
+
 - **API null data crash** (FLY-178) — `flydocs_api.py` now normalizes `null` data
   responses to empty dict before returning. Fixes `AttributeError` crashes in all
   20+ scripts when Linear returns API errors. `create_issue.py` also retries without
@@ -65,6 +132,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.9] — 2026-02-17
 
 ### Added
+
 - **Skill search and install CLI** (ENG-443) — `flydocs skills` subcommand with
   `search`, `add`, `remove`, and `list` operations. Search the curated community
   skills catalog, install from known names or GitHub repo references, and manage
@@ -81,6 +149,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.8] — 2026-02-14
 
 ### Added
+
 - **`create_issue.py --description-file` and stdin** — both cloud and local tiers now
   accept `--description-file PATH` or piped stdin for issue descriptions. Eliminates
   the two-step create + update_description workaround for long descriptions.
@@ -92,6 +161,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.7] — 2026-02-11
 
 ### Added
+
 - **Skill manifest generator** (ENG-442) — `generate_manifest.py` scans SKILL.md
   frontmatter and produces a compressed skills index table. Injected into CLAUDE.md
   and AGENTS.md between `<!-- flydocs:skills-manifest -->` markers. Bridges skill
@@ -104,12 +174,14 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.6] — 2026-02-10
 
 ### Added
+
 - **Milestone, project, and dueDate in issue output** — `list_issues.py` now returns
   `milestone`, `milestoneId`, `milestoneSortOrder`, `project`, `projectId`, and `dueDate`
   for every issue. `get_issue.py` returns the same fields (minus `milestoneSortOrder`).
   Enables milestone-grouped dashboards and priority-based session planning.
 
 ### Changed
+
 - **Session start workflow rewritten** — `session.md` now instructs agents to group issues
   by milestone (in milestone order), identify the current milestone, suggest a starting point
   based on priority cascade (blocked → in-progress → due soon → highest priority in current
@@ -117,6 +189,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
   the product scope.
 
 ### Fixed
+
 - **`create_milestone.py` missing projectId** — `ProjectMilestoneCreateInput` requires a
   `projectId`. Script now defaults to first `activeProject` from config, with `--project`
   flag to override.
@@ -126,10 +199,12 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.5] — 2026-02-10
 
 ### Added
+
 - **`list_projects.py` product scope** (ENG-475) — now respects `workspace.activeProjects`
   config. `--all` bypasses product scope to show all team projects.
 
 ### Fixed
+
 - **`list_projects.py` 400 error** (ENG-474) — state filter was using nested
   `{type: {nin: [...]}}` instead of direct `StringComparator` `{nin: [...]}`.
   Both `--active` (started only) and default (excludes completed/canceled) now work.
@@ -143,6 +218,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.4] — 2026-02-10
 
 ### Added
+
 - **`list_issues.py --milestone` filter** — filter issues by project milestone ID.
   Get milestone IDs from `list_milestones.py`, then pass to `list_issues.py --milestone <ID>`
   to see all issues within a specific milestone.
@@ -152,6 +228,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.3] — 2026-02-10
 
 ### Fixed
+
 - **Shell escaping in `update_description.py`** — descriptions with apostrophes,
   parentheses, quotes, and other shell metacharacters no longer break when passed
   via `--text`. Scripts now accept stdin as input, allowing safe heredoc piping:
@@ -164,6 +241,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.2] — 2026-02-09
 
 ### Fixed
+
 - **API connection reliability** — reduced socket timeout from 30s to 10s and increased
   max retries from 3 to 5. Resolves intermittent hangs caused by DNS returning unreachable
   Cloudflare edge IPs. Scripts now fail over to a working IP within seconds instead of
@@ -176,11 +254,13 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.1] — 2026-02-08
 
 ### Fixed
+
 - **`list_issues.py` product scope** — scoping via `activeProjects` and `product.labelIds`
   now applies regardless of `--active` or `--status` flags. Previously, these flags
   bypassed product scope entirely, returning all team issues.
 
 ### Added
+
 - **`build_product_scope()` API helper** — new method on `FlyDocsClient` implements the
   product scope cascade: `activeProjects` → `product.labelIds` → team-wide.
 - **Multiple `activeProjects` support** — `list_issues.py` now uses OR logic when
@@ -193,6 +273,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.3.0] — 2026-02-08
 
 ### Added
+
 - **`update_issue.py` bulk update script** — set multiple fields (priority, estimate,
   assignee, state, description, comment) in a single API call instead of separate scripts.
 - **`list_issues.py --active` flag** — returns all non-terminal issues (excludes Done,
@@ -204,12 +285,14 @@ Versioning: [Semantic Versioning](https://semver.org/).
   cached within each script invocation to reduce redundant API calls.
 
 ### Changed
+
 - **`transition.py` optimized** — combined state update and cycle assignment into a
   single `issueUpdate` mutation (was two separate calls for IMPLEMENTING transitions).
 - **Session start efficiency** — single `list_issues.py --active` call replaces
   per-status queries. Issues grouped by status in response.
 
 ### Removed
+
 - **`status_summary.py`** — retired from cloud mechanism. Use `list_issues.py --active`
   and group results by the status field instead.
 
@@ -218,6 +301,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.2.1] — 2026-02-07
 
 ### Fixed
+
 - **Commands not fully populating** — changed from additive `cp` to clear-then-copy
   for `.claude/commands/` and `.cursor/commands/` directories.
 - **`docflow-core.mdc` not cleaned up** — added to deprecated cursor rules list.
@@ -227,6 +311,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
   synced with version file.
 
 ### Added
+
 - **`--force` flag** — force update even when versions match.
 - **Old cursor rule directories and commands** added to deprecated cleanup.
 
@@ -235,6 +320,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.2.0] — 2026-02-06
 
 ### Added
+
 - **Scenario-aware setup command** — `/flydocs-setup` rewritten as a comprehensive
   agent prompt handling three scenarios: New Project, DocFlow Migration, FlyDocs Update.
   Includes proactive repo scanning for PRDs and existing documentation.
@@ -247,10 +333,12 @@ Versioning: [Semantic Versioning](https://semver.org/).
   pre-v1.0 artifacts: old skills, rules, hooks, and cursor rules.
 
 ### Changed
+
 - **Version file synced with manifest** — `.flydocs/version` now matches
   `manifest.json` version field (was out of sync in 0.1.0).
 
 ### Removed
+
 - Orphaned hook scripts: `session-end.py`, `linear-auto-approve.py`
 
 ---
@@ -258,6 +346,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ## [0.1.0] — 2026-01-15
 
 ### Added
+
 - Initial release of FlyDocs Core
 - Workflow skill (`flydocs-workflow`) with full lifecycle stages
 - Mechanism skills: `flydocs-cloud` (Linear API) and `flydocs-local` (file-based)

package/template/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.0-beta.7",
+  "version": "0.5.0-beta.9",
   "description": "FlyDocs Core - Manifest of all managed files",
   "repository": "github.com/plastrlab/flydocs-core",
 
@@ -18,6 +18,7 @@
         ".claude/skills/flydocs-figma",
         ".claude/skills/flydocs-estimates",
         ".claude/skills/flydocs-context-graph",
+        ".claude/skills/flydocs-context7",
         ".flydocs/scripts",
         ".cursor/agents"
       ]
@@ -145,7 +146,8 @@
           "flydocs-local": ["SKILL.md", "cursor-rule.mdc", "scripts/"],
           "flydocs-figma": ["SKILL.md", "references/"],
           "flydocs-estimates": ["SKILL.md", "references/"],
-          "flydocs-context-graph": ["SKILL.md", "schema.md", "scripts/"]
+          "flydocs-context-graph": ["SKILL.md", "schema.md", "scripts/"],
+          "flydocs-context7": ["SKILL.md", "cursor-rule.mdc", "scripts/"]
         }
       },
       ".cursor": {