feat: add declared routing and better operation metadata

[yashmehrotra]

Add observable raw routes, streaming operations, custom media types, served-only entities, explicit route paths, and configurable lint rules

Description

Brief description of the changes in this PR.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Performance improvement
• Code refactoring

Testing

• Tests pass locally with my changes
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• I have tested the CLI with example data

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• Any dependent changes have been merged and published in downstream modules

Breaking Changes

If this is a breaking change, please describe the impact and migration path for existing users:

Additional Notes

Add any additional notes, screenshots, or context about the changes here.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: ea23f8a4-6391-43a4-be6b-13bbf87e2f2b

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Gavel summary

Source	Pass	Fail	Skip	Duration
(unknown)	0	0	1	-

Totals: 0 passed · 0 failed · 1 skipped · -

View full results

[github-actions]

Gavel summary

Source	Pass	Fail	Skip	Duration
ai	9	0	0	1ms
aichat	20	0	0	1ms
api	175	0	12	92ms
cache	28	0	0	141ms
clicky	98	0	0	12.5s
enitity	1	0	0	5.4s
entity	158	0	0	275ms
entitydemo	2	0	0	1ms
exec	129	0	1	10.6s
extensions	1	0	0	70.492µs
flags	24	0	0	1ms
formatters	66	0	0	56ms
github.com/flanksource/clicky	28	0	0	11.0s
github.com/flanksource/clicky/ai	10	0	0	-
github.com/flanksource/clicky/api	251	0	0	180ms
github.com/flanksource/clicky/api/tailwind	427	0	0	-
github.com/flanksource/clicky/cmd/clicky	10	0	0	-
github.com/flanksource/clicky/docs	19	0	0	-
github.com/flanksource/clicky/entity	132	0	0	-
github.com/flanksource/clicky/examples/enitity/internal/entitydemo	7	0	0	10ms
github.com/flanksource/clicky/exec	3	0	0	440ms
github.com/flanksource/clicky/flags	52	0	0	10ms
github.com/flanksource/clicky/formatters	75	0	1	30ms
github.com/flanksource/clicky/formatters/http	38	0	0	-
github.com/flanksource/clicky/formatters/pdf	0	0	1	-
github.com/flanksource/clicky/formatters/tests	201	0	2	20ms
github.com/flanksource/clicky/internal/gumchoose	2	0	0	-
github.com/flanksource/clicky/lint	13	0	0	-
github.com/flanksource/clicky/markdown	10	0	0	60ms
github.com/flanksource/clicky/mcp	102	0	0	3.4s
github.com/flanksource/clicky/middleware	31	0	0	-
github.com/flanksource/clicky/prompt	14	0	0	10ms
github.com/flanksource/clicky/route	12	0	0	10ms
github.com/flanksource/clicky/rpc	367	0	1	90ms
github.com/flanksource/clicky/rpc/http	8	0	0	10ms
github.com/flanksource/clicky/task	168	0	0	17.5s
http	4	0	0	2ms
lint	10	0	0	16.1s
markdown	4	0	0	62ms
metrics	7	0	0	1ms
middleware	38	0	0	14ms
process	6	0	0	383.367µs
rpc	12	0	0	26ms
task	56	0	0	2.3s
tests	11	0	47	16ms
text	78	0	0	312ms
valkey	46	0	0	341ms

Totals: 2963 passed · 0 failed · 65 skipped · 1m21s

View full results

[flankbot]

🎉 This PR is included in version 1.21.68