Skip to content

Add interactive mode#41

Merged
DenysKuchma merged 3 commits into
mainfrom
feature/doc-collector-interactive-mode
May 30, 2026
Merged

Add interactive mode#41
DenysKuchma merged 3 commits into
mainfrom
feature/doc-collector-interactive-mode

Conversation

@DenysKuchma
Copy link
Copy Markdown
Collaborator

Summary

This PR adds an interactive mode to doc-collector so page documentation can include verified UI behavior, not just static page structure.
The new mode explores selected interactions, captures state changes, and falls back safely to static documentation when interactive results are weak or unreliable.

What changed

  • added opt-in interactive mode for doc-collector
  • added deterministic interaction exploration for:
  • content/detail links
  • pagination
  • tab-like controls
  • meaningful buttons
  • added State Transitions output in page docs using a before -> action -> after format
  • added support for carrying interaction-discovered URLs into the crawl queue
  • added output normalization and coverage notes for weak or partial documentation
  • improved fallback behavior when interactive or schema generation fails
  • cleaned up the interactive implementation and removed legacy / dead code paths

@DenysKuchma DenysKuchma requested a review from DavertMik May 27, 2026 17:50
Copy link
Copy Markdown
Contributor

@DavertMik DavertMik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same for new features too.
See CLAUDE.md

Image

Regexes are fine for some quick wins but evaluating actions by categories is what LLM must do (it does it well). If a solution involves Regex - probably it is not a solution. It might be optimization but not a solution!

Comment thread boat/doc-collector/src/ai/documentarian.ts Outdated
@DenysKuchma DenysKuchma requested a review from DavertMik May 29, 2026 10:54
@DenysKuchma DenysKuchma merged commit 79ccdb3 into main May 30, 2026
1 of 2 checks passed
@DenysKuchma DenysKuchma deleted the feature/doc-collector-interactive-mode branch May 30, 2026 14:14
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