This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cayenne-website.git
The following commit(s) were added to refs/heads/master by this push:
new 9a2a259ac latest agentic coding docs update
9a2a259ac is described below
commit 9a2a259acf4d4419015977fc180746d8c1c91f83
Author: Andrus Adamchik <[email protected]>
AuthorDate: Mon May 25 10:31:24 2026 -0400
latest agentic coding docs update
---
.../site/content/docs/5.0/cayenne-guide.toc.html | 5 +-
.../docs/5.0/cayenne-guide/additional-modules.html | 2 +-
.../docs/5.0/cayenne-guide/agentic-coding.html | 5 +-
.../content/docs/5.0/cayenne-guide/ant_tasks.html | 2 +-
.../apache-cayenne-claude-code-plugin.html | 41 +++
.../appendix-a-configuration-properties.html | 2 +-
.../appendix-b-service-collections.html | 2 +-
.../docs/5.0/cayenne-guide/build_tools.html | 2 +-
.../docs/5.0/cayenne-guide/cayenne-mcp-server.html | 292 +++++++++++++++++++++
.../docs/5.0/cayenne-guide/db-first-flow.html | 2 +-
.../5.0/cayenne-guide/ext-cache-invalidation.html | 2 +-
.../content/docs/5.0/cayenne-guide/ext-crypto.html | 2 +-
.../content/docs/5.0/cayenne-guide/ext-jcache.html | 2 +-
.../content/docs/5.0/cayenne-guide/ext-osgi.html | 2 +-
.../cayenne-guide/ext-project-compatibility.html | 2 +-
.../docs/5.0/cayenne-guide/ext-velocity.html | 2 +-
.../docs/5.0/cayenne-guide/gradle_plugin.html | 2 +-
.../docs/5.0/cayenne-guide/maven_plugin.html | 2 +-
.../content/docs/5.0/cayenne-guide/overview.html | 7 +-
.../docs/5.0/cayenne-guide/re-filtering.html | 2 +-
.../docs/5.0/cayenne-guide/re-introduction.html | 2 +-
.../content/docs/5.0/cayenne-guide/re-modeler.html | 2 +-
.../re-relationships-loading-control.html | 2 +-
23 files changed, 357 insertions(+), 29 deletions(-)
diff --git a/src/main/site/content/docs/5.0/cayenne-guide.toc.html
b/src/main/site/content/docs/5.0/cayenne-guide.toc.html
index bf6731c5f..222b61f24 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide.toc.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide.toc.html
@@ -25,9 +25,8 @@
<li><a href="/docs/5.0/cayenne-guide/agentic-coding" class="nav-link"
id="agentic-coding">3. Agentic Coding</a>
<ul class="sectlevel2 nav">
<li><a href="/docs/5.0/cayenne-guide/overview" class="nav-link"
id="overview">3.1. Overview</a></li>
- <li><a
href="/docs/5.0/cayenne-guide/installing-apache-cayenne-plugin-claude-code"
class="nav-link" id="installing-apache-cayenne-plugin-claude-code">3.2.
Installing <code>apache-cayenne</code> Plugin (Claude Code)</a></li>
- <li><a href="/docs/5.0/cayenne-guide/installing-the-cayenne-mcp-server"
class="nav-link" id="installing-the-cayenne-mcp-server">3.3. Installing the
Cayenne MCP Server</a></li>
- <li><a href="/docs/5.0/cayenne-guide/mcp-tools" class="nav-link"
id="mcp-tools">3.4. MCP Tools</a></li>
+ <li><a href="/docs/5.0/cayenne-guide/apache-cayenne-claude-code-plugin"
class="nav-link" id="apache-cayenne-claude-code-plugin">3.2.
<code>apache-cayenne</code> Claude Code Plugin</a></li>
+ <li><a href="/docs/5.0/cayenne-guide/cayenne-mcp-server" class="nav-link"
id="cayenne-mcp-server">3.3. Cayenne MCP Server</a></li>
</ul></li>
<li><a href="/docs/5.0/cayenne-guide/db-first-flow" class="nav-link"
id="db-first-flow">4. DB-First Flow</a>
<ul class="sectlevel2 nav">
diff --git
a/src/main/site/content/docs/5.0/cayenne-guide/additional-modules.html
b/src/main/site/content/docs/5.0/cayenne-guide/additional-modules.html
index 33181081e..6488fe666 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/additional-modules.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/additional-modules.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Additional Modules"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 260
+weight: 250
---
<div><h2>5. Additional Modules</h2>
<div id="index-section-toc"><ul>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/agentic-coding.html
b/src/main/site/content/docs/5.0/cayenne-guide/agentic-coding.html
index c550d03af..2db208fb3 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/agentic-coding.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/agentic-coding.html
@@ -26,7 +26,6 @@ weight: 160
<div><h2>3. Agentic Coding</h2>
<div id="index-section-toc"><ul>
<li><a href="/docs/5.0/cayenne-guide/overview">3.1. Overview</a>
-<li><a
href="/docs/5.0/cayenne-guide/installing-apache-cayenne-plugin-claude-code">3.2.
Installing apache-cayenne Plugin (Claude Code)</a>
-<li><a href="/docs/5.0/cayenne-guide/installing-the-cayenne-mcp-server">3.3.
Installing the Cayenne MCP Server</a>
-<li><a href="/docs/5.0/cayenne-guide/mcp-tools">3.4. MCP Tools</a>
+<li><a href="/docs/5.0/cayenne-guide/apache-cayenne-claude-code-plugin">3.2.
apache-cayenne Claude Code Plugin</a>
+<li><a href="/docs/5.0/cayenne-guide/cayenne-mcp-server">3.3. Cayenne MCP
Server</a>
</ul></div></div>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/ant_tasks.html
b/src/main/site/content/docs/5.0/cayenne-guide/ant_tasks.html
index 3c9c44090..ee192f6b7 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/ant_tasks.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/ant_tasks.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Ant Tasks"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 360
+weight: 350
---
<div class="sect2">
<h3 id="ant_tasks"><a class="anchor" href="#ant_tasks"></a>6.3. Ant Tasks</h3>
diff --git
a/src/main/site/content/docs/5.0/cayenne-guide/apache-cayenne-claude-code-plugin.html
b/src/main/site/content/docs/5.0/cayenne-guide/apache-cayenne-claude-code-plugin.html
new file mode 100644
index 000000000..8012e95ad
--- /dev/null
+++
b/src/main/site/content/docs/5.0/cayenne-guide/apache-cayenne-claude-code-plugin.html
@@ -0,0 +1,41 @@
+---
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+title: "Cayenne Guide 5.0 · apache-cayenne Claude Code Plugin"
+description: "Cayenne Guide 5.0, apache-cayenne Claude Code Plugin"
+cayenneVersion: "5.0"
+cayenneNoToc: true
+docId: cayenne-guide
+weight: 180
+---
+<div class="sect2">
+ <h3 id="apache-cayenne-claude-code-plugin"><a class="anchor"
href="#apache-cayenne-claude-code-plugin"></a>3.2. <code>apache-cayenne</code>
Claude Code Plugin</h3>
+ <div class="paragraph">
+ <p>(Claude Code specific) Install the <code>apache-cayenne</code> plugin
with Cayenne skills under Claude Code:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlight"><code class="language-bash bash"
data-lang="bash">/plugin marketplace add apache/cayenne
+/plugin install apache-cayenne@apache-cayenne
+/reload-plugins</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>The plugin adds skills for DataMap editing, class generation, reverse
engineering, query writing, and runtime setup. The skills work best with the
MCP server present (see the next chapter).</p>
+ </div>
+</div>
\ No newline at end of file
diff --git
a/src/main/site/content/docs/5.0/cayenne-guide/appendix-a-configuration-properties.html
b/src/main/site/content/docs/5.0/cayenne-guide/appendix-a-configuration-properties.html
index 73a0d5631..2e0e1c31c 100644
---
a/src/main/site/content/docs/5.0/cayenne-guide/appendix-a-configuration-properties.html
+++
b/src/main/site/content/docs/5.0/cayenne-guide/appendix-a-configuration-properties.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Appendix A. Configuration
Properties"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 370
+weight: 360
---
<div class="sect1">
<h2 id="appendix-a-configuration-properties"><a class="anchor"
href="#appendix-a-configuration-properties"></a>7. Appendix A. Configuration
Properties</h2>
diff --git
a/src/main/site/content/docs/5.0/cayenne-guide/appendix-b-service-collections.html
b/src/main/site/content/docs/5.0/cayenne-guide/appendix-b-service-collections.html
index 913e2fe0c..0860c1324 100644
---
a/src/main/site/content/docs/5.0/cayenne-guide/appendix-b-service-collections.html
+++
b/src/main/site/content/docs/5.0/cayenne-guide/appendix-b-service-collections.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Appendix B. Service
Collections"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 380
+weight: 370
---
<div class="sect1">
<h2 id="appendix-b-service-collections"><a class="anchor"
href="#appendix-b-service-collections"></a>8. Appendix B. Service
Collections</h2>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/build_tools.html
b/src/main/site/content/docs/5.0/cayenne-guide/build_tools.html
index 993963b6c..8181ea994 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/build_tools.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/build_tools.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Build Tools"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 330
+weight: 320
---
<div><h2>6. Build Tools</h2>
<div id="index-section-toc"><ul>
diff --git
a/src/main/site/content/docs/5.0/cayenne-guide/cayenne-mcp-server.html
b/src/main/site/content/docs/5.0/cayenne-guide/cayenne-mcp-server.html
new file mode 100644
index 000000000..b551745df
--- /dev/null
+++ b/src/main/site/content/docs/5.0/cayenne-guide/cayenne-mcp-server.html
@@ -0,0 +1,292 @@
+---
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+title: "Cayenne Guide 5.0 · Cayenne MCP Server"
+description: "Cayenne Guide 5.0, Cayenne MCP Server"
+cayenneVersion: "5.0"
+cayenneNoToc: true
+docId: cayenne-guide
+weight: 190
+---
+<div class="sect2">
+ <h3 id="cayenne-mcp-server"><a class="anchor"
href="#cayenne-mcp-server"></a>3.3. Cayenne MCP Server</h3>
+ <div class="paragraph">
+ <p>The MCP server is a self-contained, stdio-based process that the AI agent
launches on demand. It works with most agents (not only Claude). The MCP server
is bundled with the platform-specific CayenneModeler and requires Java 21 or
later on the system <code>PATH</code>. So to get it, first download the Modeler
at <a href="https://cayenne.apache.org/download/";
class="bare">https://cayenne.apache.org/download/</a> .</p>
+ </div>
+ <div class="paragraph">
+ <p>MCP runnable jar is <code>CayenneMCPServer.jar</code>. Its location is
OS-dependent (you will need this location in the next step):</p>
+ </div>
+ <div class="paragraph">
+ <p>Mac:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlight"><code># <install-dir> is typically
"/Applications", but it can be any other directory
+<install-dir>/CayenneModeler.app/Contents/Resources/mcp/CayenneMCPServer.jar</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>Windows:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre
class="highlight"><code><install-dir>\bin\CayenneMCPServer.jar</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>Linux / cross-platform:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre
class="highlight"><code><install-dir>/bin/CayenneMCPServer.jar</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>When installing the MCP, replace
<code>/path/to/CayenneMCPServer.jar</code> mentioned in the instructions with
the actual jar path:</p>
+ </div>
+ <div class="sect3">
+ <h4 id="installing-on-claude-code"><a class="anchor"
href="#installing-on-claude-code"></a>3.3.1. Installing on Claude Code</h4>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlight"><code class="language-bash bash" data-lang="bash">#
Register the MCP server (--scope user makes it available across all projects)
+claude mcp add cayenne --scope user -- java -jar /path/to/CayenneMCPServer.jar
+
+# Verify it is connected
+claude mcp list</code></pre>
+ </div>
+ </div>
+ </div>
+ <div class="sect3">
+ <h4 id="installing-on-cursor"><a class="anchor"
href="#installing-on-cursor"></a>3.3.2. Installing on Cursor</h4>
+ <div class="paragraph">
+ <p>Edit <code>~/.cursor/mcp.json</code> (global, all projects) or
<code>.cursor/mcp.json</code> in your project (per-project):</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlight"><code class="language-json json" data-lang="json">{
+ "mcpServers": {
+ "cayenne": {
+ "command": "java",
+ "args": ["-jar", "/path/to/CayenneMCPServer.jar"]
+ }
+ }
+}</code></pre>
+ </div>
+ </div>
+ </div>
+ <div class="sect3">
+ <h4 id="installing-on-codex"><a class="anchor"
href="#installing-on-codex"></a>3.3.3. Installing on Codex</h4>
+ <div class="paragraph">
+ <p>Add a <code>[mcp_servers.cayenne]</code> entry to
<code>~/.codex/config.toml</code>:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlight"><code class="language-toml toml"
data-lang="toml">[mcp_servers.cayenne]
+command = "java"
+args = ["-jar", "/path/to/CayenneMCPServer.jar"]</code></pre>
+ </div>
+ </div>
+ </div>
+ <div class="sect3">
+ <h4 id="available-mcp-tools"><a class="anchor"
href="#available-mcp-tools"></a>3.3.4. Available MCP Tools</h4>
+ <div class="paragraph">
+ <p>The server exposes three tools. Your agent will discover them on its
own, but it is useful to understand the capabilities and possible prompts. All
tools operate on a Cayenne project descriptor (a <code>cayenne-*.xml</code>
file) and take absolute paths — agents should resolve relative paths against
the current workspace before invoking.</p>
+ </div>
+ <div class="paragraph">
+ <p>If you are using the <code>apache-cayenne</code> Claude Code plugin, its
skills (<code>cayenne-cgen</code>, <code>cayenne-modeler</code>,
<code>cayenne-db-import</code>) call these tools automatically. You can verify
the server is available with <code>claude mcp list</code> — look for an entry
named <code>cayenne</code>.</p>
+ </div>
+ <div class="sect4">
+ <h5 id="open_project"><a class="anchor" href="#open_project"></a>3.3.4.1.
open_project</h5>
+ <div class="paragraph">
+ <p>Launches CayenneModeler with the given project file pre-loaded. The
call is non-blocking; the server waits for the Modeler to confirm a successful
project load via a short startup handshake, then returns.</p>
+ </div>
+ <table class="tableblock frame-all grid-all stretch">
+ <caption class="title">
+ Table 4. Parameters
+ </caption>
+ <colgroup>
+ <col style="width: 20%;">
+ <col style="width: 20%;">
+ <col style="width: 60%;">
+ </colgroup>
+ <thead>
+ <tr>
+ <th class="tableblock halign-left valign-top">Name</th>
+ <th class="tableblock halign-left valign-top">Required</th>
+ <th class="tableblock halign-left valign-top">Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock"><code>projectPath</code></p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">yes</p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">Absolute path to the top-level Cayenne project
descriptor (<code>cayenne-*.xml</code>).</p></td>
+ </tr>
+ </tbody>
+ </table>
+ <div class="paragraph">
+ <p>In most cases your agent knows where the project is, so a typical
prompt that triggers this tool is just this:</p>
+ </div>
+ <div class="quoteblock">
+ <blockquote>
+ <div class="paragraph">
+ <p>open my Cayenne project in the Modeler</p>
+ </div>
+ </blockquote>
+ </div>
+ <div class="paragraph">
+ <p>Though you can be more specific and indicate the exact project to
open:</p>
+ </div>
+ <div class="quoteblock">
+ <blockquote>
+ <div class="paragraph">
+ <p>open the Cayenne project at @/path/to/cayenne-project.xml in the
Modeler.</p>
+ </div>
+ </blockquote>
+ </div>
+ </div>
+ <div class="sect4">
+ <h5 id="cgen_run"><a class="anchor" href="#cgen_run"></a>3.3.4.2.
cgen_run</h5>
+ <div class="paragraph">
+ <p>Runs the Cayenne class generator (<code>cgen</code>) for a single
DataMap inside the project, using the <code>cgen</code> configuration stored in
the DataMap XML. The tool returns a JSON report describing which files were
written, which were already up-to-date, and any errors encountered.</p>
+ </div>
+ <table class="tableblock frame-all grid-all stretch">
+ <caption class="title">
+ Table 5. Parameters
+ </caption>
+ <colgroup>
+ <col style="width: 20%;">
+ <col style="width: 20%;">
+ <col style="width: 60%;">
+ </colgroup>
+ <thead>
+ <tr>
+ <th class="tableblock halign-left valign-top">Name</th>
+ <th class="tableblock halign-left valign-top">Required</th>
+ <th class="tableblock halign-left valign-top">Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock"><code>projectPath</code></p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">yes</p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">Absolute path to the top-level Cayenne project
descriptor (<code>cayenne-*.xml</code>), not a DataMap file.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock"><code>dataMap</code></p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">yes</p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">Name of the target DataMap as it appears in the
<code><map name='…'></code> element of the project descriptor.</p></td>
+ </tr>
+ </tbody>
+ </table>
+ <div class="paragraph">
+ <p>A typical agent prompt that triggers this tool:</p>
+ </div>
+ <div class="quoteblock">
+ <blockquote>
+ <div class="paragraph">
+ <p>regenerate Java classes for the <code>MyDataMap</code> DataMap in
<code>/path/to/cayenne-project.xml</code>.</p>
+ </div>
+ </blockquote>
+ </div>
+ <div class="paragraph">
+ <p>Or if you only have one project and one DataMap:</p>
+ </div>
+ <div class="quoteblock">
+ <blockquote>
+ <div class="paragraph">
+ <p>regenerate Java classes from Cayenne model</p>
+ </div>
+ </blockquote>
+ </div>
+ </div>
+ <div class="sect4">
+ <h5 id="dbimport_run"><a class="anchor" href="#dbimport_run"></a>3.3.4.3.
dbimport_run</h5>
+ <div class="paragraph">
+ <p>Runs Cayenne reverse engineering (dbimport) for a single DataMap inside
the project. The tool reads the JDBC connection from CayenneModeler preferences
on the local machine (the agent doesn’t see the credentials). If the DataMap
has a <code><reverse-engineering></code> block its filters are applied;
otherwise the full database schema is imported. The DataMap XML is rewritten on
disk with the merged schema, and a JSON summary of what changed is returned.</p>
+ </div>
+ <div class="paragraph">
+ <p>If no connection has been saved yet
(<code>dbconnector_not_configured</code> error), open the project in the
Modeler with <code>open_project</code>, run the dialog once to save the
connection, then call <code>dbimport_run</code> again.</p>
+ </div>
+ <table class="tableblock frame-all grid-all stretch">
+ <caption class="title">
+ Table 6. Parameters
+ </caption>
+ <colgroup>
+ <col style="width: 20%;">
+ <col style="width: 20%;">
+ <col style="width: 60%;">
+ </colgroup>
+ <thead>
+ <tr>
+ <th class="tableblock halign-left valign-top">Name</th>
+ <th class="tableblock halign-left valign-top">Required</th>
+ <th class="tableblock halign-left valign-top">Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock"><code>projectPath</code></p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">yes</p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">Absolute path to the top-level Cayenne project
descriptor (<code>cayenne-*.xml</code>), not a DataMap file.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock"><code>dataMap</code></p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">yes</p></td>
+ <td class="tableblock halign-left valign-top">
+ <p class="tableblock">Name of the target DataMap as it appears in the
<code><map name='…'></code> element of the project descriptor.</p></td>
+ </tr>
+ </tbody>
+ </table>
+ <div class="paragraph">
+ <p>A typical agent prompt that triggers this tool:</p>
+ </div>
+ <div class="quoteblock">
+ <blockquote>
+ <div class="paragraph">
+ <p>sync the Cayenne model with the database</p>
+ </div>
+ </blockquote>
+ </div>
+ <div class="paragraph">
+ <p>Or more specifically:</p>
+ </div>
+ <div class="quoteblock">
+ <blockquote>
+ <div class="paragraph">
+ <p>re-import the <code>MyDataMap</code> schema from the database into
<code>/path/to/cayenne-project.xml</code></p>
+ </div>
+ </blockquote>
+ </div>
+ </div>
+ </div>
+</div>
\ No newline at end of file
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/db-first-flow.html
b/src/main/site/content/docs/5.0/cayenne-guide/db-first-flow.html
index 03c6062e4..6b8d7b428 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/db-first-flow.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/db-first-flow.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, DB-First Flow"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 210
+weight: 200
---
<div><h2>4. DB-First Flow</h2>
<div id="index-section-toc"><ul>
diff --git
a/src/main/site/content/docs/5.0/cayenne-guide/ext-cache-invalidation.html
b/src/main/site/content/docs/5.0/cayenne-guide/ext-cache-invalidation.html
index 5b7c4eca4..5702e0339 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/ext-cache-invalidation.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/ext-cache-invalidation.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Cache Invalidation Extension"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 270
+weight: 260
---
<div class="sect2">
<h3 id="ext-cache-invalidation"><a class="anchor"
href="#ext-cache-invalidation"></a>5.1. Cache Invalidation Extension</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/ext-crypto.html
b/src/main/site/content/docs/5.0/cayenne-guide/ext-crypto.html
index fcd5d3c98..03a9901ce 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/ext-crypto.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/ext-crypto.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Crypto extension"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 280
+weight: 270
---
<div class="sect2">
<h3 id="ext-crypto"><a class="anchor" href="#ext-crypto"></a>5.2. Crypto
extension</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/ext-jcache.html
b/src/main/site/content/docs/5.0/cayenne-guide/ext-jcache.html
index e5df157ed..61cede9c5 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/ext-jcache.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/ext-jcache.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, JCache integration"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 290
+weight: 280
---
<div class="sect2">
<h3 id="ext-jcache"><a class="anchor" href="#ext-jcache"></a>5.3. JCache
integration</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/ext-osgi.html
b/src/main/site/content/docs/5.0/cayenne-guide/ext-osgi.html
index b2597fb5b..dced7f135 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/ext-osgi.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/ext-osgi.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Cayenne OSGI extension"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 320
+weight: 310
---
<div class="sect2">
<h3 id="ext-osgi"><a class="anchor" href="#ext-osgi"></a>5.6. Cayenne OSGI
extension</h3>
diff --git
a/src/main/site/content/docs/5.0/cayenne-guide/ext-project-compatibility.html
b/src/main/site/content/docs/5.0/cayenne-guide/ext-project-compatibility.html
index 8f5e76971..4e2ea6942 100644
---
a/src/main/site/content/docs/5.0/cayenne-guide/ext-project-compatibility.html
+++
b/src/main/site/content/docs/5.0/cayenne-guide/ext-project-compatibility.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Project compatibility
extension"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 300
+weight: 290
---
<div class="sect2">
<h3 id="ext-project-compatibility"><a class="anchor"
href="#ext-project-compatibility"></a>5.4. Project compatibility extension</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/ext-velocity.html
b/src/main/site/content/docs/5.0/cayenne-guide/ext-velocity.html
index d36219314..b7cb4d4bc 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/ext-velocity.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/ext-velocity.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Apache Velocity Extension"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 310
+weight: 300
---
<div class="sect2">
<h3 id="ext-velocity"><a class="anchor" href="#ext-velocity"></a>5.5. Apache
Velocity Extension</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/gradle_plugin.html
b/src/main/site/content/docs/5.0/cayenne-guide/gradle_plugin.html
index a356b983c..65f97478d 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/gradle_plugin.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/gradle_plugin.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Gradle Plugin"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 350
+weight: 340
---
<div class="sect2">
<h3 id="gradle_plugin"><a class="anchor" href="#gradle_plugin"></a>6.2.
Gradle Plugin</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/maven_plugin.html
b/src/main/site/content/docs/5.0/cayenne-guide/maven_plugin.html
index f01491e7c..de74a083e 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/maven_plugin.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/maven_plugin.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Maven Plugin"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 340
+weight: 330
---
<div class="sect2">
<h3 id="maven_plugin"><a class="anchor" href="#maven_plugin"></a>6.1. Maven
Plugin</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/overview.html
b/src/main/site/content/docs/5.0/cayenne-guide/overview.html
index d5a68653b..09adbe633 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/overview.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/overview.html
@@ -26,10 +26,7 @@ weight: 170
<div class="sect2">
<h3 id="overview"><a class="anchor" href="#overview"></a>3.1. Overview</h3>
<div class="paragraph">
- <p>AI coding agents such as Claude Code, Cursor, etc. can read and write
Cayenne projects like any other Java codebase. For day-to-day API work —
writing queries, manipulating an <code>ObjectContext</code>, etc. — you don’t
need anything Cayenne-specific. Prompt the agent the way you would for any
other project.</p>
- </div>
- <div class="paragraph">
- <p>Two additional elements make the agent <em>Cayenne-aware</em> beyond
plain source editing:</p>
+ <p>AI coding agents such as Claude Code, Cursor, etc. can read and write
Cayenne projects like any other Java codebase. For day-to-day API work —
writing queries, manipulating an <code>ObjectContext</code>, etc. — you may not
need anything Cayenne-specific. Prompt the agent the way you would for any
other project. But two additional elements make the agent Cayenne-aware and
allow to implement full ORM workflows:</p>
</div>
<div class="ulist">
<ul>
@@ -40,6 +37,6 @@ weight: 170
</ul>
</div>
<div class="paragraph">
- <p>Both elements are independent but work best together. This chapter walks
you through installing both and explains the available MCP tools.</p>
+ <p>Both are independent but work best together. This chapter walks you
through installing both and explains the available MCP tools.</p>
</div>
</div>
\ No newline at end of file
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/re-filtering.html
b/src/main/site/content/docs/5.0/cayenne-guide/re-filtering.html
index 0c3d693f7..4890328db 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/re-filtering.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/re-filtering.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Filtering"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 230
+weight: 220
---
<div class="sect2">
<h3 id="re-filtering"><a class="anchor" href="#re-filtering"></a>4.2.
Filtering</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/re-introduction.html
b/src/main/site/content/docs/5.0/cayenne-guide/re-introduction.html
index e0e732b9f..2f716f391 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/re-introduction.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/re-introduction.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Introduction"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 220
+weight: 210
---
<div class="sect2">
<h3 id="re-introduction"><a class="anchor" href="#re-introduction"></a>4.1.
Introduction</h3>
diff --git a/src/main/site/content/docs/5.0/cayenne-guide/re-modeler.html
b/src/main/site/content/docs/5.0/cayenne-guide/re-modeler.html
index 66805a1ba..f45642f61 100644
--- a/src/main/site/content/docs/5.0/cayenne-guide/re-modeler.html
+++ b/src/main/site/content/docs/5.0/cayenne-guide/re-modeler.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Reverse Engineering in
Cayenne Modeler"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 250
+weight: 240
---
<div class="sect2">
<h3 id="re-modeler"><a class="anchor" href="#re-modeler"></a>4.4. Reverse
Engineering in Cayenne Modeler</h3>
diff --git
a/src/main/site/content/docs/5.0/cayenne-guide/re-relationships-loading-control.html
b/src/main/site/content/docs/5.0/cayenne-guide/re-relationships-loading-control.html
index f74c9015c..b7038e5d6 100644
---
a/src/main/site/content/docs/5.0/cayenne-guide/re-relationships-loading-control.html
+++
b/src/main/site/content/docs/5.0/cayenne-guide/re-relationships-loading-control.html
@@ -21,7 +21,7 @@ description: "Cayenne Guide 5.0, Other Settings"
cayenneVersion: "5.0"
cayenneNoToc: true
docId: cayenne-guide
-weight: 240
+weight: 230
---
<div class="sect2">
<h3 id="re-relationships-loading-control"><a class="anchor"
href="#re-relationships-loading-control"></a>4.3. Other Settings</h3>
