Skip to content

feat: use Mermaid index snapshots in TestCasesGenerator relevant-test search - #265

Open
IstiN wants to merge 203 commits into
mainfrom
feature/mermaid-index-for-test-cases-generator
Open

feat: use Mermaid index snapshots in TestCasesGenerator relevant-test search#265
IstiN wants to merge 203 commits into
mainfrom
feature/mermaid-index-for-test-cases-generator

Conversation

@IstiN

@IstiN IstiN commented Jun 12, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds optional Mermaid snapshot lookup to TestCasesGenerator so that large existingTestCasesJql result sets can be searched using compact Mermaid diagrams instead of full ticket text, reducing token consumption.

New params

  • mermaidIndexStoragePath — root of the Mermaid index output (e.g. separate repo checkout)
  • mermaidIndexIntegrationjira or jira_xray (default jira)
  • useMermaidSnapshotForGeneration — also use snapshots for generation (default false)

Behavior

  • Search phase (RelatedTestCasesAgent): uses snapshot text when available, falls back to full ticket text.
  • Verification (RelatedTestCaseAgent) and generation (TestCaseGeneratorAgent): keep using full ticket text by default.

Tests

  • MermaidSnapshotResolverTest
  • MermaidSnapshotTicketWrapperTest
  • TestCasesGeneratorMermaidSnapshotTest
  • Updated TestCasesGeneratorParamsTest
  • Full :dmtools-core:test passes.

Docs

Added "Mermaid Index Snapshot Lookup" sections to xray-manual.md and testrail-manual.md.

… search

Add optional mermaidIndexStoragePath / mermaidIndexIntegration /
useMermaidSnapshotForGeneration params to TestCasesGenerator.
When configured, existing test cases are represented by pre-built
Mermaid diagram snapshots during RelatedTestCasesAgent search,
reducing token usage for large existingTestCasesJql result sets.
Verification and generation keep using full ticket text by default.

- MermaidSnapshotResolver loads .mmd snapshots by ticket key
- MermaidSnapshotTicketWrapper overrides toText() with snapshot
- Tests and docs (xray/testrail manuals) updated
…rapping

- Document mermaidIndexStoragePath, mermaidIndexIntegration, and useMermaidSnapshotForGeneration in the main TestCasesGenerator reference.

- Add explicit boolean flag and comment in TestCasesGenerator so the parameter-based decision to wrap existing test cases is obvious.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants