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

package/template/.flydocs/hooks/prompt-submit.py

@@ -1,277 +0,0 @@
-#!/usr/bin/env python3
-"""
-FlyDocs Hook: prompt-submit.py
-Triggered: When user submits a prompt
-Purpose: Inject context and validate workflow state
-
-Exit codes:
-  0 - Success (plain text output adds context to conversation)
-  2 - Block prompt (stderr shown as reason)
-
-NOTE: Uses plain text output instead of JSON due to Claude Code bug (Issue #13912)
-where JSON output from UserPromptSubmit hooks causes "hook error" despite documentation.
-"""
-
-import json
-import os
-import re
-import subprocess
-import sys
-from pathlib import Path
-
-
-DEBUG_HOOK = os.environ.get('DEBUG_HOOK', '0') == '1'
-SCRIPT_DIR = Path(__file__).parent.resolve()
-DEBUG_LOG = SCRIPT_DIR.parent / 'logs' / 'hook-debug.log'
-
-
-def debug_log(message: str) -> None:
-    """Write debug message to log file if DEBUG_HOOK is enabled."""
-    if not DEBUG_HOOK:
-        return
-    try:
-        DEBUG_LOG.parent.mkdir(parents=True, exist_ok=True)
-        from datetime import datetime
-        timestamp = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
-        with open(DEBUG_LOG, 'a') as f:
-            f.write(f'[{timestamp}] {message}\n')
-    except (OSError, IOError):
-        pass
-
-
-def get_git_context() -> str | None:
-    """Get git branch and uncommitted status."""
-    try:
-        # Check if in git repo
-        result = subprocess.run(
-            ['git', 'rev-parse', '--is-inside-work-tree'],
-            capture_output=True,
-            text=True,
-            timeout=5
-        )
-        if result.returncode != 0:
-            return None
-
-        # Get branch name
-        result = subprocess.run(
-            ['git', 'branch', '--show-current'],
-            capture_output=True,
-            text=True,
-            timeout=5
-        )
-        branch = result.stdout.strip() or 'detached'
-
-        # Check for uncommitted changes
-        uncommitted = 'no'
-        result = subprocess.run(['git', 'diff', '--quiet'], capture_output=True, timeout=5)
-        if result.returncode != 0:
-            uncommitted = 'yes'
-        result = subprocess.run(['git', 'diff', '--cached', '--quiet'], capture_output=True, timeout=5)
-        if result.returncode != 0:
-            uncommitted = 'yes'
-
-        return f'Git: branch={branch}, uncommitted={uncommitted}'
-    except (subprocess.TimeoutExpired, FileNotFoundError, subprocess.SubprocessError):
-        return None
-
-
-def get_issue_context() -> tuple[str | None, str | None]:
-    """Get active issue and status from session files."""
-    focus_file = Path('.flydocs/session/focus.md')
-    status_file = Path('.flydocs/session/status')
-
-    issue_id = None
-    status = None
-
-    if focus_file.exists():
-        try:
-            content = focus_file.read_text()
-            match = re.search(r'[A-Z]+-[0-9]+', content)
-            if match:
-                issue_id = match.group(0)
-        except (OSError, IOError):
-            pass
-
-    if status_file.exists():
-        try:
-            status = status_file.read_text().strip()
-        except (OSError, IOError):
-            pass
-
-    return issue_id, status
-
-
-def get_ac_progress() -> str | None:
-    """Get acceptance criteria progress."""
-    ac_file = Path('.flydocs/session/acceptance-criteria.md')
-    if not ac_file.exists():
-        return None
-
-    try:
-        content = ac_file.read_text()
-        total = len(re.findall(r'^\s*-\s*\[', content, re.MULTILINE))
-        done = len(re.findall(r'^\s*-\s*\[x\]', content, re.MULTILINE | re.IGNORECASE))
-        if total > 0:
-            return f'AC: {done}/{total} complete'
-    except (OSError, IOError):
-        pass
-
-    return None
-
-
-def get_workflow_reminder(status: str) -> str | None:
-    """Get workflow reminder based on current status."""
-    reminders = {
-        'IMPLEMENTING': '[Reminder: Log progress with comments, run tests before REVIEW]',
-        'REVIEW': '[Reminder: Check acceptance criteria before approving]',
-        'TESTING': '[Reminder: Validate all AC met before marking COMPLETE]'
-    }
-    return reminders.get(status)
-
-
-def get_graph_context(issue_id: str | None, branch: str | None) -> str | None:
-    """Get context graph output for the current session."""
-    graph_script = Path('.claude/skills/flydocs-context-graph/scripts/graph_context.py')
-    if not graph_script.exists():
-        return None
-
-    try:
-        cmd = ['python3', str(graph_script)]
-        if issue_id:
-            cmd.extend(['--issue', issue_id])
-        if branch:
-            cmd.extend(['--branch', branch])
-
-        result = subprocess.run(
-            cmd,
-            capture_output=True,
-            text=True,
-            timeout=5
-        )
-        if result.returncode == 0 and result.stdout.strip():
-            return result.stdout.strip()
-    except (subprocess.TimeoutExpired, FileNotFoundError, subprocess.SubprocessError):
-        pass
-
-    return None
-
-
-def get_flydocs_version() -> str | None:
-    """Get FlyDocs version."""
-    version_file = Path('.flydocs/version')
-    if version_file.exists():
-        try:
-            return version_file.read_text().strip()
-        except (OSError, IOError):
-            pass
-    return None
-
-
-def get_setup_nudge() -> str | None:
-    """Check if setup has been completed, return nudge if not."""
-    config_file = Path('.flydocs/config.json')
-    if not config_file.exists():
-        return None
-    try:
-        config = json.loads(config_file.read_text())
-        # Only nudge if field is explicitly set to false (not missing)
-        if 'setupComplete' in config and config['setupComplete'] is False:
-            return '[Setup incomplete — run /flydocs-setup to configure your project]'
-    except (json.JSONDecodeError, OSError, IOError):
-        pass
-    return None
-
-
-def main() -> None:
-    """Main hook execution."""
-    debug_log('=== Hook invoked ===')
-    debug_log(f'PWD: {os.getcwd()}')
-    debug_log(f'SCRIPT_DIR: {SCRIPT_DIR}')
-    debug_log(f'CLAUDE_PROJECT_DIR: {os.environ.get("CLAUDE_PROJECT_DIR", "<not set>")}')
-
-    # Read hook input from stdin
-    try:
-        input_data = json.loads(sys.stdin.read())
-    except (json.JSONDecodeError, ValueError):
-        input_data = {}
-
-    prompt = input_data.get('prompt', '')
-    session_id = input_data.get('session_id', '')
-    cwd = input_data.get('cwd', '')
-
-    debug_log(f'Parsed PROMPT: {prompt[:100]}...' if prompt else 'Parsed PROMPT: <empty>')
-    debug_log(f'Parsed SESSION_ID: {session_id}')
-    debug_log(f'Parsed CWD: {cwd}')
-
-    # Change to working directory
-    debug_log('Attempting to change directory...')
-    if cwd and Path(cwd).is_dir():
-        debug_log(f'Using CWD from input: {cwd}')
-        os.chdir(cwd)
-    elif os.environ.get('CLAUDE_PROJECT_DIR') and Path(os.environ['CLAUDE_PROJECT_DIR']).is_dir():
-        debug_log(f'Using CLAUDE_PROJECT_DIR: {os.environ["CLAUDE_PROJECT_DIR"]}')
-        os.chdir(os.environ['CLAUDE_PROJECT_DIR'])
-    else:
-        debug_log(f'No valid directory to change to, staying in: {os.getcwd()}')
-
-    debug_log(f'Now in directory: {os.getcwd()}')
-
-    # Build context parts
-    context_parts = []
-
-    # Git context
-    git_context = get_git_context()
-    branch = None
-    if git_context:
-        debug_log(f'Git context: {git_context}')
-        context_parts.append(git_context)
-        # Extract branch name for graph context
-        branch_match = re.search(r'branch=(\S+)', git_context)
-        if branch_match:
-            branch = branch_match.group(1).rstrip(',')
-
-    # Issue and status context
-    issue_id, status = get_issue_context()
-    if issue_id:
-        context_parts.append(f'Active issue: {issue_id}')
-    if status:
-        context_parts.append(f'Status: {status}')
-        reminder = get_workflow_reminder(status)
-        if reminder:
-            context_parts.append(reminder)
-
-    # AC progress
-    ac_progress = get_ac_progress()
-    if ac_progress:
-        context_parts.append(ac_progress)
-
-    # Setup completion nudge
-    setup_nudge = get_setup_nudge()
-    if setup_nudge:
-        context_parts.append(setup_nudge)
-
-    # FlyDocs version
-    version = get_flydocs_version()
-    if version:
-        context_parts.append(f'FlyDocs: {version}')
-
-    # Output status line
-    context = ' | '.join(context_parts)
-    debug_log(f'Final CONTEXT: {context}')
-
-    if context:
-        debug_log(f'Outputting plain text context: {context}')
-        print(context)
-
-    # Graph context (appended as separate block below status line)
-    graph_context = get_graph_context(issue_id, branch)
-    if graph_context:
-        debug_log(f'Graph context: {graph_context[:100]}...')
-        print(graph_context)
-
-    debug_log('=== Hook completed successfully ===')
-    sys.exit(0)
-
-
-if __name__ == '__main__':
-    main()