gobby 0.2.5__py3-none-any.whl → 0.2.7__py3-none-any.whl

gobby/config/features.py

@@ -42,45 +42,22 @@ class ToolSummarizerConfig(BaseModel):
         default="claude-haiku-4-5",
         description="Model to use for summarization (fast/cheap recommended)",
     )
-    prompt: str = Field(
-        default="""Summarize this MCP tool description in 180 characters or less.
-Keep it to three sentences or less. Be concise and preserve the key functionality.
-Do not add quotes, extra formatting, or code examples.
 
-Description: {description}
-
-Summary:""",
-        description="DEPRECATED: Use prompt_path instead. Prompt template for tool description summarization",
-    )
     prompt_path: str | None = Field(
         default=None,
         description="Path to custom tool summary prompt template (e.g., 'features/tool_summary')",
     )
-    system_prompt: str = Field(
-        default="You are a technical summarizer. Create concise tool descriptions.",
-        description="DEPRECATED: Use system_prompt_path instead. System prompt for tool description summarization",
-    )
+
     system_prompt_path: str | None = Field(
         default=None,
         description="Path to custom tool summary system prompt (e.g., 'features/tool_summary_system')",
     )
-    server_description_prompt: str = Field(
-        default="""Write a single concise sentence describing what the '{server_name}' MCP server does based on its tools.
 
-Tools:
-{tools_list}
-
-Description (1 sentence, try to keep under 100 characters):""",
-        description="DEPRECATED: Use server_description_prompt_path instead. Prompt template for server description generation",
-    )
     server_description_prompt_path: str | None = Field(
         default=None,
         description="Path to custom server description prompt (e.g., 'features/server_description')",
     )
-    server_description_system_prompt: str = Field(
-        default="You write concise technical descriptions.",
-        description="DEPRECATED: Use server_description_system_prompt_path instead. System prompt for server description generation",
-    )
+
     server_description_system_prompt_path: str | None = Field(
         default=None,
         description="Path to custom server description system prompt (e.g., 'features/server_description_system')",
@@ -110,26 +87,12 @@ class TaskDescriptionConfig(BaseModel):
         default=50,
         description="Minimum length of structured extraction before LLM fallback triggers",
     )
-    prompt: str = Field(
-        default="""Generate a concise task description for this task from a spec document.
-
-Task title: {task_title}
-Section: {section_title}
-Section content: {section_content}
-Existing context: {existing_context}
 
-Write a 1-2 sentence description focusing on the goal and deliverable.
-Do not add quotes, extra formatting, or implementation details.""",
-        description="DEPRECATED: Use prompt_path instead. Prompt template for task description generation",
-    )
     prompt_path: str | None = Field(
         default=None,
         description="Path to custom task description prompt (e.g., 'features/task_description')",
     )
-    system_prompt: str = Field(
-        default="You are a technical writer creating concise task descriptions for developers.",
-        description="DEPRECATED: Use system_prompt_path instead. System prompt for task description generation",
-    )
+
     system_prompt_path: str | None = Field(
         default=None,
         description="Path to custom task description system prompt (e.g., 'features/task_description_system')",
@@ -159,83 +122,17 @@ class RecommendToolsConfig(BaseModel):
         default="claude-sonnet-4-5",
         description="Model to use for tool recommendations",
     )
-    prompt: str = Field(
-        default="""You are a tool recommendation assistant for Claude Code with access to MCP servers.
-
-CRITICAL PRIORITIZATION RULES:
-1. Analyze the task type (code navigation, docs lookup, database query, planning, data processing, etc.)
-2. Check available MCP server DESCRIPTIONS for capability matches
-3. If ANY MCP server's description matches the task type -> recommend those tools FIRST
-4. Only recommend built-in Claude Code tools (Grep, Read, Bash, WebSearch) if NO suitable MCP server exists
-
-TASK TYPE MATCHING GUIDELINES:
-- Task needs library/framework documentation -> Look for MCP servers describing "documentation", "library docs", "API reference"
-- Task needs code navigation/architecture understanding -> Look for MCP servers describing "code analysis", "symbols", "semantic search"
-- Task needs database operations -> Look for MCP servers describing "database", "PostgreSQL", "SQL"
-- Task needs complex reasoning/planning -> Look for MCP servers describing "problem-solving", "thinking", "reasoning"
-- Task needs data processing/large datasets -> Look for MCP servers describing "code execution", "data processing", "token optimization"
-
-ANTI-PATTERNS (What NOT to recommend):
-- Don't recommend WebSearch when an MCP server provides library/framework documentation
-- Don't recommend Grep/Read for code architecture questions when an MCP server does semantic code analysis
-- Don't recommend Bash for database queries when an MCP server provides database tools
-- Don't recommend direct implementation when an MCP server provides structured reasoning
-
-OUTPUT FORMAT:
-Be concise and specific. Recommend 1-3 tools maximum with:
-1. Which MCP server and tools to use (if applicable)
-2. Brief rationale based on server description matching task type
-3. Suggested workflow (e.g., "First call X, then use result with Y")
-4. Only mention built-in tools if no MCP server is suitable""",
-        description="DEPRECATED: Use prompt_path instead. System prompt for recommend_tools() MCP tool.",
-    )
+
     prompt_path: str | None = Field(
         default=None,
         description="Path to custom recommend tools system prompt (e.g., 'features/recommend_tools')",
     )
-    hybrid_rerank_prompt: str = Field(
-        default="""You are an expert at selecting tools for tasks.
-Task: {task_description}
-
-Candidate tools (ranked by semantic similarity):
-{candidate_list}
-
-Re-rank these tools by relevance to the task and provide reasoning.
-Return the top {top_k} most relevant as JSON:
-{{
-  "recommendations": [
-    {{
-      "server": "server_name",
-      "tool": "tool_name",
-      "reason": "Why this tool is the best choice"
-    }}
-  ]
-}}""",
-        description="DEPRECATED: Use hybrid_rerank_prompt_path instead. Prompt template for hybrid mode re-ranking",
-    )
+
     hybrid_rerank_prompt_path: str | None = Field(
         default=None,
         description="Path to custom hybrid re-rank prompt (e.g., 'features/recommend_tools_hybrid')",
     )
-    llm_prompt: str = Field(
-        default="""You are an expert at selecting the right tools for a given task.
-Task: {task_description}
-
-Available Servers: {available_servers}
-
-Please recommend which tools from these servers would be most useful for this task.
-Return a JSON object with this structure:
-{{
-  "recommendations": [
-    {{
-      "server": "server_name",
-      "tool": "tool_name",
-      "reason": "Why this tool is useful"
-    }}
-  ]
-}}""",
-        description="DEPRECATED: Use llm_prompt_path instead. Prompt template for LLM mode recommendations",
-    )
+
     llm_prompt_path: str | None = Field(
         default=None,
         description="Path to custom LLM recommendation prompt (e.g., 'features/recommend_tools_llm')",
@@ -276,37 +173,17 @@ class ImportMCPServerConfig(BaseModel):
         default="claude-haiku-4-5",
         description="Model to use for config extraction",
     )
-    prompt: str = Field(
-        default=DEFAULT_IMPORT_MCP_SERVER_PROMPT,
-        description="DEPRECATED: Use prompt_path instead. System prompt for MCP server config extraction",
-    )
+
     prompt_path: str | None = Field(
         default=None,
         description="Path to custom import MCP system prompt (e.g., 'features/import_mcp')",
     )
-    github_fetch_prompt: str = Field(
-        default="""Fetch the README from this GitHub repository and extract MCP server configuration:
-
-{github_url}
-
-If the URL doesn't point directly to a README, try to find and fetch the README.md file.
 
-After reading the documentation, extract the MCP server configuration as a JSON object.""",
-        description="DEPRECATED: Use github_fetch_prompt_path instead. User prompt template for GitHub import",
-    )
     github_fetch_prompt_path: str | None = Field(
         default=None,
         description="Path to custom GitHub fetch prompt (e.g., 'features/import_mcp_github')",
     )
-    search_fetch_prompt: str = Field(
-        default="""Search for MCP server: {search_query}
-
-Find the official documentation or GitHub repository for this MCP server.
-Then fetch and read the README or installation docs.
 
-After reading the documentation, extract the MCP server configuration as a JSON object.""",
-        description="DEPRECATED: Use search_fetch_prompt_path instead. User prompt template for search-based import",
-    )
     search_fetch_prompt_path: str | None = Field(
         default=None,
         description="Path to custom search fetch prompt (e.g., 'features/import_mcp_search')",

gobby/config/search.py

@@ -0,0 +1,110 @@
+"""Search configuration for Gobby daemon.
+
+Provides configuration for the unified search layer with embedding
+support and TF-IDF fallback.
+
+Example usage in config.yaml:
+    search:
+      mode: auto  # tfidf, embedding, auto, hybrid
+      embedding_model: text-embedding-3-small
+      tfidf_weight: 0.4
+      embedding_weight: 0.6
+      notify_on_fallback: true
+
+For Ollama (local embeddings):
+    search:
+      mode: auto
+      embedding_model: openai/nomic-embed-text
+      embedding_api_base: http://localhost:11434/v1
+"""
+
+from pydantic import BaseModel, Field
+
+from gobby.search.models import SearchMode
+
+
+class SearchConfig(BaseModel):
+    """Configuration for unified search with fallback.
+
+    This config controls how UnifiedSearcher behaves, including:
+    - Which search mode to use (tfidf, embedding, auto, hybrid)
+    - Which embedding model to use (LiteLLM format)
+    - Weights for hybrid mode
+    - Whether to notify on fallback
+
+    Supported modes:
+    - tfidf: TF-IDF only (always works, no API needed)
+    - embedding: Embedding-based search only (fails if unavailable)
+    - auto: Try embedding, fallback to TF-IDF if unavailable
+    - hybrid: Combine both with weighted scores
+
+    LiteLLM model format examples:
+    - OpenAI: text-embedding-3-small (needs OPENAI_API_KEY)
+    - Ollama: openai/nomic-embed-text (with embedding_api_base)
+    - Azure: azure/azure-embedding-model
+    - Vertex AI: vertex_ai/text-embedding-004
+    - Gemini: gemini/text-embedding-004 (needs GEMINI_API_KEY)
+    - Mistral: mistral/mistral-embed (needs MISTRAL_API_KEY)
+    """
+
+    mode: str = Field(
+        default="auto",
+        description="Search mode: tfidf, embedding, auto, hybrid",
+    )
+    embedding_model: str = Field(
+        default="text-embedding-3-small",
+        description="LiteLLM model string (e.g., text-embedding-3-small, openai/nomic-embed-text)",
+    )
+    embedding_api_base: str | None = Field(
+        default=None,
+        description="API base URL for Ollama/custom endpoints (e.g., http://localhost:11434/v1)",
+    )
+    embedding_api_key: str | None = Field(
+        default=None,
+        description="API key for embedding provider (uses env var if not set)",
+    )
+    tfidf_weight: float = Field(
+        default=0.4,
+        ge=0.0,
+        le=1.0,
+        description="Weight for TF-IDF scores in hybrid mode",
+    )
+    embedding_weight: float = Field(
+        default=0.6,
+        ge=0.0,
+        le=1.0,
+        description="Weight for embedding scores in hybrid mode",
+    )
+    notify_on_fallback: bool = Field(
+        default=True,
+        description="Log warning when falling back to TF-IDF",
+    )
+
+    def get_normalized_weights(self) -> tuple[float, float]:
+        """Get normalized weights that sum to 1.0.
+
+        Returns:
+            Tuple of (tfidf_weight, embedding_weight) normalized to sum to 1.0
+        """
+        total = self.tfidf_weight + self.embedding_weight
+        if total == 0:
+            # Default to equal weights if both are 0
+            return (0.5, 0.5)
+        return (self.tfidf_weight / total, self.embedding_weight / total)
+
+    def get_mode_enum(self) -> SearchMode:
+        """Get the SearchMode enum instance for the configured mode.
+
+        Returns:
+            SearchMode enum corresponding to the mode string value
+
+        Raises:
+            ValueError: If the configured mode is not a valid SearchMode
+        """
+        try:
+            return SearchMode(self.mode)
+        except ValueError as e:
+            valid_modes = [m.value for m in SearchMode]
+            raise ValueError(
+                f"Invalid search mode '{self.mode}'. Valid modes are: {', '.join(valid_modes)}"
+            ) from e

gobby/config/servers.py

@@ -23,7 +23,7 @@ class WebSocketSettings(BaseModel):
         description="Enable WebSocket server for real-time communication",
     )
     port: int = Field(
-        default=8766,
+        default=60888,
         description="Port for WebSocket server to listen on",
     )
     ping_interval: int = Field(

gobby/config/skills.py

@@ -0,0 +1,43 @@
+"""
+Skills configuration for Gobby daemon.
+
+Provides configuration for skill injection and discovery.
+"""
+
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic import BaseModel, Field, field_validator
+
+
+class SkillsConfig(BaseModel):
+    """
+    Configuration for skill injection and discovery.
+
+    Controls whether and how skills are injected into session context.
+    """
+
+    inject_core_skills: bool = Field(
+        default=True,
+        description="Whether to inject core skills into session context",
+    )
+
+    core_skills_path: str | None = Field(
+        default=None,
+        description="Override path for core skills (default: install/shared/skills/)",
+    )
+
+    injection_format: Literal["summary", "full", "none"] = Field(
+        default="summary",
+        description="Format for skill injection: 'summary' (names only), 'full' (with content), 'none' (disabled)",
+    )
+
+    @field_validator("injection_format")
+    @classmethod
+    def validate_injection_format(cls, v: str) -> str:
+        """Validate injection_format is one of the allowed values."""
+        allowed = {"summary", "full", "none"}
+        if v not in allowed:
+            raise ValueError(f"injection_format must be one of {allowed}, got '{v}'")
+        return v

gobby/config/tasks.py

@@ -38,14 +38,6 @@ class CompactHandoffConfig(BaseModel):
         default=True,
         description="Enable compact handoff context extraction and injection",
     )
-    # DEPRECATED: prompt field is no longer used.
-    # Template is now defined in session-handoff.yaml workflow file.
-    # Kept for backwards compatibility but will be removed in a future version.
-    prompt: str | None = Field(
-        default=None,
-        description="DEPRECATED: Template moved to session-handoff.yaml workflow. "
-        "This field is ignored.",
-    )
 
 
 class PatternCriteriaConfig(BaseModel):
@@ -147,10 +139,7 @@ class TaskExpansionConfig(BaseModel):
         default="claude-opus-4-5",
         description="Model to use for expansion",
     )
-    prompt: str | None = Field(
-        default=None,
-        description="DEPRECATED: Use prompt_path instead. Custom prompt template for task expansion",
-    )
+
     prompt_path: str | None = Field(
         default=None,
         description="Path to custom user prompt template (e.g., 'expansion/user')",
@@ -175,22 +164,11 @@ class TaskExpansionConfig(BaseModel):
         default="You are a senior developer researching a codebase. Use tools to find relevant code.",
         description="System prompt for the research agent",
     )
-    system_prompt: str | None = Field(
-        default=None,
-        description="DEPRECATED: Use system_prompt_path instead. Custom system prompt for task expansion",
-    )
-    tdd_prompt: str | None = Field(
-        default=None,
-        description="DEPRECATED: TDD mode is now integrated into the system prompt template via Jinja2 conditionals",
-    )
+
     web_research_enabled: bool = Field(
         default=True,
         description="Enable web research for task expansion using MCP tools",
     )
-    tdd_mode: bool = Field(
-        default=True,
-        description="Enable TDD mode: create test->implement task pairs with appropriate blocking for coding tasks",
-    )
     max_subtasks: int = Field(
         default=15,
         description="Maximum number of subtasks to create per expansion",
@@ -232,10 +210,7 @@ class TaskValidationConfig(BaseModel):
         default="You are a QA validator. Output ONLY valid JSON. No markdown, no explanation, no code blocks. Just the raw JSON object.",
         description="System prompt for task validation",
     )
-    prompt: str | None = Field(
-        default=None,
-        description="DEPRECATED: Use prompt_path instead. Custom prompt template for task validation",
-    )
+
     prompt_path: str | None = Field(
         default=None,
         description="Path to custom validation prompt template (e.g., 'validation/validate')",
@@ -264,10 +239,7 @@ class TaskValidationConfig(BaseModel):
         default="You are a QA engineer writing acceptance criteria. CRITICAL: Only include requirements explicitly stated in the task. Do NOT invent specific values, thresholds, timeouts, or edge cases that aren't mentioned. Vague tasks get vague criteria. Use markdown checkboxes.",
         description="System prompt for generating validation criteria",
     )
-    criteria_prompt: str | None = Field(
-        default=None,
-        description="DEPRECATED: Use criteria_prompt_path instead. Custom prompt template for generating validation criteria",
-    )
+
     # Validation loop control
     max_iterations: int = Field(
         default=10,
@@ -724,10 +696,6 @@ class WorkflowVariablesConfig(BaseModel):
         default=False,
         description="Require an active task (in_progress) before allowing file edits",
     )
-    tdd_mode: bool = Field(
-        default=True,
-        description="Enable TDD mode for task expansion (test-implementation pairs)",
-    )
     session_task: str | list[str] | None = Field(
         default=None,
         description="Task(s) to complete before stopping. "
@@ -759,13 +727,13 @@ def merge_workflow_variables(
         ValidationError: If validate=True and merged values fail validation.
 
     Example:
-        >>> yaml_defaults = {"tdd_mode": True, "require_task_before_edit": False}
-        >>> db_overrides = {"tdd_mode": False}
+        >>> yaml_defaults = {"require_task_before_edit": False, "session_task": None}
+        >>> db_overrides = {"require_task_before_edit": True}
         >>> effective = merge_workflow_variables(yaml_defaults, db_overrides)
-        >>> effective["tdd_mode"]
-        False
         >>> effective["require_task_before_edit"]
-        False
+        True
+        >>> effective["session_task"]
+        None
     """
     # Start with defaults
     effective = dict(yaml_defaults)

gobby/hooks/__init__.py

@@ -65,14 +65,6 @@ from gobby.hooks.plugins import (
 from gobby.hooks.session_coordinator import SessionCoordinator
 from gobby.hooks.webhooks import WebhookDispatcher
 
-# Legacy imports for backward compatibility
-from gobby.sessions.manager import SessionManager
-from gobby.sessions.summary import SummaryFileGenerator
-from gobby.sessions.transcripts.claude import ClaudeTranscriptParser
-
-# Backward-compatible alias
-TranscriptProcessor = ClaudeTranscriptParser
-
 __all__ = [
     # Core coordinator
     "HookManager",
@@ -96,9 +88,4 @@ __all__ = [
     "RegisteredHandler",
     "hook_handler",
     "run_plugin_handlers",
-    # Legacy exports (backward compatibility)
-    "SessionManager",
-    "SummaryFileGenerator",
-    "TranscriptProcessor",
-    "ClaudeTranscriptParser",
 ]