"""Namespaced tool call strings for agent-facing output.

Use these constants in tool output and rules so model instructions stay correct
after namespace consolidation. Avoids hardcoded flat tool names that break when
tools are renamed to log(event=...), scan(target=...), etc.
"""

# Log events (use in instructions / remediation strings)
TOOL_LOG_ESCALATION = 'log(event="escalation", level=..., reason=..., to_agents=...)'
TOOL_LOG_OWNERSHIP = 'log(event="ownership", to_owner=..., reason=...)'
TOOL_LOG_REPLAN = 'log(event="replan", trigger=..., impact=...)'
TOOL_LOG_DEBT = 'log(event="debt", debt_type=..., severity=..., location=...)'
TOOL_LOG_PHASE = 'log(event="phase", phase=..., outcome=..., next_phase=...)'
TOOL_LOG_ARTIFACT = 'log(event="artifact", story_id=..., artifact=...)'

# Scan targets (directory/files/file_path as needed)
TOOL_SCAN_HEALTH = 'scan(target="health", directory="{directory}")'
TOOL_SCAN_DEBT = 'scan(target="debt", directory="{directory}", summary=...)'
TOOL_SCAN_DEAD_CODE = 'scan(target="dead_code", directory="{directory}", summary=...)'
TOOL_SCAN_COMPLEXITY = 'scan(target="complexity", files=...)'
TOOL_SCAN_EXTERNAL = 'scan(target="external", directory="{directory}")'
TOOL_SCAN_REGRESSION = 'scan(target="regression", files=...)'
TOOL_SCAN_COMPLIANCE = 'scan(target="compliance", file_path=...)'
TOOL_SCAN_DOCS = 'scan(target="docs", directory="{directory}")'
TOOL_SCAN_AI_PATTERNS = 'scan(target="ai_patterns", file_path=...)'
TOOL_SCAN_SECURITY = 'scan(target="security", directory="{directory}")'
TOOL_SCAN_CODE_QUALITY = 'scan(target="code_quality", directory="{directory}")'

# Workflow (use in tool output / rules)
TOOL_WORKFLOW_INIT = 'workflow(action="init", story_id=..., epic_id=...)'
TOOL_WORKFLOW_PARALLEL_START = 'workflow(action="parallel_start", story_id="{story_id}")'
TOOL_AGENT_ACTIVATE = 'agent(action="activate", name="{name}")'
TOOL_CONTEXT_GRAPH_EMPTY_HINT = 'scan(target="health", directory=...)'
