Skip to content

Document the new RDF endpoint and MCP tool#1119

Merged
jviotti merged 3 commits into
mainfrom
rdf-docs
Jul 10, 2026
Merged

Document the new RDF endpoint and MCP tool#1119
jviotti merged 3 commits into
mainfrom
rdf-docs

Conversation

@jviotti

@jviotti jviotti commented Jul 10, 2026

Copy link
Copy Markdown
Member

Signed-off-by: Juan Cruz Viotti jv@jviotti.com

Review in cubic

Signed-off-by: Juan Cruz Viotti <jv@jviotti.com>
@augmentcode

augmentcode Bot commented Jul 10, 2026

Copy link
Copy Markdown
🤖 Augment PR Summary

Summary: This PR documents the new Enterprise-only RDF promotion capability (JSON → JSON-LD/RDF) and its MCP equivalent.

Changes:

  • Added an /self/v1/api/schemas/rdf/{path} API section, including request shape (instance, flatten, context), output forms (expanded/flattened/compacted), and error codes
  • Updated commercial feature documentation to describe the Linked Data/RDF offering and link to the endpoint
  • Added an Enterprise feature bullet to the landing page highlighting JSON-LD/RDF promotion from validated instances

Technical Notes: The endpoint’s behavior is driven by x-jsonld-* annotations on the validating schema; remote JSON-LD contexts are explicitly not fetched.

🤖 Was this summary useful? React with 👍 or 👎

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

All reported issues were addressed across 3 files

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread docs/api.md Outdated

@augmentcode augmentcode Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

Comment thread docs/api.md Outdated
This endpoint is only available in the [Enterprise](commercial.md)
edition. Learn more about [commercial licensing](commercial.md).

*This endpoint takes a JSON instance as a request body, validates it against

@augmentcode augmentcode Bot Jul 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

docs/api.md:279 — This endpoint’s request body isn’t a raw JSON instance; it expects an envelope object with an instance property (plus optional flatten/context) per the published request schema. The current wording mirrors /evaluate and may mislead clients into POSTing the instance directly.

Severity: medium

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

Comment thread docs/api.md
jviotti added 2 commits July 10, 2026 17:27
Signed-off-by: Juan Cruz Viotti <jv@jviotti.com>
Signed-off-by: Juan Cruz Viotti <jv@jviotti.com>
@jviotti jviotti merged commit 6d778ac into main Jul 10, 2026
5 checks passed
@jviotti jviotti deleted the rdf-docs branch July 10, 2026 20:31

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Benchmark Index (community)

Details
Benchmark suite Current: ad469f1 Previous: 608acda Ratio
Add one schema (0 existing) 319 ms 306 ms 1.04
Add one schema (100 existing) 28 ms 23 ms 1.22
Add one schema (1000 existing) 85 ms 70 ms 1.21
Add one schema (10000 existing) 715 ms 600 ms 1.19
Update one schema (1 existing) 21 ms 16 ms 1.31
Update one schema (101 existing) 29 ms 23 ms 1.26
Update one schema (1001 existing) 86 ms 70 ms 1.23
Update one schema (10001 existing) 715 ms 599 ms 1.19
Cached rebuild (1 existing) 7 ms 5 ms 1.40
Cached rebuild (101 existing) 9 ms 6 ms 1.50
Cached rebuild (1001 existing) 29 ms 19 ms 1.53
Cached rebuild (10001 existing) 252 ms 162 ms 1.56
Index 100 schemas 551 ms 369 ms 1.49
Index 1000 schemas 1436 ms 1244 ms 1.15
Index 10000 schemas 13795 ms 11320 ms 1.22
Index 10000 schemas (custom meta-schema) 16631 ms 13541 ms 1.23
Index 10000 schemas ($ref fan-out) 16431 ms 13942 ms 1.18

This comment was automatically generated by workflow using github-action-benchmark.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Benchmark Index (enterprise)

Details
Benchmark suite Current: ad469f1 Previous: 608acda Ratio
Add one schema (0 existing) 412 ms 395 ms 1.04
Add one schema (100 existing) 121 ms 106 ms 1.14
Add one schema (1000 existing) 163 ms 160 ms 1.02
Add one schema (10000 existing) 822 ms 792 ms 1.04
Update one schema (1 existing) 99 ms 97 ms 1.02
Update one schema (101 existing) 106 ms 104 ms 1.02
Update one schema (1001 existing) 164 ms 161 ms 1.02
Update one schema (10001 existing) 834 ms 796 ms 1.05
Cached rebuild (1 existing) 9 ms 8 ms 1.13
Cached rebuild (101 existing) 11 ms 11 ms 1
Cached rebuild (1001 existing) 33 ms 31 ms 1.06
Cached rebuild (10001 existing) 269 ms 259 ms 1.04
Index 100 schemas 591 ms 498 ms 1.19
Index 1000 schemas 1629 ms 1630 ms 1.00
Index 10000 schemas 14092 ms 14430 ms 0.98
Index 10000 schemas (custom meta-schema) 17490 ms 17585 ms 0.99
Index 10000 schemas ($ref fan-out) 17248 ms 17055 ms 1.01

This comment was automatically generated by workflow using github-action-benchmark.

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.

1 participant