Skip to content

chore: fix outdated facts on the home page and in llms.txt, publish the 4.23.0 installer, add the 4.22/4.23 AI features to llms.txt - #1834

Merged
davsclaus merged 5 commits into
mainfrom
quick-fix/home-and-llms-facts
Oct 25, 2026
Merged

davsclaus merged 5 commits into
mainfrom
quick-fix/home-and-llms-facts

Conversation

@davsclaus

Copy link
Copy Markdown
Contributor

What this changes

Four commits, each can be reviewed on its own.

1. Outdated facts on the home page and in llms.txt

  • Home page: 280+ releases (282 release tags; the old 300+ counted RC and milestone tags), export to Maven only (Gradle export was removed in 4.19), and Camel Kafka Connector runs Kamelets as Kafka Connect connectors (same text on /projects/ and /docs/).
  • Footer: add the Camel CLI, write "Camel K", and link the /latest/ docs like the rest of the site.
  • llms.txt:
    • The Camel TUI is a developer tool, as its manual says, not for monitoring integrations in production.
    • Two broken links are fixed (the EIP index and OpenTelemetry, now opentelemetry2).
    • The llm: component works with any OpenAI-compatible API.
    • Small facts are corrected: median bug fix time of 1 day, the benchmark machine is a 64 GB Mac mini, most examples (not all) have a Citrus test, the core team share is 78-96% since 2009, Claus Ibsen is a committer since 2008, and only content pages have a Markdown version.

2. Installer manifests for 4.23.0, 4.22.2, 4.18.5, 4.18.4 and 4.14.9
The install command on the home page still installed 4.22.1. latest.properties now points to 4.23.0. The manifests were generated with update-camel-cli-manifest.sh, but from the camel-4.23.0 tag instead of main, because main's install.sh now says "Java 21+ required" (for 4.24). At the tag, install.sh, install.ps1 and the generator are byte-identical to the files already on the site, so only the manifests change.

3. llms.txt: AI features from Camel 4.22 and 4.23

  • A new section on semantic decisions with System One models:
    • the Semantic language, with Jev from TypeSafe AI and Wolf Defender as experts
    • audit
    • version notes for 4.23 and 4.24
    • a YAML example that validates with both versions
  • AI tools: the MCP Server component is Stable since 4.22, tools can return structured output, the AI Resource component exists, and camel-mcp-server-starter works on Spring Boot.
  • AI components:
    • the LangChain4j Agent component, and models configured with properties only
    • what the llm: component covers
    • the Spring AI 2.0 components
  • Also: camel run --observe, the documentation examples validated since 4.23, and the AGENTS.md file that camel export and the archetypes generate.
  • One entry for the four local model benchmark posts.

4. The Semantic language example in the 4.23 release post
It had no expert and put the instructions directly on the evaluation. It fails validation on main and would fail at startup on 4.23. It now follows the documented syntax.

How it was checked

  • node --test test/*-test.js: 23 tests pass. The changed data files parse as YAML.
  • Every new or changed link returns 200 on camel.apache.org.
  • The semantic YAML examples pass camel validate yaml on main and with --camel-version=4.23.0.
  • The facts were checked against the sources:
    • the Camel catalog and CLI source
    • the 4.19 upgrade guide
    • the TUI manual
    • the GitHub API (282 release tags)
    • Maven Central (camel-launcher 4.22.2 and 4.23.0 are published)

Not changed: the Camel Kit links. The move to apache/camel-kit is in progress.

🤖 Generated with Claude Code

https://claude.ai/code/session_01STT6whBgK1AqsSsUKrnE8m

davsclaus and others added 5 commits October 25, 2026 11:23
Home page and shared data:
- Release count: 280+ (282 release tags). The old 300+ counted RC and
  milestone tags.
- Export is to Maven only. Gradle export was removed in Camel 4.19.
- Camel Kafka Connector runs Kamelets as Kafka Connect connectors, not
  every Camel component (same text on /projects/ and /docs/).
- Footer: add the Camel CLI, write "Camel K", and link the /latest/ docs
  like the rest of the site.

llms.txt:
- The Camel TUI is a developer tool, as its manual says. It is not for
  monitoring integrations in production.
- Fix two broken links: the EIP index (404) and OpenTelemetry (now
  opentelemetry2).
- The llm: component works with any OpenAI-compatible API.
- Export is to Maven only, the median bug fix time is 1 day, the
  benchmark machine is a 64 GB Mac mini, most examples (not all) have a
  Citrus test, the core team share is 78-96% since 2009, Claus Ibsen is a
  committer since 2008, and only content pages have a Markdown version.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01STT6whBgK1AqsSsUKrnE8m
…5, 4.18.4 and 4.14.9

The installer on the home page (install.sh) still installed 4.22.1,
because latest.properties was not updated after 4.22.2 and 4.23.0.
latest.properties now points to 4.23.0.

Generated with update-camel-cli-manifest.sh, but with the sources taken
from the camel-4.23.0 tag instead of main: main's install.sh now says
"Java 21+ required" (for 4.24), which is wrong for 4.23. At the tag,
install.sh, install.ps1 and the manifest generator are byte-identical to
the files already on the site, so only the manifests change.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01STT6whBgK1AqsSsUKrnE8m
…ecisions with System One models

- New section "Semantic decisions with System One models": the Semantic
  language, Jev from TypeSafe AI as a System One model, Wolf Defender, the
  4.24 OpenAI decisions expert, audit, and version notes (the YAML syntax
  changed in 4.23, and 4.24 requires an expert on every evaluation and
  renames the provider modules). The YAML example validates with Camel
  4.23.0 and with main.
- AI tools: the MCP Server component is Stable since 4.22 and configured
  with camel.server.mcp-* properties, outputSchema for structured output,
  the AI Resource component, and camel-mcp-server-starter on Spring Boot.
- AI components: LangChain4j Agent and property-only model configuration,
  what the llm: component covers (moderation, Batch API, Responses API,
  token budget, rate-limit errors), and the Spring AI 2.0 components.
- camel run --observe, validated documentation examples since 4.23, and
  the AGENTS.md file from camel export and the Maven archetypes.
- One entry for the four local model benchmark posts instead of one per
  round.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01STT6whBgK1AqsSsUKrnE8m
The example had no expert and put instructions and criteria directly on
the evaluation. It fails validation against main, and in 4.23 an
evaluation without an expert fails at startup. It now names its expert
(and says how to register it) and puts instructions and criteria under
parameters, as the documentation shows. It validates with Camel 4.23.0
and with main.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01STT6whBgK1AqsSsUKrnE8m
The AI card said "40+ AI components" and links to the AI components
page, which lists 24 entries in the latest docs (4.22.x) and 26 in next.
The 40+ counted every component with the "ai" catalog label, including
cloud AI services that are not on that page.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01STT6whBgK1AqsSsUKrnE8m
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Preview is available at https://pr-1834--camel.netlify.app

@davsclaus
davsclaus merged commit f52bb32 into main Oct 25, 2026
2 checks passed
@davsclaus
davsclaus deleted the quick-fix/home-and-llms-facts branch October 25, 2026 11:43
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