Trolql

[pelikhan]

/scout investigate integrating trolql into a AW

https://www.troql.com/docs

[github-actions]

🔍 Scout Research Report

Triggered by @pelikhan

Executive Summary

Troql (troql.com) is a code understanding and risk analysis tool with the tagline "Understand Code Before You Break It." It builds a structural understanding layer over repositories to help developers and AI agents safely explore, analyze, and modify complex codebases. However, no public API, SDK, or GitHub Action was found during research — Troql currently appears to be a web-only tool requiring GitHub OAuth, which is the primary blocker for direct AW integration.

---

What Troql Does

Troql provides three core capabilities:

Capability	Description
Risk Assessment	Identifies which files are risky to change and why
Impact Analysis	Shows what parts of the system are likely affected by a change
Entry Points	Suggests lower-risk starting places for making changes

It is explicitly designed as:

• A decision-support tool for engineers (not an AI assistant or code editor)
• A way to reduce blast radius before committing changes
• A second opinion tool for pre-change analysis

It targets use cases like onboarding onto unfamiliar repos, working with legacy code, and making changes under time pressure — a natural fit for AI agent workflows.

Integration Assessment for AW

What Would Integration Look Like?

If Troql exposed a REST API or GitHub Action, AW could use it to:

1. Pre-PR risk gate — Before merging, automatically analyze changed files and surface high-risk signals as PR comments
2. AI agent pre-flight — Feed Troql risk/impact data to agents (e.g., Scout, or code-modifying agents) before they make changes
3. Review triage — Prioritize human review effort by flagging high-risk file changes
4. Change summary enrichment — Attach structural impact context to PR descriptions automatically

Current Blockers

• No public API found — Troql's docs page (troql.com/docs) returned no content during crawl
• No GitHub Action published — GitHub Marketplace search returned zero results for Troql
• Web-only with GitHub OAuth — The current flow requires interactive browser auth to analyze a repo
• Enterprise page exists (troql.com/enterprise) — API access may be available for enterprise customers, but details are not public

Recommendations

1. Contact Troql directly — Reach out via troql.com/enterprise or their site contact to ask about API access or a GitHub Action offering; this is the fastest path forward
2. Watch for a public API/Action — The product is clearly designed with AI agents in mind ("developers and AI agents can safely explore..."), so a programmatic API seems likely on their roadmap
3. Defer integration for now — Without a REST API or Action, a meaningful AW integration isn't feasible without reverse-engineering their web flow (not recommended)
4. Consider alternatives in the meantime — Tools like Graphite's Stacking, CodeScene, or static call-graph analysis scripts could partially fill the gap if risk assessment is urgently needed

Key Sources

• Troql homepage — "Understand any codebase before you change it"
• [Troql demo]((troql.com/redacted) — Shows risk assessment in action on a real repo
• [Troql enterprise]((troql.com/redacted) — Potential API/integration path

References: §22761872539

🔭 Intelligence gathered by Scout · ◷