galangal-orchestrate 0.2.11__py3-none-any.whl

galangal/config/defaults.py

@@ -0,0 +1,133 @@
+"""
+Default configuration values and templates.
+"""
+
+DEFAULT_CONFIG_YAML = """\
+# Galangal Orchestrate Configuration
+# https://github.com/Galangal-Media/galangal-orchestrate
+
+project:
+  name: "{project_name}"
+
+  # Technology stacks in this project
+  stacks:
+{stacks_yaml}
+
+# Task storage location
+tasks_dir: galangal-tasks
+
+# Git branch naming pattern
+branch_pattern: "task/{{task_name}}"
+
+# =============================================================================
+# Stage Configuration
+# =============================================================================
+
+stages:
+  # Stages to always skip for this project
+  skip:
+    - BENCHMARK        # Enable if you have performance requirements
+    # - CONTRACT       # Enable if you have OpenAPI contract testing
+    # - MIGRATION      # Enable if you have database migrations
+
+  # Stage timeout in seconds (default: 4 hours)
+  timeout: 14400
+
+  # Max retries per stage
+  max_retries: 5
+
+# =============================================================================
+# Validation Commands
+# =============================================================================
+# Configure how each stage validates its outputs.
+# Use {{task_dir}} placeholder for the task artifacts directory.
+
+validation:
+  # Preflight - environment checks (runs directly, no AI)
+  preflight:
+    checks:
+      - name: "Git clean"
+        command: "git status --porcelain"
+        expect_empty: true
+        warn_only: true       # Report but don't fail if working tree has changes
+
+  # QA - quality checks
+  qa:
+    # Default timeout per command (seconds)
+    timeout: 300
+    commands:
+      - name: "Tests"
+        command: "echo 'Configure your test command in .galangal/config.yaml'"
+        # timeout: 3600
+
+  # Review - code review (AI-driven)
+  review:
+    pass_marker: "APPROVE"
+    fail_marker: "REQUEST_CHANGES"
+    artifact: "REVIEW_NOTES.md"
+
+# =============================================================================
+# AI Backend Configuration
+# =============================================================================
+
+ai:
+  default: claude
+
+  backends:
+    claude:
+      command: "claude"
+      args: ["-p", "{{prompt}}", "--output-format", "stream-json", "--verbose"]
+      max_turns: 200
+
+# =============================================================================
+# Pull Request Configuration
+# =============================================================================
+
+pr:
+  codex_review: false      # Set to true to add @codex review to PR body
+  base_branch: main
+
+# =============================================================================
+# Prompt Context
+# =============================================================================
+# Add project-specific patterns and instructions here.
+# This context is added to ALL stage prompts.
+
+prompt_context: |
+  ## Project: {project_name}
+
+  Add your project-specific patterns, coding standards,
+  and instructions here.
+
+# Per-stage prompt additions
+stage_context:
+  DEV: |
+    # Add DEV-specific context here
+  TEST: |
+    # Add TEST-specific context here
+"""
+
+
+def generate_default_config(
+    project_name: str = "My Project",
+    stacks: list[dict[str, str]] | None = None,
+) -> str:
+    """Generate a default config.yaml content."""
+    if stacks is None:
+        stacks = [{"language": "python", "framework": None, "root": None}]
+
+    # Build stacks YAML
+    stacks_lines = []
+    for stack in stacks:
+        stacks_lines.append(f"    - language: {stack['language']}")
+        if stack.get("framework"):
+            stacks_lines.append(f"      framework: {stack['framework']}")
+        if stack.get("root"):
+            stacks_lines.append(f"      root: {stack['root']}")
+
+    stacks_yaml = "\n".join(stacks_lines) if stacks_lines else "    []"
+
+    return DEFAULT_CONFIG_YAML.format(
+        project_name=project_name,
+        stacks_yaml=stacks_yaml,
+    )

galangal/config/loader.py

@@ -0,0 +1,113 @@
+"""
+Configuration loading and management.
+"""
+
+import os
+from pathlib import Path
+from typing import Optional
+
+import yaml
+
+from galangal.config.schema import GalangalConfig
+
+# Global config cache
+_config: Optional[GalangalConfig] = None
+_project_root: Optional[Path] = None
+
+
+def find_project_root(start_path: Optional[Path] = None) -> Path:
+    """
+    Find the project root by looking for .galangal/ directory.
+    Falls back to git root, then current directory.
+    """
+    if start_path is None:
+        start_path = Path.cwd()
+
+    current = start_path.resolve()
+
+    # Walk up looking for .galangal/
+    while current != current.parent:
+        if (current / ".galangal").is_dir():
+            return current
+        if (current / ".git").is_dir():
+            # Found git root, use this as fallback
+            return current
+        current = current.parent
+
+    # Fall back to start path
+    return start_path.resolve()
+
+
+def get_project_root() -> Path:
+    """Get the cached project root."""
+    global _project_root
+    if _project_root is None:
+        _project_root = find_project_root()
+    return _project_root
+
+
+def set_project_root(path: Path) -> None:
+    """Set the project root (for testing)."""
+    global _project_root, _config
+    _project_root = path.resolve()
+    _config = None  # Reset config cache
+
+
+def load_config(project_root: Optional[Path] = None) -> GalangalConfig:
+    """
+    Load configuration from .galangal/config.yaml.
+    Returns default config if file doesn't exist.
+    """
+    global _config, _project_root
+
+    if project_root is not None:
+        _project_root = project_root.resolve()
+    elif _project_root is None:
+        _project_root = find_project_root()
+
+    config_path = _project_root / ".galangal" / "config.yaml"
+
+    if not config_path.exists():
+        _config = GalangalConfig()
+        return _config
+
+    try:
+        with open(config_path) as f:
+            data = yaml.safe_load(f) or {}
+
+        _config = GalangalConfig.model_validate(data)
+        return _config
+    except Exception as e:
+        # Log warning but return defaults
+        print(f"Warning: Could not load config: {e}")
+        _config = GalangalConfig()
+        return _config
+
+
+def get_config() -> GalangalConfig:
+    """Get the cached configuration, loading if necessary."""
+    global _config
+    if _config is None:
+        _config = load_config()
+    return _config
+
+
+def get_tasks_dir() -> Path:
+    """Get the tasks directory path."""
+    config = get_config()
+    return get_project_root() / config.tasks_dir
+
+
+def get_done_dir() -> Path:
+    """Get the done tasks directory path."""
+    return get_tasks_dir() / "done"
+
+
+def get_active_file() -> Path:
+    """Get the active task marker file path."""
+    return get_tasks_dir() / ".active"
+
+
+def get_prompts_dir() -> Path:
+    """Get the project prompts override directory."""
+    return get_project_root() / ".galangal" / "prompts"

galangal/config/schema.py

@@ -0,0 +1,155 @@
+"""
+Configuration schema using Pydantic models.
+"""
+
+from typing import Optional
+from pydantic import BaseModel, Field
+
+
+class StackConfig(BaseModel):
+    """Configuration for a technology stack."""
+
+    language: str = Field(description="Programming language (python, typescript, php, etc.)")
+    framework: Optional[str] = Field(default=None, description="Framework (fastapi, vite, symfony)")
+    root: Optional[str] = Field(default=None, description="Subdirectory for this stack")
+
+
+class ProjectConfig(BaseModel):
+    """Project-level configuration."""
+
+    name: str = Field(default="My Project", description="Project name")
+    stacks: list[StackConfig] = Field(default_factory=list, description="Technology stacks")
+    approver_name: Optional[str] = Field(default=None, description="Default approver name for plan approvals")
+
+
+class StageConfig(BaseModel):
+    """Stage execution configuration."""
+
+    skip: list[str] = Field(default_factory=list, description="Stages to always skip")
+    timeout: int = Field(default=14400, description="Stage timeout in seconds (default: 4 hours)")
+    max_retries: int = Field(default=5, description="Max retries per stage")
+
+
+class PreflightCheck(BaseModel):
+    """A single preflight check."""
+
+    name: str = Field(description="Check name for display")
+    command: Optional[str] = Field(default=None, description="Command to run")
+    path_exists: Optional[str] = Field(default=None, description="Path that must exist")
+    expect_empty: bool = Field(default=False, description="Pass if output is empty")
+    warn_only: bool = Field(default=False, description="Warn but don't fail the stage")
+
+
+class ValidationCommand(BaseModel):
+    """A validation command configuration."""
+
+    name: str = Field(description="Command name for display")
+    command: str = Field(description="Shell command to run")
+    optional: bool = Field(default=False, description="Don't fail if this command fails")
+    allow_failure: bool = Field(default=False, description="Report but don't block on failure")
+    timeout: Optional[int] = Field(
+        default=None, description="Command timeout in seconds (overrides stage default)"
+    )
+
+
+class SkipCondition(BaseModel):
+    """Condition for skipping a stage."""
+
+    no_files_match: Optional[str] = Field(
+        default=None, description="Skip if no files match this glob pattern"
+    )
+
+
+class StageValidation(BaseModel):
+    """Validation configuration for a single stage."""
+
+    skip_if: Optional[SkipCondition] = Field(default=None, description="Skip condition")
+    timeout: int = Field(
+        default=300, description="Default timeout in seconds for validation commands"
+    )
+    commands: list[ValidationCommand] = Field(
+        default_factory=list, description="Commands to run"
+    )
+    checks: list[PreflightCheck] = Field(
+        default_factory=list, description="Preflight checks (for preflight stage)"
+    )
+    pass_marker: Optional[str] = Field(
+        default=None, description="Text marker indicating pass (for AI stages)"
+    )
+    fail_marker: Optional[str] = Field(
+        default=None, description="Text marker indicating failure (for AI stages)"
+    )
+    artifact: Optional[str] = Field(
+        default=None, description="Artifact file to check for markers"
+    )
+    artifacts_required: list[str] = Field(
+        default_factory=list, description="Required artifact files"
+    )
+
+
+class ValidationConfig(BaseModel):
+    """All stage validations."""
+
+    preflight: StageValidation = Field(default_factory=StageValidation)
+    migration: StageValidation = Field(default_factory=StageValidation)
+    test: StageValidation = Field(default_factory=StageValidation)
+    contract: StageValidation = Field(default_factory=StageValidation)
+    qa: StageValidation = Field(default_factory=StageValidation)
+    security: StageValidation = Field(default_factory=StageValidation)
+    review: StageValidation = Field(default_factory=StageValidation)
+    docs: StageValidation = Field(default_factory=StageValidation)
+
+
+class AIBackendConfig(BaseModel):
+    """Configuration for an AI backend."""
+
+    command: str = Field(description="Command to invoke the AI")
+    args: list[str] = Field(default_factory=list, description="Command arguments")
+    max_turns: int = Field(default=200, description="Maximum conversation turns")
+
+
+class AIConfig(BaseModel):
+    """AI backend configuration."""
+
+    default: str = Field(default="claude", description="Default backend")
+    backends: dict[str, AIBackendConfig] = Field(
+        default_factory=lambda: {
+            "claude": AIBackendConfig(
+                command="claude",
+                args=["-p", "{prompt}", "--output-format", "stream-json", "--verbose"],
+                max_turns=200,
+            )
+        }
+    )
+    stage_backends: dict[str, str] = Field(
+        default_factory=dict, description="Per-stage backend overrides"
+    )
+
+
+class PRConfig(BaseModel):
+    """Pull request configuration."""
+
+    codex_review: bool = Field(
+        default=False, description="Add @codex review to PR body"
+    )
+    base_branch: str = Field(default="main", description="Base branch for PRs")
+
+
+class GalangalConfig(BaseModel):
+    """Root configuration model."""
+
+    project: ProjectConfig = Field(default_factory=ProjectConfig)
+    tasks_dir: str = Field(default="galangal-tasks", description="Task storage directory")
+    branch_pattern: str = Field(
+        default="task/{task_name}", description="Git branch naming pattern"
+    )
+    stages: StageConfig = Field(default_factory=StageConfig)
+    validation: ValidationConfig = Field(default_factory=ValidationConfig)
+    ai: AIConfig = Field(default_factory=AIConfig)
+    pr: PRConfig = Field(default_factory=PRConfig)
+    prompt_context: str = Field(
+        default="", description="Global context added to all prompts"
+    )
+    stage_context: dict[str, str] = Field(
+        default_factory=dict, description="Per-stage prompt context"
+    )

galangal/core/__init__.py

@@ -0,0 +1,18 @@
+"""Core workflow components."""
+
+from galangal.core.state import Stage, TaskType, WorkflowState, STAGE_ORDER
+from galangal.core.artifacts import artifact_exists, read_artifact, write_artifact
+from galangal.core.tasks import get_active_task, set_active_task, list_tasks
+
+__all__ = [
+    "Stage",
+    "TaskType",
+    "WorkflowState",
+    "STAGE_ORDER",
+    "artifact_exists",
+    "read_artifact",
+    "write_artifact",
+    "get_active_task",
+    "set_active_task",
+    "list_tasks",
+]

galangal/core/artifacts.py

@@ -0,0 +1,66 @@
+"""
+Artifact management - reading and writing task artifacts.
+"""
+
+import subprocess
+from pathlib import Path
+from typing import Optional
+
+from galangal.config.loader import get_project_root
+from galangal.core.state import get_task_dir
+
+
+def artifact_path(name: str, task_name: Optional[str] = None) -> Path:
+    """Get path to an artifact file."""
+    from galangal.core.tasks import get_active_task
+
+    if task_name is None:
+        task_name = get_active_task()
+    if task_name is None:
+        raise ValueError("No active task")
+    return get_task_dir(task_name) / name
+
+
+def artifact_exists(name: str, task_name: Optional[str] = None) -> bool:
+    """Check if an artifact exists."""
+    try:
+        return artifact_path(name, task_name).exists()
+    except ValueError:
+        return False
+
+
+def read_artifact(name: str, task_name: Optional[str] = None) -> Optional[str]:
+    """Read an artifact file."""
+    try:
+        path = artifact_path(name, task_name)
+        if path.exists():
+            return path.read_text()
+    except ValueError:
+        pass
+    return None
+
+
+def write_artifact(name: str, content: str, task_name: Optional[str] = None) -> None:
+    """Write an artifact file."""
+    path = artifact_path(name, task_name)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content)
+
+
+def run_command(
+    cmd: list[str], cwd: Optional[Path] = None, timeout: int = 300
+) -> tuple[int, str, str]:
+    """Run a command and return (exit_code, stdout, stderr)."""
+    try:
+        result = subprocess.run(
+            cmd,
+            cwd=cwd or get_project_root(),
+            capture_output=True,
+            text=True,
+            timeout=timeout,
+        )
+        return result.returncode, result.stdout, result.stderr
+    except subprocess.TimeoutExpired:
+        return -1, "", f"Command timed out after {timeout}s"
+    except Exception as e:
+        return -1, "", str(e)