feat(pose-lib): mirror_pose MCP tool

src/MCPServer.cpp

@@ -608,7 +608,8 @@
         {QStringLiteral("list_poses"), &MCPServer::toolListPoses},
         {QStringLiteral("save_pose"), &MCPServer::toolSavePose},
         {QStringLiteral("apply_pose"), &MCPServer::toolApplyPose},
-        {QStringLiteral("delete_pose"), &MCPServer::toolDeletePose}
+        {QStringLiteral("delete_pose"), &MCPServer::toolDeletePose},
+        {QStringLiteral("mirror_pose"), &MCPServer::toolMirrorPose}
     };
     return handlers;
 }
@@ -4630,6 +4631,31 @@
         QString::fromUtf8(QJsonDocument(content).toJson(QJsonDocument::Indented)));
 }
 
+QJsonObject MCPServer::toolMirrorPose(const QJsonObject &args)
+{
+    SentryReporter::addBreadcrumb("ai.tool_call", "mirror_pose");
+    const QString src = args.value("src").toString();
+    const QString dst = args.value("dst").toString();
+    if (src.isEmpty())
+        return makeErrorResult("Error: missing required 'src' argument");
+    if (dst.isEmpty())
+        return makeErrorResult("Error: missing required 'dst' argument");
+
+    auto* lib = PoseLibrary::instance();
+    if (!lib->mirrorPoseForSelection(src, dst))
+        return makeErrorResult(
+            QString("Error: failed to mirror pose '%1' → '%2' "
+                    "(no selection, no skeleton, or src not found)")
+                .arg(src, dst));
+
+    QJsonObject content;
+    content["ok"] = true;
+    content["src"] = src;
+    content["dst"] = dst;
+    return makeSuccessResult(
+        QString::fromUtf8(QJsonDocument(content).toJson(QJsonDocument::Indented)));
+}
+
 QJsonArray MCPServer::buildToolsList()
 {
     QJsonArray tools;
@@ -5882,6 +5908,26 @@
         );
     }
 
+    // mirror_pose
+    {
+        QJsonObject props;
+        props["src"] = QJsonObject{{"type", "string"}, {"description", "Existing pose name to mirror (use list_poses to enumerate)."}};
+        props["dst"] = QJsonObject{{"type", "string"}, {"description", "Output pose name. Overwrites in place if same as `src`."}};
+        QJsonArray required;
+        required.append("src");
+        required.append("dst");
+        appendTool(
+            "mirror_pose",
+            "Mirror a saved pose across the YZ plane using the bone-name "
+            "heuristic. Recognises `_l`/`_r`, `.L`/`.R`, and `Left*`/`Right*` "
+            "naming. TRS flip: pos.x → -pos.x, rotation (w,x,y,z) → (w,x,-y,-z), "
+            "scale.x → -scale.x. Centre-line bones (Spine, Hips, Head) get "
+            "the X-flipped TRS in place. Writes the result under `dst`.",
+            props,
+            required
+        );
+    }
+
     // bake_vat
     {
         QJsonObject props;

src/MCPServer.h

@@ -247,6 +247,11 @@ private slots:
     /// Pose-lib D-MCP: drop a saved pose by name. Args: `name`.
     QJsonObject toolDeletePose(const QJsonObject &args);
 
+    /// Pose-lib D-MCP: mirror a saved pose across the YZ plane
+    /// using the _l/_r/.L/.R/Left/Right bone-name heuristic.
+    /// Args: `src` (existing pose), `dst` (output pose name).
+    QJsonObject toolMirrorPose(const QJsonObject &args);
+
     // Animation
     struct NodeAnimation {
         Ogre::SceneNode* node;

src/MCPServer_test.cpp

@@ -7283,3 +7283,30 @@ TEST_F(MCPServerTest, SavePose_NoSelectionRejected)
     QJsonObject r = server->callTool("save_pose", args);
     EXPECT_TRUE(isError(r));
 }
+
+TEST_F(MCPServerTest, MirrorPose_MissingSrcRejected)
+{
+    QJsonObject args;
+    args["dst"] = "MCP_MirrorDst";
+    QJsonObject r = server->callTool("mirror_pose", args);
+    EXPECT_TRUE(isError(r));
+    EXPECT_TRUE(getResultText(r).contains("src"));
+}
+
+TEST_F(MCPServerTest, MirrorPose_MissingDstRejected)
+{
+    QJsonObject args;
+    args["src"] = "MCP_MirrorSrc";
+    QJsonObject r = server->callTool("mirror_pose", args);
+    EXPECT_TRUE(isError(r));
+    EXPECT_TRUE(getResultText(r).contains("dst"));
+}
+
+TEST_F(MCPServerTest, MirrorPose_UnknownSrcRejected)
+{
+    QJsonObject args;
+    args["src"] = "MCP_NoSuchPose";
+    args["dst"] = "MCP_AnyDst";
+    QJsonObject r = server->callTool("mirror_pose", args);
+    EXPECT_TRUE(isError(r));
+}

src/PoseLibrary.cpp

@@ -331,6 +331,16 @@
     return deletePose(ents.first(), name);
 }
 
+bool PoseLibrary::mirrorPoseForSelection(const QString& srcName,
+                                          const QString& dstName)
+{
+    auto* sel = SelectionSet::getSingleton();
+    if (!sel) return false;
+    auto ents = sel->getResolvedEntities();
+    if (ents.isEmpty()) return false;
+    return mirrorPose(ents.first(), srcName, dstName);
+}
+
 QStringList PoseLibrary::listPosesForSelection() const
 {
     auto* sel = SelectionSet::getSingleton();

src/PoseLibrary.h

@@ -138,6 +138,8 @@ class PoseLibrary : public QObject
     Q_INVOKABLE bool savePoseForSelection(const QString& name);
     Q_INVOKABLE bool applyPoseForSelection(const QString& name);
     Q_INVOKABLE bool deletePoseForSelection(const QString& name);
+    Q_INVOKABLE bool mirrorPoseForSelection(const QString& srcName,
+                                             const QString& dstName);
     Q_INVOKABLE QStringList listPosesForSelection() const;
 
 signals: