{
  "feature": "joints-constraints",
  "version": "1.0.0",
  "description": "3D joint constraints connecting rigid bodies",
  "category": "integration",
  "tags": [
    "integration",
    "godot"
  ],
  "actors": [
    {
      "id": "game_engine",
      "name": "Godot Engine",
      "type": "system"
    }
  ],
  "outcomes": {
    "hinge_joint": {
      "given": [
        "Revolute joint (door hinge) is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Revolute joint (door hinge) completed",
      "priority": 1
    },
    "slider_joint": {
      "given": [
        "Prismatic joint (piston) is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Prismatic joint (piston) completed",
      "priority": 2
    },
    "ball_joint": {
      "given": [
        "Spherical joint (shoulder) is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Spherical joint (shoulder) completed",
      "priority": 3
    },
    "cone_twist_joint": {
      "given": [
        "Twist with cone limit is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Twist with cone limit completed",
      "priority": 4
    },
    "6-dof_joint": {
      "given": [
        "Full 6-axis freedom with limits is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Full 6-axis freedom with limits completed",
      "priority": 5
    }
  },
  "rules": {
    "implementation": {
      "description": "Feature implemented in C++ engine core"
    },
    "platform_agnostic": {
      "description": "Works across desktop, web, mobile platforms"
    }
  },
  "related": [],
  "agi": {
    "goals": [
      {
        "id": "reliable_joints_constraints",
        "description": "3D joint constraints connecting rigid bodies",
        "success_metrics": [
          {
            "metric": "success_rate",
            "target": ">= 99.5%",
            "measurement": "Successful operations divided by total attempts"
          },
          {
            "metric": "error_recovery_rate",
            "target": ">= 95%",
            "measurement": "Errors that auto-recover without manual intervention"
          }
        ],
        "constraints": [
          {
            "type": "availability",
            "description": "Must degrade gracefully when dependencies are unavailable",
            "negotiable": false
          }
        ]
      }
    ],
    "autonomy": {
      "level": "supervised"
    },
    "safety": {
      "action_permissions": [
        {
          "action": "hinge_joint",
          "permission": "autonomous"
        },
        {
          "action": "slider_joint",
          "permission": "autonomous"
        },
        {
          "action": "ball_joint",
          "permission": "autonomous"
        },
        {
          "action": "cone_twist_joint",
          "permission": "autonomous"
        },
        {
          "action": "6-dof_joint",
          "permission": "autonomous"
        }
      ]
    },
    "tradeoffs": [
      {
        "prefer": "reliability",
        "over": "throughput",
        "reason": "integration failures can cascade across systems"
      }
    ]
  },
  "extensions": {
    "tech_stack": {
      "language": "C++",
      "runtime": "Godot 4.x"
    }
  }
}