# Pitfall Log

Project: Neal006/mcptail

Summary: Found 30 structured pitfall item(s), including 0 high/blocking item(s). Top priority: Installation risk - Installation risk requires verification.

## 1. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/Neal006/mcptail/issues/20

## 2. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/Neal006/mcptail/issues/13

## 3. Configuration risk - Configuration risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a configuration risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: capability.host_targets | https://github.com/Neal006/mcptail

## 4. Configuration risk - Configuration risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this configuration risk before relying on the project: Adapter: Cline
- User impact: Developers may misconfigure credentials, environment, or host setup: Adapter: Cline
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/8

## 5. Configuration risk - Configuration risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this configuration risk before relying on the project: Adapter: Windsurf
- User impact: Developers may misconfigure credentials, environment, or host setup: Adapter: Windsurf
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/6

## 6. Configuration risk - Configuration risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this configuration risk before relying on the project: Adapter: Zed
- User impact: Developers may misconfigure credentials, environment, or host setup: Adapter: Zed
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/7

## 7. Configuration risk - Configuration risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this configuration risk before relying on the project: Streamable HTTP / SSE transport capture
- User impact: Developers may misconfigure credentials, environment, or host setup: Streamable HTTP / SSE transport capture
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/18

## 8. Capability evidence risk - Capability evidence risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: README/documentation is current enough for a first validation pass.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: capability.assumptions | https://github.com/Neal006/mcptail

## 9. Runtime risk - Runtime risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a runtime risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/Neal006/mcptail/issues/11

## 10. Runtime risk - Runtime risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a runtime risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/Neal006/mcptail/issues/10

## 11. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this migration risk before relying on the project: Add GPT and Gemini input prices to pricing.json
- User impact: Developers may hit a documented source-backed failure mode: Add GPT and Gemini input prices to pricing.json
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/9

## 12. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this migration risk before relying on the project: Session diffing — compare two runs of the same server
- User impact: Developers may hit a documented source-backed failure mode: Session diffing — compare two runs of the same server
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/21

## 13. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this migration risk before relying on the project: mcptail clear — prune recorded sessions
- User impact: Developers may hit a documented source-backed failure mode: mcptail clear — prune recorded sessions
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/12

## 14. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a maintenance risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/Neal006/mcptail/issues/21

## 15. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a maintenance risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: evidence.maintainer_signals | https://github.com/Neal006/mcptail

## 16. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: no_demo
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: downstream_validation.risk_items | https://github.com/Neal006/mcptail

## 17. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: no_demo
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: risks.scoring_risks | https://github.com/Neal006/mcptail

## 18. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/Neal006/mcptail/issues/19

## 19. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/Neal006/mcptail/issues/18

## 20. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this capability risk before relying on the project: Export a captured call as a regression test
- User impact: Developers may hit a documented source-backed failure mode: Export a captured call as a regression test
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/20

## 21. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this capability risk before relying on the project: Session log rotation: cap per-session file size
- User impact: Developers may hit a documented source-backed failure mode: Session log rotation: cap per-session file size
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/13

## 22. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this capability risk before relying on the project: UI: keyboard navigation (j/k + enter) in the timeline
- User impact: Developers may hit a documented source-backed failure mode: UI: keyboard navigation (j/k + enter) in the timeline
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/15

## 23. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this capability risk before relying on the project: UI: light theme
- User impact: Developers may hit a documented source-backed failure mode: UI: light theme
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/11

## 24. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this capability risk before relying on the project: UI: search / filter in the timeline
- User impact: Developers may hit a documented source-backed failure mode: UI: search / filter in the timeline
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/10

## 25. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this conceptual risk before relying on the project: README translation: हिन्दी (hi)
- User impact: Developers may hit a documented source-backed failure mode: README translation: हिन्दी (hi)
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/17

## 26. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Project evidence flags a capability evidence risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/16

## 27. Runtime risk - Runtime risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this performance risk before relying on the project: Export a session as HAR
- User impact: Developers may hit a documented source-backed failure mode: Export a session as HAR
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/14

## 28. Runtime risk - Runtime risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this performance risk before relying on the project: OpenTelemetry exporter
- User impact: Developers may hit a documented source-backed failure mode: OpenTelemetry exporter
- Evidence: failure_mode_cluster:github_issue | https://github.com/Neal006/mcptail/issues/19

## 29. Maintenance risk - Maintenance risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: issue_or_pr_quality=unknown。
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: evidence.maintainer_signals | https://github.com/Neal006/mcptail

## 30. Maintenance risk - Maintenance risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: release_recency=unknown。
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: evidence.maintainer_signals | https://github.com/Neal006/mcptail