Skip to content

Conversation

@dacharyc
Copy link
Collaborator

@dacharyc dacharyc commented Dec 12, 2025

Add a command to analyze custom composable tutorial definitions in snooty.toml files, and their usage across the docs. This can help us identify:

  • Unused composable definitions
  • Identical or similar composable definitions that should be consolidated
  • One-off composable definitions that may represent consolidation opportunities
  • Misused composable tutorial options

With this command, this is the third command that takes the monorepo root filepath as an argument, so I've also added a configuration system so writers can set this and the CLI can use it, simplifying writer usage. I've also added relative path handling for all commands for writers who set the monorepo root.

// - --for-project: Only analyze composables for a specific project
// - --current-only: Only analyze composables in current versions
// - --verbose: Show full option details with titles
// - --find-consolidation-candidates: Show identical and similar composables for consolidation
Copy link
Collaborator

Choose a reason for hiding this comment

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

this is a mouthful. could we shorten to something (e.g. --find-candidates, --find-similar, --find-dupes) or maybe allow an alternate -fcc

@dacharyc dacharyc merged commit dabb8a5 into main Dec 12, 2025
2 checks passed
@dacharyc dacharyc deleted the analyze-composables branch December 12, 2025 21:07
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.

3 participants