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

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

@@ -1,43 +0,0 @@
----
-description: File-based issue management — local mechanism for FlyDocs
-alwaysApply: true
----
-
-<!-- Condensed from SKILL.md — update both when changing patterns -->
-
-# FlyDocs Local Mechanism
-
-Issues stored as markdown files with YAML frontmatter. No accounts, no API keys, no network.
-
-## Script Contract
-
-All scripts: `python3 .claude/skills/flydocs-local/scripts/<script>`
-
-| Script | Key Arguments |
-|--------|---------------|
-| `create_issue.py` | `--title "..." --type feature [--priority 0-4] [--estimate 1-5] [--assignee STR] [--triage]` |
-| `transition.py` | `<ref> <STATUS> "<comment>"` |
-| `comment.py` | `<ref> "<comment>"` |
-| `list_issues.py` | `[--status STATUS] [--mine] [--limit N]` |
-| `get_issue.py` | `<ref>` |
-| `assign.py` | `<ref> <assignee>` |
-| `update_description.py` | `<ref> --text "..." \| --file PATH` |
-| `status_summary.py` | `[--project ID]` |
-
-## Status Values
-
-`BACKLOG`, `READY`, `IMPLEMENTING`, `BLOCKED`, `REVIEW`, `TESTING`, `COMPLETE`, `ARCHIVED`, `CANCELED`, `DUPLICATE`
-
-## Storage Layout
-
-```
-flydocs/issues/
-  backlog/        implementing/     review/
-  ready/          testing/          done/
-```
-
-Issues: `FD-XXX-slug.md` with YAML frontmatter. IDs auto-increment via `.flydocs/issues/.counter`.
-
-## Error Handling
-
-Exit 0 = success (JSON on stdout). Exit 1 = error (message on stderr).

package/template/.claude/skills/flydocs-local/scripts/assign.py

@@ -1,20 +0,0 @@
-#!/usr/bin/env python3
-"""Assign an issue to a person."""
-
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import assign_issue
-
-if len(sys.argv) < 3:
-    print("Usage: assign.py <ref> <assignee>", file=sys.stderr)
-    sys.exit(1)
-
-try:
-    result = assign_issue(sys.argv[1], sys.argv[2])
-    print(json.dumps(result))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/comment.py

@@ -1,27 +0,0 @@
-#!/usr/bin/env python3
-"""Add a comment to an issue."""
-
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import add_comment
-
-if len(sys.argv) < 2:
-    print("Usage: comment.py <ref> [<comment>]  (or pipe via stdin)", file=sys.stderr)
-    sys.exit(1)
-
-try:
-    ref = sys.argv[1]
-    body = sys.argv[2] if len(sys.argv) > 2 else ""
-    if not body and not sys.stdin.isatty():
-        body = sys.stdin.read().strip()
-    if not body:
-        print("Provide comment as argument or pipe via stdin", file=sys.stderr)
-        sys.exit(1)
-    result = add_comment(ref, body)
-    print(json.dumps(result))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/create_issue.py

@@ -1,44 +0,0 @@
-#!/usr/bin/env python3
-"""Create a new local issue."""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import create_issue, ISSUE_TYPES
-
-parser = argparse.ArgumentParser(description="Create a new issue")
-parser.add_argument("--title", required=True)
-parser.add_argument("--type", required=True, choices=sorted(ISSUE_TYPES), dest="issue_type")
-parser.add_argument("--description", default="")
-parser.add_argument("--description-file", default="", dest="description_file")
-parser.add_argument("--priority", type=int, default=3, choices=range(5))
-parser.add_argument("--estimate", type=int, default=0, choices=range(6))
-parser.add_argument("--assignee", default="")
-parser.add_argument("--triage", action="store_true")
-
-try:
-    args = parser.parse_args()
-
-    # Resolve description: --description-file > stdin > --description
-    description = args.description
-    if args.description_file:
-        description = Path(args.description_file).read_text()
-    elif not description and not sys.stdin.isatty():
-        description = sys.stdin.read().strip()
-
-    result = create_issue(
-        title=args.title,
-        issue_type=args.issue_type,
-        description=description,
-        priority=args.priority,
-        estimate=args.estimate,
-        assignee=args.assignee,
-        triage=args.triage,
-    )
-    print(json.dumps(result))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/estimate.py

@@ -1,37 +0,0 @@
-#!/usr/bin/env python3
-"""Set estimate on an issue."""
-
-import json
-import sys
-from datetime import datetime
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import _find_issue, _parse_issue, _write_issue
-
-if len(sys.argv) < 3:
-    print("Usage: estimate.py <ref> <1-5>", file=sys.stderr)
-    sys.exit(1)
-
-ref = sys.argv[1]
-try:
-    estimate = int(sys.argv[2])
-    if estimate < 1 or estimate > 5:
-        raise ValueError
-except ValueError:
-    print("Estimate must be a number (1-5)", file=sys.stderr)
-    sys.exit(1)
-
-try:
-    filepath = _find_issue(ref)
-    data = _parse_issue(filepath)
-    data["estimate"] = estimate
-    data["updated"] = datetime.now().strftime("%Y-%m-%d")
-
-    fm = {k: v for k, v in data.items() if k not in ("description", "comments", "_path")}
-    _write_issue(filepath, fm, data["description"], data["comments"])
-
-    print(json.dumps({"success": True, "issue": ref, "estimate": estimate}))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/get_issue.py

@@ -1,20 +0,0 @@
-#!/usr/bin/env python3
-"""Get full details for an issue."""
-
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_issue
-
-if len(sys.argv) < 2:
-    print("Usage: get_issue.py <ref>", file=sys.stderr)
-    sys.exit(1)
-
-try:
-    result = get_issue(sys.argv[1])
-    print(json.dumps(result))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/link.py

@@ -1,41 +0,0 @@
-#!/usr/bin/env python3
-"""Create a relationship between two issues."""
-
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import _find_issue, add_comment
-
-LINK_TYPES = {"blocks", "related", "duplicate"}
-
-if len(sys.argv) < 4:
-    print(f"Usage: link.py <ref> <related_ref> <type>\nTypes: {', '.join(sorted(LINK_TYPES))}", file=sys.stderr)
-    sys.exit(1)
-
-ref, related_ref, link_type = sys.argv[1], sys.argv[2], sys.argv[3].lower()
-if link_type not in LINK_TYPES:
-    print(f"Invalid type: {link_type}. Valid: {', '.join(sorted(LINK_TYPES))}", file=sys.stderr)
-    sys.exit(1)
-
-try:
-    # Verify both issues exist
-    _find_issue(ref)
-    _find_issue(related_ref)
-
-    # Record the link as comments on both issues
-    if link_type == "blocks":
-        add_comment(ref, f"**Link**: blocks {related_ref}")
-        add_comment(related_ref, f"**Link**: blocked by {ref}")
-    elif link_type == "duplicate":
-        add_comment(ref, f"**Link**: duplicate of {related_ref}")
-        add_comment(related_ref, f"**Link**: duplicate of {ref}")
-    else:
-        add_comment(ref, f"**Link**: related to {related_ref}")
-        add_comment(related_ref, f"**Link**: related to {ref}")
-
-    print(json.dumps({"success": True, "type": link_type}))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/list_issues.py

@@ -1,34 +0,0 @@
-#!/usr/bin/env python3
-"""List issues with optional filters."""
-
-import argparse
-import json
-import os
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import list_issues
-
-TERMINAL_STATUSES = {"COMPLETE", "ARCHIVED", "CANCELED", "DUPLICATE"}
-
-parser = argparse.ArgumentParser(description="List issues")
-parser.add_argument("--status", default="")
-parser.add_argument("--active", action="store_true",
-                    help="All non-terminal states (excludes Done, Archived, Canceled, Duplicate)")
-parser.add_argument("--assignee", default="")
-parser.add_argument("--mine", action="store_true")
-parser.add_argument("--limit", type=int, default=50)
-
-try:
-    args = parser.parse_args()
-    assignee = args.assignee
-    if args.mine:
-        assignee = os.environ.get("USER", os.environ.get("USERNAME", ""))
-    result = list_issues(status=args.status.upper() if args.status else "", assignee=assignee, limit=args.limit)
-    if args.active:
-        result = [r for r in result if r.get("status") not in TERMINAL_STATUSES]
-    print(json.dumps(result))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/priority.py

@@ -1,37 +0,0 @@
-#!/usr/bin/env python3
-"""Set priority on an issue."""
-
-import json
-import sys
-from datetime import datetime
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import _find_issue, _parse_issue, _write_issue
-
-if len(sys.argv) < 3:
-    print("Usage: priority.py <ref> <0-4>", file=sys.stderr)
-    sys.exit(1)
-
-ref = sys.argv[1]
-try:
-    priority = int(sys.argv[2])
-    if priority < 0 or priority > 4:
-        raise ValueError
-except ValueError:
-    print("Priority must be a number (0-4)", file=sys.stderr)
-    sys.exit(1)
-
-try:
-    filepath = _find_issue(ref)
-    data = _parse_issue(filepath)
-    data["priority"] = priority
-    data["updated"] = datetime.now().strftime("%Y-%m-%d")
-
-    fm = {k: v for k, v in data.items() if k not in ("description", "comments", "_path")}
-    _write_issue(filepath, fm, data["description"], data["comments"])
-
-    print(json.dumps({"success": True, "issue": ref, "priority": priority}))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/project_update.py

@@ -1,67 +0,0 @@
-#!/usr/bin/env python3
-"""Post a project health update (local: saves to flydocs/updates/)."""
-
-import argparse
-import json
-import sys
-from datetime import datetime
-from pathlib import Path
-
-HEALTH_VALUES = {"onTrack", "atRisk", "offTrack"}
-
-parser = argparse.ArgumentParser(description="Post project update")
-parser.add_argument("--health", required=True, choices=sorted(HEALTH_VALUES))
-parser.add_argument("--body", default="")
-parser.add_argument("--body-file", default="")
-parser.add_argument("--project", default=None)
-
-try:
-    args = parser.parse_args()
-
-    body = args.body
-    if args.body_file:
-        p = Path(args.body_file)
-        if not p.exists():
-            print(f"File not found: {args.body_file}", file=sys.stderr)
-            sys.exit(1)
-        body = p.read_text().strip()
-    if not body and not sys.stdin.isatty():
-        body = sys.stdin.read().strip()
-    if not body:
-        print("Provide --body, --body-file, or pipe via stdin", file=sys.stderr)
-        sys.exit(1)
-
-    # Find project root
-    cwd = Path.cwd()
-    root = None
-    for parent in [cwd, *cwd.parents]:
-        if (parent / ".flydocs" / "config.json").exists():
-            root = parent
-            break
-    if not root:
-        print("Not in a FlyDocs project", file=sys.stderr)
-        sys.exit(1)
-
-    # Save update to flydocs/updates/
-    updates_dir = root / "flydocs" / "updates"
-    updates_dir.mkdir(parents=True, exist_ok=True)
-
-    now = datetime.now()
-    update_id = now.strftime("%Y%m%d-%H%M%S")
-    filename = f"{update_id}.md"
-
-    content = f"""---
-health: {args.health}
-date: {now.strftime("%Y-%m-%d")}
-time: {now.strftime("%H:%M")}
----
-
-{body}
-"""
-
-    (updates_dir / filename).write_text(content)
-
-    print(json.dumps({"success": True, "id": update_id}))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/status_summary.py

@@ -1,16 +0,0 @@
-#!/usr/bin/env python3
-"""Show project status summary (issue counts by status)."""
-
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import status_summary
-
-try:
-    result = status_summary()
-    print(json.dumps(result))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/transition.py

@@ -1,24 +0,0 @@
-#!/usr/bin/env python3
-"""Transition an issue to a new status."""
-
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import transition, STATUSES
-
-if len(sys.argv) < 4:
-    print("Usage: transition.py <ref> <STATUS> <comment>", file=sys.stderr)
-    sys.exit(1)
-
-try:
-    ref, status, comment = sys.argv[1], sys.argv[2].upper(), sys.argv[3]
-    if status not in STATUSES:
-        print(f"Invalid status: {status}. Valid: {', '.join(sorted(STATUSES.keys()))}", file=sys.stderr)
-        sys.exit(1)
-    result = transition(ref, status, comment)
-    print(json.dumps(result))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

package/template/.claude/skills/flydocs-local/scripts/update_description.py

@@ -1,35 +0,0 @@
-#!/usr/bin/env python3
-"""Update an issue's description."""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import update_description
-
-parser = argparse.ArgumentParser(description="Update issue description")
-parser.add_argument("ref")
-parser.add_argument("--text", default="")
-parser.add_argument("--file", default="", dest="filepath")
-
-try:
-    args = parser.parse_args()
-    text = args.text
-    if args.filepath:
-        try:
-            text = Path(args.filepath).read_text()
-        except FileNotFoundError:
-            print(f"File not found: {args.filepath}", file=sys.stderr)
-            sys.exit(1)
-    if not text and not sys.stdin.isatty():
-        text = sys.stdin.read().strip()
-    if not text:
-        print("Provide --text, --file, or pipe via stdin", file=sys.stderr)
-        sys.exit(1)
-    result = update_description(args.ref, text)
-    print(json.dumps(result))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

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

@@ -1,84 +0,0 @@
-#!/usr/bin/env python3
-"""Bulk update an issue — set multiple fields in a single operation."""
-
-import argparse
-import json
-import sys
-from datetime import datetime
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import _find_issue, _parse_issue, _write_issue, add_comment
-from flydocs_api import transition as do_transition
-
-parser = argparse.ArgumentParser(description="Update issue fields")
-parser.add_argument("ref", help="Issue reference (e.g., FD-001)")
-parser.add_argument("--title", default=None)
-parser.add_argument("--priority", type=int, choices=range(5), default=None)
-parser.add_argument("--estimate", type=int, choices=range(1, 6), default=None)
-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("--comment", default=None)
-
-try:
-    args = parser.parse_args()
-
-    updated_fields = []
-
-    # Handle state transition first (moves the file between directories)
-    if args.state:
-        do_transition(args.ref, args.state.upper(), f"Status changed to {args.state.upper()}")
-        updated_fields.append("state")
-
-    # Handle comment next (appends to file via add_comment)
-    if args.comment:
-        add_comment(args.ref, args.comment)
-        updated_fields.append("comment")
-
-    # Now read the current state of the file (after any transition/comment writes)
-    filepath = _find_issue(args.ref)
-    data = _parse_issue(filepath)
-
-    if args.title is not None:
-        data["title"] = args.title
-        updated_fields.append("title")
-
-    if args.priority is not None:
-        data["priority"] = args.priority
-        updated_fields.append("priority")
-
-    if args.estimate is not None:
-        data["estimate"] = args.estimate
-        updated_fields.append("estimate")
-
-    if args.assignee is not None:
-        data["assignee"] = args.assignee
-        updated_fields.append("assignee")
-
-    description = data.get("description", "")
-    if args.description_file is not None:
-        p = Path(args.description_file)
-        if not p.exists():
-            print(f"File not found: {args.description_file}", file=sys.stderr)
-            sys.exit(1)
-        description = p.read_text()
-        updated_fields.append("description")
-    elif args.description is not None:
-        description = args.description
-        updated_fields.append("description")
-
-    if not updated_fields:
-        print("No fields to update. Use --title, --priority, --estimate, --assignee, --state, --description, or --comment", file=sys.stderr)
-        sys.exit(1)
-
-    # Write updated issue
-    data["updated"] = datetime.now().strftime("%Y-%m-%d")
-    fm = {k: v for k, v in data.items() if k not in ("description", "comments", "_path")}
-    _write_issue(filepath, fm, description, data["comments"])
-
-    print(json.dumps({"success": True, "issue": args.ref, "updated": updated_fields}))
-except Exception as e:
-    print(str(e), file=sys.stderr)
-    sys.exit(1)

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

@@ -1,71 +0,0 @@
-#!/usr/bin/env python3
-"""
-PreToolUse Hook: Auto-approve FlyDocs mechanism and workflow scripts
-
-Auto-approves Bash commands that execute scripts in any FlyDocs skill:
-- .claude/skills/flydocs-local/scripts/
-- .claude/skills/flydocs-cloud/scripts/
-- .claude/skills/flydocs-workflow/scripts/
-
-Exit codes:
-- 0 with JSON: Approved (decision in output)
-- 0 with no output: No opinion, continue normally
-- 2: Block (stderr shown to AI)
-"""
-
-import sys
-import json
-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|context7)/scripts/\w+\.py'
-)
-
-
-def should_approve(command: str) -> bool:
-    """Check if command executes a FlyDocs skill script."""
-    return bool(APPROVED_PATTERN.search(command))
-
-
-def get_script_info(command: str) -> tuple[str, str]:
-    """Extract skill name and script name from command."""
-    match = re.search(
-        r'\.claude/skills/(flydocs-\w+)/scripts/(\w+\.py)', command
-    )
-    if match:
-        return match.group(1), match.group(2)
-    return "unknown", "unknown"
-
-
-def main():
-    try:
-        input_data = json.load(sys.stdin)
-    except (json.JSONDecodeError, EOFError):
-        sys.exit(0)
-
-    tool_name = input_data.get('tool_name', '')
-    tool_input = input_data.get('tool_input', {})
-
-    if tool_name != 'Bash':
-        sys.exit(0)
-
-    command = tool_input.get('command', '')
-
-    if should_approve(command):
-        skill, script = get_script_info(command)
-        result = {
-            "decision": "approve",
-            "reason": f"Auto-approved FlyDocs script: {skill}/{script}"
-        }
-        print(json.dumps(result))
-        sys.exit(0)
-    else:
-        # No opinion — exit 0 with no output to avoid hook error
-        sys.exit(0)
-
-
-if __name__ == "__main__":
-    main()