xcode-mcp-server 1.3.15__tar.gz → 1.3.16b2__tar.gz

xcode_mcp_server-1.3.16b2/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: xcode-mcp-server
+Version: 1.3.16b2
+Summary: RENAMED to drews-xcode-mcp - this compatibility package forwards to it
+Project-URL: Homepage, https://github.com/drewster99/drews-xcode-mcp
+Project-URL: Repository, https://github.com/drewster99/drews-xcode-mcp
+Project-URL: Issues, https://github.com/drewster99/drews-xcode-mcp/issues
+Author-email: Andrew Benson <db@nuclearcyborg.com>
+License: MIT
+License-File: LICENSE
+Keywords: mcp,server,xcode
+Classifier: Development Status :: 7 - Inactive
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: drews-xcode-mcp==1.3.16b2
+Description-Content-Type: text/markdown
+
+# xcode-mcp-server → drews-xcode-mcp
+
+**This package has been renamed to [drews-xcode-mcp](https://pypi.org/project/drews-xcode-mcp/).**
+
+With several projects named "xcode-mcp-server" in the wild — and Xcode itself now
+shipping a built-in MCP server — the old name had become ambiguous.
+
+Nothing breaks: installing this package pulls in `drews-xcode-mcp` and forwards the
+`xcode-mcp-server` command to it, so existing MCP client configurations keep working.
+Your settings carry over automatically (`~/.xcode-mcp-server` is renamed to
+`~/.drews-xcode-mcp` on first run), and `XCODEMCP_ALLOWED_FOLDERS` works as before.
+
+When convenient, update your MCP configuration to run `drews-xcode-mcp` instead.
+For Claude Code:
+
+```bash
+claude mcp remove xcode-mcp-server
+claude mcp add --scope user --transport stdio -- drews-xcode-mcp `which uvx` drews-xcode-mcp
+```
+
+(If you have tool-permission allowlists tied to the old server name, you can keep
+the old name instead — replace the first `drews-xcode-mcp` after `--` (the server
+key) with `xcode-mcp-server`, leaving the package name at the end unchanged.)
+
+Source, documentation, and issues: https://github.com/drewster99/drews-xcode-mcp

xcode_mcp_server-1.3.16b2/README.md

@@ -0,0 +1,25 @@
+# xcode-mcp-server → drews-xcode-mcp
+
+**This package has been renamed to [drews-xcode-mcp](https://pypi.org/project/drews-xcode-mcp/).**
+
+With several projects named "xcode-mcp-server" in the wild — and Xcode itself now
+shipping a built-in MCP server — the old name had become ambiguous.
+
+Nothing breaks: installing this package pulls in `drews-xcode-mcp` and forwards the
+`xcode-mcp-server` command to it, so existing MCP client configurations keep working.
+Your settings carry over automatically (`~/.xcode-mcp-server` is renamed to
+`~/.drews-xcode-mcp` on first run), and `XCODEMCP_ALLOWED_FOLDERS` works as before.
+
+When convenient, update your MCP configuration to run `drews-xcode-mcp` instead.
+For Claude Code:
+
+```bash
+claude mcp remove xcode-mcp-server
+claude mcp add --scope user --transport stdio -- drews-xcode-mcp `which uvx` drews-xcode-mcp
+```
+
+(If you have tool-permission allowlists tied to the old server name, you can keep
+the old name instead — replace the first `drews-xcode-mcp` after `--` (the server
+key) with `xcode-mcp-server`, leaving the package name at the end unchanged.)
+
+Source, documentation, and issues: https://github.com/drewster99/drews-xcode-mcp

xcode_mcp_server-1.3.16b2/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "xcode-mcp-server"
+# The version and the drews-xcode-mcp pin below are rewritten in lockstep by
+# deploy.sh so every release of the renamed package ships a matching shim.
+version = "1.3.16b2"
+description = "RENAMED to drews-xcode-mcp - this compatibility package forwards to it"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "Andrew Benson", email = "db@nuclearcyborg.com"},
+]
+keywords = ["mcp", "xcode", "server"]
+classifiers = [
+    "Development Status :: 7 - Inactive",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+dependencies = [
+    "drews-xcode-mcp==1.3.16b2",
+]
+
+[project.scripts]
+xcode-mcp-server = "xcode_mcp_server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["xcode_mcp_server"]
+
+[project.urls]
+Homepage = "https://github.com/drewster99/drews-xcode-mcp"
+Repository = "https://github.com/drewster99/drews-xcode-mcp"
+Issues = "https://github.com/drewster99/drews-xcode-mcp/issues"

xcode_mcp_server-1.3.16b2/xcode_mcp_server/__init__.py

@@ -0,0 +1,42 @@
+"""Compatibility shim: the xcode-mcp-server package is now drews-xcode-mcp.
+
+Installing this package pulls in drews-xcode-mcp and forwards the old
+`xcode-mcp-server` command to it, so existing MCP client configurations keep
+working unchanged. New configurations should invoke `drews-xcode-mcp` directly.
+"""
+
+import os
+import sys
+
+# Read by the renamed server so it can surface migration guidance to the
+# client when it was launched through this legacy package name.
+LEGACY_PACKAGE_ENVIRONMENT_VARIABLE = "XCODE_MCP_LEGACY_PACKAGE_NAME"
+
+
+def main():
+    """Forward the legacy xcode-mcp-server command to drews-xcode-mcp."""
+    os.environ[LEGACY_PACKAGE_ENVIRONMENT_VARIABLE] = "xcode-mcp-server"
+    # stderr only: stdout carries the MCP protocol stream and must stay clean.
+    print(
+        "NOTE: The 'xcode-mcp-server' package has been renamed to 'drews-xcode-mcp'.\n"
+        "      This compatibility package keeps existing configurations working,\n"
+        "      but please update your MCP configuration to run 'drews-xcode-mcp'.\n"
+        "      Details: https://github.com/drewster99/drews-xcode-mcp",
+        file=sys.stderr,
+    )
+    from drews_xcode_mcp import main as run_renamed_server
+    return run_renamed_server()
+
+
+def __getattr__(name):
+    # __version__ is resolved lazily (PEP 562) rather than imported at module
+    # scope: importing this shim must never pull in drews_xcode_mcp before
+    # main() has set the legacy environment variable, because server.py reads
+    # that variable at import time.
+    if name == "__version__":
+        from drews_xcode_mcp import __version__
+        return __version__
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = ["main", "__version__"]

xcode_mcp_server-1.3.16b2/xcode_mcp_server/__main__.py

@@ -0,0 +1,6 @@
+"""Keeps `python -m xcode_mcp_server` working after the rename to drews-xcode-mcp."""
+
+from xcode_mcp_server import main
+
+if __name__ == "__main__":
+    main()

xcode_mcp_server-1.3.15/.github/workflows/claude-code.yml

@@ -1,78 +0,0 @@
-name: Claude Code
-
-on:
-  workflow_dispatch:
-  issue_comment:
-    types: [created]
-  pull_request_review_comment:
-    types: [created]
-  issues:
-    types: [opened, assigned]
-  pull_request_review:
-    types: [submitted]
-
-jobs:
-  claude:
-    if: |
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
-      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude'))) ||
-      (github.event_name == 'issues' && github.event.action == 'assigned' && github.event.assignee.login == 'claude[bot]')
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      id-token: write
-      actions: read
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 1
-
-      - name: Set up global Claude config
-        env:
-          GH_TOKEN: ${{ secrets.CROSS_REPO_PAT }}
-        run: |
-          mkdir -p ~/.claude
-          gh api repos/drewster99/dev-ops/contents/claude-rules/base.md \
-            --jq '.content' | base64 -d > ~/.claude/CLAUDE.md
-          echo "" >> ~/.claude/CLAUDE.md
-          gh api repos/drewster99/dev-ops/contents/claude-rules/ci.md \
-            --jq '.content' | base64 -d >> ~/.claude/CLAUDE.md
-
-      - name: Run Claude Code
-        id: claude
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          additional_permissions: |
-            actions: read
-
-      - name: Auto-create PR if Claude pushed a branch
-        if: github.event_name == 'issues' || (github.event_name == 'issue_comment' && !github.event.issue.pull_request)
-        env:
-          GH_TOKEN: ${{ github.token }}
-          ISSUE_NUMBER: ${{ github.event.issue.number }}
-        run: |
-          git fetch origin --no-tags
-          BRANCH=$(git branch -r --list "origin/claude/issue-${ISSUE_NUMBER}-*" | head -1 | xargs)
-          if [ -z "$BRANCH" ]; then
-            echo "No Claude branch found for issue #${ISSUE_NUMBER}, skipping PR creation."
-            exit 0
-          fi
-          LOCAL_BRANCH="${BRANCH#origin/}"
-          EXISTING_PR=$(gh pr list --head "$LOCAL_BRANCH" --json number --jq '.[0].number' 2>/dev/null)
-          if [ -n "$EXISTING_PR" ]; then
-            echo "PR #${EXISTING_PR} already exists for branch ${LOCAL_BRANCH}."
-            exit 0
-          fi
-          echo "Creating PR from ${LOCAL_BRANCH} for issue #${ISSUE_NUMBER}..."
-          PR_BODY=$(printf 'Resolves #%s\n\nAuto-generated by Claude Code from issue #%s.' "$ISSUE_NUMBER" "$ISSUE_NUMBER")
-          gh pr create \
-            --head "$LOCAL_BRANCH" \
-            --title "$(gh issue view "$ISSUE_NUMBER" --json title --jq .title)" \
-            --body "$PR_BODY" \
-            || echo "PR creation failed -- Claude may not have pushed commits."

xcode_mcp_server-1.3.15/.github/workflows/claude-self-review.yml

@@ -1,69 +0,0 @@
-name: Claude Self-Review
-
-on:
-  pull_request:
-    types: [opened, synchronize]
-
-jobs:
-  self-review:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      id-token: write
-    steps:
-      - name: Check review iteration count
-        id: check-iterations
-        env:
-          GH_TOKEN: ${{ github.token }}
-          PR_NUMBER: ${{ github.event.pull_request.number }}
-        run: |
-          MAX_REVIEWS=3
-          COUNT=$(gh api "repos/${{ github.repository }}/issues/${PR_NUMBER}/comments" \
-            --jq '[.[] | select(.user.login == "github-actions[bot]" and (.body | contains("Self-review pass"))) ] | length')
-          echo "review_count=$COUNT" >> "$GITHUB_OUTPUT"
-          if [ "$COUNT" -ge "$MAX_REVIEWS" ]; then
-            echo "skip=true" >> "$GITHUB_OUTPUT"
-            echo "Reached max self-review iterations ($MAX_REVIEWS). Skipping."
-          else
-            echo "skip=false" >> "$GITHUB_OUTPUT"
-            echo "Self-review pass $((COUNT + 1)) of $MAX_REVIEWS"
-          fi
-
-      - name: Checkout repository
-        if: steps.check-iterations.outputs.skip != 'true'
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 1
-          ref: ${{ github.head_ref }}
-
-      - name: Set up global Claude config
-        if: steps.check-iterations.outputs.skip != 'true'
-        env:
-          GH_TOKEN: ${{ secrets.CROSS_REPO_PAT }}
-        run: |
-          mkdir -p ~/.claude
-          gh api repos/drewster99/dev-ops/contents/claude-rules/base.md \
-            --jq '.content' | base64 -d > ~/.claude/CLAUDE.md
-          echo "" >> ~/.claude/CLAUDE.md
-          gh api repos/drewster99/dev-ops/contents/claude-rules/ci.md \
-            --jq '.content' | base64 -d >> ~/.claude/CLAUDE.md
-
-      - name: Self-review and fix
-        if: steps.check-iterations.outputs.skip != 'true'
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          prompt: |
-            Self-review pass ${{ steps.check-iterations.outputs.review_count }} of 3.
-
-            You opened this PR. Review your own work before a human sees it.
-
-            1. Re-read every changed file. Check for bugs, edge cases, missing error handling.
-            2. Verify code style matches CLAUDE.md and existing patterns in this repo.
-            3. Look for security issues (injection, hardcoded secrets, unsafe operations).
-            4. If you find problems, fix them and push to this branch.
-            5. After fixing, re-review your fixes.
-            6. Add a PR comment starting with "Self-review pass N:" summarizing findings and any fixes made.
-            7. If everything looks clean, say so. Don't make changes for the sake of making changes.

xcode_mcp_server-1.3.15/CLAUDE.md

@@ -1,220 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is the Xcode MCP Server - a Model Context Protocol (MCP) server that enables AI assistants to interact with Xcode projects. It provides tools for building, running, and managing Xcode projects/workspaces programmatically through AppleScript.
-
-## Development Commands
-
-### Local Development
-```bash
-# Quick start with dev script (sets up conda env and runs MCP Inspector)
-./dev.sh
-
-# Manual setup: Test the server locally with MCP Inspector
-export XCODEMCP_ALLOWED_FOLDERS=/Users/username/Projects
-mcp dev xcode_mcp_server/__main__.py
-
-# Run the server directly
-python -m xcode_mcp_server
-```
-
-### Testing in-progress changes through the real MCP path
-
-Two MCP servers are registered against this repo:
-
-- **`xcode-mcp-server`** — the *deployed* build (`uvx xcode-mcp-server==<version>`).
-  It runs the published PyPI/beta release, NOT your working tree. Editing source
-  here does nothing to it until you `./deploy.sh` and switch versions.
-- **`xcode-mcp-local-dev-server`** — runs your **live local source** via
-  `run_local_for_claude.sh` (`cd` into the repo, then `python -m xcode_mcp_server`).
-  Use this to test uncommitted changes without deploying. (Note: the canonical
-  repo path `~/cursor/xcode-mcp-server` and `~/Documents/ncc_source/cursor/xcode-mcp-server`
-  are the same directory via symlink.)
-
-**Critical freshness rule:** a Claude instance spawns the dev-server process once,
-when it first connects, and Python imports each module once per process. So the
-dev-server bound to a *running* Claude session is **frozen at that session's
-start** — editing source afterward does NOT update it. Per-tool-call does not
-re-import; only a brand-new server process picks up edits.
-
-To test the latest source after editing, pick one:
-
-1. **Spawn a fresh Claude instance from bash** (best for end-to-end MCP-path
-   testing — each invocation starts its own dev-server process = current source):
-   ```bash
-   claude -p "Call mcp__xcode-mcp-local-dev-server__list_project_tests with
-   project_path=... and report the result verbatim." \
-     --allowedTools "mcp__xcode-mcp-local-dev-server__list_project_tests"
-   ```
-2. **Call the tool function directly via `python3 -c`** (fastest for iterating on
-   tool logic; imports fresh source each run, but bypasses FastMCP/serialization):
-   ```bash
-   python3 -c "
-   import xcode_mcp_server.security as sec
-   sec.ALLOWED_FOLDERS = {'/path/allowed'}
-   from xcode_mcp_server.tools.<tool_module> import <tool_fn>
-   fn = getattr(<tool_fn>, 'fn', <tool_fn>)   # unwrap the FastMCP tool
-   print(fn('/path/to/Project.xcodeproj'))
-   "
-   ```
-
-Do NOT trust the dev-server tools exposed in your *current* session to reflect
-edits you just made — they reflect the source as of when this session connected.
-
-**Confirming the running server matches your edits.** When running from a source
-checkout, the `version` tool appends a source fingerprint, e.g.
-`Xcode MCP Server version 1.3.14b1 (dev source e5f07eab)`. The hash is a SHA-256
-of all `.py` files in the package, computed at import — so it identifies the
-source the process actually loaded. Deployed (uvx) builds have no `.git` and omit
-the suffix. To verify a server is running your current code, compare its reported
-hash to the on-disk hash:
-```bash
-python3 -c "
-import hashlib, os
-d = hashlib.sha256()
-for root, dirs, files in os.walk('xcode_mcp_server'):
-    dirs[:] = sorted(x for x in dirs if x != '__pycache__')
-    for n in sorted(files):
-        if n.endswith('.py'):
-            with open(os.path.join(root, n), 'rb') as h: d.update(h.read())
-print(d.hexdigest()[:8])
-"
-```
-If the `version` tool's hash differs from this, the server is running stale code
-(start a fresh Claude instance). If they match, it is your current source.
-
-### Testing
-```bash
-# Run tests using the test runner framework
-python tests/test_basic.py      # Basic functionality tests
-python tests/test_build.py      # Build operation tests
-python tests/test_runner.py     # Test infrastructure
-
-# Tests automatically:
-# - Set up isolated working directory (test_projects/working/)
-# - Copy template projects from test_projects/templates/
-# - Configure ALLOWED_FOLDERS to working directory
-# - Clean up after execution
-```
-
-### Build and Deploy
-```bash
-# Deploy to PyPI (increments version, builds, and uploads)
-./deploy.sh
-
-# Manual version increment
-hatch version patch  # 1.2.0 -> 1.2.1
-hatch version minor  # 1.2.0 -> 1.3.0
-hatch version major  # 1.2.0 -> 2.0.0
-
-# Build distribution manually
-python -m build
-
-# Install locally for testing
-pip install -e .
-```
-
-### Testing with uvx
-```bash
-# Run the published version
-uvx xcode-mcp-server
-
-# Run with specific allowed folders
-XCODEMCP_ALLOWED_FOLDERS=/path/to/projects uvx xcode-mcp-server
-```
-
-## Architecture
-
-### Core Components
-
-1. **Main Entry Point** (`xcode_mcp_server/__init__.py`)
-   - Handles command-line argument parsing
-   - Manages allowed folder configuration from environment and CLI args
-   - Validates security settings before server startup
-
-2. **MCP Server Implementation** (`xcode_mcp_server/server.py` and `xcode_mcp_server/tools/`)
-   - Built with FastMCP framework
-   - Implements 24 MCP tools for Xcode interaction:
-     - **Project discovery**: `version`, `get_xcode_projects`
-     - **File system**: `get_directory_tree`, `get_directory_listing`
-     - **Build operations**: `get_project_schemes`, `build_project`, `clean_project`, `stop_project`, `get_build_errors`
-     - **Runtime**: `run_project_with_user_interaction`, `run_project_until_terminated`, `run_project_unmonitored`, `get_runtime_output`
-     - **Testing**: `list_project_tests`, `run_project_tests`, `get_latest_test_results`
-     - **Screenshots**: `take_xcode_screenshot`, `take_simulator_screenshot`, `take_window_screenshot`, `take_app_screenshot`
-     - **System info**: `list_booted_simulators`, `list_running_mac_apps`, `list_mac_app_windows`
-     - **Debug**: `debug_list_notification_history`
-
-### Security Model
-
-The server implements path-based security:
-- **ALLOWED_FOLDERS**: Set of validated absolute paths where access is permitted
-- Paths are validated for: absolute paths, existence, directory type, no '..' components
-- Default to $HOME if no folders specified
-- Every tool call validates the project path against allowed folders
-
-### AppleScript Integration
-
-All Xcode interactions use AppleScript via `osascript`:
-- Opens projects/workspaces in Xcode
-- Waits for workspace loading (60-second timeout)
-- Handles build/run/clean operations
-- Extracts build errors from Xcode's UI
-
-### Error Handling
-
-Custom exception hierarchy:
-- `XCodeMCPError`: Base exception class
-- `AccessDeniedError`: Path access violations
-- `InvalidParameterError`: Invalid input parameters
-
-## Key Implementation Details
-
-- **Notifications**: Optional macOS notifications for tool invocations (--show-notifications flag)
-- **Scheme Handling**: Active scheme detection with fallback to scheme list
-- **Build Output**: Captures first 25 lines of build errors for concise feedback
-- **Path Normalization**: Removes trailing slashes, validates absolute paths
-- **Spotlight Integration**: Uses `mdfind` for efficient project discovery across allowed folders
-
-## Version Management
-
-Version is stored in `xcode_mcp_server/__init__.py` and managed by hatch. The `deploy.sh` script automatically increments the patch version, but you can manually control it with:
-```bash
-hatch version patch  # Increment patch version
-hatch version minor  # Increment minor version
-hatch version major  # Increment major version
-```
-
-## Important Implementation Details
-
-### Internal Helper Functions
-- **`get_frontmost_project()`**: Not exposed as MCP tool; retrieves the currently open Xcode project path from frontmost window
-- **`extract_console_logs_from_xcresult()`**: Parses .xcresult bundles to extract runtime console output as structured JSON
-- **`extract_build_errors_and_warnings()`**: Filters build logs to show only errors/warnings as structured JSON (configurable via `include_warnings` parameter)
-- **`extract_test_results_from_xcresult()`**: Parses .xcresult test bundles to extract concise test results with failure details
-- **`wait_for_xcresult_after_timestamp()`**: Polls for new .xcresult files after a run starts, with timeout
-- **`find_xcresult_for_project()`**: Locates the most recent .xcresult bundle for a project (runtime logs)
-- **`find_xcresult_bundle()`**: Locates the most recent .xcresult bundle for a project (test logs)
-- **`validate_and_normalize_project_path()`**: Ensures paths are absolute, exist, and are allowed by security policy
-- **`escape_applescript_string()`**: Properly escapes strings for safe AppleScript execution
-
-### Operational Behavior
-- **Scheme Selection**: When no scheme is specified in `build_project`, the active scheme is used automatically
-- **Debug Output**: Server prints debug information to stderr for troubleshooting
-- **Workspace Loading**: All operations wait for Xcode workspace to fully load before proceeding (60-second timeout)
-- **Build Log Filtering**: Build failures return structured JSON with errors/warnings (up to 25 lines) and full log path
-- **Test Result Filtering**: Test results return structured JSON with summary and only failed test details; passing tests are counted but not detailed
-- **Warning Control**: Global `BUILD_WARNINGS_ENABLED` and `BUILD_WARNINGS_FORCED` flags control warning display; can be overridden per-tool with `include_warnings` parameter
-- **Notifications**: Optional macOS notifications via `osascript` (controlled by `NOTIFICATIONS_ENABLED` global flag)
-
-### xcresult Management
-The server relies heavily on Xcode's .xcresult bundles for extracting build, runtime, and test information:
-- **Runtime logs**: Located in `~/Library/Developer/Xcode/DerivedData/*/Logs/Launch/`
-- **Test results**: Located in `~/Library/Developer/Xcode/DerivedData/*/Logs/Test/`
-- Parsed using `xcrun xcresulttool` with appropriate subcommands
-- Timestamped checking prevents reading stale results
-- **Runtime output**: Console logs extracted from `actionsInvocationRecord` → `actions` → `actionResult` → `logRef` paths, returned as structured JSON with errors/warnings prioritized
-- **Test results**: Test tree parsed recursively to extract pass/fail counts and failure details, returned as concise structured JSON (10-50x smaller than raw xcresult output)
-- **Build errors**: Filtered using regex patterns, returned as structured JSON with full log path for deep analysis