@flydocs/cli 0.5.0-beta.0 → 0.5.0-beta.10

package/template/.flydocs/hooks/prefer-scripts.py

@@ -1,89 +0,0 @@
-#!/usr/bin/env python3
-"""
-PreToolUse Hook: Guide AI to prefer scripts over MCP
-
-Triggers before mcp__linear tool calls and provides guidance
-to use the bundled Python scripts instead.
-
-Soft guidance — doesn't block the MCP call, but reminds the AI
-that scripts exist and are preferred.
-
-Exit codes:
-- 0 with JSON: Continue with guidance message
-- 0 with no output: No opinion, continue normally
-- 2: Block (not used)
-"""
-
-import sys
-import json
-
-
-# Mapping of MCP operations to equivalent mechanism scripts
-SCRIPT_ALTERNATIVES = {
-    "create_issue": "create_issue.py --title '...' --type feature",
-    "update_issue": "transition.py ISSUE_ID STATUS 'comment'",
-    "get_issue": "get_issue.py ISSUE_ID",
-    "list_issues": "list_issues.py --status STATUS",
-    "create_comment": "comment.py ISSUE_ID 'message'",
-    "update_issue_state": "transition.py ISSUE_ID STATUS 'comment'",
-    "list_projects": "list_projects.py --active",
-    "create_project": "create_project.py --name '...'",
-    "list_workflow_states": "list_states.py",
-    "list_labels": "list_labels.py",
-    "assign_issue": "assign.py ISSUE_ID 'email'",
-    "set_issue_priority": "priority.py ISSUE_ID LEVEL",
-    "set_issue_estimate": "estimate.py ISSUE_ID POINTS",
-}
-
-
-def get_script_suggestion(tool_name: str) -> str | None:
-    """Get the equivalent script for an MCP operation."""
-    operation = tool_name.replace("mcp__linear__", "").replace("mcp__linear.", "")
-    return SCRIPT_ALTERNATIVES.get(operation)
-
-
-def main():
-    try:
-        input_data = json.load(sys.stdin)
-    except (json.JSONDecodeError, EOFError):
-        sys.exit(0)
-
-    tool_name = input_data.get('tool_name', '')
-
-    if not tool_name.startswith('mcp__linear'):
-        # No opinion — exit 0 with no output to avoid hook error
-        sys.exit(0)
-
-    script_suggestion = get_script_suggestion(tool_name)
-
-    if script_suggestion:
-        guidance = {
-            "decision": "continue",
-            "message": f"""**Reminder:** FlyDocs prefers Python scripts over MCP for issue operations.
-
-Equivalent script (in the active mechanism skill):
-```bash
-python3 .claude/skills/flydocs-cloud/scripts/{script_suggestion}
-```
-
-Scripts are:
-- Auto-approved (no permission prompt)
-- Config-aware (reads team ID, status mappings)
-- Pattern-enforced (mandatory comments on transitions)
-
-You may continue with MCP if the script doesn't cover your use case."""
-        }
-    else:
-        guidance = {
-            "decision": "continue",
-            "message": """**Reminder:** Check if the active mechanism skill has a script for this operation.
-Read the mechanism skill's SKILL.md for the full script catalog.
-Scripts are preferred over MCP for performance and auto-approval."""
-        }
-
-    print(json.dumps(guidance))
-    sys.exit(0)
-
-
-if __name__ == "__main__":
-    main()