@ngocsangairvds/vsaf 4.1.7 → 4.1.9

package/skills/vds-skill/vds-scripts/mcp_server/src/vds_mcp_server/tools/vidp_tools.py

@@ -1,64 +0,0 @@
-"""VIDP tools for MCP server.
-
-Thin wrappers around ``vds-cli vidp ...`` so the VIDP gateway is reachable
-from any MCP client that talks to the ``vds-orchestrator`` server.
-"""
-
-from __future__ import annotations
-
-import json
-from collections.abc import Callable
-from typing import TYPE_CHECKING, Any
-
-if TYPE_CHECKING:
-    from mcp.server.fastmcp import FastMCP
-
-
-def register_vidp_tools(mcp: FastMCP, execute_cli: Callable[..., Any]) -> None:
-    """Register VIDP tools with the MCP server."""
-
-    @mcp.tool()
-    async def vidp_trigger(workflow: str, payload: Any | None = None) -> str:
-        """Trigger a VIDP third-party action by workflow UUID or alias.
-
-        Maps to ``POST /third-party/v2/start/{workflow_id}``.
-
-        Args:
-            workflow: VIDP workflow UUID (e.g. ``4afa9a1d-d36c-441a-b2fd-ba9612a854c1``)
-                OR a friendly alias defined in ``~/.vds/vidp-workflows.json``
-                (e.g. ``build-jenkins-by-job-name``). Aliases are case-insensitive.
-            payload: Optional JSON payload. Any JSON-serialisable object;
-                does not need to start with ``tenantToken``.
-
-        Returns:
-            JSON string with endpoint, alias used (if any), workflowId, request
-            payload, and full response.
-        """
-        args: list[str] = ["vidp", "trigger", workflow]
-        if payload is not None:
-            args.extend(["--payload", json.dumps(payload)])
-        result = await execute_cli(*args)
-        if result["returncode"] != 0:
-            return f"Error: {result['stderr'] or result['stdout']}"
-        return result["stdout"]
-
-    @mcp.tool()
-    async def vidp_status(job_id: str, raw: bool = False) -> str:
-        """Get full workflow/stage detail for a VIDP job.
-
-        Maps to ``GET /third-party/v2/status/{job_id}?full=true``.
-
-        Args:
-            job_id: VIDP job id.
-            raw: If true, return only the raw VIDP response.
-
-        Returns:
-            JSON string with normalized job state and the raw VIDP response.
-        """
-        args: list[str] = ["vidp", "status", job_id]
-        if raw:
-            args.append("--raw")
-        result = await execute_cli(*args)
-        if result["returncode"] != 0:
-            return f"Error: {result['stderr'] or result['stdout']}"
-        return result["stdout"]

package/skills/vds-skill/vds-scripts/mcp_server/tests/__init__.py

@@ -1 +0,0 @@
-"""Test suite for VDS MCP Server."""

package/skills/vds-skill/vds-scripts/mcp_server/tests/conftest.py

@@ -1,31 +0,0 @@
-"""Pytest configuration and fixtures for MCP server tests."""
-
-from collections.abc import AsyncGenerator
-from typing import TYPE_CHECKING
-from unittest.mock import Mock
-
-import pytest
-from mcp.shared.memory import create_connected_server_and_client_session
-from vds_mcp_server.server import mcp
-
-if TYPE_CHECKING:
-    from mcp.client.session import ClientSession
-
-
-@pytest.fixture
-def anyio_backend() -> str:
-    """Use asyncio backend for tests."""
-    return "asyncio"
-
-
-@pytest.fixture
-async def client_session() -> AsyncGenerator[ClientSession]:
-    """Create in-memory MCP client session for testing."""
-    async with create_connected_server_and_client_session(mcp, raise_exceptions=True) as session:
-        yield session
-
-
-@pytest.fixture
-def mock_execute_cli() -> Mock:
-    """Mock CLI execution function."""
-    return Mock(return_value={"stdout": "test output", "stderr": "", "returncode": 0})

package/skills/vds-skill/vds-scripts/mcp_server/tests/unit/__init__.py

@@ -1 +0,0 @@
-"""Unit tests for VDS MCP Server."""

package/skills/vds-skill/vds-scripts/mcp_server/tests/unit/test_bitbucket_tools.py

@@ -1,28 +0,0 @@
-"""Unit tests for Bitbucket tools.
-
-Based on pytest v8.3.3+ API
-Context7: /pytest-dev/pytest
-"""
-
-from typing import TYPE_CHECKING
-
-import pytest
-
-if TYPE_CHECKING:
-    from mcp.client.session import ClientSession
-
-pytestmark = pytest.mark.anyio
-
-
-async def test_bitbucket_list_projects_tool(client_session: ClientSession) -> None:
-    """Test bitbucket_list_projects tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "bitbucket_list_projects" in tool_names
-
-
-async def test_bitbucket_list_repositories_tool(client_session: ClientSession) -> None:
-    """Test bitbucket_list_repositories tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "bitbucket_list_repositories" in tool_names

package/skills/vds-skill/vds-scripts/mcp_server/tests/unit/test_confluence_tools.py

@@ -1,28 +0,0 @@
-"""Unit tests for Confluence tools.
-
-Based on pytest v8.3.3+ API
-Context7: /pytest-dev/pytest
-"""
-
-from typing import TYPE_CHECKING
-
-import pytest
-
-if TYPE_CHECKING:
-    from mcp.client.session import ClientSession
-
-pytestmark = pytest.mark.anyio
-
-
-async def test_confluence_search_tool(client_session: ClientSession) -> None:
-    """Test confluence_search tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "confluence_search" in tool_names
-
-
-async def test_confluence_get_page_tool(client_session: ClientSession) -> None:
-    """Test confluence_get_page tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "confluence_get_page" in tool_names

package/skills/vds-skill/vds-scripts/mcp_server/tests/unit/test_git_tools.py

@@ -1,35 +0,0 @@
-"""Unit tests for Git tools.
-
-Based on pytest v8.3.3+ API
-Context7: /pytest-dev/pytest
-"""
-
-from typing import TYPE_CHECKING
-
-import pytest
-
-if TYPE_CHECKING:
-    from mcp.client.session import ClientSession
-
-pytestmark = pytest.mark.anyio
-
-
-async def test_git_clone_tool(client_session: ClientSession) -> None:
-    """Test git_clone tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "git_clone" in tool_names
-
-
-async def test_git_status_tool(client_session: ClientSession) -> None:
-    """Test git_status tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "git_status" in tool_names
-
-
-async def test_git_pull_tool(client_session: ClientSession) -> None:
-    """Test git_pull tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "git_pull" in tool_names

package/skills/vds-skill/vds-scripts/mcp_server/tests/unit/test_jira_tools.py

@@ -1,35 +0,0 @@
-"""Unit tests for JIRA tools.
-
-Based on pytest v8.3.3+ API
-Context7: /pytest-dev/pytest
-"""
-
-from typing import TYPE_CHECKING
-
-import pytest
-
-if TYPE_CHECKING:
-    from mcp.client.session import ClientSession
-
-pytestmark = pytest.mark.anyio
-
-
-async def test_jira_search_tool(client_session: ClientSession) -> None:
-    """Test jira_search tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "jira_search" in tool_names
-
-
-async def test_jira_get_issue_tool(client_session: ClientSession) -> None:
-    """Test jira_get_issue tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "jira_get_issue" in tool_names
-
-
-async def test_jira_list_projects_tool(client_session: ClientSession) -> None:
-    """Test jira_list_projects tool is available."""
-    tools = await client_session.list_tools()
-    tool_names = [tool.name for tool in tools.tools]
-    assert "jira_list_projects" in tool_names

package/skills/vds-skill/vds-scripts/mcp_server/tests/verification/__init__.py

@@ -1,6 +0,0 @@
-"""Real API verification tests for MCP server.
-
-These tests are MANUAL verification — they hit real Confluence and Jira APIs
-via MCP tools and require ambient credentials.  Skipped by default; opt in
-with ``--run-verification`` or ``VDS_RUN_VERIFICATION=1``.
-"""

package/skills/vds-skill/vds-scripts/mcp_server/tests/verification/conftest.py

@@ -1,51 +0,0 @@
-"""Manual verification tests — skipped by default.
-
-These tests hit real external services (Confluence, Jira) via the MCP server
-and require ambient credentials.  They are NOT part of the default pytest suite.
-
-Run explicitly with::
-
-    pytest --run-verification mcp_server/tests/verification/
-
-Or set the environment variable::
-
-    VDS_RUN_VERIFICATION=1 pytest mcp_server/tests/verification/
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-
-def pytest_addoption(parser: pytest.Parser) -> None:
-    """Register ``--run-verification`` CLI flag."""
-    try:
-        parser.addoption(
-            "--run-verification",
-            action="store_true",
-            default=False,
-            help="Run manual verification tests that hit real services.",
-        )
-    except ValueError:
-        pass  # already registered by another conftest
-
-
-def pytest_collection_modifyitems(config: pytest.Config, items: list[pytest.Item]) -> None:
-    """Skip verification tests unless explicitly opted in.
-
-    Only targets items whose node ID contains ``verification/`` so that
-    the hook never accidentally skips non-verification tests when pytest
-    collects from a parent directory.
-    """
-    if os.environ.get("VDS_RUN_VERIFICATION") == "1":
-        return
-    if config.getoption("--run-verification", default=False):
-        return
-    skip_marker = pytest.mark.skip(
-        reason="Verification tests require --run-verification or VDS_RUN_VERIFICATION=1",
-    )
-    for item in items:
-        if "verification" in item.nodeid:
-            item.add_marker(skip_marker)

package/skills/vds-skill/vds-scripts/mcp_server/tests/verification/test_mcp_confluence_tools.py

@@ -1,40 +0,0 @@
-"""Real API verification tests for Confluence tools via MCP.
-
-Based on pytest v8.3.3+ API
-Context7: /pytest-dev/pytest
-Key Features: @pytest.mark.skipif, real API calls via MCP
-"""
-
-import os
-from typing import TYPE_CHECKING
-
-import pytest
-
-if TYPE_CHECKING:
-    from mcp.client.session import ClientSession
-
-# Skip if credentials not available
-pytestmark = pytest.mark.skipif(
-    not os.getenv("INTERNAL_CONFLUENCE_TOKEN") or not os.getenv("EXTERNAL_CONFLUENCE_TOKEN"),
-    reason="Confluence tokens not available",
-)
-
-
-@pytest.mark.anyio
-async def test_confluence_search_via_mcp(client_session: ClientSession) -> None:
-    """Verify Confluence search tool via MCP with real API."""
-    result = await client_session.call_tool(
-        "confluence_search", {"query": "space = TDOV", "server": "internal", "limit": 5}
-    )
-    # Verify result structure
-    assert result is not None
-
-
-@pytest.mark.anyio
-async def test_confluence_get_page_via_mcp(client_session: ClientSession) -> None:
-    """Verify Confluence get page tool via MCP with real API."""
-    # Note: This will fail if page ID doesn't exist
-    # In real scenario, use a valid page ID
-    result = await client_session.call_tool("confluence_get_page", {"page_id": "99647801", "server": "external"})
-    # Verify result structure
-    assert result is not None

package/skills/vds-skill/vds-scripts/mcp_server/tests/verification/test_mcp_jira_tools.py

@@ -1,39 +0,0 @@
-"""Real API verification tests for JIRA tools via MCP.
-
-Based on pytest v8.3.3+ API
-Context7: /pytest-dev/pytest
-Key Features: @pytest.mark.skipif, real API calls via MCP
-"""
-
-import os
-from typing import TYPE_CHECKING
-
-import pytest
-
-if TYPE_CHECKING:
-    from mcp.client.session import ClientSession
-
-# Skip if credentials not available
-pytestmark = pytest.mark.skipif(
-    not os.getenv("VDS_USERNAME") or not os.getenv("VDS_PASSWORD"),
-    reason="VDS credentials not available",
-)
-
-
-@pytest.mark.anyio
-async def test_jira_search_via_mcp(client_session: ClientSession) -> None:
-    """Verify JIRA search tool via MCP with real API."""
-    # Note: This will fail if vds-cli is not available or credentials are invalid
-    # In real scenario, this should return search results
-    result = await client_session.call_tool("jira_search", {"query": "project = NTTC", "limit": 5})
-    # Verify result structure
-    assert result is not None
-    # Note: Actual content depends on API response
-
-
-@pytest.mark.anyio
-async def test_jira_list_projects_via_mcp(client_session: ClientSession) -> None:
-    """Verify JIRA list projects tool via MCP with real API."""
-    result = await client_session.call_tool("jira_list_projects", {})
-    # Verify result structure
-    assert result is not None

package/skills/vds-skill/vds-scripts/mcp_server/tests/verification/test_mcp_tool_registration.py

@@ -1,50 +0,0 @@
-"""Verify MCP tool registration and discovery.
-
-Based on pytest v8.3.3+ API
-Context7: /pytest-dev/pytest
-"""
-
-from typing import TYPE_CHECKING
-
-import pytest
-
-if TYPE_CHECKING:
-    from mcp.client.session import ClientSession
-
-pytestmark = pytest.mark.anyio
-
-
-async def test_all_tools_registered(client_session: ClientSession) -> None:
-    """Verify all expected tools are registered."""
-    tools = await client_session.list_tools()
-    tool_names = {tool.name for tool in tools.tools}
-
-    # Expected tools
-    expected_tools = {
-        # JIRA tools
-        "jira_search",
-        "jira_get_issue",
-        "jira_list_projects",
-        # Confluence tools
-        "confluence_search",
-        "confluence_get_page",
-        # Bitbucket tools
-        "bitbucket_list_projects",
-        "bitbucket_list_repositories",
-        # Git tools
-        "git_clone",
-        "git_status",
-        "git_pull",
-    }
-
-    assert expected_tools.issubset(tool_names), f"Missing tools: {expected_tools - tool_names}"
-
-
-async def test_tool_schemas_valid(client_session: ClientSession) -> None:
-    """Verify tool schemas are valid."""
-    tools = await client_session.list_tools()
-
-    for tool in tools.tools:
-        assert tool.name, f"Tool missing name: {tool}"
-        assert tool.description, f"Tool {tool.name} missing description"
-        assert tool.inputSchema, f"Tool {tool.name} missing inputSchema"

package/skills/vds-skill/vds-scripts/pdf_orchestrator/.dockerignore

@@ -1,93 +0,0 @@
-# Python
-__pycache__/
-*.py[cod]
-*$py.class
-*.so
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-pip-wheel-metadata/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
-# Virtual environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# OS
-.DS_Store
-.DS_Store?
-._*
-.Spotlight-V100
-.Trashes
-ehthumbs.db
-Thumbs.db
-
-# Testing
-.coverage
-.pytest_cache/
-.tox/
-htmlcov/
-.cache
-
-# Logs
-*.log
-logs/
-
-# Data and cache (but keep structure)
-data/*
-cache/*
-!data/.gitkeep
-!cache/.gitkeep
-
-# Documentation (keep README for build)
-*.md
-!README.md
-
-# Git
-.git/
-.gitignore
-
-# Development scripts
-demo_*.py
-test_*.py
-debug_*.py
-
-# Coverage and profiling
-.prof
-*.prof
-
-# Backup files
-*.bak
-*.backup
-*.old
-
-# Temporary files
-*.tmp
-*.temp
-.tmp/

package/skills/vds-skill/vds-scripts/pdf_orchestrator/.env.example

@@ -1,40 +0,0 @@
-# =============================================================================
-# VDS PDF Orchestrator - Environment Configuration
-# =============================================================================
-# P0 Change (2026-04-25): Uses shared vds-redis for session cache.
-# See docker/MIGRATION.md for migration details.
-# =============================================================================
-# Copy this file to .env and fill in your values
-# DO NOT commit .env to version control
-# =============================================================================
-
-# -----------------------------------------------------------------------------
-# Shared Redis Configuration (P0: Uses shared vds-redis)
-# -----------------------------------------------------------------------------
-# PDF orchestrator uses Redis DB 7 for session cache.
-
-# Base Redis URL
-REDIS_URL=redis://localhost:6379
-
-# PDF-specific Redis DB (DB 7)
-REDIS_PDF_SESSION_DB=7
-
-# -----------------------------------------------------------------------------
-# PDF Processing Configuration
-# -----------------------------------------------------------------------------
-# Max file size for PDF processing (bytes)
-PDF_MAX_FILE_SIZE=52428800  # 50MB
-
-# Processing timeout (seconds)
-PDF_PROCESSING_TIMEOUT=300
-
-# -----------------------------------------------------------------------------
-# API Configuration
-# -----------------------------------------------------------------------------
-# API host and port
-API_HOST=0.0.0.0
-API_PORT=8001
-
-# Logging
-LOG_LEVEL=INFO
-LOG_FORMAT=json