Investigation tracking service for AI-based debugging sessions. Captures facts, evidence, hypotheses, and findings during investigations for persistence and later review.

• Dual-Mode Operation: Local (embedded databases) or production (MongoDB + OAuth)
• MCP Integration: Model Context Protocol for Claude Code integration
• Investigation Tracking: Key investigations by Jira ticket ID
• Fact Recording: Log entries, query results, code paths, evidence, code commits
• Hypothesis Tracking: Decision tree with validation status and linked facts
• Document Storage: Markdown documents per investigation
• Web UI: Review investigations with tabbed detail view
• Multi-User Support: Teams, visibility controls, and role-based access

• Java 17+
• Maven 3.9+
• Docker (for MongoDB in production mode)

Local mode uses embedded databases with no external services required:

./scripts/run-local.sh

Default credentials: admin / password

Custom credentials:

LOCAL_USERNAME=myuser LOCAL_PASSWORD=mypass ./scripts/run-local.sh

Production mode uses MongoDB and stub authentication for development:

# Start MongoDB
docker-compose up -d

# Start server with user picker
./scripts/run-dev.sh

Log into the web UI, go to your Profile page, and expand the "MCP Token" section to reveal your token.

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "truth-teller": {
      "url": "http://localhost:4567/mcp",
      "headers": {
        "Authorization": "Bearer <your-mcp-token>"
      }
    }
  }
}

cp skills/*.md /path/to/project/.claude/commands/

/init-investigation https://axonify.atlassian.net/browse/CI-4126

truth_teller/
├── pom.xml
├── docker-compose.yml
├── scripts/                    # Build and run scripts
├── skills/                     # Claude Code skills
├── docs/                       # Documentation
└── src/
    ├── main/
    │   ├── java/.../truthteller/
    │   │   ├── api/            # REST API and Notes UI
    │   │   ├── auth/           # Authentication
    │   │   ├── config/         # Configuration
    │   │   ├── di/             # Guice modules
    │   │   ├── mcp/            # MCP handler and tools
    │   │   ├── model/          # Domain models
    │   │   ├── repository/     # Data access
    │   │   ├── service/        # Business logic
    │   │   └── util/           # Utilities
    │   └── resources/
    │       ├── templates/      # Thymeleaf templates
    │       └── public/         # Static assets (CSS, JS)
    └── test/                   # Unit tests

Code review documents are in docs/reviews/.

See DEVELOPMENT.md for the full configuration reference.

Internal use only.